ahmido/TenantAtlas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
1ddbd28b65
TenantAtlas/specs/404-public-content-messaging/tasks.md
Ahmed Darrazi 1ddbd28b65
Some checks failed
PR Fast Feedback / fast-feedback (pull_request) Failing after 4m50s
Details
feat(website): refine public content messaging rollout
2026-05-25 15:32:02 +02:00

22 KiB
Raw Blame History

Tasks: Public Website Positioning & Content Architecture

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: This feature remains in the browser/static website lane. Reuse the existing Astro build, Playwright public smoke suite, targeted static claim scans, and manual browser review under /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website. Do not add Pest, Laravel, Filament, Livewire, database, Sail, Microsoft Graph, queue, job, policy, RBAC, or apps/platform coverage.

Phase 1: Setup

Purpose: Establish the exact website-only scope and current public-content baseline before editing.

  • T001 Confirm repo-truth inputs by reviewing /Users/ahmeddarrazi/Documents/projects/wt-website/package.json, /Users/ahmeddarrazi/Documents/projects/wt-website/pnpm-workspace.yaml, and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/package.json
  • T002 [P] Inventory homepage and platform content sources 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/pages/HomePage.astro, and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/PlatformPage.astro
  • T003 [P] Inventory navigation, footer, metadata, and localization surfaces in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/sections/navbar&footer/Navbar.astro, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/sections/navbar&footer/FooterSection.astro, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/layouts/MainLayout.astro, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/Meta.astro, and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/en
  • T004 [P] Inventory docs, placeholder collections, and supporting route content 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 current smoke coverage and forbidden-pattern guards 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

Phase 2: Foundational

Purpose: Normalize shared positioning, metadata, and validation rules before user-story work.

Critical: Complete this phase before user-story implementation.

  • T006 Define the shared policy-governance vocabulary, Microsoft 365 first phrasing, provider-extensible guardrails, and CTA intent rules in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts
  • T007 Normalize shared site title, base description, and route-level metadata defaults in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/constants.ts and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/Meta.astro
  • T008 Review and correct stale localized navigation helpers or route-link utilities in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/utils/navigation.ts and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/i18n.ts
  • T009 Refresh forbidden-pattern coverage and public-route expectations for policy-governance, provider, and trust guardrails in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/tests/smoke/smoke-helpers.ts and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/tests/smoke/public-routes.spec.ts
  • T010 Confirm the foundational scope still excludes /Users/ahmeddarrazi/Documents/projects/wt-website/apps/platform by checking from /Users/ahmeddarrazi/Documents/projects/wt-website

Checkpoint: Shared positioning rules, metadata defaults, and smoke guardrails are ready for independently testable story work.

Phase 3: User Story 1 - Recognize The Right Product Category (Priority: P1) MVP

Goal: A first-time visitor opens / and understands that Tenantial is a policy governance platform for Microsoft 365 and modern cloud environments, not an Intune-only utility.

Independent Test: Read the hero and the next homepage section without relying on internal product knowledge; the product is clearly described as policy governance with Microsoft 365 as the first focus.

  • T011 [US1] Rewrite homepage hero headline, body, supporting line, and primary/secondary CTA copy in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts
  • T012 [US1] Update homepage category-proof and first supporting-section copy so Microsoft 365 first and evidence-based governance are explicit in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts
  • T013 [US1] Add explicit audience messaging for MSPs and internal IT teams 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/components/pages/HomePage.astro
  • T014 [US1] Add a concrete end-of-homepage CTA with a real route or deliberate in-page target 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/components/pages/HomePage.astro
  • T015 [US1] Adapt homepage rendering to the new category, audience, and CTA copy without widening layout scope in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/HomePage.astro
  • T016 [P] [US1] Align supporting highlights and FAQ prompts with the new product category in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/features.json and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/faqs.json
  • T017 [US1] Validate User Story 1 against /Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/quickstart.md using the rendered homepage routes in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/index.astro and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/en/index.astro to confirm category framing, audience messaging, and terminal CTA intent

Checkpoint: User Story 1 is independently shippable as the MVP.

Phase 4: User Story 2 - Follow The Governance Operating Model (Priority: P1)

