Skip to content

docs: add Brazilian Portuguese README and documentation (pt-BR)#22178

Closed
wesleysimplicio wants to merge 2 commits into
NousResearch:mainfrom
wesleysimplicio:feat/docs-pt-BR
Closed

docs: add Brazilian Portuguese README and documentation (pt-BR)#22178
wesleysimplicio wants to merge 2 commits into
NousResearch:mainfrom
wesleysimplicio:feat/docs-pt-BR

Conversation

@wesleysimplicio

@wesleysimplicio wesleysimplicio commented May 9, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

What does this PR do?

Adds Brazilian Portuguese (pt-BR) documentation surfaces — root README and Docusaurus docs site locale — to complement the in-flight pt-BR work.

Root cause

The detailed rationale from the original PR body is preserved below. This template update keeps the review structure consistent with #29640.

Fix

Why this shape

This shape mirrors #29640 so reviewers can quickly compare scope, root cause, fix, tests, and related context without having to decode a custom PR description.

Tests

  • Veja a descrição original preservada abaixo para detalhes de validação, testes e notas de verificação.
Original body

Related PRs / issues

Original body

Summary

Adds Brazilian Portuguese (pt-BR) documentation surfaces — root README and Docusaurus docs site locale — to complement the in-flight pt-BR work.

What Changed

  • Standardized this PR body to the current Hermes Turbo template.
  • Preserved the original detailed description below for reference.

Fluxo

A mudança continua seguindo o fluxo original descrito na seção preservada abaixo, sem ampliar o escopo funcional deste PR.

Visão

A padronização melhora a revisão, reduz ruído e evita deriva de formatação entre PRs abertos.

Test Plan

  • Veja a descrição original preservada abaixo para detalhes de validação, testes e notas de verificação.
Original body

Summary

Adds Brazilian Portuguese (pt-BR) documentation surfaces — root README and Docusaurus docs site locale — to complement the in-flight pt-BR work.

What's included

  • README.pt-BR.md — full native translation of README.md (mirrors the structural template of README.zh-CN.md). Not a machine translation: idiomatic pt-BR, consistent terminology with the existing agentskills.io / Hermes vocabulary, code blocks and command names left untouched.
  • Bidirectional language badges in README.md and README.zh-CN.md linking to README.pt-BR.md, matching the existing badge pattern.
  • Docusaurus pt-BR locale registered in website/docusaurus.config.ts alongside en and zh-Hans, with localized label Português (Brasil) and htmlLang: pt-BR.
  • Seed website translation at website/i18n/pt-BR/docusaurus-plugin-content-docs/current/user-guide/features/image-generation.md, mirroring the parity approach used by zh-Hans (which currently has 3 translated docs). Additional pages can be added incrementally without further config changes.

Coordination with existing pt-BR PRs

Before opening this PR I checked the three open pt-BR PRs to make sure I wasn't duplicating work:

PR Surface Files
#15737 (carloshenriquecarniatto) Web UI web/src/i18n/pt.ts, web/src/components/LanguageSwitcher.tsx, web/src/i18n/context.tsx, web/src/i18n/types.ts
#20443 (pedroborges) CLI runtime catalog agent/i18n.py, hermes_cli/config.py, locales/pt.yaml, locales/pt_BR.yaml, tests/agent/test_i18n.py, website/docs/user-guide/configuration.md
#22063 (Magaav) Web UI web/src/i18n/pt-BR.ts, web/src/components/LanguageSwitcher.tsx, web/src/i18n/context.tsx, web/src/i18n/types.ts, web/src/i18n/{en,zh}.ts

