Jira integration documentation.

diff --git a/doc/integration/external-issue-tracker.md b/doc/integration/external-issue-tracker.md
new file mode 100644 (file)
index 0000000..fb645a5
--- /dev/null
+++ b/doc/integration/external-issue-tracker.md
@@ -0,0 +1,7 @@
+GitLab has a great issue tracker but you can also use an external issue tracker such as JIRA or Redmine. This is something that you can turn on per GitLab project. If for example you configure JIRA it provides the following functionality:
+
+- the 'Issues' link on the GitLab project pages takes you to the appropriate JIRA issue index;
+- clicking 'New issue' on the project dashboard creates a new JIRA issue;
+- textual references to PROJECT-1234 in comments, commit messages get turned into HTML links to the corresponding JIRA issue.
+
+Also see the [screenshot](jira-intergration-points.png) below.

diff --git a/doc/integration/jira-integration-points.png b/doc/integration/jira-integration-points.png
new file mode 100644 (file)
index 0000000..0692a7b
Binary files /dev/null and b/doc/integration/jira-integration-points.png differ