There were a few interesting comments on my last post. Firstly from Hen:

People are attached to their editors and not their markup. If Maven had moved from xdocs to apt-gui for their site creation, I doubt there would have been many takers. It’s true, people are very attached to their editors, but you don’t have to force them to change, it’s also not a reason to write customized mark up languages. In Maven’s case, the documentation winds up being published as HTML so that’s really the best format to use, people can use whatever editor they want to edit the HTML and it allows people to choose to use a WYSIWYG editor because they exist. This is similar to what Tim O’Brien said:

Part of the reason why Maven docs are so bad is because there is no way to integrate this customer format with great tools like Ephox. Thanks for the plug Tim, but there are plenty of good HTML editors that would have done the job and a standalone program probably would suit most developers better in this particular case.

TimC also made an interesting point:

Actually, please don’t speak for all authors. The best way I have found of authoring scientific works is with LaTeX. Most definitely not wysiwyg. Fudging around with mice and equation editors is teh suck when you can simply say $\int^\inf_0 \frac{1}{x^2}= … This is definitely a case where wysiwyg isn’t the best option, but it’s also certainly not a case where they have simplified the markup language – LaTeX makes HTML look like child’s play. I’m not sure TimC would be so keen on have to use ASCII art to draw his equations like Tim O’Brien had to for tables in Maven’s markup language. I’m certainly not one to advocate WYSIWYG in every situation, my point was that you should use the most suitable mark up and then use the editor to make it easy and intuitive.

Dumbing down the mark up just limits what you can do and forces you to learn a new syntax. Using a standard mark up like HTML or LaTeX allows authors to leverage their existing knowledge and you can simplify it by providing or recommending a good editor. Sometimes that editor will be WYSIWYG, sometimes it will just be a plain old text editor.