News for hackers. Stuff that matters.
Re:Things People Hate about Your Open Source Docs by takluyver on Friday June 21, 2013 @12:59PM (#5919290)
I think people now like documentation in lots of different forms - manpages, HTML, pdf, or introspectable docs like Python docstrings. IPython, for example, has all four of those.

There are systems like Sphinx that let you share content between different formats, but they're not magic bullets. For instance, if I write docs relying on inline links because I'm used to viewing them in HTML, the result won't be great for manpage readers.

There are no comments on this comment yet.