Skip to content

[UI/UX Design] Audit and refine microcopy for terminology consistency across screens #110

@thlpkee20-wq

Description

@thlpkee20-wq

Description

This is a UI/UX design task to audit and refine UI microcopy across Home, auth pages, and InvestorDiscovery so it consistently follows the RevenueShare terminology rules. The constants file forbids "dividend" and the hyphenated "revenue-share", yet copy still mixes forms (e.g. "revenue-share opportunities").

Requirements and context

  • Must be accessible (WCAG 2.1 AA), responsive, and documented in the design system
  • Should be consistent with existing patterns and easy to review
  • Relevant code: src/constants/terminology.ts, src/components/InvestorDiscovery.tsx, src/App.tsx
  • All copy should reference or comply with TERMINOLOGY and avoid prohibited terms

Suggested execution

  • Fork the repo and create a branch
  • git checkout -b uiux/microcopy-terminology-audit
  • Implement changes
    • Audit each screen's copy against terminology.ts and list violations
    • Update strings to approved RevenueShare phrasing
    • Document a voice-and-tone microcopy guide in the design system
  • Validate accessibility and responsive assumptions

Test and commit

  • Run checks
    • npm run lint and component/visual tests
  • Cover edge cases
    • prohibited terms, button/CTA labels, empty-state copy, alt/aria labels, reading level
  • Include screenshots/before-after and accessibility (axe) notes

Example commit message

design: refine microcopy for terminology consistency

Guidelines

  • Minimum 95 percent test coverage
  • Clear documentation
  • Timeframe: 96 hours

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationui-uxux

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions