What I saw from dandelion that looked interesting was the ability to export
directly to a UML tool.  Then you would have the ability to see the links 
between
the classes visually.  At least that's how it looked to me.


>From: Ramon Leon <ramonleon at cox.net>
>Reply-To: The general-purpose Squeak developers 
>list<squeak-dev at lists.squeakfoundation.org>
>To: The general-purpose Squeak developers 
>list<squeak-dev at lists.squeakfoundation.org>
>Subject: Re: literate programming examples (Re: Thoughts from an outsider)
>Date: Mon, 04 Sep 2006 19:06:24 -0700
>
>>2. ruby. http://www.ruby-doc.org/core and http://www.ruby-doc.org/stdlib 
>>present current, accessible API docs and also higher level docs with very 
>>little fuss. These are generated from extensive code comments, READMEs, 
>>etc. (Many other languages do this but less effectively.)
>
>I can't help but point out how much Ruby's doc's are just imitations of a 
>Smalltalk class browser.  How exactly is this better than class and method 
>comments in Smalltalk directly?  How is dandelion better than a real 
>browser either?  If you can generate the docs from the code, of what 
>additional value is the doc?
>
>