Scala documentation, web sites: What should be improved?

Documentation
22

Some small ways would be:

  1. Add an issue template for documentation for “New issue” in GitHub · Where software is built
    This would make it easier to document issues with the docs, given they are usually spotted in the middle of doing something else, and it’s not always possible to fix it directly
    It would also mean the issue directly gets tagged correctly, instead of someone needing to come assign a label to it
  2. Add a “issue with this page” button to the overlay of Reference pages (which links to the above)
  3. Add an edit button to the overlay of Reference pages
    There is one above the title, but it’s easy to miss, since usually mistakes are in the middle of pages, and you usually skim the title, since you knew where you were going
  4. When switching version, remember which page I’m on
    Example: From Match Types, changing version to 3.3 LTS brings me to Scala 3 and not to Match Types
3 Likes