Sage Journals: Discover world-class research

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.

Keywords

code studies software studies digital rhetoric rhetorical genre studies

Get full access to this article

View all access options for this article.

References

Albers

M. J.

(2009) Design for effective support of user intentions in information-rich interactions. Journal of Technical Writing and Communication 39(2): 177–194.

Arduser

(2017) Remediating diagnosis: A familiar narrative form or emerging digital genre? In: Miller

C. R.

Kelly

A. R.

(eds) Emerging genres in new media environments, London, England: Palgrave Macmillan, pp. 63–78.

Artemeva

(2016) Genre studies around the globe: Beyond the three traditions, Victoria, BC: Trafford Publishing.

Bazerman

(1994) Systems of genres and the enactment of social intentions. In: Freedman

Medway

(eds) Genre and the new rhetoric, London, England: Taylor and Francis, pp. 79, 79–101101.

Beck

(2015) The invisible digital identity: Assemblages in digital networks. Computers and Composition 35(1): 125–140.

Birkbak, A., & Carlsen, H. B. (2016). The world of Edgerank: Rhetorical justifications of Facebook’s news feed algorithm. Computational Culture, 5. Retrieved from http://computationalculture.net/article/the-world-of-edgerank-rhetorical-justifications-of-facebooks-news-feed-algorithm.

Bogost

(2007) Persuasive games: The expressive power of videogames, Cambridge, MA: MIT Press.

Briandoll. (2012). The Octoverse in 2012. GitHub. Retrieved from https://github.com/blog/1359-the-octoverse-in-2012.

Brock, K. (2014). Enthymeme as rhetorical algorithm. Present Tense: A Journal of Rhetoric in Society, 4(1). Retrieved from http://www.presenttensejournal.org/volume-4/enthymeme-as-rhetorical-algorithm/.

10.

Brooke

C. G.

(2009) Lingua fracta: Towards a rhetoric of new media, New York, NY: Hampton Press.

11.

Brown

J. J.

Jr. (2015) Ethical programs: Hospitality and the rhetorics of software, Ann Arbor, MI: University of Michigan Press.

12.

Brown, J. J., Jr., & Vee, A. (2016). Rhetoric special issue editorial introduction. Computational Culture, 5. Retrieved from http://computationalculture.net/editorial/rhetoric-special-issue-editorial-introduction.

13.

Brunton

(2013) SPAM: A shadow history of the Internet, Cambridge, MA: MIT Press.

14.

Burgess

H. J.

(2010) <?php>: “Invisible” code and the mystique of Web writing. In: Dilger

Rice

(eds) From a to <a>: Keywords of markup, Minneapolis, MN: University of Minnesota Press, pp. 167–185.

15.

Casper

C. F.

(2016) The online research article and the ecological basis of new digital genres. In: Gross

A. G.

Buehl

(eds) Science and the internet: Communicating knowledge in a digital age, Amityville, NY: Baywood, pp. 77–98.

16.

Chun

W. H. K.

(2008) On “sourcery” or code as fetish. Configurations 16(3): 299–324.

17.

Code.org. (2014). Teach our K-8 intro to Computer Science. Code.org. Retrieved from https://code.org/educate/20hr.

18.

Code.org. (2015). Anybody can learn. Code.org. Retrieved from https://code.org/.

19.

Cox

(2013) Speaking code: Coding as aesthetic and political expression, Cambridge, MA: MIT Press.

20.

Cripps

M. J.

(2011) Technical communications in OSS content management systems: An academic institutional case study. Journal of Technical Writing and Communication 41(4): 423–448.

21.

Ding

(2017) Cross-culturally narrating risks, imagination, and realities of HIV/AIDS. In: Miller

C. R.

Kelly

A. R.

(eds) Emerging genres in new media environments, London, England: Palgrave Macmillan, pp. 153–170.

22.

Giltrow

Stein

