“Applied Constructivism” for User Documentation

Journal of Business and Technical Communication Jan 1998

“Applied Constructivism” for User Documentation

BARBARA MIREL

Abstract

This inquiry explores the practical implications of constructivist theory for documentation that is targeted to complex tasks and experienced users (users who are less than experts but more than novices). It argues that current task-oriented documentation falls short in addressing these tasks and users and examines the contributions that constructivism can make, contributions that will lead to documentation that differs in kind not just degree from conventional task-oriented manuals and help systems. This inquiry synthesizes the following four themes from constructivist theory and analyzes their relevance to documentation development: (1) changing the object of instruction to “activity in context,” (2) shaping instruction around problems experienced by users in work contexts, (3) highlighting users' social stock of knowledge, and (4) adopting a rhetoric of problem-based instruction expressed through cases. Examples are given from current efforts in interface and instructional design that writers may adapt to documentation design.

Journal: Journal of Business and Technical Communication
Published: 1998-01-01
DOI: 10.1177/1050651998012001002
Open Access: Closed
Topics: multimodality

Citation Context

Cited by in this index (11)

Tham (2023)

Instructional Design Pedagogy in Technical and Professional Communication

Technical Communication Quarterly
Baker (2020)

Contextual Information in Social How-To Questions That Initiate Documentation

Journal of Business and Technical Communication
Swarts (2019)

Open-Source Software in the Sciences: The Challenge of User Support

Journal of Business and Technical Communication
McNely et al. (2015)

Contemporary Research Methodologies in Technical Communication

Technical Communication Quarterly
Rivers (2011)

Future Convergences: Technical Communication Research as Cognitive Science

Technical Communication Quarterly

Show all 11 →

Spinuzzi (2011)

Losing by Expanding

Journal of Business and Technical Communication
Albers (2009)

Design for Effective Support of User Intentions in Information-Rich Interactions

Journal of Technical Writing and Communication
Wright (2008)

Implicature, Pragmatics, and Documentation: A Comparative Study

Journal of Technical Writing and Communication
Spinuzzi (2001)

Grappling with Distributed Usability: A Cultural-Historical Examination of Docu…

Journal of Technical Writing and Communication
Zachry (2001)

Constructing Usable Documentation: A Study of Communicative Practices and the E…

Journal of Technical Writing and Communication
Bushneil (1999)

A contrary view of the technical writing classroom: Notes toward future discussion

Technical Communication Quarterly

Cites in this index (3)

WITTE (1992)

Context, Text, Intertext

Written Communication
Mirel (1992)

Analyzing audiences for software manuals: A survey of instructional needs for “…

Technical Communication Quarterly
Flower (1989)

Cognition, Context, and Theory Building

College Composition and Communication

Also cites 13 works outside this index ↓

10.3102/0013189X025004005

↗
Anderson, Robert J. (1994)

10.1207/s15327051hci0902_1

Human-Computer Interactions ↗
10.1006/imms.1993.1046

↗
10.3102/0013189X020003010

↗
10.1016/S0020-7373(05)80138-5

↗
Hutchins, Edwin

Cognition in the Wild

↗
10.1016/S0020-7373(05)80129-4

↗
10.1145/223248.223258

↗
10.1006/ijhc.1996.0001

↗
10.1145/223248.223263

↗
10.1177/0893318988002002004

↗
Vygotsky, Lev

Mind in Society

↗
10.1177/016224399101600108

↗

CrossRef global citation count: 42 View in citation network →