documentation.yml

name: Documentation
on: [push]

jobs:
  build-and-publish-docfx:
    runs-on: ubuntu-latest
    if: github.repository == 'freezy/VisualPinball.Engine' && github.ref == 'refs/heads/master' 
    name: Build and publish documentation
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-dotnet@v4
        name: Setup .NET SDK
        with:
          dotnet-version: 8.0.x

      - name: Install DocFX
        run: dotnet tool install --global docfx --version 2.78.5

      - name: Build Documentation
        run: docfx VisualPinball.Unity/Documentation~/docfx.json

      # Publish generated site using GitHub Pages
      - uses: maxheld83/ghpages@master
        name: Publish Documentation on GitHub Pages
        env:
          BUILD_DIR: VisualPinball.Unity/Documentation~/_site # docfx's default output directory is _site
          GH_PAT: ${{ secrets.GH_PAT }} # See https://github.com/maxheld83/ghpages