Documenting changes

[eluser]James Gifford[/eluser]
Hi everyone.

I have been making extensive changes to CI's core libraries for a current project and I haven't been doing a great job of documenting the changes I made for future reference. I was just wondering what conventions other developers use when modifying someone else's code.

I'm currently going back and commenting any changes with my initials and a brief explanation of what I was thinking at the time. I wish now that I had commented out the original code and added my own rather than overwriting it.

Does anyone have any preferences for this sort of thing?