Documentation [was: Morphic tutorial]

Stephane Ducasse ducasse at
Thu Feb 13 08:14:28 UTC 2003

Hi richard,

sad but true....

May be I should insist and say again that all effort of documentation
(code based) out of the image are doomed and that Unit tests are the 
only way to go.
Not sexy fancy supercoooool but the only way to get concrete scenario 
of the system
in a reproduceable way and in sync with the system because even example 
methods got obsolete.


My be I should really look at Python because after all the decades they 
may have soemthing
better to show us. May be they learned in the process. They have 
blockclosures so there is a hope.

On Thursday, February 13, 2003, at 02:49 AM, Richard A. O'Keefe wrote:

> Daniel Vainsencher <danielv at> 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.
Prof. Dr. Stéphane DUCASSE (ducasse at
  "if you knew today was your last day on earth, what would you do
  different? ... especially if, by doing something different, today
  might not be your last day on earth" Calvin&Hobbes

More information about the Squeak-dev mailing list