doc: Document committer authorization.
authorLudovic Courtès <ludo@gnu.org>
Sat, 2 May 2020 21:46:10 +0000 (23:46 +0200)
committerLudovic Courtès <ludo@gnu.org>
Mon, 4 May 2020 07:56:13 +0000 (09:56 +0200)
* doc/contributing.texi (Commit Access): Add instructions for
authorizing committers.

doc/contributing.texi

index 31b875f..0ec7a48 100644 (file)
@@ -1192,13 +1192,23 @@ Maintainers ultimately decide whether to grant you commit access,
 usually following your referrals' recommendation.
 
 @item
+@cindex OpenPGP, signed commits
 If and once you've been given access, please send a message to
 @email{guix-devel@@gnu.org} to say so, again signed with the OpenPGP key
 you will use to sign commits (do that before pushing your first commit).
 That way, everyone can notice and ensure you control that OpenPGP key.
 
-@c TODO: Add note about adding the fingerprint to the list of authorized
-@c keys once that has stabilized.
+@quotation Important
+Before you can push for the first time, maintainers must:
+
+@enumerate
+@item
+add your OpenPGP key to the @code{keyring} branch;
+@item
+add your OpenPGP fingerprint to the @file{.guix-authorizations} file of
+the branch(es) you will commit to.
+@end enumerate
+@end quotation
 
 @item
 Make sure to read the rest of this section and... profit!