diff --git a/.github/instructions/module.instructions.md b/.github/instructions/module.instructions.md
new file mode 100644
index 0000000..b0ec751
--- /dev/null
+++ b/.github/instructions/module.instructions.md
@@ -0,0 +1,14 @@
+---
+applyTo: "module/**"
+---
+
+## Module Overview
+
+This module enables organizations and communities to deliver guides in multiple languages, support multiple versions, and manage several guides from a single platform.
+
+It uses [Hugo](https://gohugo.io/) to generate a static site, which can be deployed anywhere (such as Azure Static Web Apps, Netlify, Vercel, GitHub Pages, or any static hosting provider).
+
+### Translation Flexibility
+
+- You can provide PDF-only translations for any guide or version, allowing for translated content even if a full web version is not available.
+- Individual versions of a guide can be translated independently, without requiring other versions or other guides to be translated as well.
diff --git a/.github/instructions/powershell.instructions.md b/.github/instructions/powershell.instructions.md
new file mode 100644
index 0000000..3e38cd9
--- /dev/null
+++ b/.github/instructions/powershell.instructions.md
@@ -0,0 +1,5 @@
+---
+applyTo: ".powershell/**"
+---
+
+These are demo powershell scripts for seting up the multi-lingual and other options for the Hugo sites that depend on this Module
diff --git a/.github/instructions/site.instructions.md b/.github/instructions/site.instructions.md
new file mode 100644
index 0000000..ef98478
--- /dev/null
+++ b/.github/instructions/site.instructions.md
@@ -0,0 +1,7 @@
+---
+applyTo: "site/**"
+---
+
+## Site Overview
+
+This site is a demo site in Hugo for the Hugo module, allowing local debugging and development. It loads content from other Hugo sites that depend on this module, making it easier to test and debug the module in a real-world context.
diff --git a/readme.md b/readme.md
index 59316e4..27dcee3 100644
--- a/readme.md
+++ b/readme.md
@@ -1,3 +1,23 @@
-# Hugo Guides - Open Extension
+# Hugo Guides Module
 
-This repository provides an engine for guides in Hugo.
+The **Hugo Guides Module** is designed to power a multi-language, multi-guide, multi-version platform for serving authoritative guides and resources. Its goal is to provide a flexible, scalable engine for publishing and maintaining guides such as:
+
+- **The Kanban Guide**
+- **Open Guide to Kanban**
+- **Information for Decision Makers**
+- **Scrum Expansion Pack**
+
+This module enables organizations and communities to deliver guides in multiple languages, support multiple versions, and manage several guides from a single platform.
+
+It uses [Hugo](https://gohugo.io/) to generate a static site, which can be deployed anywhere (such as Azure Static Web Apps, Netlify, Vercel, GitHub Pages, or any static hosting provider).
+
+### Translation Flexibility
+
+- You can provide PDF-only translations for any guide or version, allowing for translated content even if a full web version is not available.
+- Individual versions of a guide can be translated independently, without requiring other versions or other guides to be translated as well.
+
+## Current sites using this module
+
+- [Kanban Guides](https://kanbanguides.org) – [GitHub](https://github.com/KanbanGuides/KanbanGuides)
+- [Scrum Expansion Pack](https://scrumexpansion.org) – [GitHub](https://github.com/ScrumGuides/ScrumGuide-ExpansionPack)
+- [Safe Delusion](https://safedelusion.com) –