Check out Signposting in documentation by Mike Pope<[email protected]>. Here is an excerpt:
Suppose you’re on vacation and you’re driving to a place named Lisbon Falls. You see this sign, so you turn right.
After you turn, you drive for a long time, but you don’t see Lisbon Falls, and you start to doubt that you’re on the right road. How helpful would it be to see a sign that…