diff --git a/README.md b/README.md
index ee6098f..50952a4 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,6 @@
+
# terraform-aws-tfstate-backend [![Latest Release](https://img.shields.io/github/release/cloudposse/terraform-aws-tfstate-backend.svg)](https://github.com/cloudposse/terraform-aws-tfstate-backend/releases/latest) [![Slack Community](https://slack.cloudposse.com/badge.svg)](https://slack.cloudposse.com)
+
[![README Header][readme_header_img]][readme_header_link]
@@ -77,8 +79,15 @@ We literally have [*hundreds of terraform modules*][terraform_modules] that are
## Usage
-**IMPORTANT:** The `master` branch is used in `source` just as an example. In your code, do not pin to `master` because there may be breaking changes between releases.
-Instead pin to the release tag (e.g. `?ref=tags/x.y.z`) of one of our [latest releases](https://github.com/cloudposse/terraform-aws-tfstate-backend/releases).
+**IMPORTANT:** We do not pin modules to versions in our examples because of the
+difficulty of keeping the versions in the documentation in sync with the latest released versions.
+We highly recommend that in your code you pin the version to the exact version you are
+using so that your infrastructure remains stable, and update versions in a
+systematic way so that they do not catch you by surprise.
+
+Also, because of a bug in the Terraform registry ([hashicorp/terraform#21417](https://github.com/hashicorp/terraform/issues/21417)),
+the registry shows many of our inputs as required when in fact they are optional.
+The table below correctly indicates which inputs are required.
@@ -217,7 +226,7 @@ Available targets:
| Name | Version |
|------|---------|
-| terraform | >= 0.12.0 |
+| terraform | >= 0.12.26 |
| aws | >= 2.0 |
| local | >= 1.3 |
| template | >= 2.0 |
@@ -433,8 +442,10 @@ Check out [our other projects][github], [follow us on twitter][twitter], [apply
### Contributors
+
| [![Andriy Knysh][aknysh_avatar]][aknysh_homepage]
[Andriy Knysh][aknysh_homepage] | [![Erik Osterman][osterman_avatar]][osterman_homepage]
[Erik Osterman][osterman_homepage] | [![Maarten van der Hoef][maartenvanderhoef_avatar]][maartenvanderhoef_homepage]
[Maarten van der Hoef][maartenvanderhoef_homepage] | [![Vladimir][SweetOps_avatar]][SweetOps_homepage]
[Vladimir][SweetOps_homepage] | [![Chris Weyl][rsrchboy_avatar]][rsrchboy_homepage]
[Chris Weyl][rsrchboy_homepage] | [![John McGehee][jmcgeheeiv_avatar]][jmcgeheeiv_homepage]
[John McGehee][jmcgeheeiv_homepage] | [![Oliver L Schoenborn][schollii_avatar]][schollii_homepage]
[Oliver L Schoenborn][schollii_homepage] |
|---|---|---|---|---|---|---|
+
[aknysh_homepage]: https://github.com/aknysh
[aknysh_avatar]: https://img.cloudposse.com/150x150/https://github.com/aknysh.png
diff --git a/context.tf b/context.tf
index 648917d..e5734b7 100644
--- a/context.tf
+++ b/context.tf
@@ -18,8 +18,10 @@
# will be null, and `module.this.delimiter` will be `-` (hyphen).
#
+
module "this" {
- source = "git::https://github.com/cloudposse/terraform-null-label.git?ref=tags/0.21.0"
+ source = "cloudposse/label/null"
+ version = "0.22.0" // requires Terraform >= 0.12.26
enabled = var.enabled
namespace = var.namespace
diff --git a/docs/terraform.md b/docs/terraform.md
index fe055e8..8b8d0b1 100644
--- a/docs/terraform.md
+++ b/docs/terraform.md
@@ -3,7 +3,7 @@
| Name | Version |
|------|---------|
-| terraform | >= 0.12.0 |
+| terraform | >= 0.12.26 |
| aws | >= 2.0 |
| local | >= 1.3 |
| template | >= 2.0 |
diff --git a/examples/complete/context.tf b/examples/complete/context.tf
index 648917d..e5734b7 100644
--- a/examples/complete/context.tf
+++ b/examples/complete/context.tf
@@ -18,8 +18,10 @@
# will be null, and `module.this.delimiter` will be `-` (hyphen).
#
+
module "this" {
- source = "git::https://github.com/cloudposse/terraform-null-label.git?ref=tags/0.21.0"
+ source = "cloudposse/label/null"
+ version = "0.22.0" // requires Terraform >= 0.12.26
enabled = var.enabled
namespace = var.namespace
diff --git a/examples/complete/versions.tf b/examples/complete/versions.tf
new file mode 100644
index 0000000..4f17204
--- /dev/null
+++ b/examples/complete/versions.tf
@@ -0,0 +1,18 @@
+terraform {
+ required_version = ">= 0.12.26"
+
+ required_providers {
+ aws = {
+ source = "hashicorp/aws"
+ version = ">= 2.0"
+ }
+ local = {
+ source = "hashicorp/local"
+ version = ">= 1.3"
+ }
+ template = {
+ source = "hashicorp/template"
+ version = ">= 2.0"
+ }
+ }
+}
diff --git a/main.tf b/main.tf
index 15b2a6b..9e9c638 100644
--- a/main.tf
+++ b/main.tf
@@ -152,7 +152,7 @@ resource "aws_s3_bucket_public_access_block" "default" {
}
module "dynamodb_table_label" {
- source = "git::https://github.com/cloudposse/terraform-null-label.git?ref=tags/0.21.0"
+ source = "git::https://github.com/cloudposse/terraform-null-label.git?ref=tags/0.22.0"
attributes = compact(concat(var.attributes, ["lock"]))
context = module.this.context
}
diff --git a/versions.tf b/versions.tf
index 4cab155..4f17204 100644
--- a/versions.tf
+++ b/versions.tf
@@ -1,5 +1,5 @@
terraform {
- required_version = ">= 0.12.0"
+ required_version = ">= 0.12.26"
required_providers {
aws = {