Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Minor fixes on PT tranlation #205

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Minor fixes on PT tranlation #205

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions PT/asciidoc/src/03_context_and_scope.adoc
View file
Open in desktop
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
View file
Open in desktop
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
Loading