Hacker News new | ask | show | jobs
by BiteCode_dev 1893 days ago
I love this doc because while it's not staying the whole story, it was basically my conclusion as well: you can't have one doc, you need several of them for different use cases.

I would had to the mix a page where jargon is defined, like a lexicon. You cannot, and should not always get away with jargon. Sometime you should (beginner tutorial), sometime you should define it inline (advanced tutorial), and sometime you should just use it (references), but with link it to the definition.

1 comments

I would consider "a page where jargon is defined, like a lexicon" to be a perfect example of reference material.