Skip to Content

Build OKF

Merging and conflicts

How Docklee keeps one concept per idea, and what happens when new content disagrees with what's there.

The same idea shows up in many places: a wiki page, a spec, a support article. Without care, each becomes its own concept, and they slowly drift apart. Docklee checks every new concept against the bundle, so each idea stays one concept.

How a match is found

  1. Compare titles. Titles are normalized and compared word by word.
  2. Confirm with entities. If the titles are close, Docklee checks how many entities the two concepts share.
  3. Decide. It's a match when the titles are close and at least half the entities are shared, or when the titles are nearly identical.

What happens on a match

SituationResult
A new concept matches an existing oneThe existing concept is enriched with the new facts, entities, and sources.
Several new concepts match the same existing oneThey're combined into one update.
The new facts conflict with the existing onesBoth versions are kept, the conflict is marked, and it's flagged for review.
The new concept replaces an older oneThe older concept is linked to it with supersedes, and retrieval prefers the newer one.

Guarantees

  • Nothing is lost. A merge keeps the sources from both sides, and the higher-confidence data wins.
  • Conflicts are visible. A conflict is never settled silently. Both sides stay until a person decides.
  • Decisions are recorded. Every merge is logged with what was merged, why, and with what confidence.
  • Repeatable. The same inputs always produce the same merge decisions.

Supersession in retrieval

When one concept supersedes another, retrieval drops the older concept from results. Both stay in the bundle, so the history is never lost, and an export includes both.

Next steps

Your bundle stays consistent. Ask questions of it next.

On this page