Merge pull request scala#2350 from bishabosha/move-contribute-from-scala-lang-pr

Migrate contribute section from scala-lang to a guide

Author: bishabosha

README.md

@@ -27,7 +27,7 @@ For more details on the Docker option, see [this issue](https://github.com/scala
 
 ## Contributing ##
 
-Please have a look at [https://docs.scala-lang.org/contribute.html](https://docs.scala-lang.org/contribute.html) before making a contribution.
+Please have a look at [Add New Guides/Tutorials](https://docs.scala-lang.org/contribute/add-guides.html) before making a contribution.
 This document gives an overview of the type of documentation contained within the Scala Documentation repository and the repository's structure.
 
 Small changes, or corrected typos will generally be pulled in right away. Large changes, like the addition of new documents, or the rewriting of

_config.yml

@@ -20,6 +20,7 @@ scala-212-version: 2.12.15
 scala-3-version: 3.1.1
 
 collections:
+  contribute_resources:
   style:
     output: true
   overviews:
@@ -104,6 +105,14 @@ defaults:
       overview-name: "Scala 3 — Book"
       layout: multipage-overview
       permalink: "/scala3/book/:title.html"
+  -
+    scope:
+      path: "_overviews/contribute"
+    values:
+      partof: scala-contribution
+      overview-name: Contributing to Scala
+      layout: multipage-overview
+      permalink: "/contribute/:title.html"
   -
     scope:
       path: "_overviews/scala3-migration"

_contribute_resources/1-documentation.md

@@ -0,0 +1,11 @@
+---
+title: Documentation
+link: /contribute/documentation.html
+icon: fa fa-book
+---
+[Library API docs][scala-standard-library-api-documentation], [new guides][add-guides] on [docs.scala-lang.org][home], and help
+with [scala-lang.org](https://github.com/scala/scala-lang).
+
+[add-guides]: {% link _overviews/contribute/add-guides.md %}
+[scala-standard-library-api-documentation]: {% link _overviews/contribute/scala-standard-library-api-documentation.md %}
+[home]: {% link index.md %}

_contribute_resources/2-bug-fixes.md

@@ -0,0 +1,8 @@
+---
+title: Bug fixes
+link: /contribute/guide.html
+icon: fa fa-bug
+---
+Issues with the tools, core libraries and compiler. Also you can help us by [reporting bugs][bug-reporting-guide].
+
+[bug-reporting-guide]: {% link _overviews/contribute/bug-reporting-guide.md %}

_contribute_resources/3-code-reviews.md

@@ -0,0 +1,9 @@
+---
+title: Code Reviews
+link: /contribute/codereviews.html
+icon: fa fa-eye
+---
+Review pull requests against [scala/scala](https://github.com/scala/scala/pulls),
+[lampepfl/dotty](https://github.com/lampepfl/dotty/pulls),
+[scala/scala-lang](https://github.com/scala/scala-lang/pulls),
+[scala/docs.scala-lang](https://github.com/scala/docs.scala-lang/pulls) and others.

_contribute_resources/4-core-libraries.md

@@ -0,0 +1,6 @@
+---
+title: Core Libraries
+link: /contribute/corelibs.html
+icon: fa fa-clipboard
+---
+Update and expand the capabilities of the core (and associated) Scala libraries.

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

@@ -0,0 +1,6 @@
+---
+title: IDE and Build Tools
+link: /contribute/tools.html
+icon: fa fa-terminal
+---
+Enhance the Scala tools with features for build tools, IDE plug-ins and other related projects.

_contribute_resources/6-compiler-language.md

@@ -0,0 +1,6 @@
+---
+title: Compiler/Language
+link: /contribute/guide.html#larger-changes-new-features
+icon: fa fa-cogs
+---
+Larger language features and compiler enhancements including language specification and SIPs.

_data/doc-nav-header.yml

@@ -35,6 +35,8 @@
       url: "/tutorials/FAQ/index.html"
     - title: Language Specification
       url: http://scala-lang.org/files/archive/spec/2.13/
+    - title: Contribution Guide
+      url: "/contribute/"
     - title: Style Guide
       url: "/style/index.html"
     - title: Cheatsheet

_data/nav-header.yml

@@ -1,12 +1,17 @@
 - title: Documentation
   url: "/"
+  can-highlight: true
 - title: Download
   url: https://www.scala-lang.org/download/
+  can-highlight: true
 - title: Community
   url: https://www.scala-lang.org/community/
+  can-highlight: true
 - title: Libraries
   url: https://index.scala-lang.org
+  can-highlight: true
 - title: Contribute
-  url: https://www.scala-lang.org/contribute/
+  url: /contribute/
 - title: Blog
   url: https://www.scala-lang.org/blog/
+  can-highlight: true

_includes/column-list-of-items.html

@@ -15,4 +15,4 @@ <h4>{{item.title}}</h4>
 			</div>
 		</div>
 	{% endfor %}
-</div>
+</div>

_includes/site-header.html

@@ -10,7 +10,7 @@
       <ul class="navigation-menu">
         {% for navItem in site.data.nav-header %}
             <li class="navigation-menu-item">
-              <a href="{% if navItem.url contains '://' %}{{navItem.url}}{% else %}{{site.baseurl}}{{navItem.url}}{% endif %}" {% if page.url contains navItem.url %}class="active"{% endif %}>{{navItem.title}}</a>
+              <a href="{% if navItem.url contains '://' %}{{navItem.url}}{% else %}{{site.baseurl}}{{navItem.url}}{% endif %}" {% if page.url contains navItem.url and navItem.can-highlight %} class="active"{% endif %}>{{navItem.title}}</a>
             </li>
         {% endfor %}
       </ul>

_ja/scala3/contribute-to-docs.md

@@ -45,8 +45,8 @@ Scala 3 の高品質なドキュメンテーションを作るためのいくつ
 - [Source](https://github.com/scala/docs.scala-lang/tree/main/_overviews/scala3-migration)
 - [Issues](https://github.com/scalacenter/docs.scala-lang/issues)
 
-## Scala 3 Contribution Guide
-[Scala 3 Contribution Guide](/scala3/guides/contribution/contribution-intro.html)
+## Scala 3 Contributing Guide
+[Scala 3 Contributing Guide](/scala3/guides/contribution/contribution-intro.html)
 Scala 3 コンパイラとライブラリへの貢献と内部に関する包括的な概要が含まれています
 
 - [Source](https://github.com/scala/docs.scala-lang/tree/main/_overviews/scala3-contribution)

_ja/scala3/new-in-scala3.md

@@ -13,7 +13,7 @@ Scala 3 は Scala 2 から大幅な改善が行われ、さまざまな新機能
 - [Syntax Summary][syntax-summary] では Scala 3 で新しく追加されたシンタックスを解説している。
 - [Language Reference][reference] を見ればScala 2 と Scala 3 の変更点を詳しく確認できる。
 - Scala 2 から Scala 3 への移行を考えている方は[Migration Guide][migration] を参照。
-- [Contribution Guide][contribution] は、問題を修正するためのガイドを含め、コンパイラーをさらに深く掘り下げます。
+- [Scala 3 Contributing Guide][contribution] は、問題を修正するためのガイドを含め、コンパイラーをさらに深く掘り下げます。
 
 ## What's new in Scala 3
 Scala 3 は Scala 2 を徹底的に見直して再設計されている。核心部分で、型システムの多くの面が変更されより原理原則に基づいたものになった。この変更によって新機能(ユニオン型)が使えるようになったことにくわえて、なにより型システムがさらに使いやすくなった。 例えば、[型推論][type-inference] や overload resolution が改善された.