Abstract

In spite of a critical turn in technical communication research, discussions of software documentation continue to forward a singularly instrumental understanding of how these types of texts are composed and consumed. Using work on multiliteracies, I illustrate how analysis of the competing evangelisms of software that occur in programming culture unveils the ways in which documentation, like code, is ideologically encoded. Attention to the evangelisms of software facilitates critical literacy and, consequently, a richer rhetorical literacy. Such literacies are necessary for composing effective software documentation and identifying how the ideologies of software and its documentation intersect with the nationally-situated cultural values in which these technologies and texts are developed and used. To illustrate this complexity, I offer examples of the intersections between free and open source software evangelisms and the national-as-local contexts of the United States, Brazil, and China.

Journal
Journal of Technical Writing and Communication
Published
2011-01-01
DOI
10.2190/tw.41.4.d
CompPile
Search in CompPile ↗
Open Access
Closed
Topics
Export

Citation Context

Cited by in this index (2)

  1. Journal of Technical Writing and Communication
  2. Communication Design Quarterly

References (92) · 18 in this index

  1. Open Source Basics: Definitions, Models, and Questions
  2. Examining Open Source Software in Offshoring Contexts: A Perspective on Adding Value in a…
    Technical Communication
  3. Technical Communication Quarterly
  4. B. Smith, The State of OSS Documentation, <i>OSnews</i>, November 19, 2003. Retrieved May 18, 2010, from <a t…
  5. Documentation's Sorry State
    InfoWorld
