man pages - was: wiki vs documentation

[Tom Davies]

Hi :)  

Thanks for the clarification there.  


Ok, so we CAN post 'bug-reports' against the "man" pages even though it feels weird to be posting against documentation rather than programs/packages.  However it is slightly out of our control whereas our own wiki-pages can be directly edited by us fairly easily or at least is under our control.  What we learn by doing wiki-editing helps with official docs because i think they use the same mark-up/down.  Official docs have extra protocols, such as freezing, to help us fit in with other teams.  

Regards from
Tom :)





________________________________
 From: Stephen M. Webb <stephen.webb at canonical.com>
To: ubuntu-doc at lists.ubuntu.com 
Sent: Friday, 20 September 2013, 23:49
Subject: Re: man pages - was: wiki vs documentation
 

On 09/20/2013 05:53 PM, Little Girl wrote:
> Hey there,
> 
> Tom Davies wrote:
>> We should NOT be editing "man" pages.  They are primarily written
>> by devs for devs and sometimes just about understandable for tier3,
>> maybe tier2, IT Support.  They are NOT for general consumption

<snip />

It's incredibly unlikely an upstream would ask someone to look over
something that they're probably unaware of and almost certainly wouldn't consider important.

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.

-- 
Stephen M. Webb  <stephen.webb at canonical.com>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20130921/1c0b379d/attachment.html>