terraform-docs

Bot releases are visible (Hide)

terraform-docs - v0.17.0 Latest Release

Published by tf-docs-bot 10 months ago

Changelog

Features

38a327a Add fish shell completion
e72f215 Always convert CRLF to LF for output description
eb2e3b7 fix completion installing command
230113f Move terraform-docs bin in a folder already in the Linux PATH
5727f8b Preserve whitespaces of provided content and template
65b37fb Update OpenSSL package to mitigate CVE-2023-5363

Bug Fixes

4132916 Fix CI linting
3467aa9 Fix faulty license headers
b4d62c8 Fix spelling
a375aa7 fix spaces
9449cf8 fix typo

Chores

4eb50ae Bump alpine to 3.14.2
c51e1ac Bump alpine to 3.16.0
e5abff0 Bump alpine to 3.18.5
6f4b4d8 Bump golang to 1.17.6
8423fc0 Bump golang to 1.18.10
61f0423 Bump golang to 1.18.3
47bb0d2 Bump golang to 1.21.5
f093753 Bump golangci-lint to 1.47.2 and fix issues
5cfb2f2 Bump golangci-lint to 1.55.2 and fix issues
9fa02e7 Bump staticcheck to 2023.1.6
b37d2dc Bump version to v0.17.0-alpha
a74d0f4 Bump version to v1.0.0-alpha
a89c52e Enhance release script
ac2f987 Update actions/checkout to v3
040b27b Update actions/setup-go to v3
5fad7ab Update go dependencies
649f1c4 Update go module dependencies
4552242 Update go module dependencies
82eaf8b Update goreleaser/goreleaser-actiona to v3
89666c0 Update container to Alpine 3.18.2 and Go 1.18.10
5638b29 Update Alpine base image to 3.16.1
21a9745 Upgrade Google Cloud Go packages in go.sum
bb12a12 Remove Scalr sponsorship
090efce Run make fmt

Docker images

docker pull quay.io/terraform-docs/terraform-docs:latest
docker pull quay.io/terraform-docs/terraform-docs:0.17.0

Contributors

Very special thanks to the contributors.

@Aurelian-Shuttleworth
@blakegong
@EppO
@FlorentPoinsaut
@khos2ow
@levinotik
@tbriot
@x4e-jonas
@yutaro1985

terraform-docs - v0.16.0

Published by tf-docs-bot about 3 years ago

Notable Updates

Changelog

Features

f613750 Add 'HideEmpy' section bool flag
6f97f67 Add abitlity to partially override config from submodules
de684ce Add public ReadConfig function
54dc0f5 Add recursive config to .terraform-docs.yml file
89648f7 Add sprig functions to built-in template functions
f3c9238 Extract leading comments for resources and modules
045707b feat: Add new flag 'read-comments' to optionally process comments as description

Bug Fixes

5a1210b Skip read lines from empty file

Refactoring

465dd14 Make terraform.Module available in content
90942f7 Move format package from internal to public
4a9ffe7 Move plugin-sdk to in-tree in core repository
d2fe2b1 Move print package from internal to public
b3ff514 Move template package from internal to public
ca8f833 Move template package from internal to public

Chores

f33826c Cleanup documentations
bb10971 Deprecate Settings and Options in favor of Config
3d2b878 Overhaul README and docs improvements
1ae5fd9 Restructure configurations docs
0ad14a3 Restructure how-tos docs
628f2c6 Update Netlify config and build CI

Docker images

docker pull quay.io/terraform-docs/terraform-docs:latest
docker pull quay.io/terraform-docs/terraform-docs:0.16.0

Contributors

Very special thanks to the contributors.

@bcdady
@khos2ow
@katsadim
@poojitha-bikki
@u5surf

terraform-docs - v0.15.0

Published by tf-docs-bot about 3 years ago

Notable Updates

The most notable changes in this release are:

Generate submodules documents with --recursive flag

Considering the file structure below of main module and its submodules, now it is possible to generate documentation for them main and all its submodules in one execution.

Note that generating documentation recursively is allowed only with --output-file set.

Path to find submodules can be configured with --recursive-path (defaults to modules).

Each submodule can also have their own .terraform-docs.yml config file, to override configuration from root module.
```
.
├── README.md
├── main.tf
├── modules
│   └── my-sub-module
│       ├── README.md
│       ├── main.tf
│       ├── variables.tf
│       └── versions.tf
├── outputs.tf
├── variables.tf
└── versions.tf
```
Ignore extracting versions from terraform.lock.hcl

