diff --git a/examples/billing_account/README.md b/examples/billing_account/README.md
index a8183e6b..474da886 100644
--- a/examples/billing_account/README.md
+++ b/examples/billing_account/README.md
@@ -1,3 +1,7 @@
+# Billing Account Example
+
+This example illustrates how to use the `billing_accounts_iam` submodule
+
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 ## Inputs
 
diff --git a/examples/folder/README.md b/examples/folder/README.md
index f4f6c954..b1bdfe67 100644
--- a/examples/folder/README.md
+++ b/examples/folder/README.md
@@ -1,3 +1,7 @@
+# Folder Example
+
+This example illustrates how to use the `folders_iam` submodule
+
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 ## Inputs
 
diff --git a/examples/kms_crypto_key/README.md b/examples/kms_crypto_key/README.md
index 97f5ebde..80f5b368 100644
--- a/examples/kms_crypto_key/README.md
+++ b/examples/kms_crypto_key/README.md
@@ -1,3 +1,7 @@
+# KMS Crypto Key Example
+
+This example illustrates how to use the `kms_crypto_keys_iam` submodule
+
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 ## Inputs
 
diff --git a/examples/kms_key_ring/README.md b/examples/kms_key_ring/README.md
index 9af8828c..caf84165 100644
--- a/examples/kms_key_ring/README.md
+++ b/examples/kms_key_ring/README.md
@@ -1,3 +1,7 @@
+# KMS Key Ring Example
+
+This example illustrates how to use the `kms_key_rings_iam` submodule
+
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 ## Inputs
 
diff --git a/examples/organization/README.md b/examples/organization/README.md
index 2f976b93..6dedc8bc 100644
--- a/examples/organization/README.md
+++ b/examples/organization/README.md
@@ -1,3 +1,7 @@
+# Organization Example
+
+This example illustrates how to use the `organizations_iam` submodule
+
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 ## Inputs
 
diff --git a/examples/project/README.md b/examples/project/README.md
index 5422c41a..2dbdc014 100644
--- a/examples/project/README.md
+++ b/examples/project/README.md
@@ -1,3 +1,7 @@
+# Project Example
+
+This example illustrates how to use the `projects_iam` submodule
+
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 ## Inputs
 
diff --git a/examples/pubsub_subscription/README.md b/examples/pubsub_subscription/README.md
index 18466af4..49b95a86 100644
--- a/examples/pubsub_subscription/README.md
+++ b/examples/pubsub_subscription/README.md
@@ -1,3 +1,7 @@
+# PubSub Subscription Example
+
+This example illustrates how to use the `pubsub_subscriptions_iam` submodule
+
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 ## Inputs
 
diff --git a/examples/pubsub_topic/README.md b/examples/pubsub_topic/README.md
index 7f59ad21..bc4e88cf 100644
--- a/examples/pubsub_topic/README.md
+++ b/examples/pubsub_topic/README.md
@@ -1,3 +1,7 @@
+# PubSub Topic Example
+
+This example illustrates how to use the `pubsub_topics_iam` submodule
+
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 ## Inputs
 
diff --git a/examples/service_account/README.md b/examples/service_account/README.md
index 2381b143..a893113d 100644
--- a/examples/service_account/README.md
+++ b/examples/service_account/README.md
@@ -1,3 +1,7 @@
+# Service Account Example
+
+This example illustrates how to use the `service_accounts_iam` submodule
+
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 ## Inputs
 
diff --git a/examples/storage_bucket/README.md b/examples/storage_bucket/README.md
index 5cabdd17..329869d9 100644
--- a/examples/storage_bucket/README.md
+++ b/examples/storage_bucket/README.md
@@ -1,3 +1,7 @@
+# Storage Bucket Example
+
+This example illustrates how to use the `storage_buckets_iam` submodule
+
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 ## Inputs
 
diff --git a/examples/subnet/README.md b/examples/subnet/README.md
index 70a6b8bb..23300a95 100644
--- a/examples/subnet/README.md
+++ b/examples/subnet/README.md
@@ -1,3 +1,7 @@
+# Subnet Example
+
+This example illustrates how to use the `subnets_iam` submodule
+
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 ## Inputs