Document how to add groups in dist-git

Signed-off-by: Pierre-Yves Chibon <pingou@pingoured.fr>
This commit is contained in:
Pierre-Yves Chibon 2020-09-02 17:43:09 +02:00
parent d4d518d9e4
commit 17ed06fde9

View file

@ -0,0 +1,32 @@
# How to create a group in dist-git?
/!\ You may want to read first groups_in_fedora.md for information on the
different types of groups in Fedora.
Dist-git does not allow anyone to create groups, only admins can do it via the
``pagure-admin`` CLI tool.
To create a group, you can simply run the command:
::
pagure-admin new-group <group_name> <username of requester> \
--description="short description" \
--display="Name used in the UI"
The group members are then sync upon their login in dist-git (ie: people will
have to log out and back in for their group membership to be refreshed).
Groups are linked to the user who created it and it used to not be possible to
give the group to another user(\*), so lots of the early groups were created to
the ``releng`` user, thus allowing to easily remove the user who asked for the
group if they left the project.
It is nowadays possible to give groups from an user to another. This can be done
by the person who is the current main admin of the group or a pagure admin.
The URL to give a group is:
::
https://src.fedoraproject.org/group/<group name>/edit