From b1f1a9633d4b06d3f88566e721d2bc7f76714dac Mon Sep 17 00:00:00 2001 From: Evan Read Date: Fri, 22 Mar 2019 03:54:08 +0000 Subject: [PATCH] Improve Youtrack documentation for style --- doc/integration/external-issue-tracker.md | 9 +++-- .../integrations/img/issue_configuration.png | Bin 11882 -> 0 bytes doc/user/project/integrations/redmine.md | 4 +-- doc/user/project/integrations/youtrack.md | 32 ++++++++++-------- 4 files changed, 25 insertions(+), 20 deletions(-) delete mode 100644 doc/user/project/integrations/img/issue_configuration.png diff --git a/doc/integration/external-issue-tracker.md b/doc/integration/external-issue-tracker.md index 7e2cd3d4983..c3328e01081 100644 --- a/doc/integration/external-issue-tracker.md +++ b/doc/integration/external-issue-tracker.md @@ -3,9 +3,12 @@ GitLab has a great [issue tracker](../user/project/issues/index.md) but you can also use an external one such as Jira, Redmine, YouTrack, or Bugzilla. External issue trackers are configurable per GitLab project. -Once configured, you can reference external issues using the format CODE-123, where CODE is a unique code -for the tracker, and 123 is the issue number in the tracker. These references in GitLab -merge requests, commits, or comments are automatically converted to links to the issues. +Once configured, you can reference external issues using the format `CODE-123`, where: + +- `CODE` is a unique code for the tracker. +- `123` is the issue number in the tracker. + +These references in GitLab merge requests, commits, or comments are automatically converted to links to the issues. You can keep GitLab's issue tracker enabled in parallel or disable it. When enabled, the **Issues** link in the GitLab menu always opens the internal issue tracker. When disabled, the link is not visible in the menu. diff --git a/doc/user/project/integrations/img/issue_configuration.png b/doc/user/project/integrations/img/issue_configuration.png deleted file mode 100644 index 5dfd85974d86564352a931b7285a322221772b1c..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 11882 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 C6*)ox diff --git a/doc/user/project/integrations/redmine.md b/doc/user/project/integrations/redmine.md index 8112aa21859..bac7eecfce4 100644 --- a/doc/user/project/integrations/redmine.md +++ b/doc/user/project/integrations/redmine.md @@ -18,9 +18,7 @@ ![Redmine configuration](img/redmine_configuration.png) -1. To disable the internal issue tracking system in a project, navigate to the General page, expand [Permissions](../settings/index.md#sharing-and-permissions), and slide the Issues switch invalid. - - ![Issue configuration](img/issue_configuration.png) +1. To disable the internal issue tracking system in a project, navigate to the General page, expand the [permissions](../settings/index.md#sharing-and-permissions) section and switch the **Issues** toggle to disabled. ## Referencing issues in Redmine diff --git a/doc/user/project/integrations/youtrack.md b/doc/user/project/integrations/youtrack.md index 0d0237c2925..a2a468b6fe4 100644 --- a/doc/user/project/integrations/youtrack.md +++ b/doc/user/project/integrations/youtrack.md @@ -4,25 +4,29 @@ JetBrains [YouTrack](https://www.jetbrains.com/help/youtrack/standalone/YouTrack You can configure YouTrack as an [External Issue Tracker](../../../integration/external-issue-tracker.md) in GitLab. -## Enable the YouTrack integration in a project +## Enable the YouTrack integration -Navigate to the [Integrations page](project_services.md#accessing-the-project-services), click -the **YouTrack** service, and enter the required details on the page as described -in the table below. +To enable YouTrack integration in a project: - | Field | Description | - | ----- | ----------- | - | `description` | A name for the issue tracker (to differentiate between instances, for example) | - | `project_url` | The URL to the project in YouTrack which is being linked to this GitLab project | - | `issues_url` | The URL to the issue in YouTrack project that is linked to this GitLab project. Note that the `issues_url` requires `:id` in the URL. This ID is used by GitLab as a placeholder to replace the issue number. | +1. Navigate to the project's **Settings > [Integrations](project_services.md#accessing-the-project-services)** page. +1. Click the **YouTrack** service, ensure it's active, and enter the required details on the page as described in the table below. -Once you have configured and enabled YouTrack you'll see the YouTrack link on the GitLab project pages that takes you to the appropriate YouTrack project. + | Field | Description | + |:----------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| + | **Description** | Name for the issue tracker (to differentiate between instances, for example). | + | **Project url** | URL to the project in YouTrack which is being linked to this GitLab project. | + | **Issues url** | URL to the issue in YouTrack project that is linked to this GitLab project. Note that the **Issues url** requires `:id` in the URL. This ID is used by GitLab as a placeholder to replace the issue number. | -## Disable the internal issue tracker in a project +1. Click the **Save changes** button. -Navigate to the General page, expand [Permissions](../settings/index.md#sharing-and-permissions), and switch the Issues toggle to disabled. +Once you have configured and enabled YouTrack, you'll see the YouTrack link on the GitLab project pages that takes you to the appropriate YouTrack project. -![Issue configuration](img/issue_configuration.png) +## Disable the internal issue tracker + +To disable the internal issue tracker in a project: + +1. Navigate to the project's **Settings > General** page. +1. Expand the [permissions section](../settings/index.md#sharing-and-permissions) and switch the **Issues** toggle to disabled. ## Referencing YouTrack issues in GitLab @@ -30,5 +34,5 @@ Issues in YouTrack can be referenced as `-`. `` must start with a capital letter and can then be followed by capital or lower case letters, numbers or underscores. `` is a number. An example reference is `YT-101` or `Api_32-143`. -References to - in merge requests, commits, or comments are automatically linked to the YouTrack issue URL. +References to `-` in merge requests, commits, or comments are automatically linked to the YouTrack issue URL. For more information, see the [External Issue Tracker](../../../integration/external-issue-tracker.md) documentation.