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.2.5
Page no. :  4-6
Line no.:  
Comment :  4.2.5.c

Comment:
“Names shall differ by more
than a single character.”

Recommended change:
“Names shall differ by more
than a single character where
practical and does not impede
the readability or intelligibility as
required by paragraph 4.2.5.a.”

Rationale:
This requirement can create
greater obscurity and make the
code more difficult to review,
especially when related
functions are used. 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]