La mejor forma de documentar la arquitectura de un sistema intensivo en software es la combinar en un mismo documento, tanto los detalles del diseño en UML como los detalles relacionados con la implementación en código del proyecto. Aspectos tales como la vista del modelo de datos o el esquema de paquetes pertenecen al primer grupo, en tanto que el lugar donde se puede conseguir el código y la estructura de directorios que se genera con este, son puntos a tratar en el segundo bloque.

Por otra parte, es necesario enlazar con los requisitos, de ser posible con los casos de uso, ya que de esta forma se deja en claro que parte del sistema se ha cubierto con la arquitectura que se pretende documentar.

Y de primero claro, podemos discutir el posicionamiento de la arquitectura, quizás indicando los principios de diseño que guiaron el desarrollo.

Finalmente, adjunto la plantilla del Documento de Arquitectura del Sistema:

Arquitectura del Sistema(Plantilla)

Si tiene problemas con esta plantilla y quiere tener algunas sugerencias sobre características deseables en un documento de arquitectura del sistema, tengo un post sobre la lista de Michael Stal que le puede resultar útil.