diff --git a/README.md b/README.md
index 6638ebb..89b828e 100644
--- a/README.md
+++ b/README.md
@@ -36,7 +36,6 @@ along with configuring tracing, logging, and metrics.
 The module also consists of the following submodules:
 
   - [account-settings](modules/account-settings) - to provision account-level settings for logging and metrics for API Gateway
-  ```
 
 ---
 
@@ -67,6 +66,10 @@ We literally have [*hundreds of terraform modules*][terraform_modules] that are
 
 
 
+## Introduction
+
+A set of modules for configuring an API Gateway
+
 
 ## Security & Compliance [<img src="https://cloudposse.com/wp-content/uploads/2020/11/bridgecrew.svg" width="250" align="right" />](https://bridgecrew.io/)
 
diff --git a/README.yaml b/README.yaml
index d1543f9..380c996 100644
--- a/README.yaml
+++ b/README.yaml
@@ -51,9 +51,9 @@ description: |-
   The module also consists of the following submodules:
 
     - [account-settings](modules/account-settings) - to provision account-level settings for logging and metrics for API Gateway
-    ```
 
-#introduction: |-
+introduction: |-
+  A set of modules for configuring an API Gateway
 
 references:
   - name: "API Gateway CloudWatch Logging"