[drupal-docs] usability of "Avoid all embedded headings"

[Djun Kim]

On 3 Jun 2005, at 7:38 AM, Steven Wittens wrote:

> A big +1 for using headers inside book pages.
>
> I never understood why this was such a problem

    For the reasons elucidated in the page referenced in
the title:  http://drupal.org/node/24221, to begin with.
Did you read it?

> or why the rule was added
> in the first place. For the printer friendly version?

    Obviously not for the printer friendly version, since you can't tell 
from looking
at the printer friendly version whether a heading is embedded or 
sectional.

> That one is used  by a tiny minority of users... the majority sees a 
> page as a single
> XHTML document. Within that document, headers make perfect sense.

The reason headers  'make sense' for some of the 'single XHTML 
documents'
is because they are TOO LONG to be scanned easily - they are not 
focussed
or concise enough.  The guideline about not allowing headers encourages
addressing the root problem rather than applying a usability 'band-aid'.

> Note, I also added some header renumbering page in a book issue to make
> the book pages respect the hierarchy. It renumbers correctly, handles
> missing numbers, and transitions into divs when the h# tags run out...

I addressed the issues I had with your proposed patch in the
issue  where you posted it (http://drupal.org/node/1898).
If you want to follow up, let's do so in the issues.

By the way, your  patch probably belongs to a  different issue,
I suggest http://drupal.org/node/8049 or
http://drupal.org/node/4118.