概要
Scala 3 の高品質なドキュメンテーションを作るためのいくつかの試みが目下進行中である。 特に次のようなドキュメントがある。
- Scala 3 book
- Macros tutorial
- Migration guide
- Scala 3 language reference
ドキュメンテーションの種類に関わらずコミュニティからのコントリビューションを歓迎する。
コントリビューションの仕方
さまざまな方法で私たちを支援することができる :
- ドキュメントのどこかで混乱するところがある Issue をたてる。
- 最新の状態を反映していないドキュメントがある Issue をたてるか、PR をつくる。
- タイポの修正やその他ちょっとした文章の改善 PR をつくる。
- なにかを新しく追加したり大きな変更を加えたい 議論できるよう Issue をたてる。
通常、ドキュメントプロジェクトのそれぞれには編集・改善用のリンクが含まれている。(このドキュメントについても同様で、目次の領域にある。) また、コントリビューションをはじめるために必要な情報は以下に記載されている。
Scala 3 Book
Scala 3 Book は Alvin Alexander 氏 が書いている。 この本は Scala 3 のすべての重要な機能の概説書である。これから Scala を使いはじめる読者を対象にしている。
Macros Tutorial
Macros Tutorialは Nicolas Stucki 氏 が書いている。この本では Scala 3 のマクロとそのベストプラクティスについて詳しく説明している。
Migration Guide
Scala 3 Migration Guide は Scala 2 と Scala 3 の互換性、移行に役立つツールの紹介、そして詳しい移行のガイドを含んだ包括的なドキュメントである。
Scala 3 Contributing Guide
Scala 3 Contributing Guide Scala 3 コンパイラとライブラリへの貢献と内部に関する包括的な概要が含まれています
Scala 3 Language Reference
The Dotty reference は Scala 3 になる予定である。これにはさまざまな言語仕様に関する公式のプレゼンテーションや技術的情報が含まれている。