From e5fec70cb77dbde63343a649de94f10b6e248627 Mon Sep 17 00:00:00 2001
From: Tony Carmichael <1105554+aicarmic@users.noreply.github.com>
Date: Mon, 13 Jul 2020 15:35:48 -0600
Subject: [PATCH] Update publishing.html.md

Add note to dissuade in-place replace of a released provider
---
 website/docs/registry/providers/publishing.html.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/website/docs/registry/providers/publishing.html.md b/website/docs/registry/providers/publishing.html.md
index 730177c0c..3ff1119b0 100644
--- a/website/docs/registry/providers/publishing.html.md
+++ b/website/docs/registry/providers/publishing.html.md
@@ -26,6 +26,8 @@ Publishing a provider requires at least one version be available on GitHub Relea
 
 Terraform CLI and the Terraform Registry follow the Semantic Versioning specification when detecting a valid version, sorting versions, solving version constraints, and choosing the latest version. Prerelease versions are supported (available if explicitly defined but not chosen automatically) with a hyphen (-) delimiter, such as `v1.2.3-pre`.
 
+~> **NOTE:** Avoid modifying or replacing an already-released version of a Provider, as this will cause checksum errors for users when attempting to download the plugin. Instead, if changes are necessary, please release as a new version.
+
 #### Using GoReleaser locally
 
 GoReleaser is a tool for building Go projects for multiple platforms, creating a checksums file, and signing the release. It can also upload your release to GitHub Releases.