Document how to change the watch status of someone in dist-git

Signed-off-by: Pierre-Yves Chibon <pingou@pingoured.fr>
This commit is contained in:
Pierre-Yves Chibon 2020-06-14 21:19:28 +02:00
parent 2871a87f7a
commit 96dccc0dd6

47
update_watch_dist_git.md Normal file
View file

@ -0,0 +1,47 @@
# How to udpate the watch status of someone in dist-git?
Let's start with: how to see someone's watch status?
There are two ways you can check this:
* Check the API
Visit https://src.fedoraproject.org/api/0/<namespace>/<name>/watchers
ie: https://src.fedoraproject.org/api/0/rpms/borgbackup/watchers
it will give you information about all the watchers and what they watch.
* Using pagure-admin
On the pagure host, run:
``pagure-admin get-watch <namespace>/<name> <usernme>``, for example:
``pagure-admin get-watch rpms/borgbackup bpereto`` and it will return you the
current watch status of that user on that project (or None if it is the
default status).
Now how do you update this?
* Using pagure-admin
On the pagure host, run:
``pagure-admin update-watch <namespace>/<name> <usernme>``
You will be prompted with options about which status to set, use ``-1`` to
revert to the default status.
Example:
::
# pagure-admin update-watch rpms/borgbackup bpereto
Using configuration file `/etc/pagure/pagure.cfg`
The watch status can be one of the following:
-1: reset the watch status to default
0: unwatch, don't notify the user of anything
1: watch issues and PRs
2: watch commits
3: watch issues, PRs and commits
Status:-1
Updating watch status of bpereto to -1 (reset the watch status to default) on rpms/borgbackup