wiki vs documentation

Jonathan Aquilina eagles051387 at gmail.com
Thu Sep 19 06:12:20 UTC 2013


Yes a wiki is nice to have, but again if man power is an issue why not
merge. There are other community sections such as the forums where people
can get help as well as IRC, but i feel up to date documentation is really
important


On Thu, Sep 19, 2013 at 8:10 AM, Benjamin Kerensa <bkerensa at ubuntu.com>wrote:

> Hi Jonathan,
>
> Probably not considering the lack of contributors at this time. As it is
> doc team has a difficult time getting official doc updated and released
> each cycle.
>
> You are more than welcome to solicit help but most of us already have our
> hands full.
>
>
> On Wed, Sep 18, 2013 at 11:05 PM, Jonathan Aquilina <
> eagles051387 at gmail.com> wrote:
>
>> is it possible to get help from doc team members to update the wiki with
>> things that have been discussed?
>>
>>
>> On Thu, Sep 19, 2013 at 7:56 AM, Tom Davies <tomdavies04 at yahoo.co.uk>wrote:
>>
>>> 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
>>>
>>>
>>>
>>
>>
>> --
>> Jonathan Aquilina
>>
>> --
>> ubuntu-doc mailing list
>> ubuntu-doc at lists.ubuntu.com
>> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>>
>>
>
>
> --
> *Benjamin Kerensa*
> *http://benjaminkerensa.com*
> *"I am what I am because of who we all are" - Ubuntu*
>



-- 
Jonathan Aquilina
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20130919/8def9f65/attachment-0001.html>


More information about the ubuntu-doc mailing list