Feature proposal: New, Standard Documentation System

Matej Cepl mcepl at redhat.com
Mon Dec 1 08:28:53 UTC 2008

On 2008-12-01, 01:45 GMT, Michael Cronenworth wrote:
> Man pages, while informative, are limited. If examples or 
> detailed information are required then you're back to Google 
> searching.

Yes, there are many manpages which are pretty bad. But expanding 
content won't happen by switching to different format, but fixing 
each manpage. Yes, one at the time.

> Two hours? I should hope to create something in 10 minutes.

Two hours include learning curve. After writing one manpage and 
learning how to do it, including collecting appropriate tools, it 
should be as fast as writing with anything else. I don't think 
that two hours of learning is too high price for creating 
structured, long-lasting documentation.



More information about the fedora-devel-list mailing list