Learn to Program—Stage 6 (Documentation) 2


This is probably the easiest stage—or should be.  You should be creating documentation as you go through the previous stages (from your IPO and PAC charts to the flowcharts to pseudocode and UML diagrams and finally the code itself and results of testing).  Stage 6 is writing up the final documentation explaining what you were trying to accomplish and how you did it.  It should organize the documents from the other stages.

This is also the stage that most people hate to do.  The thing is when someone else has to do Stage 7 (Maintenance) or someone wants to upgrade your programs to solve a new problem, this documentation will make their (or your) lives a million times easier.  Documentation includes the comments inside of your code—but should not be limited to that.

You should also include any problems that you had and how you overcame them (or the workarounds that you put in place until you can overcome the problems).  It should include features that you started, but could not implement—along with information on how far into the feature you were able to delve.  Included in the problems are other experiences that you had.  Even if they aren’t problems, if they are something that another coder may find useful (or you may find useful down the road), document them.

If you’ve been keeping accurate documents along the way, this should be the easiest step for you.  If you haven’t been keeping accurate documentation, then you have just entered Dante’s fifth plane of Hell.  Either way, this will ease the transition into Stage 7.

And with that, we will cover Stage 7 (Maintenance).

Have a great day:)
Patrick.


Leave a Reply to PatsComputerServices Cancel reply

Your email address will not be published. Required fields are marked *

2 thoughts on “Learn to Program—Stage 6 (Documentation)

  • Bulk CD Replication

    I am doing some analysis for my presentations. I have completed my work and now i am doing the documentation for it. I hope that it 'll be very beneficial for me. At this time i am working on stage 6 and i am very much closer to the stage 7. Please pray for me.

  • PatsComputerServices

    Well I have a feeling that unless this was a new concept, you're already doing maintenance. And in some cases Stage 7 is the easiest stage. You're basically putting out smoldering hotspots (bugs in the code) and adding minor features to the existing program.

    Please write back with your experiences in the documentation stage. Did you have enough documentation from the previous stages to make it easier? Or did you have to scramble to remember everything?

    Have a great day, and thanks for stopping by. 🙂
    Patrick.