ENHANCEMENTS:
- schemamd: Nested attributes are now correctly grouped in "optional", "required" and "read-only" (#163).
BUG FIXES:
- template functions:
title
now capitalizes each word in the input string, instead of upper-casing them (#165).
BUG FIXES:
- template data: A regression was introduced in #155 making template data field
HasExample
andHasImport
always true (#162).
NEW FEATURES:
- template functions: Added
lower
,upper
andtitle
(#162).
ENHANCEMENTS:
- Added documentation for all the template functions and template data fields (#162).
NEW FEATURES:
- cmd/tfplugindocs: Additional CLI argument
ignore-deprecated
allows to skip deprecated resources and data-sources when generating docs (#154).
BUG FIXES:
- cmd/tfplugindocs: Pass through filepaths for
examples
andimport
to allow use ofHasExample
andHasImport
template helpers in custom templates (#155). - cmd/tfplugindocs: Fixed issue with the generation of title and reference links, when nested attributes go too deep (#56).
BUG FIXES:
- cmd/tfplugindocs: Do not error when schema not found, issue log warning (#151).
BUG FIXES:
- cmd/tfplugindocs: Allow single word resources to use templates (#147).
- cmd/tfplugindocs: Pass in correct provider name for data-source and resource schema lookup when overidden with
rendered-provider-name
flag (#148).
ENHANCEMENTS:
- cmd/tfplugindocs: Expose
RenderedProviderName
to templates (#149).
NEW FEATURES:
- cmd/tfplugindocs: Additional CLI arguments
provider-name
,rendered-provider-name
,rendered-website-dir
,examples-dir
,website-temp-dir
, andwebsite-source-dir
. These allow to further customise generated doc (#95).
ENHANCEMENTS:
- cmd/tfplugindocs: Implemented usage output (i.e.
--help
) forgenerate
andvalidate
commands (#95).
BUG FIXES:
- cmd/tfplugindocs: Updated version of hc-install in response to change in HashiCorp Release API sending back a different
Content-Type
header. This was causing failures when the tool attempted to install Terraform. (#135)
ENHANCEMENTS:
- template functions: Added
split
to help separating a string into substrings (#70).
BUG FIXES:
- cmd/tflugindocs: Support for schemas containing empty nested attributes or empty nested blocks (#99, #134).
- schemamd: Attribute
ID
is considered "Read Only", unless there's a description defined, in which case it's handled like any other attribute in the schema (#46, #134).
ENHANCEMENTS:
- cmd/tfplugindocs: Use existing Terraform CLI binary if available on PATH, otherwise download latest Terraform CLI binary (#124).
- cmd/tfplugindocs: Added
tf-version
flag for specifying Terraform CLI binary version to download, superseding the PATH lookup (#124).
BUG FIXES:
- cmd/tfplugindocs: Swapped
.Type
and.Name
resource and data source template fields so they correctly align (#44). - schemamd: Switched attribute name rendering from bold text to code blocks so the Terraform Registry treats them as anchor links (#59).
NOTES:
- dependencies:
github.com/hashicorp/terraform-exec
dependency has been updated to matchterraform-plugin-sdk
, which replaced the removedtfinstall
package withgithub.com/hashicorp/hc-install
. This will resolve Go build errors for projects that import bothterraform-plugin-docs
andterraform-plugin-sdk
.