[stringtemplate-interest] package name

Zenaan Harkness zen at freedbms.net
Sat Oct 17 19:22:29 PDT 2009


On Sat, Oct 17, 2009 at 11:55:03AM -0700, Joseph Grace wrote:
> On Sat, Oct 17, 2009, Zenaan Harkness wrote:
> >http://lwn.net/Articles/351422/
> >Just read last month, when Ken Thomson was asked what he'd do
> >differently about Unix IO api, he would have spelt creat as "create".
> 
> I believe that "creat" vs. "create" and "ST" vs. "StringTemplate" are
> fundamentally different and even opposing use cases.
> 
> "creat" is only 1 letter shorter than "create".
> "ST" is a 12 letters more convenient than the hefty "StringTemplate".
> 
> "creat" sees infrequent use, suggesting the name should be explicit (as long
> as necessary), specific, and self-documenting, and not clutter up the
> abbreviated namespace.
> "ST" is essential to use StringTemplate,

In the context of programmatically generated templates.

I have a "driver" to which I feed data and template-groups-in-files.

But I do grant that programmatic ST does not appear uncommon from what I
can tell...


> so it sees frequent use and should
> be as short as reasonable to declutter the code.  It deserves an
> abbreviation.
> 
> "create" says what it means.
> StringTemplate is made up and only has special meaning.  So "ST" is a made

Well that's true. I hadn't thought of it that way. Seemed so intuitive a
name. I guess we could consider StringsAndAttributesTemplate :)

What do you think about just "Template"?


> up word with very specific meaning, StringTemplate.  It's short, so it
> implies it deserves heavy use (see point 3, above) and has the benefit of
> fairly unique spelling (capitalization sensitivity on for searching) as it
> doesn't exist in the wild (unlike "Template" which may exist in code, or
> even in English text).

Hmm. You're swaying me on this one.


> So, I would say that while "creat" well deserves an "e", "ST" does not
> necessarily deserve a "ringemplate".  I would say these are two different
> use cases, and the same principles actually suggest opposite treatments:
>  longer for uncommon "creat" -> "create", and shorter for ubiquitous
> "StringTemplate" -> "ST".
> 
> Bottom Line
> 
> Short implies heavy use, a gateway to a useful, frequently used library.
>  That's what ST should be for its use cases, and the long name negates some
> of its convenience.  And because of its hefty typing load, IMO,
> "StringTemplate" sends the wrong message to potential users of the
> StringTemplate.
> 
> IMO:  "ST" >> "StringTemplate".
> 
> = Joe =

Template?

-- 
Homepage: www.SoulSound.net -- Free Australia: www.UPMART.org
Please respect the confidentiality of this email as sensibly warranted.


More information about the stringtemplate-interest mailing list