Skip to content

Fix small pt-BR translation errors - #549

Open
yurineves92 wants to merge 2 commits into
yiisoft:masterfrom
yurineves92:fix/pt-br-small-errors
Open

yurineves92 wants to merge 2 commits into
yiisoft:masterfrom
yurineves92:fix/pt-br-small-errors

Conversation

@yurineves92

@yurineves92 yurineves92 commented Nov 6, 2026 •

Copy link
Copy Markdown
Contributor

Small follow-up to #546 with fixes found while reviewing the published Brazilian Portuguese docs.

Changes

  • Flattened lists: 16 lists were rendered as a single paragraph or a single list item in the Docker Swarm (Caddy and Traefik), Sentry and Assets pages. The English source has no blank line before these lists, so po4a merges them into one segment. Line breaks are restored in the pt-BR msgstr, the same way the Russian Sentry translation does it.
  • Report issue link: added the missing pt-BR label in ReportIssue.vue, which fell back to English.
  • Navigation: aligned the VitePress menu and the Markdown tables of contents with the page titles.
  • Consistency: aligned link text with page titles, and used "POO" and "Ser explícito" as in the other pages.

Notes

  • Translations were edited in the .po files. src/pt-BR was regenerated with the ghcr.io/yiisoft-contrib/po4a:0.74 image, because the Update translations workflow cannot push to a fork branch.
  • npm run build was not run locally.
  • The same flattened lists affect the other translations. Adding a blank line before these lists in the English source would fix it for all languages, but it would also invalidate those segments, so I left the source unchanged.
  • guide/security/overview.md links to views/view.md#security, and that section does not exist in English either. This PR does not change it.

Summary by Sourcery

Correct Brazilian Portuguese documentation formatting, navigation labels, terminology, and issue-reporting localization.

Bug Fixes:

  • Correct malformed pt-BR list rendering across Docker Swarm, Sentry, and asset documentation pages.
  • Add the missing Brazilian Portuguese label for the report-issue link.
  • Fix inconsistent Brazilian Portuguese translation wording and page references.

Enhancements:

  • Align pt-BR navigation menus and Markdown tables of contents with translated page titles.

Documentation:

  • Improve the accuracy and consistency of Brazilian Portuguese documentation terminology and links.

Restore lists that po4a flattened into a single paragraph in the Docker
Swarm, Sentry and asset pages.

Add the pt-BR label to the report issue link.

Align the menu, tables of contents and link text with page titles, and
use "POO" and "Ser explícito" consistently.
@sourcery-ai

sourcery-ai Bot commented Nov 6, 2026 •

Copy link
Copy Markdown
Reviewer's guide (collapsed on small PRs)

Reviewer's Guide

This PR fixes pt-BR documentation presentation and terminology by repairing flattened PO translation lists, aligning translated navigation and link text with page titles, and adding the missing localized Report Issue label. Translation changes remain in .po files and depend on the existing Update translations workflow for generated sources.

File-Level Changes

Change Details Files
Corrected pt-BR translation formatting and wording across documentation pages.
  • Restored line breaks for flattened lists in Docker Swarm, Sentry, and Assets translations.
  • Updated translated navigation labels, table-of-contents text, link text, and terminology for consistency.
  • Adjusted selected page-title translations, including “POO” and “Ser explícito”.
_translations/po/pt-BR/cookbook_deployment_docker-swarm-caddy.md.po
_translations/po/pt-BR/cookbook_deployment_docker-swarm-traefik.md.po
_translations/po/pt-BR/cookbook_index.md.po
_translations/po/pt-BR/cookbook_sentry-integration.md.po
_translations/po/pt-BR/guide_concept_di-container.md.po
_translations/po/pt-BR/guide_databases_db-migrations.md.po
_translations/po/pt-BR/guide_index.md.po
_translations/po/pt-BR/guide_intro_upgrade-from-v1.md.po
_translations/po/pt-BR/guide_intro_upgrade-from-v2.md.po
_translations/po/pt-BR/guide_intro_what-is-yii.md.po
_translations/po/pt-BR/guide_rest_quick-start.md.po
_translations/po/pt-BR/guide_views_asset.md.po
_translations/po/pt-BR/internals_index.md.po
Aligned pt-BR navigation labels with translated page titles.
  • Updated VitePress menu labels for testing setup, third-party integrations, Git commit messages, and view code style.
src/.vitepress/config.js
Added localized text for the report-issue action.
  • Added the pt-BR label so the report link no longer falls back to English.
src/.vitepress/theme/components/ReportIssue.vue

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Hey - I've found 1 issue

Prompt for AI Agents
Please address the comments from this code review:

## Individual Comments

### Comment 1
<location path="src/.vitepress/config.js" line_range="1449" />
<code_context>
                             items: [
                                 {text: 'Visão geral de testes', link: '/pt-BR/guide/testing/overview'},
-                                {text: 'Configurando o ambiente de testes', link: '/pt-BR/guide/testing/environment-setup'},
+                                {text: 'Configuração do ambiente de testes', link: '/pt-BR/guide/testing/environment-setup'},
                                 {text: 'Testes unitários', link: '/pt-BR/guide/testing/unit'},
                                 {text: 'Testes funcionais', link: '/pt-BR/guide/testing/functional'},
</code_context>
<issue_to_address>
**Changes exceed permitted paths**

When this PR includes the shown changes, the navigation edits and issue-report label change are outside the permitted documentation directories, so this PR violates the repository’s edit-scope rule.

Keep edits within `src/cookbook`, `src/guide`, and `src/internals`, or update the repository rule to permit these paths.

Also at `src/.vitepress/theme/components/ReportIssue.vue:24`.
</issue_to_address>

Sourcery assessment

Approval pending. 1 finding to address first.

Blocking findings: src/.vitepress/config.js:1449


Sourcery is free for open source - if you like our reviews please consider sharing them ✨

Comment thread src/.vitepress/config.js
items: [
{text: 'Visão geral de testes', link: '/pt-BR/guide/testing/overview'},
{text: 'Configurando o ambiente de testes', link: '/pt-BR/guide/testing/environment-setup'},
{text: 'Configuração do ambiente de testes', link: '/pt-BR/guide/testing/environment-setup'},

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🟡 Medium · Changes exceed permitted paths

When this PR includes the shown changes, the navigation edits and issue-report label change are outside the permitted documentation directories, so this PR violates the repository’s edit-scope rule.

Keep edits within src/cookbook, src/guide, and src/internals, or update the repository rule to permit these paths.

Also at src/.vitepress/theme/components/ReportIssue.vue:24.

Prompt for AI agents
In `src/.vitepress/config.js` at line 1449:

**Changes exceed permitted paths**

When this PR includes the shown changes, the navigation edits and issue-report label change are outside the permitted documentation directories, so this PR violates the repository’s edit-scope rule.

Keep edits within `src/cookbook`, `src/guide`, and `src/internals`, or update the repository rule to permit these paths.

Also at `src/.vitepress/theme/components/ReportIssue.vue:24`.

From .github/copilot-instructions.md L22:

- Edits are permitted only in `src/cookbook`, `src/guide` and `src/internals`.

Run po4a so src/pt-BR matches the updated .po files. The Update
translations workflow cannot push to a fork branch, so the generated
files need to be part of the pull request.

This branch has not been deployed

No deployments
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