Skip to content

CHANGELOG.md

Latest commit

 

History

History
308 lines (175 loc) · 18.3 KB

CHANGELOG.md

File metadata and controls

308 lines (175 loc) · 18.3 KB

0.25.0 (April 20, 2026)

FEATURES:

  • generate: Add support for state stores (#570)
  • migrate: Add support for state stores (#570)
  • validate: Add support for state stores (#570)

BUG FIXES:

  • deps: bump github.com/hashicorp/hc-install to v0.9.4 (#589)

0.24.0 (October 13, 2025)

FEATURES:

  • generate: Support multiple configuration example files in default templates (#508)
  • generate/migrate/validate: Add support for list resources (#528)

0.23.0 (September 17, 2025)

FEATURES:

  • generate: Add support for actions (#505)
  • migrate: Add support for actions (#505)
  • validate: Add support for actions (#505)

0.22.0 (July 01, 2025)

BREAKING CHANGES:

  • generate: The .ProviderShortName template function now uses the rendered provider name to derive the provider short name. Users that pass in the --rendered-provider-name flag might see a different output for this function (#492)

NOTES:

  • generate: Generated import documentation will now contain more information about which methods are supported by the provider (CLI command, config by ID, config by identity). (#495)

FEATURES:

  • generate: Added support for defining import example file (import-by-string-id.tf) using Terraform configuration and the id attribute (#472)
  • generate: Added support for defining import example file (import-by-identity.tf) using Terraform configuration and the identity attribute (managed resource identity) (#496)

ENHANCEMENTS:

  • validate: Add allowed-guide-subcategories and allowed-resource-subcategories to provide a list of allowed subcategories (#456)
  • validate: Add allowed-guide-subcategories-file and allowed-resource-subcategories-file to provide a file containing a list of allowed subcategories (#456)
  • generate: Default resource and function templates now use .RenderedProviderName instead of .ProviderName (#492)
  • generate: Remove trailing whitespace from default function template when .HasVariadic evaluates to false (#489)

BUG FIXES:

  • validate: Fixed a bug that caused all non-index files to be detected as guides (#456)
  • generate: Remove subcategory field from default provider templates (#446)

0.21.0 (February 27, 2025)

FEATURES:

  • generate: Add support for write-only arguments (#434)

0.20.1 (November 26, 2024)

BUG FIXES:

  • validate: Fixed a bug that caused false positive validation errors for resource types that have the same name as the provider. (#419)
  • generate: Fixed a bug that caused all generated resource documentation to have the same content when the provider has a resource type with the same name as the provider. (#419)
  • generate: Fixed a bug that would return an error when a static file exists in both templates and docs, which will now be ignored. (#421)

0.20.0 (November 06, 2024)

NOTES:

  • all: This Go module has been updated to Go 1.22 per the Go support policy. It is recommended to review the Go 1.22 release notes before upgrading. Any consumers building on earlier Go versions may experience errors. (#400)

FEATURES:

  • generate: Add support for ephemeral resources (#415)
  • migrate: Add support for ephemeral resources (#415)
  • validate: Add support for ephemeral resources (#415)

BUG FIXES:

  • validate: File extension check now runs on index.* files instead of just index.md files. (#413)
  • validate: File extension check now specifies the correct valid extensions in the error message. (#413)
  • validate: Front matter check now runs with the correct options on legacy index files. (#413)

0.19.4 (June 04, 2024)

NOTES:

  • validate: The number of files check has been removed to match the latest Terraform Registry ingress logic (#381)

BUG FIXES:

  • generate: Prevented incorrect attribute paths with nested attributes that contain multiple attributes (#380)

0.19.3 (May 28, 2024)

BUG FIXES:

  • validate: Fixed issue with provider name not defaulting to directory (#376)

0.19.2 (April 29, 2024)

BUG FIXES:

  • migrate: Ensured idempotency of template files when command is ran multiple times (#364)
  • generate: Prevented automatic id attribute behaviors under blocks (#365)

0.19.1 (April 22, 2024)

BUG FIXES:

  • generate: fixed a bug where attribute titles were not being generated for nested object attributes (#357)
  • generate: fixed a bug where the plainmarkdown function did not output plain URLs (#361)

0.19.0 (April 15, 2024)

BREAKING CHANGES:

  • generate: the plainmarkdown function now removes all markdown elements/formatting to render the output as plain text (#332)
  • schemamd: The schemamd package has moved to internal/schemamd and can no longer be imported (#354)
  • functionmd: The functionmd package has moved to internal/functionmd and can no longer be imported (#354)

FEATURES:

  • validate: Added support for Provider-defined Function documentation to all checks (#341)
  • validate: Added InvalidDirectoriesCheck which checks for valid provider documentation folder structure (#341)
  • validate: Added MixedDirectoriesCheck which throws an error if both legacy documentation and registry documentation are found (#341)
  • validate: Added NumberOfFilesCheck which checks the number of provider documentation files against the registry limit (#341)
  • validate: Added FileSizeCheck which checks the provider documentation file size against the registry limit (#341)
  • validate: Added FileExtensionCheck which checks for valid provider documentation file extensions (#341)
  • validate: Added FrontMatterCheck which checks the YAML frontmatter of provider documentation for missing required fields or invalid fields (#341)
  • validate: Added FileMismatchCheck which checks the names/number of provider documentation files against the provider schema (#341)

ENHANCEMENTS:

  • migrate: Added --provider-name flag to override the default provider name when any file names that contain provider name prefixes are removed during migration (#349)

BUG FIXES:

  • migrate: use relative paths (from provider directory) instead of absolute paths for migrated code templates (#330)
  • migrate: fixed a bug where documentation files with provider name prefixes were migrated to templates directory as-is, causing generate to create duplicate templates (#349)
  • generate: fixed a bug where incorrect attribute titles were being generated for certain nested schemas (#350)

0.18.0 (January 24, 2024)

FEATURES:

  • generate: Add support for Provider-defined Function documentation (#328)
  • migrate: Add support for Provider-defined Function documentation (#328)

ENHANCEMENTS:

  • validate: Add functions to list of allowed template and rendered website subdirectories (#328)

0.17.0 (January 17, 2024)

BREAKING CHANGES:

  • generate: templates using printf with either codefile or tffile to render code examples in markdown will need to switch to using those functions directly. For example, switch the following template code: {{printf "{{codefile \"shell\" %q}}" .ImportFile}} to {{codefile "shell" .ImportFile}} (#300)

FEATURES:

  • migrate: Added new migrate subcommand that migrates existing provider docs using the rendered website source directories (website/docs/ or /docs/) to a terraform-plugin-docs-supported templates directory. (#314)

ENHANCEMENTS:

  • generate: Add provider-schema flag to pass in a file path to a provider schema JSON file, allowing the command to skip building the provider and calling Terraform CLI (#299)

BUG FIXES:

  • generate: fix no such file or directory error when running generate with no existing rendered website directory. (#296)
  • generate: fix incorrect rendering of example and import files for providers with no docs templates or with generic fallback templates. (#300)

0.16.0 (July 06, 2023)

ENHANCEMENTS:

  • generate: Prevent files and subdirectories in the rendered website directory that are not directly managed by tfplugindocs from being deleted during generation (#267)
  • validate: Add cdktf to list of allowed rendered website subdirectories (#267)

0.15.0 (June 07, 2023)

BREAKING CHANGES:

  • generate: The legacy-sidebar flag has been removed without replacement. It implemented no logic and is not necessary with Terraform Registry based documentation (#258)

NOTES:

  • This Go module has been updated to Go 1.19 per the Go support policy. Any consumers building on earlier Go versions may experience errors. (#231)

ENHANCEMENTS:

  • generate: Added provider-dir flag, which enables the command to be run from any directory (#259)

0.14.1 (March 02, 2023)

BUG FIXES:

  • dependencies: github.com/hashicorp/terraform-exec dependency upgraded to v0.18.1 to avoid causing acceptance test failures when terraform-plugin-sdk or terraform-plugin-testing are in use (#226)

0.14.0 (February 28, 2023)

NOTES:

  • This Go module has been updated to Go 1.18 per the Go support policy. Any consumers building on earlier Go versions may experience errors (#199)

0.13.0 (July 8, 2022)

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).

0.12.0 (June 29, 2022)

BUG FIXES:

  • template data: A regression was introduced in #155 making template data field HasExample and HasImport always true (#162).

NEW FEATURES:

  • template functions: Added lower, upper and title (#162).

ENHANCEMENTS:

  • Added documentation for all the template functions and template data fields (#162).

0.11.0 (June 28, 2022)

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 and import to allow use of HasExample and HasImport 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).

0.10.1 (June 14, 2022)

BUG FIXES:

  • cmd/tfplugindocs: Do not error when schema not found, issue log warning (#151).

0.10.0 (June 13, 2022)

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).

0.9.0 (June 1, 2022)

NEW FEATURES:

  • cmd/tfplugindocs: Additional CLI arguments provider-name, rendered-provider-name, rendered-website-dir, examples-dir, website-temp-dir, and website-source-dir. These allow to further customise generated doc (#95).

ENHANCEMENTS:

  • cmd/tfplugindocs: Implemented usage output (i.e. --help) for generate and validate commands (#95).

0.8.1 (May 10, 2022)

BUG FIXES:

0.8.0 (May 3, 2022)

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).

0.7.0 (March 15, 2022)

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).

0.6.0 (March 14, 2022)

NOTES:

  • dependencies: github.com/hashicorp/terraform-exec dependency has been updated to match terraform-plugin-sdk, which replaced the removed tfinstall package with github.com/hashicorp/hc-install. This will resolve Go build errors for projects that import both terraform-plugin-docs and terraform-plugin-sdk.
⚡