[drupal-docs] Drupal Handbook Authoring Standards

[Boris Mann]

On Sat, 08 Jan 2005 16:48:41 -0500, Charlie Lowe <cel4145 at cyberdash.com> wrote:
> One comment. There's an assumption in the following that the
> documentation entries might only need one level of headings:
> 
> "For longer handbook entries, please break your explanation up into
> sections. At the beginning of each section provide a title which should
> be enclosed within <h3> tags."
> 
> I suggest changing it to something like
> 
> "For longer handbook entries, please break your explanation up into
> sections and subsections using headings and subheadings. Headings and
> subheadings should make use of titles enclosed in <h2>, <h3>, etc.
> respectively." (or <h3>, <h4>, etc., depending on the outcome of the h2
> vs h3 discussion; +1 for h2).

I was, BTW, never advocating skipping a heading level and using h3,
just point out (again) that h2 is not styled differently from h1,
which makes it hard to read.

I believe only Steven Wittens can make the necessary edits to the
Drupal.org stylesheet.

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