# Merging and conflicts (/docs/okf/merging-and-conflicts)
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 [#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 [#what-happens-on-a-match]

| Situation | Result |
| --- | --- |
| A new concept matches an existing one | The existing concept is enriched with the new facts, entities, and sources. |
| Several new concepts match the same existing one | They're combined into one update. |
| The new facts conflict with the existing ones | Both versions are kept, the conflict is marked, and it's flagged for review. |
| The new concept replaces an older one | The older concept is linked to it with `supersedes`, and retrieval prefers the newer one. |

## Guarantees [#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 [#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 [#next-steps]

Your bundle stays consistent. Ask questions of it next.

<Cards>
  <Card title="Query OKF" href="/docs/okf/query-okf" description="Read OKF through an engine." />
  <Card title="Semantic vocabulary" href="/docs/okf/semantic-vocabulary" description="The supersedes and contradicts links." />
  <Card title="Contradictions and updates" href="/docs/memory/intelligence/contradictions-and-updates" description="The same idea, for memory." />
</Cards>
