Field notes / 03

Help a reader recognize the current version.

Finding a record is only the first step. A reader also needs to know whether its information is current, what it applies to, and which reference should guide the next decision.

Give a record enough context

A familiar title may refer to several different items. A short description, stable reference, and clear status can help a reader recognize the intended record. Search results should expose the details needed to choose a result before opening several near-identical entries.

Context also includes scope. A supplier detail may apply to a particular branch or service rather than an entire organization. Make that relationship visible instead of expecting the reader to infer it from an old note.

Explain what a date represents

An edit timestamp shows that something changed. It does not necessarily mean that every part of a record was checked. A review date can be useful when there is a defined review action and a person responsible for it. Without that definition, another date can create false confidence.

Where information may become stale, explain the reason for a review and the appropriate response. Do not assume that the newest record is automatically the most reliable one.

Make replacement relationships visible

A record or document can be superseded without becoming irrelevant to the history. A retired entry should point to the current reference when one exists. The current entry may also need a short explanation of what changed and why.

Avoid relying only on filenames such as “final” or “latest.” They are easy to duplicate and difficult to maintain across systems. A deliberate relationship is more understandable than a naming convention that everyone interprets differently.

Check retrieval from the reader’s position

Ask someone to find the right information using only the clues they would normally have. They may know an old title, a partial reference, or the colleague who handled the item. Review both the search result and the information presented after opening it.

A useful improvement might be a clearer summary, an additional search field, or a visible superseded status. A more powerful search engine cannot compensate for records whose meaning and relationships remain unclear.