Avoid abbreviations
- Often there are multiple ways to abbreviate a name, but usually only one unabbreviated name. Don't make your users guess.
- Sometimes it's tempting to abbreviate names, but consider that having consistency across libraries is often more important, than a particularly nice or clever abbreviation.
- Users can rename things on import. This makes it straightforward to look up an abbreviated name, if the user decides to abbreviate something.
Avoid symbolic names
- Sometimes it is tempting to pick a symbolic name, but consider that it makes it hard for users to search for these names on the web, and causes issues with pronouncing these names.
- As a general rule of a thumb: If the cost/benefit ratio of a symbolic name is lower than
???
, it's probably not worth it.
Constructors