diff --git a/docs/ConfigureHEC/index.md b/docs/ConfigureHEC/index.md
index 5e73977..d6247d1 100644
--- a/docs/ConfigureHEC/index.md
+++ b/docs/ConfigureHEC/index.md
@@ -4,6 +4,8 @@
 To avoid losing data, the Splunk HTTP Event Collector (HEC) shall be already configured and ready to receive data.
 
 ## Set the Environment Variables
+Clone the [repository](https://github.com/splunk/terraform-genesyscloud-aws) and execute:
+
 ```bash
 $~ cd examples/hec
 $~ cp .env-example .env
@@ -13,8 +15,10 @@ $~ vi .env
 $~ source .env
 ```
 
+:books: [Clone a GitHub Repo](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)
+
 ## Configure the Deployment
-Edit `examples/hec/main.tf` as explained below
+Edit [examples/hec/main.tf](https://github.com/splunk/terraform-genesyscloud-aws/tree/main/examples/hec/main.tf) as explained below
 
 ```hcl
 module "main" {
diff --git a/docs/ConfigureKinesis/index.md b/docs/ConfigureKinesis/index.md
index 5447048..de19b8b 100644
--- a/docs/ConfigureKinesis/index.md
+++ b/docs/ConfigureKinesis/index.md
@@ -2,6 +2,8 @@
 ![Configure Kinesis](../static/configure-kinesis.png)
 
 ## Set the Environment Variables
+Clone the [repository](https://github.com/splunk/terraform-genesyscloud-aws) and execute:
+
 ```bash
 $~ cd examples/kinesis
 $~ cp .env-example .env
@@ -11,8 +13,10 @@ $~ vi .env
 $~ source .env
 ```
 
+:books: [Clone a GitHub Repo](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)
+
 ## Configure the Integration
-Edit `examples/kinesis/main.tf` as explained below
+Edit [examples/kinesis/main.tf](https://github.com/splunk/terraform-genesyscloud-aws/tree/main/examples/kinesis/main.tf) as explained below
 
 ```hcl
 module "main" {
diff --git a/docs/ConfigureS3/index.md b/docs/ConfigureS3/index.md
index dd8845c..a15ca6c 100644
--- a/docs/ConfigureS3/index.md
+++ b/docs/ConfigureS3/index.md
@@ -2,6 +2,8 @@
 ![Configure S3](../static/configure-s3.png)
 
 ## Set the Environment Variables
+Clone the [repository](https://github.com/splunk/terraform-genesyscloud-aws) and execute:
+
 ```bash
 $~ cd examples/s3
 $~ cp .env-example .env
@@ -11,8 +13,10 @@ $~ vi .env
 $~ source .env
 ```
 
+:books: [Clone a GitHub Repo](https://docs.github.com/en/repositories/creating-and-managing-repositories/cloning-a-repository)
+
 ## Configure the Integration
-Edit `examples/s3/main.tf` as explained below
+Edit [examples/s3/main.tf](https://github.com/splunk/terraform-genesyscloud-aws/tree/main/examples/s3/main.tf) as explained below
 
 ```hcl
 module "main" {
diff --git a/docs/GenesysCloudTopics/index.md b/docs/GenesysCloudTopics/index.md
index b65bb31..94f5841 100644
--- a/docs/GenesysCloudTopics/index.md
+++ b/docs/GenesysCloudTopics/index.md
@@ -31,7 +31,7 @@ By default this module configures Genesys Cloud to monitor the following list of
 A full list of available topics can be found [here](https://developer.genesys.cloud/notificationsalerts/notifications/available-topics). Please select the `Event Bridge` checkbox to filter the supported topics.
 
 ## Advanced Configuration
-To add / remove topics from the configuration, please edit the variable `topic_filters` in `variables.tf`. This configuration will be applied to all use case scenarios.
+To add / remove topics from the configuration, please edit the variable `topic_filters` in [variables.tf](https://github.com/splunk/terraform-genesyscloud-aws/tree/main/variables.tf). This configuration will be applied to all use case scenarios.
 
 To configure **only a specific use case**, edit the `examples/<your_use_case>/main.tf` as shown below.
 
diff --git a/docs/Troubleshooting/index.md b/docs/Troubleshooting/index.md
index 7b3ab63..a3c970a 100644
--- a/docs/Troubleshooting/index.md
+++ b/docs/Troubleshooting/index.md
@@ -1,7 +1,7 @@
 # Troubleshooting
 
 * `409` error (`BucketAlreadyExists`)
-    * the name of the bucket terraform is trying to create is not unique within your AWS region :point_right: set a different s3_bucket_name in `variables.tf`
+  * the name of the bucket terraform is trying to create is not unique within your AWS region :point_right: set a different s3_bucket_name in `variables.tf`
 
 * The script is stuck or you get a `403`
     * there is a permission issue :point_right: make sure you have set the environment variables by running `source .env` and that you have the required permissions to create the required resources in AWS
diff --git a/docs/UseCasesOverview/index.md b/docs/UseCasesOverview/index.md
index 8223380..ee50b5f 100644
--- a/docs/UseCasesOverview/index.md
+++ b/docs/UseCasesOverview/index.md
@@ -13,6 +13,7 @@ Each scenario has pros and cons, please decide the deployment depending on your
 Excluding AWS from the solution is (apparently) viable but consider that:
 
 * Splunk and Genesys Cloud instances should be in close proximity i.e. running in the same continent. Otherwise you may experience latency, retransmissions, higher package loss
+
     > AWS EventBridge retransmits events in case of failures..
 
 * Splunk must be adequately sized to handle events spikes that could increase the load on the instance