Repository navigation
docs: add Arabic documentation edition - #3666
m0hamed-ux wants to merge 1 commit into
Conversation
|
This PR has been closed automatically. It's still a draft, but we close those early so you don't put in more time only to have it closed the moment you mark it ready. This repo only keeps pull requests open when they come from a maintainer, or from a contributor a maintainer has assigned to the linked issue, and you aren't currently assigned to #3665. If a maintainer assigns you to #3665, this PR reopens on its own and there's nothing more you need to do here. Assignment is a maintainer call based on capacity; comments that only ask to be assigned don't factor in. What does help is engaging on the issue itself by confirming the repro, explaining why it matters for your use case, or describing the approach you'd take. You're welcome to keep pushing commits here (just avoid force-pushing, since GitHub can't reopen a rewritten branch), but that on its own won't get the PR reviewed or the issue assigned, and realistically most auto-closed PRs stay closed. There's no need to open a new PR either way. CONTRIBUTING.md has the full reasoning, but in short:
Maintainers: reopen, remove |
Adds an Arabic documentation edition at
/ar/, with Modern Standard Arabic terminology and the existing language selector, navigation, and translation notices.Fixes #3665
This contains all 52 pages currently eligible for translation, Arabic style-guide and glossary inputs, and generated notices. The API reference and migration guide remain English under the existing registry policy. The root README translation is a separate local review draft and is not included here. No SDK runtime code or dependencies change.
Generation and review
Codex assisted with contribution research, the Arabic style guide and glossary, and the documentation translations. No Anthropic API key was used: Codex generated drafts that a local adapter supplied through the repository's
Translatorinterface totranslate_page. The official tooling restored code fences, pinned English heading IDs, validated structure, and wrote source-section provenance. The translator itself was not modified. This differs from the documented Claude API command; maintainer feedback on that method is welcome, including regeneration with the standard tool if preferred.The contributor reviewed the Arabic preview and approved proceeding with this PR. English remains authoritative, and future corrections should go through language inputs and regeneration.
Validation
uv run --frozen pytest tests/docs -q: 49 passed.--strict: passed without issues.Only English and Arabic sites were built. Updating the available-language list marks the other editions'
translations.mdoutdated until their usual regeneration.Draft scope
Issue #3665 currently has no assignee or
help wantedlabel. This draft makes the prepared edition available for scope and workflow discussion; it does not imply maintainer approval. The issue originally proposed a smaller starting contribution, and this work can be split into an initial homepage/Get started set followed by topical batches if preferred.