Skip to content

fix(copy): replace legally risky terms with safer alternatives#6

Merged
NimbleEngineer21 merged 3 commits intomainfrom
fix/legal-copy-review
Mar 5, 2026
Merged

fix(copy): replace legally risky terms with safer alternatives#6
NimbleEngineer21 merged 3 commits intomainfrom
fix/legal-copy-review

Conversation

@NimbleEngineer21
Copy link
Owner

Summary

  • Replace "financial planning" with "personal finance calculator" across all SEO meta tags, sidebar tagline, and setup wizard to avoid implying professional financial planning services (SEC/state regulated term)
  • Soften directive/advisory language: "Buy down the rate" → "Buy-down likely to break even", "CAN YOU AFFORD IT?" → "PURCHASE VS. AVAILABLE FUNDS", "Ready now" → "Funds available", "You need X more" → "There is a X gap"
  • Replace regulated meta keywords: "asset management" → "asset tracking", "liquidation planner" → "purchase readiness"
  • Rename Readiness page title from "Financial Readiness" to "Purchase Readiness" and strengthen footer disclaimer with "For illustration only"
  • Reword ConformingStatus jumbo loan copy from directive ("Increase down payment to X%") to informational ("A down payment of X% would keep the loan conforming")
  • Clean up minor code quality issues in ConformingStatus (optional chaining, nested ternary, replaceAll, Number.parseFloat)

Motivation

Several terms used in user-facing copy could be misconstrued as implying the app provides professional financial advice, which carries legal risk under the Investment Advisers Act of 1940, SEC Reg BI, and state-level regulations. This PR neutralizes that language while preserving the app's functionality and clarity.

Test plan

  • All 415 tests pass (npm test)
  • ESLint clean (npm run lint)
  • Visual spot-check: sidebar tagline, setup wizard welcome screen, Readiness page, Purchase Planning page, Loans Calculator buy-down labels, ConformingStatus jumbo section
  • Verify <title> and OG/Twitter meta tags render correctly (view source or social card validator)

Replace "financial planning" with "personal finance calculator" across
SEO meta tags, sidebar, and setup wizard to avoid implying professional
financial planning services. Soften directive language ("Buy down the
rate", "CAN YOU AFFORD IT?", "Ready now", "You need X more") into
neutral, informational phrasing that reduces legal risk of being
construed as financial advice. Rename Readiness page from "Financial
Readiness" to "Purchase Readiness" and strengthen footer disclaimer.

Also clean up minor code quality issues in ConformingStatus (optional
chaining, nested ternary, replaceAll, Number.parseFloat).
Revert .replaceAll() to .replace() to prevent runtime crash on older
mobile browsers (ES2021 API not available on Android WebView targets
this project already polyfills for). Remove remaining legally risky
language from comments/JSDoc ("can afford", "Financial readiness",
"suggest", "Consider increasing"). Rename identifiers to match neutral
tone: suggestConformingDown → calcConformingDown, canAfford → isCovered,
onApplySuggestion → onApplyConformingDown, suggestion → conformingOption.
Normalize parseFloat/parseInt to Number.parseFloat/Number.parseInt in
touched files.
@NimbleEngineer21 NimbleEngineer21 merged commit 13737c0 into main Mar 5, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant