ahmido/TenantAtlas
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity
44e472ec18
TenantAtlas/specs/404-public-content-messaging/quickstart.md
ahmido 44e472ec18 feat(website): finalize public content messaging updates (#396) 
## 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
2026-05-24 23:06:38 +00:00

4.9 KiB
Raw Blame History

Quickstart: Spec 404 Public Content Architecture & Messaging

Scope

Work only in:

/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website
/Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging

Do not touch:

/Users/ahmeddarrazi/Documents/projects/wt-website/apps/platform

Install Dependencies If Needed

cd /Users/ahmeddarrazi/Documents/projects/wt-website && corepack pnpm install

Run The Website Locally

cd /Users/ahmeddarrazi/Documents/projects/wt-website && WEBSITE_PORT=4321 corepack pnpm dev:website

Open:

http://127.0.0.1:4321

Read-Only Content Audit

Review public content sources before editing:

cd /Users/ahmeddarrazi/Documents/projects/wt-website
rg -n "Tenantial|TenantAtlas|TenantPilot|TenantCTRL|ScrewFast|construction|hardware|manufacturing|trusted by|SOC 2|ISO|uptime|checkout|subscribe|sign up|login" apps/website/src

Audit these content surfaces:

  • /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/index.astro
  • /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/platform.astro
  • /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/pricing.astro
  • /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/trust.astro
  • /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/pages/contact.astro
  • /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/content/docs
  • /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/data_files
  • /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/utils/navigation.ts
  • /Users/ahmeddarrazi/Documents/projects/wt-website/apps/website/src/components/Meta.astro

Content Review Checklist

For the homepage:

  • hero identifies Tenantial as evidence-first governance for Microsoft tenant configuration
  • first two sections mention at least three of backup, restore, drift, findings, evidence, audit trail, exceptions, and reviews
  • headings read as a coherent story from product category to evaluation
  • each section adds new meaning
  • CTAs match buyer stage and route intentionally

For /platform:

  • explains backup, restore, drift, findings, evidence, auditability, exceptions, and reviews as one model
  • stays public and does not cite apps/platform
  • frames previews as static/demo/illustrative where needed
  • does not imply live Microsoft tenant connection or Graph execution

For pricing/evaluation:

  • contact-led and scoped
  • no checkout, subscription activation, self-serve billing, account creation, or unsupported entitlement claims
  • CTAs resolve to /contact or another intentional target

For trust/FAQ/footer/legal-adjacent content:

  • no unsupported SOC 2, ISO, Microsoft endorsement, uptime, recovery, compliance, or customer-proof claims
  • no fake customer logos, testimonials, or "trusted by" claims
  • no public website live-tenant-data implication
  • no newsletter, login, scheduling, or backend submission implication unless implemented

Build Validation

cd /Users/ahmeddarrazi/Documents/projects/wt-website && corepack pnpm build:website

Smoke Validation

cd /Users/ahmeddarrazi/Documents/projects/wt-website && WEBSITE_PORT=4321 corepack pnpm --filter @tenantatlas/website test:smoke

Static Git Validation

cd /Users/ahmeddarrazi/Documents/projects/wt-website && git diff --check
cd /Users/ahmeddarrazi/Documents/projects/wt-website && git status --short -- apps/platform

The apps/platform command must print no output.

Manual Browser Review

Review these routes in desktop and mobile widths, light and dark modes:

  • /
  • /platform
  • /pricing
  • /contact
  • /trust
  • /legal
  • /privacy
  • /terms
  • /imprint
  • /welcome-to-docs/
  • /guides/intro/
  • /guides/getting-started/
  • /guides/first-project-checklist/
  • /platform/evidence-review/

Check:

  • product category is clear from the homepage hero and first sections
  • homepage headings form a coherent narrative
  • /platform explains the product model more deeply than the homepage
  • pricing remains conservative and contact-led
  • trust copy avoids unsupported proof
  • CTAs are consistent and targets are intentional
  • no href="#" placeholders are visible or emitted
  • no forbidden public residue terms appear in visible copy or metadata
  • static product previews are framed as illustrative/static/demo content where needed
  • keyboard users can reach navigation, CTAs, footer links, FAQ controls, and visible controls
  • visible focus states are present
  • no body-level horizontal overflow occurs
  • reduced-motion mode leaves content understandable

Handoff

Implementation summary must document:

  • changed public pages and docs surfaces
  • CTA language decisions
  • claim-safety decisions
  • metadata changes
  • validation results
  • remaining content follow-ups
  • apps/platform untouched confirmation