documentation drift, prevented/live on every pull request


DocParity checks every pull request for documentation drift and drafts the fix before you merge. A deterministic engine decides which docs are affected; an LLM only writes the words. Never the other way around.

3 mapping tiers90%+ deterministic confidence0 LLM decisions

The core problem


Day 1

You write the docs

Fresh and accurate. The README is something the whole team is proud of.

Week 2

A new endpoint ships

The code goes out. The docs describing it quietly do not, and nobody notices.

Month 2

The database changes

A migration merges. The schema docs and the ER diagram still show the old shape.

Month 6

A new hire follows the docs

Nothing works. The documentation has been lying for four straight months.

README API docs architecture diagrams deployment guides environment variables the internal wiki release notes onboarding guides

Core philosophy

every other AI doc tool asks

“Generate the documentation.”

So you get more prose to maintain, more pages nobody asked for, and still no idea which of it is already wrong.

DocParity asks

So you fix the two files a change actually broke, each with a reason, before the drift ever reaches a reader.

The loop

DRIFT DIES
IN REVIEW,

not in production. Keep scrolling, it moves sideways.

01

You push

The branch is read on every commit and its status updated. Silently: no comment, ever.

02

Rules decide

Your rules, path heuristics, learned co-changes. Which docs are affected is proven, not guessed.

03

The PR opens

One comment, rewritten in place on every push. The answer was already computed.

04

An LLM drafts

Only the docs the rules flagged. It answers NO_CHANGE when nothing is stale.

05

You merge

The docs PR folds the fix into your branch, and closes itself if you write the docs first.

The receipt

feature/checkout-limits · PR #214docparity

✓ Tests · ✓ Lint · ✓ Security

⚠ Documentation drift detected· confidence 92%

Findings · deterministic

docker-compose.yml invalidates docs/deployment/added a redis service, deploy guide doesn't mention it92% · tier 1
services/billing/rates.py invalidates docs/billing/matches your doc-mapping.yml rule95% · tier 3

Suggestion · capped at 70%

MAX_ITEMS changed 20 to 50, checkout guide quotes the old limit65%
docs PR drafted · #215Review docs PR

Disagree? Comment /docparity ignore


The trust model


Overstating confidence on a guess is how doc bots die. DocParity never lets a suggestion wear a finding's badge. And when it does get one wrong, /docparity ignore closes the finding and teaches the engine to weigh that rule lower in your repo.

Tier 3 / your rules

95%

Declare path to docs mappings in .docparity.yml. Your rule beats every heuristic: deterministic accuracy for any repo layout.

Tier 1 / path heuristics

90%+

Dockerfile to deployment docs. Routes to API docs. DDL to database docs. Every hit explainable in one sentence, provable from the diff.

Tier 2 / suggestions

up to70%

Semantic matches, changed constants, learned co-changes. Honest guesses with evidence, visually distinct, never dressed up as certainty.

Who it's for


Pricing

CHEAPER THAN A
CONFUSED NEW HIRE.

Usage is metered per pull request, counted once however many times you push to it. Hit the Free tier's limit and drift detection keeps running: only the drafted fixes pause, and the bot says so rather than going quiet.