Skip to content

Use straight apostrophes in English display text - #16

Merged
superblaettler merged 1 commit into
mainfrom
copy-conventions
Nov 11, 2026
Merged

superblaettler merged 1 commit into
mainfrom
copy-conventions

Conversation

@superblaettler

Copy link
Copy Markdown
Collaborator

Applies the shared Supertext copy convention for display text: English UI text uses a straight apostrophe.

French and Italian keep ’ (U+2019), which is correct typography in those languages — only the English surface changed. Each file type got the escape its syntax needs: \' in PHP/Twig/JS, '' in YAML, plain ' in JSON and double-quoted strings.

Checked but deliberately not changed

The other conventions from the WordPress plugins have no equivalent here:

  • "AI translation" over "machine translation" — the only hits are npm/Packagist discovery keywords and the host CMS's own API terms (for example wagtail-localize's apply_machine_translation, Polylang's Machine Translation module). Renaming either would hurt package discovery or break navigation instructions.
  • ServiceId — no occurrences.
  • No "we" in user-facing strings — no occurrences.
  • Curly double quotes in display text — the remaining straight-quote strings are developer-facing (API validation errors, exception messages, log lines, Content-Disposition headers), not end-user display text. Left alone; happy to convert the genuine UI ones on request.

French, Italian and German catalogue values were not touched.

Verification

The repo's own build and test tooling was not available in this environment, so this change was verified structurally instead: JSON and YAML files were re-parsed after the edit to confirm they still load, and the escaping was checked per file type. Please run the repo's normal checks before merging.

🤖 Generated with Claude Code

Applies the shared Supertext copy convention: English UI text uses a
straight apostrophe. French and Italian keep U+2019, which is correct
typography in those languages, so only the English surface changed.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@superblaettler
superblaettler merged commit 853c6ce into main Nov 11, 2026
9 checks 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