Hacker News new | ask | show | jobs
by hu3 2273 days ago
Begs the question: Why isn't Mozilla funding this?

> At this point, the only person really writing docs is me, and I haven't had a ton of time lately either. So we haven't had a docs team meeting since August of 2018. There also aren't really docs RFCs these days. As such, this blog post isn't really announcing the end of the docs team as much as it is describing what is already true today.

3 comments

They used to, but it looks like that came with its own set of problems: https://words.steveklabnik.com/thank-u-next
I know... dotnet and Go aren't exactly hurting for effort for things like docs and tooling that take a project from good to great.
shame, I'm that weirdo that actually loves reading and writing docs.

If moz were paying, I'd happily sit and just rummage through the codebase adding docs to everything.

That said I think Django had the best policy on this. Rather than get someone to write docs, make docs a first class citizen. i.e No matter how good your code is, if you don't update/create the relevant docs your PR doesn't pass muster.

As a result Django has some of the best documentation out there with only Symfony's docs coming anywhere close.