diff --git a/doc/contributing.texi b/doc/contributing.texi index d4784de452..c94ae940fa 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -2945,6 +2945,20 @@ implicitly blame them, which is unhelpful. Accountability comes from a consensus about the problem, learning from it and improving 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 In order to reduce the possibility of mistakes, committers will have