summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorLudovic Courtès <ludo@gnu.org>2025-06-07 18:38:37 +0200
committerLudovic Courtès <ludo@gnu.org>2025-06-09 22:05:14 +0200
commitff954d9c9ff7de933379a02558ce1582d3aee7f0 (patch)
tree9b9e33fd816b92aa9fbad90d06707627fec88c3f
parent37e63638207914c8cf2b227ee81115d463dd8400 (diff)
doc: Document ‘etc/teams.scm sync-codeberg-teams’.
* doc/contributing.texi (Teams): Document ‘sync-codeberg-teams’. Change-Id: I0a32c78b26f3687ed744a29a9d768b5ee597d932
-rw-r--r--doc/contributing.texi21
1 files changed, 19 insertions, 2 deletions
diff --git a/doc/contributing.texi b/doc/contributing.texi
index 9fdf4ff68d..217db850ac 100644
--- a/doc/contributing.texi
+++ b/doc/contributing.texi
@@ -2773,13 +2773,30 @@ $ guix shell -D guix
[env]$ git send-email --to=@var{ISSUE_NUMBER}@@debbugs.gnu.org -2
@end example
-To generate a @file{CODEOWNERS} file, which Forgejo uses to determine
-which team or person should review changes to a given set of files, run:
+@cindex teams, on Codeberg
+To generate a @file{CODEOWNERS} file, which Forgejo---the software
+behind Codeberg---uses to determine which team or person should review
+changes to a given set of files, run:
@example
./etc/teams.scm codeowners > CODEOWNERS
@end example
+Teams defined in @file{etc/teams.scm} are reflected
+@uref{https://codeberg.org/guix/guix, on Codeberg}; the ``Owners'' team
+on Codeberg, whose members have administration privileges over
+@uref{https://codeberg.org/guix, the entire ``organization''}, is the
+only one missing from this file. To synchronize team changes with
+Codeberg, a member of the ``Owners'' team can run:
+
+@example
+./etc/teams.scm sync-codeberg-teams @var{token}
+@end example
+
+@noindent
+... where @var{token} is a token created on the Codeberg interface
+granting access to the relevant settings.
+
@node Making Decisions
@section Making Decisions