Hacker News new | past | comments | ask | show | jobs | submit login
Tell HN: Hire Technical Writers
1 point by remoquete on July 19, 2023 | hide | past | favorite | 1 comment
I often read comments here on HN stating how difficult writing documentation is and how big of a chore it can be. _Writing is hard_, the HN hive mind seems to think. Well, you've a solution: Hire technical writers. I wrote a letter in my blog about this not long ago: https://news.ycombinator.com/item?id=36472637

Some of the responses to that thread were a bit depressing. Some conflated technical writing (documentation) with technical content marketing. Others said they'd never seen tech writers at their jobs before. Is technical writing so unknown? If it is, what would help you understand what it is about and how it can provide value to your team?




One example I often see to support the value of technical writing is MATLAB.

Among software engineers (and maybe even Hacker News) there is sometimes a distaste for MATLAB. But it still remains a widely used language and it is very respected outside of software engineering in research and engineering. One of the main benefits I see about MATLAB is that the documentation and support are so strong and make it easy to get started, especially for people without programming backgrounds.

I think this Reddit thread is a good example: https://www.reddit.com/r/matlab/comments/dxh520/why_is_matla.... Despite the title, almost every comment is praising the MATLAB docs.

For people who doubt the value of documentation, I think looking at MATLAB and Simulink (a billion dollar company) is a good example of the value of technical writing.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: