WHEN CALLED
A system is understood by the people who built it and by almost no one else, while the decision to fund, adopt or approve it sits with those others.
WHAT WE DECIDE
What has to be understood first and what can be left out. Which claims the audience will test, and what evidence must be visible at the moment they test it. What may not be simplified.
WHAT REMAINS
Technical narrative structure · figure and diagram conventions · briefing and exhibition systems · moving-image sequences · terminology consistent with the system's own documentation
PROBLEM TYPES
REQUESTABLE AS
- — Technical narrative for an audience outside the development organization
- — Exhibition or conference presentation system for a system under development
- — Moving-image sequence explaining an operating concept
- — Figure and diagram conventions for a document set