From 4f49b16079b27d7ce633619e4cddfdf2bffbc952 Mon Sep 17 00:00:00 2001
From: cashmere <cashmere@autistici.org>
Date: Fri, 4 Sep 2026 09:05:24 +0200
Subject: initial commit

---
 www/checkin.wiki | 89 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 89 insertions(+)
 create mode 100644 www/checkin.wiki

(limited to 'www/checkin.wiki')

diff --git a/www/checkin.wiki b/www/checkin.wiki
new file mode 100644
index 0000000..88266b8
--- /dev/null
+++ b/www/checkin.wiki
@@ -0,0 +1,89 @@
+<title>Check-in Checklist</title>
+
+<h2><u>Always</u> run the following checklist prior to <u>every</u>
+check-in or commit to the Fossil repository:</h2>
+
+Before every check-in:
+
+  0.   <b>fossil user default</b> → your username is correct.
+
+  1.   <b>fossil diff</b> →
+       <ol type="a">
+       <li> No stray changes
+       <li> All changes comply with the license
+       <li> All inputs are scrubbed before use
+       <li> No injection attacks via %s formats
+       </ol>
+
+  2.   <b>fossil extra</b> → no unmanaged files need to be added.
+
+  3.   The check-in will go onto the desired branch.
+       →  Check-ins to trunk normally require approval from
+       the lead programmer (drh).
+
+  4.   auto-sync is on, or the system clock is verified
+
+  5.   If sources files have been added or removed, ensure all makefiles
+       and configure scripts have been updated accordingly.
+
+Before every check-in to <b>trunk</b>:
+
+  6.   No compiler warnings on the development machine.
+
+  7.   The fossil executable that results from a build actually works.
+
+
+<hr>
+<h2>Commentary</h2>
+
+Before you go ahead and push content back to the servers, make sure
+that the username you are using by default matches your username
+within the project. Also remember to enable the localauth setting
+if you intend to make changes via a locally served web UI.
+
+Item 1 is the most important step.  Consider using <b>gdiff</b>
+instead of <b>diff</b> if you have a graphical differ configured.  Or
+use the command-line option <b>--tk</b>.  Also consider the <b>-v</b>
+command-line option to show the complete text of newly added files.
+The recommended command for completing checklist item 1 is:
+
+   <b>fossil diff --tk -v</b>
+
+Look carefully at every changed line in item 1.
+Make sure that you are not about to commit unrelated changes.
+If there are two or more unrelated changes present, consider
+breaking up the commit into two or more separate commits.
+Always make 100% sure that all changes are compatible with the
+BSD license, that you have the authority to commit the code in accordance
+with the [/doc/trunk/www/copyright-release.html | CLA] that you have
+signed and have on file, and that
+no NDAs, copyrights, patents, or trademarks are infringed by the check-in.
+Also check very carefully to make sure that
+you are not introducing security vulnerabilities.  Pay particular attention
+to the possibility of SQL or HTML injection attacks.
+
+Item 2 verifies that you have not added source files but failed to
+do the necessary "<b>fossil add</b>" to manage them.  If you commit
+without bringing the new file under source control, the check-in will
+be broken.  That, in turn, can cause complications far in the future
+when we are bisecting for a bug.
+
+For item 3, Run "<b>fossil status</b>" or the equivalent to
+make sure your changes are going into the branch you think they are.
+Also double-check the branch name when entering change comments.
+Never check into trunk unless you are expressly authorized to do so.
+
+For Item 4, if you are on-network, make sure auto-sync is enabled.  This
+will minimize the risk of an unintended fork.  It will also give you a
+warning if you system clock is set incorrectly.  If you are off-network,
+make sure that your system clock is correct or at least close to correct
+so that your check-in does not appear out-of-sequence on timelines.
+On-network commits are preferred, especially for trunk commits.
+
+Items 6 and 7 help to ensure that check-ins on the trunk always work.
+Knowing that the trunk always works makes bisecting much easier.  Items
+6 and 7 are recommended for all check-ins, even those that are on a branch.
+But they are especially important for trunk check-ins.  We desire that
+all trunk check-ins work at all times.  Any experimental, unstable, or
+questionable changes should go on a branch and be merged into trunk after
+further testing.
-- 
cgit v1.3.1