RE: Configuration Guides

Subject: RE: Configuration Guides
From: "margaret Cekis" <margaret -dot- cekis -at- comcast -dot- net>
To: "'Ryan Young'" <ryangyoung -at- gmail -dot- com>, "'Helen OBoyle'" <hoboyle -at- gmail -dot- com>
Date: Mon, 7 Mar 2016 19:14:10 -0500

Ryan Young said, "We're also working on defining what each guide should be.
The other tech
writer here has pushed for combining installation, configuration, and
common operator tasks into an "Operations" guide. I feel like that's a bad
idea as it makes users effectively search through two irrelevant guides. It
sounds like the consensus here would be to separate out those three topics?"
I think it depends on whether the installation and configuration, and other
operational activities are connected and who will be doing them. When I
worked on documentation for bank automation software, there were user
guides, administrator guides, and installation/ configuration guides.
The installation and configuration of a dedicated server and software that
ran the web application for a financial institution was installed by IT
professionals, and was usually done once, except for subsequent software
upgrades, also done by IT staff. The administration guide contained account
configuration instructions for the bank administrative staff who set up the
individual customer accounts. The user guides for the customers contained
account setup information for each customer to set up accounts for that
customer's employees authorized to use the banking application.
So my advice is to analyze each type of configuration and assign it to a
specific user role. After that analysis, consider the various roles, and how
they may overlap. Add then decide which roles require distinct configuration
instructions, and how you will deliver them.
Margaret Cekis, Johns Creek GA

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 @

Configuration Guides: From: Stuckey, Ginger
RE: Configuration Guides: From: Erika Yanovich
RE: Configuration Guides: From: Helen OBoyle
Re: Configuration Guides: From: Ryan Young

Previous by Author: Re: What happened to information architecture and design
Next by Author: RE: datasheet vs. product bulletin vs. app note vs. tech note vs. case study ?
Previous by Thread: RE: Configuration Guides
Next by Thread: RE: Configuration Guides

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

Sponsored Ads