diff --git a/website/docs/r/cloudhsm_v2_cluster.html.markdown b/website/docs/r/cloudhsm_v2_cluster.html.markdown
index 3fa1db4cf42..49dac57a131 100644
--- a/website/docs/r/cloudhsm_v2_cluster.html.markdown
+++ b/website/docs/r/cloudhsm_v2_cluster.html.markdown
@@ -14,10 +14,10 @@ For information about CloudHSM v2, see the
 [AWS CloudHSM User Guide][1] and the [Amazon
 CloudHSM API Reference][2].
 
-~> **NOTE:** CloudHSM can take up to several minutes to be set up.
-Practically no single attribute can be updated except TAGS.
+~> **NOTE:** A CloudHSM Cluster can take several minutes to set up.
+Practically no single attribute can be updated, except for `tags`.
 If you need to delete a cluster, you have to remove its HSM modules first.
-To initialize cluster, you have to add an hsm instance to the cluster then sign CSR and upload it.
+To initialize cluster, you have to add an HSM instance to the cluster, then sign CSR and upload it.
 
 ## Example Usage
 
@@ -65,7 +65,7 @@ resource "aws_cloudhsm_v2_cluster" "cloudhsm_v2_cluster" {
 The following arguments are supported:
 
 * `source_backup_identifier` - (Optional) The id of Cloud HSM v2 cluster backup to be restored.
-* `hsm_type` - (Required) The type of HSM module in the cluster. Currently, only hsm1.medium is supported.
+* `hsm_type` - (Required) The type of HSM module in the cluster. Currently, only `hsm1.medium` is supported.
 * `subnet_ids` - (Required) The IDs of subnets in which cluster will operate.
 * `tags` - (Optional) A map of tags to assign to the resource.
 
@@ -74,12 +74,12 @@ The following arguments are supported:
 The following attributes are exported:
 
 * `cluster_id` - The id of the CloudHSM cluster.
-* `cluster_state` - The state of the cluster.
+* `cluster_state` - The state of the CloudHSM cluster.
 * `vpc_id` - The id of the VPC that the CloudHSM cluster resides in.
 * `security_group_id` - The ID of the security group associated with the CloudHSM cluster.
 * `cluster_certificates` - The list of cluster certificates.
     * `cluster_certificates.0.cluster_certificate` - The cluster certificate issued (signed) by the issuing certificate authority (CA) of the cluster's owner.
-    * `cluster_certificates.0.cluster_csr` - The certificate signing request (CSR). Available only in UNINITIALIZED state after an hsm instance is added to the cluster.
+    * `cluster_certificates.0.cluster_csr` - The certificate signing request (CSR). Available only in `UNINITIALIZED` state after an HSM instance is added to the cluster.
     * `cluster_certificates.0.aws_hardware_certificate` - The HSM hardware certificate issued (signed) by AWS CloudHSM.
     * `cluster_certificates.0.hsm_certificate` - The HSM certificate issued (signed) by the HSM hardware.
     * `cluster_certificates.0.manufacturer_hardware_certificate` - The HSM hardware certificate issued (signed) by the hardware manufacturer.