Skip to content

fix(quality): tour step titles misaligned with elements; "capabilityies" pluralization typo in summary reports #588

@roballred

Description

@roballred

Two small, surface-level quality bugs surfaced by the Early-Maturity EA Practice Lead persona walk (#586). Filing together because both are stakeholder-visible and both undercut the credibility of the first-deliverable surfaces the persona depends on (Architecture Vision, Executive Summary, in-product tour).

Bug 1 — Tour step element/title mismatch

In apps/govea/src/components/product-tour.tsx, three consecutive steps have title/element misalignment:

Step Element selector Popover title
9 [data-tour="nav-strategy"] "Decisions" (should be Strategy)
10 [data-tour="nav-roadmap"] "Strategy" (should be Roadmap)
11 [data-tour="nav-reports"] "Roadmap" (should be Reports/Search)

The titles appear to be off-by-one relative to the elements they're anchored to. A first-time user clicking through the tour sees the highlight land on the Strategy nav link while the popover says "Decisions" — undermines the tour's purpose as orientation.

Reproducer

  1. Sign in as Riverdale Admin.
  2. Click the Tour button in the header.
  3. Click Next → through steps 1-8.
  4. Observe steps 9-11: the highlighted nav item does not match the popover title.

Bug 2 — "capabilityies" pluralization

The reports surfaces use a ${n} ${noun}ies template that produces "capabilityies" whenever n > 1. Two confirmed sites:

  • /reports/architecture-vision"3 capabilityies linked" under each Strategic Driver.
  • /executive (Executive Summary) → "4 capabilityies without supporting technology" in the Architecture Gaps callout.

The pluralization needs to be a proper noun-form mapping (capability → capabilities), or the template needs to switch to ${n} capabilit${n === 1 ? 'y' : 'ies'}.

Reproducer

  1. Sign in as Riverdale Admin.
  2. Open /reports/architecture-vision. Observe Strategic Drivers section text.
  3. Open /executive. Observe Architecture Gaps callout text.

Why these matter for this persona

The Early-Maturity Practice Lead walks each of these surfaces as a demo-to-leadership candidate. A typo on the Architecture Vision PDF is exactly the kind of detail that costs early-stage credibility. The tour mismatch is the first thing they show a colleague.

Traceability

Capability: fd-traceability-views; fd-portfolio-views; tour lives outside a capability doc.
Persona: early-maturity-practice-lead (Assumed)
Parent: #515 (Phase 0.5 epic), surfaced by #586.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingjourney:early-maturity-practice-leadIssues tied to the Early-Maturity EA Practice Lead persona journeytrack:foundationInfrastructure, governance, or enabling work that unblocks other tracks

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions