Skip to content

Commit 813cf12

Browse files
committed
include old scala intro in page
1 parent 27c1189 commit 813cf12

File tree

8 files changed

+115
-129
lines changed

8 files changed

+115
-129
lines changed

_contribute_resources/1-documentation.md

Lines changed: 0 additions & 11 deletions
This file was deleted.

_contribute_resources/2-bug-fixes.md

Lines changed: 0 additions & 8 deletions
This file was deleted.

_contribute_resources/3-code-reviews.md

Lines changed: 0 additions & 9 deletions
This file was deleted.

_contribute_resources/4-core-libraries.md

Lines changed: 0 additions & 6 deletions
This file was deleted.

_contribute_resources/5-ide-and-build-tools.md

Lines changed: 0 additions & 6 deletions
This file was deleted.

_contribute_resources/6-compiler-language.md

Lines changed: 0 additions & 6 deletions
This file was deleted.

_overviews/contribute/bin-old-content.md

Lines changed: 0 additions & 68 deletions
This file was deleted.

_overviews/contribute/index.md

Lines changed: 115 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -20,15 +20,42 @@ explore_resources:
2020
icon: "fa fa-check-to-slot"
2121
link: "#how-do-i-choose-where-to-contribute"
2222

23-
contrib_resources:
23+
compiler_resources:
2424
- title: "Scala 3 Contributing Guide"
2525
description: "Guide to the Scala 3 Compiler and fixing an issue"
2626
icon: "fa fa-code-merge"
2727
link: /scala3/guides/contribution/contribution-intro.html
28-
- title: "Scala 2 Hackers Guide"
29-
description: "Guide to the Scala 3 Compiler and fixing an issue"
30-
icon: "fa fa-code-pull-request"
31-
link: /scala3/guides/contribution/contribution-intro.html
28+
- title: "Compiler Academy Videos"
29+
description: "In-depth tours of the Scala 3 compiler's internals"
30+
icon: "fa fa-circle-play"
31+
link: https://www.youtube.com/channel/UCIH0OgqE54-KEvYDg4LRhKQ
32+
33+
scala_resources:
34+
- title: Documentation
35+
description: "Library API docs, new guides on docs.scala-lang.org, and help with scala-lang.org."
36+
icon: fa fa-book
37+
link: /contribute/documentation.html
38+
- title: Bug fixes
39+
description: "Issues with the tools, core libraries and compiler. Also, you can help us by reporting bugs."
40+
icon: fa fa-bug
41+
link: /contribute/guide.html
42+
- title: Code Reviews
43+
description: "Review pull requests against scala/scala, lampepfl/dotty, scala/scala-lang, scala/docs.scala-lang,
44+
and others."
45+
icon: fa fa-eye
46+
link: /contribute/codereviews.html
47+
- title: Core Libraries
48+
description: "Update and expand the capabilities of the core (and associated) Scala libraries."
49+
icon: fa fa-clipboard
50+
link: /contribute/corelibs.html
51+
- title: IDE and Build Tools
52+
description: "Enhance the Scala tools with features for build tools, IDE plug-ins and other related projects."
53+
icon: fa fa-terminal
54+
link: /contribute/tools.html
55+
- title: Compiler/Language
56+
description: "Larger language features and compiler enhancements including language specification and SIPs."
57+
icon: fa fa-cogs
58+
link: /contribute/guide.html#larger-changes-new-features
3259

3360
library_resources:
3461
- title: Library Authors Guide
@@ -39,6 +66,10 @@ library_resources:
3966
description: "How you can write code and documentation that welcomes all"
4067
icon: "fa fa-door-open"
4168
link: "inclusive-language-guide.html"
69+
- title: Create a Welcoming Community
70+
description: "Our code of conduct is practical agreement for a healthy community"
71+
icon: "fa fa-handshake-simple"
72+
link: "https://scala-lang.org/conduct"
4273
- title: Binary Compatability Guide
4374
description: "Evolve your library over time, giving users the confidence to upgrade safely."
4475
icon: "fa fa-puzzle-piece"
@@ -50,35 +81,99 @@ Welcome to the guide on contributing to all parts of Scala's open-source ecosyst
5081
## Newcomers' FAQ
5182

5283
If you are reading this page, we welcome you, regardless of your background, to begin contributing to Scala's
53-
open-source ecosystem. Find out more by clicking the links:
84+
open-source ecosystem. We have answered some common questions for you below:
5485

5586
{% include inner-documentation-sections.html links=page.explore_resources %}
5687

5788
## Ways to Start Today
5889

