* Re: [gentoo-dev] [Gentoo Phoenix] an official Gentoo wiki
@ 2010-04-04 8:29 99% ` Arun Raghavan
0 siblings, 0 replies; 1+ results
From: Arun Raghavan @ 2010-04-04 8:29 UTC (permalink / raw
To: gentoo-dev
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)
^ permalink raw reply [relevance 99%]
Results 1-1 of 1 | reverse | options above
-- pct% links below jump to the message on this page, permalinks otherwise --
2010-04-03 13:19 [gentoo-dev] [Gentoo Phoenix] an official Gentoo wiki Ben de Groot
2010-04-03 14:30 ` Alex Legler
2010-04-03 14:46 ` Ben de Groot
2010-04-03 23:37 ` Sebastian Pipping
2010-04-04 1:20 ` Ben de Groot
2010-04-04 7:31 ` Joshua Saddler
2010-04-04 8:29 99% ` Arun Raghavan
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox