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: What is not mandated is forbidden From:"Margaret Cekis" <Margaret -dot- Cekis -at- comcast -dot- net> To:"'McLauchlan, Kevin'" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Thu, 19 Jun 2014 14:05:42 -0400
Kevin McLauchlan asked, "Does everyone subscribe to the notion that customer
docs should contain only what is necessary? Is there a place for material
that is good to know, or that might reduce customer inquiries, but is not
necessarily critical to performing a task?"...such as "how 'discovered
vulnerabilities' are handled for our products."
---------------------------------------------------------
Kevin:
I've worked for some startups and other small companies that sell online
software products. All the information that the users receive is in a single
PDF (somewhat tutorial) User Guide that can be read online or downloaded and
printed by the user. These manuals usually include a short section in the
front or the back under a heading like "Product Support", which lists the
email address and 800 hotline number where users can report problems or
request additional assistance. If you and your management actually want
customer assistance in reporting and solving problems, or want to reassure
customers that you have a process for handling "discovered vulnerabilities",
I'd put that statement in the Product Support section. (I'd probably also
recommend that they add that statement to the Product Support information on
the company's website.)
Margaret Cekis, Johns Creek GA
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Doc-To-Help 2014 v1 now available. SharePoint 2013 support, NetHelp enhancements, and more. Read all about it.