#7776·hyperf

[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