RE: Recommendations on Documentation Plan Templates?

Subject: RE: Recommendations on Documentation Plan Templates?
From: "Wright, Lynne" <Lynne -dot- Wright -at- Kronos -dot- com>
To: Peter Neilson <neilson -at- windstream -dot- net>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 28 Jul 2017 20:34:52 +0000

But given that Jim -- and his director -- want a "fresh eye" opinion, I think part of his review should be to not only assess whether what they are currently doing is effective; but whether they should do things in an entirely different way.

For example, if they are currently delivering docs as pdfs, maybe its time to switch to a web-based help- or knowledge-base system, and start supplementing the documentation with video tutorials.

-----Original Message-----
From: techwr-l-bounces+lynne -dot- wright=kronos -dot- com -at- lists -dot- techwr-l -dot- com [mailto:techwr-l-bounces+lynne -dot- wright=kronos -dot- com -at- lists -dot- techwr-l -dot- com] On Behalf Of Peter Neilson
Sent: Friday, July 28, 2017 4:24 PM
To: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: Recommendations on Documentation Plan Templates?

I'm just shooting from the top of my mixed metaphor here, but triage would seem to be in order. It's obvious that one cannot do everything at once, but one certainly can create lists of the documents, answering as you go the questions of what is it, what do customers do with it (and how do we know what they do), how obsolete is it, who is in charge of it, and all that good stuff. News writers used to call that kind of collection of data the 5 Ws and the H.

Your result should be three lists. (1) Needs to be updated yesterday or sooner; (2) Would be nice to make it right, eventually; (3) Nobody even wants to care or worry about it.

Prioritize list (1).

On Fri, 28 Jul 2017 15:14:46 -0400, Jim <jameswitkin -at- gmail -dot- com> wrote:

> Hello, well I met our new Director today. I work in a small product
> management group as the documentation manager along with three product
> line managers. I mentioned to the new Director that the documentation
> could use review by a "fresh set of eyes" to ensure we are creating
> the right types of documents for the right audiences. Me and my big
> mouth. He replied, "great, why don't you come up with a new
> documentation plan that we can review." Anyone know where I can find a
> good template to work from? This would be a plan for our entire
> documentation set, not for a specific project like a new software
> release. Any ideas?
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com

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

You are currently subscribed to TECHWR-L as Lynne -dot- Wright -at- kronos -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 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


References:
Recommendations on Documentation Plan Templates?: From: Jim
Re: Recommendations on Documentation Plan Templates?: From: Peter Neilson

Previous by Author: RE: Recommendations on Documentation Plan Templates?
Next by Author: RE: Recommendations on Documentation Plan Templates?
Previous by Thread: Re: Recommendations on Documentation Plan Templates?
Next by Thread: Re: Recommendations on Documentation Plan Templates?


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


Sponsored Ads