Skip to content

feat: added initial ai based translations#10705

Merged
jasonsaayman merged 2 commits intov1.xfrom
feat/add-docs-translation
Apr 14, 2026
Merged

feat: added initial ai based translations#10705
jasonsaayman merged 2 commits intov1.xfrom
feat/add-docs-translation

Conversation

@jasonsaayman
Copy link
Copy Markdown
Member

@jasonsaayman jasonsaayman commented Apr 13, 2026

Summary by cubic

Adds Spanish, French, and Chinese docs and enables vitepress locale routing with per-language nav/sidebars. Users can browse /es, /fr, and /zh with localized home, Getting Started, Advanced, and Misc content (fallbacks to English where missing).

Description

  • Summary of changes

    • Configures vitepress locales with language-specific nav/sidebars in docs/.vitepress/config.mts.
    • Adds full doc trees for es, fr, zh including new Advanced topics (Headers, Fetch adapter, HTTP/2, Rate limiting, Progress, Retry).
    • Updates home actions and links per locale; English remains default (/); localized routes under /es, /fr, /zh.
  • Reasoning

    • Make axios docs accessible to more readers and align with updates merged from v1.x.
  • Additional context

    • Initial pass; expect follow-up proofreading and terminology tweaks.
    • Missing pages should fall back to English automatically.

Testing

  • No automated tests (docs-only).
  • Manual QA:
    • Run locally (npx vitepress dev docs) and visit /, /es/, /fr/, /zh/.
    • Verify localized homepages, nav/sidebars, and key pages (Getting Started, Advanced topics listed above).
    • Build (npx vitepress build docs) to ensure no errors.

Written for commit d627bd8. Summary will update on new commits.

@jasonsaayman jasonsaayman self-assigned this Apr 13, 2026
@jasonsaayman jasonsaayman added priority::medium A medium priority commit::feat The PR is related to a feature labels Apr 13, 2026
Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

5 issues found across 103 files

Confidence score: 4/5

  • This PR is likely safe to merge, with risk concentrated in documentation examples rather than core runtime code, so impact is mostly on copied usage patterns.
  • Most severe issue: the retry docs in docs/es/pages/advanced/retry.md and docs/zh/pages/advanced/retry.md assume Retry-After is numeric seconds; missing HTTP-date/invalid-value handling can lead users to retry too early.
  • There are also concrete snippet correctness problems (fs not imported in docs/es/pages/advanced/multipart-form-data-format.md, repeated const instance in docs/zh/pages/advanced/adapters.md, and abort-delay mismatch in docs/es/pages/advanced/retry.md) that can cause copy-paste errors.
  • Pay close attention to docs/es/pages/advanced/retry.md, docs/zh/pages/advanced/retry.md, docs/es/pages/advanced/multipart-form-data-format.md, and docs/zh/pages/advanced/adapters.md - fix retry semantics and invalid JS examples before publishing.

Note: This PR contains a large number of files. cubic only reviews up to 75 files per PR, so some files may not have been reviewed. cubic prioritises the most important files to review.

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="docs/es/pages/advanced/multipart-form-data-format.md">

<violation number="1" location="docs/es/pages/advanced/multipart-form-data-format.md:15">
P2: The Node.js example uses `fs.createReadStream` but never imports `fs`, so this snippet will throw a ReferenceError when copied.</violation>
</file>

<file name="docs/es/pages/advanced/retry.md">

<violation number="1" location="docs/es/pages/advanced/retry.md:91">
P1: Handle `Retry-After` HTTP-date values (and invalid values) instead of assuming it is always numeric seconds.</violation>

<violation number="2" location="docs/es/pages/advanced/retry.md:128">
P2: The comment claims abort cancels pending retry delays, but the shown retry-delay code does not connect delay timers to the abort signal.</violation>
</file>

<file name="docs/zh/pages/advanced/retry.md">

<violation number="1" location="docs/zh/pages/advanced/retry.md:92">
P2: The `Retry-After` handling only supports numeric seconds; HTTP-date values will not be honored and can cause immediate retries.</violation>
</file>

<file name="docs/zh/pages/advanced/adapters.md">

<violation number="1" location="docs/zh/pages/advanced/adapters.md:16">
P2: This code sample redeclares `const instance` multiple times in the same scope, which makes the snippet invalid JavaScript.</violation>
</file>

Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.

Comment thread docs/es/pages/advanced/retry.md
Comment thread docs/es/pages/advanced/multipart-form-data-format.md
Comment thread docs/es/pages/advanced/retry.md
Comment thread docs/zh/pages/advanced/retry.md
Comment thread docs/zh/pages/advanced/adapters.md
@jasonsaayman jasonsaayman merged commit 01a581a into v1.x Apr 14, 2026
26 checks passed
@jasonsaayman jasonsaayman deleted the feat/add-docs-translation branch April 14, 2026 16:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

commit::feat The PR is related to a feature priority::medium A medium priority

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant