On 4 April 2010 13:01, Joshua Saddler <nightmo...@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)
