diff --git a/PT/asciidoc/src/03_context_and_scope.adoc b/PT/asciidoc/src/03_context_and_scope.adoc index 92c75be..1c038e6 100644 --- a/PT/asciidoc/src/03_context_and_scope.adoc +++ b/PT/asciidoc/src/03_context_and_scope.adoc @@ -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 @@ -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[] diff --git a/PT/asciidoc/src/05_building_block_view.adoc b/PT/asciidoc/src/05_building_block_view.adoc index 82e431d..1e5caad 100644 --- a/PT/asciidoc/src/05_building_block_view.adoc +++ b/PT/asciidoc/src/05_building_block_view.adoc @@ -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_. @@ -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[]