Skip to content

feat(i18n-pt): translate the Adoption section into Portuguese - #589

Open
FigueiredoRod wants to merge 3 commits into
i18n/ptfrom
i18n/pt-adoption-settlement
Open

FigueiredoRod wants to merge 3 commits into
i18n/ptfrom
i18n/pt-adoption-settlement

Conversation

@FigueiredoRod

Copy link
Copy Markdown
Contributor

This PR translates the Adoption section into Portuguese (pt-PT).
Affected files:

docs/.vuepress/config.js - fills in the /pt/adoption/ sidebar tree (Scheme guide, TechOps, Settlement management, Finance Portal v2, RBAC, Onboarding) and points the navbar "Adoção" entry at /pt/adoption/ instead of the English page. The /pt/community/, /pt/product/ and /pt/technical/ sidebars stay empty and their nav links keep the "(em inglês)" marker.

docs/pt/adoption/** - 32 new pages mirroring the English tree exactly: same directory names, same file names, no translated paths. Covers the Scheme guide, the Hub Operations guides (TechOps, Settlement management, Finance Portal v2, RBAC, Onboarding) and the section index.

Translation follows docs/community/contributing/translations/locales/pt.md as proposed in #580: AO90 orthography, third-person impersonal register (no você/tu), the A.4 normative glossary, and the A.3 list of terms kept in English (scheme, hub, DFSP, component and repo names). Diagrams are not duplicated - the pt pages reference the English .svg assets, per the locale decision of record. Links from docs/pt/** resolve inside docs/pt/**; where a target is not yet translated the link points at the English page marked "(em inglês)".

One English defect is mirrored rather than fixed: the Finance Portal link that is broken in the English source is reproduced as-is, so the translation stays faithful to canonical English. A separate English PR should fix it.

markdownlint reports no new violations: every translated page has strictly fewer errors than its English counterpart, and the ones that remain are structural shapes inherited from the source.

AI Assistance Disclosure

AI tools were used in producing part of this contribution.
Tools used: Claude Code (Claude Opus 5)
Scope: drafting and copy-editing of the Portuguese pages, the /pt/adoption/ sidebar block in config.js, and this PR description.
All AI-generated content has been reviewed, understood, and validated by the author.

Adds the Portuguese translation of the settlement management section of
the adoption guide:

- HubOperations/Settlement/settlement-management-introduction.md
- HubOperations/Settlement/settlement-basic-concepts.md
- HubOperations/Settlement/ledgers-in-the-hub.md
- docs/pt/adoption/index.md (adoption landing page)

Wires the pages into the '/pt/adoption/' sidebar in config.js and points
the Portuguese "Adoção" nav entry at /pt/adoption/ instead of the English
/adoption/. Pages not yet translated keep linking to their English
sources, marked "(em inglês)".
Completes the Portuguese (pt-PT) translation of docs/adoption: the
Onboarding, Finance Portal v2, RBAC and Technical Operations guides under
HubOperations, and the five Scheme templates.

Follows the pt-PT annex: AO90 orthography, third-person imperative and
impersonal constructions instead of "você", A.4 glossary terms
(liquidação, cotação, comissão, razão geral, beneficiário) and A.3 terms
kept in English (scheme, switch, hub, DFSP, deployment, onboarding,
endpoint, rollback). Portal UI labels stay in English, since they are the
literal strings the reader sees on screen; the surrounding prose and the
descriptive headings are translated.

The Uniform Glossary keeps the source ordering and gives each entry as
"Termo (Source Term)", so it can still be cross-referenced against the
English Business Rules.

Repoints docs/pt/adoption/index.md at the newly translated pages and
drops the "(em inglês)" markers that are no longer accurate, and fills in
the '/pt/adoption/' sidebar in docs/.vuepress/config.js to match the
English tree.
The English source links the Finance Portal as
[Finance Portal](busops-portal-introduction.md), which resolves inside
HubOperations/Settlement/ where no such file exists; the page lives in
HubOperations/Portalv2/. The link 404s on the English site.

The Portuguese page had silently corrected it to point at the Portalv2
page. Part 1 of the translation guidelines is explicit that English is
canonical and that source errors are fixed in a separate English PR,
never in the translation, so this reverts to mirroring the source. The
defect is recorded so it can be fixed upstream first and then applied
here.
@mojaloopci

Copy link
Copy Markdown

Preview deployment is available at: https://docs.mojaloop.io/pr/589/

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.

2 participants