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

[Steven Wittens]

>If we can agree on that, we can move to the next discussion, which is
>"what should our standards be?" We effectively need a styleguide for
>drupal docs, just like there is a code styleguide. This should cover
>both naming conventions and the preferred markup for various types of
>information. For example, as has been recently recommend, inline code
>snippets should be contained in <code> tags; blocks of code should be
>contained in <pre><code> tags. That kind of information would be
>included in a drupal documentation styleguide.
>  
>
By the way, codefilter automatically checks if a code tag contains 
linebreaks, and if so, adds a box wrapper. We should avoid pre as it 
will cause wrapping issues. And using overflow: auto; is a recipe for 
disaster in tableless themes unfortunately.

Steven Wittens