docs-release.yaml

# yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json

name: Release docs

permissions: {}

on:
  push:
    tags:
      - docs-v*

jobs:
  docs-release:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - name: Parse semver string
        id: semver 
        uses: booxmedialtd/ws-action-parse-semver@7784200024d6b3fc01253e617ec0168daf603de3 # v1.4.7
        with:
          input_string: ${{ github.ref_name }}
          version_extractor_regex: '^docs-v(.*)$'
      - name: Checkout
        if: ${{ steps.semver.outputs.prerelease == '' }}
        uses: actions/checkout@eef61447b9ff4aafe5dcd4e0bbf5d482be7e7871 # v4.2.1
      - name: Setup Go
        uses: actions/setup-go@0a12ed9d6a96ab950c8f026ed9f722fe0da7ef32 # v5.0.2
        if: ${{ steps.semver.outputs.prerelease == '' }}
        with:
          go-version-file: go.mod
          cache-dependency-path: go.sum
      - name: Build site
        if: ${{ steps.semver.outputs.prerelease == '' }}
        run: |
          set -e
          make codegen-mkdocs
      - name: Deploy site
        if: ${{ steps.semver.outputs.prerelease == '' }}
        run: |
          set -e
          git fetch origin gh-pages --depth=1
          git config user.name ci-bot
          git config user.email ci-bot@example.com
          mike deploy -F ./website/mkdocs.yaml --push --update-aliases ${{ steps.semver.outputs.fullversion }} latest