4 ms·
> people started writing higher quality documentation I think that's certainly the case. We went from raw, technical-specs style documentations revolving aroun
by axlee 6y ago
> people started writing higher quality documentation
I think that's certainly the case. We went from raw, technical-specs style documentations revolving around feature description towards a more usage-based documentation style, which is far more effective at answering the most common questions when approaching a new software: "How can I do X using this software? What if Y happen when trying to do X?"
Also, projects like Django and companies like Stripe provided great examples to follow when writing solid documentations for respectively frameworks and APIs and led the way to an overall higher quality of docs, by mimetism.
It also doesn't hurt that a well-documented product sells better and has easier adoption: maybe the popular software/frameworks/languages/APIs of today are not exactly the "best" of yesterday, but people naturally gravitated towards the better documented ones.