The way to capture the content of a conversation like that, so that more than one person at a time can easily benefit from it, is in a theory of operation docum

The way to capture the content of a conversation like that, so that more than one person at a time can easily benefit from it, is in a theory of operation document with appropriate illustrations. Simple block diagrams will take you far before you need to specify something in the level of detail that the UML supports. I like the range of approaches in the Architecture of Open Source Applications books: http://aosabook.org/en/index.html http://aosabook.org/en/index.html