Tag Archives: manuals

Organizing Content for Constructivist Learning [Organizing Content #28]

In my last post, I argued that rhetoric is the foundation of communication. Rhetoric is the practice of fitting the message to the context to get the results you want. In the most common scenario for technical writers and instructional designers, the rhetorical context is a learning situation. You want the user to learn new Continue Reading »

How Much Should You Document? Everything? Strategies for an Agile Environment

In a recent IT Author podcast (“Documentation and Agile Development“), Alistair Christie and Graham Campbell talk about agile development and its impact on documentation. One consequence of working in an agile environment, they say, is the need to prioritize your documentation, to deliver instructions for only the most important or confusing features. Presumably, some agile Continue Reading »