summaryrefslogtreecommitdiff
path: root/doc/administration/integration/external-issue-tracker.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/administration/integration/external-issue-tracker.md')
-rw-r--r--doc/administration/integration/external-issue-tracker.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/doc/administration/integration/external-issue-tracker.md b/doc/administration/integration/external-issue-tracker.md
new file mode 100644
index 00000000000..a2d7e922aad
--- /dev/null
+++ b/doc/administration/integration/external-issue-tracker.md
@@ -0,0 +1,30 @@
+# External issue tracker
+
+GitLab has a great issue tracker but you can also use an external one such as
+Jira or Redmine. Issue trackers are configurable per GitLab project and allow
+you to do the following:
+
+- the **Issues** link on the GitLab project pages takes you to the appropriate
+ issue index of the external tracker
+- clicking **New issue** on the project dashboard creates a new issue on the
+ external tracker
+
+## Configuration
+
+The configuration is done via a project's **Services**.
+
+### Project Service
+
+To enable an external issue tracker you must configure the appropriate **Service**.
+Visit the links below for details:
+
+- [Redmine](../project_services/redmine.md)
+- [Jira](../project_services/jira.md)
+
+### Service Template
+
+To save you the hassle from configuring each project's service individually,
+GitLab provides the ability to set Service Templates which can then be
+overridden in each project's settings.
+
+Read more on [Services Templates](../project_services/services_templates.md).