A Though on Redundancy of Community Wiki and Other Forms of Support

[Tom Davies]

Hi :)
Community Documentation definitely (to my mind at least) has it's own
unique advantages.  I don't think it should try to copy what is
already done in official docs.

This team might sometimes find updates or interesting points in
community docs that could useful be added to the official docs. Mostly
i think the official docs should leave it up to the user to explore
further afield for other documentation.  It is good to make people
aware of community documentation but the community documentation is
fairly volatile so it's risky for official documentation to link to
specific pages.  There are obviously going to be cases where it is a
good idea.

Some of the community pages are more stable than the official pages.
I think Community Docs should link to the official docs, upstream
documentation and other resources as much as reasonably possible,
rather than trying to copy things that already exist.  On the other
hand there are occasionally external resources that might disappear
one day and might be worth copying.  An example is one of the articles
our "Antivirus" page links to.  It's an extremely broad-brush-strokes
general overview that is unlikely to change any decade soon.


Where upstream documentation is poor or non-existent then community
docs is an excellent place!

I found it interesting that the upstream documentation for Joomla was
not particularly good for Ubuntu users.  I know the parts i needed as
a normal user using an external hosting service weren't there but i
had thought they probably covered the server-side stuff quite well.
Interesting to hear they weren't very receptive to people helping them
with that either!

Regards from
Tom :)




On 3 December 2013 00:54, Svetlana Belkin <barsookmud at yahoo.com> wrote:
> On 12/02/2013 07:38 PM, Svetlana Belkin wrote:
>> On 12/02/2013 05:48 PM, Gunnar Hjalmarsson wrote:
>>> On 2013-12-02 14:40, Jonathan Aquilina wrote:
>>>> I feel community docs should be a replication of the official docs
>>>> but where any amendments or fixes can take place.
>>>
>>> Isn't making amendments to and fixes of the *official* docs the very
>>> reason why this team exists?
>>
>> Yes, but to me, that's more for the desktop/system docs, if there was a
>> PPA for them to be up to date as they get updated by the comitors. But
>> the Community Wiki, in my mind, is for (again) "docs" to programs that
>> don't come pre-installed with Ubuntu.  The stuff in the Center.
>>
>> Svetlana Belkin
>>
>
> I meant server not system.
>
> --
> https://wiki.ubuntu.com/belkinsa
>
> --
> ubuntu-doc mailing list
> ubuntu-doc at lists.ubuntu.com
> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc