I generate dot files (graphviz) based on code. It's an amazing tool, both for understanding how the code behaves and as a communication tool others. The clear

I generate dot files (graphviz) based on code. It's an amazing tool, both for understanding how the code behaves and as a communication tool others. The clear advantage is that the documentation is always up to date. Spend time once to develop your tool, generate your doc at any time you want with almost zero cost. For a simple state machine sed/grep/awk magic is sufficient to generate a dot file. For a more complex data processing graph, I use boost graph.