doc: contributing: Add guidance on reverting commits.

Particularly to cover the case where things might need to happen with the
build farms if changes are reverted.

* doc/contributing.texi (Commit Access): Add guidance on reverting commits.

Change-Id: Iba320b76b0927b693c75054b5473a50bdd77c7ee
This commit is contained in:
Christopher Baines 2024-12-18 17:43:32 +00:00
parent ddbb59f9bc
commit 321edcf074
No known key found for this signature in database
GPG key ID: 5E28A33B0B84F577

View file

@ -2945,6 +2945,20 @@ implicitly blame them, which is unhelpful. Accountability comes from
a consensus about the problem, learning from it and improving a consensus about the problem, learning from it and improving
processes so that it's less likely to reoccur. processes so that it's less likely to reoccur.
@subsubsection Reverting commits
Like normal commits, the commit message should state why the changes are
being made, which in this case would be why the commits are being
reverted.
If the changes are being reverted because they led to excessive number
of packages being affected, then a decision should be made whether to
allow the build farms to build the changes, or whether to avoid
this. For the bordeaux build farm, commits can be ignored by adding them
to the @code{ignore-commits} list in the
@code{build-from-guix-data-service} record, found in the bayfront
machine configuration.
@subsection Commit Revocation @subsection Commit Revocation
In order to reduce the possibility of mistakes, committers will have In order to reduce the possibility of mistakes, committers will have