3 ms·
I'm legitimately curious what that person expects out of documentation. MDN has basically everything you could want. Simple explanation, examples in an an edit
by hbn 5y ago
I'm legitimately curious what that person expects out of documentation. MDN has basically everything you could want.
Simple explanation, examples in an an editor that can be played with and executed, argument names and explanations, browser compatibility, etc etc etc
Compared to the amount of languages where their documentation is a table auto-generated from code, it's everything I could dream of!
- Shared404 5y ago> I'm legitimately curious what that person expects out of documentation. MDN has basically everything you could want. w3schools style "Let me walk you through every step of the process" probably. It has it's place, I know I've found it useful in the past, but definitely not a place you want to stay in very long.
- hbn 5y agoMaybe, but I think MDN would be even more helpful for beginners. Compare the documentation for JavaScript's Math.pow() on each: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/pow https://developer.mozilla.org/en-US/docs/Web/JavaScript/Refe... https://www.w3schools.com/jsref/jsref_pow.asp https://www.w3schools.com/jsref/jsref_pow.asp W3 doesn't have much in terms of English explanation, has less examples, and their playground forwards you to another page as opposed to MDN where it's embedded.
- anitil 5y agoMDN documentation and Sqlite documentation stand out to me as some of the best around. The Cloudflare how-tos would be up there, if you stretch the definition of documentation
- hbn 5y agoTailwind CSS also has super nice documentation. Really quick omnisearch, and covers basically everything in-depth with good examples, and what CSS is generated from each class.