http://www.perlmonks.org?node_id=176947


in reply to Writing Good Documentation

In the Free Software Management HOWTO there's a section on writing documentation that may be of interest.

Also check The Linux Documentation Project for other resources. Reading over the docs of some of the larger open source projects might not be a bad idea either.