How we change what others think, feel, believe and do
CHAPTER 5 : Naming
Abbreviations are useful for reducing the length of a name, making it more manageable (and sometimes more readable too!). Thus:
ParagraphStatus ..becomes.. ParaSts
The danger with abbreviations is that they are often over-used, and names become unintelligible. The author is so accustomed to using his own abbreviation standards and methods, that 'FstPghLnSz' clearly means 'First paragraph line size' to him. Too many abbreviations put together like this are clearly unclear.
Abbreviations are often clear within context, but are unclear when viewed on their own. Does 'Wgt' mean 'Widget', or 'Weight', or something else?
A good test of an abbreviation: can it be pronounced? A really good abbreviation significantly reduces the number of letters used and can be understood both when looked at and when spoken:
Char, Curs, Len
There are several strategies for generating abbreviations:
Once an abbreviation is used, then it is important that the same spelling is used consistently. If a different spelling for the same abbreviation is used, then it can easily cause confusion. eg. 'WinHgt' uses 'Win' as an abbreviation for 'Window' and 'Hgt' as an abbreviation for 'Height'. It would be confusing to subsequently use names like 'WndwWidth' or 'CharHght'.
And the big