Err, Bob, what email program are you using? It seems to have made a  
very confusing mess of the conversation thus far!


On 29-Dec-07, at 7:47 PM, Robert Hawley wrote:
>
>>>>>>>> what I meant here is a generic menu item or button so that  
>>>>>>>> every element
>>>>>>>> is assumed to have documentation on the web-site.  At the  
>>>>>>>> moment the
>>>>>>>> comments get into the image with code - I am suggesting an  
>>>>>>>> external
>>>>>>>> place where additional material can be added (including  
>>>>>>>> examples etc)
>>>>>>>> much more easily and flexibly.

The cmd-6 weblink option I pointed out simply provides a way to have a  
URL in any text within Squeak; if you click on it Squeak tries to open  
the URL in your chosen web browser. Thus it is trivally easy to have  
any class or method comment contain a link to more detailed  
commentary, extended examples etc.

But crucially the mechanism is not even faintly the issue; the problem  
is getting the content out of people. Why, I've had to go to  
developers in the company of my old friend Mr BaseballBat to get  
comments out of them in the past!

tim
--
tim Rowledge; tim at rowledge.org; http://www.rowledge.org/tim
Fractured Idiom:- APRES MOE LE DELUGE - Larry and Curly get wet