Proceedings of the 23rd annual international conference on Design of communication: documenting & designing for pervasive information
A metric for software readability
ISSTA '08 Proceedings of the 2008 international symposium on Software testing and analysis
Toward data mining engineering: A software engineering approach
Information Systems
| Hi-index | 0.00 |
The paper is based on the premise that the productivity and quality of software development and maintenance, particularly in large and long term projects, is related to software readability. Software readability depends on such things as coding conventions and system overview documentation. Existing mechanisms to ensure readability --- for example, peer reviews --- are not sufficient. The paper proposes that software organizations or projects institute a readability/documentation group, similar to a test or usability group. This group would be composed of programmers and would produce overview documentation and ensure code and documentation readability. The features and functions of this group are described. Its benefits and possible objections to it are discussed.