EAC - Voluntary Voting System Guidelines

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]