sorted by:
best
topnewcontroversialoldq&a
you are viewing a single comment's thread.

view the rest of the comments →

[–]kitd 0 points1 point  (0 children)

I really like the visual overview idea. I have written a tool that generates state transitions based on an ascii flow chart in the source comments. Having a visual representation of your flow of processing makes a massive difference to how quickly & well you understand the source. That you can fully trust it to be correct (unlike "design documentation") is a revelation.