[Planetlab-users] PlanetLab Wiki

[Emil Sit]

On Wed, 14 April 2004 at 17:10 (-0400), Scott Karlin wrote:
> On Wed, Apr 14, 2004 at 01:47:01PM -0700, Timothy Roscoe wrote:
> > I'd like to propose a system more like the PHP web site (php.net) or
> > the many others like it - users add comments to the end of sections of
> > the documentation so that it's all available in the same place.
[...] 
> We can weakly emulate what you suggest by keeping the static pages
> and then having a shadow wiki -- people would keep two browser
> windows open simultaneously.  For now, this is my intention.

Of course, there's no reason why you can't simply put the 
documentation on the Wiki, and people can add comments to the
bottom anyway.  And periodically, comments can be refactored
directly into the actual text.

But, for more fine-grained commentary, annotation tools such as
CritSuite [1] or Annotea [2] might be appropriate.  CritSuite,
though it's pretty old, seemed to work pretty well and not require
any client support.  You just need to set up a crit server, and
then you can hit URLs like:

	http://crit.org/http://www.planet-lab.org/

That'll automatically enable annotation viewing and then you could
just click through and use HTML forms to make additional
annotations.  (Unfortunately, crit.org appears to have gone down
for lack of funding.)

Annotea might appeal to the XML fans but client support seems to
be lacking.

[1] http://web.archive.org/web/20020203145236/http://crit.org/index.html
    http://www.buzzmaven.com/modules/mylinks/singlelink.php?cid=2&lid=11
[2] http://annozilla.mozdev.org/