Update README.md (#346)

Author: ocofaigh

README.md

@@ -1,5 +1,27 @@
 # terraform-ibm-kms
 
+---
+
+## Module archived
+
+:spider_web: This repo is no longer maintained and is archived. Use one of the following public modules if you consume the module from GitHub: 
+- [terraform-ibm-key-protect-all-inclusive](https://github.com/terraform-ibm-modules/terraform-ibm-key-protect-all-inclusive)
+- [terraform-ibm-key-protect](https://github.com/terraform-ibm-modules/terraform-ibm-key-protect)
+- [terraform-ibm-kms-key](https://github.com/terraform-ibm-modules/terraform-ibm-kms-key)
+- [terraform-ibm-kms-key-ring](https://github.com/terraform-ibm-modules/terraform-ibm-kms-key-ring)
+
+## Changes if you use the Hashicorp registry
+
+:exclamation: **Important:**  This module will be deleted from the Hashicorp registry on 1 August 2023. 
+
+If you  consume the module from the Hashicorp registry, use of the following instead:
+- [key-protect-all-inclusive](https://registry.terraform.io/modules/terraform-ibm-modules/key-protect-all-inclusive/ibm/latest)
+- [key-protect](https://registry.terraform.io/modules/terraform-ibm-modules/key-protect/ibm/latest)
+- [kms-key](https://registry.terraform.io/modules/terraform-ibm-modules/kms-key/ibm/latest)
+- [kms-key-ring](https://registry.terraform.io/modules/terraform-ibm-modules/kms-key-ring/ibm/latest)
+
+---
+
 [![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
 [![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)
 [![latest release](https://img.shields.io/github/v/release/terraform-ibm-modules/terraform-ibm-kms?logo=GitHub&sort=semver)](https://github.com/terraform-ibm-modules/terraform-ibm-kms/releases/latest)