El código no nos dice toda la historia

Simon brown ha publicado un articulo con el que estoy muy de acuerdo; se trata del por qué es bueno documentar la arquitectura del software, ya que los comentarios en el código fuente no nos ayudan a entender del todo como funciona el sistema. Una lectura ampliamente recomendable. Link: Coding The Architecture