129 lines
7.2 KiB
Markdown
129 lines
7.2 KiB
Markdown
# UT-PUB-07 — Brand Language Remediation (Sitewide Copy)
|
||
|
||
## Status
|
||
Ready for Dev
|
||
|
||
## Story
|
||
As a site visitor,
|
||
I want clear, human, no‑nonsense copy without buzzwords or hype,
|
||
so that I can understand services and artists quickly without feeling marketed to.
|
||
|
||
## Acceptance Criteria
|
||
1. Given I visit key public pages (/, /artists, /gift-cards, /services, /specials),
|
||
When I read the visible copy,
|
||
Then no disallowed phrases or hype terms appear per docs/united_tattoo_brand_language_guidelines.md, and revised copy matches the guidelines’ tone and examples.
|
||
|
||
2. Given the SEO metadata (app/layout.tsx),
|
||
When I review the meta description,
|
||
Then it uses plain language with no hype words (e.g., “stunning”, “exceptional”), following the guidelines.
|
||
|
||
3. Given artist bios and marketing blurbs (data/artists.ts),
|
||
When I read bios,
|
||
Then language is concrete and justified (years, specialties, examples), with no absolute superlatives (e.g., “powerhouse”, “unparalleled”, “next‑level results”).
|
||
|
||
4. Given a brand‑language lint test is added to CI,
|
||
When the test runs on PR,
|
||
Then it fails if disallowed phrases are introduced anywhere under app/, components/, data/ and passes after remediation.
|
||
|
||
5. Given the guidelines require Grade‑7 reading level as a standard,
|
||
When I spot‑check revised copy with a readability tool,
|
||
Then copy approximates Grade‑7 or lower (short sentences, concrete nouns/verbs) and avoids abstract metaphors.
|
||
|
||
## Tasks / Subtasks
|
||
- [ ] Apply copy rewrites in components (AC: 1)
|
||
- [ ] components/artists-page-section.tsx
|
||
Replace: “Our exceptional team… unique expertise and artistic vision… your perfect tattoo.”
|
||
With: “Meet our artists. See their work and specialties. We’ll match you to the right artist for what you want.”
|
||
- [ ] components/artists-grid.tsx
|
||
Replace: “talented… unique style… create your perfect tattoo.”
|
||
With: “Browse artists by style and experience. Pick the one whose work matches what you want.”
|
||
- [ ] components/gift-cards-page.tsx
|
||
Replace: “Give the gift of exceptional tattoo artistry. Perfect for …”
|
||
With: “Give a tattoo gift card. Good for any service. Never expires.”
|
||
- [ ] components/services-section.tsx
|
||
Replace: “Transform… into stunning new pieces… bold blackout designs.”
|
||
With: “Cover‑ups and blackout. We design a new piece to cover the old one. Free consult to pick the best approach.”
|
||
- [ ] components/services-mobile-carousel.tsx and components/services-mobile-only.tsx
|
||
Mirror the services‑section rewrite above.
|
||
- [ ] components/specials-page.tsx
|
||
Replace “Perfect for first‑time clients” / “Perfect gifts …”
|
||
With: “Good for first‑time clients” / “Good gift for anyone who wants a tattoo.”
|
||
- [ ] components/artist-portfolio.tsx (marketing blurbs only; authentic client quotes may remain as quotes)
|
||
Replace hype (“powerhouse”, “exceptional”, “next‑level results”)
|
||
With concrete: “22+ years. Focus: cover‑ups, makeovers, illustrative work. See recent cover‑ups in the portfolio.”
|
||
|
||
- [ ] Normalize artist bios (AC: 3)
|
||
- [ ] data/artists.ts — Christy
|
||
Replace: “powerhouse… exceptional… next‑level results… name you trust… creativity and expertise thrive”
|
||
With: “22+ years. Cover‑ups, makeovers, illustrative designs. Based in Fountain/Colorado Springs. See cover‑up examples.”
|
||
- [ ] data/artists.ts — Donovan
|
||
Replace: “unparalleled passion and creativity”
|
||
With: “Bold illustrative work with fine detail. See recent pieces.”
|
||
- [ ] data/artists.ts — Heather
|
||
Replace: “unmatched artistry… turns skin into stunning, wearable art”
|
||
With: “Vibrant watercolor and embroidery‑style designs. Portfolio shows healed results.”
|
||
- [ ] data/artists.ts — Other entries
|
||
Remove/replace “perfect”, “exceptional”, “stunning”, “trusted name/name you trust”, “next‑level”, “powerhouse”, “thrive(s)”. Use concrete facts (years, styles, favorite subjects) and link to work.
|
||
|
||
- [ ] SEO meta description (AC: 2)
|
||
- [ ] app/layout.tsx
|
||
Replace: “explore stunning tattoo portfolios”
|
||
With: “Browse artists’ portfolios and book with the artist you want.”
|
||
|
||
- [ ] Add brand‑language lint tests (AC: 4)
|
||
- [ ] Create __tests__/content/brand-language-lint.test.ts
|
||
Fails on banned patterns (regex: “exceptional|unique|perfect|world[- ]class|cutting[- ]edge|unparalleled|next[- ]level|powerhouse|trusted name|name you trust|premium experience|seamless experience|unforgettable|thrive[s]?|elevat\w+|stunning|incredible|exceeded all my expectations”).
|
||
Scope: scan text content of app/, components/, data/.
|
||
- [ ] Wire test in CI (existing Vitest runs): ensure it executes with the rest.
|
||
- [ ] Document how to extend the banned list from docs/united_tattoo_brand_language_guidelines.md.
|
||
|
||
- [ ] Spot readability checks (AC: 5)
|
||
- [ ] Run a quick readability check (manual or script) on changed files; shorten or simplify where needed (Grade‑7 target).
|
||
- [ ] Ensure sentences are short; replace abstract phrasing with concrete (sizes, hours, examples).
|
||
|
||
- [ ] Regression & QA
|
||
- [ ] Visual check of updated pages for layout shifts after copy changes (line wraps, responsiveness at sm/md/lg).
|
||
- [ ] Verify no snapshot or RTL tests fail due to text changes (update snapshots where intended).
|
||
- [ ] Confirm no banned phrases remain (re-run search and tests).
|
||
|
||
## Dev Notes
|
||
Authoritative source:
|
||
- docs/united_tattoo_brand_language_guidelines.md (Version 1.0)
|
||
|
||
Remediation scope (from prior audit):
|
||
- components: artists-page-section.tsx, artists-grid.tsx, gift-cards-page.tsx, services-section.tsx, services-mobile-carousel.tsx, services-mobile-only.tsx, specials-page.tsx, artist-portfolio.tsx (marketing blurbs)
|
||
- data: data/artists.ts (bios and detail lists)
|
||
- app: app/layout.tsx (SEO description)
|
||
|
||
Guidelines to enforce:
|
||
- No hype/buzzwords; plain speaking; justified confidence only
|
||
- Concrete facts over abstract claims
|
||
- Grade‑7 reading level target; short sentences, contractions OK
|
||
- Authentic client quotes can remain as quotes (not repeated as brand claims)
|
||
|
||
## Testing
|
||
- Vitest: brand‑language‑lint.test.ts ensures banned phrases absent in text sources
|
||
- RTL/component: update any snapshots impacted by copy changes
|
||
- Manual: readability spot‑checks; cross‑device text wrap checks
|
||
|
||
## Change Log
|
||
| Date | Version | Description | Author |
|
||
|------------|---------|-------------------------------------------|---------------|
|
||
| 2025-09-20 | 0.1 | Initial draft of PUB‑07 remediation story | Scrum Master |
|
||
|
||
## Dev Agent Record
|
||
### Agent Model Used
|
||
<!-- dev-agent: record model/version used during implementation -->
|
||
|
||
### Debug Log References
|
||
<!-- dev-agent: link to any debug logs or traces generated -->
|
||
|
||
### Completion Notes List
|
||
<!-- dev-agent: notes about completion, issues encountered, resolutions -->
|
||
|
||
### File List
|
||
<!-- dev-agent: list all files created/modified/affected during implementation -->
|
||
|
||
## QA Results
|
||
<!-- qa-agent: append review results and gate decision here -->
|