Skip to content

docs(landing): rewording pass on the ES and EN copy - #258

Merged
gnacho merged 1 commit into
mainfrom
fix/257-copy-pass
Oct 30, 2026
Merged

gnacho merged 1 commit into
mainfrom
fix/257-copy-pass

Conversation

@gnacho

@gnacho gnacho commented Oct 30, 2026

Copy link
Copy Markdown
Owner

The landing copy read like marketing in places and had a few AI tells. This is a
wording pass only: no layout, no assets, no behaviour.

What changed

  • Claims without a fact behind them. pillars.lead ("Not marketing slogans.
    They shape every decision"), features.lead ("No more, no less"),
    install.title ("Easy and fast installation") and compare.title ("The GNOME
    companion that was missing") now state what the section actually holds.
  • Invented vocabulary. "Coalescing" becomes the queue that merges repeated
    events. "Does not speak a vendor protocol" becomes "does not implement a
    vendor protocol".
  • Punctuation. Semicolons out of prose strings (faq.a2, footer.copy,
    install.r1d, features.f4d), one line closers dropped.
  • Voice. about.p2 moves to first person in both languages ("on my own
    setup", "en mi propia instalación"), as the rest of the page and soul.md
    ask for.
  • Consistency. compare.r5 matches features.f4t ("Deletion guard"),
    sw.localSub in English matches the Spanish, and features.f1d no longer
    repeats "its own" three times.
  • Metadata. Description, og:description, twitter:description and the FAQ
    entry inside the JSON-LD updated. i18n.js cache bust to ?v=17.

Verification

  • 134 keys in both languages, same order, no key left on one side, and every
    data-i18n key used in the HTML exists.
  • No em dashes, en dashes or semicolons in prose values.
  • verify-nxs-redesign.js 127 passed, verify-nxs-weight.js 25 passed, axe 0
    violations at 390 and 1280 in both themes, no console errors.
  • Deployed to production first and checked the rendered strings in both
    languages.

Closes #257

Drop the empty claims from the section leads, replace the invented vocabulary
with the real mechanism, remove semicolons and one line closers from prose,
speak in first person in the about section, and align the meta descriptions.

Closes #257
@gnacho
gnacho merged commit 4411981 into main Oct 30, 2026
2 checks passed
@gnacho
gnacho deleted the fix/257-copy-pass branch October 30, 2026 07:16
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.

landing: rewording pass on the ES and EN copy

1 participant