Rebuilt IP, ROI, and marginal-revenue tool pages to the shared IG pattern with full ten-locale copy. | Dev Logs

Date: 2026-08-06 20:05 Summary: Rebuilt IP, ROI, and marginal-revenue tool pages to the shared IG pattern with full ten-locale copy.

[question] In /Users/xuli/vscodeai/onlinefreetools, rebuild these EXISTING tool pages to match the IG pattern used by howToCalculateBmiPage.ts and websiteHeadersPage.ts (shared helpers in src/pages/site/toolContent.ts: renderToolIgSections, renderToolReferencesSection, renderToolExtraSections).

Tools

1. ip-address — src/pages/ipAddressPage.ts + i18n keys tool_ip_address_*
2. how-to-calculate-roi — src/pages/howToCalculateRoiPage.ts + tool_roi_*
3. how-to-calculate-marginal-revenue — src/pages/marginalRevenuePage.ts + tool_marginal_revenue_*

Specs

Read work-tasks/{slug}/02-tool-info.md and 03-locale-briefs.md for each.

IP

• Keep existing fetch UI (/api for IP)
• Add How / Rules / Example / Use cases via renderToolIgSections(prefix tool_ip_address, mode rules)
• References: e.g. MDN IP, Cloudflare/what-is-my-ip style educational links (pick 2 authoritative)
• FAQ: edge how IP obtained; proxy/VPN limits; LAN vs public
• Full comments on functions in page files (user rule)
• en + zh full rewrite first; then ALL other langs (es pt id fr de ar ja ru) independently per briefs — not isomorphic

ROI (YMYL)

• Keep calculator fields (initial/final/gain)
• Add How + Formula (mode formula) with assumption items (tax/time/fees)
• Clickable Investopedia refs (≥2)
• Soften any investment-advice tone; disclaimer already via ymyl section
• Example fixed numbers
• en+zh then all other langs

Marginal revenue (YMYL)

• Keep MR calculator interaction
• Visible formula derivation in formula section
• References: textbooks/Investopedia marginal revenue
• Disclaimer
• en+zh then all langs

Patterns

• Import helpers like BMI page
• References AFTER FAQ/Related (contentHtml + toolSeoHtml + referencesHtml)
• Update scripts/site/i18n.mjs home titles/descs when title changes
• description ≥120 chars each lang
• Escape quotes in TS strings
• Do NOT change tool-catalog.json slugs/related unless broken
• Do NOT touch text-diff or markdown-to-html

After edits: run npm run lint:seo and fix failures you introduced.

Return summary of files changed and any leftover gaps.

[try to solve] Aligned three existing tool pages with the BMI / website-headers IG structure: pages wire renderToolIgSections / renderToolReferencesSection / renderToolExtraSections; References sit after FAQ/Related.

• IP: kept /api/tools/ip-address fetch UI; How + Rules (edge-trusted client IP, VPN/NAT/dual-stack); Example uses 203.0.113.10; refs MDN X-Forwarded-For and Cloudflare Learning.
• ROI (YMYL): kept initial/final/gain; Formula includes tax/time/fees/multi-period assumption items; fixed example 1000→1300 = 30%; two clickable Investopedia refs; softened advice tone.
• Marginal revenue (YMYL): kept Q1/TR1/Q2/TR2 calculator with visible ΔTR/ΔQ derivation; example 10→11 / 1000→1080 → MR 80; Investopedia + OpenStax refs.

Ten-locale copy rewritten independently from 03-locale-briefs.md (not English-template isomorphic); scripts/site/i18n.mjs home-card titles/descs synced. npm run lint:seo passed.

Leftover gaps: 03 still marks ar/ja/ru pending native review; tool-catalog.json unchanged; text-diff / markdown-to-html untouched.

[actions]

• src/pages/ipAddressPage.ts
• src/pages/howToCalculateRoiPage.ts
• src/pages/marginalRevenuePage.ts
• src/site/i18n/{en,zh,es,pt,id,fr,de,ar,ja,ru}.ts
• scripts/site/i18n.mjs
• npm run lint:seo