Technical writing and computer programming
Abstract
It is argued that technical writing and computer programming are based on similar principles, perhaps because both are mechanisms for efficiently organizing and communicating complex information. Both technical writing and programming are multistep processes involving planning, drafting, and revising. Moreover, six key aspects of computer programming (modularity, modifiability, user interface, failsafe presentation, style, and debugging) have analogs among such technical writing principles and practices as report sectioning, audience analysis and adaptation, and editing. These similarities are discussed and a course that builds on these likenesses to teach technical writing to programming students is described.< <ETX xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:xlink="http://www.w3.org/1999/xlink">></ETX>
- Journal
- IEEE Transactions on Professional Communication
- Published
- 1988-01-01
- DOI
- 10.1109/47.9219
- CompPile
- Search in CompPile ↗
- Open Access
- Closed
- Topics
- Export
- BibTeX RIS
Citation Context
Cited by in this index (0)
No articles in this index cite this work.
Cites in this index (2)
-
Weiss (1986)Journal of Technical Writing and Communication
-
Benzon (1981)Journal of Technical Writing and Communication
Related Articles
-
Business and Professional Communication Quarterly Jan 2026LinkedIn in Business and Technical Communication: A Textbook Analysis Grounded in Digital Literacy ↗Sarah Moore; Kathryn Lookadoo
-
Communication Design Quarterly Sep 2025Review of "Queer Techné: Bodies, Rhetoric, and Desire in the History of Computing by Patricia Fancher," Fancher P. (2024). <i>Queer techné: Bodies, rhetoric, and desire in the history of computing.</i> National Council of Teachers of English. ↗Thomas Gurinskas
-
Communication Design Quarterly Jun 2025Review of "User Experience Research and Usability of Health Information Technology by Jessica Lynn Campbell, PhD," Campbell, J. L. (2024). <i>User Experience Research and Usability of Health Information technology.</i> CRC Press. ↗Chip Warner
-
Technical Communication Quarterly Apr 2025Beyond Digital Literacy: Investigating Threshold Concepts to Foster Engagement with Digital Life in Technical Communication Pedagogy ↗Danielle Mollie Stambler; Nupoor Ranade; Daniel L. Hocutt; Stephen Fonash; Jessica Lynn Campbell; Ann Hill Duin; Isabel Pedersen; Jason Tham; Saveena (Chakrika) Veeramoothoo; Gustav Verhulsdonck
-
Pedagogy Apr 2025modern rhetorical theory rhetorical criticism african american rhetorics cultural rhetorics first-year composition writing pedagogy basic writing graduate education two-year college teacher development writing centers technical communication professional writing labor and working conditions digital rhetoric multimodality social media literacy studies race and writing gender and writing community literacy literary studies editorial matter