User Confidence and Topic-Based Writing

Recently, I suggested that the move to topic based documentation should be understood as a move away from the textbook model of documentation towards a user assistance model. This move reflects a change in priorities, putting more emphasis on readers who want to learn and less on those who want to be taught.

But can we justify this change in priorities? Can we be confident that the majority of our readers actually do prefer to learn by doing rather than by being taught. If we believe John Carroll’s minimalism studies, we certainly should incline in that direction, but we also have to recognize that sometimes some readers will still want to be taught, rather than learn by doing. The question is, can we make reasonable assumptions about what proportion of our particular user community falls into each camp? read more