Well, I use POD/perldoc. I find it very appealing for the following reasons:

• It's integral to the code (if I want it to be), so I'm less likely to forgot to update doc when I change the code.
• POD can be exposed at run-time using modules like Pod::Usage -- so with just a little bit of planning, the documentation can double as help/manpage info for your users.
• POD doesn't require any extra tools, which is nice if you're developing on and deploying to multiple systems.
• It's easy to convert POD to plain text, HTML, and a variety of other output flavors.
• Various Pod::* modules give me other ways to manipulate the POD contents. For example, I can write a pre-deployment check that makes sure my POD contains correct copyright notices and so on.

Of course, if there's something better out there I'd love to know about it too. But looking at the doc for RoboDoc -- I haven't actually used it -- makes it seem like it offers POD-like functionality but not a lot of extras that would compel me to switch.

---

---

Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!

Titles consisting of a single word are discouraged, and in most cases are disallowed outright.

Read Where should I post X? if you're not absolutely sure you're posting in the right place.

Please read these before you post! —

• How do I compose an effective node title?
• How do I post a question effectively?
• Markup in the Monastery

Posts may use any of the Perl Monks Approved HTML tags:

a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr

You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)

	For:		Use:
	&		&
	<		&lt;
	>		&gt;
	[		&#91;
	]		&#93;

Link using PerlMonks shortcuts! What shortcuts can I use for linking?

See Writeup Formatting Tips and other pages linked from there for more info.