|The stupid question is the question not asked|
Re^3: Code Critiqueby TGI (Parson)
|on Oct 11, 2010 at 06:44 UTC||Need Help??|
I am a big fan of design by comments, at least for relatively simple projects.
What this means is, start with an English (or whatever language makes sense to you) description of what the program should do. Keep it all very simple and high level. Don't go into great detail about formats and so forth at first.
Now you can write some code. Keep everything related to the current idea all on one screen of text. If it gets too long, wave your hands and invent a subroutine name.
Now, the top level of abstraction is done. Of course the code won't work yet. We've waved our hands an awful lot. We now need to implement each sub we invented to avoid having to think about the details of what we're doing.
Each sub is effectively its own little program. Repeat this process for each subroutine until they are all written. For example, we can be very concrete about how we convert a foo file name into a csv file name. No need for additional subs:
Something like sanitize_data() may be more complex, and even need a good number of subs of its own.
Once you've fleshed out all the subs, your code will be done.
For existing code, work in reverse. Label things. Describe what is happening. Take big blocks of code and move them into a sub and replace them with descriptively named routines.