RE: To capitalize or not?

Subject: RE: To capitalize or not?
From: <mbaker -at- analecta -dot- com>
To: "'Keith Hood'" <bus -dot- write -at- gmail -dot- com>, "'Jim'" <jameswitkin -at- gmail -dot- com>
Date: Thu, 9 Jun 2016 09:23:06 -0400

This is really not a question of either consistency or capitalization. It is
a question of whether things have names. If they have names, the rules about
capitalizing those names are clear. If they don't have names, or if you
choose to refer to a named thing by type rather than name, the rules are
similarly clear.

The issue is, does the port in question have a name, and if so, what is that
name. Answer that question and then follow the capitalization rules

The one exception to this would be that if the interface gets it wrong (and
you can't get it fixed, which should be the first thing you try), then it
will make things clearer for the reader if you follow the interface.

Where inconsistencies tend to arise in these matters is when people ask the
wrong questions and base their answers on the wrong principles. If you are
arguing about whether a thing should be capitalized, or whether
capitalization should be consistent, when you should be arguing about
whether a thing has a name, you are likely to come up with inconsistent
answers, and thus inconsistent results.

The question is, does the port have a name. Everything follows from that
using well established rules. And only the company that builds the machine
can decide whether or not it wants to name that port. But if it does, it
should use that name consistently.


-----Original Message-----
From: techwr-l-bounces+mbaker=analecta -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+mbaker=analecta -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf
Of Keith Hood
Sent: Thursday, June 9, 2016 12:59 AM
To: Jim
Cc: techwr-l
Subject: Re: To capitalize or not?

In the absence of any more compelling argument, just maintain consistency.
If the other port names are capitalized, then capitalize this one as well.

Visit TechWhirl for the latest on content technology, content strategy and content development |


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 @


To capitalize or not?: From: Jim
Re: To capitalize or not?: From: Keith Hood

Previous by Author: RE: To capitalize or not?
Next by Author: RE: Current industry trends for technical writers
Previous by Thread: Re: To capitalize or not?
Next by Thread: Re: To capitalize or not?

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

Sponsored Ads