Documentation [was: Morphic tutorial]

Daniel Vainsencher danielv at
Sat Feb 15 02:27:23 UTC 2003

Hi Richard.

I'm really not sure what you're responding to. I didn't say, add another
page. I said, take what's there, make it less "Scattered, disorganized,
and out of date".

BTW, if you're going to vomit, please, use a Bag ;-)

More to the point, you seem to be bothered by the fact that people are
putting docs in a Swiki because your connection is one sometimes
available. Since it is a cooperative project, obviously, it needs to be
on the net somewhere. So maybe the problem is really simply that you
don't have a way to take the Swiki with you, and the information in it
isn't made a part of standard releases, as man pages are with most
unixish software.

Since there are wonderful, easily installed Squeak wikis, it seems it's
just a matter of making a periodic release of a the relevant pages out
of the swiki, which is a simple matter of copying, without changing the
way the Doc group (and some other people) work. You'd just run a local
Swiki on your home machine, or extract the Swiki to some other format,
like HTML.

Heck, the whole thing could be packaged as a SAR package on SM that
installs only the swiki content, with a prerequisite for Comanche.

If this actually solves your problem...

Daniel Vainsencher

"Richard A. O'Keefe" <ok at> 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.
> 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