build-documentation.yml

name: Build Documentation

on:
  repository_dispatch:
  push:
    branches:
      - main

permissions: 
  contents: write
    
jobs:
  generate-docs:
    # runs-on: windows-latest
    runs-on: ubuntu-latest

    steps:
      - name: Checkout
        uses: actions/checkout@v2


      # - name: Setup .NET Core
      #   uses: actions/setup-dotnet@v1
      #   with:
      #     dotnet-version: 3.1.101

      - name: Dotnet Setup
        uses: actions/setup-dotnet@v3
        with:
          dotnet-version: 7.x


      # - name: Setup DocFX
      #   uses: crazy-max/ghaction-chocolatey@v1
      #   with:
      #     args: install docfx
      # - name: Install dependencies
      #   run: dotnet restore

      - name: Setup DocFX
        run: dotnet tool update -g docfx


      # - name: DocFX Build
      #   working-directory: Documentation
      #   run: docfx docfx.json

      - name: DocFX Build 
        run: docfx Documentation/docfx.json


      - name: Publish
        uses: peaceiris/actions-gh-pages@v3
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          publish_dir: Documentation/_site