terraform-docs
Generate documentation from Terraform modules in various formats
...Once you set it up and configured it, every time you or your teammates want to regenerate documentation (manually, through a pre-commit hook, or as part of a CI pipeline) all you need to do is run terraform-docs /module/path. One of the most popular format is markdown table, which is a very good fit for generating README of module. terraform-docs is available on Linux, macOS, Windows, and FreeBSD platforms. terraform-docs will locate any available configuration file without needing to explicitly pass the --config flag.