Hacker News new | ask | show | jobs
by smiler 4883 days ago
Can anyone look to good guides / examples on technical writing [for those of us who are developers who have to also write docs from time to time]
2 comments

Mark Phillips' beautiful docs list: https://github.com/PharkMillups/beautiful-docs
Check out https://readthedocs.org/ which is directly related to writethedocs.org. Here's a bit more instruction on how they're building up a repository of these docs: https://docs.readthedocs.org/en/latest/index.html
We're also trying to build a resource around this kind of information on docs.writethedocs.org. It just launched today as part of this, and is half baked. However, this is the start of that doc: http://docs.writethedocs.org/en/latest/starting.html

It isn't so much about how to write documentation, but adding that section is something we want to do.

We also have a section currently linked to a couple of interesting projects: http://docs.writethedocs.org/en/latest/about/alternatives.ht...