Re: Copyright notices on manuals.



On Wed, Jun 28, 2000 at 07:32:55PM -0700 or thereabouts, Gregory Leblanc wrote:

> important.  This has been discussed before, but I'll raise it again, because
> it is so important. Each app needs to have at least two types of documents
> associated with it.  I can write some good reference manuals.  What I mean
> is, hen somebody fires up this application, knows that it has feature X, and
> needs a reference to that feature and how to use it.  The other kind of
> documentation is 'HOW-TO's.  Essentially tutorials, of varying scope, that
> explain in detail "how to" do something.  These should be VERY closely
> linked, to the reference manual, so that as you go through the tutorial, you
> can "click" on any given step or action, and get a detailed view of the
> things that can be done there.  
> Have most people been writing reference manuals, or HOW-TOs?

So far, reference docs. howtos have been discussed though. I think
just few have been written.

Tim Janik came up with a cool feature which might make it into
future stuff which would be nice (if we could assume everyone had
said cool feature installed and was thus able to make use of it):
a mouse-event recorder. So you start it off recording, then open up
Gimp, select a brush, draw a smiley face, save it, and stop recording.
Then someone can come along and run that file and it does it on your
screen for you, mouse cursor movements and appearance changes and all.

Not too helpful if you don't have it installed, of course, but possibly
something for the future. You could have little snippets of tasks 
being done.

He was playing with this at LinuxTag. I don't know how complete it is,
nor where it would fit in.

Telsa




[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]