Re: [gentoo-doc] Wiki, Take #whatever

[wireless]

Jose Luis Rivero wrote:

>> So, I'd like to hear what you think. Should we have a wiki? Why or why
>> not?

NO !!!

> What will be the propose of the wiki? More documentation? Written by
> anyone and hosted in gentoo.org? Without being sure about its quality
> first? If so, you have my "no, please".

>> There's no question that having a properly-administered wiki can be a
>> powerful asset. Look at Ubuntu, Debian, Arch, the Xfce wiki, etc. What
>> about Gentoo?

> Maybe I'm too ignorant but every time a look to Ubuntu or Debian wiki I
> wasn't able to be sure about the 'official','review','updated' state of
> the documentation.

> Summarizing:
>  - If you think we have problems in GDP, let's talk about them.
>  - Seems to me that people is thinking of using a wiki not as a result
>    of a process to solve a problem.
>  - I prefer quality over quantity. Every step done shouldn't touch the
>    Gentoo Documentation quality.
>  - If someone is thinking of us involved in the wiki review or admin
>    process and all its fun, please ask first.
>  - If someone is thinking of replacing docs with a wiki, I really
>    dislike the idea.

Sorry for the delayed response, I've been unplugged for a while.....


After reading the entire thread, a rather simple solution seems
obvious. The GDP or Infra or whatever official group should stay
out of the the wiki business, for many aforementioned reasons.


However, if  what ever the new wiki(s) pop up for the ashes of any
previous efforts, it seem like a natural place for 'official gentoo
folks' to peruse, parse, filter and/or glean information for good
ideas and (tested) content into one of the existing gentoo
semantics (GDP infra whatever), but leave the morass of a wiki to
the user community at large.

That way folks could first look to the trunk of Gentoo for docs
on a given subject and if nothing there exist, THEN go to any
of these community wikis.


For example, installing a webcam is pretty important and very, very
common among needs for any distro. Yet if you google for webcam,
install and gentoo, you get a variety of 'hash' mostly outdated.


Those talent folks within the official gentoo structure, should
recognize this and build docs somewhere, of high quality, that
walk a gentoo user through how to set up a capture card (ntsc/pal)
or a web cam.

But for every issue that really needs a good doc, there will be
many wikis with a variety of quality, mostly due to the lack of
maintenance over time.   Smart folks with lots of current
responsibilities, should stay focused on current goals.


However, as the external gentoo wikis mature, but the others
in the gentoo community, folks can glean good idea to increase
the officially maintained docs.

YMMV,

James