Question

I am looking for some direction as to a standard format for commenting changes in PHP. Continually while working with an assortment of developers on large scale projects, comments run wild and in most cases changes are either poorly commented or not commented at all.

Here is an example, please feel free to expand on it:

/**
 * Author: [first and last name]
 * Date Changed: [YYYY-MM-DD]
 * Description: [description]
 */

Q: Does anyone know of a standardized way of commenting changes in PHP?

Answer 1

Such things should not be put into file comments. Use revision control software to store all versions of your file (not just the latest). Never allow developers to work without it. Such software allows you to do much more with source code:

• You can find who changed each line of the file
• You can revert file to previous (or working) version
• You can create different branches of your source and merge them automatically
• You can automate building of your software and run tests automatically
• Backup your source repository and you’ll never lost your work
• … and more