Goal: A buyer scrolls the homepage and understands how observed state becomes evidence, detection, review, decision, and audit trail.

Independent Test: Read homepage section titles and core summaries in order from top to bottom; the operating-model flow is clear and each section adds new meaning.

  • T018 [US2] Rewrite the homepage operating-model sequence and section summaries around observe, evidence, detect, review, decide, and audit in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts
  • T019 [US2] Update homepage section ordering and block composition for the new operating-model narrative in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/HomePage.astro
  • T020 [P] [US2] Refresh homepage capability cards for policy evidence, drift/change detection, governance reviews, controlled recovery, provider readiness, and decision traceability in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/features.json
  • T021 [P] [US2] Update the docs landing and intro narrative to reflect the same governance model in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/welcome-to-docs.mdx, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/guides/intro.mdx, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/en/welcome-to-docs.mdx, and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/en/guides/intro.mdx
  • T022 [US2] Validate User Story 2 against /Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/contracts/public-content-contract.md by reviewing the operating-model and capability sections in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/HomePage.astro

Checkpoint: User Story 2 is independently shippable once the homepage operating model reads coherently.

Phase 5: User Story 3 - Evaluate Provider Posture And Boundaries Safely (Priority: P2)

Goal: A security-conscious evaluator can see Microsoft 365 as the current focus, provider-extensible direction as future-safe, and clear boundaries about what the product is not.

Independent Test: Read the homepage and /platform; current Microsoft focus, future provider direction, and non-admin-center/non-helpdesk boundaries are all explicit without live-support claims for other providers.

  • T023 [US3] Rewrite the Microsoft 365 first section and provider/domain labeling rules in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts
  • T024 [US3] Update /platform copy to separate current Microsoft focus from future provider direction and to reinforce product boundaries in /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
  • T025 [P] [US3] Align public docs provider-boundary explanations with the same current-versus-future posture in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/platform/evidence-review.mdx, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/en/platform/evidence-review.mdx, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/guides/intro.mdx, and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/en/guides/intro.mdx
  • T026 [P] [US3] Review navigation and footer labels so route exposure stays honest for platform, docs, trust, pricing, and contact surfaces in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/sections/navbar&footer/Navbar.astro and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/sections/navbar&footer/FooterSection.astro
  • T027 [US3] Validate User Story 3 against /Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/contracts/public-content-contract.md by reviewing /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/platform.astro and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/index.astro

Checkpoint: User Story 3 is independently shippable once provider posture and boundaries are clear and safe.

Phase 6: User Story 4 - Trust The Site Without False Assurance (Priority: P2)

Goal: A DACH or enterprise evaluator reads the trust teaser, metadata, navigation, and CTA surfaces and sees conservative, honest claims.

Independent Test: Review /trust, /pricing, /contact, homepage trust surfaces, and metadata; there are no false assurance, placeholder-link, or autonomous-remediation claims.

  • T028 [US4] Rewrite the trust teaser, trust page copy, and trust-adjacent CTA language for conservative claims in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/site-copy.ts
  • T029 [US4] Update homepage, platform, pricing, and trust metadata to remove false assurance and preserve policy-governance wording in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/Meta.astro, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/layouts/MainLayout.astro, and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/constants.ts
  • T030 [P] [US4] Review conservative trust, contact-led evaluation, and legal-adjacent rendering in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/TrustPage.astro, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/PricingPage.astro, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/ContactPage.astro, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/LegalPage.astro, and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/TextPage.astro
  • T031 [P] [US4] Update docs and checklist content to avoid false provider/compliance/automation assurance in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/guides/getting-started.mdx, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/guides/first-project-checklist.mdx, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/en/guides/getting-started.mdx, and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/en/guides/first-project-checklist.mdx
  • T032 [US4] Update smoke and interaction expectations for trust-safe links, metadata, and placeholder-free CTAs 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
  • T033 [US4] Validate User Story 4 against /Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/quickstart.md and /Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/contracts/public-content-contract.md by reviewing /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/trust.astro, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/pricing.astro, and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/contact.astro

Checkpoint: User Story 4 is independently shippable once trust-sensitive surfaces remain honest and placeholder-free.

Final Phase: Polish And Cross-Cutting Concerns

