diff --git a/update_watch_dist_git.md b/update_watch_dist_git.md
new file mode 100644
index 0000000..b8ae5d8
--- /dev/null
+++ b/update_watch_dist_git.md
@@ -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
+