Readability and computer documentation

Authors:
Gretchen Hargis
Affiliations:
IBM Corp., San Jose, CA
Venue:
ACM Journal of Computer Documentation (JCD)
Year:
2000

Citing 1
Cited 5

Developing Quality Technical Information: A Handbook for Writers and Editors (2nd Edition)

Developing Quality Technical Information: A Handbook for Writers and Editors (2nd Edition)

Practical guidelines for the readability of IT-architecture diagrams

Proceedings of the 20th annual international conference on Computer documentation
Real-life IT architecture design reports and their relation to IEEE Std 1471 stakeholders and concerns

Automated Software Engineering
How documentation evolves over time

Ninth international workshop on Principles of software evolution: in conjunction with the 6th ESEC/FSE joint meeting
Globally distributed content creation: developing consumable content for international markets

Proceedings of the 28th ACM International Conference on Design of Communication
On the refactoring of activity labels in business process models

Information Systems

Quantified Score

Hi-index	0.01

Visualization

Abstract

Traditional readability concerns are alive and well, but subsumed within several more recent documentation quality efforts. For example, concerns with interestingness and translatability for global markets, with audience analysis and task sufficiency, and with reader appropriateness of technical text all involve readability, but often in ways not easily measured by any formula.