move newcomer contribution to contribution guide

bishabosha · anatoliykmetyuk · bishabosha · commit 1d10e89f19ae · 2022-08-23T15:40:05.000+02:00
Co-authored-by: Jamie Thompson &lt;bishbashboshjt@gmail.com&gt;
Co-authored-by: Anatolii Kmetiuk &lt;anatoliykmetyuk@gmail.com&gt;
diff --git a/_getting-started/index.md b/_getting-started/index.md
@@ -6,17 +6,15 @@ languages: [fr, ja, uk]
 includeTOC: true
 
 newcomer_resources:
-  - title: "Resources For Newcomers"
-    links:
-      - title: Are You Coming From Java?
-        description: What you should know to get to speed with Scala after your initial setup.
-        icon: "fa fa-coffee"
-        link: /scala3/newcomers/java.html
-      - title: Scala in the Browser
-        description: >
-          To start experimenting with Scala right away, use "Scastie" in your browser.
-        icon: "fa fa-cloud"
-        link: https://scastie.scala-lang.org/pEBYc5VMT02wAGaDrfLnyw
+  - title: Are You Coming From Java?
+    description: What you should know to get to speed with Scala after your initial setup.
+    icon: "fa fa-coffee"
+    link: /scala3/newcomers/java.html
+  - title: Scala in the Browser
+    description: >
+      To start experimenting with Scala right away, use "Scastie" in your browser.
+    icon: "fa fa-cloud"
+    link: https://scastie.scala-lang.org/pEBYc5VMT02wAGaDrfLnyw
 
 redirect_from:
   - /getting-started.html
@@ -32,7 +30,9 @@ The instructions below cover both Scala 2 and Scala 3.
 {% endaltDetails %}
 </div>
 
-{% include inner-documentation-sections.html sections=page.newcomer_resources %}
+## Resources For Newcomers
+
+{% include inner-documentation-sections.html links=page.newcomer_resources %}
 
 ##  Install Scala on your computer
 
diff --git a/_includes/inner-documentation-sections.html b/_includes/inner-documentation-sections.html
@@ -2,19 +2,17 @@
 	Layouts using this include should pass an include variable called 'collection' referencing a collection carrying the data (i.e.: contribute_community_tickets, contribute_resources...)
 {% endcomment %}
 
-{% for section in include.sections %}
-<h2 class="frontpage">{{ section.title }}</h2>
 <div class="documentation">
-	{% for link in section.links %}
-	<a href="{% if link.link contains '://' %}{{link.link}}{% else %}{{site.baseurl}}{{link.link}}{% endif %}" class="doc-item doc-item-link">
-	<div class="doc-item-header">
-		<i class="{{link.icon}}"></i>
-		<h4>{{link.title}}</h4>
-	</div>
-	<div class="doc-item-main">
-		<p>{{link.description}}</p>
-	</div>
+	{% for link in include.links %}
+	<a href="{% if link.link contains '://' %}{{link.link}}{% else %}{{site.baseurl}}{{link.link}}{% endif %}"
+		class="doc-item doc-item-link">
+		<div class="doc-item-header">
+			<i class="{{link.icon}}"></i>
+			<h4>{{link.title}}</h4>
+		</div>
+		<div class="doc-item-main">
+			<p>{{link.description}}</p>
+		</div>
 	</a>
 	{% endfor %}
 </div>
-{% endfor %}
diff --git a/_overviews/contribute/add-guides.md b/_overviews/contribute/add-guides.md
@@ -1,6 +1,6 @@
 ---
 title: Add New Guides/Tutorials
-num: 7
+num: 8
 ---
 
 ## Why Contribute New Learning Material?
diff --git a/_overviews/contribute/become-contributor.md b/_overviews/contribute/become-contributor.md
@@ -1,8 +1,7 @@
 ---
-layout: singlepage-overview
-title: Becoming a Scala OSS Contributor
+title: Contribution FAQ
+num: 2
 ---
-You are a confident Scala programmer who is looking to give back to the community. Or maybe you are only at the start of your Scala journey and are looking for good ways to improve your expertise. Regardless of your background, contributing to open source Scala libraries has its own benefits for you.
 
 ## Why contribute?
 Open Source Software (OSS) libraries are the flesh on top of the bone structure of the core language itself. They power vast majority of the commercial and non-commercial projects out there alike.
