Re: punctuation and procedure titles...

Subject: Re: punctuation and procedure titles...
From: "Terry Barron" <tbarron -at- systems -dot- dhl -dot- com>
To: Angela Pollak <angela -dot- pollak -at- sybase -dot- com>
Date: Thu, 09 Mar 2000 11:41:38 -0800

This is from Sun Technical Publications, _A Style Guide for the
Computer Industry_

"Unlike lists, steps *always* should be complete sentences.
- Use sentence-style capitalization.
- End the sentence with appropriate punctuation."

~~~ Terry

Angela Pollak wrote:
>
> Do you punctuate procedural titles with a colon? For example, which of the
> following would you say is correct:
>
> To <fry an egg>:
> 1. blah blah.
> 2. blah blah blah.
>
> To <fry an egg>
> 1. blah blah.
> 2. blah blah blah.
>
> And what is your reasoning?


>
> My apologies if this has been discussed before... I've exhausted my
> resources on the subject matter and they are anything but conclusive.
> Roughly half said it is correct, and the other half said it is incorrect.
> Some based the decision on opinion, some on snippets of grammar rules that
> may or may not be relevant to the field of software documentation. I even
> asked two grammarians and they both came up with opposite answers. Oops.
>
> I'm no further ahead than when I started looking into the subject :-}
>
> Thanks
>
> ~A~
>




Previous by Author: Re: ? Edward Tufte Course on Presenting Data and Info
Next by Author: Re: Word 97 to PDF question
Previous by Thread: RE: punctuation and procedure titles...
Next by Thread: RE: punctuation and procedure titles...


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

Sponsored Ads


Sponsored Ads