Ascend Archive
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: (ASCEND) Requesting all comments...



I prefer printed docs. If you go to CD based docs like Cisco does you get shot
on site. Cisco CD docs suck royally. The ability to print/search PDF docs is
nice option though. But the PDF that is exactly like the printed books would be
an nice extra to offer. But printed books should always be the preferred format
for docs.

Tim Jung
System Admin
Internet Gateway Inc.
tjung@igateway.net

-----Original Message-----
From: David Miller <David.Miller@ascend.com>
To: ascend-users@bungi.com <ascend-users@bungi.com>
Cc: msimonid@ascend.com <msimonid@ascend.com>; dmiller@ascend.com
<dmiller@ascend.com>
Date: Tuesday, May 19, 1998 1:38 PM
Subject: (ASCEND) Requesting all comments...


>Hi y'all:
>
>Tech Pubs has been working to improve our documentation, both in content
>and structure. About a year ago, we asked for comments on what we should do
>to improve the documentation we provide. We received a ton of good
>comments, and have incorporated a lot of them.
>
>We are planning on making more improvements, and wanted to make sure you
>had a chance to voice any opinions you have. (Do you EVER have any
>opinions?)   ;^)
>
>We appreciate any comments, from "It's perfect" to "What is this cr*p? I
>can't even read it", but we would appreciate that you be as SPECIFIC as you
>can in your comments.
>
>The major change we are planning is adding a "Real examples" section,
>illustrating sample configurations, including a detailed graphic,
>description of the environment, and config dump of the pertinent MAX
>parameters. The plans are to include the following sample environment:
>
>- Typical (or as close as we can come) ISP environment
>- Corporate IP-routed environment
>- IPX-routed environment
>- AppleTalk-routed environment
>- OSPF environment
>- ATMP environment
>- Multicast environment
>
>Any others you would like to see? (or any from the above list that we
>should chuck?)
>
>Also:
>
>Currently, on which type of doc do you rely on the most? Printed manuals,
>Release Notes, CD, etc.?
>Which format works best for you: Printed, CD, HTML, etc.?
>Does the detail (or lack thereof) in the documentation work for you? Should
>we provide more conceptual discussions, examples, etc...or less?
>How satisfied are you with the documentation itself?
>How satisfied are you with how we release documentation and make it available?
>
>We honestly appreciate any and all suggestions. We will attempt to
>incorporate as many suggestions as possible, hoping to improve the
>documentation for everyone.
>
>Please send all comments directly to dmiller@ascend.com and
>msimonid@ascend.com in the Tech Pubs department...
>
>Thanks a lot for any help...
>David Miller
>Senior Technical Writer
>Ascend Communications, Inc.
>++ Ascend Users Mailing List ++
>To unsubscribe: send unsubscribe to ascend-users-request@bungi.com
>To get FAQ'd: <http://www.nealis.net/ascend/faq>


++ Ascend Users Mailing List ++
To unsubscribe:	send unsubscribe to ascend-users-request@bungi.com
To get FAQ'd:	<http://www.nealis.net/ascend/faq>


Follow-Ups: