Re: Documentation

Michael Johnson (hekate@intergate.bc.ca)
Thu, 6 Aug 1998 09:56:44 -0700 (PDT)


Um, not to nitpick but that post that keeps getting quoted as being from
J.D. is actually a post of mine. Just an FYI so we don't have any
confusion.
 On Thu, 6 Aug 1998, Jan Sacharuk wrote:

> 
> On Wed, 5 Aug 1998, Dave Walker wrote:
> 
> @>J.D. Jordan wrote:
> @>> 
> @>> At 05:13 PM 8/5/98 -0700, you wrote:
> @>> >Um...some people claim they _do_ RTFM and still have problems. I think the
> @>> >docs are fine, for people that are used to going through the process of
> @>> >mixing what they can find _IN_ the docs with a little instinct,
> @>> >initiative, and common sense. User Friendly nowadays is a M$/MAC
> @>> >inheritence that seems to be based on the concept of guessing how to make
> @>> >things more intuitive as opposed to giving more detailed documentation.
> @>> >People are only doing what they are conditioned to do. People want and
> @>> >expect, rightly or wrongly, intuitive application interfaces and when they
> @>> >don't
> @>> >get it they become frustrated with the application/developers regardless
> @>> >of how good/bad or whatever the documentation might seem to those who
> @>> >write it or use it with great effect.
> @>> >
> @>> > -Michael
> @>> 
> 
> << snip a heckuva good suggestion >>
> 
> I'd like to offer my services for the same sort of thing. Perhaps we
> can collaborate. I'm stronger on my coding side than on my technical
> writing side, but it seems to me that that would be best. At the very
> least, I can proofread. ;)
> 
> Jan Sacharuk
> 
>  ****   ****  ===========================jan@cs.ualberta.ca==================
> **   ***   ** GCS d-(++)>++ s++:-- a-- C++++$ UAHISCX++$ P++ L>+++ E+(+++)$
> **    *    ** W-- N+ !o K? w---(++++) !O M- V-- PS+ PE++ Y+ !PGP t--- 5+++
>  **  j.s  ** X+ R tv-- b+++(++++)>++++ DI++++ D+ G++(++++) e>++ h>++ r++>+++
>   **  +  ** x+**(+++++)  
>    **v.y**  ----------------------------------------------------------------- 
>     ** ** "Life *is* pain, Princess. Anybody that tells you different is
>       *  selling something." - 'Dread Pirate Roberts', The Princess Bride
> 
> 
> --
>    WWW:   http://www.afterstep.org/
>    FTP:   ftp://ftp.afterstep.org/
>    MAIL:  http://www.caldera.com/linuxcenter/forums/afterstep.html
> 
> 


-M    
                             
One is most dishonest towards one's God; he is not _permitted_ to sin. 
 
mail: mjohnson@pop3.aebc.com
                                     



--
   WWW:   http://www.afterstep.org/
   FTP:   ftp://ftp.afterstep.org/
   MAIL:  http://www.caldera.com/linuxcenter/forums/afterstep.html