diff --git a/doc/theming.rst b/doc/theming.rst
index 988f93f..a51efec 100644
--- a/doc/theming.rst
+++ b/doc/theming.rst
@@ -13,3 +13,43 @@ By specifying the configuration keys ``THEME_TEMPLATE_FOLDER`` and
 ``THEME_STATIC_FOLDER`` in pagure's configuration file, you tell pagure to
 look for templates and static files first in these folders, then in its
 usual folders.
+
+
+Let's take an example, you wish to replace the pagure logo at the top right
+of all the pages.
+
+This logo is part of the ``master.html`` template which all pages inherit
+from. So what you want to do is replace this ``master.html`` by your own.
+
+* First, create the folder where your templates and static files will be stored:
+
+::
+
+    mkdir /var/www/mypaguretheme/templates
+    mkdir /var/www/mypaguretheme/static
+
+* Place your own logo in the static folder
+
+::
+
+    cp /path/to/your/logo /var/www/mypaguretheme/static
+
+* Place in there the original ``master.html``
+
+::
+
+    cp /path/to/original/pagure/templates/master.html /var/www/mypaguretheme/templates
+
+* Edit it and replace the url pointing to the pagure logo (around line 27)
+
+::
+
+    - <img height=40px src="{{ url_for('static', filename='pagure-logo.png') }}"
+    + <img height=40px src="{{ url_for('static', filename='my-logo.png') }}"
+
+* Adjust pagure's configuration file:
+
+    + THEME_TEMPLATE_FOLDER='/var/www/mypaguretheme/templates'
+    + THEME_STATIC_FOLDER='/var/www/mypaguretheme/static'
+
+* Restart pagure