[drupal-docs] Transitioning to header-free book pages (was Re: Styleguide)

[Dries Buytaert]

On 01 May 2005, at 01:53, puregin wrote:
> Please do let me know what you think - love it, hate it,
> suggestions for improvement?

I found it confusing for two reasons: (i) your example page is way too 
long and (ii) I can't determine the page's structure in less than 3 
seconds.

People don't read web pages from the first word to the last, they 
merely scan them in order to (i) determine the structure and (ii) to 
find that one paragraph they need.  When you write for the web, there 
shouldn't be any noise; sentences should be brief and to the point.  
Pages should be short, allowing users to see and understand the page at 
a glance.  I think short pages which clear structure are preferred.

I suggest we go with your earlier suggestion: (i) don't use headings in 
book pages, (ii) create a new node for each heading and (iii) at all 
cost, avoid book pages deeper than level 3 or 4.

--
Dries Buytaert  ::  http://www.buytaert.net/