[self-interest] documentation!

David Ungar ungar at me.com
Sat Jul 23 04:01:46 UTC 2016


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' spam-me at xeny.net [self-interest] <self-interest at yahoogroups.com> 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 ungar at me.com [self-interest] 
> wrote:
> 
> > Machine-checkable info is more reliable.
> 
> >> Dne 22.7.2016 v 06:43 'Jason Grossman' spam-me at xeny.net 
> >> [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.
> 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.selflanguage.org/pipermail/self-interest/attachments/20160722/8eadf48d/attachment.html>


More information about the Self-interest mailing list