Location: PHPKode > projects > Pieforms > pieforms-php5-0.2.2/doc/geshi/docs/developers/cvs.html
<html>
<head>
    <title>GeSHi - CVS</title>
</head>
<body>
<h1>CVS</h1>

<h2>Commit Guidelines</h2>

<ul>
    <li>Document the changes, the changes should be a short and broad summary of the diff</li>
    <li>document <em>why</em> you made your changes, if appropriate. A diff can't tell us
    that unless it's a parse error</li>
    <li>never have an empty comment at all</li>
    <li>your commits go to a mailing list and to other developers, so don't swear</li>
    <li>English only</li>
    <li>Mention bug numbers (at or near the front of the line) if you are fixing or partially
    fixing a bug, or perhaps if you've regressed a bug</li>
    <li>Keep it reasonably short (I would expect most commits to be 50-300 chars)</li>
</ul>

<h3>examples</h3>

<p>"Optimised method foo" is NOT good: to vague</p>

<p>"Optimised method foo by applying algorithm bar, which means that method
baz doesn't need to be called so often" is good: contains a what
(optimised method foo), a how (applied algorithm bar, if someone is
interested they can read the diff), and a why.</p>

</body>
</html>
Return current item: Pieforms