From 0afe07bb0272d39e316668550cc73d6e2621495f Mon Sep 17 00:00:00 2001
From: Clement Verna <cverna@tutanota.com>
Date: Sep 27 2017 20:05:27 +0000
Subject: Update the documentation on how to create pull requests.


Signed-off-by: Clement Verna <cverna@tutanota.com>

---

diff --git a/doc/usage/_static/pagure_pr_commits.png b/doc/usage/_static/pagure_pr_commits.png
new file mode 100644
index 0000000..5040bd8
Binary files /dev/null and b/doc/usage/_static/pagure_pr_commits.png differ
diff --git a/doc/usage/_static/pagure_pr_overview.png b/doc/usage/_static/pagure_pr_overview.png
new file mode 100644
index 0000000..e5a5065
Binary files /dev/null and b/doc/usage/_static/pagure_pr_overview.png differ
diff --git a/doc/usage/_static/pagure_pr_pull_requests.png b/doc/usage/_static/pagure_pr_pull_requests.png
new file mode 100644
index 0000000..2ecf6ed
Binary files /dev/null and b/doc/usage/_static/pagure_pr_pull_requests.png differ
diff --git a/doc/usage/pull_requests.rst b/doc/usage/pull_requests.rst
index b6533cf..64b14e7 100644
--- a/doc/usage/pull_requests.rst
+++ b/doc/usage/pull_requests.rst
@@ -17,19 +17,68 @@ Before you can open a pull request, you need to complete the :ref:`first-steps`
 and :ref:`create-fork` of the project you would like to contribute to. Once
 you have a fork and you have pushed a `git branch <https://git-scm.com/docs/git-branch>`_
 containing one or more `commits <https://git-scm.com/docs/git-commit>`_, you are
-ready to contribute to the project. Navigate to the project's Pull Request page
-and click on the ``File Pull Request`` button.
+ready to contribute to the project.
 
-A dropdown menu should appear containing the git branches in your fork. Select the
-branch containing your changes. You will be taken to a page where you can customize
-the title of your Pull Request and its description. By default, this is populated
-using your commit message.
+Pagure to Pagure pull request 
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Once you are satisfied with your title and description, click ``Create``.
+You can create a pull request from a pagure project, using one of the following options
 
-Congratulations! It is now up to the project maintainer to accept your changes by
-merging them.
+From the project overview 
+*************************
 
+#. Go the the ``overview`` tab of your fork.
+
+#. Locate your feature branch (Right hand side), and press the button ``New PR`` button.
+
+#. Fill the Create a pull request form (Title and Description) and create your pull request.
+
+Notes: The ``New PR`` button appears only if there are commits not available in the main branch.
+
+.. image:: _static/pagure_pr_overview.png
+	:target: ../_images/pagure_pr_overview.png
+
+From the commits history 
+************************
+
+#. Go to the ``commit`` tab of your fork and select your feature branch.
+
+#. Press the ``create pull request`` button (above the latest commits).
+
+#. Fill the Create a pull request form (Title and Description) and create your pull request.
+
+.. image:: _static/pagure_pr_commits.png
+	:target: ../_images/pagure_pr_commits.png
+
+From the pull requests list
+***************************
+
+#. Go to the main project's (not your fork) pull requests list and press the ``File Pull Request`` button.
+   
+#. Select the feature branch containing your changes from the dropdown menu. 
+
+#. Fill the Create a pull request form (Title and Description) and create your pull request.
+
+.. image:: _static/pagure_pr_pull_requests.png
+	:target: ../_images/pagure_pr_pull_requests.png
+ 
+Remote Git to Pagure pull request 
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You can create a pull request from an other git hosting platform (eg github, gitlab).
+This is a remote pull request.
+
+From the pull requests list
+***************************
+
+#. Go to the main project's (not your fork) pull requests list and press the ``File Pull Request`` button.
+   
+#. Select the ``Remote pull-request`` option from the dropdown menu.
+
+#. Fill the New remote pull-request form (Title, Git repo address and Git branch) and create your remote pull request. 
+
+Congratulations! It is now up to the project maintainer to accept your changes
+by merging them.
 
 .. _update-pull-request: