Skip to content

Commit

Permalink
Minor fixes on PT tranlation
Browse files Browse the repository at this point in the history
  • Loading branch information
giflw committed Nov 11, 2024
1 parent 865b38f commit e0f8671
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 8 deletions.
10 changes: 5 additions & 5 deletions PT/asciidoc/src/03_context_and_scope.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -14,13 +14,13 @@ Contexto e escopo - como o nome sugere - delimita seu sistema (ou seja, seu esco
Se necessário, diferencie o contexto de negócios (entradas e saídas específicas do domínio) do contexto técnico (canais, protocolos, hardware).
.Motivação
As interfaces de domínio e as interfaces técnicas para parceiros de comunicação estão entre os aspectos mais críticos do seu sistema. Certifique-se de entendê-las completamente.
As interfaces de domínio e as interfaces técnicas para componentes externos estão entre os aspectos mais críticos do seu sistema. Certifique-se de entendê-las completamente.
.Forma
Várias opções:
* Diagramas de contexto
* Listas de parceiros de comunicação e suas interfaces.
* Listas de componentes externos e suas interfaces.
.Mais informações
Expand All @@ -35,17 +35,17 @@ ifdef::arc42help[]
[role="arc42help"]
****
.Conteúdo
Especificação de *todos* os parceiros de comunicação (usuários, sistemas de TI, ...) com explicações de entradas e saídas ou interfaces específicas do domínio.
Especificação de *todos* os componentes externos (usuários, sistemas de TI, ...) com explicações de entradas e saídas ou interfaces específicas do domínio.
Opcionalmente, você pode adicionar formatos específicos do domínio ou protocolos de comunicação.
.Motivação
Todas as partes interessadas devem entender quais dados são trocados com o ambiente do sistema.
.Forma
Todos os tipos de diagramas que mostram o sistema como uma caixa preta e especificam as interfaces de domínio para os parceiros de comunicação.
Todos os tipos de diagramas que mostram o sistema como uma caixa preta e especificam as interfaces de domínio para os componentes externos.
Como alternativa (ou adicionalmente), você pode usar uma tabela.
O título da tabela é o nome do seu sistema, as três colunas contêm o nome do parceiro de comunicação, as entradas e as saídas.
O título da tabela é o nome do seu sistema, as três colunas contêm o nome do componente externo, as entradas e as saídas.
****
endif::arc42help[]

Expand Down
6 changes: 3 additions & 3 deletions PT/asciidoc/src/05_building_block_view.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ ifdef::arc42help[]
[role="arc42help"]
****
.Conteúdo
A visão de blocos de construção mostra a decomposição estática do sistema em blocos de construção (módulos, componentes, subsistemas, classes, interfaces, pacotes, bibliotecas, frameworks, camadas, partições, níveis, funções, macros, operações, estruturas de dados, ...) bem como suas dependências (relacionamentos, associações, ...)
A visão de blocos de construção mostra a decomposição estática do sistema em blocos (módulos, componentes, subsistemas, classes, interfaces, pacotes, bibliotecas, frameworks, camadas, partições, níveis, funções, macros, operações, estruturas de dados, ...) bem como suas dependências (relacionamentos, associações, ...)
Esta visão é obrigatória para toda documentação de arquitetura.
Em analogia a uma casa, esta é a _planta baixa_.
Expand Down Expand Up @@ -55,14 +55,14 @@ Aqui você descreve a decomposição geral do sistema usando o seguinte modelo d
** use _uma_ tabela para uma visão geral curta e pragmática de todos os blocos de construção contidos e suas interfaces
** use uma lista de descrições de caixa preta dos blocos de construção de acordo com o modelo de caixa preta (veja abaixo).
Dependendo da sua escolha de ferramenta, esta lista pode ser subcapítulos (em arquivos de texto), subpáginas (em um Wiki) ou elementos aninhados (em uma ferramenta de modelagem).
Dependendo da sua escolha de ferramenta, esta lista pode ser subcapítulos (em arquivos de texto), subpáginas (em uma Wiki) ou elementos aninhados (em uma ferramenta de modelagem).
* (opcional:) interfaces importantes, que não são explicadas nos modelos de caixa preta de um bloco de construção, mas são muito importantes para entender a caixa branca.
Já que há tantas maneiras de especificar interfaces, por que não fornecer um modelo específico para elas?
No pior caso, você tem que especificar e descrever sintaxe, semântica, protocolos, tratamento de erros,
restrições, versões, qualidades, compatibilidades necessárias e muito mais.
Na melhor das hipóteses, você conseguirá usar exemplos ou assinaturas simples.
Na melhor das hipóteses, você conseguirá usar exemplos ou descrições simples.
****
endif::arc42help[]
Expand Down

0 comments on commit e0f8671

Please sign in to comment.