Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

I believe it depends who the target audience is for the documentation.

Writing good documentation requires empathy. Writing good code does also. However, it's in general more difficult to empathise with someone who has a fundamentally different background than yourself. Some developers can write code other developers on their team will easily understand, but they're not necessarily able to understand the way less technically inclined individuals (or individuals with a different expertise) think.

Generally speaking, this is why UX is such an important field. Writing good documentation is about understanding the target audience, and being able to understand the user's journey - which may be very different than your own.



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

Search: