From ef6d3a66e9b2107e0aa5224bf3021a400478cce9 Mon Sep 17 00:00:00 2001
From: Pierre-Yves Chibon <pingou@pingoured.fr>
Date: Feb 06 2018 13:04:52 +0000
Subject: Document project intra-pagure hyperlinks


Fixes https://pagure.io/pagure/issue/2921

Signed-off-by: Pierre-Yves Chibon <pingou@pingoured.fr>

---

diff --git a/doc/usage/markdown.rst b/doc/usage/markdown.rst
index 95f1c17..6303fc7 100644
--- a/doc/usage/markdown.rst
+++ b/doc/usage/markdown.rst
@@ -115,6 +115,9 @@ Install the needed system libraries:
 Hyperlinks
 ----------
 
+Regular links
+^^^^^^^^^^^^^
+
 Need to embed a link to somewhere else? No problem! You can create an
 in-line link by wrapping the text in `[ ]` and appending the the URL in
 parentheses `( )` immediately after.
@@ -124,6 +127,29 @@ parentheses `( )` immediately after.
 Pagure is used by the `Fedora Project <https://fedoraproject.org>`_.
 
 
+Links to ticket/PR of the same project
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You want to link to a ticket or a pull-request in the current project? Easy
+just use `#` immediately followed by the identifier of the ticket or
+pull-request.
+
+`This is an example for #2921`
+
+This is an example for `#2921 <https://pagure.io/pagure/issue/2921>`_
+
+Links to ticket/PR of another project
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You want to link to a ticket or a pull-request of a different project? Simply
+add the project name in front of the `#` and immediately followed by the
+identifier of the ticket or pull-request.
+
+`This is an example for pagure#2921`
+
+This is an example for `pagure#2921 <https://pagure.io/pagure/issue/2921>`_
+
+
 Lists
 -----