Skip to content

docs: update GitHub integration for Projects v2 + gh CLI auth#14

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/e1e3e247
Open

docs: update GitHub integration for Projects v2 + gh CLI auth#14
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/e1e3e247

Conversation

@mintlify

@mintlify mintlify Bot commented Jun 9, 2026

Copy link
Copy Markdown

Summary

Rework the GitHub integration docs around the new Projects v2 GraphQL ingest, gh CLI-based token flow, and the GITHUB_PROJECT_IDS env var.

Changes

  • guides/github-linear.mdx — lead the GitHub tab with the gh CLI flow + interactive project picker; add a PAT fallback path with the corrected repo, read:org, read:project scopes; document Project Status → status_category mapping; replace all GITHUB_ORG/GITHUB_REPOS content with GITHUB_PROJECT_IDS setup, verification, and troubleshooting.
  • reference/environment-variables.mdx — replace the GITHUB_ORG / GITHUB_REPOS rows with GITHUB_PROJECT_IDS, update the GITHUB_TOKEN scope list, and refresh the minimal example.
  • configuration.mdx — mirror the same env var changes in the configuration overview table.

Context

Tracks Meridiona/meridian#198, which swaps the Issues Search REST API for Projects v2 GraphQL, removes GITHUB_ORG/GITHUB_REPOS in favour of GITHUB_PROJECT_IDS, and adds a gh-based setup path so a PAT is no longer required.

@mintlify

mintlify Bot commented Jun 9, 2026

Copy link
Copy Markdown
Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
meridiona 🟢 Ready View Preview Jun 9, 2026, 7:14 AM

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants