Hacker News new | ask | show | jobs
by afarrell 2236 days ago
> I still do not know how to write its blog posts or documentation.

Honestly, I've often found that writing documentation alone is a bad use of time. If it wasn't written as part of design or development, the first draft of documentation is always going to suffer from the problem of bridging the gap between knowing the system well and knowing what a knowledge-lacking reader needs.

I submit to y'all that docs should almost always be a pair-programming exercise between a developer who is highly knowledgable and a developer as close to the target audience as you can get. There are plenty of more junior devs on codementor.io or /r/learnprogramming who can help.

Either individual alone will easily flounder or write prose with a bad UX.