My favorites | Sign in
Project Home Downloads Wiki Issues Source
Search
for
CommitRules  
The parameters that must be met before committing
Featured, Phase-Implementation, Phase-Requirements
Updated Jun 24, 2011 by jonahbron.d

Commit Rules

These parameters must be met before committing to the trunk.

Unit Tests

  • If new code was created, unit tests must be created for that code.
  • All unit tests pertaining to the changed code must be tested, and passed.

PHPDoc Headers/Comments

  • Valid PHPDoc comments must be created for any files, classes, public class properties/constants, or public methods.
  • PHPDoc comments are optional for protected methods/properties.
  • Valid PHPDoc commets must be created for any code changed that did not already have them.
  • PHPDoc comments must be updated to reflect any changes made.

Comments

  • Private class variables can have a single line comment or block comment if necessary.
  • Be rigorous about keeping comments up to date.
  • Commented-out code is a no-no. Either delete it, or (fix and?) integrate it.

Log Message

  • Prefix your message with the class/folder your changes apply to enclosed in square brackets. For example: "[A_Db_Recordset_MySQL] Did something blah blah...", or "[A_Db] Did something else...".
  • Provide a thorough description of what changes were made. Separate items with new lines.
  • Avoid committing changes to more than one class at a time, the exception being if the changes depend on each other.

Syntax Standards

At this point, the PEAR Codesniffer standard to check against has not been yet decided. Until then, check with Zend, and ignore any line length or tab errors Refer to this document: SyntaxStandards .


Sign in to add a comment
Powered by Google Project Hosting