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: Need Release Notes Advice (fwd) From:"Thiessen, Christopher(Chris) E" <CHRISTOPHER -dot- E -dot- THIESSEN -at- CDEV -dot- COM> Date:Fri, 29 Mar 1996 05:25:58 -0600
We use the same methodology for our upgrade guides/release notes.
Chris Thiessen
Manager, Documentation Services
Ceridian Employer Services
christopher -dot- e -dot- thiessen -at- cdev -dot- com
----------
From: Anne Weiler
To: "Technical Writers List; for a
Subject: Re: Need Release Notes Advice (fwd)
Date: Thursday, March 28, 1996 8:31PM
<financial examples snipped>
Barbara Hallnan wrote:
> * Gov/Corp User Security no longer crashes when you
> enter a maturity date prior to the current date.
> or
> * In Portfolio Holdings, when you use the Edit
> Column Values button, unpriced securities are now
> excluded from the aggregate calculations.
This is the style we use for our release notes. The theory is 1. make it
positive. 2. don't worry about the reverse logic because if users
encountered the problem they'll recognize it, and if they didn't encounter
the problem, hopefully, this phrasing won't upset them too much.
Anyone buy this logic?
Anne
--
Anne Weiler --annew -at- chancery -dot- com
Media Development
Chancery Software