So every newly-created class would automatically have a hyperlink to the
appropriate Swiki page?  Sweeeet......

-----Original Message-----
From: Doug Way [mailto:dway at riskmetrics.com]
Sent: Thursday, February 27, 2003 8:50 PM
To: swiki-bugs at cc.gatech.edu; The general-purpose Squeak developers list
Subject: ComSwiki enhancement request (was Re:
[ENH][DOC]MorphClassComment-efc)



I guess I've mentioned this before, but one simple solution would be to
have
an automatic link of some sort (or perhaps a menu item) from the class
comment
in the Squeak browser to open scamper on a corresponding swiki page
about the
class.  This way, the swiki page could have more recent class comments
if
available, easily editable by anyone, as a sort of backup to the class
comment
in the image (which as we know is often missing completely).  And this
backup
comment would be easily accessible from the class browser.

However, we'd need a reliable way to specify a swiki page based on its
name. 
Something like http://minnow.cc.gatech.edu/squeak?page=Morph should
access the
page "Morph" on the swiki.  Right now, you can try something like
http://minnow.cc.gatech.edu/squeak/morph but it doesn't work reliably
(as in
this case).

I'm submitting this an an official ComSwiki enhancement request this
time, if
anyone feels like adding this feature. :-)

- Doug Way


Eddie Cottongim wrote:
> 
> I had really only intended the swiki page to be a temporary work area.
But I
> do like the idea of some kind of linkage between internal and external
docs.
> 
> It would be nice if there was a way for the swiki to directly reflect
the
> comments in the image (like javadoc but more dynamically bound), have
a way
> to annotate them, and provide a way that people could harvest updated
> comments to go into the image. Something like, "show me all the class
> comments people have annotated/updated since #5183", and the harvester
would
> pick the ones he/she thought were improvements for inclusion with the
image.
> --I don't think you'd want the new comments to go in the image
> directly/automatically. Too easy for junk to get in that way.
> --Need to work out the semantics of what happens when the image
comment is
> updated: Probably the comment text would be updated, but old
annotations
> would stay.
> 
> Maybe someone did that already. Just an idea.
> 
> Eddie
> 
> ----- Original Message -----
> From: "Brent Vukmer" <bvukmer at blackboard.com>
> To: "The general-purpose Squeak developers list"
> <squeak-dev at lists.squeakfoundation.org>
> Sent: Thursday, February 27, 2003 11:38 AM
> Subject: RE: [ENH][DOC] MorphClassComment-efc
> 
> Looks great.  What about putting a hyperlink to the Swiki page for
this
> class comment( assuming that page is up-to-date ), within the class
> comment?