This is a list from a group of people (including me). I am posting it on their behalf.
- SAM documentation. It needs some love. Also, right now the first google result has a NSFW image just when you open the link: Explaining Scala SAM type | Abitrarily Idiosyncratic Randomness . The first link should be the Scala docs. As final addition, to get this issue resolved: SAM doesn't work with polymorphic functions · Issue #6904 · scala/scala3 · GitHub
- Macros and Metaprograming: The docs are really hard. All the info is actually there, but they are extreamly cryptic and I experience the effect of I see words, I understand meaning of each word, yet I do not understand all together. Maybe here the community would benefit of the huge literature about macros and meta programing done by Mateusz Kubuszok.
We support the already mention improvements. To name a few:
- Compiler flags for Scala 3 (not the migration guide, the actual flags, what they do and their values)
- Aligning Scala docs in Scala site with Scala 3 reference and change experimental into non-experimental when the features are stable.