diff --git a/doc/_static/pagure_custom_pr.png b/doc/_static/pagure_custom_pr.png
new file mode 100644
index 0000000..5086d23
Binary files /dev/null and b/doc/_static/pagure_custom_pr.png differ
diff --git a/doc/pr_custom_page.rst b/doc/pr_custom_page.rst
new file mode 100644
index 0000000..d1e57ee
--- /dev/null
+++ b/doc/pr_custom_page.rst
@@ -0,0 +1,74 @@
+Customize the PR page
+=====================
+
+Pagure offers the possibility to customize the page to create pull-request
+to add your specific information, such as: please follow the XYZ coding style,
+run the tests or whatever you wish to inform contributors when they open a
+new pull-request.
+
+The customization is done via a file in the git repository containing the
+meta-data for the pull-requests. This file must be placed under a ``templates``
+folder, be named ``contributing.md`` and can be formated as you wish using
+markdown.
+
+
+Example
+-------
+
+For a project named ``test`` on ``pagure.io``.
+
+* First, clone the pull-request git repo [#f1]_ and move into it
+
+::
+
+    git clone ssh://git@pagure.org/requests/test.git
+    cd test
+
+* Create the templates folder
+
+::
+
+    mkdir templates
+
+* Create the customized PR info
+
+::
+
+    vim templates/contributing.md
+
+And place in this file the following content:
+
+::
+
+    Contributing to test
+    ====================
+
+    When creating a pull-request against test, there are couple of items to do
+    that will speed up the review process:
+
+    * Ensure the unit-tests are all passing (cf the ``runtests.sh`` script at the
+      top level of the sources)
+    * Check if your changes are [pep8](https://www.python.org/dev/peps/pep-0008/)
+      compliant for this you can install ``python-pep8`` and run the ``pep8`` CLI
+      tool
+
+
+* Commit and push the changes to the git repo
+
+::
+
+    git add templates
+    git commit -m "Customize the PR page"
+    git push
+
+
+* And this is how it will look like
+
+.. image:: _static/pagure_custom_pr.png
+        :target: _static/pagure_custom_pr.png
+
+
+
+.. [#f1] All the URLs to the different git repositories can be found on the
+         main page of the project, on the right-side menu, under the section
+         ``Source GIT URLs``, click on ``more`` to see them.
diff --git a/doc/usage.rst b/doc/usage.rst
index ec62a02..c7985ba 100644
--- a/doc/usage.rst
+++ b/doc/usage.rst
@@ -12,3 +12,4 @@ Contents:
 
    theming
    ticket_templates
+   pr_custom_page