wiki vs documentation

[Tom Davies]

Hi :)
They are very different things with different aims that catch different types of people.  To edit official documentation you kinda need to be a team-player and communicate with other people and negotiate for the things you would like to see.  


By contrast in the wiki individuals can just go ahead and do things, even add pages they feel might be of interest to other people or just to themselves.  


If a big change happens it's theoretically more likely that the wiki will be updated sooner while the official documentation is still going through various processes.  The wiki never gets frozen but the official documentation needs to be frozen so that translators have time to translate without the source of their work being at risk of constant change even mid-sentence.  You will see this happen over the next few days and even weeks because the official documentation is about to be (or maybe even has already been frozen) so we can't make fresh changes now and have to race existing things through if they are nearly complete and/or need to go in.  


Having the 2 systems is not a duplication of our effort although sometimes effort expended in one has a benefit to the other or makes it easier to fix the other.  

Regards from 

Tom :)  




________________________________
 From: Jonathan Aquilina <eagles051387 at gmail.com>
To: Phill Whiteside <phillw at vpolink.com> 
Cc: Ubuntu Doc <ubuntu-doc at lists.ubuntu.com> 
Sent: Thursday, 19 September 2013, 6:31
Subject: Re: wiki vs documentation
 


Why dont both get merged? the doc team works with the community etc seeing as man power is scarce?



On Thu, Sep 19, 2013 at 12:13 AM, Phill Whiteside <phillw at vpolink.com> wrote:

There are two areas of the wiki system, https://help.ubuntu.com/ and https://help.ubuntu.com/community The former is looked after by the doc team, the latter is maintained by the community.
>
>
>Regards,
>
>
>Phill.
>
>
>
>On 18 September 2013 22:50, Jonathan Aquilina <eagles051387 at gmail.com> wrote:
>
>What is the difference between the wiki and the official documentation? wouldnt it be better to grow the official documentation instead of maintain two instances of documentation?
>>
>>
>>
-- 
>>Jonathan Aquilina 
>>--
>>ubuntu-doc mailing list
>>ubuntu-doc at lists.ubuntu.com
>>https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>>
>>
>
>
>
>-- 
>https://wiki.ubuntu.com/phillw 


-- 
Jonathan Aquilina 
-- 
ubuntu-doc mailing list
ubuntu-doc at lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20130919/aadceb51/attachment.html>