literate programming examples (Re: Thoughts from an outsider)

tim Rowledge tim at rowledge.org
Tue Sep 5 03:13:13 UTC 2006


On 4-Sep-06, at 7:06 PM, Ramon Leon wrote:
> If you can generate the docs from the code, of what additional  
> value is the doc?

Modulo the quality of the comments in the code that are being used,  
it's the presentation that can make the difference. A form of browser  
that can gather linked comments from methods and classes and present  
them in a neatly intelligible form is surely an improvement over  
scattered snippets?

But don't forget that crucial first clause above about the quality of  
the  source material.

tim
--
tim Rowledge; tim at rowledge.org; http://www.rowledge.org/tim
Useful random insult:- Always loses battles of wits because he's  
unarmed.





More information about the Squeak-dev mailing list