RE: Comma question

Subject: RE: Comma question
From: "Combs, Richard" <richard -dot- combs -at- Polycom -dot- com>
To: Tony Chung <tonyc -at- tonychung -dot- ca>, Karen Felker <akaren -at- earthlink -dot- net>
Date: Fri, 19 Jul 2013 10:38:48 -0700

Tony Chung wrote:

> It doesn't help that you don't have a complete sentence. A missing subject
> can cloud anyone's perception of how the language is used.. While this
> style is common in API docs, just know that the comma rules should
> technically follow a proper sentence structure.

Implied subjects aren't limited to imperative sentences. I think most grammarians would agree that if the implied subject is clear from the context, the sentence is just fine. That's the case not just in API docs or Karen's table of algorithms, but in any table or list of items followed by descriptions of what they do.

| Accelerator | Makes the car go forward.
| Brake pedal | Makes the car stop.

The implied subject of each sentence on the right is the term on the left.

Richard G. Combs
Senior Technical Writer
Polycom, Inc.
richardDOTcombs AT polycomDOTcom
rgcombs AT gmailDOTcom

New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.

Learn more:


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-leave -at- lists -dot- techwr-l -dot- com

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

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @


Comma question: From: Karen Felker
Re: Comma question: From: Tony Chung

Previous by Author: RE: Comma question
Next by Author: RE: SharePoint question
Previous by Thread: Re: Comma question
Next by Thread: Re: Comma question

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

Sponsored Ads