Re: Giving up on XML

Subject: Re: Giving up on XML
From: Janice Gelb <janice -dot- gelb -at- sun -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 22 Mar 2007 07:38:30 +1100

David Neeley wrote:
> Lauren said my previous post confused her, then extended that thought:
> "A Style Guide is a "guide" and not a law. ...
> "Here's where I get confused. David, you mentioned that, "Writer after
> writer had blithely overridden the document styles--and updating the
> document to produce a consistent result was a veritable nightmare!" This is
> a "document style" (in the old days it was "style sheet") issue and not a
> "style guide" issue. Document styles should not be played with and should
> be consistent across shared documents.
> I just want to know where the argument is here, documents or guides?"
> The Nortel document styles were designed following their corporate
> style guide. Thus, in overriding those styles and making changes in
> individual documents, the writers were deviating from the style guide.
> [snip explanation of applying formatting styles]

I believe what Lauren was referring to was the
use of the word "style guide" - which in your
case you appear to be using to refer to *formatting*
style and which most other places use to refer
to guidelines for *writing* style (e.g., phrasing,
hyphenation, etc.)

-- Janice

Janice Gelb | The only connection Sun has with
janice -dot- gelb -at- sun -dot- com | this message is the return address

Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include single source authoring, team authoring,
Web-based technology, and PDF output.

Now shipping: Help &amp; Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help &amp; Manual:

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.


Re: Giving up on XML: From: David Neeley

Previous by Author: Re: Giving up on XML
Next by Author: Re: What would you do?
Previous by Thread: Re: Giving up on XML
Next by Thread: Re: Giving up on XML

What this post helpful? Share it with friends and colleagues:

Sponsored Ads