WORKING-DOCUMENTS — Make a document answer one use
- Situation: A document is requested, but its label does not reveal the use it must support.
- Question: Do you need to check one view, reuse related views, show the same subject differently, see enough structure, compare named sources, or use an architecture description in a decision?
- First useful result or blocker: A checked view, a reusable viewing approach, another presentation of the subject, an account of sufficient or missing structure, a source comparison, the architecture-description result needed now, or the specific obstacle to obtaining it.
- Mantra: Name who will use the document and what it must support. Check one view; prepare recurring views; show the subject another way; expose enough structure; compare sources; or use a description in architecture work. Keep document, subject, decision, and performed Work distinct. Stop when the needed result exists; return when its use or content changes.
- Start with:
E.17.0for checking one view against its viewpoint;E.17.1/E.17.2for recurring use;A.6.3.RTfor representation change;C.33for structural information;E.17.ID.CRfor source comparison;C.30.ADfor architecture-description use; otherwise use the direct pattern for the document result. - Stop or return: Stop when that result answers the use. One file may carry several results without merging them.