publish-docs.yml

name: Publish Docs

on:
  push:
    branches:
      - main
    tags:
      - '*dev*'  # Match x.x.xxdevx style tags

permissions:
  contents: write
  pages: write
  id-token: write

concurrency:
  group: "pages"
  cancel-in-progress: true

jobs:

  # 1. MAIN BRANCH DEPLOYMENT (Production)
  publish-main:
    if: github.ref == 'refs/heads/main'
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: BEE Install and Build Docs
        run: ./ci/docs.sh

      - name: Upload GitHub Pages artifact
        uses: actions/upload-pages-artifact@v3
        with:
          path: docs/sphinx/_build/html

      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v4

  # 2. TAGGED DEV RELEASE DEPLOYMENT
  publish-dev-tag:
    if: startsWith(github.ref, 'refs/tags/') && contains(github.ref, 'dev')
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0  # Ensure tags are available

      - name: Get Tag Name
        id: tag
        run: echo "TAG_NAME=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT

      - name: Build Docs
        run: ./ci/docs.sh

      - name: Deploy versioned dev docs to subdir
        run: |
          TAG_NAME=${{ steps.tag.outputs.TAG_NAME }}

          git config --global user.name "GitHub Actions"
          git config --global user.email "actions@github.com"

          git clone --depth=1 --branch gh-pages https://x-access-token:${{ secrets.GITHUB_TOKEN }}@github.com/${{ github.repository }} gh-pages
          cd gh-pages

          mkdir -p $TAG_NAME
          rm -rf $TAG_NAME/*
          cp -r ../docs/sphinx/_build/html/* $TAG_NAME/

          touch .nojekyll
          git add .
          git commit -m "Deploy docs for $TAG_NAME"
          git push origin gh-pages