14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
|
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
|
-
+
-
+
+
+
|
<h2>Source files</h2>
* Header comment includes copyright notice, license information, and author contact info.
* (Racket) All comments on their own line begin with <code>;;</code>
<h2>Pre-commit checklist</h2>
# Run <code>fossil diff --tk</code> to ensure all edits are related.
# If any files have been added with <code>fossil add</code> ensure the makefile is up to date.
# If any files have been added with <code>fossil add</code>, ensure the makefile is up to date.
# Ideally, any documentation (Scribble files) should be updated at the same time as the source code.
# Make sure you’re on the correct branch.
<h2>Commit messages</h2>
* Commit messages should use the imperative voice.
* Commit messages should be no more than ≈ 50 characters long.
* If more explanation is needed, create a ticket and cross-reference it with the commit message.
* Link a commit to a related ticket by using brackets <code>[ ]</code> containing at least the first 6 digits of the UUID.
* Comments added to tickets in connection with a resolving check-in should describe <em>why</em> the change was made, not <em>how</em> (the code does that part already).
|
