EAC - Voluntary Voting System Guidelines

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]