On Fri, Mar 5, 2010 at 20:36, Sebastian Cohnen <[email protected]> wrote: > but back to topic: MoinMoin sucks! It's unbelievably slow, throws 500s all > the time and don't forget the syntax - pure hell when you seriously want to > work with it. I've talked with Jan and he has been recently thinking of a > replacement. As a first step we want to suggest using Markdown and git from > now on - at least for documentation purposes. Once we (or better I) have > enough translated from MoinMoin to Markdown we could start linking from the > wiki to Github (as it renders markdown nicely for you). We think that this > approach is likely to work best as an interim solution before we have a > ass-kickin' couch-wiki solution. Once that's done, we can easily import the > markdown stuff. or maybe markdown+git works so well, so that it stays the > preferred way - who knows? ;)
Well, we use MoinMoin for Mercurial; it's not slow and doesn't throw 500s, though. I would suggest that that has to do with Apache's specific setup/infra. > What do you think? You can ping me on IRC (tisba) anytime, but the ml should > be the place, where the discussion takes place (so that everyone can > participate). I also in the past added some things/structure to the wiki, but I agree that it lacks structure and doesn't always work well if you're looking for something. Personally, I rather like Sphinx, the package that Python (and many Python packages) use for their docs. On the other hand, a wiki has a much lower bar for contribution. I don't think Markdown or reST (which Sphinx uses) are fundamentally better than the wiki markup. Yes, the wiki needs more maintenance, but no, I don't think the initial impulse to start over with some proprietary system wil result in better docs anytime soon. Cheers, Dirkjan
