4 ms·
Honestly most techdoc writers have never really used their products in production. You are lucky if they have built their own test and sample apps. So the solu
by verst 7y ago
Honestly most techdoc writers have never really used their products in production. You are lucky if they have built their own test and sample apps.
So the solution is having the engineers building the service write the documentation right? Wrong. They also don't know what assumptions a real customer makes and how they would use it. Quite likely they too don't understand real external production use.
Writing technical documentation is hard.
- Ididntdothis 7y ago"Writing technical documentation is hard." So true. Good documentation can make or break a platform. I think a big part of the success of C++ is that Stroustrup is an excellent writer. A lot of the posts I have seen from Linus were also very well written. In the 90s Apple had documentation that seemed written by people who actually knew how to develop software. Nowadays it feels less so.
- thu2111 7y agoIt's much easier to get platform developers to write sample apps using their own platform than it is to get techdoc writers to do so though.