Documentation [was: Morphic tutorial]
Daniel Vainsencher
danielv at netvision.net.il
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 cs.otago.ac.nz> 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.
...
> 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
|