GH-48782: [Docs][CI] Skip Markdown files with doxygen and trigger Docs job on PR when files are modified

.github/workflows/docs.yml

@@ -18,6 +18,11 @@
 name: Docs
 
 on:
+  pull_request:
+    paths:
+      - '.github/workflows/docs.yml'
+      - 'cpp/apidoc/**'
+      - 'docs/**'
   push:
 
 permissions:

.github/workflows/docs_light.yml

@@ -21,14 +21,15 @@ on:
   pull_request:
     paths:
       - '.dockerignore'
-      - 'docs/**'
       - '.github/workflows/docs_light.yml'
       - 'ci/docker/conda.dockerfile'
       - 'ci/docker/conda-cpp.dockerfile'
       - 'ci/docker/conda-python.dockerfile'
       - 'ci/scripts/cpp_build.sh'
       - 'ci/scripts/python_build.sh'
       - 'compose.yaml'
+      - 'cpp/apidoc/**'
+      - 'docs/**'
 
 permissions:
   contents: read

cpp/apidoc/Doxyfile

@@ -1096,7 +1096,8 @@ EXCLUDE_PATTERNS       = *-test.cc \
                          *_generated.h \
                          *-benchmark.cc \
                          *_codegen.py \
-                         *internal*
+                         *internal* \
+                         *.md
 
 # The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names
 # (namespaces, classes, functions, etc.) that should be excluded from the

cpp/src/arrow/flight/sql/odbc/README.md

@@ -26,7 +26,7 @@ After the build succeeds, the ODBC DLL will be located in
 
 2. Register your ODBC DLL:
 
-   Need to replace <path\to\repo> with actual path to repository in the commands.
+   Need to replace `<path\to\repo>` with actual path to repository in the commands.
    1. `cd to repo.`
    2. `cd <path\to\repo>`
    3. Run script to register your ODBC DLL as Apache Arrow Flight SQL ODBC Driver