Get the latest tech news
Why is language documentation still so terrible?
Seriously, is there a good reason for this? I feel like I'm going crazy because almost every language doc I've looked at is legitimately awful in a bunch of obvious ways. It's not uncommon to see third party libraries updated by a single person that are better structured, more thorough, with better layouts than the official documentation upheld by the language team itself.
Look at the font-colors chosen with such intention- high-contrast, near-white for plain text, low-contrast grey for the less-important "stable since" version number, vivid orange for the links, with a darker background for code-links. The tiny little 3 dot menu in the top right corner opens up the nav-pane that people actually want, but only after an additional click on "Table of Contents" because why bother making it easy or convenient. Release types/support timeline/naming scheme at the bottom, beneath this massive list, but you don't have a table of contents so nobody's ever going to know it exists and there are no header links so if you want to show someone you have to say "yeah just keep scrolling for about 15 years it's definitely down there"
Or read this on Hacker News