Skip to content

docs(glossary): rewrite grounded on reviewed translations - #622

Merged
deblasis merged 4 commits into
mainfrom
translate/glossary-v2
Sep 14, 2026
Merged

deblasis merged 4 commits into
mainfrom
translate/glossary-v2

Conversation

@deblasis

@deblasis deblasis commented Sep 14, 2026

Copy link
Copy Markdown
Collaborator

Summary

Rewrites GLOSSARY.md grounded on terminology from issue #418 reviewed pages (~30 learn pages). First PR in the AI translation stack.

  • Restructures glossary: non tradurre → traduzioni confermate → nomi propri → disambiguazioni → proposte → pagine legacy
  • Each confirmed term cites source page/PR from human translations
  • Resolves legacy "Problematic terms" overlap by promoting corpus decisions to fixed rules
  • Adds gap-fill proposals for untranslated content (marked as proposta)
  • Fixes dead links to old it.reactjs.org issues (moved to historical footnotes)
  • Documents legacy deviations in human-reviewed pages (do not replicate in new translations)

Key decisions (corpus-grounded)

Term Decision
state state in new translations (legacy pages may use stato)
Effect Effetto (from you-might-not-need-an-effect); effetto collaterale for generic side effects
event handler gestore di eventi
render renderizzare / renderizzazione
commit fase di commit (loanword)
mount/unmount montare/smontare in prose, EN in API
prop drilling loanword

Glossary reflects human-reviewed choices as-is — no maintainer re-litigation. Update later if community decides.

Moved to proposte (no corpus Fonte)

  • event listener → listener di eventi
  • controlled / uncontrolled component

Legacy pages (deviations documented, normalization optional)

  • you-might-not-need-an-effectstato, English event handler, mixed effetti/Effetto
  • extracting-state-logic-into-a-reducerstato
  • scaling-up-with-reducer-and-contextstato

Test plan

Rebuild glossary from issue #418 reviewed pages: confirmed terms
with source citations, disambiguation rules, and gap-fill proposals.

Signed-off-by: Alessandro De Blasis <alex@deblasis.net>
Co-authored-by: Cursor <cursoragent@cursor.com>
@vercel

vercel Bot commented Sep 14, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated
legacy-it-reactjs-org Ignored Ignored Preview Sep 14, 2026 4:28am UTC

Request Review

@github-actions

Copy link
Copy Markdown

Size changes

Details

📦 Next.js Bundle Analysis for react-dev

This analysis was generated by the Next.js Bundle Analysis action. 🤖

This PR introduced no changes to the JavaScript bundle! 🙌

Treat Effect like state/props/hooks — core concept stays in English.
Note legacy Effetto usage in you-might-not-need-an-effect for community.

Signed-off-by: Alessandro De Blasis <alex@deblasis.net>
Co-authored-by: Cursor <cursoragent@cursor.com>
Revert Effect loanword policy; Effetto is the confirmed choice from
you-might-not-need-an-effect and community review.

Signed-off-by: Alessandro De Blasis <alex@deblasis.net>
Co-authored-by: Cursor <cursoragent@cursor.com>
Move event listener and controlled/uncontrolled terms to proposte.
Document legacy deviations in human-reviewed pages. Clarify that
glossary choices follow the corpus without re-litigating them.

Signed-off-by: Alessandro De Blasis <alex@deblasis.net>
Co-authored-by: Cursor <cursoragent@cursor.com>
@deblasis
deblasis added this pull request to stack #624 September 14, 2026 04:36
@deblasis
deblasis merged commit c84be37 into main Sep 14, 2026
10 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