3 ms·
ArchWiki[1] is a counterexample to the notion that the community cannot write good technical documentation. It is actually much better written and more thorough
by zelly 6y ago
ArchWiki[1] is a counterexample to the notion that the community cannot write good technical documentation. It is actually much better written and more thorough than MDN, but it's also concerning a topic that attracts many hobbyists. To be fair, web dev is not something many people do without being paid, as opposed to tinkering with Linux, so the talent pool may be smaller.
Also, the W3C and ECMA standards documents are all free and are more authoritative references than any wiki. It would be interesting to see if a language model e.g. GPT-3 could translate the standardese into something more readable to laymen.
https://wiki.archlinux.org/ https://wiki.archlinux.org/
- potatoz2 6y agoArchWiki is a good counterexample (so is Wikipedia I guess), but the W3C and ECMA specs are not: they document what ought to happen and are geared towards implementation, not what actually happens in practice or how to build a mental model about what happens.