From ff954d9c9ff7de933379a02558ce1582d3aee7f0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ludovic=20Court=C3=A8s?= <ludo@gnu.org>
Date: Sat, 7 Jun 2025 18:38:37 +0200
Subject: [PATCH] =?UTF-8?q?doc:=20Document=20=E2=80=98etc/teams.scm=20sync?=
 =?UTF-8?q?-codeberg-teams=E2=80=99.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* doc/contributing.texi (Teams): Document ‘sync-codeberg-teams’.

Change-Id: I0a32c78b26f3687ed744a29a9d768b5ee597d932
---
 doc/contributing.texi | 21 +++++++++++++++++++--
 1 file changed, 19 insertions(+), 2 deletions(-)

diff --git a/doc/contributing.texi b/doc/contributing.texi
index 9fdf4ff68da..217db850acc 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