Skip to content

Commit

Permalink
Merge branch 'hashicorp:main' into main
Browse files Browse the repository at this point in the history
  • Loading branch information
mbialon authored Sep 29, 2023
2 parents d5a85f6 + c611551 commit 394dea0
Showing 1 changed file with 8 additions and 2 deletions.
10 changes: 8 additions & 2 deletions docs/terraform-plugin-versions.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,14 @@
# Terraform Plugin Versions

The Terraform AWS Provider is constructed with HashiCorp-maintained packages for building plugins. Most existing resources are implemented with [Terraform Plugin SDKv2](https://developer.hashicorp.com/terraform/plugin/sdkv2), while newer resources may use [Terraform Plugin Framework](https://developer.hashicorp.com/terraform/plugin/framework). A thorough comparison of the packages can be found [here](https://developer.hashicorp.com/terraform/plugin/framework-benefits).
The Terraform AWS Provider is constructed with HashiCorp-maintained packages for building plugins.
Most existing resources are implemented with [Terraform Plugin SDKv2](https://developer.hashicorp.com/terraform/plugin/sdkv2), while newer resources may use [Terraform Plugin Framework](https://developer.hashicorp.com/terraform/plugin/framework).
A thorough comparison of the packages can be found [here](https://developer.hashicorp.com/terraform/plugin/framework-benefits).

At this time community contributions in either package will be accepted. The AWS Provider is [muxed](https://developer.hashicorp.com/terraform/plugin/framework/migrating/mux) to allow resources and data sources implemented in both packages. As AWS Provider tooling around Plugin Framework (and the library itself) matures, we will being requiring all net-new resources be implemented with it. [`skaff`](skaff.md) currently supports generating Plugin Framework based resources using the optional `-p`/`--plugin-framework` flag. Factors to consider when choosing between packages are:
At this time, we accept community contributions implemented using either package.
The AWS Provider is [muxed](https://developer.hashicorp.com/terraform/plugin/framework/migrating/mux), so that resources and data sources can be implemented using either package.
As AWS Provider tooling around Plugin Framework (and the library itself) matures, we will require that all net-new resources are implemented using the Plugin Framework.
[`skaff`](skaff.md) currently supports generating Plugin Framework based resources using the optional `-p`/`--plugin-framework` flag.
Factors to consider when choosing between packages are:

1. What other resources in a given service use
2. Level of comfort with the new idioms introduced in Plugin Framework
Expand Down

0 comments on commit 394dea0

Please sign in to comment.