doc: Document ‘etc/teams.scm sync-codeberg-teams’.

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

Change-Id: I0a32c78b26f3687ed744a29a9d768b5ee597d932

1 files 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