Abstract

This experience report shares the story of course redesign for cultivating technological and code literacy. This redesign came about as a result of listening to advisory board members as well as responding to recent scholarship calling for more specifics on the teaching of component content management and content strategy. We begin with discussion of code literacy differentiation between code-as-language, code-as-tool, and code-as-structure. We then share detail about our advisory board engagement and the resulting advanced-level technical communication course in which, framed by technological literacy narratives, students produce a static HTML site for a client, develop a repository for this work (GitHub), use XML and the DITA standard for dynamic document delivery, and create a digital experience element to accompany the site. We document and analyze student narratives and online course discussions. We emphasize a more holistic approach to code literacy and that course redesign should be a collaborative endeavor with advisory board members and industry experts. Through these experiences, students gain requisite knowledge and practice so as to enter the technical communication community of practice.

Journal
Communication Design Quarterly
Published
2019-01-22
DOI
10.1145/3309578.3309583
CompPile
Search in CompPile ↗
Open Access
OA PDF Gold
Topics
Export

Citation Context

Cited by in this index (8)

  1. Technical Communication Quarterly
  2. Communication Design Quarterly
  3. Communication Design Quarterly
  4. Reflections: A Journal of Community-Engaged Writing and Rhetoric
  5. Communication Design Quarterly
Show all 8 →
  1. Computers and Composition
  2. Computers and Composition
  3. Communication Design Quarterly

References (65) · 16 in this index

  1. Technical Communication Quarterly
  2. Journal of Business and Technical Communication
  3. Applen J.D. & McDaniel R. (2009). The rhetorical nature of XML: Constructing knowledge in networked environme…
  4. Bellamy L. Carey M. & Schlotfeldt J. (2012). Ipractices: A roadmap for writing editing and architecting in DI…
  5. Technical Communication Quarterly
