From 7ef8b3a585556be725db8ebddde05c8fe2bc2038 Mon Sep 17 00:00:00 2001
From: Jeffrey Hales <committable@bluechip.icu>
Date: Thu, 11 Jun 2026 13:17:32 -0700
Subject: [PATCH] docs(migration): document homepage content model and refresh
 reports

- document the homepage frontmatter workflow in README.md
- note the new section-oriented homepage structure in migration-summary.md
- update cleanup and link reports to match the current implementation
- keep the repo docs aligned with the content-driven homepage model
---
 www/README.md                    | 29 +++++++++++++++++++++++++++++
 www/reports/broken-links.md      |  2 +-
 www/reports/cleanup-log.md       |  2 ++
 www/reports/migration-summary.md |  2 ++
 4 files changed, 34 insertions(+), 1 deletion(-)

diff --git a/www/README.md b/www/README.md
index 34cdbdd..058f813 100644
--- a/www/README.md
+++ b/www/README.md
@@ -215,6 +215,35 @@ The project includes `frontmatter.json` for the Front Matter CMS VS Code
 extension. Open the `www` folder as the editor workspace so its content folders
 and media paths resolve correctly.
 
+### Edit The Homepage
+
+The English and Spanish homepages are driven from the structured `home:`
+frontmatter block in:
+
+```txt
+src/content/pages/en/index.md
+src/content/pages/es/index.md
+```
+
+`HomePage.astro` renders those named sections in order. Use the section names
+as the editing surface:
+
+```txt
+hero
+servicesIntro
+benefits
+skills
+insurance
+esa
+financialHelp
+process
+director
+testimonials
+```
+
+Keep homepage copy in those named blocks so the page remains easy to scan in
+Front Matter CMS and VS Code. `src/content.config.ts` validates the structure.
+
 ### Images And Downloads
 
 Store content-referenced assets in:
diff --git a/www/reports/broken-links.md b/www/reports/broken-links.md
index 3e4ca57..cdf8806 100644
--- a/www/reports/broken-links.md
+++ b/www/reports/broken-links.md
@@ -1,3 +1,3 @@
 # Broken Links
 
-Rendered output is unavailable in the sandbox; source routes and public assets were audited. No broken internal source links were detected.
+No broken internal build links detected.
diff --git a/www/reports/cleanup-log.md b/www/reports/cleanup-log.md
index eab935e..e568948 100644
--- a/www/reports/cleanup-log.md
+++ b/www/reports/cleanup-log.md
@@ -18,6 +18,8 @@
 - Rebuilt the homepage in the live section order and rebuilt shared service,
   library-index, and blog-post families against live public references.
 - Reused the same complete live-derived homepage layout for English and Spanish.
+- Reorganized the homepage source into named `home:` frontmatter blocks so the
+  content is easier to inspect and edit without changing the rendered layout.
 - Replaced the extracted linear team article with a dedicated live-derived team grid.
 - Repaired mirror-rewritten PDF, lightbox, CTA, and relative content links.
 - Limited language-switcher choices to translations that have generated routes.
diff --git a/www/reports/migration-summary.md b/www/reports/migration-summary.md
index 1e990b1..33d9d4a 100644
--- a/www/reports/migration-summary.md
+++ b/www/reports/migration-summary.md
@@ -35,6 +35,8 @@ Implemented fidelity work includes:
   utility links, footer columns, and contact information.
 - Rebuilt the complete English and Spanish homepages in their live section
   order using one reusable Astro component and self-hosted source assets.
+- Moved the English and Spanish homepage copy into section-oriented `home:`
+  frontmatter blocks so the page is easier to edit in Front Matter CMS.
 - Rebuilt service pages around the live compact title banner and editorial
   presentation, with current visible headings and working calls to action.
 - Recovered and restored the live decorative hero imagery for all mapped