> 1. I will be happy to stay with the XDOCS for official documentation, > IF AND ONLY IF, We decide committers can edit and commit themselves > without having to wait for a review. >
This sounds very reasonable to me. +1 I really do not wish to dump the xdocs (since i had to sped that time > writing them and figuring out how they work) but supporting anakia, > forest, and a moving wiki does not seem like a good idea. If no one is > going to edit them but me we should dump them as well. A couple months ago I spent a lot of time playing around with the different documentation engines trying to figure out if there is something better than Forrest. In particular I wanted to see if there was a system that supports Confluence or MoinMoin markup since this would simplify the task of moving docs from the wiki over to SVN, and I also think it's a lot easier to use than XDoc. Forrest has a plugin for MoinMoin and Doxia has a plugin for Confluence. I experimented with both and found that they implement less than a quarter of their respective markup grammars. I also discovered that using Doxia without Maven is a major pain and is best avoided. My recommendation for the time being is to use Forrest for both the site and documentation. It supports XDoc so we should be able to save the documentation work that Ed has already done, and it is *much* better documented than Anakia and has many more features. tl;dr: Forrest is bad but everything else is much worse.
