From 6dcaa3ba0e4bef25b29938e5c1395869c5423471 Mon Sep 17 00:00:00 2001
From: "google-labs-jules[bot]"
 <161369871+google-labs-jules[bot]@users.noreply.github.com>
Date: Wed, 15 Jul 2026 04:48:30 +0000
Subject: [PATCH] docs: add "Back to Overview" navigation to template
 documentation
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Improved documentation UX by adding a "← Back to Overview" link at the bottom of all template documentation pages. This prevents "dead-end" navigation and makes it easier for users to explore different templates.

Changes:
- Added `[← Back to Overview](../README.md)` to all `docs/template/*.md` files.
- Updated `.template/docs/template.md` to include the link in future templates.
- Verified changes using MkDocs and Playwright.
---
 .template/docs/template.md   | 3 +++
 docs/template/agent.md       | 3 +++
 docs/template/api.md         | 3 +++
 docs/template/eventbridge.md | 3 +++
 docs/template/graphql.md     | 3 +++
 docs/template/s3.md          | 3 +++
 docs/template/sqs.md         | 3 +++
 docs/template/stream.md      | 3 +++
 8 files changed, 24 insertions(+)

diff --git a/.template/docs/template.md b/.template/docs/template.md
index f8136a9..c12ba86 100644
--- a/.template/docs/template.md
+++ b/.template/docs/template.md
@@ -20,3 +20,6 @@ Deploy the stack using:
 ```bash
 mise run deploy ${name}
 ```
+
+
+[← Back to Overview](../README.md)
diff --git a/docs/template/agent.md b/docs/template/agent.md
index cfb67a6..5901bae 100644
--- a/docs/template/agent.md
+++ b/docs/template/agent.md
@@ -63,3 +63,6 @@ Variable | Description | Required | Default
 `SERVICE_NAME` | Powertools service name | No | `bedrock-agent`
 `METRICS_NAMESPACE` | Powertools metrics namespace | No | `BedrockAgent`
 `LOG_LEVEL` | Log level for the Lambda Logger | No | `INFO`
+
+
+[← Back to Overview](../README.md)
diff --git a/docs/template/api.md b/docs/template/api.md
index eb2a179..3f6aa22 100644
--- a/docs/template/api.md
+++ b/docs/template/api.md
@@ -47,3 +47,6 @@ Variable | Description | Required | Default
 `SERVICE_NAME` | Powertools service name | No | `rest-api`
 `METRICS_NAMESPACE` | Powertools metrics namespace | No | `RestApi`
 `LOG_LEVEL` | Log level for the Lambda Logger | No | `INFO`
+
+
+[← Back to Overview](../README.md)
diff --git a/docs/template/eventbridge.md b/docs/template/eventbridge.md
index 367620d..5a504fc 100644
--- a/docs/template/eventbridge.md
+++ b/docs/template/eventbridge.md
@@ -52,3 +52,6 @@ Variable | Description | Required | Default
 `SERVICE_NAME` | Powertools service name | No | `eventbridge`
 `METRICS_NAMESPACE` | CloudWatch metrics namespace | No | `EventBridge`
 `LOG_LEVEL` | Log level for the Lambda Logger | No | `INFO`
+
+
+[← Back to Overview](../README.md)
diff --git a/docs/template/graphql.md b/docs/template/graphql.md
index c3f10cf..f2254ca 100644
--- a/docs/template/graphql.md
+++ b/docs/template/graphql.md
@@ -90,3 +90,6 @@ Variable | Description | Required | Default
 `SERVICE_NAME` | Powertools service name | No | `graphql-api`
 `METRICS_NAMESPACE` | Powertools metrics namespace | No | `GraphQLApi`
 `LOG_LEVEL` | Log level for the Lambda Logger | No | `INFO`
+
+
+[← Back to Overview](../README.md)
diff --git a/docs/template/s3.md b/docs/template/s3.md
index 64aa77d..138bf80 100644
--- a/docs/template/s3.md
+++ b/docs/template/s3.md
@@ -42,3 +42,6 @@ Variable | Description | Required | Default
 `SERVICE_NAME` | Powertools service name | No | `s3-processor`
 `METRICS_NAMESPACE` | CloudWatch Metrics namespace | No | `S3Processor`
 `LOG_LEVEL` | Log level for the Lambda Logger | No | `INFO`
+
+
+[← Back to Overview](../README.md)
diff --git a/docs/template/sqs.md b/docs/template/sqs.md
index 31fd0f8..f0ebeaa 100644
--- a/docs/template/sqs.md
+++ b/docs/template/sqs.md
@@ -53,3 +53,6 @@ Variable | Description | Required | Default
 `SERVICE_NAME` | Powertools service name | No | `sqs-processor`
 `METRICS_NAMESPACE` | Powertools metrics namespace | No | `SqsProcessor`
 `LOG_LEVEL` | Log level for the Lambda Logger | No | `INFO`
+
+
+[← Back to Overview](../README.md)
diff --git a/docs/template/stream.md b/docs/template/stream.md
index aa17a5b..2288143 100644
--- a/docs/template/stream.md
+++ b/docs/template/stream.md
@@ -55,3 +55,6 @@ Variable | Description | Required | Default
 `SERVICE_NAME` | Powertools service name | No | `dynamodb-stream`
 `METRICS_NAMESPACE` | Powertools metrics namespace | No | `DynamoDBStream`
 `LOG_LEVEL` | Log level for the Lambda Logger | No | `INFO`
+
+
+[← Back to Overview](../README.md)