tom/diana
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Resolve open questions; update all core specs

Browse Source
This commit is contained in:
Tom Roth
2026-07-31 07:17:00 +02:00
parent 6bd990e4a0
commit 1a6f9fc509
4 changed files with 170 additions and 107 deletions
Download Patch File Download Diff File Expand all files Collapse all files

67
specification/99-open-questions.md
View File

@@ -3,40 +3,49 @@
This log tracks uncertainties and deferred decisions. Each item should be resolved before implementation in Phase 4.
## OQ-1 — Preferred contact method(s) beyond the contact form
- **Status**: Open
- **Context**: Contact form is a given, but preferred secondary channel(s) are not finalized.
- **Why it matters**: Influences CTA design, header/footer, and “next steps” after form submission.
- **Candidates**: phone, SMS/text, email.
- **Proposed resolution**: Decide primary + secondary channel(s) and when to encourage each.
- **Status**: Resolved
- **Resolution**: Secondary contact channels are **email** and **phone**. Both should appear in the site header/footer and in the confirmation copy after form submission.
## OQ-2 — GDPR/cookie consent and tracking requirements
- **Status**: Open
- **Context**: Need to know whether we will run analytics/ads pixels and whether consent banners are required.
- **Why it matters**: Affects scripts, cookie banner, privacy policy content, and SEO.
- **Proposed resolution**:
- Decide whether to use analytics (and which)
- If analytics, decide consent model and privacy policy needs
- **Status**: Resolved
- **Resolution**: **No analytics, no tracking scripts, no cookie consent banner** for v1. No privacy policy required at launch. Revisit if analytics are added later.
## OQ-3 — Form backend + spam protection approach (ADR-002)
- **Status**: Open
- **Context**: Static site requires an external or existing backend mechanism.
- **Why it matters**: Reliability, spam filtering, and operational workflow.
- **Proposed resolution**: Choose a form delivery method and specify validation + anti-spam.
- **Status**: Partially resolved
- **Resolution**: Form submissions will be handled via an **existing AWS service**. Specific service (e.g. SES, API Gateway + Lambda, or similar) and the endpoint URL/configuration need to be confirmed before `38-lead-capture-spec.md` implementation. See ADR-002.
- **Remaining**: Confirm which AWS service/endpoint and provide connection details.
## OQ-4 — Minimum quote form fields for “qualified leads”
- **Status**: Open
- **Context**: Goal is “more qualified leads”, but minimum qualifying information is not fully specified.
- **Why it matters**: Balances friction vs. lead quality.
- **Proposed resolution**: Define required vs optional fields in `38-lead-capture-spec.md`.
## OQ-4 — Minimum quote form fields for "qualified leads"
- **Status**: Resolved
- **Resolution**: Required form fields are:
- **Name** (full name)
- **Address** (service location)
- **Phone**
- **Email**
- **Description** (description of work requested)
- All fields are required. Detailed validation rules to be defined in `38-lead-capture-spec.md`.
## OQ-5 — Service taxonomy: separate pages vs grouping for carpentry/mounting/flooring
- **Status**: Open
- **Context**: Requirement says separate page per service, but some services overlap.
- **Why it matters**: SEO clarity and content uniqueness.
- **Proposed resolution**: Confirm final service list and page slugs.
## OQ-5 — Service taxonomy: separate pages vs grouping
- **Status**: Resolved
- **Resolution**: Services are grouped for best SEO relevance and content depth. Proposed groupings:
| Page | Slug | Services included |
|------|------|-------------------|
| Painting | `/services/painting/` | Interior & exterior painting, trim work |
| Tile Setting | `/services/tile-setting/` | All tile types, kitchens, bathrooms, entryways, patios |
| Drywall & Sheetrocking | `/services/drywall/` | Removing, replacing, patching, sanding |
| Minor Plumbing | `/services/plumbing/` | Sinks, toilets, showers |
| Minor Electrical | `/services/electrical/` | Lights, fans, fixtures |
| Carpentry & Mounting | `/services/carpentry-and-mounting/` | Carpentry, furniture assembly, TV/shelf mounting |
| Flooring & Wood Refinishing | `/services/flooring/` | Flooring touch-ups, wood refinishing (floors, decks, stairs, cabinets) |
| Security & Safety Equipment | `/services/security-safety/` | Grab bars, lock bars, window mesh, security cameras |
| Boat Work | `/services/boat-work/` | Woodwork, spray paint, marine hardware |
- **Rationale**: Carpentry and Mounting share the same installation/assembly search intent. Flooring touch-ups and Wood Refinishing share the same surface/finish search intent and existing image assets.
## OQ-6 — Brand naming and domain
- **Status**: Open
- **Context**: Current site uses “Spotlight Home Improvement Services”; new site may keep or adjust branding.
- **Why it matters**: Title tags, logo, copy, and SEO continuity.
- **Proposed resolution**: Confirm public-facing brand name for v1.
- **Status**: Resolved
- **Resolution**: New public-facing brand name is **"Home Enhancement and Renovation — HER"**.
- Use full name in footers, About page, and legal references.
- Use **"HER"** as the short-form logo/header identity.
- Update all spec documents and eventually title tags/metadata to reflect the new brand.