[drupal-docs] XHTML in our documentation - Textile, Markdown, ...

[Moshe Weitzman]

> Any text-based format can be "converted". I suspect that what "Dries
> has wanted" is a way for export/offline reading. I am not a fan of
> random alternative markup languages.

i'm not the biggest fan either. But the advantages of having clean 
parseable XML are huge. The first example that comes to mind is the 
wonderful S5 slideshow module from Bryght  [1]. This one is worth 
checking out. It displays any set of book pages in a snazzy slideshow a 
la Powerpoint/Keynote/etc. The catch is that your book pages must 
contain valid, semantically correct HTML. So how can we assure that 
documentation authors produce work that has this characteristic? I 
propose that these markup languages are the best way. I'm open to other 
suggestions, or to debate on whether clean HTML is even a worthwhile 
goal.

[1] http://www.bryght.com/node/121 (see the test site link)