[Sigia-l] Writing vs. Documentation

[Jonathan Baker-Bates]

> > Will Parker:
> >
> >> Writing complex  documentation
> >
> > I'm sure there are *some* apps where *complex* documentation is 
> > needed, but for the vast majority of apps there's often an inverse 
> > relationship between the "complexity" of the documentation and the 
> > inherent usability of the app itself. Of course, there are 
> other ways 
> > of providing "documentation" without having to "write" (prose).
> 
> This is one of the reasons I like having good technical 
> authors around early in the process. They love saving 
> themselves work and can help the persuasion process for doing 
> the UI right (ditto for first level tech support)
> 

Just on a side issue here - when you say "documentation," do you mean a
written specification for the app before it's built, or a user manual
for the app for use after that?

I ask because I have made the mistake in the past of assuming that the
word "documentation" means a specification for the design of an
application, and have subsequently looked like an idiot on more than one
forum because of it.

Jonathan


______________________________________________________________________
This email has been scanned by the MessageLabs Email Security System.
For more information please visit http://www.messagelabs.com/email 
______________________________________________________________________