3 ms·
That seems crazy. I feel like MDN documentation is done so well. It balances well between giving good examples, and yet still remaining exhaustive in what it de
by mostertoaster 5y ago
That seems crazy. I feel like MDN documentation is done so well. It balances well between giving good examples, and yet still remaining exhaustive in what it describes. Most extensive documentation ends up being less than useful and I have to fall back to just search results.
- hbn 5y agoI'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.
- amatecha 5y agoFor real? MDN's documentation is some of the best I've ever seen... Complete, frequently-updated documentation of all Web APIs including comprehensive examples of typical usages with clearly-worded explanations! It also links directly to the actual ECMAScript specs that define what the documentation is describing. I mean, how could it get any better?