diff --git a/docs/images/update-for-release.uml b/docs/images/update-for-release.uml
new file mode 100644
--- /dev/null
+++ b/docs/images/update-for-release.uml
@@ -0,0 +1,24 @@
+@startuml
+  participant DEV as "developer local git repository"
+  participant REPO as "git-repository (~ phabricator)"
+  participant CI as "update-for-release job"
+
+  activate DEV
+  activate REPO
+  activate CI
+
+  DEV->REPO: pushes new tag on master branch
+  deactivate DEV
+  REPO-->CI: trigger event to notify changes
+  CI->REPO: clone repository locally
+  CI-->CI: check for existing upstream tag
+  alt If the upstream tag do not exist
+    CI-->CI: retrieves tag information
+    CI-->CI: imports pypi source tarball
+    CI-->CI: commits new debian/changelog entry for debian/unstable-swh release
+    alt If not params.DRY_RUN
+      CI->REPO: pushes new commit and tag on branch debian/unstable-swh
+    end
+  end
+
+@enduml