[drupal-docs] Styleguide

[Steven Wittens]

>
>      I would like to re-iterate that it's very important that we *not* 
> include
> any headers in handbook nodes (no <H1> ... <H6>)  The reason: headers
> are about structure.  Structure should be sole domain of book module or
> whatever else holds the content.    Putting header tags into a node
> gives 'false structure' .    Subsections of a given section, therefore,
> should always be constructed as a child of that section.
>
>      In fact, perhaps we need a special filter for this situation.


I don't see the problem with header tags. Within a single page, the page 
title is a h1. Below that, we can have h2, h3, h4 etc. It is 
semantically valid and makes the page more accessible.

If there are problems with headers in the printer friendly output, then 
they should be fixed there. For example by renumbering the headers 
inside an article automatically when doing the printer friendly output. 
This isn't all that hard in fact.

Steven Wittens