[PROPOSAL] Brazilian Portuguese translation for Hyperf documentation
Author: simonscabelloCreated Jul 14, 2026Updated Jul 14, 2026
Summary
I would like to contribute a Brazilian Portuguese translation of the Hyperf documentation.
Motivation
Hyperf has a growing potential among Brazilian PHP developers, but the lack of documentation in Portuguese can make adoption more difficult, especially for developers learning concepts such as coroutines, dependency injection, AOP and microservices.
Proposed structure
The translated documentation would be added under:
docs/pt-br/
The directory would mirror the structure of docs/en/.
Translation guidelines
- Preserve code examples without translating them.
- Preserve class names, method names, configuration keys and commands.
- Use natural Brazilian Portuguese instead of literal translation.
- Keep links, Markdown structure and headings compatible with the original documentation.
- Update docs/_navbar.md and docs/index.html to register the new language.
Initial scope
- README.md
- quick-start/
- config.md
- controller.md
- router.md
- request.md
- response.md
- middleware/
- db/
- dependency injection and AOP documentation
Source: hyperf/hyperf