(2009) Genres in the Internet: Issues in the theory of genre, Amsterdam, The Netherlands: John Benjamins.

23.

Gonzalez-Pueyo

Redrado

(2003) Scientific articles in Internet homepages: Assumptions upon lay audiences. Journal of Technical Writing and Communication 33(2): 165–184.

24.

Gross

A. G.

Harmon

J. E.

(2016) The Internet revolution in the sciences and humanities, Oxford, England: Oxford University Press.

25.

Hartelius

E. J.

(2017) Sentimentalism in online deliberation: Assessing the generic liability of immigration discourses. In: Miller

C. R.

Kelly

A. R.

(eds) Emerging genres in new media environments, London, England: Palgrave Macmillan, pp. 225–241.

26.

Herring

S. C.

Scheidt

L. A.

Bonus

Wright

(2004) Bridging the gap: A genre analysis of weblogs. In: Sprague

R. H.

Jr. (ed.) Proceedings of the 37th Annual Hawaii International Conference on System Science, Los Alamitos, CA: IEEE Computer Society Press, pp. 101–111.

27.

Holmes, S. (2014). Rhetorical allegorithms in Bitcoin. Enculturation: A Journal of Rhetoric, Writing, and Culture, 18. Retrieved from http://enculturation.net/rhetoricalallegorithms.

28.

Holmes, S. (2016). ‘Can we name the tools?’ Ontologies of code, speculative techné, and rhetorical concealment. Computational Culture, 5. Retrieved from http://computationalculture.net/article/can-we-name-the-tools-ontologies-of-code-speculative-techne-and-rhetorical-concealment.

29.

Hooks. (n.d.). Drupal API. Retrieved from https://api.drupal.org/api/drupal/includes%21module.inc/group/hooks/7.

30.

Hyon

(1996) Genre in three traditions: Implications for ESL. TESOL Quarterly 30(4): 693–722.

31.

Imerlin. (2007). Captcha Riddler. Drupal. Retrieved from https://www.drupal.org/project/riddler.

32.

Iva2k. (2010). BOTCHA Spam Prevention. Drupal. Retrieved from https://www.drupal.org/project/botcha.

33.

Jamieson

K. M.

(1975) Antecedent genre as rhetorical constraint. Quarterly Journal of Speech 61(4): 406–415.

34.

Johnson-Eilola, J. (2002). Open source basics: Definitions, models, and questions. SIGDOC ‘02, 79–83.

35.

Kelly

A. R.

Maddalena

(2015) Harnessing agency for efficacy: ‘Foldit’ and citizen science. POROI - The Project on Rhetoric of Inquiry 11(1): 1–20.

36.

Kelly

A. R.

Maddalena

(2016) Networks, genres, and complex wholes: Citizen science and how we act together through typified text. Canadian Journal of Communication 41: 287–303.

37.

Kelly

A. R.

Miller

C. R.

(2016) Intersections: Scientific and parascientific communication on the Internet. In: Gross

A. G.

Buehl

(eds) Science and the internet: Communicating knowledge in a digital age, Amityville, NY: Baywood Press, pp. 221–245.

38.

Kernighan

B. W.

Pike

(1999) The practice of programming, Reading, MA: Addison-Wesley.

39.

Kernighan

B. W.

Plauger

P. J.

(1978) The elements of programming style (2nd ed.), New York, NY: McGraw-Hill.

40.

Knuth

D. E.

(1992) Literate programming, Stanford, CA: Center for the Study of Language and Information.

41.

Lena

J. C.

Peterson

R. A.

(2008) Classification as culture: Types and trajectories of music genres. American Sociological Review 73(5): 697–718.

42.

Lessig

(1999) Code and other laws of cyberspace, New York, NY: Basic Books.

43.

Lewis

(2016) Content management systems, Bittorrent trackers, and large-scale rhetorical genres: Analyzing collective activity in participatory digital spaces. Journal of Technical Writing and Communication 46(1): 4–26.