Show all 92 →
  1. Perspectives on Software Documentation: Inquiries and Innovations
  2. Multiliteracies for a Digital Age
  3. Permanence and Change
  4. J. Atwood, Are You an Evangelist Too? <i>Coding Horror</i>, December 4, 2006. Retrieved October 14, 2009, fro…
  5. J. Plamondon, <i>Effective Evangelism. Slated Antitrust</i>, 2008. Retrieved October 15, 2010, from <a target…
  6. State of New York v. Microsoft Corporation
  7. Vatican: The Holy See, <i>Doctrinal Note on Some Aspects of Evangelization</i>, n.d. Retreived October 10, 20…
  8. The Hacker Ethic and the Spirit of the Information Age
  9. Hackers: Heroes of the Computer Revolution
  10. Open Source: Voices from the Open Source Revolution
  11. The Cathedral & the Bazaar: Musings on Linux and Open Source
  12. The New Hacker's Dictionary
  13. B. D. Ballentine, Hacker Ethics & Firefox Extensions: Writing & Teaching the "Grey" Areas of Web 2.0. Compute…
  14. R. Stallman, New UNIX Implementation, September 27, 1983. Retrieved October 15, 2009, from <a target="_blank"…
  15. Free Software Foundation, <i>The Free Software Definition, 1996</i>. Retrieved October 15, 2009, from <a targ…
  16. M. Tiemann, <i>History of the OSI, Open Source Initiative</i>, <a target="_blank" href='http://www.opensource…
  17. L Torvalds, Free Minix-Like Kernel Sources for 386-AT, October 5, 1991, <a target="_blank" href='http://group…
  18. Open Source Initiative, <i>Home</i>, n.d. Retrieved March 28, 2007, from <a target="_blank" href='http://www.…
  19. Two Bits: The Cultural Significance of Free Software
  20. Discourse in Late Modernity: Rethinking Critical Discourse Analysis
  21. Writing Software Documentation: A Task-Oriented Approach
  22. Perspectives on Software Documentation: Inquiries and Innovations
  23. Perspectives on Software Documentation: Inquiries and Innovations
  24. Technical Communication Quarterly
  25. Perspectives on Software Documentation: Inquiries and Innovations
  26. Perspectives on Software Documentation: Inquiries and Innovations
  27. Online Support Systems
    ACM Computing Surveys  
  28. Technical Communication Quarterly
  29. IEEE Transactions on Professional Communication
  30. IEEE Transactions on Professional Communication
  31. Using an Access-Centered Design to Improve Accessibility: A Primer for Technical Communicators
    Technical Communication
  32. Conducting Usability Studies with Users Who are Elderly or Have Disabilities
    Technical Communication
  33. IEEE Transactions on Professional Communication
  34. Technical Communication Quarterly
  35. Journal of Business and Technical Communication
  36. Journal of Business and Technical Communication
  37. Journal of Business and Technical Communication
  38. Critical Power Tools
  39. Technology and the Politics of Knowledge
  40. Computers and Composition
  41. The Politics of the Interface: Power and its Exercise in Electronic Contact Zones
    College Composition and Communication  
  42. Perspectives on Software Documentation: Inquiries and Innovations
  43. Linux Documentation Project, The Linux Documentation Project Manifesto, 2008. Retrieved January 15, 2011, fro…
  44. GNU, <i>GNU Free Documentation License</i>, 2008. Retrieved February 15, 2011, from <a target="_blank" href='…
  45. FLOSS Manuals Group, <i>Firefox Manual</i>, 2009. Retrieved February 15, 2011, from <a target="_blank" href='…
  46. Mozilla, <i>What Is Mozilla?</i> n.d. Retrieved February 15, 2011, from <a target="_blank" href='http://www.m…
  47. Handbook of Research on Open Source Software
  48. Runaway World: How Globalization is Reshaping our Lives
  49. Globalization
  50. Strategic Culture as Context: The First Generation of Theory Strikes Back
    Review of International Studies  
  51. Spurious Coin: A History of Science, Management, and Technical Writing
  52. Journal of Business and Technical Communication
  53. American Hegemony in the Packaged Software Trade and the "Culture of Software,"
    The Information Society  
  54. From Counterculture to Cyberculture: Stewart Brand, the Whole Earth Network, and the Rise…
  55. D. McBride, Open letter on copyrights, December 4, 2003. Retrieved from <a target="_blank" href='http://www.c…
  56. A War of Words in the Discourse of Trade
  57. L. Torvalds, GPL is No Hippie Dream. Retrieved December 8, 2003 from <a target="_blank" href='http://www.info…
  58. E. Moglen, Speech for Harvard Journal of Law & Technology, February 3, 2004. Retrieved from <a target="_blank…
  59. The Freedom Agenda: Why America Must Spread Democracy (Just Not the Way George Bush Did)
  60. Speaking Matters: Liberation Theology, Rhetorical Performance, and Social Action
    College Composition and Communication  
  61. The Church's Contribution to Citizenship in Brazil
    Journal of International Affairs
  62. Associated Press, Brazil Gives Nod to Open Source, November 16, 2003. Retrieved from <a target="_blank" href=…
  63. M. Cardoso, How Do You Say, ‘Bye, Microsoft,’ in Brazil? Brazzil, April, 2004. Retrieved from <a target="_bla…
  64. L. I. L. da Silva, International Free Software Forum 10 Speech, 2009. Retrieved from <a target="_blank" href=…
  65. The Prospects for Democracy in China
    Foreign Affairs
  66. People's Republic of China, <i>Constitution of the People's Republic of China</i>, 2004. Retrieved from <a ta…
  67. The China Fantasy: Why Capitalism Will Not Bring Democracy to China
  68. Capitalism Without Democracy: The Private Sector in Contemporary China
  69. China Democracy: Reconsidering the Prospects for a Democratic China
  70. China's Open Door Policy, 1978-84
    Journal of International Affairs
  71. United States, <i>Memo of Understanding between the Government of the United States of America and the Govern…
  72. Actuate, <i>4th Actuate Annual Open Survey Includes China: Attracts a Record Number of Responses</i>, June 22…
  73. S. Dean, <i>Actuate Survey: Open Source Booming in China, Germany and Other Regions</i>, June 2, 2009. Ostati…
  74. F. Muller, <i>Open Source: A Look at China's Linux and Open Source Movement</i>, February 1, 2010. Zdnet. Ret…
  75. C. N. Yang, Behind the Upsurge in Chinese Open Source Communities, November 2, 2006. Retrieved from <a target…
  76. R. Montagne and S. Inskeep, Chinese City Cracks Down on Pirated Software, December 3, 2008. Retrieved from <a…
  77. FLOSS Manuals Group, <i>Translation Tools</i>, 2009. Retrieved from <a target="_blank" href='http://en.flossm…
  78. Electronic Evolution: from Technical Communication to Knowledge Management
    Professional Communication Conference Proceedings
  79. From Wordsmith to Communication Strategist: Heresthetic and Political Maneuvering in Tech…
    Technical Communication
  80. IEEE Transactions on Professional Communication
  81. Technical Communication Quarterly
  82. Journal of Business and Technical Communication
  83. Power and Legitimacy in Technical Communication, Volume I: The Historical and Contemporar…
  84. Technical Communication Quarterly
  85. Journal of Business and Technical Communication
  86. Positioning Technical Communication for the Creative Economy
    Technical Communication
  87. Technical Communication Quarterly