This PR touches none of those files. It targets the documentation surfaces (README.md, README.pt-BR.md, README.zh-CN.md, website/docusaurus.config.ts, website/i18n/pt-BR/**) which are orthogonal to the runtime catalog and Web UI work in flight, so it can land independently of any of those PRs without conflict.

If maintainers prefer to consolidate, this PR is small enough to fold into one of the others — but it can also stand alone.

Test plan

  • README.pt-BR.md renders correctly on GitHub (links, badges, tables, code blocks)
  • README.md and README.zh-CN.md show the new pt-BR badge linking to README.pt-BR.md
  • website/docusaurus.config.ts parses cleanly — pt-BR added to locales array and localeConfigs block follows the existing structure for zh-Hans
  • website/i18n/pt-BR/docusaurus-plugin-content-docs/current/user-guide/features/image-generation.md follows the file-path convention used by zh-Hans and will be picked up by npm run start -- --locale pt-BR in website/
  • Maintainer to confirm pt-BR locale builds with cd website && npm run build (no Docusaurus locale assets required beyond the page overrides; missing pages fall back to English, same as zh-Hans today)

Notes

  • Translations target Brazilian Portuguese specifically (matches the existing pt_BR.yaml naming used by feat(i18n): add Portuguese locale support #20443). The Docusaurus locale code pt-BR is the canonical BCP-47 form for this dialect.
  • I deliberately translated only the smallest of the three zh-Hans parity docs (image-generation.md) to keep this PR reviewable. Happy to follow up with tool-gateway.md and windows-wsl-quickstart.md in a separate PR once this lands, or extend this PR if maintainers prefer.

Generated by Hermes Turbo

Generated by Hermes Turbo

@wesleysimplicio
docs(i18n): add Brazilian Portuguese (pt-BR) README and Docusaurus lo…
e31a904 
…cale

Add native pt-BR translation of the main README plus bootstrap of the
Docusaurus pt-BR locale, complementing existing pt-BR work in flight.

- README.pt-BR.md: full native translation of README.md (mirrors the
  README.zh-CN.md structural template; not a machine translation).
- README.md / README.zh-CN.md: add bidirectional language badge to
  README.pt-BR.md.
- website/docusaurus.config.ts: register `pt-BR` alongside `en` and
  `zh-Hans` with localized label "Português (Brasil)".
- website/i18n/pt-BR/.../features/image-generation.md: seed translation
  of the image-generation guide to mirror the parity coverage that
  zh-Hans currently has (3 docs translated). Additional pages can be
  added incrementally without further config changes.

This contribution intentionally avoids overlap with the in-flight pt-BR
PRs:

- NousResearch#15737 (web/src/i18n/pt.ts)        -- Web UI strings
- NousResearch#20443 (locales/pt.yaml + agent/i18n.py) -- CLI runtime catalog
- NousResearch#22063 (web/src/i18n/pt-BR.ts)     -- Web UI strings

Surfaces here (root README + Docusaurus docs site i18n) are not touched
by any of the above.
Copilot AI review requested due to automatic review settings May 9, 2026 01:05
Copilot AI reviewed May 9, 2026
View reviewed changes

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Adds Brazilian Portuguese (pt-BR) documentation support across the repo’s README surfaces and the Docusaurus docs site, enabling a pt-BR locale alongside existing English and Simplified Chinese docs.

Changes:

  • Adds a full README.pt-BR.md translation and links it from the existing READMEs via language badges.
  • Registers pt-BR as a Docusaurus locale in website/docusaurus.config.ts.
  • Seeds the pt-BR Docusaurus content with a translated image-generation.md doc page.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
README.md Adds a pt-BR language badge linking to the new Portuguese README.
README.zh-CN.md Adds a pt-BR language badge linking to the new Portuguese README.
README.pt-BR.md Introduces a Brazilian Portuguese translation of the root README.
website/docusaurus.config.ts Registers pt-BR locale with label and htmlLang.
website/i18n/pt-BR/docusaurus-plugin-content-docs/current/user-guide/features/image-generation.md Adds an initial pt-BR localized doc page (image generation).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread ...te/i18n/pt-BR/docusaurus-plugin-content-docs/current/user-guide/features/image-generation.md
## Setup

:::tip Assinantes Nous
Se você tem uma assinatura paga do [Nous Portal](https://portal.nousresearch.com), pode usar geração de imagens pelo **[Tool Gateway](tool-gateway.md)** sem chave de API da FAL. Sua escolha de modelo persiste nos dois caminhos.

@wesleysimplicio wesleysimplicio May 9, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Addressed in 9953323 — translated tool-gateway.md to pt-BR alongside image-generation.md, matching the zh-Hans precedent in #20430 (which translated the same pair together for this exact reason). The relative link [Tool Gateway](tool-gateway.md) now resolves to the local pt-BR file, and Docusaurus + GitHub raw view both render correctly. Thanks for the catch!

@wesleysimplicio wesleysimplicio mentioned this pull request May 9, 2026
Closed
3 tasks
@wesleysimplicio
docs(i18n): translate tool-gateway.md to pt-BR
9953323 
Addresses Copilot review on NousResearch#22178: image-generation.md (line 31) had
a relative link to `tool-gateway.md` that did not resolve in the pt-BR
locale. Translating tool-gateway.md fixes the link and matches the
zh-Hans precedent (NousResearch#20430), which translated the two docs as a pair
for the same reason.

Native pt-BR translation mirroring the en source structure 1:1 (matches
the sibling image-generation.md style already in this PR).
@alt-glitch alt-glitch added type/docs Documentation improvements P3 Low — cosmetic, nice to have labels May 9, 2026
This was referenced May 9, 2026
Closed
Open
@wesleysimplicio

wesleysimplicio commented Jun 12, 2026

Copy link
Copy Markdown
Contributor Author

Closing non-fix PR as requested — mantendo apenas PRs de fix.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

Assignees

No one assigned

Labels

P3 Low — cosmetic, nice to have type/docs Documentation improvements

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@wesleysimplicio @alt-glitch