aboutsummaryrefslogtreecommitdiff
path: root/.github/workflows/api-docs.yml
diff options
context:
space:
mode:
authorJavier López <graulopezjavier@gmail.com>2022-03-18 10:46:35 -0500
committerJavier López <graulopezjavier@gmail.com>2022-03-18 13:29:55 -0500
commit91914010252a1f5c8a3358d09c3be92f30585ee3 (patch)
tree27621423a50d0b9e0c993744c86a58cab38ad67f /.github/workflows/api-docs.yml
parent9e66d27d37d2260358783c043fdb636bf881e85f (diff)
downloadrneovim-91914010252a1f5c8a3358d09c3be92f30585ee3.tar.gz
rneovim-91914010252a1f5c8a3358d09c3be92f30585ee3.tar.bz2
rneovim-91914010252a1f5c8a3358d09c3be92f30585ee3.zip
ci(docs): add a check for PR's to commit their doc changes
Repurpose the api-docs workflow to also run in all PR's but work only as a check, if the changes in the PR introduce doc changes that are not committed fail. [skip ci]
Diffstat (limited to '.github/workflows/api-docs.yml')
-rw-r--r--.github/workflows/api-docs.yml15
1 files changed, 15 insertions, 0 deletions
diff --git a/.github/workflows/api-docs.yml b/.github/workflows/api-docs.yml
index 39d85e967d..36ac087c4a 100644
--- a/.github/workflows/api-docs.yml
+++ b/.github/workflows/api-docs.yml
@@ -1,3 +1,6 @@
+# Autogenerate the API docs on new commit to important branches
+# Also work as a check for PR's to not forget commiting their doc changes
+# called from api-docs-check.yml
name: Autogenerate API docs
on:
push:
@@ -9,6 +12,12 @@ on:
- 'master'
- 'release-[0-9]+.[0-9]+'
workflow_dispatch:
+ workflow_call:
+ inputs:
+ check_only:
+ type: boolean
+ default: false
+ required: false
jobs:
regen-api-docs:
@@ -44,6 +53,12 @@ jobs:
python3 scripts/gen_vimdoc.py
printf '::set-output name=UPDATED_DOCS::%s\n' $([ -z "$(git diff)" ]; echo $?)
+ - name: FAIL, PR has not commited doc changes
+ if: ${{ steps.docs.outputs.UPDATED_DOCS != 0 && inputs.check_only }}
+ run: |
+ echo "Job failed, run ./scripts/gen_vimdoc.py and commit your doc changes"
+ exit 1
+
- name: Automatic PR
if: ${{ steps.docs.outputs.UPDATED_DOCS != 0 }}
run: |