pagure/doc/usage/pr_custom_page.rst

Customize the PR page
=====================

Pagure offers the possibility to customize the page that creates 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 formatted 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.io/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.