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
154 lines
4.9 KiB
Markdown
154 lines
4.9 KiB
Markdown
# Quickstart: Spec 404 Public Content Architecture & Messaging
|
|
|
|
## Scope
|
|
|
|
Work only in:
|
|
|
|
```bash
|
|
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/website
|
|
/Users/ahmeddarrazi/Documents/projects/wt-website/specs/404-public-content-messaging
|
|
```
|
|
|
|
Do not touch:
|
|
|
|
```bash
|
|
/Users/ahmeddarrazi/Documents/projects/wt-website/apps/platform
|
|
```
|
|
|
|
## Install Dependencies If Needed
|
|
|
|
```bash
|
|
cd /Users/ahmeddarrazi/Documents/projects/wt-website && corepack pnpm install
|
|
```
|
|
|
|
## Run The Website Locally
|
|
|
|
```bash
|
|
cd /Users/ahmeddarrazi/Documents/projects/wt-website && WEBSITE_PORT=4321 corepack pnpm dev:website
|
|
```
|
|
|
|
Open:
|
|
|
|
```text
|
|
http://127.0.0.1:4321
|
|
```
|
|
|
|
## Read-Only Content Audit
|
|
|
|
Review public content sources before editing:
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
cd /Users/ahmeddarrazi/Documents/projects/wt-website && corepack pnpm build:website
|
|
```
|
|
|
|
## Smoke Validation
|
|
|
|
```bash
|
|
cd /Users/ahmeddarrazi/Documents/projects/wt-website && WEBSITE_PORT=4321 corepack pnpm --filter @tenantatlas/website test:smoke
|
|
```
|
|
|
|
## Static Git Validation
|
|
|
|
```bash
|
|
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
|