Rocky_Mountain_Vending/docs/public-copy-guardrails.md

61 lines
1.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Rocky Public Copy Guardrails
This guide applies to customer-facing copy in `app/` and `components/`.
## Voice
- Sound like a strong local vending company.
- Lead with customer outcomes: service, speed, support, placement, reliability.
- Keep it plainspoken, confident, and easy to scan.
- Write like Rocky Mountain Vending is talking to a business owner, property manager, school, or office admin.
## Do Say
- What we do
- Who it is for
- What happens next
- How quickly we respond
- Why businesses trust Rocky
Examples:
- `Tell us what you need and our team will follow up quickly.`
- `Need service, moving help, or machine sales support? Were here to help.`
- `Share your location details and well recommend the right machine mix.`
## Never Say
Do not let customer-facing copy explain the website, UI, or refactor work.
Avoid phrases like:
- `rest of the site`
- `design system`
- `presentation`
- `shell`
- `dedicated page`
- `intake`
- `handoff`
- `path`
- `popup`
- `embed`
- `this page now`
- `consistent service experience`
- `best next step`
- `fuller request`
- `fuller intake`
## Before / After
- Bad: `We built this page to feel like the rest of the site: clear, calm, and easy to scan.`
- Good: `See why Utah businesses trust Rocky Mountain Vending for dependable service and support.`
- Bad: `Open the Rocky placement popup and well follow up within one business day.`
- Good: `Tell us about your location and well follow up within one business day.`
- Bad: `This page now matches the rest of the site instead of feeling like a separate design system.`
- Good: `Browse the machines we use, the features we prioritize, and the support that comes with every installation.`
## Review Rule
If a sentence explains how the site is organized instead of why a customer should care, rewrite it.