test gh action

Author: jolly-chen

.github/workflows/root-docs.yml

@@ -2,8 +2,32 @@
 name: 'Generate Doxygen Documentation'
 
 on:
-  # TODO: incremental on pull request
+  # https://github.com/root-project/root/pull/12112#issuecomment-1411004278
+  pull_request:
+    branches:
+      - '**'
+    paths-ignore:
+      - 'doc/**'
+      - 'documentation/**'
+
   push:
+    # branches:
+    #   - 'master'
+    #   - 'v*-*-*-patches'
+
+  # Allows nightly builds to trigger one run for each branch easily, by
+  # providing the relevant branch as "default" value here:
+  workflow_call:
+    inputs:
+      head_ref:
+        type: string
+        default: master
+      base_ref:
+        type: string
+        default: master
+      ref_name:
+        type: string
+        default: master
 
   workflow_dispatch:
     inputs:
@@ -44,6 +68,9 @@ jobs:
       - linux
       - x64
 
+    permissions:
+      contents: read
+
     container:
       image: registry.cern.ch/root-ci/alma9:buildready # ALSO UPDATE BELOW!
       options: '--security-opt label=disable --rm' # ALSO UPDATE BELOW!