44.

Lopes

C. V.

(2014) Exercises in programming style, Boca Raton, FL: Chapman and Hall/CRC Press.

45.

Losh

(2009) Virtualpolitik: An electronic history of government media-making in a time of war, scandal, disaster, miscommunication, and mistakes, Cambridge, MA: MIT Press.

46.

Maher

(2011) The technical communicator as evangelist: Toward critical and rhetorical literacies of software documentation. Journal of Technical Writing and Communication 41(4): 367–401.

47.

McCorkle

(2012) Rhetorical delivery as technological discourse: A cross-historical study, Carbondale, IL: Southern Illinois University Press.

48.

Mehlenbacher

A. R.

(2017) Crowdfunding science: Exigencies and strategies in an emerging genre of science communication. Technical Communication Quarterly 26(2): 127–144. doi: 10.1080/10572252.2017.1287361.

49.

Mehlenbacher

Kampe

(2017) Expansive genres of play: Getting serious about game genres for the design of future learning environments. In: Miller

C. R.

Kelly

A. R.

(eds) Emerging genres in new media environments, London, England: Palgrave Macmillan, pp. 117–133.

50.

Miller

C. R.

(1979) A humanistic rationale for technical writing. College English 40(6): 610–617.

51.

Miller

C. R.

(1984) Genre as social action. Quarterly Journal of Speech 70: 151–176.

52.

Miller, C. R., & Kelly, A. R. (2016) Discourse genres. In A. Rocci & L. de Saussure (Eds.), Verbal Communication (pp. 269–286). Berlin, Germany: Mouton–De Gruyter.

53.

Miller, C. R., & Shepherd, D. (2004). Blogging as social action: A genre analysis of the Weblog. In L. Gurak et al. (Eds.), Into the blogosophere: Rhetoric, community, and culture of weblogs. University of Minnesota Libraries. Retrieved from http://conservancy.umn.edu/handle/11299/172818.

54.

Miller

C. R.

Shepherd

(2009) Questions for genre theory from the blogosphere. In: Giltrow

Stein

(eds) Genres in the Internet: Issues in the theory of genre, Amsterdam, The Netherlands: John Benjamins, pp. 263–290.

55.

Pflugfelder, E. H. (2017). Reddit’s “Explain Like I’m Five”: Technical descriptions in the wild. Technical Communication Quarterly. Advance online publication. doi: 10.1080/10572252.2016.1257741.

56.

Porter

J. E.

(2009) Recovering delivery for digital rhetoric. Computers and Composition 26(4): 207–224.

57.

Qiu

(2016) The openness of Open Application Programing Interfaces. Information, Communication & Society 20: 1720–1736.

58.

Randall

(2017) Source as Paratext: Videogame adaptations and the question of fidelity. In: Miller

C. R.

Kelly

A. R.

(eds) Emerging genres in new media environments, London, England: Palgrave Macmillan, pp. 171–185.

59.

Read

(2016) The net work genre function. Journal of Business and Technical Communication 30(4): 419–450.

60.

Reiff, M. J., & Bawarshi, A. (Eds.). (2016). Genre and the performance of publics. Boulder, CO: University Press of Colorado Press.

61.

RobLoach. (2007). ReCAPTCHA. Drupal. Retrieved from https://www.drupal.org/project/recaptcha.

62.

Ross

D. G.

(2017) The role of ethics, culture, and artistry in scientific illustration. Technical Communication Quarterly 26(2): 145–172. doi: 10.1080/10572252.2017.1287376.

63.

Russell

D. R.

(1997) Rethinking genre in school and society: An activity theory analysis. Written Communication 14(4): 504–554.

64.

Sánchez

(2016) The roles of technical communication researchers in design scholarship. Journal of Technical Writing and Communication 47(3): 359–391.

65.

