chore(docs): remove local mirror references, use live site only
Deleted the www.azinstitute4autism.com mirror directory and scrubbed all references to it from AGENTS.md, MIGRATION_BRIEF.md, www/README.md, and www/original/README.md. The live public site is now the sole source of truth with no local mirror fallback.
This commit is contained in:
@@ -13,42 +13,20 @@ content only after verifying it against the live public site.
|
||||
|
||||
## Project
|
||||
|
||||
This repository contains a mirrored copy of the Arizona Institute for Autism website.
|
||||
|
||||
Raw mirror source:
|
||||
|
||||
```txt
|
||||
./www.azinstitute4autism.com
|
||||
```
|
||||
|
||||
New Astro site target:
|
||||
|
||||
```txt
|
||||
./www
|
||||
```
|
||||
|
||||
The mirror was created with:
|
||||
|
||||
```sh
|
||||
wget --mirror --page-requisites --adjust-extension --convert-links --no-parent https://www.azinstitute4autism.com
|
||||
```
|
||||
|
||||
Do not modify, move, rename, or delete `./www.azinstitute4autism.com`.
|
||||
|
||||
Treat the mirror as read-only raw source material.
|
||||
|
||||
The live public website is the single source of truth:
|
||||
|
||||
```txt
|
||||
https://www.azinstitute4autism.com
|
||||
```
|
||||
|
||||
Use the mirror as a convenient local extraction and inspection aid only. The
|
||||
mirror may contain stale, missing, rewritten, or incorrectly downloaded
|
||||
content and assets. Verify content, design, URLs, metadata, assets, and
|
||||
responsive behavior against the live public site before treating them as
|
||||
authoritative. When the live site and mirror disagree, follow the live site and
|
||||
document material discrepancies.
|
||||
Verify content, design, URLs, metadata, assets, and responsive behavior against
|
||||
the live public site before treating them as authoritative.
|
||||
|
||||
## Primary goal
|
||||
|
||||
@@ -221,10 +199,9 @@ Favor:
|
||||
Before implementing a page family or shared component:
|
||||
|
||||
1. Inspect the live page and its HTML, CSS, assets, and responsive behavior.
|
||||
2. Use the mirror to accelerate local extraction and inspection.
|
||||
3. Resolve any discrepancy in favor of the live public site.
|
||||
4. Record the source structure and important visual details.
|
||||
5. Identify which patterns are truly shared and which are page-specific.
|
||||
2. Resolve any discrepancy in favor of the live public site.
|
||||
3. Record the source structure and important visual details.
|
||||
4. Identify which patterns are truly shared and which are page-specific.
|
||||
|
||||
After implementation, compare the Astro output with the live public site at
|
||||
representative desktop and mobile viewport widths. Check the full page, not
|
||||
@@ -365,10 +342,9 @@ reports/migration-summary.md
|
||||
Before large filesystem changes:
|
||||
|
||||
1. Inspect the live public site.
|
||||
2. Inspect the mirror and identify relevant discrepancies.
|
||||
3. Inspect the relevant source HTML, CSS, and assets in detail.
|
||||
4. Summarize the implementation and visual-validation plan.
|
||||
5. Proceed methodically.
|
||||
2. Inspect the relevant source HTML, CSS, and assets in detail.
|
||||
3. Summarize the implementation and visual-validation plan.
|
||||
4. Proceed methodically.
|
||||
|
||||
At the end of a task, summarize:
|
||||
|
||||
|
||||
+19
-54
@@ -7,21 +7,15 @@ brief provides detailed implementation guidance. If any wording here appears
|
||||
to conflict with `AGENTS.md`, follow `AGENTS.md` and correct this brief before
|
||||
continuing.
|
||||
|
||||
This is a fidelity-first migration, not a redesign. The raw mirror is a
|
||||
convenient local extraction and inspection aid, but the live public site is the
|
||||
This is a fidelity-first migration, not a redesign. The live public site is the
|
||||
single content and visual source of truth. The `migration-foundation` branch
|
||||
may be consulted for nonvisual tooling and recovered content, but it must not
|
||||
be used as the visual baseline.
|
||||
|
||||
## Task
|
||||
|
||||
Migrate the public Arizona Institute for Autism website from a mirrored HubSpot-generated static copy into a clean, maintainable Astro + TypeScript site.
|
||||
|
||||
Raw mirrored source:
|
||||
|
||||
```txt
|
||||
./www.azinstitute4autism.com
|
||||
```
|
||||
Migrate the public Arizona Institute for Autism website into a clean,
|
||||
maintainable Astro + TypeScript site.
|
||||
|
||||
New Astro project target:
|
||||
|
||||
@@ -29,12 +23,6 @@ New Astro project target:
|
||||
./www
|
||||
```
|
||||
|
||||
The raw mirror was created with:
|
||||
|
||||
```sh
|
||||
wget --mirror --page-requisites --adjust-extension --convert-links --no-parent https://www.azinstitute4autism.com
|
||||
```
|
||||
|
||||
There is no HubSpot export, no HubSpot CLI access, and no HubSpot API access.
|
||||
|
||||
Use the live public website as the single source of truth:
|
||||
@@ -43,15 +31,9 @@ Use the live public website as the single source of truth:
|
||||
https://www.azinstitute4autism.com
|
||||
```
|
||||
|
||||
Use the local mirror as a convenient extraction and inspection aid. It may
|
||||
contain stale, missing, rewritten, or incorrectly downloaded content and
|
||||
assets. Verify content, design, URLs, metadata, assets, and responsive behavior
|
||||
against the live site. When the live site and mirror disagree, follow the live
|
||||
site and document material discrepancies.
|
||||
|
||||
If the live site is temporarily unavailable, work that depends on its authority
|
||||
must remain explicitly unverified rather than silently treating the mirror as
|
||||
authoritative.
|
||||
Verify content, design, URLs, metadata, assets, and responsive behavior against
|
||||
the live site. If the live site is temporarily unavailable, work that depends
|
||||
on its authority must remain explicitly unverified.
|
||||
|
||||
## High-level goal
|
||||
|
||||
@@ -76,10 +58,6 @@ Create a new Astro site in `./www` that is:
|
||||
|
||||
Do not modify or delete:
|
||||
|
||||
```txt
|
||||
./www.azinstitute4autism.com
|
||||
```
|
||||
|
||||
Do not depend on:
|
||||
|
||||
- HubSpot CLI
|
||||
@@ -283,13 +261,12 @@ Do not use Tailwind.
|
||||
For each page family or shared component:
|
||||
|
||||
1. Inspect the live page, HTML, CSS, assets, and responsive behavior.
|
||||
2. Use the mirror to accelerate local extraction and inspection.
|
||||
3. Resolve discrepancies in favor of the live public site.
|
||||
4. Record important visual details and identify genuine shared patterns.
|
||||
5. Implement the page or component in maintainable Astro code.
|
||||
6. Compare the complete rendered page with the live public site at representative
|
||||
2. Resolve discrepancies in favor of the live public site.
|
||||
3. Record important visual details and identify genuine shared patterns.
|
||||
4. Implement the page or component in maintainable Astro code.
|
||||
5. Compare the complete rendered page with the live public site at representative
|
||||
desktop and mobile viewport widths.
|
||||
7. Fix material visual differences before marking it complete.
|
||||
6. Fix material visual differences before marking it complete.
|
||||
|
||||
Document intentional visual deviations and their reasons in
|
||||
`reports/migration-summary.md`.
|
||||
@@ -412,9 +389,6 @@ www/
|
||||
generate-redirects.mjs
|
||||
generate-sitemap.mjs
|
||||
|
||||
original/
|
||||
README.md
|
||||
|
||||
reports/
|
||||
url-inventory.csv
|
||||
asset-inventory.csv
|
||||
@@ -427,17 +401,10 @@ www/
|
||||
migration-summary.md
|
||||
```
|
||||
|
||||
The `original/README.md` file should explain that the raw source mirror lives outside the Astro project at:
|
||||
|
||||
```txt
|
||||
../www.azinstitute4autism.com
|
||||
```
|
||||
|
||||
Do not duplicate the entire raw mirror inside `./www` unless there is a specific reason.
|
||||
|
||||
## Initial inspection
|
||||
|
||||
Before creating or modifying files, inspect the mirror.
|
||||
Before creating or modifying files, inspect the live public site and current
|
||||
project sources.
|
||||
|
||||
Look for:
|
||||
|
||||
@@ -687,9 +654,8 @@ src/styles/rtl.css
|
||||
src/styles/global.css
|
||||
```
|
||||
|
||||
Extract the current site's visual language from the live public site, using the
|
||||
mirrored CSS and HTML as a convenient local aid after checking for discrepancies.
|
||||
Tokens must encode source values; they must not introduce a replacement visual
|
||||
Extract the current site's visual language from the live public site. Tokens
|
||||
must encode source values; they must not introduce a replacement visual
|
||||
system.
|
||||
|
||||
Use design tokens such as:
|
||||
@@ -837,7 +803,7 @@ It should support:
|
||||
- hreflang links where translation relationships are known
|
||||
- JSON-LD/schema when extracted
|
||||
|
||||
Preserve metadata from the mirror wherever possible.
|
||||
Preserve metadata from the live site wherever possible.
|
||||
|
||||
Generate:
|
||||
|
||||
@@ -906,7 +872,7 @@ tools/generate-sitemap.mjs
|
||||
|
||||
This script should:
|
||||
|
||||
- scan the mirror
|
||||
- scan the available source and generated output
|
||||
- identify HTML files
|
||||
- infer URL paths
|
||||
- identify page type
|
||||
@@ -929,7 +895,7 @@ This script should:
|
||||
|
||||
- attempt to crawl the live site if internet is available
|
||||
- discover URLs from sitemap and internal links
|
||||
- compare discovered URLs against the mirror
|
||||
- compare discovered URLs against the current site source and generated output
|
||||
- document missing URLs/assets
|
||||
- avoid aggressive crawling
|
||||
- respect the scope of `www.azinstitute4autism.com`
|
||||
@@ -1165,7 +1131,6 @@ www/README.md
|
||||
It should explain:
|
||||
|
||||
- what the project is
|
||||
- where the raw mirror lives
|
||||
- how the migration was performed
|
||||
- how to install dependencies
|
||||
- how to run local dev
|
||||
@@ -1241,7 +1206,7 @@ Proceed methodically:
|
||||
2. Read `CLAUDE.md`, if using Claude Code.
|
||||
3. Read this `MIGRATION_BRIEF.md`.
|
||||
4. Inspect the live public site.
|
||||
5. Inspect `./www.azinstitute4autism.com` and identify relevant discrepancies.
|
||||
5. Inspect the relevant live public site pages and identify discrepancies.
|
||||
6. Summarize a concise implementation plan.
|
||||
7. Scaffold Astro in `./www`.
|
||||
8. Build extraction/reporting scripts.
|
||||
|
||||
+1
-50
@@ -1,8 +1,7 @@
|
||||
# Arizona Institute for Autism Astro Site
|
||||
|
||||
Static Astro + TypeScript migration of the public Arizona Institute for Autism
|
||||
website. The read-only source mirror is located at
|
||||
`../www.azinstitute4autism.com`.
|
||||
website.
|
||||
|
||||
## Quick Start
|
||||
|
||||
@@ -23,9 +22,6 @@ http://localhost:4321
|
||||
The development server watches source files and refreshes the browser after
|
||||
edits. Stop it with `Ctrl+C`.
|
||||
|
||||
Do **not** run `npm run extract` during normal editing. Extraction regenerates
|
||||
migrated Markdown from the raw mirror and can overwrite editorial changes.
|
||||
|
||||
## Environment Setup
|
||||
|
||||
Requirements:
|
||||
@@ -322,51 +318,6 @@ Edit the component's `label`, `heading`, and `items` data in the post. Keep
|
||||
answer. Shared FAQ markup, styling, interaction, and schema generation live in
|
||||
`src/components/FAQAccordion.astro`.
|
||||
|
||||
## Mirror Extraction Workflow
|
||||
|
||||
The mirror is read-only source material. Never modify:
|
||||
|
||||
```txt
|
||||
../www.azinstitute4autism.com
|
||||
```
|
||||
|
||||
Only rerun extraction when intentionally refreshing migrated content from the
|
||||
mirror. Commit or back up editorial changes first.
|
||||
|
||||
Dependency-free extraction:
|
||||
|
||||
```sh
|
||||
npm run extract
|
||||
```
|
||||
|
||||
Full Cheerio/Turndown extraction:
|
||||
|
||||
```sh
|
||||
npm run extract:full
|
||||
```
|
||||
|
||||
After extraction:
|
||||
|
||||
```sh
|
||||
npm run extract:blog-footers
|
||||
npm run generate:sitemap
|
||||
npm run generate:redirects
|
||||
npm run build
|
||||
npm run audit:links
|
||||
npm run audit:images
|
||||
npm run audit:blog
|
||||
```
|
||||
|
||||
Extraction regenerates content files, copied assets, and inventories. Review
|
||||
the complete Git diff before accepting it. Extraction may recreate FAQ-bearing
|
||||
posts and CTA-bearing pages as Markdown; restore their `FAQAccordion` and
|
||||
`Button` MDX blocks before accepting the result. `npm run audit:blog` reports
|
||||
plain Markdown FAQ sections.
|
||||
|
||||
`npm run extract:blog-footers` preserves the extracted previous/next and
|
||||
similar-post relationships in `src/data/blog-footers.json`, then removes those
|
||||
footer fragments from article prose so `BlogPostFooter.astro` can render them.
|
||||
|
||||
## Reports And Utilities
|
||||
|
||||
Migration reports are stored in `reports/`.
|
||||
|
||||
@@ -1,10 +0,0 @@
|
||||
# Raw Source Mirror
|
||||
|
||||
The read-only wget mirror used for this migration lives outside this Astro
|
||||
project at:
|
||||
|
||||
```txt
|
||||
../www.azinstitute4autism.com
|
||||
```
|
||||
|
||||
Run `npm run extract` to regenerate content and inventories from that source.
|
||||
Reference in New Issue
Block a user