docs.yml

name: Publish Docs

on:
  push:
    paths:
      - docs/**
      - fmtm_splitter/**
      - mkdocs.yml
    branches: [main]
  # Allow manual trigger (workflow_dispatch)
  workflow_dispatch:

jobs:
  get_cache_key:
    runs-on: ubuntu-latest
    outputs:
      cache_key: ${{ steps.set_cache_key.outputs.cache_key }}
    steps:
      - name: Set cache key
        id: set_cache_key
        run: echo "cache_key=docs-build-$(date --utc +'%Y-%m-%d_%H:%M:%S')" >> $GITHUB_OUTPUT

  build_doxygen:
    uses: hotosm/gh-workflows/.github/workflows/doxygen_build.yml@main
    needs: [get_cache_key]
    with:
      cache_paths: |
        docs/apidocs
      cache_key: ${{ needs.get_cache_key.outputs.cache_key }}

  publish_docs:
    uses: hotosm/gh-workflows/.github/workflows/mkdocs_build.yml@main
    needs:
      - get_cache_key
      - build_doxygen
    with:
      image: ghcr.io/hotosm/fmtm-splitter:ci
      cache_paths: |
        docs/apidocs
      cache_key: ${{ needs.get_cache_key.outputs.cache_key }}