Hello DDD Crew,
I would like to contribute a Brazilian Portuguese (pt-BR) translation of the Domain Message Flow Modelling documentation.
This resource is especially valuable for explaining how commands, events, queries, actors, bounded contexts, and systems interact within a scenario. A Brazilian Portuguese version could make the technique more accessible to the Portuguese-speaking DDD community.
Proposed scope
The initial contribution would include:
- a Brazilian Portuguese translation of the main
README.md;
- a link to the pt-BR version in the main README;
- reuse of the existing visual resources without modifying them;
- preservation of the original English labels in parentheses whenever they correspond to text displayed inside the diagrams.
The proposed directory structure is:
translations/pt-br/README.md
Terminology approach
The translation would follow the terminology already used in other accepted pt-BR contributions to DDD Crew repositories:
- contexto delimitado (Bounded Context);
- comando (command);
- evento (event);
- consulta (query);
- remetente (sender);
- destinatário (receiver);
- conteúdo da mensagem (message contents);
- fluxo de mensagens (message flow).
Official names such as Domain Message Flow Modelling, Domain Storytelling, and Miller's Law would be preserved.
Visual resources
This first contribution would reuse the original diagrams and Miro board backup, which would remain in English.
The translated README would include a note explaining that the visual resources are unchanged. When necessary, the English labels used in the diagrams would appear in parentheses next to their Portuguese equivalents so readers can correlate the documentation with the images.
Questions
- Is a Brazilian Portuguese translation welcome?
- Is
translations/pt-br/ the preferred directory structure?
- Is reusing the original English visual resources acceptable for the initial contribution?
- Should the Miro board backup remain linked only from the original resources directory?
If the proposal is accepted, I will prepare the textual translation as a focused documentation pull request.
Thank you for maintaining and sharing this resource.
Hello DDD Crew,
I would like to contribute a Brazilian Portuguese (
pt-BR) translation of the Domain Message Flow Modelling documentation.This resource is especially valuable for explaining how commands, events, queries, actors, bounded contexts, and systems interact within a scenario. A Brazilian Portuguese version could make the technique more accessible to the Portuguese-speaking DDD community.
Proposed scope
The initial contribution would include:
README.md;The proposed directory structure is:
Terminology approach
The translation would follow the terminology already used in other accepted pt-BR contributions to DDD Crew repositories:
Official names such as Domain Message Flow Modelling, Domain Storytelling, and Miller's Law would be preserved.
Visual resources
This first contribution would reuse the original diagrams and Miro board backup, which would remain in English.
The translated README would include a note explaining that the visual resources are unchanged. When necessary, the English labels used in the diagrams would appear in parentheses next to their Portuguese equivalents so readers can correlate the documentation with the images.
Questions
translations/pt-br/the preferred directory structure?If the proposal is accepted, I will prepare the textual translation as a focused documentation pull request.
Thank you for maintaining and sharing this resource.