Capítulo 6. Composição
Este trabalho foi traduzido com recurso a IA. Agradecemos o teu feedback e comentários: translation-feedback@oreilly.com
A composição visual é um aspeto essencial dos diagramas de arquitetura de software; ajuda-te a transmitir a estrutura, as relações e as dependências do sistema que está a ser documentado. Uma composição visual eficaz garante que os diagramas sejam legíveis e melhora a facilidade com que o público pode entendê-los.
Neste capítulo, vais explorar a forma como a composição dos diagramas pode aumentar a compreensão do público, como evitar induzir o público em erro e como guiá-lo através da narrativa dos diagramas.
Diagramas ilegíveis
Quando crias um diagrama, tens de considerar como será consumido e quem o irá consumir. Esta secção explica como evitar o antipadrão dos diagramas ilegíveis.
Ao criar um diagrama numa ferramenta como draw.io ou Visio, a maioria das pessoas aceita a tela padrão para trabalhar. Essa predefinição é normalmente algo como o tamanho de papel A4 ou Letter na orientação de retrato. O teu público vai ver o teu diagrama numa folha de papel impressa em retrato? Hoje em dia, isso é improvável.
Talvez o teu público consuma o diagrama num documento do Microsoft Word ou do Apache OpenOffice Writer (em que as predefinições são A4 ou Letter em retrato), mas se o teu diagrama for criado numa tela de retrato, é pouco provável que o público o consiga ver na íntegra num ecrã de computador (que é paisagem) sem ter de fazer zoom out ...
Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.
Read now
Unlock full access