diff --git a/docs/images/.gitignore b/docs/images/.gitignore
new file mode 100644
--- /dev/null
+++ b/docs/images/.gitignore
@@ -0,0 +1,2 @@
+*.svg
+*.png
\ No newline at end of file
diff --git a/docs/images/Makefile b/docs/images/Makefile
new file mode 100644
--- /dev/null
+++ b/docs/images/Makefile
@@ -0,0 +1,13 @@
+UML_DIAGS_SRC = $(wildcard *.uml)
+UML_DIAGS = $(patsubst %.uml,%.svg,$(UML_DIAGS_SRC),%.png)
+
+all: $(UML_DIAGS)
+
+%.svg: %.uml
+	DISPLAY="" plantuml -tsvg $<
+
+%.png: %.uml
+	DISPLAY="" plantuml -tpng $<
+
+clean:
+	-rm -f $(DEP_GRAPHS) $(UML_DIAGS)
diff --git a/docs/images/debian-build-jobs.uml b/docs/images/debian-build-jobs.uml
new file mode 100644
--- /dev/null
+++ b/docs/images/debian-build-jobs.uml
@@ -0,0 +1,37 @@
+@startuml
+  participant TAG_AND_PUSH as "tag-and-push" order 1
+  participant UPDATE_FOR_RELEASE as "update-for-release" order 2
+  participant GBP_BUILDPACKAGE as "gbp-buildpackage" order 3
+  participant AUTOMATIC_BACKPORT as "automatic-backport" order 4
+
+  legend left
+    | short name | full name |
+    | unstable-swh | debian/unstable-swh branch |
+    | stretch-swh | debian/stretch-swh branch |
+    | changelog | debian/changelog file |
+    | swh's debian repo | https://debian.softwareheritage.org |
+  endlegend
+
+  activate TAG_AND_PUSH
+  activate UPDATE_FOR_RELEASE
+  TAG_AND_PUSH->UPDATE_FOR_RELEASE: developer pushes new tag in master branch
+
+  UPDATE_FOR_RELEASE-->UPDATE_FOR_RELEASE: jenkins edits changelog for new release \non unstable-swh (using tag's information)
+  deactivate TAG_AND_PUSH
+
+  activate GBP_BUILDPACKAGE
+  UPDATE_FOR_RELEASE->GBP_BUILDPACKAGE: jenkins pushes new commit and tag on unstable-swh
+  GBP_BUILDPACKAGE-->GBP_BUILDPACKAGE: gbp builds/uploads unstable-swh package to swh's debian repo
+  deactivate UPDATE_FOR_RELEASE
+
+  activate AUTOMATIC_BACKPORT
+  GBP_BUILDPACKAGE->AUTOMATIC_BACKPORT: gbp pushes new tag on unstable-swh
+  AUTOMATIC_BACKPORT-->AUTOMATIC_BACKPORT: jenkins merges unstable-swh in stretch-swh\njenkins edits changelog for new backport \nrelease on stretch-swh
+
+  AUTOMATIC_BACKPORT->GBP_BUILDPACKAGE: jenkins pushes new tag on the stretch-swh branch
+
+  GBP_BUILDPACKAGE-->GBP_BUILDPACKAGE: gbp builds/uploads stretch backports package\ngbp pushes new tags stretch-swh branch
+
+  deactivate AUTOMATIC_BACKPORT
+  deactivate GBP_BUILDPACKAGE
+@enduml