http://www.perlmonks.org?node_id=50502


in reply to Planning your software before writing

Flowcharts are good, but whats much more valueable to me is documentation of the data structures, and a heirarchial diagram of how you implemented the processes of the flow diagram. Documenting the objects is very valuable(both data and the code itself - if its object oriented).

Flowcharts alone don't go very far with me, they leave a lot unsaid..up to your interpretation/guesswork. If all you have is the flow diagram, you need to delineate where/how the various tasks in the flow are implemented in the coded routines.