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

[Boris Mann]

On Wed, 16 Mar 2005 17:32:55 -0500, Moshe Weitzman <weitzman at tejasa.com> wrote:

> I propose that we ditch HTML authoring and use author using Markdown [1]
> or Textile [2] formats. These formats are easy to learn, and always
> output valid XHTML. Plus, we already have Drupal modules for each. Also,
> I think it will be easier to communicate style rules using one of these
> syntaxes (e.g. "top level headlines begin with **").

-1 -- Either straight XHTML or WYSIWYG, and I don't think we'll be
doing that on ay drupal.org sties. If you don't want tags, use an
input filter to restrict usage.

> Dries has long wanted a DocBook like format for our documentation. I
> think Markdown and Textile are like Docbook in that they can be
> converted to any format. But unlike DocBook, they are easily
> comprehended by all.

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.

--
Boris Mann
http://www.bryght.com