== Commit Rules ==

=== Using sensible commit messages ===

When committing your changes to MacPorts' central port tree using subversion it is good practice to use properly formatted commit messages.

Think about others reading the [https://trac.macports.org/timeline timeline]. Here you want to see on first glance which port got modified, therefore the required format for commit messages is this:
{{{
PORTNAME: COMMENT
}}}
Here a reader of MacPorts' timeline can quickly get the most important information, i.e. WHICH port got changed and WHY.

A real-life example is:
{{{
devel/zmq: Fix build on darwin <= 10, closes #40663
}}}
Note that references to [https://trac.macports.org/wiki/Tickets trac tickets] can be inserted using the '#' as well as references to certain commits of the MacPorts repository by using 'r' (e.g. r111866).