Re: documenting desktop to web application

Subject: Re: documenting desktop to web application
From: dmbrown -at- brown-inc -dot- com
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Fri, 26 Sep 2003 08:56:51 -0700


Sean Wheller wrote:
>
> ...you miss the point. In the
> original post it was suggested that a User Manual be
> written to document functionality.

And you've *forgotten* the point. Recording existing functionality was only *one* of the reasons for creating what was clearly described as *user* documentation.

The lack of user documentation is itself a good enough reason to create that documentation. Recording existing functionality is just a side benefit.

>
> WEB APPS are not vertical like FAT APPS.
> That is they are very hard to document top down.

WHAT?!?

If a web application is designed with a single entry point and well-defined paths through the UI, how is it any different from a desktop application with a single entry point and well-defined paths through the UI?

>
> Never underestimate the power of the hyper link. Screens
> (WEB PAGES) can jump and drill in any direction. FAT
> APP dialogs are generally limited to a few dialogs
> deep, then you close them and start again in another
> direction.

Are you telling us that all pages in a web application *must* link to a lot of other pages simply because they *can*? That's absurd.

Web applications contain exactly as many links as the developer puts into them, which is no different from desktop applications.

>
> User Manuals explain the behavior of an application is
> completing tasks.

And that's precisely what the person requesting the user documentation seemed to be asking for.

>
> But if the FAT APP is dead in 18 months, I would not
> bother with writing a User Manual for Engineers and
> Developers.

Again, you forget the original post, in which the client had asked for *user* documentation, presumably to be used for existing customers for a YEAR AND A HALF.

If you don't think user documentation is worth bothering with, then you must be working for a company producing the mythical self-documenting software.

--David

========================================================================

HTML Indexer 4 is still the easiest way to create and maintain indexes
for web sites, intranets, HTML Help, JavaHelp, and other HTML documents.

HTML Indexer 4 includes fully integrated cross-references, target frames
and windows, multiple-file output, "one-step accept" of default entries,
and more!

http://www.html-indexer.com/




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

NEED TO PUBLISH YOUR FRAMEMAKER CONTENT ONLINE?
?Mustang? (code name) is a NEW online publishing tool for FrameMaker that
lets you easily single-source content to Web, intranets, and online Help.
The interface is designed for FrameMaker users, so there is little or no
learning curve and no macro language required! See a live demo that
will take your breath away: http://www.ehelp.com/techwr-l3

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



References:
Re: documenting desktop to web application: From: Sean Wheller

Previous by Author: Re: documenting desktop to web application
Next by Author: RE: Visual Basic and Tech Writing
Previous by Thread: Re: documenting desktop to web application
Next by Thread: Re: documenting desktop to web application


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


Sponsored Ads