#13457
Concrete Methods that Promote Active Learning in Software Manuals 
To learn software, passive users prefer to have concepts and procedures clearly spelled out for them, while active learners prefer experimenting with the program. When designing a manual, writers should keep both types of users in mind. Writers at WordPerfect are currently experimenting with minimalist design models that encourage active learning. One such model is an “On Your Own” section which guides users through creating a document. Another model is a visually oriented “Applications” section which provides tips on how to create a document.
Bringhurst, Robert G. STC Proceedings (1993). Presentations>Writing>Documentation
#25045
Using Audience Analysis to Make Design Decisions for Computer Documentation
Software documentation writers frequently fail to consider the broad range of their users, limiting themselves to overly simple audience breakdowns such as novice, intermediate, and expert. Before writing, technical writers should analyze their audience based on considerations such as the users’ physical environment, learning preferences, skill levels, objectives, and computer systems. Once this audience information is obtained, writers should create design models that accommodate as many of these users as possible.
Bringhurst, Robert G. STC Proceedings (1994). Articles>Documentation>Audience Analysis
