o3de-extras/Gems/ROS2/.github/workflows/Documentation.yml

name: Documentation

on:
  push:
    branches:
      - development
    paths:
      - ".github/workflows/Documentation.yml"
      - "Code/**"
  workflow_run:
# DISCLAIMER: This trigger will only work if this workflow is located on the default branch!
    workflows: ["Documentation Configuration Changed"]
    branches:
      - "gh-pages"
    types:
      - completed

permissions:
  contents: write

jobs:
  docsgen:
    name: Generate documentation and publish it to Github Pages
    runs-on: ubuntu-latest
    steps:
      - name: Checkout gh-pages branch
        uses: actions/checkout@v3
        with:
          ref: gh-pages
      - name: Checkout development branch
        uses: actions/checkout@v3
        with:
          repository: RobotecAI/o3de-ros2-gem
          ref: development
          path: o3de-ros2-gem
      - name: Setup doxygen and graphviz
        run: |
          sudo apt update
          sudo apt install -y doxygen wget
          sudo apt install graphviz
      - name: Generate documentation
        run: doxygen Doxyfile
      - name: Remove the unused development branch folder
        run: rm -r o3de-ros2-gem
      - name: Deploy to GitHub Pages
        uses: JamesIves/[email protected]
        with:
          folder: .