docfx.yml

# Called by ci.yml to run documentation build
# See: https://docs.github.com/en/actions/using-workflows/reusing-workflows#creating-a-reusable-workflow
name: Build docfx

on:
  workflow_call:

permissions:
  contents: read

jobs:
  run-docfx-build:
    runs-on: windows-latest

    steps:
    - name: check out code
      uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2

    - name: Setup dotnet
      uses: actions/setup-dotnet@c2fa09f4bde5ebb9d1777cf28262a3eb3db3ced7 # v5.2.0

    - name: install docfx
      shell: pwsh
      env:
        # renovate: datasource=nuget depName=docfx
        DOCFX_VERSION: '2.78.5'
      run: dotnet tool install -g docfx --version ${env:DOCFX_VERSION}

    - name: run .\build\docfx.cmd
      shell: cmd
      run: .\build\docfx.cmd