Sample, M. (2013). Criminal code: Procedural logic and rhetorical excess in videogames. Digital Humanities Quarterly, 7(1). Retrieved from http://www.digitalhumanities.org/dhq/vol/7/1/000153/000153.html.

66.

Sapienza

(2002) Does being technical matter? XML, single source, and technical communication. Journal of Technical Writing and Communication 32(2): 155–170.

67.

Schryer

C. F.

(1993) Records as genre. Written communication 10(2): 200–234.

68.

Schryer

C. F.

(1994) The lab vs. the clinic: Sites of competing genres. In: Freedman

Medway

(eds) Genre and the new rhetoric, London, England: Taylor & Francis, pp. 105–124.

69.

Schryer

C. F.

(1999) Genre time/space: Chronotopic strategies in the experimental article. A Journal of Composition Theory 19: 81–89.

70.

Shah

R. C.

Kesan

J. P.

(2008) Setting online policy with software defaults. Information, Communication & Society 11(7): 989–1007.

71.

Shepherd

(2016) Building relationships: Online dating and the new logics of Internet culture, New York, NY: Lexington Books.

72.

Sherlock

(2009) Genre, activity, and collaborative work and play in World of Warcraft: Places and problems of open systems in online gaming. Journal of Business and Technical Communication 23(3): 263–293.

73.

Spinuzzi, C. (2001). Software development as mediated activity: Applying three analytical frameworks for studying compound mediation. In M. J. Northrop, & S. Tilley (Eds.), SIGDOC ‘01: Proceedings of the 19th Annual International Conference on Computer Documentation (pp. 58–67). New York: ACM Digital Library.

74.

Spinuzzi, C. (2002). Towards a hermeneutic understanding of programming languages. Currents in Electronic Literacy, 6. Retrieved from http://currents.dwrl.utexas.edu/spring02/spinuzzi.html.

75.

Spinuzzi

(2003a) Compound mediation in software development: Using genre ecologies to study textual artifacts. In: Bazerman

Russell

D. R.

(eds) Writing selves/Writing societies: Research from activity perspectives, Fort Collins, CO: WAC ClearinghouseRetrieved from http://wac.colostate.edu/books/selves_societies/spinuzzi/.

76.

Spinuzzi

(2003b) Tracing genres through organizations: A sociocultural approach to information design, Cambridge, MA: MIT Press.

77.

Spinuzzi, C. (2013). Topsight: A guide to studying, diagnosing, and fixing information flow in organizations. Seattle, WA: CreateSpace Independent Publishing Platform.

78.

Stolley

(2015) MVC, materiality, and the magus: The rhetoric of source-level production. In: Ridolfo

Hart-Davidson

(eds) Rhetoric and the digital humanities, Chicago, IL: University of Chicago Press, pp. 264–276.

79.

Vee, A. (2013). Understanding computer programming as a literacy. Literacy in Composition Studies, 1(2). Retrieved from http://licsjournal.org/OJS/index.php/LiCS/article/view/24.

80.

Wardrip-Fruin

(2009) Expressive processing: Digital fictions, computer games, and software studies, Cambridge, MA: MIT Press.

81.

Wickman

(2016) “Learning to share your science”: The scientific notebook textual object and dynamic rhetorical space. In: Gross

A. G.

Buehl

(eds) Science and the Internet: Communicating knowledge in a digital age, Amityville, NY: Baywood Press, pp. 11–32.

82.

Wundo. (2004). CAPTCHA. Drupal. Retrieved from https://www.drupal.org/project/captcha.

83.

Yates

Orlikowski

W. J.

(1992) Genres of organizational communication: A structurational approach to studying communication and media. Academy of Management Review 17(2): 299–326.

84.

Zappen

J. P.

(2005) Digital rhetoric: Toward an integrated theory. Technical Communication Quarterly 14(3): 319–325.

Rhetorical Genres in Code

Abstract

Keywords

Get full access to this article

References