Merge branch 'scala:main' into main

Author: mariogalic

.github/CODEOWNERS

@@ -0,0 +1 @@
+/_ja @scala/docs-ja

.github/dependabot.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/workflows/build.yml

@@ -22,11 +22,11 @@ jobs:
         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.
+          # # Checking for docs.scala-lang/blob/main 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/'
+             --url-ignore '/https://github.com/scala/docs.scala-lang/blob/main/.*/,/www.oracle.com/'
 

.gitignore

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

Dockerfile

@@ -0,0 +1,11 @@
+FROM ruby:2.5
+
+RUN gem install bundler jekyll
+
+WORKDIR /srv/jekyll
+
+COPY Gemfile .
+COPY Gemfile.lock .
+
+RUN bundle install
+

Gemfile.lock

@@ -4,14 +4,14 @@ GEM
     addressable (2.7.0)
       public_suffix (>= 2.0.2, < 5.0)
     colorator (1.1.0)
-    concurrent-ruby (1.1.7)
-    em-websocket (0.5.1)
+    concurrent-ruby (1.1.8)
+    em-websocket (0.5.2)
       eventmachine (>= 0.12.9)
       http_parser.rb (~> 0.6.0)
     ethon (0.12.0)
       ffi (>= 1.3.0)
     eventmachine (1.2.7)
-    ffi (1.13.1)
+    ffi (1.15.0)
     forwardable-extended (2.6.0)
     html-proofer (3.15.3)
       addressable (~> 2.3)
@@ -24,7 +24,7 @@ GEM
     http_parser.rb (0.6.0)
     i18n (0.9.5)
       concurrent-ruby (~> 1.0)
-    jekyll (3.9.0)
+    jekyll (3.9.1)
       addressable (~> 2.4)
       colorator (~> 1.0)
       em-websocket (~> 0.5)
@@ -37,7 +37,7 @@ GEM
       pathutil (~> 0.9)
       rouge (>= 1.7, < 4)
       safe_yaml (~> 1.0)
-    jekyll-redirect-from (0.15.0)
+    jekyll-redirect-from (0.16.0)
       jekyll (>= 3.3, < 5.0)
     jekyll-sass-converter (1.5.2)
       sass (~> 3.4)
@@ -50,27 +50,27 @@ GEM
     kramdown-parser-gfm (1.1.0)
       kramdown (~> 2.0)
     liquid (4.0.3)
-    listen (3.2.1)
+    listen (3.5.1)
       rb-fsevent (~> 0.10, >= 0.10.3)
       rb-inotify (~> 0.9, >= 0.9.10)
     mercenary (0.3.6)
-    mini_portile2 (2.5.0)
-    nokogiri (1.11.1)
+    mini_portile2 (2.5.1)
+    nokogiri (1.11.4)
       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)
+    public_suffix (4.0.6)
     racc (1.5.2)
     rainbow (3.0.0)
-    rb-fsevent (0.10.4)
+    rb-fsevent (0.11.0)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
-    rexml (3.2.4)
-    rouge (3.22.0)
+    rexml (3.2.5)
+    rouge (3.26.0)
     safe_yaml (1.0.5)
     sass (3.7.4)
       sass-listen (~> 4.0.0)

_books/2-programming-scala.md

@@ -1,11 +1,11 @@
 ---
 title: "Programming Scala"
-link: https://shop.oreilly.com/product/0636920033073.do
+link: http://programming-scala.com
 image: /resources/img/books/ProgrammingScala-final-border.gif
-status: Updated for Scala 2.12
-authors: ["Alex Payne", "Dean Wampler"]
+status: Updated for Scala 3
+authors: ["Dean Wampler"]
 publisher: O’Reilly
 publisherLink: https://www.oreilly.com/
 ---
 
-Both are industry experts, Alex Payne being the lead API programmer at Twitter, a social networking service based on Scala. O’Reilly, the publisher, writes: "Learn how to be more productive with Scala, a new multi-paradigm language for the Java Virtual Machine (JVM) that integrates features of both object-oriented and functional programming. With this book, you'll discover why Scala is ideal for highly scalable, component-based applications that support concurrency and distribution. You'll also learn how to leverage the wealth of Java class libraries to meet the practical needs of enterprise and Internet projects more easily."
+Dean is a well-known member of the Scala community, using Scala recently for streaming data systems at Lightbend and now at Domino Data Lab. This edition covers the new features of Scala 3, with comparisons to Scala 2, both to explain why the changes were made and how they improve Scala, and also to enable developers using mixed Scala 2 and 3 code bases to work effectively. The book is aimed at professional programmers who want a comprehensive, in-depth, yet pragmatic tour of Scala and best practices for using it.

_config.yml

@@ -15,9 +15,9 @@ keywords:
 - Document
 - Guide
 
-scala-version: 2.13.5
-scala-212-version: 2.12.13
-scala-3-version: 3.0.0-RC1
+scala-version: 2.13.6
+scala-212-version: 2.12.14
+scala-3-version: 3.0.0
 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"

_data/compiler-options.yml

@@ -611,9 +611,22 @@
   - option: "-Vimplicits"
     schema:
       type: "Boolean"
-    description: "Show more detail on why some implicits are not applicable."
+    description: "Print dependent missing implicits."
     abbreviations:
     - "-Xlog-implicits"
+  - option: "-Vimplicits-verbose-tree"
+    schema:
+      type: "Boolean"
+    description: "Display all intermediate implicits in a chain."
+  - option: "-Vimplicits-max-refined"
+    schema:
+      type: "Int"
+      default: "0"
+    description: "max chars for printing refined types, abbreviate to `F {...}`"
+  - option: "-Vtype-diffs"
+    schema:
+      type: "Boolean"
+    description: "Print found/required error messages as colored diffs."
   - option: "-Vinline"
     schema:
       type: "String"

_data/overviews.yml

@@ -254,6 +254,11 @@
       icon: cog
       url: "compiler-options/index.html"
       description: "Various options to control how scalac compiles your code."
+    - title: Error Formatting
+      by: Torsten Schmits
+      icon: cog
+      url: "compiler-options/errors.html"
+      description: "A new engine for more user-friendly error messages, printing chains of dependent implicits and colored found/required type diffs."
 
 
 - category: Legacy