코드 밖 커뮤니케이션

CHAPTER 06 문장의 구성

시각적 구성^{visual composition}은 문서화할 시스템의 구조, 관계 및 종속성을 전달하는 데 도움이 되므로 소프트웨어 아키텍처 다이어그램의 필수 요소다. 효과적인 시각적 구성은 다이어그램의 가독성을 높여주고 독자가 쉽게 이해할 수 있도록 도와준다.

이 장에서는 독자가 오해하지 않고 다이어그램의 내러티브를 따라갈 수 있도록 다이어그램을 구성하는 방법을 살펴본다.

가독성이 떨어지는 다이어그램

다이어그램을 만들 때는 다이어그램을 어떻게 소비할지, 또 누가 소비할지 고려해야 한다. 다음은 가독성이 떨어지는 다이어그램 안티패턴^{illegible diagram antipattern}을 방지하기 위한 몇 가지 팁이다.

draw.io나 비지오^Visio 같은 툴에서 다이어그램을 만들 때는 대부분 기본 캔버스를 사용한다. 기본 캔버스는 일반적으로 A4 또는 레터^Letter1 크기이며 세로 방향인 경우가 많다. 독자가 과연 세로로 종이에 인쇄된 다이어그램을 볼까? 요즘에는 더더욱 없을 것이다.

어쩌면 독자는 마이크로소프트 워드^{Microsoft Word} 또는 오픈 오피스 라이터^{Open Office Writer}(기본값은 A4 또는 레터, 세로)의 문서 내에서 다이어그램을 사용할 수도 있다. 그런 경우 세로 캔버스에 다이어그램을 ...