I realise that with GNU 'info' a lot of developers become, dare I say it, quite lazy when it comes to providing a well written man page - and some argue they're not needed at all. But I find, in the products that I develop, that man pages are used more often for quick reference, and therefore the quality and usability of a product can be improved by providing well written man pages.
To that end, and because I've been writing man pages myself for over 10 years, I've decided to provide some notes for beginners on how to write your own man page. I hope this article is of help to the wider developer community:
Technical Prose: How to write a UNIX man page
Best regards,
Mark.