[ANN] Documentation Website

Duane Maxwell dmaxwell at san.rr.com
Mon Feb 4 18:46:27 UTC 2002


Goran writes:
> The Sqdb is an attempt to host comments outside of the image. I
> personally don't know if it will succeed - it will definitely require
> good tool support IN the image, in order to be used. But it is an
> interesting idea nevertheless.

Correct.

> SqueakDoc though seems to "clash" with Sqdb - but on the other hand,
> that's bound to happen I guess.

Yes, it would seem to.  Frankly, I'm not so hung up on sqdb that I wouldn't
defer to a superior solution.  I am of the opinion that the success of any
documentation effort needs to be tightly integrated with the image.  The web
portion of my site is there only for support - the primary interfaces are
through XML.

I am very impressed by the SqueakDoc.org effort so far.  I would have no
problem shifting my stuff to that site, linking, or mirroring, or whatever.
Perhaps Bernd would like to see what I've done so far and adopt a similar
solution, or take over mine.

I think Scamper is the biggest obstacle to SqueakDoc.org at the moment.

-- Duane




More information about the Squeak-dev mailing list