Ascend Archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: (ASCEND) ascend software releases
Hi Marc:
Kevin forwarded your comments to Tech Pubs, and I wanted to offer some
comments...
>>Why has Ascend started making their docs impossible to use? If I want to
>>know the difference between 5.0Ap6 and p16, I can't just print the notes
>>for each revision between them.
>
>We used to do that, and got more complaints - "why don't you guys have
>cumulative release notes"....so we did!
Tech Pubs received overwhelming support to begin compiling Release Notes in
a cumulative format.
I believe the predominant reason was that no one wanted to have to download
several copies of a Release Note to look for one feature or correction.
Coming soon, we'll be updating the organization of the RNs. Currently, as
you know, they are grouped by release, so all the features and corrections
for 5.0Ai13 are grouped together...all the features and corrections for
5.0Ai21 are grouped together, etc.
But this means you have to go section-by-section to find a specific feature
or correction.
After the next general release, all subsequent Release Notes will be
grouped to match more closely the structure of our manuals, with sections
like "Frame Relay", "IP Routing", "VPN", etc., and all corrections will be
grouped numerically in one list.
Ah, but you say, how will I know where a specific feature or TR was fixed?
I quickly answer that we'll indicate in each new feature or correction the
first available release that introduced the feature/fix...
Also, at the top of each Release Note, we'll have a "What's new in this
release" so you can see quickly if a particular release has something to
offer you.
>>It is nearly impossible to decide on a good release when half the notes
>>don't include all the changes (eg. incremental releases sometimes include
>>fixes from patch releases but they aren't included in the release notes),
>>some of them are wrong (ie. obviously aren't even _looked_ at before
>>release), and the actual release notes keep being updated for old
>>versions.
>
>Please detail any issues you have so that we can address them (I'll pass them
>on to the Manager of Tech Pubs), since posting here will not have *that*
>desired effect.
Kevin has the ear of the Tech Pubs Manager and our entire department. Any
errors in the Release Notes will be corrected as soon as they are found.
If you find errors in the Release Notes, please let us know. Also, if you
have any other suggestions about Release Note structure, organization,
content, etc., please let us know that, as well.
Obviously, we'd like our documentation to satisfy every customer's needs,
but because that may be a physical impossibilty, we'd like to satisfy the
majority of people, but certainly not frustrate ANYONE. Please let us know
your thoughts...
David Miller
Senior Technical Writer
++ Ascend Users Mailing List ++
To unsubscribe: send unsubscribe to ascend-users-request@bungi.com
To get FAQ'd: <http://www.nealis.net/ascend/faq>