Skip to content

README in English, like the rest of the ecosystem - #3

Merged
lopadova merged 1 commit into
mainfrom
task/english-readme
Aug 30, 2026
Merged

README in English, like the rest of the ecosystem#3
lopadova merged 1 commit into
mainfrom
task/english-readme

Conversation

@lopadova

Copy link
Copy Markdown
Contributor

The docs site was already entirely in English — the README was not. A package published on Packagist is read by people who do not speak Italian, and the README is the first thing they see, so it is the last place to keep a second language.

What changed

The README, translated in full — keeping the register rather than the words. Every claim still says which failure it prevents: that is the reason those sentences are written the way they are, and a flatter translation would have kept the claims while losing the arguments.

The one Italian comment left in the doc site (docs-site/assets/custom.css) goes to English too.

Structure is untouched

Verified mechanically, not by eye:

before after
Headings 29 29
Table rows equal equal
Code fences 32 32
Links & images identical identical¹

¹ The single difference is the internal anchor #test#tests, following its renamed heading — checked to resolve.

Both images still resolve, and npm run build in docs-site/ still generates 8 pages with zero warnings.

Not in scope, and deliberately so

  • CLAUDE.md stays in Italian: it is guidance for the team and for AI agents working in the repo, not community-facing, and it matches the convention in laravel-iam-agents and the other packages.
  • Source comments stay in Italian, for the same reason and the same precedent (laravel-iam-agents and laravel-flow are Italian in src/ too). Changing them is a large, separate diff — say the word if you want it.

Generated by Claude Code

The docs site was already in English; the README was not, and a package
published on Packagist is read by people who do not speak Italian. The
README is the first thing they see, so it is the last place to keep a
second language.

Translated in full, keeping the register rather than the words: every
claim still says which failure it prevents, which is the reason those
sentences are written the way they are. Structure is untouched — same 29
headings, same tables row for row, same code blocks, same links (the only
change is the anchor #test → #tests, following its heading).

The one Italian comment left in the doc site (assets/custom.css) goes to
English too.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EZ4u82zdoa8naYm75kppMC
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying laravel-routines with  Cloudflare Pages  Cloudflare Pages

Latest commit: 88e0354
Status: ✅  Deploy successful!
Preview URL: https://a53cad13.laravel-routines.pages.dev
Branch Preview URL: https://task-english-readme.laravel-routines.pages.dev

View logs

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Aug 30, 2026

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review Completed 2026-08-30T15:27:27.003152Z 88e0354 PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@lopadova
lopadova merged commit 4e05b99 into main Aug 30, 2026
5 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