B.4 Pattern: Single-Pass Readable Con’d
Solution:
- Single-Pass Readable is easier said than done, and probably merits a pattern language on its own. However, here are a variety of techniques which can be helpful to achieve single-pass readability:
- Use Evocative Pattern Names or Pattern Thumbnails in cases where some understanding of a forward referenced pattern is necessary for the reader to keep reading.
- Help the reader locate key information by using Findable Sections and Visible Forces to highlight the tradeoffs involved.
- Use Skippable Sections (such as Code Samples as Bonus) to highlight information which can be skipped on first reading.
- In a pattern language, provide a clear, concise summary of the structure of the pattern language, then remind the readers where they are within the structure as they go along, using Headings Convey Structure.
- If you need to introduce and/or define a number of concepts in the introductory sections of your pattern, try to pare down your list, and write your pattern using this reduced list.