RE: Guide titles

[Sion Lane <sion -dot- lane -at- unit4 -dot- com>]

Has anyone recommended 'The ABCs of XYZ'?

It loses something if the product isn't actually called XYZ

-----Original Message-----
From: techwr-l-bounces+sion -dot- lane=unit4 -dot- com -at- lists -dot- techwr-l -dot- com [mailto:techwr-l-bounces+sion -dot- lane=unit4 -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of techwr-l-request -at- lists -dot- techwr-l -dot- com
Sent: 30 September 2014 06:55
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: TECHWR-L Digest, Vol 107, Issue 23

Send TECHWR-L mailing list submissions to
	techwr-l -at- lists -dot- techwr-l -dot- com

To subscribe or unsubscribe via the World Wide Web, visit
	http://lists.techwr-l.com/mailman/listinfo/techwr-l
or, via email, send a message with subject or body 'help' to
	techwr-l-request -at- lists -dot- techwr-l -dot- com

You can reach the person managing the list at
	techwr-l-owner -at- lists -dot- techwr-l -dot- com

When replying, please edit your Subject line so it is more specific than "Re: Contents of TECHWR-L digest..."


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
TechWhirl's Email Discussion List is Sponsored by Doc-to-Help:

Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^




Today's Topics:

   1. RE: The Source of Bad Writing - WSJ (Margaret Cekis)
   2. Re: Guide titles (Lauren)
   3. Re: Guide titles (joanne grey)
   4. Re: Guide titles (Chris Morton)
   5. RE: Guide titles (Ron Hearn)
   6. Upcoming Fast 5 / Webinar on DITA (INKtopia Admin)


----------------------------------------------------------------------

Message: 1
Date: Mon, 29 Sep 2014 10:18:40 -0400
From: "Margaret Cekis" <Margaret -dot- Cekis -at- comcast -dot- net>
To: "'Mike Starr'" <mike -at- writestarr -dot- com>,
	<techwr-l -at- lists -dot- techwr-l -dot- com>
Subject: RE: The Source of Bad Writing - WSJ
Message-ID: <17FFF25B6C144140A226B981591004DF -at- Margy>
Content-Type: text/plain;	charset="us-ascii"

Mike Starr started this thread with a link to Harvard professor Steven Pinker's article on bad writing.

Here's a link to another article with appreciation for professional communicators," The 7 Habits of Seriously Effective Communication Pros,"
from Entrepreneur:  http://www.entrepreneur.com/article/237542.
Margaret Cekis, Johns Creek GA




------------------------------

Message: 2
Date: Mon, 29 Sep 2014 08:31:10 -0700
From: Lauren <lauren -at- writeco -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: Guide titles
Message-ID: <54297B3E -dot- 8040607 -at- writeco -dot- net>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed

XYZ Bible

XYZ Handbook
- I haven't seen "handbook" in awhile. I like that one.

XYZ Manual


On 9/25/2014 6:08 AM, David Tinsley wrote:
> We currently use the term "XYZ User Guide" as the title for our products. We are brainstorming to see if there may be a better title that would actually make the end user read the guides. The guides include information like:
>
> - setup and installation
> - troubleshooting
> - technical information, approvals/classifications information, 
> regulatory stuff
> - explanations of how the technology works
> - Integration information (a delivery option is in pcb form that the 
> end user integrated into their end solution)
>
> Anyone got any ideas, suggestions?
>
> David




------------------------------

Message: 3
Date: Mon, 29 Sep 2014 08:42:14 -0700
From: joanne grey <clarifiedmind -at- yahoo -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Subject: Re: Guide titles
Message-ID:
	<1412005334 -dot- 41426 -dot- YahooMailNeo -at- web142601 -dot- mail -dot- bf1 -dot- yahoo -dot- com>
Content-Type: text/plain; charset=us-ascii

"Handbook" would definitely be in keeping with making documentation less rigid and more user-centric.




On Monday, September 29, 2014 8:31 AM, Lauren <lauren -at- writeco -dot- net> wrote:
 


XYZ Bible

XYZ Handbook
- I haven't seen "handbook" in awhile. I like that one.

------------------------------

Message: 4
Date: Mon, 29 Sep 2014 09:11:13 -0700
From: Chris Morton <salt -dot- morton -at- gmail -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Subject: Re: Guide titles
Message-ID:
	<CAO7RWYRyT+FJ116ZxSABZDSnOut5yxDyo6dADBpM3AsZGVeUvA -at- mail -dot- gmail -dot- com>
Content-Type: text/plain; charset=UTF-8

*Zen & the Art of XYZ Operations*

*Hitchhiker's Guide To XYZ*

*The Kama Sutra: The Ultimate Guide to XYZ*

> Chris



On Thu, Sep 25, 2014 at 6:08 AM, David Tinsley <dtinsley -at- ndigital -dot- com>
wrote:

> We currently use the term "XYZ User Guide" as the title for our products.
> We are brainstorming to see if there may be a better title that would 
> actually make the end user read the guides. The guides include 
> information
> like:
>
> - setup and installation
> - troubleshooting
> - technical information, approvals/classifications information, 
> regulatory stuff
> - explanations of how the technology works
> - Integration information (a delivery option is in pcb form that the 
> end user integrated into their end solution)
>
> Anyone got any ideas, suggestions?
>
> David
>
>
> ---------------------------------------------------------------
> David Tinsley
> Manager, Technical Communications
> NDI
> 103 Randall Drive
> Waterloo, ON, Canada N2V 1C5
> Telephone: +1 (519) 884-5142 ext. 601
> Toll Free: +1 (877) 634-6340
> Global: ++ (800) 634-634-00
> Facsimile: +1 (519) 884-5184
> Website: www.ndigital.com
>
> ---------------------------------------------------------------
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Read about how Georgia System Operation Corporation improved teamwork, 
> communication, and efficiency using Doc-To-Help | 
> http://bit.ly/1lRPd2l
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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
>


------------------------------

Message: 5
Date: Mon, 29 Sep 2014 10:30:30 -0700
From: Ron Hearn <rhearn -at- central1 -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Subject: RE: Guide titles
Message-ID:
	<583D271B7D537345843033DBE339A9B2EBB701F552 -at- EVS1 -dot- cs -dot- ad -dot- central1 -dot- com>
Content-Type: text/plain; charset="us-ascii"

I have created a new version of our Content Management User Guide to reflect significant changes to the page layout process in the CMS. However, the old guide will be needed for a period of time as users will still need it until they move to the new process. So both guides with similar titles will exist for a while. The issue we have is what to call the old guide. Someone has suggested calling it a "legacy" guide but I am wondering if there is a better name for it,  e.g. the "Content Management Users Guide (name)" though (name) could be in a different position in the doc title.  Does  anyone have any suggestions?

Ron Hearn
Documentation Specialist

Central 1 Credit Union
1441 Creekside Drive
Vancouver, British Columbia, Canada
V6J 4S7

rhearn -at- central1 -dot- com
Tel: 604.730.6391
Fax: 604.730-7792

-----Original Message-----
From: techwr-l-bounces+rhearn=cucbc -dot- com -at- lists -dot- techwr-l -dot- com [mailto:techwr-l-bounces+rhearn=cucbc -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of Chris Morton
Sent: Monday, September 29, 2014 9:11 AM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: Guide titles

*Zen & the Art of XYZ Operations*

*Hitchhiker's Guide To XYZ*

*The Kama Sutra: The Ultimate Guide to XYZ*

> Chris



On Thu, Sep 25, 2014 at 6:08 AM, David Tinsley <dtinsley -at- ndigital -dot- com>
wrote:

> We currently use the term "XYZ User Guide" as the title for our products.
> We are brainstorming to see if there may be a better title that would 
> actually make the end user read the guides. The guides include 
> information
> like:
>
> - setup and installation
> - troubleshooting
> - technical information, approvals/classifications information, 
> regulatory stuff
> - explanations of how the technology works
> - Integration information (a delivery option is in pcb form that the 
> end user integrated into their end solution)
>
> Anyone got any ideas, suggestions?
>
> David
>
>
> ---------------------------------------------------------------
> David Tinsley
> Manager, Technical Communications
> NDI
> 103 Randall Drive
> Waterloo, ON, Canada N2V 1C5
> Telephone: +1 (519) 884-5142 ext. 601
> Toll Free: +1 (877) 634-6340
> Global: ++ (800) 634-634-00
> Facsimile: +1 (519) 884-5184
> Website: www.ndigital.com
>
> ---------------------------------------------------------------
>
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Read about how Georgia System Operation Corporation improved teamwork, 
> communication, and efficiency using Doc-To-Help | 
> http://bit.ly/1lRPd2l
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> 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
>

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as RHearn -at- cucbc -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 This email and any attachments are strictly confidential, may be privileged, and are intended only for the use of the person(s) named above. Any other person is strictly prohibited from disclosing, distributing, copying or using it. If you are not the intended recipient (or are not receiving this communication on behalf of the intended recipient), please notify the sender immediately by return email or telephone call, and securely destroy this communication. Thank you.

Please reply to this message with "Unsubscribe" or "Unsubscribe All" in the subject line to unsubscribe from this mailing list or from all commercial electronic messages from Central 1.



------------------------------

Message: 6
Date: Mon, 29 Sep 2014 14:00:24 -0400
From: INKtopia Admin <admin -at- inktopia -dot- net>
To: Techwr-l <techwr-l -at- lists -dot- techwr-l -dot- com>
Subject: Upcoming Fast 5 / Webinar on DITA
Message-ID:
	<CAC8ceKnU82=bkLbTWX6BV66UNLYqwz=khNMRw5xi2Ac5TRs3zw -at- mail -dot- gmail -dot- com>
Content-Type: text/plain; charset=UTF-8

Hi everyone,

A quick reminder that our Google Hangout / Fast 5 with The Hitchhiker?s Guide to XML Authoring White Paper Author, TechWhirler and XML expert Chris Despopoulos and Maxwell Hoffmann, Adobe?s Global Product Evangelist for its Technical Communication Suite is next Wednesday, October 8 at 12PM eastern time.

You'll laugh, you'll cry, you'll hopefully learn a little bit about XML and how to bring it to your organizations (or avoid it).

More info and to submit a question to Chris / Maxwell:

http://techwhirl.com/event/techwhirl-fast-5-hitchhikers-guide-xml-authoring/

Take care,
al

-- 


TechWhirl.com

*Helping the world explore the art of content and communications* Follow TechWhirl on
Twitter:         @TechWriterToday
Facebook:     facebook.com/techwriterlist
Google+:       *plus.google.com/+techwhirl
<https://plus.google.com/+techwhirl>*


------------------------------

_______________________________________________
You are currently subscribed to
TECHWR-L.
To unsubscribe send a blank email to
http://lists.techwr-l.com/mailman/listinfo/techwr-l
Send administrative questions to admin -at- techwr-l -dot- com -dot- 

Visit
http://www.techwhirl.com/ for more resources and info.

Looking for the archived Techwr-l email discussions?  Search our public email archives @ http://techwr-l.com/archives

End of TECHWR-L Digest, Vol 107, Issue 23
*****************************************


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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
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