We have been working on updating a cool dating website (well at least I think that it is cool
), to make it meet some of the new web 2.0 standards. The project involves revamping the original site, so we have inherited the previous code from the initial developer. I have been trying to do some backwards engineering of the code, to try and figure out how the site works. This is however proving to be quite a task because the previous developer did not put much effort into commenting and there is some quite complex code to sift through.
While I was studying, my programming lecturer always talked about the importance of commenting and he used to subtract marks from projects if the code wasn’t commented correctly. I am now realising how important a simple thing like commenting can be, especially if there are multiple developers working on a project.
I am sure that a vast majority of developers do use comments in their code and I will definetly make sure to use them more appropriately in the future






You are spot on about comments. Some simple comments can go a very long way in helping one understand what the heck is going on. All too often developers don’t think someone else will be picking up the pieces of the code.
Another idea which i’ve come across is implementing some sort of code checking software that actually checks that source code is properly commented amongst other things.