Skip to content

[WIP] - Add Brazilian Portuguese (pt-BR) translation#1112

Draft
Rychillie wants to merge 8 commits intovapor:mainfrom
Rychillie:Rychillie/vapor-docs-pt-br
Draft

[WIP] - Add Brazilian Portuguese (pt-BR) translation#1112
Rychillie wants to merge 8 commits intovapor:mainfrom
Rychillie:Rychillie/vapor-docs-pt-br

Conversation

@Rychillie
Copy link
Copy Markdown

@Rychillie Rychillie commented Mar 29, 2026

Summary

Adds complete Brazilian Portuguese (pt-BR) translation for the Vapor documentation.

What was implemented

Setup

  • Registered pt locale in mkdocs.yml with full nav_translations mapping
  • Added pt-BR entry to .github/translation_needed.description.leaf

Translated Sections

Install & Getting Startedindex.pt.md, macOS, Linux, Hello World, Folder Structure, SPM, Xcode

Basics — Routing, Controllers, Content, Client, Validation, Async, Logging, Environment, Errors

Fluent — Overview, Model, Schema, Query, Relations, Migration, Transaction, Advanced

Leaf — Overview, Getting Started, Custom Tags

Redis — Overview, Sessions

Security — Passwords, Crypto, JWT, Authentication

Advanced — APNS, Commands, Files, Middleware, Queues, Request, Server, Services, Sessions, Testing, Tracing, WebSockets

Deploy — Docker, Fly, Heroku, DigitalOcean, Nginx, Supervisor, Systemd

Contributing — Contributing Guide

Version — Legacy Docs redirect

Translation Guidelines

  • Informal tone using "você"
  • All code blocks, terminal commands, paths, and API names kept in English
  • Technical terms (middleware, handler, framework, async/await, deploy, etc.) kept in English
  • Brazilian Portuguese conventions ("arquivo" not "ficheiro")
  • Admonition titles translated ("Dica", "Nota", "Aviso")
  • Internal links unchanged (i18n plugin resolves automatically)

@Rychillie Rychillie requested review from a team, 0xTim and gwynne as code owners March 29, 2026 22:08
@Rychillie Rychillie changed the title Add Brazilian Portuguese (pt-BR) translation: setup and initial pages [WIP] - Add Brazilian Portuguese (pt-BR) translation: setup and initial pages Mar 29, 2026
@Rychillie Rychillie changed the title [WIP] - Add Brazilian Portuguese (pt-BR) translation: setup and initial pages [WIP] - Add Brazilian Portuguese (pt-BR) translation Mar 29, 2026
@Rychillie Rychillie marked this pull request as draft March 29, 2026 22:10
@bolodissenoura

This comment was marked as spam.

@lucianfialho

This comment was marked as spam.

@Andsu-dev

This comment was marked as spam.

@TheHandyOwl TheHandyOwl added the translation-update This PR contains translations for the docs label Apr 2, 2026
Add Portuguese language configuration to mkdocs.yml with all nav_translations,
update translation_needed issue template, and translate the first 7 pages:
index, install (macOS/Linux), and getting-started (hello-world, folder-structure,
spm, xcode).
…nt, client, validation, async, logging, environment, errors)
…ery, relations, migration, transaction, advanced)
…ddleware, queues, request, server, services, sessions, testing, tracing, websockets)
…(docker, fly, heroku, digital-ocean, nginx, supervisor, systemd, contributing, legacy-docs)
@Rychillie Rychillie force-pushed the Rychillie/vapor-docs-pt-br branch from c671e42 to 9e29f74 Compare April 5, 2026 18:17
… strings, and placeholders across all 47 files
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

translation-update This PR contains translations for the docs

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants