Deploy Documentation workflow (aws/bedrock-agentcore-starter-toolkit)

name: Deploy Documentation
 
on:
  push:
    branches:
      - main
    paths:
      - 'documentation/**'
      - '.github/workflows/deploy-docs.yml'
  workflow_dispatch:  # Allows manual triggering
 
permissions:
  contents: write
  pages: write
  id-token: write
 
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true
 
jobs:
  deploy:
    timeout-minutes: 30
    runs-on: latchkey-small
    steps:
      - uses: actions/checkout@v5
        with:
          fetch-depth: 0  # Fetch all history for proper versioning
 
      - name: Checkout SDK repository
        uses: actions/checkout@v5
        with:
          repository: aws/bedrock-agentcore-sdk-python
          path: bedrock-agentcore-sdk-python
          fetch-depth: 1
 
      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          cache: 'pip'
          python-version: '3.10'
 
      - name: Install uv
        uses: astral-sh/setup-uv@v6
 
      - name: Create virtual environment and install dependencies
        run: |
          uv venv
          source .venv/bin/activate
          uv pip install mkdocs-material mkdocstrings-python pymdown-extensions
          uv pip install mike mkdocs-macros-plugin mkdocs-llmstxt mkdocs-include-markdown-plugin
 
          # Install the SDK package from PyPI
          uv pip install bedrock-agentcore
 
          # Install the toolkit package in development mode
          uv pip install -e .
 
      - name: Setup Git for mike versioning
        run: |
          git config --global user.name "github-actions"
          git config --global user.email "github-actions@github.com"
 
      - name: Deploy documentation
        working-directory: ./documentation
        run: |
          source ../.venv/bin/activate
          mkdocs gh-deploy --force