publish-docs.yml

on:
  workflow_dispatch:
    inputs:
      workspace_path:
        description: 'Path to the workspace being released.'
        required: true
        type: string
      project_file:
        description: 'Path to the project file.'
        required: true
        type: string
      test_project_file:
        description: 'Path to the test project file.  If provided, run unit tests, otherwise skip them.'
        required: false
        type: string
  workflow_call:
    inputs:
      workspace_path:
        description: 'Path to the workspace being released.'
        required: true
        type: string
      project_file:
        description: 'Path to the project file.'
        required: true
        type: string
      test_project_file:
        description: 'Path to the test project file.  If provided, run unit tests, otherwise skip them.'
        required: false
        type: string

name: Publish Docs
jobs:
  build-publish:
    runs-on: ubuntu-latest
    permissions:
      contents: write # Needed in this case to write github pages.
    steps:
      - uses: actions/checkout@v4
      - id: build
        name: Build and Test SDK
        uses: ./.github/actions/ci
        with:
          project_file: ${{ inputs.project_file }}
          test_project_file: ${{ inputs.test_project_file }}

      - id: build-docs
        name: Build Documentation
        uses: ./.github/actions/build-docs
        with:
          workspace_path: ${{ inputs.workspace_path }}

      - id: publish-docs
        name: Publish Documentation
        uses: ./.github/actions/publish-docs
        with:
          workspace_path: ${{ inputs.workspace_path }}
          token: ${{secrets.GITHUB_TOKEN}}