Journal of Technical Writing and Communication Oct 2018

Rhetorical Genres in Code

Kevin Brock University of South Carolina ; Ashley Rose Mehlenbacher University of Waterloo

Abstract

We examine the rhetorical activity employed within software development communities in code texts. For technical communicators, the rhetoricity of code is crucial for the development of more effective code and documentation. When we understand that code is a collection of rhetorical decisions about how to engage those machinic processes, we can better attend to the significance and nuance of those decisions and their impact on potential user activities.

Journal
Journal of Technical Writing and Communication
Published
2018-10-01
DOI
10.1177/0047281617726278
CompPile
Open Access
Closed
Topics
Export
BibTeX RIS

Citation context

Cited by in this index (3)

  1. Johnson (2026)
    What Video Games Can Tell Us About Interactive Technical Communication
    Journal of Technical Writing and Communication
  2. McDaniel et al. (2021)
    Game Design Tactics for Teaching Technical Communication in Online Courses
    Journal of Technical Writing and Communication
  3. Glotfelter (2019)
    Algorithmic Circulation: How Content Creators Navigate the Effects of Algorithm…
    Computers and Composition

References (84) · 18 in this index

  1. Albers (2009)
    Design for Effective Support of User Intentions in Information-Rich Interactions
    Journal of Technical Writing and Communication
  2. 10.1007/978-3-319-40295-6_3
     ↗
  3. Artemeva N. (2016)
    Genre studies around the globe: Beyond the three traditions
  4. Bazerman C. (1994)
    Genre and the new rhetoric
  5. Beck (2015)
    The Invisible Digital Identity: Assemblages in Digital Networks
    Computers and Composition
Show all 84 →
  1. Birkbak, A. & Carlsen, H. B. (2016). The world of Edgerank: Rhetorical justifications of Facebook’s news feed…
  2. 10.7551/mitpress/5334.001.0001
     ↗
  3. Briandoll. (2012). The Octoverse in 2012. GitHub . Retrieved from…
  4. Brock, K. (2014). Enthymeme as rhetorical algorithm. Present Tense: A Journal of Rhetor…
  5. Brooke C. G. (2009)
    Lingua fracta: Towards a rhetoric of new media
  6. 10.3998/dh.13474172.0001.001
     ↗
  7. Brown, J. J., Jr. & Vee, A. (2016). Rhetoric special issue editorial introduction. Comp…
  8. 10.7551/mitpress/9384.001.0001
     ↗
  9. 10.5749/j.ctttv58b.15
     ↗
  10. Casper C. F. (2016)
    Science and the internet: Communicating knowledge in a digital age
  11. 10.1353/con.0.0064
     ↗
  12. Code.org. (2014). Teach our K-8 intro to Computer Science. Code.org …
  13. Code.org. (2015). Anybody can learn. Code.org . Retrieved from ht…
  14. Cox G. (2013)
    Speaking code: Coding as aesthetic and political expression
  15. Cripps (2011)
    Technical Communications in OSS Content Management Systems: An Academic Institu…
    Journal of Technical Writing and Communication
  16. 10.1007/978-3-319-40295-6_8
     ↗
  17. 10.1075/pbns.188
     ↗
  18. Gonzalez-Pueyo et al. (2003)
    Scientific Articles in Internet Homepages: Assumptions upon Lay Audiences
    Journal of Technical Writing and Communication
  19. 10.1093/oso/9780190465926.001.0001
     ↗
  20. 10.1007/978-3-319-40295-6_12
     ↗
  21. 10.1109/HICSS.2004.1265271
     ↗
  22. Holmes, S. (2014). Rhetorical allegorithms in Bitcoin. Enculturation: A Journal of Rhet…
  23. Holmes, S. (2016). ‘Can we name the tools?’ Ontologies of code, speculative techné, and rhetorical concealmen…
  24. Hooks. (n.d.). Drupal API . Retrieved from https://api.drupal.org…
  25. 10.2307/3587930
     ↗
  26. Imerlin. (2007). Captcha Riddler. Drupal . Retrieved from https:/…
  27. Iva2k. (2010). BOTCHA Spam Prevention. Drupal . Retrieved from ht…
  28. 10.1080/00335637509383303
     ↗
  29. Johnson-Eilola, J. (2002). Open source basics: Definitions, models, and questions. SIGD…
     ↗
  30. Kelly A. R. (2015)
    POROI - The Project on Rhetoric of Inquiry
  31. 10.22230/cjc.2016v41n2a3043
     ↗
  32. Kelly A. R. (2016)
    Science and the internet: Communicating knowledge in a digital age
  33. Kernighan B. W. (1999)
    The practice of programming
  34. Kernighan B. W. (1978)
    The elements of programming style (2nd ed.)
  35. Knuth D. E. (1992)
    Literate programming
  36. 10.1177/000312240807300501
     ↗
  37. Lessig L. (1999)
    Code and other laws of cyberspace
  38. Lewis (2016)
    Content Management Systems, Bittorrent Trackers, and Large-Scale Rhetorical Gen…
    Journal of Technical Writing and Communication
  39. Lopes C. V. (2014)
    Exercises in programming style
  40. 10.7551/mitpress/7966.001.0001
     ↗
  41. Maher (2011)
    The Technical Communicator as Evangelist: Toward Critical and Rhetorical Litera…
    Journal of Technical Writing and Communication
  42. McCorkle B. (2012)
    Rhetorical delivery as technological discourse: A cross-historical study
  43. Mehlenbacher (2017)
    Crowdfunding Science: Exigencies and Strategies in an Emerging Genre of Science…
    Technical Communication Quarterly
  44. 10.1007/978-3-319-40295-6_6
     ↗
  45. 10.2307/375964
     ↗
  46. 10.1080/00335638409383686
     ↗
  47. Miller, C. R. & Kelly, A. R. (2016) Discourse genres. In A. Rocci & L. de Saussure (Eds.), …
     ↗
  48. Miller, C. R. & Shepherd, D. (2004). Blogging as social action: A genre analysis of the Weblog. In L. Gurak e…
  49. 10.1075/pbns.188.11mil
     ↗
  50. Pflugfelder (2017)
    Reddit’s “Explain Like I’m Five”: Technical Descriptions in the Wild
    Technical Communication Quarterly
  51. Porter (2009)
    Recovering Delivery for Digital Rhetoric
    Computers and Composition
  52. 10.1080/1369118X.2016.1254268
     ↗
  53. 10.1007/978-3-319-40295-6_9
     ↗
  54. Read (2016)
    The Net Work Genre Function
    Journal of Business and Technical Communication
  55. Reiff, M. J. & Bawarshi, A. (Eds.). (2016). Genre and the performance of publics …
     ↗
  56. RobLoach. (2007). ReCAPTCHA. Drupal . Retrieved from https://www.…
  57. Ross (2017)
    The Role of Ethics, Culture, and Artistry in Scientific Illustration
    Technical Communication Quarterly
  58. RUSSELL (1997)
    Rethinking Genre in School and Society: An Activity Theory Analysis
    Written Communication
  59. Sánchez (2017)
    The Roles of Technical Communication Researchers in Design Scholarship
    Journal of Technical Writing and Communication
  60. Sample, M. (2013). Criminal code: Procedural logic and rhetorical excess in videogames. …
  61. Sapienza (2002)
    Does Being Technical Matter? Xml, Single Source, and Technical Communication
    Journal of Technical Writing and Communication
  62. SCHRYER (1993)
    Records as Genre
    Written Communication
  63. Schryer C. F. (1994)
    Genre and the new rhetoric
  64. Schryer C. F. (1999)
    A Journal of Composition Theory
  65. 10.1080/13691180802109097
     ↗
  66. Shepherd D. (2016)
    Building relationships: Online dating and the new logics of Internet culture
  67. Sherlock (2009)
    Genre, Activity, and Collaborative Work and Play in World of Warcraft: Places a…
    Journal of Business and Technical Communication
  68. Spinuzzi, C. (2001). Software development as mediated activity: Applying three analytical frameworks for stud…
     ↗
  69. Spinuzzi, C. (2002). Towards a hermeneutic understanding of programming languages. Curr…
  70. Spinuzzi C. (2003)
    Writing selves/Writing societies: Research from activity perspectives
  71. 10.7551/mitpress/6875.001.0001
     ↗
  72. Spinuzzi, C. (2013). Topsight: A guide to studying, diagnosing, and fixing information …
  73. Stolley K. (2015)
    Rhetoric and the digital humanities
  74. Vee (2013)
    Understanding Computer Programming as a Literacy
    Literacy in Composition Studies
  75. Wardrip-Fruin N. (2009)
    Expressive processing: Digital fictions, computer games, and software studies
  76. Wickman C. (2016)
    Science and the Internet: Communicating knowledge in a digital age
  77. Wundo. (2004). CAPTCHA. Drupal . Retrieved from https://www.drupa…
  78. 10.2307/258774
     ↗
  79. Zappen (2005)
    Digital Rhetoric: Toward an Integrated Theory
    Technical Communication Quarterly
