3 ms·
> They’re a small but mighty team that’s constantly overwhelmed I think this is an incredibly common situation. Personally speaking, I find that to be an excus
by BossingAround 5y ago
> They’re a small but mighty team that’s constantly overwhelmed
I think this is an incredibly common situation. Personally speaking, I find that to be an excuse. If a woefully understaffed team of tech writers got the budget for 15 new tech writers, that usually wouldn't solve the problem.
The main issue is developers who don't believe documentation is highly important.
The "we generate documentation, so we're covered" is exactly the attitude I'd describe as highly unproductive. Of course that's great, but auto-generated docs are a small part of what should be your overall documentation suite. It shouldn't become the developers' excuse for not spending more time on documentation.
Tech writers will very rarely write docs from zero. I wouldn't even be surprised if the tech writers at Apple had no access to the source code, in which case they can't possibly write the docs from zero.