Skip to main content
When a ticket turns up something your docs don’t cover, Decimal’s KB Gap Detection agent opens a pull request against your documentation repository. It reads the repo first to learn your structure and conventions, finds the right file or decides where a new one belongs, writes the content in your existing tone, and opens the PR for review. Every change arrives as a pull request. The agent never commits to your main branch.
KB Gap Detection requires a connected GitHub integration. To create real pull requests, install the GitHub Write app from Settings → Integrations. With only the standard read-only app, the agent runs in preview mode and shows proposed changes without creating PRs.

​
What the Agent Changes

The agent creates a new article when a support topic has no coverage at all, matching your repo’s format and adding the page to your navigation config so it shows up in the sidebar. When a topic is covered but thin, it edits the existing file instead, adding the missing detail without reflowing the text around it. It reads and writes .md, .mdx, .rst, and .json. Code files are out of reach.

​
How Gaps Are Found

Every resolved ticket is compared against your knowledge base. If the agent had to explain something undocumented, or found existing docs incomplete, that’s a gap. Gaps are only acted on when the analysis is confident. An uncertain read proposes nothing.

​
Triggering the Agent

Open a resolved ticket on the Support page, open the More actions menu in the ticket header, and click Analyze Gap. The agent runs in the background and opens a PR when it finishes.

​
Reviewing Pull Requests

The PR title uses a Conventional Commits prefix, such as docs: add rate limiting documentation. The body summarizes what changed, the support context that revealed the gap, and links back to the source ticket. Review the diff, comment, request changes, and merge as you would on any PR.

​
Customizing the Writing

Keep a style guide in your repository and the agent reads it before writing, so generated content follows your terminology and formatting. Email support@getdecimal.ai to point it at the right path. Without one, the agent still reads your existing files and matches what it finds: frontmatter fields, heading style, .mdx against .md, directory naming, and your navigation config, whether that’s Mintlify, Docusaurus, or Fern.

​
Safeguards

​
Connect the GitHub Write App

The standard GitHub integration is read-only, which is all code search needs. Opening pull requests takes the GitHub Write app:
  1. Go to Settings → Integrations
  2. Click GitHub Write and follow the authorization flow
  3. Select which repositories the agent can write to