US Election Assistance Commission - Voluntary Voting System Guidelines Vote
EAC Home
Introduction
View Guidelines
View Comments
Glossary

View Comments

Section CommentsGeneral CommentsGlossary Comments
 
Name :   Scott Hunsaker
Organization :   Hart Intercivic
Post Date :   9/30/2005

Section Comments
Section :  4
Page no. :  4-6
Line no.:  4.2.5.c
Comment :  30 I 4 p 4-6 4.2.5.c

All single-character names are
forbidden except for variables
used as loop indexes.

All single-character names
should be avoided and only
used where software
programming conventions
dictate. Examples of such
conventions include names of
loop indexes and X-Y
coordinates.

This requirement can create
greater obscurity and make the
code more difficult to review,
especially when conflicting with
well established programming
practices and conventions that
have been in use by the
software industry since it
inception. While attempting to
enhance the readability, the
requirement is arbitrary and
should be defined as a
guideline and it effectively
contradicts the requirement in
4.2.5.a. "…variable names
shall be chosen so as to
enhance the readability and
intelligibility of the program.
[McConnell Ch 9]