Feature proposal: New, Standard Documentation System

[Aioanei Rares]

On Thu, Nov 27, 2008 at 12:20 PM, Dominik 'Rathann' Mierzejewski <
dominik at greysector.net> wrote:

> On Thursday, 27 November 2008 at 11:06, Thorsten Leemhuis wrote:
> > On 27.11.2008 10:32, Richard W.M. Jones wrote:
> > >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).
> >
> > My 2 cent: It would be way better for everyone to get those man pages
> > upstream.
> >
> > One reason for that: If you add man pages from debian to a fedora
> > package then you have to recheck every now and then if the man pages are
> > still up2date. That afaics often tends to be forgotten (I'm guilty
> > myself here).
>
> +1. Also I'd make it a SHOULD item in review guidelines.
>
> Regards,
> R.
>
> --
> Fedora http://fedoraproject.org/wiki/User:Rathann
> RPMFusion http://rpmfusion.org | MPlayer http://mplayerhq.hu
> "Faith manages."
>        -- Delenn to Lennier in Babylon 5:"Confessions and Lamentations"
>
> --
> fedora-devel-list mailing list
> fedora-devel-list at redhat.com
> https://www.redhat.com/mailman/listinfo/fedora-devel-list
>


I agree, sometimes Fedora isn't regarded as the best documented distro out
there, and
that's bad.
-- 
Aioanei Rares
schaiba at fedoraproject.org
"China is a big country, inhabited by many Chinese." --Charles de Gaulle
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.fedoraproject.org/pipermail/devel/attachments/20081127/af533423/attachment.html