Re: Guidance for Cocoa's steep learning curve

FROM : I. Savant
DATE : Fri May 16 16:27:13 2008

> Sigh.  Your attitude reminds me of a conversation I once had with a
> fellow programmer.  When I was encouraging her to add more documentation
> to the code, she replied, jokingly, "If it was hard for me to write,
> then it should be hard for them to read."
>
> The sad thing is that you are not joking...


  I don't think it's possible to continue a rational debate when you
keep going down this type of path. Nobody here even remotely suggested
that documentation should be hard to read. Conversely, nobody can
reasonably argue that it is possible for documentation (on such a
highly complex technical subject) to be made "easy".

--
I.S.