fantasai wrote:
>
> http://fantasai.tripod.com/Mozilla/2003/doc-style/guide.html
Comments since the last draft have been accounted for. (If I've missed
something, let me know.) Open issues:
- change 'programlisting' class to 'code'?
See "Re: markup classes", posted by fantasai on May 19, 2003
- remove rule about meta http-equiv="content-type" ?
We could instead ask people to only include that if the charset
is not Latin-1.
- remove rule about unnecessary ?
I'm somewhat inclined to keep this one.
- remove rule about coding HTML in lowercase?
- metadata format for stuff beyond keyword/description
Not necessary at this point, but does need to be discussed.
- format for authorship?
There are many different styles on mozilla.org right now. I'm
not sure that the one at the top of the current style guide is
the best.
Also, which document structure should I base the "document" template on?
a) http://mozilla.org/projects/xpcom/doc/streams.html
b) http://moz.zope.org/contribute/writing/templates/document
c) some combination of both
(I'm talking about the document's *structure* here, not the markup.)
~fantasai
