notion-ci-integration

# Notion CI Integration ## Overview Automate documentation sync, deploy tracking, and configuration management by integrating the Notion API into CI/CD pipelines. This skill covers GitHub Actions workflows that push changelogs and release notes to Notion pages, update database entries on successful deploys, create pages for incident reports, and read feature flags or configuration from Notion databases — all with proper rate limit handling for CI environments. ## Prerequisites - GitHub repository with Actions enabled - Notion internal integration token (create at `https://www.notion.so/my-integrations`) - Target Notion pages/databases shared with the integration (click "..." > "Connections" > add your integration) - `NOTION_TOKEN` stored as a GitHub Actions secret - Node.js 18+ or Python 3.9+ in CI environment ## Instructions ### Step 1: GitHub Actions Workflow for Documentation Sync Push changelogs and release notes to Notion automatically on release. ```yaml # .github/workflows/notion-docs-sync.yml name: Sync Docs to Notion on: release: types: [published] push: branches: [main] paths: ['CHANGELOG.md', 'docs/**'] env: NOTION_TOKEN: ${{ secrets.NOTION_TOKEN }} jobs: sync-release-notes: runs-on: ubuntu-latest if: github.event_name == 'release' steps: - uses: actions/checkout@v4 - uses: actions/setup-node@v4 with: node-version: '20' cache: 'npm' - run: npm ci - name: Push release not...