Check out Signposting in documentation by Mike Pope<mike@mikepope.com>. 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.
![]()
[Source]
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…
The full article is available here.