• Create BookmarkCreate Bookmark
  • Create Note or TagCreate Note or Tag
  • PrintPrint
Share this Page URL
Help

Chapter 6. Concreteness > Use focused, realistic, accurate, up-to-date examples

Use focused, realistic, accurate, up-to-date examples

To make examples serve their purpose forcefully, writers sometimes simplify examples. Removing extraneous parts from an example helps users focus on the point of the example. The first part of this guideline is similar to the clarity guideline “Focus on the meaning” on page 105. In the original passage that was improved for that guideline, the example contained more information than was needed to make the point about the usefulness of digital images in a security system.

Writers seldom have real examples, especially code examples, and permission to use them. Realistic (rather than real) examples are one possibility for filling the need for examples. If you are dealing with a complex system, choose examples that show increasing levels of complexity rather than trying to show too much all at once.


PREVIEW

                                                                          

Not a subscriber?

Start A Free Trial


  
  • Creative Edge
  • Create BookmarkCreate Bookmark
  • Create Note or TagCreate Note or Tag
  • PrintPrint