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.
Subject:RE: The Instrument? The instrument? From:"Gordon McLean" <gordon -dot- mclean -at- ciboodle -dot- com> Date:Wed, 10 Dec 2008 08:16:07 -0000
We have this quandary as well. Part of our product is a Development Kit so
terms like Object (object), module (Module) and so on, abound!
Inherited an initial caps scheme and loathed to change it as I'm sure it
would lead to many rewrites in the name of clarity.
Gordon
-----Original Message-----
From: techwr-l-bounces+gordon -dot- mclean=ciboodle -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+gordon -dot- mclean=ciboodle -dot- com -at- lists -dot- techwr-l -dot- com] On
Behalf Of Chris Vickery
Sent: 10 December 2008 00:57
To: Susan W Gallagher; Nancy Allison
Cc: Technical Writing
Subject: RE: The Instrument? The instrument?
Here, we find ourselves capped into a corner with our existing style. We cap
objects in our interface that are specific to our application. This is fine
for the most part, but you get some sticky wickets when you've got an object
in the application called a File, but in the same sentence you refer to a
file on the user's system. I may opt to cleanse with the holy fire and just
go lc on everything, but I'm not there yet.
Chris
-----Original Message-----
From: techwr-l-bounces+cvickery=arenasolutions -dot- com -at- lists -dot- techwr-l -dot- com
[mailto:techwr-l-bounces+cvickery=arenasolutions -dot- com -at- lists -dot- techwr-l -dot- com]
On Behalf Of Susan W Gallagher
Sent: Tuesday, December 09, 2008 4:02 PM
To: Nancy Allison
Cc: Technical Writing
Subject: Re: The Instrument? The instrument?
There was a time when using initial caps for emphasis was common, but I'm
not old enough to remember it -- and I'm **old**! <g>
Chicago, 15th ed. says in part in paragraph 7.50, "Initial capitals, once
used to lend importance to certain words, are now used only ironically."
HTH!
-Sue Gallagher
On Tue, Dec 9, 2008 at 12:05 PM, Nancy Allison <maker -at- verizon -dot- net>
wrote:
>
> If you've worked on anything that refers to a hardware thingy by both
> its clunky formal name and by the phrase "the instrument," do you
> capitalize "instrument"?
>
> The manual I've inherited does. The phrase has a homey, old-timey,
> reverential feel. Seems as if maybe I should bow my head every time I
> read it.
>
> Does it strike you as an outdated convention? Would you capitalize
it?
> I'm dying to knock down the caps but want a to hear others' opinions.
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> ComponentOne Doc-To-Help 2009 is your all-in-one authoring and
publishing
> solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
> HTML and publish to the Web, Help systems or printed manuals.
>http://www.doctohelp.com
>
> Help & Manual 5: The complete help authoring tool for individual
> authors and teams. Professional power, intuitive interface. Write
> once, publish to 8 formats. Multi-user authoring and version control!
>http://www.helpandmanual.com/
>
> ---
> You are currently subscribed to TECHWR-L as susanwg -at- gmail -dot- com -dot-
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
>http://lists.techwr-l.com/mailman/options/techwr-l/susanwg%40gmail.com
>
>
> 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
>http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
>http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or HTML
and publish to the Web, Help systems or printed manuals. http://www.doctohelp.com
Help & Manual 5: The complete help authoring tool for individual authors and
teams. Professional power, intuitive interface. Write once, publish to 8
formats. Multi-user authoring and version control! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as cvickery -at- arenasolutions -dot- com -dot-
ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals. http://www.doctohelp.com
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as gordon -dot- mclean -at- ciboodle -dot- com -dot-
___________________________________________________________________
Sword Ciboodle Ltd (a company registered in Scotland with
registered number SC143434 and whose registered office is at
India of Inchinnan, Renfrewshire, UK, PA4 9LH) is part of the Sword
Group of companies.
This email (and any attachments) is intended for the named
recipient(s) and is private and confidential. If it is not for you, please
inform us and then delete it. If you are not the intended recipient(s),
the use, disclosure, copying or distribution of any information
contained within this email is prohibited. Messages to and from us
may be monitored. If the content is not about the business of the
Sword Group then the message is neither from nor sanctioned by
us.
Internet communications are not secure. You should scan this
message and any attachments for viruses. Under no circumstances
do we accept liability for any loss or damage which may result from
your receipt of this email or any attachment.
___________________________________________________________________
ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals. http://www.doctohelp.com
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
