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
|