90+
### The Scala Compiler Academy
91+
92+
The [Scala Center](https://scala.epfl.ch)
93+
runs the **Scala Compiler Academy** project to onboard and educate new people in the Scala 3 compiler.
94+
One of the Compiler Academy
95+
projects is an Issue Spree – an event that takes place every 3 weeks where people fix Scala 3 compiler issues
96+
in pair programming sessions while learning the compiler together. You can apply for the Spree participation
97+
by [filling the form](https://forms.gle/DfoSuHFm3T6MA3L59).
98+
99+
{% include inner-documentation-sections.html links=page.compiler_resources %}
100+
59101
### So You Want To Write A Library...
60102

61103
Read these guides if you are a maintainer of a library, or are thinking of starting a new project:
62104

63105
{% include inner-documentation-sections.html links=page.library_resources %}
64106

65-
### Scala Project
107+
## Contributing to the Scala Project
66108

67-
There is also an option to contribute to the Scala 3 compiler itself. The Scala Center runs the
68-
Compiler Academy project to onboard and educate new people in the Scala 3 compiler. One of the Compiler Academy
69-
projects is an Issue Spree – an event that takes place every 3 weeks where people fix Scala 3 compiler issues
70-
in pair programming sessions while learning the compiler together. You can apply for the Spree participation
71-
by [filling the form](https://forms.gle/DfoSuHFm3T6MA3L59).
109+
### Why You Should Contribute To Scala
110+
The Scala programming language is an open source project with a very
111+
diverse community, where people from all over the world contribute their work,
112+
with everyone benefiting from friendly help and advice, and
113+
kindly helping others in return. So why not join the Scala community and help
114+
everyone make things better?
115+
116+
**What Can I Do?**
117+
That depends on what you want to contribute. Below are some getting started resources for different contribution domains. Please read all the documentation and follow all the links from the topic pages below before attempting to contribute, as many of the questions you have will already be answered.
118+
119+
### Reporting bugs
120+
121+
See our [bug reporting guide][bug-reporting-guide] to learn
122+
how to efficiently report a bug.
72123

73-
{% include inner-documentation-sections.html links=page.contrib_resources %}
124+
### Contribute
125+
126+
Coordination of contribution efforts takes place on
127+
[Scala Contributors](https://contributors.scala-lang.org/).
128+
129+
{% include inner-documentation-sections.html links=page.scala_resources %}
130+
131+
### Guidelines
132+
133+
When contributing, please follow:
134+
135+
* The [Scala Code of Conduct](https://scala-lang.org/conduct/)
136+
* The [Inclusive Language Guide][inclusive-language-guide]
137+
138+
### Community Tickets
139+
140+
All issues can be found in the [Scala bug tracker](https://github.com/scala/bug), or the [Scala 3 issue tracker](https://github.com/lampepfl/dotty/issues). Most issues are labeled
141+
to make it easier to find issues you are interested in.
142+
143+
### Tools and Libraries
144+
145+
The Scala ecosystem includes a great many diverse open-source projects
146+
with their own maintainers and community of contributors. Helping out
147+
one of these projects is another way to help Scala. Consider lending
148+
on a hand on a project you're already using. Or, to find out about
149+
other projects, see the
150+
[Libraries and Tools section](https://scala-lang.org/community/#community-libraries-and-tools)
151+
on our Community page.
152+
153+
### Scala Community Build
154+
155+
The Scala community build enables the Scala compiler team
156+
to build and test a corpus of
157+
Scala open source projects
158+
against development versions of the Scala compiler and standard
159+
library in order to discover regressions prior to releases.
160+
The build uses Lightbend's
161+
[dbuild](https://github.com/typesafehub/dbuild) tool,
162+
which leverages [sbt](https://www.scala-sbt.org).
163+
164+
If you're the maintainer -- or just an interested user! -- of an
165+
open-source Scala library or tool, please visit the
166+
[community build documentation](https://github.com/scala/community-build/wiki)
167+
for guidelines on what projects are suitable for the community build
168+
and how projects can be added.
74169

75170
## Your Questions, Answered
76171

77172
{% capture backButton %}
78173
<p>
79174
<a href="#newcomers-faq">
80-
<i class="fa-solid fa-angle-left"></i>
81-
<span> back</span>
175+
<i class="fa-solid fa-angle-up"></i>
176+
<span> return to FAQ</span>
82177
</a>
83178
</p>
84179
{% endcapture %}
@@ -163,3 +258,8 @@ The above benefits are something good to achieve regardless of your level of exp
163258
in the Google Summer of Code program where you are paid to work on open source Scala projects over the course
164259
of summer.
165260
{{backButton}}
261+
262+
263+
264+
[bug-reporting-guide]: {% link _overviews/contribute/bug-reporting-guide.md %}
265+
[inclusive-language-guide]: {% link _overviews/contribute/inclusive-language-guide.md %}

0 commit comments

Comments
 (0)