소프트웨어 아키텍처 에서 문서화 는 지도 를 만드는 것과 비슷하다. 그렇게까지 복잡할 필요가 없는 소프트웨어가 문득 정신 차리고 보니 복잡해져 있는 이유는 길을 잃었기 때문이다 이때 잘 작성된 문서가 필요하다 문서와 소프트웨어를 동치시켜가며 둘 다를 개선시키는 것이 아키텍처 방법론의 기본이 되어야 한다 클린코드라면 문서화가 필요하지 않다는 의견도 있지만 나는 동의하지 않는다
문서화를 회계에 비유하자면 구멍가게는 장부가 없거나 약식 부기로도 비즈니스가 가능하겠지만 규모가 있는 비즈니스라면 제대로 작성된 회계장부가 필요하다 회계장부는 실제 비즈니스와 동치되어야하고 비즈니스를 개선할 때 회계장부를 보고 개선을 한다