Add scala3 docs translated in Japanese

[i10416]

Hi! I partly translated scala3 docs in Japanese!

If there's anything to change, please tell me.

TODO

• improve getting-started guide
• translate some sentences yet to be done

[i10416]

I can not figure out why Ci failed since it works well locally.

[griggt]

The CI failure may be related to the recent purge of old documentation: scala/scala-lang#453 (comment)

[exoego]

Suggested change

	[Scala 3 Book][scala3-book] は Alvin Alexander 氏 が書いています。 この本はScala 3 のすべての重要な機能の概説書です。これから Scala を使いはじめる読者を対象にしています。
	[Scala 3 Book][scala3-book] は Alvin Alexander 氏 が書いています。 この本は Scala 3 のすべての重要な機能の概説書です。これから Scala を使いはじめる読者を対象にしています。

[exoego]

Suggested change

	Scalaのインストーラツールの"Coursier"を使うのがおすすめです。Coursierを使えばインストールが必要なものすべてを自動でインストールできます。 もちろん、手動でそれぞれのツールをインストールすることもできます。最低限 Java、sbt があれば Scala のコードを書き始められます。
	Scala のインストーラツールの "Coursier"を使うのがおすすめです。Coursier を使えばインストールが必要なものすべてを自動でインストールできます。 もちろん、手動でそれぞれのツールをインストールすることもできます。最低限 Java、sbt があれば Scala のコードを書き始められます。

[exoego]

ひらがなが続いて区切りが分かりにくく思いました

Suggested change

	Scala をインストールするということはつまりさまざまなコマンドラインツールやビルドツールをインストールするということです。
	Scala をインストールするということはつまり、さまざまなコマンドラインツールやビルドツールをインストールするということです。

[exoego]

Suggested change

	コマンドライン、IDEのどちらからでも sbt プロジェクトを作成できます。
	コマンドライン、IDE のどちらからでも sbt プロジェクトを作成できます。

[exoego]

翻訳漏れのようです

[exoego]

Suggested change

	以下では Scala 3 のコンパイラ、REPLと Scala 3 をインストールする手順を説明します。
	以下では Scala 3 のコンパイラ、REPL と Scala 3 をインストールする手順を説明します。

[exoego]

Suggested change

	- **Polymorphic function types**. dependent function types のように Scala 2 では型パラメタを受け取るメソッドを定義することができました。 しかし、開発者はこれらのメソッドをさらに抽象化することはできませんでした。Scala 3 では、`[A] => List[A] => List[A]` といった書き方をする[polymorphic function types][types-polymorphic] を使って引数に加えて型引数をとるような関数を抽象化できます。
	- **Polymorphic function types**. dependent function types のように Scala 2 では型パラーメタを受け取るメソッドを定義することができました。 しかし、開発者はこれらのメソッドをさらに抽象化することはできませんでした。Scala 3 では、`[A] => List[A] => List[A]` といった書き方をする[polymorphic function types][types-polymorphic] を使って引数に加えて型引数をとるような関数を抽象化できます。

[i10416]

「パラメタ」または「パラメータ」が一般的だと思うのですがどうでしょうか。

[exoego]

あ、本当ですね、パラメータにしたつもりが TYPO してました… 😅

Suggested change

	- **Polymorphic function types**. dependent function types のように Scala 2 では型パラメタを受け取るメソッドを定義することができました。 しかし、開発者はこれらのメソッドをさらに抽象化することはできませんでした。Scala 3 では、`[A] => List[A] => List[A]` といった書き方をする[polymorphic function types][types-polymorphic] を使って引数に加えて型引数をとるような関数を抽象化できます。
	- **Polymorphic function types**. dependent function types のように Scala 2 では型パラメータを受け取るメソッドを定義することができました。 しかし、開発者はこれらのメソッドをさらに抽象化することはできませんでした。Scala 3 では、`[A] => List[A] => List[A]` といった書き方をする[polymorphic function types][types-polymorphic] を使って引数に加えて型引数をとるような関数を抽象化できます。

日本語訳では "パラメータ" の訳が使われており、"パラメタ" は見当たらないようなので、パラメータにするのがよさそうです。

[exoego]

Suggested change

	Scala は常に関数型プログラミングとオブジェクト指向プログラミングの間のフロンティアにあります。そしてScala 3 はその境界を両方に広げます。
	Scala は常に関数型プログラミングとオブジェクト指向プログラミングの間のフロンティアにあります。そして Scala 3 はその境界を両方に広げます。

[exoego]

Suggested change

	先に言及した型システムの変更とcontextual abtstractions の再設計によって、関数型プログラミングを以前にも増して簡単に書けるようになりました。
	先に言及した型システムの変更 とcontextual abtstractions の再設計によって、関数型プログラミングを以前にも増して簡単に書けるようになりました。

[exoego]

Suggested change

	- **Composition over inheritance**. このフレーズはしばしば引用されますが、実装するのは面倒です。 しかしScala 3 の [export clauses][oo-export]を使えば楽になります。imports と対称的に、 export clauses はオブジェクトの特定のメンバーへアクセスするためのエイリアスを定義します。
	- **Composition over inheritance**. このフレーズはしばしば引用されますが、実装するのは面倒です。 しかし　Scala 3 の [export clauses][oo-export]を使えば楽になります。imports と対称的に、 export clauses はオブジェクトの特定のメンバーへアクセスするためのエイリアスを定義します。

[exoego]

Suggested change

	- **No more NPEs**. Scala 3 はかつてないほどnull安全です。: [explicit null][oo-explicit-null] によって `null` を型ヒエラルキーの外側に追い出しました。これによってエラーを静的にキャッチしやすくなります。また、 [safe initialization][oo-safe-init]の追加的なチェックで初期化されていないオブジェクトへのアクセスを検知できます。
	- **No more NPEs**. Scala 3 はかつてないほど null 安全です。: [explicit null][oo-explicit-null] によって `null` を型ヒエラルキーの外側に追い出しました。これによってエラーを静的にキャッチしやすくなります。また、 [safe initialization][oo-safe-init]の追加的なチェックで初期化されていないオブジェクトへのアクセスを検知できます。

[i10416]

Thank you for your corrections!

[exoego]

LGTM from Japanese speaker POV

[SethTisue]

@eed3si9n want to give it a once-over, or shall we just merge it at this point?

[eed3si9n]

@SethTisue I might be able to nipick a bunch of things, but I'm in favor of merging since it went through a good review by exoego-san already.

Something to note is that the tone is adopted by @ItoYo16u -san is a polite form. In Japanese there are different degrees of politeness built into the basic grammar, and when I lead the translation of Scala 2.x documentation (for instance at https://github.com/scala/docs.scala-lang/blob/master/_ja/overviews/collections/overview.md) I intentionally chose plain form (常体) often called da-dearu style (だ・である調). By convention, academic papers and technical reports are written using the plain form, including the Japanese translation for Odersky, Spoon, Venners 'Programming in Scala.'

On the other hand, the translation here uses polite form (敬体) or desu-masu style (です・ます調). The polite form is the business casual of the Japanese language, and blogs including corporate blogs like Google Japan and emails often use it. Ruby's entire reference manual is in polite form as well. It's the safe default, but in my opinion it sounds more like a corporate blog post and less like a technical document.

Again, I'm not vetoing this PR because of this, but I feel like this is something we should be aware of, and potentially revisit later.

[i10416]

Thank you for your advice. I will rewrite in da-dearu style soon.

[i10416]

I finished rewriting in plain form.

[eed3si9n]

@ItoYo16u コントリビューションありがとうございます。Thanks for the contribution! 🙇