Re: Self Documenting Interfaces

["Dan Kaminsky" <effugas best com>]

-----Original Message-----
From: Preben Randhol <randhol@dusken4.samfundet.ntnu.no>
To: Dan Kaminsky <effugas@best.com>
Date: Thursday, July 23, 1998 1:13 PM
Subject: Re: Self Documenting Interfaces


>* "Dan Kaminsky" <effugas@best.com
>
>| Guided tours should be guided by the *app*.  That's why I think GNOME
should
>
>Which makes a small app twice the size or more...


I'd gladly take a few extra K for useful documentation.  And it's not
encapsulated in the app anyway.

>| put a high priority on voiced tours.
>
>OK so if I make a small program of about 60kb then I should put 100Mb
>of soundfiles there so that some lazy person can listen to the manual?


I'm gonna take back my claim that voicing tours is preferable.  However, a
text-annotated visual tour of a program and what it can do *IS* a good
thing.  There's no better way to learn an app than to watch it in use,
rewind, fast forward, etc.