@@ -23,7 +22,7 @@ Often, when people are talking about contributing to OSS, they think of fixing i
 - **Issue reproduction**. Some reported issues lack reproduction instructions at all! If a maintainer can't reproduce it, they won't be able to fix it. Pinning down exact conditions that make an issue manifest is another way to contribute.
 - **Open-source your own project**. Do you have a pet project you are working on? Is there anything you're working on at work parts of which are generic enough that you can share them online? Open-sourcing your work is a way to solve a problem for other programmers who may also have it. If you are interested in going open-source, here is an excellent guide on how to get started: [https://docs.scala-lang.org/overviews/contributors/index.html](https://docs.scala-lang.org/overviews/contributors/index.html).
 
-## What should I contribute to?
+## Choosing Where to Contribute
 The best project to contribute to is the one that you are using yourself. Take an inventory of your work and hobby projects: what OSS libraries do they use? Have you ever encountered bugs in them? Or have you ever wanted a certain feature implemented? Pick a bug and a feature and commit to fixing or implementing it. Clone the project you are trying to improve, figure out how the tests are written and run there. Write a test for your feature or bug.
 
 While implementing or fixing the feature, it is important to ask for help early when you feel stuck. Even if your code doesn't work, don't hesitate to submit a pull request while stating clearly that you need help. More information about the guidelines of good contribution you can find in the [talk by Seth Tisue](https://youtu.be/DTUpSTrnI-0) on how to be a good contributor.
@@ -33,4 +32,3 @@ If you can't immediately see a bug or feature that you personally would like to
 There is also an option to contribute to the Scala 3 compiler itself. The Scala Center runs the Compiler Academy project to onboard and educate new people in the Scala 3 compiler. One of the Compiler Academy projects is an Issue Spree – an event that takes place every 3 weeks where people fix Scala 3 compiler issues in pair programming sessions while learning the compiler together. You can apply for the Spree participation by [filling the form](https://forms.gle/DfoSuHFm3T6MA3L59).
 
 You may want to keep an eye on the Scala Center [LinkedIn](https://www.linkedin.com/company/scala-center/) and [Twitter](https://twitter.com/scala_lang) to stay up-to-date with the possible contribution opportunities. For example, every year, the Scala Center participates in the Google Summer of Code program where you are paid to work on open source Scala projects over the course of summer.
-
diff --git a/_overviews/contribute/bug-reporting-guide.md b/_overviews/contribute/bug-reporting-guide.md
@@ -1,6 +1,6 @@
 ---
 title: Bug Reporting Guide
-num: 8
+num: 9
 ---
 
 The Scala compiler and standard library bug tracker is located at [https://github.com/scala/bug](https://github.com/scala/bug), and for Scala 3, it is located at [github.com/lampepfl/dotty](https://github.com/lampepfl/dotty/issues). Before you submit a bug make sure that it is certainly a bug by following instructions
diff --git a/_overviews/contribute/codereviews.md b/_overviews/contribute/codereviews.md
@@ -1,6 +1,6 @@
 ---
 title: Code Review Contributions
-num: 3
+num: 4
 ---
 ## Code Review Contributions
 
diff --git a/_overviews/contribute/corelibs.md b/_overviews/contribute/corelibs.md
@@ -1,6 +1,6 @@
 ---
 title: Core Library Contributions
-num: 4
+num: 5
 ---
 ## Core Library Contributions
 
diff --git a/_overviews/contribute/documentation.md b/_overviews/contribute/documentation.md
@@ -1,6 +1,6 @@
 ---
 title: Documentation Contributions
-num: 5
+num: 6
 ---
 ## Contributing Documentation to the Scala project
 
diff --git a/_overviews/contribute/guide.md b/_overviews/contribute/guide.md
@@ -1,6 +1,6 @@
 ---
 title: Contributing guide
-num: 10
+num: 11
 ---
 
 | **Shortcut**                           | **Description** |
diff --git a/_overviews/contribute/hacker-guide.md b/_overviews/contribute/hacker-guide.md
@@ -1,7 +1,7 @@
 ---
 title: Scala 2 Hacker's Guide
 by: Eugene Burmako
-num: 12
+num: 13
 ---
 <br>
 This guide is intended to help you get from an idea of fixing a bug or implementing a new feature into a nightly Scala build, and, ultimately, to a production release of Scala incorporating your idea.
diff --git a/_overviews/contribute/inclusive-language-guide.md b/_overviews/contribute/inclusive-language-guide.md
@@ -1,6 +1,6 @@
 ---
 title: Inclusive Language Guide
-num: 2
+num: 3
 ---
 
 We are committed to providing a friendly, safe and welcoming environment for
diff --git a/_overviews/contribute/index.md b/_overviews/contribute/index.md
@@ -1,8 +1,30 @@
 ---
-title: Introduction
+title: Becoming a Scala OSS Contributor
 num: 1
+
+explore_resources:
+  - title: Why Contribute?
+    description: "Giving back to the community has many benefits..."
+    icon: "fa fa-circle-question"
+    link: "become-contributor.html#why-contribute"
+  - title: Ways to Contribute
+    description: "From documentation to coding a bug-fix, there is lots to do..."
+    icon: "fa fa-clipboard-list"
+    link: "become-contributor.html#ways-to-contribute"
+  - title: Choosing Where to Contribute
+    description: "If you are using OSS, you are already a contributor..."
+    icon: "fa fa-check-to-slot"
+    link: "become-contributor.html#choosing-where-to-contribute"
 ---
 
+Regardless of your background, contributing to open source Scala libraries has its own benefits for you.
+You could be a confident Scala programmer who is looking to give back to the community. Or maybe you are only at the
+start of your Scala journey and are looking for good ways to improve your expertise.
+
+### Explore Scala OSS
+
+{% include inner-documentation-sections.html links=page.explore_resources %}
+
 ### Why You Should Contribute To Scala
 The Scala programming language is an open source project with a very
 diverse community, where people from all over the world contribute their work,
diff --git a/_overviews/contribute/partest-guide.md b/_overviews/contribute/partest-guide.md
@@ -1,6 +1,6 @@
 ---
 title: Running the Test Suite
-num: 13
+num: 14
 ---
 
 Partest is a custom parallel testing tool that we use to run the test suite for the Scala compiler and library. Go to the scala project folder from your local checkout and run it via `sbt`, `ant` or standalone as follows.
diff --git a/_overviews/contribute/scala-internals.md b/_overviews/contribute/scala-internals.md
@@ -1,6 +1,6 @@
 ---
 title: Scala Contributors Forum
-num: 9
+num: 10
 ---
 
 The [Scala Contributors Forum][scala-contributors] is where discussions about the Scala ecosystem
diff --git a/_overviews/contribute/scala-standard-library-api-documentation.md b/_overviews/contribute/scala-standard-library-api-documentation.md
@@ -1,6 +1,6 @@
 ---
 title: Contribute to API Documentation
-num: 6
+num: 7
 ---
 
 This page is specific to API documentation contributions – that is, API
diff --git a/_overviews/contribute/tools.md b/_overviews/contribute/tools.md
@@ -1,6 +1,6 @@
 ---
 title: IDE and Build Tool Contributions
-num: 11
+num: 12
 
 # Projects list:
 projects:
diff --git a/index.md b/index.md
@@ -94,14 +94,10 @@ sections:
         description: "The Scala Improvement Process. Language & compiler evolution."
         icon: "fa fa-cogs"
         link: /sips/index.html
-      - title: "Contributing to Scala"
-        description: "The Complete Guide to Contributing to Scala's compilers, libraries and documentation."
-        icon: "fa fa-cogs"
-        link: /contribute/
-      - title: "Becoming a Scala OSS Contributor"
-        description: "How to start contributing to open-source Scala ecosystem"
+      - title: "Become a Scala OSS Contributor"
+        description: "From start to finish: discover how you can help Scala's open-source ecosystem"
         icon: "fa fa-code-branch"
-        link: /scala3/newcomers/contributor.html
+        link: /contribute/
       - title: "Scala 3 Contributing Guide"
         description: "Guide to the Scala 3 Compiler and fixing an issue"
         icon: "fa fa-cogs"

-Original file line number
+Diff line change
@@ @@ -1,6 +1,6 @@ @@
 ---
 title: Add New Guides/Tutorials
 -num: 7
 +num: 8
 ---
 ## Why Contribute New Learning Material?