New flag, --lockfile, is added to control whether ignore reading .terraform.lock.hcl file in an attempt to extract the exact version of provider being used or not. Default is true.

If set to true, exact version of provider available in lock file at the time of execution will be extracted. If set to false, the version in .tf file will be used (either exact, or a constrained version: >=, ~>, ...)
The updated order of trying to look up for .terraform-docs.yml config file, now, is:
1. root of module directory
2. .config/ folder at root of module directory
3. current directory
4. .config/ folder at current directory
5. $HOME/.tfdocs.d/
add output-check option for outputs

This option can be used to compare content of target file with generated output by terraform-doc and fail if different.
Remove --show-all, --hide-all, and --sort-by-XXX flags. (which have been deprecated in v0.13.0)

Changelog

Features

d77324c Add new '--show all' and '--hide all' sections
d004771 Add support for generating Packer document
f46a48b Attempt looking up config file in .config folder
1450ee9 Generate submodules documents with '--recursive' flag
5256426 Ignore extracting versions from terraform.lock.hcl
25f03b4 Remove deprecated '--show-all' and '--hide-all' flags
258f460 Remove deprecated '--sort-by-XXX' flags
21eaab4 add output-check option for outputs

Bug Fixes

ab05309 Process \n as line break in --output-template flag
c14edaf Properly format indented code blocks
61cc005 Render resources without URL correctly in Markdown and Asciidoc

Chores

8a288b5 Add Scalr sponsorship
af68ca2 Add new example for MacOs Install docs
77bc780 Bump alpine to 3.14.0
dfd1256 Bump golang to 1.16.6-alpine
bb1e21a Cosmetic cleanup asciidoc module table
490644e Increase test coverage for Config
209ed66 Upgrade go dependencies
567cfcc updating how-to doc for correct Include Examples syntax

Docker images

docker pull quay.io/terraform-docs/terraform-docs:latest
docker pull quay.io/terraform-docs/terraform-docs:0.15.0

Contributors

Very special thanks to the contributors.

@Damans227
@frugecn
@jeanbaptistebeck
@khos2ow
@rickhlx

terraform-docs - v0.14.1

Published by tf-docs-bot over 3 years ago

Changelog

This is a small patch over v0.14.0. It fixes base template not found error on Windows. You can ignore updating to this version if you are not running terraform-docs on Windows.

Bug Fixes

30b429d Fix base template not found on Windows

Docker images

docker pull quay.io/terraform-docs/terraform-docs:latest
docker pull quay.io/terraform-docs/terraform-docs:0.14.1

terraform-docs - v0.14.0

Published by tf-docs-bot over 3 years ago

Notable Updates

The most notable changes in this release are:

Generated content can be customized further away with content in configuration. If the content is empty the default orders of section is used. content is a Go template with following additional variables:
- {{ .Header }}
- {{ .Footer }}
- {{ .Inputs }}
- {{ .Modules }}
- {{ .Outputs }}
- {{ .Providers }}
- {{ .Requirements }}
- {{ .Resources }}
```
content: |-
  Any arbitrary text can be placed anywhere in the content

  {{ .Header }}

  and even in between sections

  {{ .Providers }}

  and they don't even need to be in the default order

  {{ .Outputs }}

  {{ .Inputs }}
```
These variables are the generated output of individual sections in the selected formatter. For example {{ .Inputs }} is Markdown Table representation of inputs when formatter is set to markdown table and AsciiDoc Document representation when formatter is set to asciidoc document and so on.

Compatible formats for customized content are:
- asciidoc document
- asciidoc table
- markdown document
- markdown table
Local relative files can be included automatically in the generated content with `{{ include "..." }} function. This can be very useful for:
- inject arbitrary markdown files in between sections
- automatically include example usage
```
content: |-
  include any relative files

  {{ include "relative/path/to/file" }}

  or examples

  ```hcl
  {{ include "examples/foo/main.tf" }}
  ```
