Your docs are lying.
Find out where.
Find the Gaps reads your code and your docs side by side, and shows you everywhere they’ve drifted apart — the missing pages, the dead links, the silently wrong examples — before your customers find it first.
brew install sandgardenhq/tap/find-the-gaps
bun
Bun is a fast, all-in-one JavaScript & TypeScript runtime — a drop-in replacement for Node with a built-in package manager, test runner, and bundler.
At a glance
- 65 features identified
- 0 undocumented (user-facing)
- 61 drift findings
- 12 missing screenshots
Sections
- Runtime14
- Package manager11
- Test runner9
- Bundler8
- HTTP & WebSockets7
Drift findings
Sorted by severity. Each item links back to the line of code and the docs page it disagrees with.
-
high
Bun.serve({ tls })staleDocs show
key/certas strings — code now also acceptsBunFileandBuffer. -
high
bun install --frozen-lockfileundocumentedFlag added in v1.1.30. No mention on the install reference page.
-
med
Bun.password.hash()staleDocs example uses
algorithm: 'bcrypt'— default changed to'argon2id'. -
med
bun.lockunmappedPage describes
bun.lockb(binary). Format is now text-basedbun.lock. -
low
bun --hotstaleWatcher behavior changed for
node_modules. Docs unchanged since v1.0.x.
Missing visuals
Pages that describe a UI or output but don't show one. Each entry includes a suggested alt text and where to drop the image.
Link checkers catch broken URLs. Spell checkers catch typos. Neither can tell you that a function signature in README.md no longer matches the code — or that a new public API shipped last month without a single page describing it...
...before your customers do.
Here's what it actually does.
See every gap, instantly.
Find the Gaps reads every page of your docs and every line of your code, and points out exactly where they’ve stopped agreeing.
A report, not a mystery.
You get a plain-language report — here’s what’s missing, here’s what’s pointing at nothing, here’s what no longer matches reality. Your team picks up a list, not a mystery.
Ready-made for Doc Holiday.
The Find The Gaps report is exactly what Doc Holiday needs to get to work — filing PRs, syncing your docs, keeping them current as your code ships.
Three artifacts. One run.
An inventory of what your product actually does.
Every feature in your codebase, grouped and described in plain English — the surface area your customers can touch. New hires find it. Sales reads it. AI agents query it.
generated 2026-04-30 · grouped into 8 sections
A prioritized punch-list of doc problems.
The undocumented code, the pages pointing at things that don’t exist, and — the worst kind — the docs that look right but quietly disagree with the code. With a link to every line.
undocumented · unmapped · stale
The visuals your docs are missing.
Every place your docs describe a UI but don’t show one — with the exact alt text and insertion hint your team needs to fill it in. The boring work, pre-scoped.
each with alt text · location · caption
Find the Gaps tells you what's wrong.
Doc Holiday fixes it.
The CLI is the diagnosis: a clear, structured list of every place your docs and code have drifted apart. Doc Holiday is the treatment — it picks up that report, opens pull requests against your docs site, and keeps it from happening again.
Diagnoses the drift.
Open-source CLI. Runs in CI or on your laptop. Outputs a structured report.
- scans 13 languages
- maps features → docs
- flags drift, gaps, ghosts
Treats it, automatically.
Hosted service. Reads the report. Drafts the fixes. Files PRs against your docs.
- auto-PRs to your docs repo
- keeps docs in sync as code ships
- works with your existing CI pipeline
Two commands.
A full picture of your docs.
Drop it into your CI pipeline.
Ships as a composite GitHub Action. Run it on a schedule, before a release, or on demand — it opens a labeled tracking issue with the findings. No local install.
Ready to see what your docs are missing?
Free to install and run on any repo. Or let us show you what Doc Holiday does with the findings — automatic PRs, continuous sync, the works.
