On Tue, Jun 30, 2015 at 2:10 AM, Sean P. DeNigris <s...@clipperadams.com> wrote:
> Peter Uhnák wrote
>> It seems that
>> <sample>
>>  is then the go-to naming for now
>
> I agree with Ben that from a native English perspective, exemplar doesn't
> quite sound right.
>
> Sample and Example are the two words that most clearly capture the intent.
> The problem with using #sample to return instances and #example to
> illustrate usage is that it's a bit too subtle. Even though technically one
> could argue the logic of that distinction, in reality English speakers use
> them interchangeably and it will be confusing.

Thats a fair argument.

> A core principle of Smalltalk
> is to type a bit more to make things clearer (e.g. avoid
> single-character/abbreviated variable names). I strongly feel we should be
> more specific and uniform by either using (<exampleInstance> &
> <exampleCode>) or (<sampleInstance> & <sampleCode>).

I find myself liking the last two, I think since the concatenated
words rolls off the tongue nicer with one less syllable, but I think
any of those are fine. Actually, rather than pairing based on the
first part, maybe using <exampleCode> together with <sampleInstance>
will distinguish the most between the two cases.

cheers -ben

Reply via email to