```
Add --html bool flag and config to Markdown to control the generated HTML tags inside markdown output. If set to false no html tags (e.g. <br>, <pre>) will be generated. And as a workaround the multi-line codeblock will be converted to single line with linebreak onverted to <SPACE>.

For example:
```
{
  "bar": {
    "bar": "bar",
    "foo": "bar"
  },
  "buzz": [
    "fizz",
    "buzz"
  ],
  "fizz": []
}
```
will be converted to:
```
{ "bar": { "bar": "bar", "foo": "bar" }, "buzz": [ "fizz", "buzz" ], "fizz": [] }
```

Changelog

Features

2f088f2 Add '--html bool' flag and config to Markdown
6777364 Customize content with individual sections output
ea34bce Include relative files into generated content
57cf3db Extract provider version from .terraform.lock.hcl
0284283 Separate the module version from module source when using ?ref=

Bug Fixes

90ccb84 Add missing Resource.Mode to plugin-sdk (#493)
6820b4c Normalize version to prevent malformed error

Chores

bd32f8c Bump action-homebrew-bump-formula action to v3.8.0
7327de1 Clarify deprecated settings in the docs (#499)
d79abf0 Documentation cosmetic cleanup
2706df0 Enable CodeQL scanning
5df7ff2 Improve Makefile help message
23436be Update release scripts
7f63260 Update to go1.16.4
4397fac Validate license header on files on CI

Docker images

docker pull quay.io/terraform-docs/terraform-docs:latest
docker pull quay.io/terraform-docs/terraform-docs:0.14.0

Contributors

Very special thanks to the contributors.

@edgarsandi
@khos2ow
@lokkersp

terraform-docs - v0.13.0

Published by tf-docs-bot over 3 years ago

Notable Updates

The most notable changes in this release are:

Add support for Terraform v0.15 and configuration_aliases (thanks to @adamjohnson01)
Add ability to show or hide data-sources (thanks to @edgarsandi)

Read .terraform-docs.yml from relative path, absolute path, or $HOME (more info)

# executing from parent
$ terraform-docs -c .terraform-docs.yml module-a/

# executing from child
$ cd module-a/
$ terraform-docs -c ../.terraform-docs.yml .

# or an absolute path
$ terraform-docs -c /path/to/parent/folder/.terraform-docs.yml .

Support outputing to file for absolute path (more info)

# this works, relative path
$ terraform-docs markdown table --output-file ../docs/README.md .

# so does this, absolute path
$ terraform-docs markdown table --output-file /path/to/module/docs/README.md .

Version constraints configuration (more info)

# .terraform-docs.yml
version: ">= 0.13.0, < 1.0.0"

Breaking Changes

We're no longer distributing standalone binaries. Only compressed files (either tar.gz or zip) will be available to download from GitHub Release page.
--sort-by-XX flags are deprecated in favor of corresponding dynamic --sort-by XX. Affected flags are:
- --sort-by-required
- --sort-by-type
In return new --sort-by string is added with following values:
- name (default)
- required
- type
Note that the behavior of --sort bool was not changed and to disable sorting altogether you can run --sort false.

Note than the type of sort.by in .terraform-docs.yml has been changed from list to string
```
sort:
  enabled: true
  by: required   # this now only accepts string
