buildGithubPage.yml

name: "Publish documentation"
on:
  push:
    branches:
      - "features/dka/docs"

jobs:

  check-changes-api-doc:
    name: Check for changes in api documentation
    runs-on: ubuntu-latest
    permissions: read-all
    steps:
      - uses: actions/checkout@v3
      - uses: dorny/paths-filter@v3
        id: api-doc-change
        with:
          filters: |
            src: 
              - 'api/**'

    outputs:
      changed: ${{steps.api-doc-change.outputs.changed}}

  check-changes-client-doc:
    name: Check for changes in client documentation
    runs-on: ubuntu-latest
    permissions: read-all
    steps:
      - uses: actions/checkout@v3
      - uses: dorny/paths-filter@v3
        id: client-doc-change
        with:
          filters: |
            src: 
              - 'client/**'
    outputs:
      changed: ${{steps.client-doc-change.outputs.changed}}

  publish-api-documentation:
    name: Publish api documentation
    needs: check-changes-api-doc
    if: ${{needs.api-doc-change.outputs.changed == 'true'}}
    permissions:
       id-token: "write"
       pages: "write"
    runs-on: "ubuntu-latest"
    steps:
      - id: "checkout"
        name: "Check out Git repository"
        uses: "actions/checkout@v3"

      - id: "upload-documentation"
        name: "Upload Pages artifact"
        uses: "actions/upload-pages-artifact@v2"
        with:
          path: "api/"

      - id: "deployment"
        name: "Deploy documentation to GitHub Pages"
        uses: "actions/deploy-pages@v2"

  publish-client-documentation:
    name: Publish client documentation
    needs: check-changes-client-doc
    if: ${{needs.client-doc-change.outputs.changed == 'true'}}
    permissions:
      id-token: "write"
      pages: "write"

    runs-on: "ubuntu-latest"

    steps:
      - id: "checkout"
        name: "Check out Git repository"
        uses: "actions/checkout@v3"

      - id: "upload-documentation"
        name: "Upload Pages artifact"
        uses: "actions/upload-pages-artifact@v2"
        with:
          path: "client/"

      - id: "deployment"
        name: "Deploy documentation to GitHub Pages"
        uses: "actions/deploy-pages@v2"