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

[Charlie Lowe]

Djun Kim wrote:
> By all means, let's expand and clarify the
> "Avoid all embedded headings" page.
> 
> But let's make it clear to authors and editors
> that this practice should be avoided in almost all
> cases.

i don't have the answers as to how to clarify this. for instance,

http://drupal.org/node/24268

i tried <dl>/<dt> tags, but it seems overkill, is a pain to code, and 
resulted in less readable text (because of the formatting). so i used 
<p> and <strong> tags, but this somehow seems wrong since normally i 
would create subheadings. i could certainly see the "Modifying the 
handbook modules pages for inclusion in Drupal core" end up being a 
separate page, but the rest is more usable listed together. meanwhile, i 
have other texts in the works that will have similar issues.