```

Flags --show-all and --hide-all are deprecated in favor of explicit use of --show and --hide.

In other words when --show <section> is used, only <section> will be shown. If you want to show multiple sections and hide the rest you can specify multiple --show flags. The same logic is also applied to --hide.

# show 'inputs' and hide everything else
$ terraform-docs --show inputs <formatter>

# show 'inputs' and show 'outputs' and hide everything else
$ terraform-docs --show inputs --show outputs <formatter>

# hide 'header' and show everything else
$ terraform-docs --hide header <formatter>

# hide 'header' and hide 'providers' and show everything else
$ terraform-docs --hide header --hide providers <formatter>

Note: Using --show or --hide CLI flag will completely override the values from .terraform-docs.yml. Example:

$ cat .terraform-docs.yml
sections:
  show:
    - inputs
    - outputs

# example 1: this will only show 'providers'
$ terraform-docs --show providers .

# example 2: this will hide 'inputs' and hide 'providers' and show everything else
$ terraform-docs --hide inputs --hide providers .

Changelog

Features

c8fc7ab add ability to show or hide data-sources
d914ca7 Add a flag for showing description with hcl formatted tfvars
a26111f Add support for configuration_aliases
fcd314b Read config from relative path, absolute, or $HOME
0eea133 Support inline comments variation for Markdown and AsciiDoc
845469c Support outputing to file for absolute path
dabf54f Version constraints configuration

Bug Fixes

4be2223 In output-mode inject do not fail if file not found

Refactoring

557d53d Deprecate '--sort-by-XX' in favor of '--sort-by XX'
8c531b6 Deprecate --show-all and --hide-all flags
40f9b9d Do not distribute standalone binaries
2ea8635 Remove unused build tools from dockerfile

Documentation

b4981a1 Add 'since version' to docs for clarity
1415ac9 Add Terraform compatibility matrix documentation
6b0cf54 Add document for 'false' value for CLI flag
2784920 Update doc to indicate minimum go1.16 is needed

Docker images

docker pull quay.io/terraform-docs/terraform-docs:latest
docker pull quay.io/terraform-docs/terraform-docs:0.13.0

Contributors

Very special thanks to the contributors.

@adamjohnson01
@edgarsandi
@khos2ow
@mikiya771
@pujan14

terraform-docs - v0.12.1

Published by tf-docs-bot over 3 years ago

Changelog

This is a small patch over v0.12.0. It fixes missing footer-from from CLI and config (#449). You can ignore updating to this version if you are not using footer in your module output.

Bug Fixes

7a6f6c1 Fix missing footer-from if set via CLI flag or config
e4a3a84 print cli errors to stderr

Docker images

docker pull quay.io/terraform-docs/terraform-docs:latest
docker pull quay.io/terraform-docs/terraform-docs:0.12.1

Contributors

Very special thanks to the contributors.

@asobrien
@khos2ow

terraform-docs - v0.12.0

Published by tf-docs-bot over 3 years ago

Notable Updates

The most notable changes in this release are:

Add support for footer (thanks to @simonc-613)
Add anchors for markdown, asciidocs items (thanks to @nitrocode)
Save generated content directly into a file (mode inject and replace)
- inject: partially replace the target file with generated output
- replace: completely replace the target file with generated output
  
  The output generated by formatters (markdown, asciidoc, etc) will be inserted into a template before getting saved into the file. This template can be customized with --output-template CLI flag or corresponding item in .terraform-docs.yml config file. Its default value is:
```

{{ .Content }}

