News for hackers. Stuff that matters.
Re:Ask HN: documentation format? by jakewolf on Friday March 14, 2008 @01:49PM (#136949)
Something formatted for 8.5" x 11" paper for printing out as a pdf and easy to navigate/search html.

How long are we really talking about?

Re:Ask HN: documentation format? by binglo on Friday March 14, 2008 @02:10PM (#136984)
I find that a plain text file longer than about a dozen pages in a terminal window -- containing more than a handful of sections and subsections -- becomes a pain in the neck to efficiently navigate around (during both reading and writing). A non-technical person might be reading such a document using Notepad.

So, we're talking about a doc that's getting a little too cramped being just a plain text file, and which might grow longer as time goes by.