Documentation [was: Morphic tutorial]
ducasse at iam.unibe.ch
Thu Feb 13 08:14:28 UTC 2003
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 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.
Prof. Dr. Stéphane DUCASSE (ducasse at iam.unibe.ch)
"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