[drupal-docs] Styleguide

[Anisa]

I really have no place in such an empassioned discussion of headers.  I 
live in a land of no letterhead, after all.  But...  Well, as long as 
there is no case where the end goal of actually having helpful 
documentation is forgotten for something artificial like an imposed 
structure.  I would really hate for that to be forgotten because someone 
(however nice!) counted all the h2 tags.

Anisa.


bryan kennedy wrote:

> On Apr 26, 2005, at 7:35 AM, Dries Buytaert wrote:
>
>> I think I'm convinced ... maybe we should try not to use headers in 
>> book pages.  As long the book's depth stays within the agreed range, 
>> I'm OK with the proposed work.
>
>
> Okay I am still way confused about how this would work.  I mean I 
> don't get how we will decrease the navigation depth with out making in 
> each subsection super "wide" while eliminating headers in the content 
> of the book pages.
>
> But I am totally willing to be convinced.  Could someone take a stab 
> at describing how they would restructure this content (broken up into 
> two main header sections, five sub header sections) within the other 
> 18 items below it.  Please emphasize why this would be beneficial to 
> the user experience:
> Blocks
> http://drupal.org/node/17170
> I am not trying to be obstinate I guess I just haven't seen any 
> examples of how this would work.
>
> I would also like to re-iterate my belief that we are building a 
> website, not a book.  Yes, it would be awesome if we could take the 
> content from our website and do a book friendly output, but IMO the 
> people who want this are a minority audience (even if a majority of 
> devel on this list want it).
>
> bryan
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://drupal3.drupal.org/pipermail/documentation/attachments/20050426/59037e04/attachment.htm