step-security/terraform-docs

Generate Terraform module documentation in pull requests

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stale
License
None
namedescriptionrequireddefault
config-fileName of terraform-docs config file. To enable, provide the file name (e.g. `.terraform-docs.yml`)nodisabled
working-dirComma separated list of directories to generate docs for (ignored if `atlantis-file` or `find-dir` is set)no.
atlantis-fileName of Atlantis file to extract list of directories by parsing it. To enable, provide the file name (e.g. `atlantis.yaml`)nodisabled
find-dirName of root directory to extract list of directories by running `find ./find_dir -name *.tf` (ignored if `atlantis-file` is set)nodisabled
recursiveIf true it will update submodules recursivelynofalse
recursive-pathSubmodules path to recursively updatenomodules
output-formatterraform-docs format to generate content (see [all formats](https://github.com/terraform-docs/terraform-docs/blob/master/docs/FORMATS_GUIDE.md)) (ignored if `config-file` is set)nomarkdown table
output-methodMethod should be one of `replace`, `inject`, or `print`. Set as an empty string if `output.mode` and `output.file` are defined in config-filenoinject
output-fileFile in module directory where the docs should be placednoREADME.md
templateWhen provided will be used as the template if/when the `output-file` does not exist. Set as an empty string if `output.template` is defined in config-fileno<!-- BEGIN_TF_DOCS --> {{ .Content }} <!-- END_TF_DOCS -->
argsAdditional arguments to pass to the command (see [full documentation](https://github.com/terraform-docs/terraform-docs/tree/master/docs))no""
indentionIndention level of Markdown sections [1, 2, 3, 4, 5]no2
git-pushIf true it will commit and push the changesnofalse
git-push-user-nameIf empty the name of the GitHub Actions bot will be used (i.e. `github-actions[bot]`)no""
git-push-user-emailIf empty the no-reply email of the GitHub Actions bot will be used (i.e. `github-actions[bot]@users.noreply.github.com`)no""
git-commit-messageCommit messagenoterraform-docs: automated action
git-push-sign-offIf true it will sign-off commitnofalse
git-sub-dirSubdirectory that terraform code is checked out intono""
fail-on-diffFail the job if there is any diff found between the generated output and existing file (ignored if `git-push` is set)nofalse
namedescription
num_changedNumber of files changed