ahmido
44e472ec18
## Summary - refresh website copy and structured content datasets - update docs content in EN and default locales - adjust website UI auth-related components and smoke tests - add Spec Kit artifacts for feature 404 public content messaging ## Validation - committed and pushed from branch `404-public-content-messaging` ## Target - base branch: `website-dev` Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #396
22 KiB
Tasks: apps/website Public Content Architecture & Messaging
Input: Design documents from /Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/
Prerequisites: plan.md, spec.md, research.md, data-model.md, public-content-contract.md, quickstart.md
Tests: No new test family is required by Spec 404. Use existing website build and Playwright public smoke validation; update smoke expectations only where implementation changes make the existing checks incomplete. Do not add Pest, Laravel, Filament, Livewire, database, Sail, Microsoft Graph, queue, job, policy, RBAC, or apps/platform test coverage.
Phase 1: Setup
Purpose: Establish the website-only scope and current public content baseline before editing.
- T001 Confirm current git scope and verify
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/platformis untouched by runninggit status --short -- apps/platformfrom/Users/ahmeddarrazi/Documents/projects/wt-website - T002 [P] Inventory homepage and product-route content sources in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/HomePage.astro,/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/PlatformPage.astro, and/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T003 [P] Inventory pricing, trust, contact, and legal-adjacent content sources in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/PricingPage.astro,/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/TrustPage.astro,/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/ContactPage.astro, and/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T004 [P] Inventory exposed docs and placeholder collections in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs,/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/blog,/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/insights, and/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/products - T005 [P] Inventory CTA, navigation, footer, metadata, and smoke-validation surfaces in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/utils/navigation.ts,/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/sections/navbar&footer/FooterSection.astro,/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/Meta.astro, and/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/tests/smoke
Phase 2: Foundational
Purpose: Normalize shared website copy rules before story-specific page edits.
Critical: Complete this phase before user-story implementation.
- T006 Define the normalized primary and secondary CTA intent rules for German default and English mirror copy in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T007 Normalize shared site tagline, short description, navigation labels, and footer conversation wording for evidence-first Microsoft tenant governance in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T008 Remove or rewrite public copy that implies unavailable login, signup, checkout, account creation, self-serve billing, subscription, automated scheduling, newsletter, or guaranteed backend submission workflows in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T009 Review and update forbidden residue or unsupported-claim smoke expectations for Spec 404 content terms in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/tests/smoke/smoke-helpers.tsand/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/tests/smoke/public-routes.spec.ts - T010 Confirm foundational edits still leave
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/platformuntouched by runninggit status --short -- apps/platformfrom/Users/ahmeddarrazi/Documents/projects/wt-website
Checkpoint: Shared website messaging and CTA guardrails are ready for independently testable user-story work.
Phase 3: User Story 1 - Understand The Product Category (Priority: P1) MVP
Goal: A first-time visitor opens / and understands that Tenantial is an evidence-first governance product for Microsoft tenant configuration.
Independent Test: Read the homepage hero and first two homepage sections without relying on visuals; the product category and at least three core concepts are clear.
- T011 [US1] Rewrite homepage hero title, supporting copy, primary CTA, secondary CTA, and metadata for product-category clarity in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T012 [US1] Rewrite homepage first product section copy to mention backup, restore, drift, findings, evidence, auditability, exceptions, and reviews without unsupported guarantees in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T013 [P] [US1] Review homepage hero and first-section rendering so the updated copy is used without layout redesign in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/HomePage.astro - T014 [P] [US1] Align homepage feature labels and FAQ entry points with the evidence-first category message in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/features.jsonand/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/faqs.json - T015 [US1] Validate User Story 1 by reviewing
/against/Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/quickstart.md
Checkpoint: User Story 1 is independently shippable as the MVP.
Phase 4: User Story 2 - Follow A Clear Website Narrative (Priority: P1)
Goal: A buyer scrolls the homepage and sees a deliberate narrative from problem to model to capability to evaluation.
Independent Test: Copy homepage headings and subheadings into a plain-text outline; the sequence tells a coherent story without repeated claims.
- T016 [US2] Reorder or rewrite homepage section intent copy from category to problem to operating model to capability proof to evaluation in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T017 [US2] Adjust homepage component sequencing only as needed to support the revised narrative without broad layout redesign in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/HomePage.astro - T018 [P] [US2] Rewrite homepage workflow tab headings and body copy so each tab adds distinct meaning in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T019 [P] [US2] Confirm homepage evaluation section copy remains calm and contact-led while supporting the narrative handoff in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.tsand/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/sections/pricing/PricingSection.astro - T020 [US2] Validate User Story 2 by reviewing homepage heading order and section repetition against
/Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/contracts/public-content-contract.md
Checkpoint: User Story 2 is independently shippable once the homepage narrative reads coherently.
Phase 5: User Story 3 - Explain The Public Product Model On /platform (Priority: P1)
Goal: A visitor opens /platform and understands Tenantial's public product model in more detail than the homepage.
Independent Test: Read /platform without using admin/platform code as a source; backup, restore, drift, findings, evidence, auditability, exceptions, and reviews are explained as one operating model.
- T021 [US3] Rewrite
/platformpage heading, subtitle, backup, drift, restore, and boundary copy for one public operating model in/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T022 [US3] Ensure
/platformrenders the deeper product-model copy without importing from or referencing/Users/ahmeddarrazi/Documents/projects/wt-website/apps/platformin/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/PlatformPage.astro - T023 [P] [US3] Tighten static/demo preview framing and alt text for platform product previews in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T024 [P] [US3] Review public docs product-model explanations for alignment with
/platformin/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/platform/evidence-review.mdxand/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/guides/intro.mdx - T025 [US3] Validate User Story 3 by reviewing
/platformagainst/Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/contracts/public-content-contract.md
Checkpoint: User Story 3 is independently shippable once /platform communicates the public product model safely.
Phase 6: User Story 4 - Present Conservative Evaluation And Pricing Language (Priority: P2)
Goal: A buyer reads /pricing and homepage evaluation copy and understands that commercial packaging is scoped and contact-led.
Independent Test: Read pricing and evaluation copy; there are no checkout, subscription activation, instant onboarding, self-serve billing, or unsupported entitlement claims.
- T026 [US4] Rewrite pricing intro heading, subtitle, title, badges, and metadata as conservative evaluation language in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T027 [US4] Rewrite pricing package names, descriptions, feature lists, button labels, and target links to avoid fake fixed entitlements or purchase claims in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.tsand/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/pricing.json - T028 [P] [US4] Confirm pricing rendering does not add checkout, subscription, billing, account creation, or unsupported plan semantics in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/PricingPage.astroand/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/sections/pricing/PricingSection.astro - T029 [P] [US4] Confirm homepage evaluation copy uses the same contact-led commercial posture in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/HomePage.astro - T030 [US4] Validate User Story 4 by reviewing
/pricingand homepage evaluation copy against/Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/contracts/public-content-contract.md
Checkpoint: User Story 4 is independently shippable once commercial copy is conservative and contact-led.
Phase 7: User Story 5 - Build Trust Without Fake Proof (Priority: P2)
Goal: A security-conscious buyer reads trust, FAQ, legal-adjacent, and footer copy and sees clear conservative trust positioning.
Independent Test: Read /trust, FAQ, legal-adjacent copy, docs, and footer statements; unsupported certifications, endorsements, customer proof, uptime, recovery, and compliance guarantees do not appear.
- T031 [US5] Rewrite trust page heading, subtitle, CTA, stats, and metadata to explain claim boundaries without fake proof in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T032 [P] [US5] Rewrite FAQ answers for conservative restore, audit, compliance, Microsoft, preview, and evidence language in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/faqs.json - T033 [P] [US5] Review legal, privacy, terms, and imprint copy for unsupported claims or placeholder residue in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/LegalPage.astro,/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/TextPage.astro, and/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T034 [P] [US5] Rewrite exposed docs content that is not intentionally Tenantial-specific or hide unready docs from public navigation in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docsand/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/astro.config.mjs - T035 [US5] Validate User Story 5 by scanning
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/srcfor forbidden proof and residue terms listed in/Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/quickstart.md
Checkpoint: User Story 5 is independently shippable once trust-sensitive public copy is proof-safe.
Phase 8: User Story 6 - Normalize CTA Language (Priority: P3)
Goal: A visitor sees consistent CTA language across homepage, platform, pricing, trust, docs, contact, navigation, and footer.
Independent Test: List all visible CTA labels and targets; every label maps to a supported buyer intent and every target resolves intentionally.
- T036 [US6] Normalize primary and secondary CTA labels across homepage, platform, pricing, trust, contact, docs, navigation, and footer copy in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts - T037 [US6] Verify navigation and footer links use only intentional route targets and no placeholder social URLs in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/utils/navigation.tsand/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/sections/navbar&footer/FooterSection.astro - T038 [P] [US6] Reframe contact page form labels and instructions so they prepare a contact request without implying backend submission or automated scheduling in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.tsand/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/ContactPage.astro - T039 [P] [US6] Review docs navigation and in-page links for consistent CTA intent and intentional targets in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs - T040 [US6] Validate User Story 6 by checking public CTA targets and
href="#"placeholders in/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src
Checkpoint: User Story 6 is independently shippable once CTA language and targets are consistent.
Final Phase: Polish And Cross-Cutting Concerns
Purpose: Complete public content validation, smoke checks, and handoff.
- T041 [P] Update route titles, route descriptions, Open Graph summaries, and public metadata affected by the revised copy in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts,/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/Meta.astro, and/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/ui/starlight/Head.astro - T042 [P] Review German default and English mirror copy for content parity and claim safety in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.tsand/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/en - T043 [P] Review sitemap, robots, redirect, and noindex behavior remains aligned with Spec 403 in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/astro.config.mjs,/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/robots.txt.ts, and/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages - T044 [P] Update Playwright public smoke expectations only for changed public content, CTA, residue, metadata, or route behavior in
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/tests/smoke/smoke-helpers.ts,/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/tests/smoke/public-routes.spec.ts, and/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/tests/smoke/interaction.spec.ts - T045 Run build validation from
/Users/ahmeddarrazi/Documents/projects/wt-websitewithcorepack pnpm build:website - T046 Run public smoke validation from
/Users/ahmeddarrazi/Documents/projects/wt-websitewithWEBSITE_PORT=4321 corepack pnpm --filter @tenantatlas/website test:smoke - T047 Run whitespace validation from
/Users/ahmeddarrazi/Documents/projects/wt-websitewithgit diff --check - T048 Run scope validation from
/Users/ahmeddarrazi/Documents/projects/wt-websitewithgit status --short -- apps/platform - T049 Prepare the final implementation handoff in the PR or final response with changed pages, docs surfaces, CTA language decisions, claim-safety decisions, metadata changes, validation results, remaining content follow-ups, and
apps/platformuntouched confirmation from/Users/ahmeddarrazi/Documents/projects/wt-website
Dependencies
Phase Dependencies
Setup must complete before Foundational. Foundational must complete before any user story. User Stories 1, 2, and 3 are all P1 and can proceed after Foundational, with US2 benefiting from the US1 homepage category vocabulary. User Stories 4 and 5 can proceed after Foundational and can run in parallel with each other once shared claim vocabulary is stable. User Story 6 should run after the main page copy decisions so CTA language can be normalized across all surfaces.
User Story Dependencies
- US1: Depends on Phase 2 only.
- US2: Depends on Phase 2 and benefits from US1 wording.
- US3: Depends on Phase 2 only.
- US4: Depends on Phase 2 and pricing/evaluation vocabulary from foundational tasks.
- US5: Depends on Phase 2 and claim-safety vocabulary from foundational tasks.
- US6: Depends on US1-US5 copy decisions across public pages and docs.
MVP Scope
Complete Phase 1, Phase 2, and Phase 3 (US1) for the smallest independently reviewable increment.
Parallel Execution Examples
After Phase 2
US1 can update homepage category copy:
- T011 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts
- T013 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/HomePage.astro
US3 can update product-model copy:
- T021 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts
- T024 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/platform/evidence-review.mdx
Pricing And Trust
US4 pricing work:
- T027 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/pricing.json
- T028 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/PricingPage.astro and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/sections/pricing/PricingSection.astro
US5 trust work:
- T032 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/faqs.json
- T034 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs
Final Validation
Cross-cutting review can run in parallel before final commands:
- T041 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/Meta.astro and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/ui/starlight/Head.astro
- T042 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/en
- T043 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/astro.config.mjs and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/robots.txt.ts
Implementation Strategy
- Finish setup and foundational copy guardrails before page-level rewrites.
- Ship the MVP with US1 homepage product-category clarity.
- Complete US2 homepage narrative and US3
/platformproduct-model copy before final CTA normalization. - Complete US4 pricing/evaluation and US5 trust/FAQ/legal/docs proof-safety in parallel where files do not overlap.
- Complete US6 CTA normalization after page copy settles.
- Finish with metadata, localized mirror review, smoke expectations, build, public smoke, whitespace, and
apps/platformscope validation.
Test Governance Notes
The declared test purpose is Browser/static website. The affected validation lanes are website build, Playwright public smoke, manual browser/content review, whitespace validation, and apps/platform scope validation. No Pest, Laravel, Filament, Livewire, database, provider, workspace, membership, session, queue, Sail, or heavy-governance setup is introduced. No dedicated follow-up spec is needed unless repeated public-website content validation becomes a recurring release governance problem.