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

Re: "W3C Manual of Style" work in progress

From: Susan Lesch <lesch@w3.org>
Date: Wed, 26 Sep 2001 02:48:51 -0700
Message-Id: <p0510030bb7d73e63c2e5@[192.168.123.102]>
To: Paul Grosso <pgrosso@arbortext.com>, spec-prod@w3.org
Cc: "Williams, Stuart" <skw@hplb.hpl.hp.com>
Paul Grosso wrote:

>  In general, I would like to see more about using the xmlspec DTD
>  and/or XML in general to produce W3C documents.

If there are volunteers to write a few sentences or more about
production with XMLspec, xmlspec.xsl, html2ps or whatever is in use,
contributions are most welcome. Tonight I installed a new chapter 10 as
a placeholder.

http://www.w3.org/2001/06/manual/#Production

XMLspec, xmlspec.xsl, and diffspec.xsl are added to References.

>  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].

Fixed.

>  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?

Conscious, only to stay lean. But it is UK usage I am told, and has
been switched to commas because you noticed.

>  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)?

I was taught (in the US) that commas and periods are inside quotes,
except when the quoted material is technical or otherwise likely to be
misunderstood because of trailing punctuation. The Chicago manual has
more information on this question than I have ever applied. For clauses
and sentences in our specs ending in a term, I like the Gregg manual
rule 290: "Italicize or underline as a unit whatever should be grasped
as a unit...." (replacing "Italicize or underline" with "Mark up").

>  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.

Reported to the authors.

Thank you for your comments.
Received on Wednesday, 26 September 2001 05:49:00 GMT

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