News for hackers. Stuff that matters.
Re:Ask HN: documentation format? by kingkongrevenge on Friday March 14, 2008 @06:23PM (#137203)
POD. Learn it in 10 minutes. Generates all formats. Embeddable in code, if appropriate.

http://perldoc.perl.org/perlpod.html

Re:Ask HN: documentation format? by binglo on Friday March 14, 2008 @08:27PM (#137276)
Yes. Thank you. I like POD for man-page -style docs, but for longer multi-section docs I'm not sure it buys you much more than plain text (except that you can easily convert to other formats). Also, it's harder to read than plain text -- though maybe easier than docbook xml.

The POD docs I see as html are just single long html pages. I realize this is just an implementation issue though.