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
This commit is contained in:
2026-06-11 13:17:32 -07:00
parent 1be3ad0410
commit 7ef8b3a585
4 changed files with 34 additions and 1 deletions
+29
View File
@@ -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 extension. Open the `www` folder as the editor workspace so its content folders
and media paths resolve correctly. 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 ### Images And Downloads
Store content-referenced assets in: Store content-referenced assets in:
+1 -1
View File
@@ -1,3 +1,3 @@
# Broken Links # 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.
+2
View File
@@ -18,6 +18,8 @@
- Rebuilt the homepage in the live section order and rebuilt shared service, - Rebuilt the homepage in the live section order and rebuilt shared service,
library-index, and blog-post families against live public references. library-index, and blog-post families against live public references.
- Reused the same complete live-derived homepage layout for English and Spanish. - 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. - Replaced the extracted linear team article with a dedicated live-derived team grid.
- Repaired mirror-rewritten PDF, lightbox, CTA, and relative content links. - Repaired mirror-rewritten PDF, lightbox, CTA, and relative content links.
- Limited language-switcher choices to translations that have generated routes. - Limited language-switcher choices to translations that have generated routes.
+2
View File
@@ -35,6 +35,8 @@ Implemented fidelity work includes:
utility links, footer columns, and contact information. utility links, footer columns, and contact information.
- Rebuilt the complete English and Spanish homepages in their live section - Rebuilt the complete English and Spanish homepages in their live section
order using one reusable Astro component and self-hosted source assets. 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 - Rebuilt service pages around the live compact title banner and editorial
presentation, with current visible headings and working calls to action. presentation, with current visible headings and working calls to action.
- Recovered and restored the live decorative hero imagery for all mapped - Recovered and restored the live decorative hero imagery for all mapped