lens/.github/workflows/publish-docs.yml

name: Publish docs via GitHub Pages
on:
  push:
    branches:
      - master
  release:
    types:
      - published
concurrency:
  group: publish-docs
  cancel-in-progress: true
jobs:
  verify-docs:
    name: Verify docs
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [16.x]
    steps:
      - name: Set up Python 3.7
        uses: actions/setup-python@v2
        with:
          python-version: "3.x"

      - name: Checkout Release from lens
        uses: actions/checkout@v3
        with:
          fetch-depth: 0

      - name: Using Node.js ${{ matrix.node-version }}
        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.node-version }}

      - name: Generate Extensions API Reference using typedocs
        run: |
          npm install
          npm run build:docs          

      - name: Verify that the markdown is valid
        run: |
          npm run mkdocs:verify          

  build:
    name: Deploy docs
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [16.x]
    needs: verify-docs
    steps:
      - name: Set up Python 3.7
        uses: actions/setup-python@v2
        with:
          python-version: "3.x"

      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install mkdocs-material
          pip install mike          

      - name: Checkout Release from lens
        uses: actions/checkout@v3
        with:
          fetch-depth: 0

      - name: git config
        run: |
          git config --local user.email "action@github.com"
          git config --local user.name "GitHub Action"          

      - name: Using Node.js ${{ matrix.node-version }}
        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.node-version }}

      - name: Generate Extensions API Reference using typedocs
        run: |
          npm ci
          npm run build:docs          

      - name: mkdocs deploy master
        if: contains(github.ref, 'refs/heads/master')
        run: |
          mike deploy --push master          

      - name: Get the release version
        if: contains(github.ref, 'refs/tags/v') && !github.event.release.prerelease
        id: get_version
        run: echo "VERSION=${GITHUB_REF/refs\/tags\//}" >> $GITHUB_OUTPUT

      - name: mkdocs deploy new release
        if: contains(github.ref, 'refs/tags/v') && !github.event.release.prerelease
        run: |
          mike deploy --push --update-aliases ${{ steps.get_version.outputs.VERSION }} latest
          mike set-default --push ${{ steps.get_version.outputs.VERSION }}