3 ms·
Good documentation is whatever actually gets written. This reminds me of all the “semantic web” dreams that never happened. > Good documentation is all about t
by paulsutter 7y ago
Good documentation is whatever actually gets written. This reminds me of all the “semantic web” dreams that never happened.
> Good documentation is all about the semantic markup. A “definition” is not just a different formatting or like. It means there’s actually a concept of a “definition” as a discrete concept in your documentation.
- criddell 7y agoThat section stood out to me as well. Semantic markup may be useful, but it's not the defining characteristic of good documentation.