Purpose: Complete localization parity, route exposure review, browser/static validation, and implementation handoff.

  • T034 [P] Review German default and English mirror parity for all changed marketing routes 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
  • T035 [P] Reconcile exposed docs/navigation and redirect behavior with the updated positioning contract in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/astro.config.mjs, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/product.astro, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/products/index.astro, and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/en/product.astro
  • T036 [P] Review dominant next-step CTA intent across the homepage, platform, pricing, trust, contact, footer, and exposed docs routes 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/sections/navbar&footer/Navbar.astro, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/sections/navbar&footer/FooterSection.astro, and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs
  • T037 [P] Run the targeted static claim scan from /Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/quickstart.md against /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/public
  • T038 Run website build validation from /Users/ahmeddarrazi/Documents/projects/wt-website with corepack pnpm build:website
  • T039 Run public smoke validation from /Users/ahmeddarrazi/Documents/projects/wt-website with WEBSITE_PORT=4321 corepack pnpm --filter @tenantatlas/website test:smoke
  • T040 Run whitespace validation from /Users/ahmeddarrazi/Documents/projects/wt-website with git diff --check
  • T041 Run scope validation from /Users/ahmeddarrazi/Documents/projects/wt-website with git status --short -- apps/platform
  • T042 Perform the manual desktop/mobile browser review described in /Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/quickstart.md for /, /platform, /pricing, /trust, /contact, and exposed docs routes
  • T043 Prepare the final implementation handoff with changed surfaces, provider/trust guardrail decisions, validation results, follow-up specs, and apps/platform untouched confirmation from /Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/plan.md

Dependencies

Phase Dependencies

Setup must complete before Foundational. Foundational must complete before any user story. User Stories 1 and 2 are the P1 path and should land before provider/trust refinement. User Story 3 depends on the shared category and operating-model vocabulary from earlier phases. User Story 4 depends on the shared provider, CTA, metadata, and navigation decisions so trust-safe wording does not drift from the rest of the site.

User Story Dependencies

  • US1: Depends on Phase 2 only.
  • US2: Depends on Phase 2 and benefits from US1 category vocabulary.
  • US3: Depends on Phase 2 and benefits from US1-US2 shared narrative.
  • US4: Depends on Phase 2 and benefits from US1-US3 provider, metadata, and navigation decisions.

MVP Scope

Complete Phase 1, Phase 2, and Phase 3 (US1) for the smallest independently reviewable increment. Phase 4 (US2) is the immediate next increment once the product category is fixed.

Parallel Execution Examples

After Phase 2

US1 supporting-surface work can run in parallel after the main homepage copy settles:
- T015 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/HomePage.astro
- T016 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/features.json and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/faqs.json

US2 operating-model support work can run in parallel once the sequence is defined:
- T020 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files/features.json
- T021 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/welcome-to-docs.mdx and related intro mirrors

Provider And Trust

US3 and US4 can progress on different files once shared vocabulary is stable:
- T025 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/platform/evidence-review.mdx and related mirrors
- T030 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/pages/TrustPage.astro, PricingPage.astro, ContactPage.astro, LegalPage.astro, and TextPage.astro
- T031 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs/guides/getting-started.mdx and related checklist mirrors

Final Validation

Cross-cutting closeout can run in parallel before the final command sequence:
- T034 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
- T035 in /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/astro.config.mjs and redirect route files
- T036 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/sections/navbar&footer/Navbar.astro, /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/sections/navbar&footer/FooterSection.astro, and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs
- T037 from /Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging/quickstart.md against /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src and /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/public

Implementation Strategy

  1. Finish setup and foundational vocabulary/metadata/smoke guardrails before page-level rewrites.
  2. Ship the MVP by fixing homepage category framing in US1.
  3. Layer the operating-model narrative in US2 before broadening provider posture in US3.
  4. Complete trust-safe metadata, docs, and CTA coverage in US4 after the shared category and provider story settle.
  5. Finish with localization parity, route-exposure review, static claim scans, build, smoke, manual browser review, and scope validation.

Test Governance Notes

The declared test purpose is Browser/static website. The affected validation lanes are website build, Playwright public smoke, targeted static claim scans, manual browser 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 release validation becomes a recurring governance problem.