TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
To leverage from what Keith wrote, it's a contextual matter. If it's
labeled that way on the device, I might go along with capitalizing it.....
but not without first raising questions about it.
Ordinarily, I'd never capitalize *external port*, as it's not a proper
noun. And as Jack wrote, Engineers Are Prone to Capitalizing Everything.
Why? Because they Don't Know Any Better.
Are the other ports capitalized on their labels? Then maybe External Port
(I said *maybe*).
But not knowing the context, I'd opt for all lowercase, coupled with a
cropped screenshot of the physical port and its label. That way it doesn't
matter how the physical port is labeled; your body copy will be correct.
On Thu, Jun 9, 2016 at 12:58 AM, Keith Hood <bus -dot- write -at- gmail -dot- com> wrote:
> In the absence of any more compelling argument, just maintain consistency.
> If the other port names are capitalized, then capitalize this one as well.
>
> <
>https://www.avast.com/sig-email?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=webmail&utm_term=oa-2322-b
> >
> Virus-free
> <
>https://www.avast.com/sig-email?utm_medium=email&utm_source=link&utm_campaign=sig-email&utm_content=webmail&utm_term=oa-2322-b
> >
> <#DDB4FAA8-2DD7-40BB-A1B8-4E2AA1F9FDF2>
>
> On Wed, Jun 8, 2016 at 2:06 PM, Jim <jameswitkin -at- gmail -dot- com> wrote:
>
> > I'm having this ongoing debate with my engineer coworkers: when to
> > capitalize the names of the parts that make up our hardware platform.
> I'm
> > describing a server we manufacture for telecom networks. On the back of
> the
> > server are various ports and plugs. I am providing instructions for
> > connecting a specific cable to a specific port, which we call the
> "external
> > port."
> >
> > Question: should reference to this specific port be capitalized (External
> > Port) or not (external port). My engineer coworkers say yes because we
> are
> > referring to a specific port so this is a type of proper noun. All the
> > other ports on the server have specific names so these should also be
> > capitalized. I'm not sure this does qualify as a proper noun. Thoughts?
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> > Visit TechWhirl for the latest on content technology, content strategy
> and
> > content development | http://techwhirl.com
> >
> > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> >
> > You are currently subscribed to TECHWR-L as bus -dot- write -at- gmail -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
> > http://www.techwhirl.com/email-discussion-groups/ for more resources and
> > info.
> >
> > Looking for articles on Technical Communications? Head over to our
> online
> > magazine at http://techwhirl.com
> >
> > Looking for the archived Techwr-l email discussions? Search our public
> > email archives @ http://techwr-l.com/archives
> >
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Visit TechWhirl for the latest on content technology, content strategy and
> content development | http://techwhirl.com
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as salt -dot- morton -at- gmail -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
>http://www.techwhirl.com/email-discussion-groups/ for more resources and
> info.
>
> Looking for articles on Technical Communications? Head over to our online
> magazine at http://techwhirl.com
>
> Looking for the archived Techwr-l email discussions? Search our public
> email archives @ http://techwr-l.com/archives
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com