Rhetoric and composition is the academic discipline that studies writing as a situated practice shaped by audience, purpose, genre, and context. It’s the scholarly field behind the practical guidance in this vault’s style guide, plain language specification, and technical writing discipline.
The field has two historical roots. Rhetoric, originating with Aristotle’s analysis of persuasion through logos, ethos, and pathos, established audience analysis as central to effective communication [@aristotle_rhetoric]. Composition studies emerged in the 20th Century as the systematic study of how writing is taught, learned, and practiced — shifting attention from finished texts to the processes that produce them.
Key developments
The process movement
Before the 1970s, writing instruction focused on products — the finished essay, graded for correctness. Peter Elbow challenged this by introducing freewriting and arguing that meaning emerges from the act of writing, not before it [@elbow1973]. Linda Flower and John Hayes gave this empirical grounding through think-aloud protocol research, showing that composing is a recursive process — planning, translating, and reviewing interact throughout, not in sequence [@flowerhayes1981].
This research changed how writing is taught and practiced. The vault’s emphasis on revision as a substantive, recursive process — not a final polish — reflects this shift.
Rhetorical genre studies
Carolyn Miller’s “Genre as Social Action” (1984) redefined genre from a formal classification (sonnets have 14 lines) to a social one (genres are typified responses to recurring situations) [@miller1984]. This matters for technical writing because it means teaching someone to write a genre — a term definition, a lesson, a specification — requires teaching them to understand the situation it responds to, not just to follow its template.
The vault’s content types are genres in Miller’s sense: each responds to a recurring question (what does this mean? how do I learn this? how should this behave?) and stabilizes into recognizable conventions.
Clarity and style
Joseph Williams brought linguistics and cognitive science to prose style, showing that clarity follows from putting characters in subjects and actions in verbs [@williams2006]. Richard Lanham developed the Paramedic Method for revising institutional prose, naming the “Official Style” — the passive, nominalized, hedged writing that institutions reward and readers endure [@lanham2006]. George Orwell had anticipated these insights in “Politics and the English Language” (1946), arguing that unclear writing both reflects and reinforces unclear thinking [@orwell1946].
The vault’s style guide synthesizes these contributions into operational rules: prefer active voice, use specific verbs over abstract nouns, cut vague adverbs, avoid cliches.
Plain language and document design
The plain language movement — advanced by Rudolf Flesch, Janice Redish, and others — extended rhetorical principles to public communication, arguing that government, legal, and medical writing should be understandable by the people it affects [@flesch1949] [@redish2012]. Karen Schriver bridged this with document design, demonstrating empirically that visual presentation (headings, layout, whitespace) shapes comprehension as much as sentence-level prose [@schriver1997].
The vault’s plain language specification draws on this tradition.
Applied technical communication
A parallel tradition developed in industry, focused on how people actually use documentation. John Carroll’s research on minimalist documentation at IBM showed that users don’t read manuals front-to-back — they start doing things and consult documentation when stuck. Task-oriented, stripped-down materials consistently outperformed comprehensive manuals [@carroll1990]. This aligned the empirical finding with Flower’s distinction between writer-based and reader-based prose: comprehensive manuals organized by system architecture are writer-based; minimalist documentation organized by user tasks is reader-based.
Kristina Halvorson defined content strategy as the governance layer over content creation — asking not just how to write but who owns content, when it gets updated, and what gets retired [@halvorson2012]. Content strategy addresses the organizational problems that individual technical writing can’t solve: content bloat, inconsistency across channels, and missing governance.
The applied tradition shares foundations with the academic one — both draw on audience analysis, usability testing, cognitive load theory, and information architecture. The difference is emphasis: applied practitioners focus on what works in production environments with real users, tight deadlines, and organizational constraints.
Cognitive science of learning
Writing for education draws on a separate research tradition: John Sweller’s cognitive load theory showed that working memory is limited and instructional design should minimize extraneous processing [@sweller1988]. Richard Mayer’s multimedia learning principles — coherence (exclude extraneous material), segmenting (break into manageable parts), signaling (highlight essential material) — extended this to instructional writing and design [@mayer2009]. Grant Wiggins and Jay McTighe’s backward design framework — start with desired understanding, determine acceptable evidence, then plan learning experiences — shaped curriculum design [@wigginsmctighe2005]. Ralph Tyler’s objectives-first model (Tyler, 1949) and Jerome Bruner’s spiral curriculum (Bruner, 1960) provide the deeper foundations. John Biggs’s constructive alignment ensures that teaching activities and assessment target the same outcomes (Biggs & Tang, 2011).
The vault’s pedagogy module, particularly designing effective lessons and designing curricula, draws on all of these.
Contemporary directions
The developments above established the field’s core frameworks by the early 2000s. Contemporary work extends them in several directions:
Writing as situated expertise. Anne Beaufort’s research identified five knowledge domains that expert writers draw on: discourse community knowledge, subject matter knowledge, genre knowledge, rhetorical knowledge, and writing process knowledge. Her longitudinal studies showed that writing instruction fails to transfer across contexts when it focuses on generic skills rather than the situated, domain-specific nature of expertise [@beaufort2007].
Genre systems and activity theory. Charles Bazerman and David Russell extended Miller’s genre theory by integrating it with activity theory — analyzing how genres mediate institutional activity systems and how genre systems (proposal → grant decision → progress report) organize collective work [@bazerman2015] [@russell1997]. This explains not just what individual genres do but how they interact.
Writing beyond print. Kathleen Blake Yancey argued that composition must expand beyond alphabetic text to encompass digital, visual, and multimodal composing [@yancey2004]. Anne Wysocki and others extended this into practical pedagogy for multimodal writing [@wysocki2004]. Stacey Pigg’s research on distributed writing work showed how professional writing now occurs across fragmented digital environments, extending the cognitive process model to account for tool-mediated composition [@pigg2014].
Writing and disciplinarity. Paul Prior’s research on academic writing showed that disciplinary writing practices are learned through situated participation, not explicit instruction — extending genre theory and activity theory to explain how writers develop disciplinary voice [@prior2004]. This connects to the vault’s treatment of each module as a discourse community with its own conventions.
Genre theory extended. Amy Devitt developed Miller’s genre theory into a comprehensive framework, showing that genres simultaneously constrain and enable writers — and that teaching genres requires critical genre awareness (understanding what a genre does and why) rather than template reproduction [@devitt2004].
Critical and justice-oriented approaches. Asao Inoue applied critical pedagogy to writing assessment, arguing that conventional grading based on a single standard of “quality” reproduces racial and linguistic inequity [@inoue2015]. Natasha Jones extended this to technical communication, showing that documentation practices are never neutral — they carry assumptions about whose needs matter [@jones2016]. These critical approaches connect writing studies to the language and power questions that run through the vault’s pedagogy module.
Translingual approaches. Suresh Canagarajah and others argue that all communication is translingual — drawing on multiple languages, dialects, and semiotic resources — and that monolingual assumptions distort how we understand writing [@canagarajah2013]. Bruce Horner, Min-Zhan Lu, and others proposed treating language difference as a resource for meaning-making rather than an obstacle [@horneretal2011]. This challenges writing conventions (including this vault’s) that assume a single standard language.
Accessibility and universal design. Jay Timothy Dolmage’s work on academic ableism shows that writing and assessment conventions encode ableist assumptions [@dolmage2017]. Sushil Oswal connected accessibility standards (WCAG) to writing and document design practices, arguing that accessible documents are better documents for all readers [@oswal2019]. This extends document design from readability to inclusion.
Coding as literacy. Annette Vee argues that computer programming is becoming a literacy — a socially organized symbolic system — parallel to alphabetic writing, with its own rhetorical conventions and power dynamics [@vee2017].
Why this matters for the vault
This vault’s writing conventions aren’t arbitrary preferences — they’re grounded in decades of empirical research and theoretical development. When the style guide says “prefer active voice,” it’s drawing on Williams’s research showing that sentences with characters as subjects and actions as verbs are processed faster and remembered better. When the plain language spec says “test with readers,” it’s drawing on Schriver’s demonstration that writers systematically misjudge reader comprehension. When the lesson design guide says “concrete before abstract,” it’s drawing on Sweller and Mayer’s cognitive science.
Grounding the vault’s practices in their intellectual origins serves two purposes: it makes the rules intelligible (you can follow a rule better when you know why it works), and it makes them revisable (if the research changes, the rules should change too).
Sources
Foundational
- Aristotle, Rhetoric [@aristotle_rhetoric]
- George Orwell, “Politics and the English Language” [@orwell1946]
- Rudolf Flesch, The Art of Readable Writing [@flesch1949]
- Ralph Tyler, Basic Principles of Curriculum and Instruction (Tyler, 1949)
- Jerome Bruner, The Process of Education (Bruner, 1960)
- Peter Elbow, Writing Without Teachers [@elbow1973]
- Linda Flower and John Hayes, “A Cognitive Process Theory of Writing” [@flowerhayes1981]
- Carolyn Miller, “Genre as Social Action” [@miller1984]
- John Sweller, “Cognitive Load During Problem Solving” [@sweller1988]
Core references
- John Carroll, The Nurnberg Funnel [@carroll1990]
- Karen Schriver, Dynamics in Document Design [@schriver1997]
- David Russell, “Rethinking Genre in School and Society” [@russell1997]
- Grant Wiggins and Jay McTighe, Understanding by Design [@wigginsmctighe2005]
- Joseph Williams, Style: Lessons in Clarity and Grace [@williams2006]
- Richard Lanham, Revising Prose [@lanham2006]
- Anne Beaufort, College Writing and Beyond [@beaufort2007]
- Richard Mayer, Multimedia Learning [@mayer2009]
- John Biggs and Catherine Tang, Teaching for Quality Learning at University (Biggs & Tang, 2011)
- Janice Redish, Letting Go of the Words [@redish2012]
- Kristina Halvorson and Melissa Rach, Content Strategy for the Web [@halvorson2012]
Contemporary extensions
- Amy Devitt, Writing Genres [@devitt2004]
- Kathleen Blake Yancey, “Made Not Only in Words” [@yancey2004]
- Anne Wysocki et al., Writing New Media [@wysocki2004]
- Bruce Horner et al., “Language Difference in Writing: Toward a Translingual Approach” [@horneretal2011]
- Charles Bazerman, A Rhetoric of Literate Action [@bazerman2015]
- Suresh Canagarajah, Translingual Practice [@canagarajah2013]
- Stacey Pigg, “Coordinating Constant Invention” [@pigg2014]
- Paul Prior, Writing/Disciplinarity [@prior2004]
- Asao Inoue, Antiracist Writing Assessment Ecologies [@inoue2015]
- Natasha Jones, “The Technical Communicator as Advocate” [@jones2016]
- Annette Vee, Coding Literacy [@vee2017]
- Jay Timothy Dolmage, Academic Ableism [@dolmage2017]
- Sushil Oswal, Accessible ePublishing [@oswal2019]