If we can also apply this to network engineers, that would be awesome. No more waiting 2 weeks for a firewall rule. But how many places actually have tech writers these days.. mostly devs will be asked to write documenation.
The problem is that AI generated content always has the same structure and grammatical style, and you absolutely still need to guide it in order to make good content.
Tech writers will become more productive, not obsolete.
MS started aggressively using AI to generate their documentation a year or two ago. It did not make things better at all, and in fact quite the contrary. Awkwardly verbose wording, contradictory sentences in different paragraphs of the same article, etc. That said, they were already on a trajectory of decline.
I've only worked with one tech writer; they have been a dying breed for a long time. Gone are the days when software shipped with doorstopper manuals. Only a big company can justify them now. For the rest, LLMs are good enough.
I spent half a day writing tests against MS SQL where tests would create a separate schema, do their business, then the schema dropped via "DROP SCHEMA ... CASCADE". In the end, thanks to Meat Intelligence on the web I found out there is no CASCADE for MS SQL. But only because blogs and documentation etc were written by people who kinda mostly checked what they wrote.
Sure, manually written API docs are a thing of the past. But this has been true even before the era of LLMs. But I'm not that sure that this argument stands for all kinds of software. Depending on the abstraction between your source code and the things your users want to achieve, the expert view of a technical communicator might be necessary in order to come up with instructions (how-to) that meet the needs of the person seeking help instead of just summarizing the software code in natural language.
16 comments
[ 4.1 ms ] story [ 37.1 ms ] threadTech writers will become more productive, not obsolete.
> This isn't a minor efficiency gain. It's a fundamental shift
> This isn't theoretical. It works today.
> The documentation stays accurate because it's generated from real code, not someone's memory of how things used to work.
Yes, because Claude never hallucinates.
People want to interact with other humans.
Hotel doorman problem etc.
AI does not take responsibility
Some of it was accurate.
Some of it was not.