CrossRef global citation count: 5 View in citation network → Build reading path →

Related articles

  1. Communication Design Quarterly Mar 2026
    Review of "Text at Scale: Corpus Analysis in Technical Communication by Stephen Carradini and Jason Swarts," Carradini, S., & Swarts, J. (2023). Text at scale: Corpus analysis in technical communication. The WAC Clearinghouse/University Press of Colorado. https://doi.org/10.37514/TPC-B.2023.2104 ↗
    Matthew D. Bryan
    rhetorical criticism genre theory writing across the curriculum technical communication quantitative research book reviews
  2. Prompt: A Journal of Academic Writing Assignments Jan 2026
    A Murder Most Technical: Gamification, AI, and Rhetorical Genre Studies in the Technical Writing Classroom ↗
    Justin Cook
    rhetorical criticism genre theory writing pedagogy service learning teacher development argument collaborative writing technical communication professional writing
  3. Pedagogy Oct 2025
    Contributors ↗
    modern rhetorical theory rhetorical criticism genre theory cultural rhetorics first-year composition writing pedagogy advanced composition creative writing writing across the curriculum graduate education two-year college service learning teacher development technical communication professional writing labor and working conditions archival research multimodality artificial intelligence literacy studies race and writing gender and writing disability studies literary studies editorial matter
  4. IEEE Transactions on Professional Communication Jun 2025
    Presenting and Making Relevant: Analyzing Teaching Assistant Perceptions of Writing in Statistics Using Semantic Frames ↗
    Ben Markey
    rhetorical criticism genre theory discourse analysis graduate education teacher development assessment technical communication professional writing book reviews
  5. Technical Communication Quarterly Oct 2024
    ’F---- Shark Tank:’ Rethinking the Centrality of the Business Pitch in Microenterprise Entrepreneurship ↗
    Mason T. Pellegrini
    rhetorical criticism genre theory graduate education technical communication professional writing qualitative research race and writing affect and writing editorial matter