Sure, no argument there. Someone had written about parameter type comments. Self objects and slots can have comments in their annotations. Easy enough to write some reflective code to compile it, search it, etc.

- David (from iPad, typos likely)

On Jul 22, 2016, at 6:01 PM, 'Jason Grossman' [self-interest] <> wrote:


I guess we're talking at cross purposes. I'd like documentation of
things that are not machine-checkable, like overviews of what the most
important objects are and what they're for.

On 23 Jul 2016, at 10:58, David Ungar [self-interest]

> Machine-checkable info is more reliable.

>> Dne 22.7.2016 v 06:43 'Jason Grossman'
>> [self-interest] 
>> napsal(a):
>>> IMO the worst thing that ever happened to object-oriented
>>> programming
>>> was the idea that if we write good code our environments will
>>> automatically be self-documenting.