builddocsite.yml

name: Build Documentation Site

on:
  workflow_dispatch:
  schedule:
  - cron: '0 2 * * *'

permissions: read-all

jobs:
  documentation:
    runs-on: ubuntu-latest
    permissions:
      contents: write      
    steps:
      - name: Wait for actions to finish
        uses: softprops/turnstyle@v1
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
      - name: Checkout master branch
        uses: actions/checkout@v4
        with:
          ref: master
          path: master
      - name: Checkout dev branch
        uses: actions/checkout@v4
        with:
          ref: dev
          path: dev
      - name: Checkout gh-pages branch
        uses: actions/checkout@v4
        with:
          ref: gh-pages
          path: gh-pages
      - name: Setup .NET 7.0
        uses: actions/setup-dotnet@v4
        with:
          dotnet-version: 7.x
      
      - run: dotnet tool install -g docfx --version 2.72.1
      
      - name: Build docs
        shell: pwsh
        run: |
          ./dev/pages/Build-Site.ps1
      - name: Add & Commit & Push
        uses: EndBug/add-and-commit@v9
        with:
          cwd: ./gh-pages          
          push: true