“Applied Constructivism” for User Documentation

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.