Feature proposal: New, Standard Documentation System

[Richard W.M. Jones]

On Wed, Nov 26, 2008 at 08:28:55PM -0600, Michael Cronenworth wrote:
> Far too often I find myself looking for non-existent man pages, Google  
> results, or help menus in GNU/Linux software. What's the problem? There  
> is no single, reliable, standardized documentation system that is  
> universally accepted or appreciated. Yes, what I'm about to describe  
> should obsolete man, info, and all the other dozen "help" documentation  
> found in all the Fedora packages.

Debian forces all programs to come with a man page.  If one is
missing, this is considered a bug and packagers have to write one.

http://www.debian.org/doc/debian-policy/ch-docs.html

This would be an excellent idea for Fedora to follow (and we can,
license permitting, use the Debian man pages).

Rich.

-- 
Richard Jones, Emerging Technologies, Red Hat  http://et.redhat.com/~rjones
virt-p2v converts physical machines to virtual machines.  Boot with a
live CD or over the network (PXE) and turn machines into Xen guests.
http://et.redhat.com/~rjones/virt-p2v