Re: [gentoo-dev] [Gentoo Phoenix] an official Gentoo wiki

[Arun Raghavan <ford_prefect@gentoo.org>]

On 4 April 2010 13:01, Joshua Saddler <nightmorph@gentoo.org> wrote:
[...]
>> I am not pushing for our existing documentation to be migrated into a
>> wiki at this point. But I think that once the place is there, and it
>> functions well, it would be the obvious next step to do so. As I said
>> before, the barrier to contributing and maintaining documentation is
>> much higher in the case of GuideXML, so it doesn't really make sense
>> to keep that around when we have a better solution.
>>
>> I know there are people who do not agree with me on this last point
[... lots of good reasons to keep the documentation in GuideXML ...]

I think the docs team has put in a huge amount of effort for a long
time now to make well-formatted, easily readable documentation, and
there really isn't a wiki solution out there that is remotely
comparable.

GuideXML isn't that hard to pick up, and I'm sure the docs team would
be happy to help someone who's having trouble figuring out how to do
something with it. So I *really* don't see "ease-of-use" being a good
excuse for replacing GuideXML with a wiki. The difference in ease is
not that high.

[...]
> I ain't out to stop ya'll from using a wiki. I do agree that they have some advantages. However, I will point out how limited wikis are. They're not a magic bullet that will solve all our problems.

Again, I agree. We _should_ have a wiki for easy note-taking,
maintaining todo lists, possibly even meeting minutes. But our
official documentation should go through sufficient review and
formatting to make sure we maintain the quality of documentation that
we have had so far.

Cheers,
-- 
Arun Raghavan
http://arunraghavan.net/
(Ford_Prefect | Gentoo) & (arunsr | GNOME)