Skip to content

Commit 5747ad4

Browse files
[Github] Test docs action on workflow changes (#119627)
This patch makes the check docs build workflow run testing on all of the docs builds when the workflow is changed. This is intended to catch issues like those that were not caught premerge when adding in the functionality to download the built docs.
1 parent 7d764db commit 5747ad4

File tree

1 file changed

+35
-11
lines changed

1 file changed

+35
-11
lines changed

.github/workflows/docs.yml

+35-11
Original file line numberDiff line numberDiff line change
@@ -94,6 +94,8 @@ jobs:
9494
flang:
9595
- 'flang/docs/**'
9696
- 'flang/include/flang/Optimizer/Dialect/FIROps.td'
97+
workflow:
98+
- '.github/workflows/docs.yml'
9799
- name: Fetch LLVM sources (PR)
98100
if: ${{ github.event_name == 'pull_request' }}
99101
uses: actions/checkout@v4
@@ -115,77 +117,99 @@ jobs:
115117
- name: Setup output folder
116118
run: mkdir built-docs
117119
- name: Build LLVM docs
118-
if: steps.docs-changed-subprojects.outputs.llvm_any_changed == 'true'
120+
if: |
121+
steps.docs-changed-subprojects.outputs.llvm_any_changed == 'true' ||
122+
steps.docs-changed-subprojects.outputs.workflow_any_changed == 'true'
119123
run: |
120124
cmake -B llvm-build -GNinja -DCMAKE_BUILD_TYPE=Release -DLLVM_ENABLE_SPHINX=ON ./llvm
121125
TZ=UTC ninja -C llvm-build docs-llvm-html docs-llvm-man
122126
mkdir built-docs/llvm
123127
cp -r llvm-build/docs/* built-docs/llvm/
124128
- name: Build Clang docs
125-
if: steps.docs-changed-subprojects.outputs.clang_any_changed == 'true'
129+
if: |
130+
steps.docs-changed-subprojects.outputs.clang_any_changed == 'true' ||
131+
steps.docs-changed-subprojects.outputs.workflow_any_changed == 'true'
126132
run: |
127133
cmake -B clang-build -GNinja -DCMAKE_BUILD_TYPE=Release -DLLVM_ENABLE_PROJECTS="clang" -DLLVM_ENABLE_SPHINX=ON ./llvm
128134
TZ=UTC ninja -C clang-build docs-clang-html docs-clang-man
129135
mkdir built-docs/clang
130136
cp -r clang-build/docs/* built-docs/clang/
131137
- name: Build clang-tools-extra docs
132-
if: steps.docs-changed-subprojects.outputs.clang-tools-extra_any_changed == 'true'
138+
if: |
139+
steps.docs-changed-subprojects.outputs.clang-tools-extra_any_changed == 'true' ||
140+
steps.docs-changed-subprojects.outputs.workflow_any_changed == 'true'
133141
run: |
134142
cmake -B clang-tools-extra-build -GNinja -DCMAKE_BUILD_TYPE=Release -DLLVM_ENABLE_PROJECTS="clang;clang-tools-extra" -DLLVM_ENABLE_SPHINX=ON ./llvm
135143
TZ=UTC ninja -C clang-tools-extra-build docs-clang-tools-html docs-clang-tools-man
136144
mkdir built-docs/clang-tools-extra
137145
cp -r clang-tools-extra-build/docs/* built-docs/clang-tools-extra/
138146
- name: Build LLDB docs
139-
if: steps.docs-changed-subprojects.outputs.lldb_any_changed == 'true'
147+
if: |
148+
steps.docs-changed-subprojects.outputs.lldb_any_changed == 'true' ||
149+
steps.docs-changed-subprojects.outputs.workflow_any_changed == 'true'
140150
run: |
141151
cmake -B lldb-build -GNinja -DCMAKE_BUILD_TYPE=Release -DLLVM_ENABLE_PROJECTS="clang;lldb" -DLLVM_ENABLE_SPHINX=ON ./llvm
142152
TZ=UTC ninja -C lldb-build docs-lldb-html docs-lldb-man
143153
mkdir built-docs/lldb
144154
cp -r lldb-build/docs/* built-docs/lldb/
145155
- name: Build libunwind docs
146-
if: steps.docs-changed-subprojects.outputs.libunwind_any_changed == 'true'
156+
if: |
157+
steps.docs-changed-subprojects.outputs.libunwind_any_changed == 'true' ||
158+
steps.docs-changed-subprojects.outputs.workflow_any_changed == 'true'
147159
run: |
148160
cmake -B libunwind-build -GNinja -DCMAKE_BUILD_TYPE=Release -DLLVM_ENABLE_RUNTIMES="libunwind" -DLLVM_ENABLE_SPHINX=ON ./runtimes
149161
TZ=UTC ninja -C libunwind-build docs-libunwind-html
150162
mkdir built-docs/libunwind
151163
cp -r libunwind-build/libunwind/docs/* built-docs/libunwind
152164
- name: Build libcxx docs
153-
if: steps.docs-changed-subprojects.outputs.libcxx_any_changed == 'true'
165+
if: |
166+
steps.docs-changed-subprojects.outputs.libcxx_any_changed == 'true' ||
167+
steps.docs-changed-subprojects.outputs.workflow_any_changed == 'true'
154168
run: |
155169
cmake -B libcxx-build -GNinja -DCMAKE_BUILD_TYPE=Release -DLLVM_ENABLE_RUNTIMES="libcxxabi;libcxx;libunwind" -DLLVM_ENABLE_SPHINX=ON ./runtimes
156170
TZ=UTC ninja -C libcxx-build docs-libcxx-html
157171
mkdir built-docs/libcxx
158172
cp -r libcxx-build/libcxx/docs/* built-docs/libcxx/
159173
- name: Build libc docs
160-
if: steps.docs-changed-subprojects.outputs.libc_any_changed == 'true'
174+
if: |
175+
steps.docs-changed-subprojects.outputs.libc_any_changed == 'true' ||
176+
steps.docs-changed-subprojects.outputs.workflow_any_changed == 'true'
161177
run: |
162178
cmake -B libc-build -GNinja -DCMAKE_BUILD_TYPE=Release -DLLVM_ENABLE_RUNTIMES="libc" -DLLVM_ENABLE_SPHINX=ON ./runtimes
163179
TZ=UTC ninja -C libc-build docs-libc-html
164180
mkdir built-docs/libc
165181
cp -r libc-build/libc/docs/* built-docs/libc/
166182
- name: Build LLD docs
167-
if: steps.docs-changed-subprojects.outputs.lld_any_changed == 'true'
183+
if: |
184+
steps.docs-changed-subprojects.outputs.lld_any_changed == 'true' ||
185+
steps.docs-changed-subprojects.outputs.workflow_any_changed == 'true'
168186
run: |
169187
cmake -B lld-build -GNinja -DCMAKE_BUILD_TYPE=Release -DLLVM_ENABLE_PROJECTS="lld" -DLLVM_ENABLE_SPHINX=ON ./llvm
170188
TZ=UTC ninja -C lld-build docs-lld-html
171189
mkdir built-docs/lld
172190
cp -r lld-build/docs/* built-docs/lld/
173191
- name: Build OpenMP docs
174-
if: steps.docs-changed-subprojects.outputs.openmp_any_changed == 'true'
192+
if: |
193+
steps.docs-changed-subprojects.outputs.openmp_any_changed == 'true' ||
194+
steps.docs-changed-subprojects.outputs.workflow_any_changed == 'true'
175195
run: |
176196
cmake -B openmp-build -GNinja -DCMAKE_BUILD_TYPE=Release -DLLVM_ENABLE_PROJECTS="clang;openmp" -DLLVM_ENABLE_SPHINX=ON ./llvm
177197
TZ=UTC ninja -C openmp-build docs-openmp-html
178198
mkdir built-docs/openmp
179199
cp -r openmp-build/docs/* built-docs/openmp/
180200
- name: Build Polly docs
181-
if: steps.docs-changed-subprojects.outputs.polly_any_changed == 'true'
201+
if: |
202+
steps.docs-changed-subprojects.outputs.polly_any_changed == 'true' ||
203+
steps.docs-changed-subprojects.outputs.workflow_any_changed == 'true'
182204
run: |
183205
cmake -B polly-build -GNinja -DCMAKE_BUILD_TYPE=Release -DLLVM_ENABLE_PROJECTS="polly" -DLLVM_ENABLE_SPHINX=ON ./llvm
184206
TZ=UTC ninja -C polly-build docs-polly-html docs-polly-man
185207
mkdir built-docs/polly
186208
cp -r polly-build/docs/* built-docs/polly/
187209
- name: Build Flang docs
188-
if: steps.docs-changed-subprojects.outputs.flang_any_changed == 'true'
210+
if: |
211+
steps.docs-changed-subprojects.outputs.flang_any_changed == 'true' ||
212+
steps.docs-changed-subprojects.outputs.workflow_any_changed == 'true'
189213
run: |
190214
cmake -B flang-build -GNinja -DCMAKE_BUILD_TYPE=Release -DLLVM_ENABLE_PROJECTS="clang;mlir;flang" -DLLVM_ENABLE_SPHINX=ON ./llvm
191215
TZ=UTC ninja -C flang-build docs-flang-html

0 commit comments

Comments
 (0)