httpd-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Marc Slemko <ma...@worldgate.com>
Subject Re: Document style guide
Date Sun, 15 Feb 1998 18:38:59 GMT
On Sun, 15 Feb 1998, Paul Sutton wrote:

> Items under discussion
> ----------------------
> 
>   0.   Do we need a style guide for documentation?
>    a.  Yes
>    b.  No

Yes, and all the below things are a start.

> 
>   1.   Case of HTML tags
> 
>    a.  Use upper case. E.g. <STRONG>
>    b.  Use lower case. E.g. <strong>
> 
>   2.   Layout of HTML attributes inside tags
> 
>    a.  Place attributes on different lines. E.g.
> 
>          <A
>             HREF="directive-dict.html#Status"
>             REL="Help"
>          >Status</A>
> 
>    b.  Place attributes on single line unless wrapped by end-of-line. E.g.
> 
>          <A HREF="directive-dict.html#Status" REL="Help">Status</A>
> 
>   3.   Capitalization of Apache's hostname and email address
> 
>    a.  Lowercase. E.g. http://www.apache.org/, ...@apache.org
>    b.  Mixed case.  E.g. http://WWW.Apache.Org/, ...@Apache.Org
> 
> 
> Other Possible Style Items
> --------------------------


> 
>   4    HTML version compliance; use of non-standard extensions
>   5    Style sheets
>   6    Indentation of containers (e.g. <UL>, <DL>, BLOCKQUOTE>) content
>   7    Use of font styles vs. phase styles (e.g. <B> vs. <STRONG>)
>   8    Language (UK vs. US spelling and conventions, for instance)

Go for Canadian spelling, eh?


Mime
View raw message