ansdoc action
Github Action running ansdoc
name: ansdoc
on:
# run this action only on master/main branch, so the README.md gets updated
# after every successful merge from a feature branch
push:
branches:
- 'main'
- 'master'
jobs:
ansdoc:
name: ansdoc
# required to commit the specified output file back to the branch
permissions:
contents: write
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: FalcoSuessgott/ansdoc-action@v1
with:
# file containting the ansible variables (default: defaults/main.yml)
# the file needs to contain two "<!--ansdoc -->" seperators!
vars-file: defaults/main.yml
# specifiy the output file (default: README.md)
output-file: README.md
# this step commits the output-file back to the repo. Check: https://github.com/stefanzweifel/git-auto-commit-action
- uses: stefanzweifel/git-auto-commit-action@v4
with:
commit_message: "docs(vars): update documentation generated by ansdoc"