man pages - was: wiki vs documentation

Lars Noodén lars.nooden at gmail.com
Sat Sep 21 10:08:28 UTC 2013


On 09/21/2013 01:49 AM, Stephen M. Webb wrote:
[snip]
> Much of the time man pages are actually added to a package by the 
> packagers, who are very often completely different people than the 
> upstream developers.
[snip]
> You generally don't have to join an upstream project to contribute 
> docs or manpages.  It's usually enough to file a bug against the 
> project with a correction attached.  It's the writing (content) 
> that's the difficult part, not the format or mechanic of inclusion.

So would it work to edit the manual page that was installed with the
package and upload that as an attachment to the bug report in Launchpad?
I think the barrier so far has been administrative and if the solution
were that easy, a lot of head way could be made in time for the next LTS.

These pages are important because they serve as the first line of
support for intermediate users and on up.  This includes, especially,
those taking care of other peoples' Ubuntu machines.

Regards,
/Lars




More information about the ubuntu-doc mailing list