diff --git a/docs/terraform-plugin-versions.md b/docs/terraform-plugin-versions.md index c3e7f679024..b84e6e35732 100644 --- a/docs/terraform-plugin-versions.md +++ b/docs/terraform-plugin-versions.md @@ -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