- Task
- Taking the notion of reciprocal relationships between communication needs, invention, and practices as a scaffold, extensively research a particular development in technologies for writing and reading and the implications it had on literacy and education.
- Solution
- To fulfill the requirements for this project, I chose to create a website that demonstrates how technical communication has evolved in response to the adoption of various technologies.
Project Site: Technical Operations Documentation
Context

Technical Operations Documentation is an active resource, developed from scratch to be referenced by software developers as they adopt the technologies and practices used to create apps.
An initial idea for this project focused on analyzing the development, use, and impact of the Hashicorp Configuration Language (HCL), as an example of the interplay between technology and “text” communication – in this case, a human-readable language spawned out of a need to standardize computer infrastructure (Hashicorp/hcl, 2025). I chose to forego this exploration in favour of work that both satisfies the project requirements and has tangible value to the software developers in my organization.
I developed this resource by planning procedures, documenting processes, authoring markdown files, creating images and graphics, building links and references, and configuring the authoring software to publish a site hosted on GitHub. This site is a clear example of situated practice, whereby the intention is to present information seekers with a mixed-media resource and have them engage with the material “by doing” (The New London Group, 2025). While this resource may appear to facilitate a constructivist approach to learning (Kalantzis & Cope, 2010), it is far more likely to be used simply as a reference for professional training (Taber, 2014), contributing to individual advances in knowledge and understanding on an as-needed basis.
One of the reasons I chose this modality is the site’s version history, a feature not typically available when producing other types of artifacts. Progress history provides insight into the artifact’s development, and as a site designed around knowledge-centered learning, it was important to me that this history be transparent (Anderson, 2008).
I have also deliberately endeavoured to adapt the way links are referenced, in an attempt to reflect the spirit of APA-style references:


Links in the “What is a CDN” admonition are coordinated with footer links to be styled in the spirit of APA (7th Ed.) references.
Footnotes consisting of all the links on a page have been added as a form of functional “reference” to not only attribute concepts to their originators, but also provide additional context and information.
This project has been challenging because adopting a new documentation platform meant learning the technology while simultaneously crafting of language and information architecture for a specific audience. Kress’ (2003) reminder that “the world told is a different world to the world shown…” also guided many of my design and modality decisions. Navigating the tension between “completeness” and “crux” involved extensive iteration, but I’m pleased with the outcome because I know it will have enduring value.
This resource brings together information about technology, created using the very tools it describes, and intended to support effective technology use; I anticipate it will contribute positively to information literacy within my organization.
References
Anderson, T. (2008). Towards a theory of online learning. In T. Anderson & F. Elloumi (Eds.), Theory and practice of online learning (pp. 45–74). Athabasca University Press.
HashiCorp. (2025). HCL (Version 2.x) [Computer software]. https://github.com/hashicorp/hcl (Original work published 2014).
Kalantzis, M., & Cope, B. (2010). The teacher as designer: Pedagogy in the new media age. E-Learning and Digital Media, 7(3), 200–222. https://doi.org/10.2304/elea.2010.7.3.200
Kress, G. (2003). The futures of literacy: Modes, logics and affordances. https://doi.org/10.4324/9780203299234-1
Taber, N. (2014). Tensions between practice and praxis in academia: Adult education, neoliberalism, professional training, and militarism. Canadian Journal for the Study of Adult Education, 26(2 SI), Article 2 SI. https://doi.org/10.56105/cjsae.v26i2
The New London Group. (2025). Reprint: A pedagogy of multiliteracies: Designing social futures. Harvard Educational Review, 95(1), 102–134. https://doi.org/10.17763/1943-5045-95.1.102





The class members with whom I had the most similar selections.









And although the interface invited me to just begin authoring, it wasn’t until I had zoomed out that I began to reflect on the structure and flow of the story. This is both powerful and liberating, because it facilitates an iterative workflow and capability that doesn’t exist for printed text. Case in point, in speaking about the “writing machine”, a reference to the word processor, Engelbart states:





