diff --git a/doc/usage/pagure_ci_jenkins.rst b/doc/usage/pagure_ci_jenkins.rst
new file mode 100644
index 0000000..ec54ebf
--- /dev/null
+++ b/doc/usage/pagure_ci_jenkins.rst
@@ -0,0 +1,92 @@
+Jenkins with Pagure-ci
+======================
+
+Jenkins is a Continuous Integration service that can be configured to be
+integrated with pagure.
+
+This document describe the steps needed to make it work.
+
+
+How to enable Pagure CI
+=======================
+
+* Visit the settings page of your project
+
+* Scroll down to the `Hooks` section and click on `Pagure CI`
+
+* Select the type of CI service you want
+
+* Enter the URL to the project on the CI service. For example, if your
+  project is running at `http://jenkins.fedoraproject.org` you will need to
+  enter the url: `http://jenkins.fedoraproject.org/job/<projectname>`
+
+* Tick the checkbox activating the hook.
+
+
+These steps will activate the hook, after reloading the page or the tab, you
+will be given access to two important values: the token used to trigger the
+build on jenkins and the URL used by jenkins to report the status of the
+build.
+Keep these two available when configuring jenkins for your project.
+
+
+Configure Jenkins
+=================
+
+These steps can only be made by the admins of your jenkins instance, but
+they only need to be made once.
+
+* Download the following plugins:
+
+  * `Git Plugin <https://wiki.jenkins-ci.org/display/JENKINS/Git+Plugin>`_
+  * `Notification Plugin <https://wiki.jenkins-ci.org/display/JENKINS/Notification+Plugin>`_
+
+
+Configure your project on Jenkins
+=================================
+
+* Go to the `Configure` page of your project
+
+* Under `Job Notification`  click `Add Endpoint`
+
+* Fields in Endpoint will be :
+
+::
+
+    FORMAT: JSON
+    PROTOCOL: HTTP
+    EVENT: Job Finalized
+    URL: <The URL provided in the Pagure CI hook on pagure>
+    TIMEOUT: 3000
+    LOG: 1
+
+* Tick the checkbox `This build is parameterized`
+
+* Add two `String Parameters` named REPO and BRANCH
+
+* Source Code Management select Git  and give the URL of the pagure project
+
+* Under Build Trigger click on Trigger build remotely and specify the token
+  given by pagure.
+
+* Under Build -> Add build step -> Execute Shell
+
+* In the box given  enter the shell steps you want for testing your project.
+
+
+Example Script
+
+::
+
+    # Script specific for Pull-Request build
+    if [ -n "$REPO" -a -n "$BRANCH" ]; then
+    git remote rm proposed || true
+    git remote add proposed "$REPO"
+    git fetch proposed
+    git checkout origin/master
+    git config --global user.email "you@example.com"
+    git config --global user.name "Your Name"
+    git merge --no-ff "proposed/$BRANCH" -m "Merge PR"
+    fi
+
+    # Part of the script specific to how you run the tests on your project