bmr_bluecap/bcs-website
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
bcs-website/docs/content-deviations.md
Brad Rodgers fc64909f3d
All checks were successful
CI / ci (push) Successful in 1m56s
Details
docs: reconcile to as-built (ADR-0008, deploy runbook); clean text hero on detail pages 
- ADR-0008: private package, External-Secrets pull over public HTTPS (no k3s restart);
  CI auth via CI_TOKEN PAT; Playwright dropped from CI. Marks ADR-0007 partially superseded.
- gitops-deployment-strategy + deployment.md updated to as-built flow + operate/troubleshoot runbook
- content-deviations: detail-page heroes are text-only (no image)
- service/focus detail pages: clean text hero (drop shared photo/icon)
2026-07-20 08:27:35 -04:00

5.3 KiB
Raw Permalink Blame History

Content Deviations

Intentional differences between the live WordPress site (docs/live-site-content-inventory.md) and the Astro rebuild, logged per the parity plan. Updated 2026-07-15 after the copy migration to Markdown collections (ADR-0002).

Service & focus-area detail pages — exact copy restored

  • The 8 service detail pages and 4 focus-area detail pages now carry verbatim live-site copy in src/content/services/*.md and src/content/focus-areas/*.md. Each service page: H1 (service name) → H2 (exact tagline) → the exact three body paragraphs, matching the live structure.
  • Removed invented content from the earlier rebuild: the paraphrased sections[] sub-headings and the "Typical outputs" / outcomes[] lists were not present on the live site and have been dropped to honor the no-invention rule. They may return later as owner-approved "Typical outputs" modules (parity plan Phase 5).
  • Focus-area detail pages use the exact single paragraph from the homepage "Our Core Focus Areas" section — the only live copy that exists for these (the live /focus-areas/ page is empty). No additional copy was invented.

Detail-page heroes — no hero image (2026-07-17)

  • Service and focus-area detail pages use a clean text hero (eyebrow + title), no hero image. This matches the originals, which had no hero photo on those pages. An interim version put a shared photo (looked repetitive) then the per-service 64px icon (too small / orphaned) — both rejected; the text hero is the final call. Service icons remain on the /services/ overview cards, at their intended small size. The /services/, /focus-areas/, and About pages keep their real photos.

Metadata (not visible body copy)

  • SEO meta descriptions (description frontmatter, 120–158 chars) are newly written marketing metadata, not live body copy. Paraphrase is acceptable for meta descriptions; they are enforced by the Zod schema (ADR-0003).
  • summary frontmatter reuses the exact live /services/ overview paragraph (services) and the exact homepage focus paragraph (focus areas); it drives the overview and homepage cards.

Typography

  • Curly apostrophes/quotes from WordPress were normalized to straight apostrophes in the Markdown bodies (e.g., "client's" not "client's"). Meaning and wording are unchanged.

Homepage — exact copy restored (2026-07-15)

  • src/pages/index.astro now carries exact live copy: hero paragraph, the full "How We Work" section (intro + Increasing the Supply of Capital + Bridging Supply and Demand + Cultivating Capital-Ready Initiatives incl. the "step in as sponsor" paragraph), the About teaser, the four metrics (27 Years / $10+ billion / $3.5+ billion / 275+ Projects and Initiatives, with exact supporting text), and the Core Focus Areas intro.
  • Additive (not live copy): the "Our Services" section keeps a short connective subhead + intro sentence (the live homepage lists only service titles). No fabricated claims.
  • Default OG / hero fallback images repointed to real photos (img_0067); the contact hero uses img_0058. The four generic placeholder images were deleted from public/assets/.
  • Omitted defect: the live "Follow Our Quest" lorem-ipsum block remains removed.
  • H1 wording is exact; live renders RESTORATION/PRESERVATION/RESPONSIBLE USE in all-caps, the rebuild uses sentence case (typographic only).

About Us — exact copy restored + migrated to Markdown (2026-07-15)

  • Migrated to src/content/pages/about.md (ADR-0002) with verbatim copy for all ten sections and every paragraph. The sticky in-page nav is derived from the h2 headings (restores the live anchor nav). The live "andrestore" typo is corrected to "and restore".
  • Added hero heading ("Finance, innovation, and stewardship…") — the live About page has no hero heading; this is an additive structural heading, not body copy.

Imagery — real live-site assets imported (2026-07-15)

  • Real assets downloaded to public/assets/live-site/ (+ /icons). The real logo replaced the placeholder public/assets/bluecap-logo.png. Homepage hero (img_0067), homepage About band (img_0053), About hero (img_0062), Services hero (img_0075), Focus/detail heroes (img_0070) now use real photography. The 8 service cards render their real icons (decorative, aria-hidden).
  • IMG_0075.webp was JPEG-mislabeled on the live site; saved as img_0075.jpg.

About Us imagery — interleaved (2026-07-15)

  • Eight real live-site photos are now interleaved through the About sections (img1, img_0055, img_0054, img_0072, img_0053, img_0058, img_0075, img_0070), plus img_0062 as the hero — matching the live page's ~9-photo visual rhythm. Alt text is descriptive (live alts were empty). Order approximates the live placement; exact per-section pairing is best-effort.

Known placeholders / not-yet-restored (tracked in parity-checklist.md)

  • In-body About images are referenced by URL from Markdown, so they ship without intrinsic width/height (minor CLS); revisit if a Lighthouse CLS budget requires it.
  • Per-page 1200×630 OG images (SEO plan §2) still to be generated; pages currently share the img_0067 default.
  • Contact/defect items unchanged (see bcs-website-owner-decisions).