guix_mirror_bot pushed a commit to branch master
in repository guix.
commit ff954d9c9ff7de933379a02558ce1582d3aee7f0
Author: Ludovic Courtès <[email protected]>
AuthorDate: Sat Jun 7 18:38:37 2025 +0200
doc: Document ‘etc/teams.scm sync-codeberg-teams’.
* 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 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
