Merge branch 'main' into resolve-todos-2

Author: b-studios

.drone.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+- package-ecosystem: bundler
+  directory: "/"
+  schedule:
+    interval: daily
+  open-pull-requests-limit: 10
+  ignore:
+  - dependency-name: html-proofer
+    versions:
+    - "> 3.15.3"

.github/dependabot.yml

@@ -0,0 +1,32 @@
+name: Build
+on: [push, pull_request]
+jobs:
+  build:
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v2
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 2.5.8
+          bundler-cache: true
+      - name: Set up coursier
+        uses: laughedelic/coursier-setup@v1
+        with:
+          jvm: adopt:11
+      - name: Run mdoc
+        run: |
+          ./scripts/run-mdoc.sh
+          rm -r /tmp/mdoc-out/
+      - name: Jekyll build
+        run: bundle exec jekyll build
+      - name: HTMLProofer
+        run: |
+          # # Checking for docs.scala-lang/blob/master leads to a chicken and egg problem because of the edit links of new pages.
+          bundle exec htmlproofer ./_site/\
+             --only-4xx\
+             --http-status-ignore "400,401,429"\
+             --empty-alt-ignore\
+             --allow-hash-href\
+             --url-ignore '/https://github.com/scala/docs.scala-lang/blob/master/.*/,/www.oracle.com/'
+

.github/workflows/build.yml

@@ -8,5 +8,4 @@ _site
 vendor/bundle
 .idea/
 /coursier
-/tut-tmp/
 .sass-cache/

.gitignore

@@ -45,7 +45,7 @@ GEM
       jekyll (~> 3.0)
     jekyll-watch (2.2.1)
       listen (~> 3.0)
-    kramdown (2.3.0)
+    kramdown (2.3.1)
       rexml
     kramdown-parser-gfm (1.1.0)
       kramdown (~> 2.0)
@@ -54,15 +54,17 @@ GEM
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     mercenary (0.3.6)
-    mini_portile2 (2.4.0)
-    nokogiri (1.10.10)
-      mini_portile2 (~> 2.4.0)
+    mini_portile2 (2.5.0)
+    nokogiri (1.11.1)
+      mini_portile2 (~> 2.5.0)
+      racc (~> 1.4)
     nokogumbo (2.0.2)
       nokogiri (~> 1.8, >= 1.8.4)
     parallel (1.19.2)
     pathutil (0.16.2)
       forwardable-extended (~> 2.6)
     public_suffix (4.0.5)
+    racc (1.5.2)
     rainbow (3.0.0)
     rb-fsevent (0.10.4)
     rb-inotify (0.10.1)

Gemfile.lock

@@ -54,5 +54,5 @@ Ovdje je `n == 10` i `v == 10`. U prvoj iteraciji, `i == 0` i `j == 0` tako da `
 Bez `if` čuvara, ovo bi ispisalo sljedeće:
 ```
 