Show all 65 →
  1. BBC Bitesize. (n.d.). What makes a good webpage? Retrieved from http://www.bbc.co.uk/guides/zgx3b9q BBC Bite…
  2. Benz C. (2010). What is DITA and why should you care? Retrieved from https://www.learningsolutionsmag.com/art…
  3. Betts R. (2011). Concept to code. Retrieved from http://uxmag.com/articles/concept-to-code Betts R. (2011). …
  4. Bodnik S. (n.d.). Technical writing and DITA. Retrieved from http://online-learning.com/technical-writing-dit…
  5. 10.4324/9781410600110
  6. Technical Communication Quarterly
  7. Technological literacy in the visual communication classroom: Reconciling principles and …
    Programmatic Perspectives
  8. Technical Communication Quarterly
  9. Davis D. (2011). Writing with sound. Currents in Electronic Literacy. Retrieved from https://currents.dwrl.ut…
  10. Duckett J. (2011).HTML & CSS: Design and build websites. Hoboken NJ: John Wiley & Sons. Duckett J. (2011). …
  11. Technical Communication Quarterly
  12. Emanuel B. & Martins M.A.F. (2014). Towards a rhetoric of interaction: Three case studies. Paper presented at…
  13. Structured authoring without XML: Evaluating lightweight DITA for technical communication
    Technical Communication
  14. IEEE Transactions on Professional Communication
  15. Computers and Composition
  16. Communication Design Quarterly
  17. Hackos J. (2016). Following the trends 2016: An analysis of the survey results. Retrieved from https://www.in…
  18. Hartman K. (2011). The art of wearable communication. TED Talk. Retrieved from https://www.ted.com/talks/kate…
  19. Technical Communication Quarterly
  20. International Technology Education Association. (2006). Technological literacy for all: A rationale and struc…
  21. Kapchan D. (2015). Body. In D. Novak and M. Sakakeeny (Eds.) Keywords in sound (pp.33--44). Durham NC: Duke U…
  22. Kelley K. (2017). DITA: Past present and future. University of Minnesota Digital Conservancy. https://conserv…
  23. Negotiating professional consciousness in technical communication: A community of practic…
    Technical Communication
  24. Lindgren C. (2017). Ways with data: Understanding coding as writing. University of Minnesota Digital Conserva…
  25. 10.1145/584955.584972
  26. Meyer R. (2013). What should a digital writing tool be? The Atlantic. Retrieved from https://www.theatlantic.…
  27. Intercultural connectivism: Personal learning networks in course redesign
    Rhetoric and Professional Communication and Globalization
  28. Journal of Technical Writing and Communication
  29. O'Keefe S. (2017). Structured authoring and XML. Scriptorium Publishing Services Inc. Retrieved from https://…
  30. Photinos C. (n.d.). Understanding URLs. Writing Commons. Retrieved from https://writingcommons.org/chapters/i…
  31. Computers and Composition
  32. DITA: An XML-based technical documentation authoring and publishing architecture
    Technical Communication
  33. Rajagopal K. Brinke D.J. Van Bruggen J. & Sloep P.B. (2012). Understanding personal learning networks: Their …
  34. Redish J. (2014). Letting go of the words: Writing web content that works. Waltham MA: Elsevier. Redish J. …
  35. Rettberg J.W. (2014). Seeing ourselves through technology: How we use selfies blogs and wearable devices to s…
  36. Saldana J. (2013). The coding manual for qualitative researchers (2nd ed.). Thousand Oaks CA: SAGE Publicatio…
  37. Samuels J. (2013a). Getting started with topic-based writing. Tech Whirl. Retrieved from https://techwhirl.co…
  38. Samuels J. (2013b). The three musketeers of technical content. Tech Whirl. Retrieved from https://techwhirl.c…
  39. 10.22230/src.2015v6n3a209
  40. Selber S. (2004). Multiliteracies for a digital age. Carbondale IL: Southern Illinois University Press. Selb…
  41. Self T. (2013) Separation of content and form. HYPERWRITE. Retrieved from http://www.hyperwrite.com/articles/…
  42. Sheffield J.P. (n.d.). Break down an image. Writing Commons. Retrieved from https://writingcommons.org/breaki…
  43. Shriver K. (2010). Reading on the web: Implications for online information design. Retrieved from http://vide…
  44. IEEE Transactions on Professional Communication
  45. Stedman K. (n.d.). What are new literacies? Writing Commons. Retrieved from https://writingcommons.org/what-a…
  46. Stolley K. (2008). The lo-fi manifesto. Kairos 12(3). Retrieved from http://kairos.technorhetoric.net/12.3/to…
  47. Stolley K. (2011). How to design and write web pages today. Santa Barbara CA: Greenwood. Stolley K. (2011).…
  48. Stolley K. (2016). The lo-fi manifesto v. 2.0. Kairos 20(2). Retrieved from http://kairos.technorhetoric.net/…
  49. Technical Communication Quarterly
  50. Technical writing and DITA. (n.d.). Retrieved from http://online-learning.com/technical-writing-dita/ Techni…
  51. Tham J. (2013). Graphic design for non-designers. Slideshare. Retrieved from https://www.slideshare.net/Jason…
  52. Through Glass. Reframing technical communication practices via Google Glass
    Intercom
  53. Tham J. (2016). Rhetorical web design: Thinking critically about ready-made web templates and the problem of …
  54. Technical Communication Quarterly
  55. Usability.gov. (n.d.). Information architecture basics. Retrieved from https://www.usability.gov/what-and-why…
  56. Usability.gov. (n.d.). Writing for the web. Retrieved from https://www.usability.gov/how-to-and-tools/methods…
  57. Vee A. (2017). Coding literacy: How computer programming is changing writing. Cambridge MA: The MIT Press. …
  58. Vermeulen F. (2017). Text images or video in your technical communication? TechSmith. Retrieved from https://…
  59. Wenger E. (1998). Communities of practice: Learning meaning and identity. Cambridge UK: Cambridge University …
  60. Computers and Composition