RE: Release notes: what's your standard like?

Subject: RE: Release notes: what's your standard like?
From: "diotima" <diotima -at- myway -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Fri, 14 Oct 2005 14:00:52 -0400 (EDT)



what a coincidence. i was just going to ask about release notes and voila, there's already a release notes thread underway!



i have noticed that release notes vary widely, from the "classic" type (known issues, bug fixes, etc. in succinct plain [-text] style) to the full-fledged uber type (screen shots, marketing, multi-color, instructions, kitchen sink).



i'd be interested in seeing some good examples of release notes -- that is, from the point of view of technical writers. in my case, the product is an online application, so there's nothing to install and bugs are generally fixed in real time as they come up. i've been handed a set of release notes and asked to edit it, but i find it problematic in fundamental aspects (purpose, scope, audience analysis), but i also see that it's being driven by c-level managers' desires (who tend to feel that more is always better because it makes us look like a "real" company).



because i don't really want to overhaul the whole document (i have enough work at the moment), and because i don't want to fight the fight with the higher powers, and because i don't want to alienate the person who the doc, i am probably just going to do a surface copyedit and keep my mouth shut.



nevertheless, i am interested to hear more on this topic and especially to see some fine examples.



ciao,

diotima





--- On Tue 10/11, Jenn Wilson < jenn -at- mylar -dot- outflux -dot- net > wrote:

From: Jenn Wilson [mailto: jenn -at- mylar -dot- outflux -dot- net]

To: techwr-l -at- lists -dot- techwr-l -dot- com

Date: Tue, 11 Oct 2005 13:13:46 -0700 (PDT)

Subject: Release notes: what's your standard like?



<br><br>Hi, everyone --<br><br>I'm curious how your respective organizations view and publish release <br>notes.<br

_______________________________________________
No banners. No pop-ups. No kidding.
Make My Way your home on the Web - http://www.myway.com



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

Try WebWorks ePublisher Pro for Word today! Smooth migration of legacy
RoboHelp content into your new Help systems. EContent Magazine Decision-
maker review (October 2005) is here: http://www.webworks.com/techwr-l

Doc-To-Help 2005 converts RoboHelp files with one click. Author with Word or any HTML editor. Visit our site to see a conversion demo movie and learn more. http://www.componentone.com/TECHWRL/DocToHelp2005

---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.



Previous by Author: Re: Network files run amok...
Next by Author: RE: Recent files in Word
Previous by Thread: RE: Release notes: what's your standard like?
Next by Thread: Online poll about how developers prefer to see docs


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


Sponsored Ads