Ask HN: Is there a better way to document complex software architectures?
I'd like to understand if is there is some sort of "Literate Programming" approach to this problem?  Interleaving the architecture through the (combined) code + architecture document?