```
Remove --no-XXX flags. (in v0.10.0 --no-XXX have been deprecated in favor of their counterparts in the format of --XXX=false)

Changelog

Features

aa1e6bb Add support for footer docs
1168e12 Add support for pre-commit hooks
ac5a29c Implement module sort by position (no sort)
243fb27 add mode resource or data source to generated docs
a3bafd6 Save generated content directly into a file
8c05cb9 Add resource 'Name' to generated docs
3d39a94 Add option to hide Type and Default columns
02f490d --anchor to add anchors for markdown, asciidocs
25d2ff4 Completely remove deprecated '--no-XXX' flags

Bug Fixes

7e489d2 Do not modify header lines and trailing whitespaces
c94b43a Template should be optional for output-mode 'replace'

Refactoring

10cd6de Add DCO file
5b57ea4 Disable codecov patch status
3cc4f44 Fix issues reported by golangci-lint
8faaf9f Remove authors file and corresponding scripts
c246442 Remove changelog and corresponding scripts
0c25f7b Update golangci-lint configuration

Docker images

docker pull quay.io/terraform-docs/terraform-docs:latest
docker pull quay.io/terraform-docs/terraform-docs:0.12.0

Contributors

Very special thanks to the contributors.

@andreswebs
@edgarsandi
@khos2ow
@nitrocode
@si-c613
@tpansino

terraform-docs - v0.12.0-beta.1

Published by github-actions[bot] over 3 years ago

Notable Updates

terraform-docs v0.12.0-beta.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.12.0 is officially released.

Changelog

Features

a3bafd6 Save generated content directly into a file
8c05cb9 Add resource 'Name' to generated docs
3d39a94 Add option to hide Type and Default columns
02f490d --anchor to add anchors for markdown, asciidocs
25d2ff4 Completely remove deprecated '--no-XXX' flags

Docker images

docker pull quay.io/terraform-docs/terraform-docs:0.12.0-beta.1

terraform-docs - v0.11.2

Published by tf-docs-bot over 3 years ago

Changelog

Bug Fixes

09ab491 Fixed lexicographic sorting of resources
fef4035 Use 'latest' as resource link if not a fixed version

Docker images

docker pull quay.io/terraform-docs/terraform-docs:latest
docker pull quay.io/terraform-docs/terraform-docs:0.11.2

Contributors

Very special thanks to the contributors.

@khos2ow
@sergei-ivanov

terraform-docs - v0.11.1

Published by tf-docs-bot over 3 years ago

Changelog

Bug Fixes

e5c8df5 fixed modules section visibility set via commandline (#387)
7b6afa3 include Resource.Mode when sorting to ensure deterministic resource table rendering
fb204ca Fix release scripts for chocolatey

Docker images

docker pull quay.io/terraform-docs/terraform-docs:latest
docker pull quay.io/terraform-docs/terraform-docs:0.11.1

Contributors

Very special thanks to the contributors.

@bashims
@HeikoNeblung
@khos2ow

terraform-docs - v0.11.0

Published by tf-docs-bot over 3 years ago

Notable Updates

The most notable changes in this release are:

Add a section for Resources (thanks to @xortim)
Add a section for Modules (thanks to @HeikoNeblung)
Initial implementation for plugin development, please check out:
- https://github.com/terraform-docs/plugin-sdk
- https://github.com/terraform-docs/tfdocs-format-template
An Slack workspace: https://slack.terraform-docs.io/

Note: We've also enabled GoReleaser for the release workflow, and to be able to support all the use-cases we changed the distribution of assets from standalone binary to compressed files (tar.gz and zip). In the upcoming releases we're going to deprecate distribution of standalone binaries, please adjust any scripts accordingly.

Changelog

Features

24e7cba Update download instruction to use tar.gz
aecd044 Use goreleaser for release workflow and tasks
2575a40 added output section for modulecalls
533a82b Add section for Resources
54fc067 Add support for plugin execution
aa7224d Add Slack workspace link

Bug Fixes

4f8952b Do not escape asterisk in markdown or asciidoc
4a98297 Cleanup extra empty lines from 'pretty' output
2353afb Never escape special characters in tfvars json
63750c1 Normalize last empty line of the generated output
4cd6f59 Show correct version when brew installs it

Refactoring

cbc0987 Make Developer Certificate of Origin (DCO) a requirement
37b9faa Move internal/tfconfig out of tree
89d7f6c Move pkg/print to internal/print
e3a19ea Move pkg/tfconf to internal/terraform
446b9bc Move pkg/tmpl to internal/template

Docker images

docker pull quay.io/terraform-docs/terraform-docs:latest
docker pull quay.io/terraform-docs/terraform-docs:0.11.0

Contributors

Very special thanks to the contributors.

@HeikoNeblung
@dependabot
@khos2ow
@xortim
@winmillwill

terraform-docs - v0.10.1

Published by github-actions[bot] about 4 years ago

Changelog

This is a small patch over v0.10.0. It fixes an issue where terraform-docs crashes if provided argument is a file and not a directory.

Note: If you are a user of antonbabenko/pre-commit-terraform, you most probably are affected by this issue and need to upgrade to v0.10.1 otherwise you can continue using v0.10.0 without any issue.

Bug Fixes

Prevent segfault error if input arg is a file (#327)

terraform-docs - v0.10.0

Published by github-actions[bot] about 4 years ago

Changelog

BREAKING CHANGE

Following flags have been deprecated and will be removed in the following releases:
- Flag --no-color has been deprecated, use --color=false instead
- Flag --no-escape has been deprecated, use --escape=false instead
- Flag --no-header has been deprecated, use --hide header instead
- Flag --no-inputs has been deprecated, use --hide inputs instead
- Flag --no-outputs has been deprecated, use --hide outputs instead
- Flag --no-providers has been deprecated, use --hide providers instead
- Flag --no-requirements has been deprecated, use --hide requirements instead
- Flag --no-required has been deprecated, use --required=false instead
- Flag --no-sensitive has been deprecated, use --sensitive=false instead
- Flag --no-sort has been deprecated, use --sort=false instead
Flags --with-aggregate-type-defaults and --sort-inputs-by-required were marked as deprecated in v0.8.0 and now are removed.

Features

Add support for .terraform-docs.yml config file (#272)
Build and push docker image (#289)
Add new flags: --show, --show-all, --hide-all (#267)
Add support for TOML renderer (#197)
Add new flag to sort inputs by type (#246)
Add support for AsciiDoc renderer (#241)

Bug Fixes

Normalize variables with CRLF line ending in heredoc (#307)
Render special chars in variables' default value properly (#284)

Refactoring

Refactor cli implemention and configuration (#266)
Deprecate multiple flags in favor of new ones (#265)
Remove deprecated flags (#229)
Add factory function to return format types (#243)
Reorganize markdown format tests (#244)

Documentation

Overall improvements to documentation (#293)
Add detail about module header usage guide (#282)

Contributors

Very special thanks to the contributors.

@achaussier
@dependabot[bot]
@dependabot-preview[bot]
@swails
@jlosito
@Plouufff
@khos2ow
@rdelcampog
@ryanking
@tomoasleep

terraform-docs - v0.10.0-rc.1

Published by github-actions[bot] over 4 years ago

terraform-docs v0.10.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.10.0 is officially released.

Action Required: This release deprecates handful of flags. Please update your workflow accordingly based on the changelog.

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

terraform-docs - v0.9.1

Published by github-actions[bot] over 4 years ago

Changelog

This is a small patch over v0.9.0 fixing issues with header section when there's no main.tf file.

Bug Fixes

Don't crash when reading header if 'main.tf' not found (#235)
Make sure requirements section is sorted (#233)

terraform-docs - v0.9.0

Published by github-actions[bot] over 4 years ago

Changelog

Note A regression found in this release where if there's no main.tf file available in the module, generating any output formats fails with Error: open main.tf: no such file or directory error.
This has been fixed in v0.9.1 but as a workaround for this release you can explicitly pass --no-header flag to circumvent the issue.

Features

Add support for tfvars hcl and json commands (#226)
Allow hiding the "Sensitive" column in markdown (#223)
Add section for module requirements (#222)
Add support for fetching the module header from any file (#217)
Add support for XML renderer (#198)
Show sensitivity of the output value in rendered result (#207)
Extract and render output values from Terraform (#191)
Render formatted results with go templates (#177)
Add support for YAML renderer (#189)

Bug Fixes

Mark variables not required if default set to null (#221)
--no-header should not attempt reading main.tf file (#224)
Fix type conversion for numbers (#204)

Enhancements

Add extensive tests coverage for all the packages (#208)

Refactoring

Add Default value types for better marshalling (#196)
Introduce Format interface and expose to public pkg (#195)
Add tfconf.Options to load Module with (#193)

Documentation

Enhance automatic document generation (#227)
Add installation guide for Windows users (#218)
Put reference to usage, cli, etc. in user guide (#216)
Example git hook to keep module docs up to date (#214)
Auto generate formats document from examples (#192)

Contributors

Very special thanks to the contributors.

@aaronsteers
@gshel
@iMartyn
@JamesUoM
@julienduchesne
@khos2ow

terraform-docs - v0.8.2

Published by github-actions[bot] over 4 years ago

Changelog

This is a small patch over v0.8.1 fixing issues with header section.

Bug Fixes

Do not escape markdown table inside module header (#186)
Add double space only at the end of paragraph lines (#185)
Preserve asterisk list in header and fix escaping (#179)
Add newline between code block and trailing lines (#184)

terraform-docs - v0.8.1

Published by github-actions[bot] over 4 years ago

Changelog

This is a small patch release over v0.8.0.

Bug Fixes

Show native map and list as default value in JSON (#174)

terraform-docs - v0.8.0

Published by github-actions[bot] almost 5 years ago

Changelog

This release supports Terraform v0.12.x configuration.

BREAKING CHANGE

With Terraform 0.12 ability to generate output from file has been deprecated in favor of from folder which contains one or more .tf files.
In the JSON format response, list of "Inputs" has been renamed to inputs.
In the JSON format response, list of "Outputs" has been renamed to outputs.
In the JSON format respone, module "Comment" has been renamed to module header.
For simplicity we've decided to deprecated the old --sort-inputs-by-required flag to the simpler and more generic --sort--by-required. The deprecated flags will get removed second release from now.
As of Terraform 0.12, the default value of input variables are shown in full JSON format (if available) and --with-aggregate-type-defaults is not needed anymore. The flag is marked as soft deprecated and will get removed in the second release from now.
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.

Features

Add '--no-escape' flag to 'json' command (#147)
Add flags to not show different sections (#144)
Add '--no-color' flag to 'pretty' command (#143)
Show 'providers' information (#140)
Bump golang to latest v1.13 (#133)
Support Terraform 0.12.x configuration (#113)

Bug Fixes

Do not escape any characters of a URL (#170)
Add double space at the end of multi-lines paragraph (#169)
Show empty JSON properties, as 'null' for all types (#166)
Show all JSON properties, empty or null (#160)
Do not escape strings inside code blocks (#155)
Read leading module header from main.tf (#154)
Read leading comment lines if description is not provided (#151)
Reimplement '--no-sort' to be compatible with Terraform 0.12 configuration (#141)