GitHub Discussions

Overview

Connecting GitHub Discussions to GitBook surfaces user-reported bugs, questions, and feature requests directly inside your docs site. Once connected, issue data can power GitBook Assistant — so visitors get answers informed by real support context — and optionally trigger change requests when patterns in closed issues point to documentation gaps.

How it works

GitBook syncs records from your selected GitHub repositories. Those records can be exposed in AI Search and GitBook Assistant, letting your docs site answer questions using issue history alongside your written documentation. You can also enable auto-generate change requests to let GitBook analyze closed issues and propose documentation updates for your team to review.

Configure

1. Connect GitHub Discussions — Open your site's Settings → Connections, select GitHub Discussions, and authorize GitBook to access your repositories.

2. Choose repositories — Select which repositories to sync. GitBook will start importing issues as records.

3. Configure connection settings — Choose how the records are used:

   • Expose in search / assistant — Makes issue records available to GitBook Assistant and AI Search. Note: this makes content accessible to anyone who can view your site.

   • Auto-generate change requests — Lets GitBook analyze issues and open suggested documentation updates for your team to review. (Currently in early access.)

4. Adjust search ranking — Optionally boost or deprioritize GitHub Discussion records relative to your primary docs content.