Documentation [was: Morphic tutorial]

Richard A. O'Keefe ok at cs.otago.ac.nz
Thu Feb 13 01:49:11 UTC 2003


Daniel Vainsencher <danielv at netvision.net.il> wrote:
	I've noticed some people are already turning up with questions
	about various existing docs and examples, and I think this is
	great - I think we suffer much more from our docs being to
	disorganized and not-quite-up-to date than from lacking Docs.
	So just roaming over all the documentation and reading it and
	trying things out, and fixing what doesn't work is a really
	great way of making it better.
	
I am getting a bit sick of this.
Scattered, disorganised, and out of date documentation
is, practically speaking, no documentation at all.
It is, at best, a sop to people's consciences.

I have a friend here.  I like Squeak.  He likes Python.
I've been programming a lot longer than he has, in a lot more
languages.  Guess who can get more done faster?

If it doesn't have a user interface, I can.  (Probably in Haskell.)

It it has a user interface, he can.
Because Python has documentation.  Documentation you don't
have to spend hours searching for on a net you may not be able to
access at the time.  Documentation that comes _with_ Python, it's
right there on the CD or in the .tgz file.  Documentation that
actually tells you everything you need to know to get up to speed.

The next time someone says "let's make a Swiki page to talk about
documentation" I'm going to vomit.

Then I'm going to borrow my friend's Core Python book.



More information about the Squeak-dev mailing list