docs.yaml

name: Docs

on:
  push:
    branches:
    - main
    paths:
    - src/**
    - docfx/**
    - .github/workflows/docs.yml

env:
  DOTNET_VERSION: '8'           # The .NET SDK version to use

jobs:
  generate-docs:
    runs-on: windows-latest
    steps:
    - uses: actions/checkout@v3
    - name: Setup .NET Core
      uses: actions/setup-dotnet@v3
      with:
        dotnet-version: ${{ env.DOTNET_VERSION }}

    - name: Setup DocFX
      uses: crazy-max/ghaction-chocolatey@v1
      with:
        args: install docfx

    - name: DocFX Build
      run: docfx ./docfx/docfx.json
      continue-on-error: false

    - name: Upload Artifact
      uses: actions/upload-artifact@v1
      with:
        name: site
        path: docfx/_site
          
  deploy:
    concurrency: ci-${{ github.ref }}
    needs: [generate-docs]
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v3

      - name: Download Artifact
        uses: actions/download-artifact@v1
        with:
          name: site

      - name: Deploy
        uses: JamesIves/github-pages-deploy-action@v4
        with:
          folder: 'site'