Re: [Ocaml-lib-devel] ExtLib v0.1o

[fva <fv...@ts...>]

Blair Zajac wrote:

>So I propose this naming scheme.
>
>1) A module name may consists of one or more words.  The first letter
>   of each word is capitalized.  Words are concatenated together with
>   no additional characters, such as _.
>
Agree.

>2) For module names consisting of two or more words, the more general
>   word is listed first, followed by words that qualify the first word.
>
>   So ListMutable instead of MutableList.
>
Disagree... I'd rather have the English convention: modifiers first even 
if they are verbs (Hashtbl) or substantives (PriorityQueue, MutableList) 
or whatever (MyList, ThisList,,,)

>3) Words making up a name may be shortened if the short version is a
>   commonly known shortcut.  Make the name as short as possible but no
>   shorter than needed to be easily readable for a code review.
>
>   Determining a shortcut would be up to a vote to see how many people
>   could use the shortcut without looking it up.
>
>   Example shortcut: Character -> Char.
>
Agree, with nuances: remember some abbreviations simply don't read well 
(See J. Aitchison on organization of the mental lexicon and what gets 
read there). It is clear to me that built-in types *do*read well as 
modifiers, because most seasoned users of the language already have 
"char", "int" and "bool" as lexical items. Hence your "good-looking" 
CharList, CharArrayList, etc...

Regards,

        Fran Valverde