Re: Documentation

Jan Sacharuk (jan@ugrad.cs.ualberta.ca)
Thu, 6 Aug 1998 09:25:58 -0600 (MDT)


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