All field notes

03 / Knowledge systems · 6 min read

Making internal knowledge search worth trusting

A useful answer needs more than the right paragraph. It needs a source, the right permissions, and a way to handle stale or conflicting information.

Newtonly / Field notes

01 / 04

Finding a passage is not the whole job

A company can have excellent documents and still make people hunt through folders, messages, and old tickets to answer a simple question. Retrieval can shorten that search, but an answer without provenance just creates a new place for confusion to live.

The interface should show exactly where an answer came from and make it easy to open the underlying source. When several documents disagree, the system should surface the conflict rather than quietly choosing the most persuasive wording.

02 / 04

Respect access at the moment of retrieval

Search results must follow the same permissions as the underlying documents. It is not enough to retrieve everything and hide sensitive passages at the end. Access has to be enforced before a passage reaches the answer-generating step.

That usually means keeping document ownership, visibility, and updates in sync with the source system. Permissions are not a cosmetic layer on top of a search index; they are part of its design.

03 / 04

Treat freshness as a product decision

What happens when a policy changes on Monday but the index still holds Friday's version? Give documents clear update rules, show their dates when useful, and decide which collections need frequent refreshes. If a source is missing or stale, say so.

The content owners should also have a way to correct or retire material. A knowledge system is only as trustworthy as the maintenance process behind it.

04 / 04

Test with questions people actually ask

Build an evaluation set from real questions, including vague ones, multi-part ones, and those with no answer in the available material. Check whether the right source was retrieved, whether the answer is supported, and whether the system abstains when it should.

A successful rollout starts with a collection whose owners care about its quality. Prove that people can find better answers there, then add more material deliberately instead of indexing every file at once.