Terraform Docs Versions Save

terraform-docs v0.8.0-rc.3 is a pre-release. It is to help gather feedback from the community as well as give users a chance to test terraform-docs in staging environments before v0.8.0 is officially released.

This release supports Terraform v0.12.x configuration.

The official changelog will come out with the v0.8.0 release. For now, you can see the interim changelog here.

terraform-docs v0.8.0-rc.2 is a pre-release. It is to help gather feedback from the community as well as give users a chance to test terraform-docs in staging environments before v0.8.0 is officially released.

This release supports Terraform v0.12.x configuration.

The official changelog will come out with the v0.8.0 release. For now, you can see the interim changelog here.

Notes:

• There's currently one outstanding issue for rendering markdown table format (https://github.com/segmentio/terraform-docs/issues/138#issuecomment-570936597), any feedback or help on this issue is greatly appreciated.

terraform-docs v0.8.0-rc.1 is a pre-release. It is to help gather feedback from the community as well as give users a chance to test terraform-docs in staging environments before v0.8.0 is officially released.

This release supports Terraform v0.12.x configuration.

The official changelog will come out with the v0.8.0 release. For now, you can see the interim changelog here.

Notes:

• With Terraform 0.12 the information about providers being used in the module will be generated by default. This will cause the first generation of documents with the latest release of terraform-docs binary be slightly different than before, now there will be Providers section in Markdown and providers block in JSON. You can ignore this by using new --no-providers flag if you choose to.
• There's currently a known issue for rendering markdown table format (#138), please give us feedback if you happen to have any issues with that too.

Changelog

Features

• Code blocks support for all formats. Single line break support (#123)
• Add --no-escape flag for Markdown printer (#117)
• Use Cobra CLI instead of docopt (#116)
• Escape pipe character when generating Markdown (#114)
• Replace dep with Go Modules (#100)
• Replace gometalinter with golangci-lint. (#103)

Bug Fixes

• target deps was missing (required by all) (#126)
• Add support for controlling the indentation of Markdown headers (#120)
• Fix typo in options documentation (#98)

Refactoring

• Use Github Actions instead of Circle CI (#124)
• Refactor Settings for better performance (#119)
• Enhance release scripts
• Generate release note based on the current tag changelog
• Enhance Makefile and add editorconfig (#115)
• Add Changelog generation via git-chglog. (#104)

Documentation

• Update Installation and Code Completion in README
• Add 'enhancement' section to pull request template (#101)

Contributors

• @HighwayofLife
• @hmalphettes
• @khos2ow
• @metmajer
• @yutachaos

This release adds the following improvements:

Features

• Add subcommand terraform-docs md document to generate Markdown representing inputs and outputs in a document format (#81)

Bugfixes

• Fix 'authors' target in Makefile to get an author's email address, not the committer's (#90)

Miscellaneous

• Unified presentation of default values and descriptions across printer types (#96, #97)

Special thanks to @khos2ow for the hard work!

This release adds the following improvements:

Features

• Add option terraform-docs --sort-inputs-by-required to sort inputs by required, then by name.

Bugfixes

• Fix escaping of underscores for variable names in Markdown (#63).

Miscellaneous

• Add Homebrew formula (https://github.com/segmentio/terraform-docs/commit/9422d09f732a132f855cfcf3f4e6d652d3c80a6e, https://github.com/segmentio/terraform-docs/commit/86940f04bd6370993d376a4628ad8f50676c4ebb).

This release adds the following improvements:

Bugfixes

• Fix loading of comments from main.tf on Windows (#65).
• Fix needless newlines in Markdown output to resolve markdownlint warnings (#66).
• Fix support for unquoted names for Terraform inputs and outputs (#70).
• Fix Windows binary to be named terraform-docs.exe (#72).
• Fix directory structure created by make build to create bin/$OS-$ARCH/terraform-docs (#74).

This release adds the following improvements:

Features

• Add option terraform-docs --version to documentation.
• Add option terraform-docs --no-sort to omit sorting of inputs and outputs (#61).
• Add option terraform-docs --with-aggregate-type-defaults to render default value of types list and map (#53).

GitHub

• Add Contribution Guidelines in CONTRIBUTING.md.
• Add Issue and Pull Request templates in .github.

Testing

• Add static checks for errors and warnings using gometalinter.
• Refactor code to improve testability and facilitate future community contributions (#59, #60).
• Add tests to prevent against future regressions. Increase test coverage to > 90%.
• Add CircleCI configuration (#56, #58).

Miscellaneous

• Add complete Makefile.
• Add dependency management using deps.
• Add automated generation of AUTHORS using git log.

• fixed name handling to handle unquoted hcl variable names.
• fix typo
• Prefer leading comments over description for outputs to maintain compatability.
• *: add --no-required option
• doc: snakecase -> camelcase
• Add support for printing the variable 'type' in Markdown. Currently only markdown supported, but trivial to add to other outputs.
• Add support for reading description tag from output resources. Fixes #24
• Add note about installing with Homebrew
• Strip # prefix from comments
• add proper license
• auto version

• main: add support for files (@s-urbaniak)
• closes #17 Updated example in README (@nwalke)
• Closes #18 Added a very basic sort to inputs and outputs (@nwalke)
• doc: Account for single whitespace after comment character in header (@paybyphone)
• print/markdown: Better markdown description normalizations (@paybyphone)
• print/markdown: Added line break conversion for outputs (@paybyphone)
• doc: placeholder for list types (@paybyphone)
• doc: Allow top-level comments for variables when description missing (@paybyphone)
• print/markdown: Replace table cell newlines with HTML line breaks (@paybyphone)