W3C home > Mailing lists > Public > spec-prod@w3.org > July to September 2001

Re: "W3C Manual of Style" work in progress

From: Paul Grosso <pgrosso@arbortext.com>
Date: Tue, 25 Sep 2001 12:58:15 -0500
Message-Id: <4.3.2.7.2.20010925121343.0227b5a8@notesmail.arbortext.com>
To: Susan Lesch <lesch@w3.org>, spec-prod@w3.org
At 16:21 2001 09 24 -0700, Susan Lesch wrote:
>The first draft of the "W3C Manual of Style" [1] is ready for review by


>[1] http://www.w3.org/2001/06/manual

In general, I would like to see more about using the xmlspec DTD
and/or XML in general to produce W3C documents.  I don't mean
docn of the xmlspec DTD itself, but info on production/publication
of docs written in XML.  For example, at least a mention if where
to go for xmlspec resources, what an editor should do with the 
XML and HTML (and PDF or whatever) versions when submitting
them for publication, etc.

I note in section 10.2 that spell checking is required.  However,
in the sample Rec at http://www.w3.org/StyleSheets/TR/REC-sample
there is the phrase "W3C Technial Reports" [sic].

Section 10.4 talks of punctuation, referring to the Chicago
Manual of Style wherein it recommends the use of a comma 
(or colon if appropriate) after "e.g." or "i.e.".  However I 
note this Style document does not do that.  Was this an oversight 
or a conscious decision?

Also, do you have any comments about the business about putting
punctuation such as commas and periods inside quotes (which used
to be the recommended way, but is sometimes confusing and rarely 
followed these days)?

When I try to go to http://www.w3.org/TR/Templates/tech-report.html
using Netscape 4.7, I get error 400 due to the fact that I appear
to get redirected to 
http://www.w3.org/StyleSheets/TR/W3C-%%Status:WD,CR,PR,REC,NOTE%%
which is not well-formed.

paul
Received on Tuesday, 25 September 2001 14:00:28 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 10 March 2012 06:19:11 GMT