Hacker News new | ask | show | jobs
by wyager 3574 days ago
The documentation is supposed to tell you what the language is, not exhaustively detail everything the language is not.
1 comments

No, it's supposed to teach people how to use the language. When a large fraction of your user base will be bringing a specific skill set, then you should generate documentation aimed at translating those skills!
You've described tutorial, not a language documentation set.