Hacker News new | ask | show | jobs
by spondylosaurus 356 days ago
I'm a little biased, but as a tech writer who doesn't think they'll be made obsolete by swaggerless LLMs any time soon I strongly agree. If you've written enough docs and sufficiently internalized all the stylistic best practices, putting words in order is the easy part; I could do that in my sleep. But technical writing is like 20% writing and 80% research, fact-checking, QA, diplomacy, and searching for (metaphorical) unexploded ordinances that could blow up in users' faces if you don't direct them down the right path.

I would guess some of the vibes you mention come down to actual writing style, which I have plenty of opinions on (some of them controversial among my fellow writers!), but I think there's another subtler aspect of reading something that really anticipates your needs as a user and feeling like you're in good hands. It's something I don't always nail, but I always notice when I read docs that do.