Skip to content

Add support for generating documentation for actions #505

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 10 commits into
base: main
Choose a base branch
from

Conversation

austinvalle
Copy link
Member

@austinvalle austinvalle commented Aug 12, 2025

Related Issue

Ref: hashicorp/terraform-json#166

Example usage:

Description

This PR adds support for generating action documentation. Docs are generated in a subdirectory /actions for the generate, validate, and migrate commands.

Currently the only type of action is unlinked which is essentially the same as any other resource/data source/ephemeral resource, however, there will eventually be additional action types that need additional documentation generated for them (such as linked managed resource types), so there are some duplicated bits to allow that to happen later.

Rollback Plan

  • If a change needs to be reverted, we will roll out an update to the code within 7 days.

Changes to Security Controls

No

@austinvalle austinvalle added this to the v0.23.0 milestone Aug 12, 2025
@austinvalle austinvalle requested a review from a team as a code owner August 12, 2025 13:19
@@ -10,15 +10,15 @@ require (
github.com/hashicorp/go-version v1.7.0
github.com/hashicorp/hc-install v0.9.2
github.com/hashicorp/terraform-exec v0.23.0
github.com/hashicorp/terraform-json v0.25.0
github.com/hashicorp/terraform-json v0.25.1-0.20250808120122-465ba375ab0a
Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

TODO: This needs to be updated once this PR is merged for terraform-json: hashicorp/terraform-json#166

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant