[self-interest] documentation!
David Ungar
ungar at me.com
Sat Jul 23 15:01:03 UTC 2016
For higher level comments than individual objects, how about comments on name space objects? For instance globals? If you want a comment on a category, you could use a separate parent object instead.
- David (from iPad, typos likely)
> On Jul 22, 2016, at 10:28 PM, Russell Allen mail at russell-allen.com [self-interest] <self-interest at yahoogroups.com> wrote:
>
> I first used Squeak 1.x and the system browse was enough for me to discover the system. Modern Pharo scares me though. The tools haven't scaled.
> Russell
>
> Sent from my phone
>
>
>> On 23 Jul 2016, at 2:06 PM, 'Jason Grossman' spam-me at xeny.net [self-interest] <self-interest at yahoogroups.com> wrote:
>>
>>
>> Yes, excellent.
>>
>> And then there's also stuff that's even more high level than that.
>>
>> For example, when I look through the object systems of Pharo or even the
>> relatively small Io, I find a mixture of things that are intended for
>> widespread use and things that are intended for niche uses, for lots of
>> reasons (e.g. they're experimental, or they're optimised for only
>> certain cases, or they're badly optimised but get correct results in
>> corner cases, or they can talk to other obsolete systems, or ...). This
>> can be shown in the internal documentation of the objects and sometime
>> is (not always - grrr), but that's not where it's most useful, is it? I
>> want to know before I start exploring which objects I should consider
>> first.
>>
>> On 23 Jul 2016, at 14:01, David Ungar ungar at me.com [self-interest]
>> wrote:
>>
>> > 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.
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.selflanguage.org/pipermail/self-interest/attachments/20160723/0676ed44/attachment.html>
More information about the Self-interest
mailing list