-(0, 0) (0, 1) (0, 2) (0, 3) (0, 4) (0, 5) (0, 6) (0, 7) (0, 8) (0, 9) (1, 1) ...
+(0, 0) (0, 1) (0, 2) (0, 3) (0, 4) (0, 5) (0, 6) (0, 7) (0, 8) (0, 9) (1, 0) ...
 ```

_ba/tour/for-comprehensions.md

@@ -22,7 +22,8 @@ Konvencija je da se koristi slovo `A` kao identifikator tipa, mada se može kori
 ```scala mdoc
 class Stack[A] {
   private var elements: List[A] = Nil
-  def push(x: A) { elements = x :: elements }
+  def push(x: A): Unit =
+    elements = x :: elements
   def peek: A = elements.head
   def pop(): A = {
     val currentTop = peek

_ba/tour/generic-classes.md

@@ -15,9 +15,9 @@ keywords:
 - Document
 - Guide
 
-scala-version: 2.13.4
-scala-212-version: 2.12.12
-scala-3-version: 3.0.0-M3
+scala-version: 2.13.5
+scala-212-version: 2.12.13
+scala-3-version: 3.0.0-RC1
 scala-3-plugin-version: 0.5.1
 
 collections:
@@ -103,6 +103,17 @@ defaults:
       overview-name: "Scala 3 — Book"
       layout: multipage-overview
       permalink: "/scala3/book/:title.html"
+  -
+    scope:
+      path: "_overviews/scala3-migration"
+    values:
+      scala3: true
+      # num: 99 # to list them in the TOC, should be overwritten individually
+      partof: scala3-migration
+      type: section
+      overview-name: "Scala 3 Migration Guide"
+      layout: multipage-overview
+      permalink: "/scala3/guides/migration/:title.html"
   -
     scope:
       path: "_overviews/scala3-macros"

_config.yml

@@ -3,8 +3,6 @@
   submenu:
     - title: Current
       url: https://www.scala-lang.org/api/current/
-    - title: Nightly
-      url: https://www.scala-lang.org/files/archive/nightly/2.13.x/api/2.13.x/
     - title: All Versions
       url: "/api/all.html"
 - title: Learn

_data/doc-nav-header.yml

@@ -436,11 +436,10 @@ la ejecución del argumento por nombre `fun`.
 ## Actores remotos
 
 Esta sección describe el API de los actores remotos. Su principal interfaz es el objecto
-[`RemoteActor`](https://www.scala-lang.org/api/2.9.1/scala/actors/remote/RemoteActor$.html) definido
-en el paquete `scala.actors.remote`. Este objeto facilita el conjunto de métodos necesarios para crear
-y establecer conexiones a instancias de actores remotos. En los fragmentos de código que se muestran a
-continuación se asume que todos los miembros de `RemoteActor` han sido importados; la lista completa
-de importaciones utilizadas es la siguiente:
+`RemoteActor` definido en el paquete `scala.actors.remote`. Este objeto facilita el conjunto
+de métodos necesarios para crear y establecer conexiones a instancias de actores remotos. En los
+fragmentos de código que se muestran a continuación se asume que todos los miembros de
+`RemoteActor` han sido importados; la lista completa de importaciones utilizadas es la siguiente:
 
     import scala.actors._
     import scala.actors.Actor._
@@ -449,10 +448,10 @@ de importaciones utilizadas es la siguiente:
 
 ### Iniciando actores remotos
 
-Un actore remot es identificado de manera unívoca por un
-[`Symbol`](https://www.scala-lang.org/api/2.9.1/scala/Symbol.html). Este símbolo es único para la instancia
-de la máquina virual en la que se está ejecutando un actor. Un actor remoto identificado con el nombre
-`myActor` puede ser creado del siguiente modo.
+Un actore remot es identificado de manera unívoca por un `Symbol`. Este símbolo
+es único para la instancia de la máquina virual en la que se está ejecutando un
+actor. Un actor remoto identificado con el nombre `myActor` puede ser creado del
+siguiente modo.
 
     class MyActor extends Actor {
       def act() {

_es/overviews/core/actors.md

@@ -16,7 +16,8 @@ A continuación se muestra un ejemplo:
 
     class Stack[T] {
       var elems: List[T] = Nil
-      def push(x: T) { elems = x :: elems }
+      def push(x: T): Unit =
+    	elems = x :: elems
       def top: T = elems.head
       def pop() { elems = elems.tail }
     }

_es/tour/generic-classes.md

@@ -22,7 +22,7 @@ The Scala installer is a tool named `cs` that ensures that a JVM and standard Sc
 
 <div class="main-download">
     <div id="download-step-one">
-        <p>Follow <a href="https://get-coursier.io/docs/cli-overview.html#install-native-launcher" target="_blank">the instructions to install the <code>cs</code> launcher</a> then run:</p>
+        <p>Follow <a href="https://get-coursier.io/docs/cli-installation.html#native-launcher" target="_blank">the instructions to install the <code>cs</code> launcher</a> then run:</p>
         <p><code>$ ./cs setup</code></p>
     </div>
 </div>

_getting-started/index.md

@@ -55,7 +55,7 @@ but here's a glance at what everything is for:
 => `main`
 1. Right-click `scala` and select **New** => **Package**
 1. Name the package `example` and click **OK** (or just press the Enter or Return key).
-1. Right-click the package `example` and select **New** => **Scala class**.
+1. Right-click the package `example` and select **New** => **Scala class** (if you don't see this option, right-click the `SbtExampleProject`, click **Add Frameworks Support**, select **Scala** and proceed)
 1. Name the class `Main` and change the **Kind** to `Object`.
 1. Change the code in the class to the following:
 

_getting-started/intellij-track/building-a-scala-project-with-intellij-and-sbt.md

@@ -11,7 +11,7 @@ redirect_from: "/getting-started-sbt-track/testing-scala-with-sbt-on-the-command
 
 There are multiple libraries and testing methodologies for Scala,
 but in this tutorial, we'll demonstrate one popular option from the ScalaTest framework
-called [FunSuite](https://www.scalatest.org/getting_started_with_fun_suite).
+called [AnyFunSuite](https://www.scalatest.org/scaladoc/3.2.2/org/scalatest/funsuite/AnyFunSuite.html).
 We assume you know [how to create a Scala project with sbt](getting-started-with-scala-and-sbt-on-the-command-line.html).
 
 ## Setup
@@ -46,9 +46,9 @@ sbt test
 named after the object we're testing.
 
 ```
-  import org.scalatest.FunSuite
+  import org.scalatest.funsuite.AnyFunSuite
 
-  class CubeCalculatorTest extends FunSuite {
+  class CubeCalculatorTest extends AnyFunSuite {
       test("CubeCalculator.cube") {
           assert(CubeCalculator.cube(3) === 27)
       }
@@ -58,9 +58,9 @@ named after the object we're testing.
 Let's go over this line by line.
 
 * `class CubeCalculatorTest` means we are testing the object `CubeCalculator`
-* `extends FunSuite` lets us use functionality of ScalaTest's FunSuite class
+* `extends AnyFunSuite` lets us use functionality of ScalaTest's AnyFunSuite class
 such as the `test` function
-* `test` is function that comes from FunSuite that collects
+* `test` is function that comes from AnyFunSuite that collects
 results from assertions within the function body.
 * `"CubeCalculator.cube"` is a name for the test. You can call it anything but
 one convention is "ClassName.methodName".
@@ -72,9 +72,9 @@ indeed 27. The `===` is part of ScalaTest and provides clean error messages.
 1. Add another test block with its own `assert` statement that checks for the cube of `0`.
 
     ```
-      import org.scalatest.FunSuite
+      import org.scalatest.funsuite.AnyFunSuite
     
-      class CubeCalculatorTest extends FunSuite {
+      class CubeCalculatorTest extends AnyFunSuite {
           test("CubeCalculator.cube 3 should be 27") {
               assert(CubeCalculator.cube(3) === 27)
           }

_getting-started/sbt-track/testing-scala-with-sbt-on-the-command-line.md

@@ -39,9 +39,9 @@
 <script src="{{ site.baseurl }}/resources/js/vendor/unslider.js" type="text/javascript"></script>
 
 <!-- Highlight -->
-<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.9.0/highlight.min.js" type="text/javascript"></script>
-<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.9.0/languages/scala.min.js" type="text/javascript"></script>
-<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/9.9.0/languages/java.min.js" type="text/javascript"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/highlight.min.js" type="text/javascript"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/languages/scala.min.js" type="text/javascript"></script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/10.7.2/languages/java.min.js" type="text/javascript"></script>
 
 <!-- CodeMirror -->
 <script src="{{ site.baseurl }}/resources/js/vendor/codemirror/codemirror.js" type="text/javascript"></script>

_includes/footer.html

@@ -5,7 +5,7 @@ title: Scala Cheatsheet
 partof: cheatsheet
 
 by: Kenji Ohtsuka
-about: Thanks to <a href="https://brenocon.com/">Brendan O'Connor</a>. このチートシートは Scala 構文 のクイックリファレンスとして作成されました。 Licensed by Brendan O'Connor under a CC-BY-SA 3.0 license.
+about: Thanks to <a href="https://brenocon.com/">Brendan O'Connor</a>. このチートシートは Scala 構文 のクイックリファレンスとして作成された。 Licensed by Brendan O'Connor under a CC-BY-SA 3.0 license.
 
 language: ja
 ---

_ja/cheatsheets/index.md

@@ -1,13 +1,47 @@
 ---
-layout: inner-page-documentation
+layout: documentation
 title: ドキュメント
 language: ja
-partof: documentation
-discourse: true
+more-resources-label: その他のリソース
+
 
 # Content masthead links
-more-resources-label: その他のリソース
-sections:
+
+scala3-sections:
+  - title: "First steps"
+    links:
+      - title: "Scala 3 の新機能"
+        description: "Scala 3 で追加されたさまざまな新機能の概要"
+        icon: "fa fa-star"
+        link: /ja/scala3/new-in-scala3.html
+      - title: "Scala 3 をはじめる"
+        description: "あなたのコンピューターに Scala 3 をインストールしてScalaコードを書きはじめよう!"
+        icon: "fa fa-rocket"
+        link: /ja/scala3/getting-started.html
+      - title: "Scala 3 Book"
+        description: "主要な言語仕様のイントロダクションをオンラインブックで読む"
+        icon: "fa fa-book"
+        link: /scala3/book/introduction.html
+  - title: "More detailed information"
+    links:
+      - title: "Migration Guide"
+        description: "Scala 2 から Scala 3 へ移行するためのガイド"
+        icon: "fa fa-suitcase"
+        link: /scala3/guides/migration/compatibility-intro.html
+      - title: "Guides"
+        description: "Scala 3 の言語仕様からピックアップして解説"
+        icon: "fa fa-map"
+        link: /ja/scala3/guides.html
+      - title: "API"
+        description: "Scala 3 の全バージョンのAPIドキュメント"
+        icon: "fa fa-file-text"
+        link: https://dotty.epfl.ch/api/index.html
+      - title: "Language Reference"
+        description: "Scala 3 の言語仕様"
+        icon: "fa fa-book"
+        link: https://dotty.epfl.ch/docs/reference/overview.html
+
+scala2-sections:
 
   - title: "最初のステップ"
     links:

_ja/index.md

@@ -60,7 +60,7 @@ Scala のコレクションは、体系的に可変および不変コレクシ
 
 [![Mutable collection hierarchy][3]][3]
 
-図の伝説:
+図の凡例:
 
 [![Graph legend][4]][4]
 

_ja/overviews/collections/overview.md

@@ -108,7 +108,7 @@ JVM は値クラスをサポートしないため、Scala は場合によって
 
 メモリ割り当ては必要無い。
 値クラスが型引数として使われる場合もこのルールがあてはまる。
-例えば、`identify` を呼び出すだけでも `Meter` インスタンスの実体が作成されることが必要となる:
+例えば、`identity` を呼び出すだけでも `Meter` インスタンスの実体が作成されることが必要となる:
 
     def identity[T](t: T): T = t
     identity(Meter(5.0))

_ja/overviews/core/value-classes.md

@@ -0,0 +1,58 @@
+---
+layout: inner-page-documentation
+overview-name: "Scala 3 Documentation"
+title: Contributing to the Docs
+language: ja
+scala3: true
+---
+
+## 概要
+Scala 3 の高品質なドキュメンテーションを作るためのいくつかの試みが目下進行中である。
+特に次のようなドキュメントがある。
+
+- Scala 3 book
+- Macros tutorial
+- Migration guide
+- Scala 3 language reference
+
+ドキュメンテーションの種類に関わらずコミュニティからのコントリビューションを歓迎する。
+
+
+### コントリビューションの仕方
+さまざまな方法で私たちを支援することができる :
+- **ドキュメントのどこかで混乱するところがある** Issue をたてる。
+- **最新の状態を反映していないドキュメントがある** Issue をたてるか、PR をつくる。
+- **タイポの修正やその他ちょっとした文章の改善** PR をつくる。
+- **なにかを新しく追加したり大きな変更を加えたい**  議論できるよう Issue をたてる。
+
+通常、ドキュメントプロジェクトのそれぞれには編集・改善用のリンクが含まれている。(このドキュメントについても同様で、目次の領域にある。) また、コントリビューションをはじめるために必要な情報は以下に記載されている。
+
+## Scala 3 Book
+[Scala 3 Book][scala3-book] は Alvin Alexander 氏 が書いている。 この本は Scala 3 のすべての重要な機能の概説書である。これから Scala を使いはじめる読者を対象にしている。
+
+- [Sources](https://github.com/scala/docs.scala-lang/tree/master/_overviews/scala3-book)
+- [Issues](https://github.com/scala/docs.scala-lang/issues)
+
+## Macros Tutorial
+[Macros Tutorial](/scala3/guides/macros)は Nicolas Stucki 氏 が書いている。この本では Scala 3 のマクロとそのベストプラクティスについて詳しく説明している。 
+
+- [Sources](https://github.com/scala/docs.scala-lang/tree/master/_overviews/scala3-macros)
+- [Issues](https://github.com/scala/docs.scala-lang/issues)
+
+## Migration Guide
+[Scala 3 Migration Guide](/scala3/guides/migration/compatibility-intro.html) は Scala 2 と Scala 3 の互換性、移行に役立つツールの紹介、そして詳しい移行のガイドを含んだ包括的なドキュメントである。
+
+- [Contribution Overview](https://scalacenter.github.io/scala-3-migration-guide/docs/contributing.html)
+- [Source](https://github.com/scalacenter/scala-3-migration-guide)
+- [Issues](https://github.com/scalacenter/scala-3-migration-guide/issues)
+
+
+## Scala 3 Language Reference
+The [Dotty reference](https://dotty.epfl.ch/docs/reference/overview.html) は Scala 3 になる予定である。これにはさまざまな言語仕様に関する公式のプレゼンテーションや技術的情報が含まれている。
+
+- [Sources](https://github.com/lampepfl/dotty/tree/master/docs/docs/reference)
+- [Issues](https://github.com/lampepfl/dotty/issues)
+
+
+[scala3-book]: {% link _overviews/scala3-book/introduction.md %}
+