Skip to main content

Documentation drift detection

Catch documentation drift before the wiki goes quiet

Code merges without doc updates create drift. Moxie re-checks on every merge, flags gaps, and packages fixes into one weekly reviewable PR.

Quick Answer: To stop docs from going stale on GitHub merges, Moxie Docs automatically re-indexes your repository every time a pull request merges, compares the new code against existing documentation, and flags the drift. It then batches the fixes into a single reviewable docs-only Friday Cleanup PR, so your docs are corrected on the same cadence as your code without anyone rewriting them by hand.
  • On every merge. Drift is caught while the change is still fresh.
  • Visible gaps. Missing or stale pages show up in the workspace.
  • Human review. Cleanup PRs are drafts - your team merges.

What you get

Drift on merge

Live code paths compared to the docs that describe them.

Gap detection

See what is undocumented before onboarding or agents hit it.

Friday Cleanup

One scoped docs PR per week - review and merge when ready.

Search still works

Jump from the index to source citations even when a page is stale.

How it works

  1. 01

    Connect GitHub

    Install the app on the repos you want watched.

  2. 02

    First index

    Baseline docs and conventions from source.

  3. 03

    Ship as usual

    Every merge re-checks. Gaps accumulate in the workspace.

  4. 04

    Friday Cleanup

    Approve or edit the weekly docs PR.

FAQ