From 031caf212607282f06b9c080a7f55e3049b2c896 Mon Sep 17 00:00:00 2001
From: sujay patel <sujaypatel1996@gmail.com>
Date: Thu, 13 Jun 2019 01:33:21 +0530
Subject: [PATCH 001/195] Adding order by to list runner jobs api.

---
 app/finders/runner_jobs_finder.rb             | 19 +++++++-
 .../51794-add-ordering-to-runner-jobs-api.yml |  5 +++
 doc/api/runners.md                            |  2 +
 lib/api/runners.rb                            |  2 +
 spec/finders/runner_jobs_finder_spec.rb       | 22 ++++++++++
 spec/requests/api/runners_spec.rb             | 44 +++++++++++++++++++
 6 files changed, 93 insertions(+), 1 deletion(-)
 create mode 100644 changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml

diff --git a/app/finders/runner_jobs_finder.rb b/app/finders/runner_jobs_finder.rb
index 4fca4ec94f3..5e2c779cef8 100644
--- a/app/finders/runner_jobs_finder.rb
+++ b/app/finders/runner_jobs_finder.rb
@@ -3,6 +3,8 @@
 class RunnerJobsFinder
   attr_reader :runner, :params
 
+  ALLOWED_INDEXED_COLUMNS = %w[id].freeze
+
   def initialize(runner, params = {})
     @runner = runner
     @params = params
@@ -11,7 +13,7 @@ class RunnerJobsFinder
   def execute
     items = @runner.builds
     items = by_status(items)
-    items
+    sort_items(items)
   end
 
   private
@@ -23,4 +25,19 @@ class RunnerJobsFinder
     items.where(status: params[:status])
   end
   # rubocop: enable CodeReuse/ActiveRecord
+
+  # rubocop: disable CodeReuse/ActiveRecord
+  def sort_items(items)
+    return items unless ALLOWED_INDEXED_COLUMNS.include?(params[:order_by])
+
+    order_by = params[:order_by]
+    sort = if params[:sort].match?(/\A(ASC|DESC)\z/i)
+             params[:sort]
+           else
+             :desc
+           end
+
+    items.order(order_by => sort)
+  end
+  # rubocop: enable CodeReuse/ActiveRecord
 end
diff --git a/changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml b/changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml
new file mode 100644
index 00000000000..908a132688c
--- /dev/null
+++ b/changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml
@@ -0,0 +1,5 @@
+---
+title: Add order_by and sort params to list runner jobs api
+merge_request: 29629
+author: Sujay Patel
+type: added
diff --git a/doc/api/runners.md b/doc/api/runners.md
index 2d91428d1c1..b5d25bf23a1 100644
--- a/doc/api/runners.md
+++ b/doc/api/runners.md
@@ -291,6 +291,8 @@ GET /runners/:id/jobs
 |-----------|---------|----------|---------------------|
 | `id`      | integer | yes      | The ID of a runner  |
 | `status`  | string  | no       | Status of the job; one of: `running`, `success`, `failed`, `canceled` |
+| `order_by`| string  | no       | Order jobs by `id`. |
+| `sort`    | string  | no       | Sort jobs in `asc` or `desc` order (default: `desc`) |
 
 ```
 curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/runners/1/jobs?status=running"
diff --git a/lib/api/runners.rb b/lib/api/runners.rb
index f3fea463e7f..c2d371b6867 100644
--- a/lib/api/runners.rb
+++ b/lib/api/runners.rb
@@ -115,6 +115,8 @@ module API
       params do
         requires :id, type: Integer, desc: 'The ID of the runner'
         optional :status, type: String, desc: 'Status of the job', values: Ci::Build::AVAILABLE_STATUSES
+        optional :order_by, type: String, desc: 'Order by `id` or not', values: RunnerJobsFinder::ALLOWED_INDEXED_COLUMNS
+        optional :sort, type: String, values: %w[asc desc], default: 'desc', desc: 'Sort by asc (ascending) or desc (descending)'
         use :pagination
       end
       get ':id/jobs' do
diff --git a/spec/finders/runner_jobs_finder_spec.rb b/spec/finders/runner_jobs_finder_spec.rb
index 97304170c4e..01f45a37ba8 100644
--- a/spec/finders/runner_jobs_finder_spec.rb
+++ b/spec/finders/runner_jobs_finder_spec.rb
@@ -35,5 +35,27 @@ describe RunnerJobsFinder do
         end
       end
     end
+
+    context 'when order_by and sort are specified' do
+      context 'when order_by id and sort is asc' do
+        let(:params) { { order_by: 'id', sort: 'asc' } }
+        let!(:jobs) { create_list(:ci_build, 2, runner: runner, project: project, user: create(:user)) }
+
+        it 'sorts as id: :asc' do
+          is_expected.to eq(jobs.sort_by(&:id))
+        end
+      end
+    end
+
+    context 'when order_by is specified and sort is not specified' do
+      context 'when order_by id and sort is not specified' do
+        let(:params) { { order_by: 'id' } }
+        let!(:jobs) { create_list(:ci_build, 2, runner: runner, project: project, user: create(:user)) }
+
+        it 'sorts as id: :desc' do
+          is_expected.to eq(jobs.sort_by(&:id).reverse)
+        end
+      end
+    end
   end
 end
diff --git a/spec/requests/api/runners_spec.rb b/spec/requests/api/runners_spec.rb
index 5548e3fd01a..f5ce3a3570e 100644
--- a/spec/requests/api/runners_spec.rb
+++ b/spec/requests/api/runners_spec.rb
@@ -584,6 +584,34 @@ describe API::Runners do
           end
         end
 
+        context 'when valid order_by is provided' do
+          context 'when sort order is not specified' do
+            it 'return jobs in descending order' do
+              get api("/runners/#{project_runner.id}/jobs?order_by=id", admin)
+
+              expect(response).to have_gitlab_http_status(200)
+              expect(response).to include_pagination_headers
+
+              expect(json_response).to be_an(Array)
+              expect(json_response.length).to eq(2)
+              expect(json_response.first).to include('id' => job_5.id)
+            end
+          end
+
+          context 'when sort order is specified as asc' do
+            it 'return jobs sorted in ascending order' do
+              get api("/runners/#{project_runner.id}/jobs?order_by=id&sort=asc", admin)
+
+              expect(response).to have_gitlab_http_status(200)
+              expect(response).to include_pagination_headers
+
+              expect(json_response).to be_an(Array)
+              expect(json_response.length).to eq(2)
+              expect(json_response.first).to include('id' => job_4.id)
+            end
+          end
+        end
+
         context 'when invalid status is provided' do
           it 'return 400' do
             get api("/runners/#{project_runner.id}/jobs?status=non-existing", admin)
@@ -591,6 +619,22 @@ describe API::Runners do
             expect(response).to have_gitlab_http_status(400)
           end
         end
+
+        context 'when invalid order_by is provided' do
+          it 'return 400' do
+            get api("/runners/#{project_runner.id}/jobs?order_by=non-existing", admin)
+
+            expect(response).to have_gitlab_http_status(400)
+          end
+        end
+
+        context 'when invalid sort is provided' do
+          it 'return 400' do
+            get api("/runners/#{project_runner.id}/jobs?sort=non-existing", admin)
+
+            expect(response).to have_gitlab_http_status(400)
+          end
+        end
       end
 
       context "when runner doesn't exist" do

From f7a92ff52822267d834c1c2d2d8ecf367a294e17 Mon Sep 17 00:00:00 2001
From: Felipe Artur <felipefac@gmail.com>
Date: Thu, 6 Jun 2019 14:52:36 -0300
Subject: [PATCH 002/195] Add GetCommitSignatures feature flag

Adds feature flag for GetCommitSignatures which
got ported to go.

More info: https://gitlab.com/gitlab-org/gitaly/merge_requests/1283
---
 lib/feature/gitaly.rb | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/lib/feature/gitaly.rb b/lib/feature/gitaly.rb
index d7a8f8a0b9e..67c0b902c0c 100644
--- a/lib/feature/gitaly.rb
+++ b/lib/feature/gitaly.rb
@@ -8,7 +8,12 @@ class Feature
     # CATFILE_CACHE sets an incorrect example
     CATFILE_CACHE = 'catfile-cache'.freeze
 
-    SERVER_FEATURE_FLAGS = [CATFILE_CACHE].freeze
+    SERVER_FEATURE_FLAGS =
+      [
+        CATFILE_CACHE,
+        'get_commit_signatures'.freeze
+      ].freeze
+
     DEFAULT_ON_FLAGS = Set.new([CATFILE_CACHE]).freeze
 
     class << self

From 36e73eff4e6a56ff7e3b1c078f42ae664754eaa7 Mon Sep 17 00:00:00 2001
From: Nathan Friend <nathan@gitlab.com>
Date: Fri, 28 Jun 2019 16:27:47 -0300
Subject: [PATCH 003/195] Allow (Haml) tooltip delay customization via
 localStorage

---
 app/assets/javascripts/main.js | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/app/assets/javascripts/main.js b/app/assets/javascripts/main.js
index 9f30a989295..2d32e6a7fbb 100644
--- a/app/assets/javascripts/main.js
+++ b/app/assets/javascripts/main.js
@@ -119,11 +119,15 @@ function deferredInitialisation() {
       .catch(() => {});
   }
 
+  const glTooltipDelay = localStorage.getItem('gl-tooltip-delay');
+  const delay = glTooltipDelay ? JSON.parse(glTooltipDelay) : 0;
+
   // Initialize tooltips
   $body.tooltip({
     selector: '.has-tooltip, [data-toggle="tooltip"]',
     trigger: 'hover',
     boundary: 'viewport',
+    delay,
   });
 
   // Initialize popovers

From e549a7fb1f364395c20522e5395e22a2bf434ed0 Mon Sep 17 00:00:00 2001
From: Takuya Noguchi <takninnovationresearch@gmail.com>
Date: Mon, 1 Jul 2019 18:49:53 +0900
Subject: [PATCH 004/195] Update mixin-deep to 1.3.2

To address a Prototype Pollution vulnerability,
which exists in `mixin-deep` package, versions
`>=2.0.0 <2.0.1 || <1.3.2` (CVE-2019-10746).

- Diff: https://github.com/jonschlinkert/mixin-deep/compare/1.3.1...1.3.2
- Synk ID: https://app.snyk.io/vuln/SNYK-JS-MIXINDEEP-450212

Signed-off-by: Takuya Noguchi <takninnovationresearch@gmail.com>
---
 changelogs/unreleased/63945-update-mixin-deep-to-1-3-2.yml | 5 +++++
 yarn.lock                                                  | 6 +++---
 2 files changed, 8 insertions(+), 3 deletions(-)
 create mode 100644 changelogs/unreleased/63945-update-mixin-deep-to-1-3-2.yml

diff --git a/changelogs/unreleased/63945-update-mixin-deep-to-1-3-2.yml b/changelogs/unreleased/63945-update-mixin-deep-to-1-3-2.yml
new file mode 100644
index 00000000000..a0ef34f3700
--- /dev/null
+++ b/changelogs/unreleased/63945-update-mixin-deep-to-1-3-2.yml
@@ -0,0 +1,5 @@
+---
+title: Update mixin-deep to 1.3.2
+merge_request: 30223
+author: Takuya Noguchi
+type: other
diff --git a/yarn.lock b/yarn.lock
index 07b4e20fc5f..901f7fbd6fb 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -7534,9 +7534,9 @@ mississippi@^3.0.0:
     through2 "^2.0.0"
 
 mixin-deep@^1.2.0:
-  version "1.3.1"
-  resolved "https://registry.yarnpkg.com/mixin-deep/-/mixin-deep-1.3.1.tgz#a49e7268dce1a0d9698e45326c5626df3543d0fe"
-  integrity sha512-8ZItLHeEgaqEvd5lYBXfm4EZSFCX29Jb9K+lAHhDKzReKBQKj3R+7NOF6tjqYi9t4oI8VUfaWITJQm86wnXGNQ==
+  version "1.3.2"
+  resolved "https://registry.yarnpkg.com/mixin-deep/-/mixin-deep-1.3.2.tgz#1120b43dc359a785dce65b55b82e257ccf479566"
+  integrity sha512-WRoDn//mXBiJ1H40rqa3vH0toePwSsGb45iInWlTySa+Uu4k3tYUSxa2v1KqAiLtvlrSzaExqS1gtk96A9zvEA==
   dependencies:
     for-in "^1.0.2"
     is-extendable "^1.0.1"

From 8f27b0b1109b84bacd482a75b9b7092ee5fd3660 Mon Sep 17 00:00:00 2001
From: Sarah Daily <sdaily@gitlab.com>
Date: Mon, 1 Jul 2019 20:09:07 +0000
Subject: [PATCH 005/195] Add relevant webcast to drive traffic and MQLs

---
 doc/user/project/clusters/index.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/user/project/clusters/index.md b/doc/user/project/clusters/index.md
index c6ee168bad0..581fa66d58c 100644
--- a/doc/user/project/clusters/index.md
+++ b/doc/user/project/clusters/index.md
@@ -5,6 +5,9 @@
 Connect your project to Google Kubernetes Engine (GKE) or an existing Kubernetes
 cluster in a few steps.
 
+NOTE: **Scalable app deployment with GitLab and Google Cloud Platform**
+[Watch the webcast](https://about.gitlab.com/webcast/scalable-app-deploy/) and learn how to spin up a Kubernetes cluster managed by Google Cloud Platform (GCP) in a few clicks.
+
 ## Overview
 
 With one or more Kubernetes clusters associated to your project, you can use

From 4d02fb67ad942ccd910db80d57d015ec9a81a7d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jarka=20Ko=C5=A1anov=C3=A1?= <jarka@gitlab.com>
Date: Fri, 28 Jun 2019 19:09:31 +0200
Subject: [PATCH 006/195] Update label note to support scoped labels notes

- port of EE change
---
 app/models/label_note.rb           | 18 +++++++++++++-----
 app/models/resource_label_event.rb |  7 +++++--
 2 files changed, 18 insertions(+), 7 deletions(-)

diff --git a/app/models/label_note.rb b/app/models/label_note.rb
index d6814f4a948..ba5f1f82a81 100644
--- a/app/models/label_note.rb
+++ b/app/models/label_note.rb
@@ -62,19 +62,27 @@ class LabelNote < Note
   end
 
   def note_text(html: false)
-    added = labels_str('added', label_refs_by_action('add', html))
-    removed = labels_str('removed', label_refs_by_action('remove', html))
+    added = labels_str(label_refs_by_action('add', html), prefix: 'added', suffix: added_suffix)
+    removed = labels_str(label_refs_by_action('remove', html), prefix: removed_prefix)
 
     [added, removed].compact.join(' and ')
   end
 
+  def removed_prefix
+    'removed'
+  end
+
+  def added_suffix
+    ''
+  end
+
   # returns string containing added/removed labels including
   # count of deleted labels:
   #
   # added ~1 ~2 + 1 deleted label
   # added 3 deleted labels
   # added ~1 ~2 labels
-  def labels_str(prefix, label_refs)
+  def labels_str(label_refs, prefix: '', suffix: '')
     existing_refs = label_refs.select { |ref| ref.present? }.sort
     refs_str = existing_refs.empty? ? nil : existing_refs.join(' ')
 
@@ -84,9 +92,9 @@ class LabelNote < Note
     return unless refs_str || deleted_str
 
     label_list_str = [refs_str, deleted_str].compact.join(' + ')
-    suffix = 'label'.pluralize(deleted > 0 ? deleted : existing_refs.count)
+    suffix += ' label'.pluralize(deleted > 0 ? deleted : existing_refs.count)
 
-    "#{prefix} #{label_list_str} #{suffix}"
+    "#{prefix} #{label_list_str} #{suffix.squish}"
   end
 
   def label_refs_by_action(action, html)
diff --git a/app/models/resource_label_event.rb b/app/models/resource_label_event.rb
index f2c7cb6a65d..ad08f4763ae 100644
--- a/app/models/resource_label_event.rb
+++ b/app/models/resource_label_event.rb
@@ -36,10 +36,9 @@ class ResourceLabelEvent < ApplicationRecord
     issue || merge_request
   end
 
-  # create same discussion id for all actions with the same user and time
   def discussion_id(resource = nil)
     strong_memoize(:discussion_id) do
-      Digest::SHA1.hexdigest([self.class.name, created_at, user_id].join("-"))
+      Digest::SHA1.hexdigest(discussion_id_key.join("-"))
     end
   end
 
@@ -121,4 +120,8 @@ class ResourceLabelEvent < ApplicationRecord
   def resource_parent
     issuable.project || issuable.group
   end
+
+  def discussion_id_key
+    [self.class.name, created_at, user_id]
+  end
 end

From 4000d0cc3799182113adeda5e15e4252a7bf0bdb Mon Sep 17 00:00:00 2001
From: Maxim Efimov <efimovms@gmail.com>
Date: Tue, 2 Jul 2019 16:12:55 +0000
Subject: [PATCH 007/195] Fix incorrect link for prometheus AWS CloudWatch
 exporter

---
 doc/user/project/integrations/prometheus_library/cloudwatch.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/user/project/integrations/prometheus_library/cloudwatch.md b/doc/user/project/integrations/prometheus_library/cloudwatch.md
index 66f1b587070..01da7e00d74 100644
--- a/doc/user/project/integrations/prometheus_library/cloudwatch.md
+++ b/doc/user/project/integrations/prometheus_library/cloudwatch.md
@@ -18,7 +18,7 @@ The [Prometheus service](../prometheus.md) must be enabled.
 
 ## Configuring Prometheus to monitor for Cloudwatch metrics
 
-To get started with Cloudwatch monitoring, you should install and configure the [Cloudwatch exporter](https://github.com/hnlq715/nginx-vts-exporter) which retrieves and parses the specified Cloudwatch metrics and translates them into a Prometheus monitoring endpoint.
+To get started with Cloudwatch monitoring, you should install and configure the [Cloudwatch exporter](https://github.com/prometheus/cloudwatch_exporter) which retrieves and parses the specified Cloudwatch metrics and translates them into a Prometheus monitoring endpoint.
 
 Right now, the only AWS resource supported is the Elastic Load Balancer, whose Cloudwatch metrics can be found [here](http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-cloudwatch-metrics.html).
 

From 7edeedc700cdb825aa885b53ceca8ebc145c1b23 Mon Sep 17 00:00:00 2001
From: sujay patel <sujaypatel1996@gmail.com>
Date: Thu, 13 Jun 2019 01:33:21 +0530
Subject: [PATCH 008/195] Adding order by to list runner jobs api.

---
 app/finders/runner_jobs_finder.rb             | 22 ++++++++++-
 .../51794-add-ordering-to-runner-jobs-api.yml |  5 +++
 doc/api/runners.md                            |  2 +
 spec/finders/runner_jobs_finder_spec.rb       | 37 +++++++++++++++++++
 4 files changed, 65 insertions(+), 1 deletion(-)
 create mode 100644 changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml

diff --git a/app/finders/runner_jobs_finder.rb b/app/finders/runner_jobs_finder.rb
index 4fca4ec94f3..f1ee1d38255 100644
--- a/app/finders/runner_jobs_finder.rb
+++ b/app/finders/runner_jobs_finder.rb
@@ -3,6 +3,8 @@
 class RunnerJobsFinder
   attr_reader :runner, :params
 
+  ALLOWED_INDEXED_COLUMNS = %w[id created_at].freeze
+
   def initialize(runner, params = {})
     @runner = runner
     @params = params
@@ -11,7 +13,7 @@ class RunnerJobsFinder
   def execute
     items = @runner.builds
     items = by_status(items)
-    items
+    sort_items(items)
   end
 
   private
@@ -23,4 +25,22 @@ class RunnerJobsFinder
     items.where(status: params[:status])
   end
   # rubocop: enable CodeReuse/ActiveRecord
+
+  # rubocop: disable CodeReuse/ActiveRecord
+  def sort_items(items)
+    order_by = if ALLOWED_INDEXED_COLUMNS.include?(params[:order_by])
+                 params[:order_by]
+               else
+                 :id
+               end
+
+    sort = if params[:sort] =~ /\A(ASC|DESC)\z/i
+             params[:sort]
+           else
+             :desc
+           end
+
+    items.order(order_by => sort)
+  end
+  # rubocop: enable CodeReuse/ActiveRecord
 end
diff --git a/changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml b/changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml
new file mode 100644
index 00000000000..6af61d7b145
--- /dev/null
+++ b/changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml
@@ -0,0 +1,5 @@
+---
+title: 51794-add-order-by-to-list-runner-jobs-api
+merge_request:
+author: Sujay Patel
+type: added
diff --git a/doc/api/runners.md b/doc/api/runners.md
index 2d91428d1c1..b70b954031b 100644
--- a/doc/api/runners.md
+++ b/doc/api/runners.md
@@ -291,6 +291,8 @@ GET /runners/:id/jobs
 |-----------|---------|----------|---------------------|
 | `id`      | integer | yes      | The ID of a runner  |
 | `status`  | string  | no       | Status of the job; one of: `running`, `success`, `failed`, `canceled` |
+| `order_by`| string  | no       | Order jobs by `id` or `created_at` (default: id) |
+| `sort`    | string  | no       | Sort jobs in `asc` or `desc` order (default: `desc`) |
 
 ```
 curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/runners/1/jobs?status=running"
diff --git a/spec/finders/runner_jobs_finder_spec.rb b/spec/finders/runner_jobs_finder_spec.rb
index 97304170c4e..9ed6f50ddfb 100644
--- a/spec/finders/runner_jobs_finder_spec.rb
+++ b/spec/finders/runner_jobs_finder_spec.rb
@@ -35,5 +35,42 @@ describe RunnerJobsFinder do
         end
       end
     end
+
+    context 'when order_by and sort are specified' do
+      context 'when order_by created_at' do
+        let(:params) { { order_by: 'created_at', sort: 'asc' } }
+        let!(:jobs) { Array.new(2) { create(:ci_build, runner: runner, project: project, user: create(:user)) } }
+
+        it 'sorts as created_at: :asc' do
+          is_expected.to match_array(jobs)
+        end
+
+        context 'when sort is invalid' do
+          let(:params) { { order_by: 'created_at', sort: 'invalid_sort' } }
+
+          it 'sorts as created_at: :desc' do
+            is_expected.to eq(jobs.sort_by { |p| -p.user.id })
+          end
+        end
+      end
+
+      context 'when order_by is invalid' do
+        let(:params) { { order_by: 'invalid_column', sort: 'asc' } }
+        let!(:jobs) { Array.new(2) { create(:ci_build, runner: runner, project: project, user: create(:user)) } }
+
+        it 'sorts as id: :asc' do
+          is_expected.to eq(jobs.sort_by { |p| p.id })
+        end
+      end
+
+      context 'when both are nil' do
+        let(:params) { { order_by: nil, sort: nil } }
+        let!(:jobs) { Array.new(2) { create(:ci_build, runner: runner, project: project, user: create(:user)) } }
+
+        it 'sorts as id: :desc' do
+          is_expected.to eq(jobs.sort_by { |p| -p.id })
+        end
+      end
+    end
   end
 end

From d48ee86053acabf4d52effc2a6a2ba714926821d Mon Sep 17 00:00:00 2001
From: Stan Hu <stanhu@gmail.com>
Date: Wed, 3 Jul 2019 00:13:00 -0700
Subject: [PATCH 009/195] Make Housekeeping button do a full garbage collection

Previously the Housekeeping button and API would use the counter of last
pushes to determine whether to do a full garbage collection, or whether
to do one of the less comprehensive tasks: a full repack, incremental
pack, or ref pack. This was confusing behavior, since a project owner
might have to click the button dozens of times before a full GC would be
initiated.

This commit forces a full GC each time this is initiated. Note that the
`ExclusiveLease` in `HousekeepingService` prevents users from clicking
on the button more than once a day.

Closes https://gitlab.com/gitlab-org/gitlab-ce/issues/63349
---
 app/controllers/projects_controller.rb       |  2 +-
 changelogs/unreleased/sh-fix-issue-63349.yml |  5 +++
 lib/api/projects.rb                          |  2 +-
 spec/controllers/projects_controller_spec.rb | 47 ++++++++++++++++++++
 spec/requests/api/projects_spec.rb           |  2 +-
 5 files changed, 55 insertions(+), 3 deletions(-)
 create mode 100644 changelogs/unreleased/sh-fix-issue-63349.yml

diff --git a/app/controllers/projects_controller.rb b/app/controllers/projects_controller.rb
index 12db493978b..9d2f64280a3 100644
--- a/app/controllers/projects_controller.rb
+++ b/app/controllers/projects_controller.rb
@@ -182,7 +182,7 @@ class ProjectsController < Projects::ApplicationController
   end
 
   def housekeeping
-    ::Projects::HousekeepingService.new(@project).execute
+    ::Projects::HousekeepingService.new(@project, :gc).execute
 
     redirect_to(
       project_path(@project),
diff --git a/changelogs/unreleased/sh-fix-issue-63349.yml b/changelogs/unreleased/sh-fix-issue-63349.yml
new file mode 100644
index 00000000000..0e51a6b7b20
--- /dev/null
+++ b/changelogs/unreleased/sh-fix-issue-63349.yml
@@ -0,0 +1,5 @@
+---
+title: Make Housekeeping button do a full garbage collection
+merge_request: 30289
+author:
+type: fixed
diff --git a/lib/api/projects.rb b/lib/api/projects.rb
index 1e14c77b5be..a7d62014509 100644
--- a/lib/api/projects.rb
+++ b/lib/api/projects.rb
@@ -474,7 +474,7 @@ module API
         authorize_admin_project
 
         begin
-          ::Projects::HousekeepingService.new(user_project).execute
+          ::Projects::HousekeepingService.new(user_project, :gc).execute
         rescue ::Projects::HousekeepingService::LeaseTaken => error
           conflict!(error.message)
         end
diff --git a/spec/controllers/projects_controller_spec.rb b/spec/controllers/projects_controller_spec.rb
index 8d2412f97ef..4e1cac67d23 100644
--- a/spec/controllers/projects_controller_spec.rb
+++ b/spec/controllers/projects_controller_spec.rb
@@ -318,6 +318,53 @@ describe ProjectsController do
     end
   end
 
+  describe '#housekeeping' do
+    let(:group) { create(:group) }
+    let(:project) { create(:project, group: group) }
+    let(:housekeeping) { Projects::HousekeepingService.new(project) }
+
+    context 'when authenticated as owner' do
+      before do
+        group.add_owner(user)
+        sign_in(user)
+
+        allow(Projects::HousekeepingService).to receive(:new).with(project, :gc).and_return(housekeeping)
+      end
+
+      it 'forces a full garbage collection' do
+        expect(housekeeping).to receive(:execute).once
+
+        post :housekeeping,
+             params: {
+               namespace_id: project.namespace.path,
+               id: project.path
+             }
+
+        expect(response).to have_gitlab_http_status(302)
+      end
+    end
+
+    context 'when authenticated as developer' do
+      let(:developer) { create(:user) }
+
+      before do
+        group.add_developer(developer)
+      end
+
+      it 'does not execute housekeeping' do
+        expect(housekeeping).not_to receive(:execute)
+
+        post :housekeeping,
+             params: {
+               namespace_id: project.namespace.path,
+               id: project.path
+             }
+
+        expect(response).to have_gitlab_http_status(302)
+      end
+    end
+  end
+
   describe "#update" do
     render_views
 
diff --git a/spec/requests/api/projects_spec.rb b/spec/requests/api/projects_spec.rb
index 5f7d2fa6d9c..c67412a44c1 100644
--- a/spec/requests/api/projects_spec.rb
+++ b/spec/requests/api/projects_spec.rb
@@ -2428,7 +2428,7 @@ describe API::Projects do
     let(:housekeeping) { Projects::HousekeepingService.new(project) }
 
     before do
-      allow(Projects::HousekeepingService).to receive(:new).with(project).and_return(housekeeping)
+      allow(Projects::HousekeepingService).to receive(:new).with(project, :gc).and_return(housekeeping)
     end
 
     context 'when authenticated as owner' do

From abed4d0ce3c73f549d7e70d516926f85fb4a1940 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9my=20Coutable?= <remy@rymai.me>
Date: Wed, 3 Jul 2019 09:59:03 +0000
Subject: [PATCH 010/195] Rename Release groups in issue_workflow.md

Based on https://about.gitlab.com/handbook/product/categories/#release-stage:
- 'core release' -> 'progressive delivery'
- 'supporting capabilities' -> 'release management'
---
 doc/development/contributing/issue_workflow.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/development/contributing/issue_workflow.md b/doc/development/contributing/issue_workflow.md
index f1015f56106..f4fa0caeb01 100644
--- a/doc/development/contributing/issue_workflow.md
+++ b/doc/development/contributing/issue_workflow.md
@@ -154,8 +154,8 @@ The current group labels are:
 * ~"group::ci and runner" 
 * ~"group::testing" 
 * ~"group::package" 
-* ~"group::core release" 
-* ~"group::supporting capabilities" 
+* ~"group::progressive delivery" 
+* ~"group::release management" 
 * ~"group::autodevops and kubernetes" 
 * ~"group::serverless and paas"
 * ~"group::apm" 

From 93182f4f06fa35d83a8b1467a846aa123ad82e3e Mon Sep 17 00:00:00 2001
From: Sanad Liaquat <sliaquat@gitlab.com>
Date: Wed, 3 Jul 2019 15:12:53 +0500
Subject: [PATCH 011/195] Raise error on api call failure

---
 qa/qa/tools/generate_perf_testdata.rb | 63 ++++++++++++++++++++-------
 1 file changed, 48 insertions(+), 15 deletions(-)

diff --git a/qa/qa/tools/generate_perf_testdata.rb b/qa/qa/tools/generate_perf_testdata.rb
index b0477951967..1b053622f1b 100644
--- a/qa/qa/tools/generate_perf_testdata.rb
+++ b/qa/qa/tools/generate_perf_testdata.rb
@@ -196,6 +196,7 @@ module QA
         project_path = "#{@group_name}%2F#{@project_name}"
         branch_name = "branch_with_many_commits-#{SecureRandom.hex(8)}"
         file_name = "file_for_many_commits.txt"
+
         create_a_branch_api_req(branch_name, project_path)
         create_a_new_file_api_req(file_name, branch_name, project_path, "Initial commit for new file", "Initial file content")
         create_mr_response = create_a_merge_request_api_req(project_path, branch_name, "master", "MR with many commits-#{SecureRandom.hex(8)}")
@@ -203,7 +204,7 @@ module QA
         100.times do |i|
           update_file_api_req(file_name, branch_name, project_path, Faker::Lorem.sentences(5).join(" "), Faker::Lorem.sentences(500).join("\n"))
         end
-        STDOUT.puts "Created an MR with many commits: #{@urls[:mr_with_many_commits]}"
+        STDOUT.puts "Using branch: #{branch_name}, created an MR with many commits: #{@urls[:mr_with_many_commits]}"
       end
 
       private
@@ -211,56 +212,88 @@ module QA
       # API Requests
 
       def create_a_discussion_on_issue_api_req(project_path_or_id, issue_id, body)
-        post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/issues/#{issue_id}/discussions").url, "body=\"#{body}\""
+        call_api(expected_response_code: 201) do
+          post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/issues/#{issue_id}/discussions").url, "body=\"#{body}\""
+        end
       end
 
       def update_a_discussion_on_issue_api_req(project_path_or_id, mr_iid, discussion_id, resolved_status)
-        put Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/merge_requests/#{mr_iid}/discussions/#{discussion_id}").url, "resolved=#{resolved_status}"
+        call_api(expected_response_code: 200) do
+          put Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/merge_requests/#{mr_iid}/discussions/#{discussion_id}").url, "resolved=#{resolved_status}"
+        end
       end
 
       def create_a_discussion_on_mr_api_req(project_path_or_id, mr_iid, body)
-        post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/merge_requests/#{mr_iid}/discussions").url,
-             "body=\"#{body}\""
+        call_api(expected_response_code: 201) do
+          post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/merge_requests/#{mr_iid}/discussions").url, "body=\"#{body}\""
+        end
       end
 
       def create_a_label_api_req(project_path_or_id, name, color)
-        post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/labels").url, "name=#{name}&color=#{color}"
+        call_api(expected_response_code: 201) do
+          post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/labels").url, "name=#{name}&color=#{color}"
+        end
       end
 
       def create_a_todo_api_req(project_path_or_id, issue_id)
-        post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/issues/#{issue_id}/todo").url, nil
+        call_api(expected_response_code: 201) do
+          post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/issues/#{issue_id}/todo").url, nil
+        end
       end
 
       def create_an_issue_api_req(project_path_or_id, title, description)
-        post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/issues").url, "title=#{title}&description=#{description}"
+        call_api(expected_response_code: 201) do
+          post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/issues").url, "title=#{title}&description=#{description}"
+        end
       end
 
       def update_an_issue_api_req(project_path_or_id, issue_id, description, labels_list)
-        put Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/issues/#{issue_id}").url, "description=#{description}&labels=#{labels_list}"
+        call_api(expected_response_code: 200) do
+          put Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/issues/#{issue_id}").url, "description=#{description}&labels=#{labels_list}"
+        end
       end
 
       def create_a_project_api_req(project_name, group_id, visibility)
-        post Runtime::API::Request.new(@api_client, "/projects").url, "name=#{project_name}&namespace_id=#{group_id}&visibility=#{visibility}"
+        call_api(expected_response_code: 201) do
+          post Runtime::API::Request.new(@api_client, "/projects").url, "name=#{project_name}&namespace_id=#{group_id}&visibility=#{visibility}"
+        end
       end
 
       def create_a_group_api_req(group_name, visibility)
-        post Runtime::API::Request.new(@api_client, "/groups").url, "name=#{group_name}&path=#{group_name}&visibility=#{visibility}"
+        call_api(expected_response_code: 201) do
+          post Runtime::API::Request.new(@api_client, "/groups").url, "name=#{group_name}&path=#{group_name}&visibility=#{visibility}"
+        end
       end
 
       def create_a_branch_api_req(branch_name, project_path_or_id)
-        post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/repository/branches").url, "branch=#{branch_name}&ref=master"
+        call_api(expected_response_code: 201) do
+          post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/repository/branches").url, "branch=#{branch_name}&ref=master"
+        end
       end
 
       def create_a_new_file_api_req(file_path, branch_name, project_path_or_id, commit_message, content)
-        post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/repository/files/#{file_path}").url, "branch=#{branch_name}&commit_message=\"#{commit_message}\"&content=\"#{content}\""
+        call_api(expected_response_code: 201) do
+          post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/repository/files/#{file_path}").url, "branch=#{branch_name}&commit_message=\"#{commit_message}\"&content=\"#{content}\""
+        end
       end
 
       def create_a_merge_request_api_req(project_path_or_id, source_branch, target_branch, mr_title)
-        post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/merge_requests").url, "source_branch=#{source_branch}&target_branch=#{target_branch}&title=#{mr_title}"
+        call_api(expected_response_code: 201) do
+          post Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/merge_requests").url, "source_branch=#{source_branch}&target_branch=#{target_branch}&title=#{mr_title}"
+        end
       end
 
       def update_file_api_req(file_path, branch_name, project_path_or_id, commit_message, content)
-        put Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/repository/files/#{file_path}").url, "branch=#{branch_name}&commit_message=\"#{commit_message}\"&content=\"#{content}\""
+        call_api(expected_response_code: 200) do
+          put Runtime::API::Request.new(@api_client, "/projects/#{project_path_or_id}/repository/files/#{file_path}").url, "branch=#{branch_name}&commit_message=\"#{commit_message}\"&content=\"#{content}\""
+        end
+      end
+
+      def call_api(expected_response_code: 200)
+        response = yield
+        raise "API call failed with response code: #{response.code} and body: #{response.body}" unless response.code == expected_response_code
+
+        response
       end
     end
   end

From 9671ca19de430e49b6cb2a51d2405c640dfddd16 Mon Sep 17 00:00:00 2001
From: Achilleas Pipinellis <axil@gitlab.com>
Date: Wed, 3 Jul 2019 12:27:06 +0200
Subject: [PATCH 012/195] Re-align CE and EE API docs

---
 doc/api/group_boards.md | 22 ++++++++++++++++++++--
 doc/api/users.md        | 33 ++++++++++++++++++++++++++++-----
 2 files changed, 48 insertions(+), 7 deletions(-)

diff --git a/doc/api/group_boards.md b/doc/api/group_boards.md
index 4bee05a128a..a677a9c9a33 100644
--- a/doc/api/group_boards.md
+++ b/doc/api/group_boards.md
@@ -27,7 +27,16 @@ Example response:
 [
   {
     "id": 1,
-    "group_id": 5,
+    "name:": "group issue board",
+    "group": {
+      "id": 5,
+      "name": "Documentcloud",
+      "web_url": "http://example.com/groups/documentcloud"
+    },
+    "milestone":   {
+      "id": 12
+      "title": "10.0"
+    },
     "lists" : [
       {
         "id" : 1,
@@ -136,7 +145,16 @@ Example response:
 ```json
   {
     "id": 1,
-    "group_id": 5,
+    "name:": "group issue board",
+    "group": {
+      "id": 5,
+      "name": "Documentcloud",
+      "web_url": "http://example.com/groups/documentcloud"
+    },
+    "milestone":   {
+      "id": 12
+      "title": "10.0"
+    },
     "lists" : [
       {
         "id" : 1,
diff --git a/doc/api/users.md b/doc/api/users.md
index 5615dcdd307..6be097e6364 100644
--- a/doc/api/users.md
+++ b/doc/api/users.md
@@ -147,6 +147,24 @@ GET /users
 ]
 ```
 
+Users on GitLab [Silver or higher](https://about.gitlab.com/pricing/) will also see
+the `group_saml` provider option:
+
+```json
+[
+  {
+    "id": 1,
+    ...
+    "identities": [
+      {"provider": "github", "extern_uid": "2435223452345"},
+      {"provider": "bitbucket", "extern_uid": "john.smith"},
+      {"provider": "google_oauth2", "extern_uid": "8776128412476123468721346"},
+      {"provider": "group_saml", "extern_uid": "123789", "saml_provider_id": 10}
+    ],
+    ...
+  }
+]
+
 You can lookup users by external UID and provider:
 
 ```
@@ -260,14 +278,13 @@ Example Responses:
   "can_create_project": true,
   "two_factor_enabled": true,
   "external": false,
-  "private_profile": false,
-  "shared_runners_minutes_limit": 133
-  "extra_shared_runners_minutes_limit": 133
+  "private_profile": false
 }
 ```
 
 Users on GitLab [Starter, Bronze, or higher](https://about.gitlab.com/pricing/) will also see
-the `shared_runners_minutes_limit` and `extra_shared_runners_minutes_limit` parameters: **[STARTER]**
+the `shared_runners_minutes_limit` and `extra_shared_runners_minutes_limit` parameters.
+Users on GitLab Silver will also see the `group_saml` option:
 
 ```json
 {
@@ -275,6 +292,12 @@ the `shared_runners_minutes_limit` and `extra_shared_runners_minutes_limit` para
   "username": "john_smith",
   "shared_runners_minutes_limit": 133,
   "extra_shared_runners_minutes_limit": 133
+  "identities": [
+    {"provider": "github", "extern_uid": "2435223452345"},
+    {"provider": "bitbucket", "extern_uid": "john.smith"},
+    {"provider": "google_oauth2", "extern_uid": "8776128412476123468721346"},
+    {"provider": "group_saml", "extern_uid": "123789", "saml_provider_id": 10}
+  ],
   ...
 }
 ```
@@ -1285,4 +1308,4 @@ Example response:
 
 Please note that `last_activity_at` is deprecated, please use `last_activity_on`.
 
-[gemojione-index]: https://github.com/jonathanwiesel/gemojione/blob/master/config/index.json
\ No newline at end of file
+[gemojione-index]: https://github.com/jonathanwiesel/gemojione/blob/master/config/index.json

From 8b809837f44bbebdac65eebadb09a45fb60c6a65 Mon Sep 17 00:00:00 2001
From: charlieablett <cablett@gitlab.com>
Date: Sun, 16 Jun 2019 22:12:56 +1200
Subject: [PATCH 013/195] Enumerate fields with Gitaly calls

 - Add a complexity of 1 if Gitaly is called at least once
 - Add an error notification if `calls_gitaly` isn't right for a
 particular field
---
 app/graphql/types/base_field.rb       | 23 +++++++-
 app/graphql/types/project_type.rb     |  2 +-
 app/graphql/types/tree/tree_type.rb   |  4 +-
 spec/graphql/types/base_field_spec.rb | 81 +++++++++++++++++++++++++++
 4 files changed, 106 insertions(+), 4 deletions(-)

diff --git a/app/graphql/types/base_field.rb b/app/graphql/types/base_field.rb
index dd0d9105df6..ee23146f711 100644
--- a/app/graphql/types/base_field.rb
+++ b/app/graphql/types/base_field.rb
@@ -4,21 +4,30 @@ module Types
   class BaseField < GraphQL::Schema::Field
     prepend Gitlab::Graphql::Authorize
 
+    attr_reader :calls_gitaly
+
     DEFAULT_COMPLEXITY = 1
 
     def initialize(*args, **kwargs, &block)
+      @calls_gitaly = !!kwargs.delete(:calls_gitaly)
       kwargs[:complexity] ||= field_complexity(kwargs[:resolver_class])
 
       super(*args, **kwargs, &block)
     end
 
+    def base_complexity
+      complexity = DEFAULT_COMPLEXITY
+      complexity += 1 if @calls_gitaly
+      complexity
+    end
+
     private
 
     def field_complexity(resolver_class)
       if resolver_class
         field_resolver_complexity
       else
-        DEFAULT_COMPLEXITY
+        base_complexity
       end
     end
 
@@ -45,5 +54,17 @@ module Types
         complexity.to_i
       end
     end
+
+    def calls_gitaly_check
+      # Will inform you if :calls_gitaly should be true or false based on the number of Gitaly calls
+      # involved with the request.
+      if @calls_gitaly && Gitlab::GitalyClient.get_request_count == 0
+        raise "Gitaly is called for field '#{name}' - please add `calls_gitaly: true` to the field declaration"
+      elsif !@calls_gitaly && Gitlab::GitalyClient.get_request_count > 0
+        raise "Gitaly not called for field '#{name}' - please remove `calls_gitaly: true` from the field declaration"
+      end
+    rescue => e
+      Gitlab::Sentry.track_exception(e)
+    end
   end
 end
diff --git a/app/graphql/types/project_type.rb b/app/graphql/types/project_type.rb
index c25688ab043..87d5351f80f 100644
--- a/app/graphql/types/project_type.rb
+++ b/app/graphql/types/project_type.rb
@@ -26,7 +26,7 @@ module Types
     field :web_url, GraphQL::STRING_TYPE, null: true
 
     field :star_count, GraphQL::INT_TYPE, null: false
-    field :forks_count, GraphQL::INT_TYPE, null: false
+    field :forks_count, GraphQL::INT_TYPE, null: false, calls_gitaly: true # 4 times
 
     field :created_at, Types::TimeType, null: true
     field :last_activity_at, Types::TimeType, null: true
diff --git a/app/graphql/types/tree/tree_type.rb b/app/graphql/types/tree/tree_type.rb
index b947713074e..2023abc13f9 100644
--- a/app/graphql/types/tree/tree_type.rb
+++ b/app/graphql/types/tree/tree_type.rb
@@ -15,9 +15,9 @@ module Types
         Gitlab::Graphql::Representation::TreeEntry.decorate(obj.trees, obj.repository)
       end
 
-      field :submodules, Types::Tree::SubmoduleType.connection_type, null: false
+      field :submodules, Types::Tree::SubmoduleType.connection_type, null: false, calls_gitaly: true
 
-      field :blobs, Types::Tree::BlobType.connection_type, null: false, resolve: -> (obj, args, ctx) do
+      field :blobs, Types::Tree::BlobType.connection_type, null: false, calls_gitaly: true, resolve: -> (obj, args, ctx) do
         Gitlab::Graphql::Representation::TreeEntry.decorate(obj.blobs, obj.repository)
       end
       # rubocop: enable Graphql/AuthorizeTypes
diff --git a/spec/graphql/types/base_field_spec.rb b/spec/graphql/types/base_field_spec.rb
index 0d3c3e37daf..ebdfa3eaf4d 100644
--- a/spec/graphql/types/base_field_spec.rb
+++ b/spec/graphql/types/base_field_spec.rb
@@ -22,6 +22,24 @@ describe Types::BaseField do
       expect(field.to_graphql.complexity).to eq 1
     end
 
+    describe '#base_complexity' do
+      context 'with no gitaly calls' do
+        it 'defaults to 1' do
+          field = described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true)
+
+          expect(field.base_complexity).to eq 1
+        end
+      end
+
+      context 'with a gitaly call' do
+        it 'adds 1 to the default value' do
+          field = described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: true)
+
+          expect(field.base_complexity).to eq 2
+        end
+      end
+    end
+
     it 'has specified value' do
       field = described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, complexity: 12)
 
@@ -52,5 +70,68 @@ describe Types::BaseField do
         end
       end
     end
+
+    context 'calls_gitaly' do
+      context 'for fields with a resolver' do
+        it 'adds 1 if true' do
+          field = described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: true)
+
+          expect(field.to_graphql.complexity).to eq 2
+        end
+      end
+
+      context 'for fields without a resolver' do
+        it 'adds 1 if true' do
+          field = described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: true)
+
+          expect(field.to_graphql.complexity).to eq 2
+        end
+      end
+
+      it 'defaults to false' do
+        field = described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true)
+
+        expect(field.base_complexity).to eq Types::BaseField::DEFAULT_COMPLEXITY
+      end
+
+      it 'is overridden by declared complexity value' do
+        field = described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: true, complexity: 12)
+
+        expect(field.to_graphql.complexity).to eq 12
+      end
+    end
+
+    describe '#calls_gitaly_check' do
+      let(:gitaly_field) { described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: true) }
+      let(:no_gitaly_field) { described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: false) }
+
+      context 'if there are no Gitaly calls' do
+        before do
+          allow(Gitlab::GitalyClient).to receive(:get_request_count).and_return(0)
+        end
+
+        it 'does not raise an error if calls_gitaly is false' do
+          expect { no_gitaly_field.send(:calls_gitaly_check) }.not_to raise_error
+        end
+
+        it 'raises an error if calls_gitaly: true appears' do
+          expect { gitaly_field.send(:calls_gitaly_check) }.to raise_error(/please add `calls_gitaly: true`/)
+        end
+      end
+
+      context 'if there is at least 1 Gitaly call' do
+        before do
+          allow(Gitlab::GitalyClient).to receive(:get_request_count).and_return(1)
+        end
+
+        it 'does not raise an error if calls_gitaly is true' do
+          expect { gitaly_field.send(:calls_gitaly_check) }.not_to raise_error
+        end
+
+        it 'raises an error if calls_gitaly is not decalared' do
+          expect { no_gitaly_field.send(:calls_gitaly_check) }.to raise_error(/please remove `calls_gitaly: true`/)
+        end
+      end
+    end
   end
 end

From c99c30fdd6f3adf4fb29aad4b10e265be69d2d67 Mon Sep 17 00:00:00 2001
From: charlieablett <cablett@gitlab.com>
Date: Wed, 19 Jun 2019 14:37:54 +0200
Subject: [PATCH 014/195] Remove potentially noisy warning

- If Gitaly calls are missing, it could be due to a conditional and
may just become noise
---
 app/graphql/types/base_field.rb       | 2 --
 spec/graphql/types/base_field_spec.rb | 4 ----
 2 files changed, 6 deletions(-)

diff --git a/app/graphql/types/base_field.rb b/app/graphql/types/base_field.rb
index ee23146f711..95db116d6f9 100644
--- a/app/graphql/types/base_field.rb
+++ b/app/graphql/types/base_field.rb
@@ -60,8 +60,6 @@ module Types
       # involved with the request.
       if @calls_gitaly && Gitlab::GitalyClient.get_request_count == 0
         raise "Gitaly is called for field '#{name}' - please add `calls_gitaly: true` to the field declaration"
-      elsif !@calls_gitaly && Gitlab::GitalyClient.get_request_count > 0
-        raise "Gitaly not called for field '#{name}' - please remove `calls_gitaly: true` from the field declaration"
       end
     rescue => e
       Gitlab::Sentry.track_exception(e)
diff --git a/spec/graphql/types/base_field_spec.rb b/spec/graphql/types/base_field_spec.rb
index ebdfa3eaf4d..d7360872508 100644
--- a/spec/graphql/types/base_field_spec.rb
+++ b/spec/graphql/types/base_field_spec.rb
@@ -127,10 +127,6 @@ describe Types::BaseField do
         it 'does not raise an error if calls_gitaly is true' do
           expect { gitaly_field.send(:calls_gitaly_check) }.not_to raise_error
         end
-
-        it 'raises an error if calls_gitaly is not decalared' do
-          expect { no_gitaly_field.send(:calls_gitaly_check) }.to raise_error(/please remove `calls_gitaly: true`/)
-        end
       end
     end
   end

From f4890d90782ad42a802b89c2a17c83bf9fb9d123 Mon Sep 17 00:00:00 2001
From: charlieablett <cablett@gitlab.com>
Date: Fri, 21 Jun 2019 16:20:00 +0200
Subject: [PATCH 015/195] Alert if `calls_gitaly` declaration missing

- Move `calls_gitaly_check` to public
- Add instrumentation for flagging missing CallsGitaly declarations
- Wrap resolver proc in before-and-after Gitaly counts to get the net
Gitaly call count for the resolver.
---
 app/graphql/gitlab_schema.rb                  |  1 +
 app/graphql/types/base_field.rb               | 22 +++++++------
 lib/gitlab/graphql/authorize.rb               |  2 +-
 lib/gitlab/graphql/calls_gitaly.rb            | 15 +++++++++
 .../graphql/calls_gitaly/instrumentation.rb   | 30 ++++++++++++++++++
 spec/graphql/gitlab_schema_spec.rb            |  4 +++
 spec/graphql/types/base_field_spec.rb         | 18 +++--------
 spec/requests/api/graphql_spec.rb             | 31 +++++++++++++++++++
 8 files changed, 99 insertions(+), 24 deletions(-)
 create mode 100644 lib/gitlab/graphql/calls_gitaly.rb
 create mode 100644 lib/gitlab/graphql/calls_gitaly/instrumentation.rb

diff --git a/app/graphql/gitlab_schema.rb b/app/graphql/gitlab_schema.rb
index 5615909c4ec..152ebb930e2 100644
--- a/app/graphql/gitlab_schema.rb
+++ b/app/graphql/gitlab_schema.rb
@@ -13,6 +13,7 @@ class GitlabSchema < GraphQL::Schema
   use BatchLoader::GraphQL
   use Gitlab::Graphql::Authorize
   use Gitlab::Graphql::Present
+  use Gitlab::Graphql::CallsGitaly
   use Gitlab::Graphql::Connections
   use Gitlab::Graphql::GenericTracing
 
diff --git a/app/graphql/types/base_field.rb b/app/graphql/types/base_field.rb
index 95db116d6f9..64bc7e6474f 100644
--- a/app/graphql/types/base_field.rb
+++ b/app/graphql/types/base_field.rb
@@ -21,6 +21,18 @@ module Types
       complexity
     end
 
+    def calls_gitaly_check(calls)
+      return if @calls_gitaly
+
+      # Will inform you if :calls_gitaly should be true or false based on the number of Gitaly calls
+      # involved with the request.
+      if calls > 0
+        raise "Gitaly is called for field '#{name}' - please add `calls_gitaly: true` to the field declaration"
+      end
+    rescue => e
+      Gitlab::Sentry.track_exception(e)
+    end
+
     private
 
     def field_complexity(resolver_class)
@@ -54,15 +66,5 @@ module Types
         complexity.to_i
       end
     end
-
-    def calls_gitaly_check
-      # Will inform you if :calls_gitaly should be true or false based on the number of Gitaly calls
-      # involved with the request.
-      if @calls_gitaly && Gitlab::GitalyClient.get_request_count == 0
-        raise "Gitaly is called for field '#{name}' - please add `calls_gitaly: true` to the field declaration"
-      end
-    rescue => e
-      Gitlab::Sentry.track_exception(e)
-    end
   end
 end
diff --git a/lib/gitlab/graphql/authorize.rb b/lib/gitlab/graphql/authorize.rb
index f8d0208e275..e83b567308b 100644
--- a/lib/gitlab/graphql/authorize.rb
+++ b/lib/gitlab/graphql/authorize.rb
@@ -8,7 +8,7 @@ module Gitlab
       extend ActiveSupport::Concern
 
       def self.use(schema_definition)
-        schema_definition.instrument(:field, Instrumentation.new, after_built_ins: true)
+        schema_definition.instrument(:field, Gitlab::Graphql::Authorize::Instrumentation.new, after_built_ins: true)
       end
     end
   end
diff --git a/lib/gitlab/graphql/calls_gitaly.rb b/lib/gitlab/graphql/calls_gitaly.rb
new file mode 100644
index 00000000000..f75941e269f
--- /dev/null
+++ b/lib/gitlab/graphql/calls_gitaly.rb
@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Gitlab
+  module Graphql
+    # Allow fields to declare permissions their objects must have. The field
+    # will be set to nil unless all required permissions are present.
+    module CallsGitaly
+      extend ActiveSupport::Concern
+
+      def self.use(schema_definition)
+        schema_definition.instrument(:field, Gitlab::Graphql::CallsGitaly::Instrumentation.new, after_built_ins: true)
+      end
+    end
+  end
+end
diff --git a/lib/gitlab/graphql/calls_gitaly/instrumentation.rb b/lib/gitlab/graphql/calls_gitaly/instrumentation.rb
new file mode 100644
index 00000000000..ca54e12c049
--- /dev/null
+++ b/lib/gitlab/graphql/calls_gitaly/instrumentation.rb
@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Gitlab
+  module Graphql
+    module CallsGitaly
+      class Instrumentation
+        # Check if any `calls_gitaly: true` declarations need to be added
+        def instrument(_type, field)
+          type_object = field.metadata[:type_class]
+          return field unless type_object && type_object.respond_to?(:calls_gitaly_check)
+
+          old_resolver_proc = field.resolve_proc
+          wrapped_proc = gitaly_wrapped_resolve(old_resolver_proc, type_object)
+          field.redefine { resolve(wrapped_proc) }
+        end
+
+        def gitaly_wrapped_resolve(old_resolver_proc, type_object)
+          proc do |parent_typed_object, args, ctx|
+            previous_gitaly_call_count = Gitlab::GitalyClient.get_request_count
+
+            old_resolver_proc.call(parent_typed_object, args, ctx)
+
+            current_gitaly_call_count = Gitlab::GitalyClient.get_request_count
+            type_object.calls_gitaly_check(current_gitaly_call_count - previous_gitaly_call_count)
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/graphql/gitlab_schema_spec.rb b/spec/graphql/gitlab_schema_spec.rb
index d36e428a8ee..93b86b9b812 100644
--- a/spec/graphql/gitlab_schema_spec.rb
+++ b/spec/graphql/gitlab_schema_spec.rb
@@ -21,6 +21,10 @@ describe GitlabSchema do
     expect(field_instrumenters).to include(instance_of(::Gitlab::Graphql::Present::Instrumentation))
   end
 
+  it 'enables using gitaly call checker' do
+    expect(field_instrumenters).to include(instance_of(::Gitlab::Graphql::CallsGitaly::Instrumentation))
+  end
+
   it 'has the base mutation' do
     expect(described_class.mutation).to eq(::Types::MutationType.to_graphql)
   end
diff --git a/spec/graphql/types/base_field_spec.rb b/spec/graphql/types/base_field_spec.rb
index d7360872508..0be83ea60c4 100644
--- a/spec/graphql/types/base_field_spec.rb
+++ b/spec/graphql/types/base_field_spec.rb
@@ -106,26 +106,18 @@ describe Types::BaseField do
       let(:no_gitaly_field) { described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: false) }
 
       context 'if there are no Gitaly calls' do
-        before do
-          allow(Gitlab::GitalyClient).to receive(:get_request_count).and_return(0)
-        end
-
         it 'does not raise an error if calls_gitaly is false' do
-          expect { no_gitaly_field.send(:calls_gitaly_check) }.not_to raise_error
-        end
-
-        it 'raises an error if calls_gitaly: true appears' do
-          expect { gitaly_field.send(:calls_gitaly_check) }.to raise_error(/please add `calls_gitaly: true`/)
+          expect { no_gitaly_field.send(:calls_gitaly_check, 0) }.not_to raise_error
         end
       end
 
       context 'if there is at least 1 Gitaly call' do
-        before do
-          allow(Gitlab::GitalyClient).to receive(:get_request_count).and_return(1)
+        it 'does not raise an error if calls_gitaly is true' do
+          expect { gitaly_field.send(:calls_gitaly_check, 1) }.not_to raise_error
         end
 
-        it 'does not raise an error if calls_gitaly is true' do
-          expect { gitaly_field.send(:calls_gitaly_check) }.not_to raise_error
+        it 'raises an error if calls_gitaly: is false or not defined' do
+          expect { no_gitaly_field.send(:calls_gitaly_check, 1) }.to raise_error(/please add `calls_gitaly: true`/)
         end
       end
     end
diff --git a/spec/requests/api/graphql_spec.rb b/spec/requests/api/graphql_spec.rb
index 656d6f8b50b..d78b17827a6 100644
--- a/spec/requests/api/graphql_spec.rb
+++ b/spec/requests/api/graphql_spec.rb
@@ -131,4 +131,35 @@ describe 'GraphQL' do
       end
     end
   end
+
+  describe 'testing for Gitaly calls' do
+    let(:project) { create(:project, :repository) }
+    let(:user) { create(:user) }
+
+    let(:query) do
+      graphql_query_for('project', { 'fullPath' => project.full_path }, %w(forksCount))
+    end
+
+    before do
+      project.add_developer(user)
+    end
+
+    it_behaves_like 'a working graphql query' do
+      before do
+        post_graphql(query, current_user: user)
+      end
+    end
+
+    context 'when Gitaly is called' do
+      before do
+        allow(Gitlab::GitalyClient).to receive(:get_request_count).and_return(1, 2)
+      end
+
+      it "logs a warning that the 'calls_gitaly' field declaration is missing" do
+        expect(Gitlab::Sentry).to receive(:track_exception).once
+
+        post_graphql(query, current_user: user)
+      end
+    end
+  end
 end

From a11fe5de4408595cc8b2b091cbbb76e423c98f34 Mon Sep 17 00:00:00 2001
From: charlieablett <cablett@gitlab.com>
Date: Wed, 26 Jun 2019 22:42:25 +1200
Subject: [PATCH 016/195] Wrap proc properly in gitaly call counts

- Add `calls_gitaly: true` to some fields missing (hey, it works!)
- Clarify proc wrapping
- Add kwargs argument to `mount_mutation`
---
 app/graphql/types/base_field.rb                 |  5 ++---
 app/graphql/types/merge_request_type.rb         |  2 +-
 app/graphql/types/mutation_type.rb              |  2 +-
 .../types/permission_types/merge_request.rb     |  4 ++--
 app/graphql/types/project_type.rb               |  2 +-
 app/graphql/types/repository_type.rb            |  6 +++---
 .../graphql/calls_gitaly/instrumentation.rb     | 17 +++++++++--------
 lib/gitlab/graphql/mount_mutation.rb            |  5 +++--
 8 files changed, 22 insertions(+), 21 deletions(-)

diff --git a/app/graphql/types/base_field.rb b/app/graphql/types/base_field.rb
index 64bc7e6474f..42c7eb6b485 100644
--- a/app/graphql/types/base_field.rb
+++ b/app/graphql/types/base_field.rb
@@ -23,12 +23,11 @@ module Types
 
     def calls_gitaly_check(calls)
       return if @calls_gitaly
+      return if calls < 1
 
       # Will inform you if :calls_gitaly should be true or false based on the number of Gitaly calls
       # involved with the request.
-      if calls > 0
-        raise "Gitaly is called for field '#{name}' - please add `calls_gitaly: true` to the field declaration"
-      end
+      raise "Gitaly is called for field '#{name}' #{"on type #{owner.name} " if owner}- please add `calls_gitaly: true` to the field declaration"
     rescue => e
       Gitlab::Sentry.track_exception(e)
     end
diff --git a/app/graphql/types/merge_request_type.rb b/app/graphql/types/merge_request_type.rb
index 577ccd48ef8..6734d4761c2 100644
--- a/app/graphql/types/merge_request_type.rb
+++ b/app/graphql/types/merge_request_type.rb
@@ -43,7 +43,7 @@ module Types
     field :allow_collaboration, GraphQL::BOOLEAN_TYPE, null: true
     field :should_be_rebased, GraphQL::BOOLEAN_TYPE, method: :should_be_rebased?, null: false
     field :rebase_commit_sha, GraphQL::STRING_TYPE, null: true
-    field :rebase_in_progress, GraphQL::BOOLEAN_TYPE, method: :rebase_in_progress?, null: false
+    field :rebase_in_progress, GraphQL::BOOLEAN_TYPE, method: :rebase_in_progress?, null: false, calls_gitaly: true
     field :merge_commit_message, GraphQL::STRING_TYPE, method: :default_merge_commit_message, null: true, deprecation_reason: "Renamed to defaultMergeCommitMessage"
     field :default_merge_commit_message, GraphQL::STRING_TYPE, null: true
     field :merge_ongoing, GraphQL::BOOLEAN_TYPE, method: :merge_ongoing?, null: false
diff --git a/app/graphql/types/mutation_type.rb b/app/graphql/types/mutation_type.rb
index 6ef1d816b7c..bc5fb709522 100644
--- a/app/graphql/types/mutation_type.rb
+++ b/app/graphql/types/mutation_type.rb
@@ -9,6 +9,6 @@ module Types
     mount_mutation Mutations::AwardEmojis::Add
     mount_mutation Mutations::AwardEmojis::Remove
     mount_mutation Mutations::AwardEmojis::Toggle
-    mount_mutation Mutations::MergeRequests::SetWip
+    mount_mutation Mutations::MergeRequests::SetWip, calls_gitaly: true
   end
 end
diff --git a/app/graphql/types/permission_types/merge_request.rb b/app/graphql/types/permission_types/merge_request.rb
index 13995d3ea8f..d877fc177d2 100644
--- a/app/graphql/types/permission_types/merge_request.rb
+++ b/app/graphql/types/permission_types/merge_request.rb
@@ -10,8 +10,8 @@ module Types
       abilities :read_merge_request, :admin_merge_request,
                 :update_merge_request, :create_note
 
-      permission_field :push_to_source_branch, method: :can_push_to_source_branch?
-      permission_field :remove_source_branch, method: :can_remove_source_branch?
+      permission_field :push_to_source_branch, method: :can_push_to_source_branch?, calls_gitaly: true
+      permission_field :remove_source_branch, method: :can_remove_source_branch?, calls_gitaly: true
       permission_field :cherry_pick_on_current_merge_request, method: :can_cherry_pick_on_current_merge_request?
       permission_field :revert_on_current_merge_request, method: :can_revert_on_current_merge_request?
     end
diff --git a/app/graphql/types/project_type.rb b/app/graphql/types/project_type.rb
index 87d5351f80f..13be71c26ee 100644
--- a/app/graphql/types/project_type.rb
+++ b/app/graphql/types/project_type.rb
@@ -40,7 +40,7 @@ module Types
     field :lfs_enabled, GraphQL::BOOLEAN_TYPE, null: true
     field :merge_requests_ff_only_enabled, GraphQL::BOOLEAN_TYPE, null: true
 
-    field :avatar_url, GraphQL::STRING_TYPE, null: true, resolve: -> (project, args, ctx) do
+    field :avatar_url, GraphQL::STRING_TYPE, null: true, calls_gitaly: true, resolve: -> (project, args, ctx) do
       project.avatar_url(only_path: false)
     end
 
diff --git a/app/graphql/types/repository_type.rb b/app/graphql/types/repository_type.rb
index 5987467e1ea..b024eca61fc 100644
--- a/app/graphql/types/repository_type.rb
+++ b/app/graphql/types/repository_type.rb
@@ -6,9 +6,9 @@ module Types
 
     authorize :download_code
 
-    field :root_ref, GraphQL::STRING_TYPE, null: true
-    field :empty, GraphQL::BOOLEAN_TYPE, null: false, method: :empty?
+    field :root_ref, GraphQL::STRING_TYPE, null: true, calls_gitaly: true
+    field :empty, GraphQL::BOOLEAN_TYPE, null: false, method: :empty?, calls_gitaly: true
     field :exists, GraphQL::BOOLEAN_TYPE, null: false, method: :exists?
-    field :tree, Types::Tree::TreeType, null: true, resolver: Resolvers::TreeResolver
+    field :tree, Types::Tree::TreeType, null: true, resolver: Resolvers::TreeResolver, calls_gitaly: true
   end
 end
diff --git a/lib/gitlab/graphql/calls_gitaly/instrumentation.rb b/lib/gitlab/graphql/calls_gitaly/instrumentation.rb
index ca54e12c049..08e98028755 100644
--- a/lib/gitlab/graphql/calls_gitaly/instrumentation.rb
+++ b/lib/gitlab/graphql/calls_gitaly/instrumentation.rb
@@ -10,18 +10,19 @@ module Gitlab
           return field unless type_object && type_object.respond_to?(:calls_gitaly_check)
 
           old_resolver_proc = field.resolve_proc
-          wrapped_proc = gitaly_wrapped_resolve(old_resolver_proc, type_object)
-          field.redefine { resolve(wrapped_proc) }
-        end
 
-        def gitaly_wrapped_resolve(old_resolver_proc, type_object)
-          proc do |parent_typed_object, args, ctx|
+          gitaly_wrapped_resolve = -> (typed_object, args, ctx) do
             previous_gitaly_call_count = Gitlab::GitalyClient.get_request_count
-
-            old_resolver_proc.call(parent_typed_object, args, ctx)
-
+            result = old_resolver_proc.call(typed_object, args, ctx)
             current_gitaly_call_count = Gitlab::GitalyClient.get_request_count
             type_object.calls_gitaly_check(current_gitaly_call_count - previous_gitaly_call_count)
+            result
+          rescue => e
+            ap "#{e.message}"
+          end
+
+          field.redefine do
+            resolve(gitaly_wrapped_resolve)
           end
         end
       end
diff --git a/lib/gitlab/graphql/mount_mutation.rb b/lib/gitlab/graphql/mount_mutation.rb
index 9048967d4e1..b10e963170a 100644
--- a/lib/gitlab/graphql/mount_mutation.rb
+++ b/lib/gitlab/graphql/mount_mutation.rb
@@ -6,11 +6,12 @@ module Gitlab
       extend ActiveSupport::Concern
 
       class_methods do
-        def mount_mutation(mutation_class)
+        def mount_mutation(mutation_class, **custom_kwargs)
           # Using an underscored field name symbol will make `graphql-ruby`
           # standardize the field name
           field mutation_class.graphql_name.underscore.to_sym,
-                mutation: mutation_class
+                mutation: mutation_class,
+                **custom_kwargs
         end
       end
     end

From cf1b0d10bcdde69f05695a2e9a0d380c6badb6d1 Mon Sep 17 00:00:00 2001
From: charlieablett <cablett@gitlab.com>
Date: Fri, 28 Jun 2019 13:24:47 +1200
Subject: [PATCH 017/195] Address reviewer comments

- Add 1 for all fields that call Gitaly (with resolvers or without)
- Clarify comment regarding Gitaly call alert
- Expose predicate `calls_gitaly?` instead of ivar
---
 app/graphql/types/base_field.rb               | 16 +++-------
 .../graphql/calls_gitaly/instrumentation.rb   | 16 +++++++---
 spec/graphql/types/base_field_spec.rb         | 27 +++--------------
 .../calls_gitaly/instrumentation_spec.rb      | 29 +++++++++++++++++++
 spec/requests/api/graphql_spec.rb             |  2 +-
 5 files changed, 50 insertions(+), 40 deletions(-)
 create mode 100644 spec/lib/gitlab/graphql/calls_gitaly/instrumentation_spec.rb

diff --git a/app/graphql/types/base_field.rb b/app/graphql/types/base_field.rb
index 42c7eb6b485..6b377e88e16 100644
--- a/app/graphql/types/base_field.rb
+++ b/app/graphql/types/base_field.rb
@@ -4,8 +4,6 @@ module Types
   class BaseField < GraphQL::Schema::Field
     prepend Gitlab::Graphql::Authorize
 
-    attr_reader :calls_gitaly
-
     DEFAULT_COMPLEXITY = 1
 
     def initialize(*args, **kwargs, &block)
@@ -17,19 +15,12 @@ module Types
 
     def base_complexity
       complexity = DEFAULT_COMPLEXITY
-      complexity += 1 if @calls_gitaly
+      complexity += 1 if calls_gitaly?
       complexity
     end
 
-    def calls_gitaly_check(calls)
-      return if @calls_gitaly
-      return if calls < 1
-
-      # Will inform you if :calls_gitaly should be true or false based on the number of Gitaly calls
-      # involved with the request.
-      raise "Gitaly is called for field '#{name}' #{"on type #{owner.name} " if owner}- please add `calls_gitaly: true` to the field declaration"
-    rescue => e
-      Gitlab::Sentry.track_exception(e)
+    def calls_gitaly?
+      @calls_gitaly
     end
 
     private
@@ -51,6 +42,7 @@ module Types
       proc do |ctx, args, child_complexity|
         # Resolvers may add extra complexity depending on used arguments
         complexity = child_complexity + self.resolver&.try(:resolver_complexity, args, child_complexity: child_complexity).to_i
+        complexity += 1 if calls_gitaly?
 
         field_defn = to_graphql
 
diff --git a/lib/gitlab/graphql/calls_gitaly/instrumentation.rb b/lib/gitlab/graphql/calls_gitaly/instrumentation.rb
index 08e98028755..e2733a1416f 100644
--- a/lib/gitlab/graphql/calls_gitaly/instrumentation.rb
+++ b/lib/gitlab/graphql/calls_gitaly/instrumentation.rb
@@ -7,7 +7,7 @@ module Gitlab
         # Check if any `calls_gitaly: true` declarations need to be added
         def instrument(_type, field)
           type_object = field.metadata[:type_class]
-          return field unless type_object && type_object.respond_to?(:calls_gitaly_check)
+          return field unless type_object && type_object.respond_to?(:calls_gitaly?)
 
           old_resolver_proc = field.resolve_proc
 
@@ -15,16 +15,24 @@ module Gitlab
             previous_gitaly_call_count = Gitlab::GitalyClient.get_request_count
             result = old_resolver_proc.call(typed_object, args, ctx)
             current_gitaly_call_count = Gitlab::GitalyClient.get_request_count
-            type_object.calls_gitaly_check(current_gitaly_call_count - previous_gitaly_call_count)
+            calls_gitaly_check(type_object, current_gitaly_call_count - previous_gitaly_call_count)
             result
-          rescue => e
-            ap "#{e.message}"
           end
 
           field.redefine do
             resolve(gitaly_wrapped_resolve)
           end
         end
+
+        def calls_gitaly_check(type_object, calls)
+          return if type_object.calls_gitaly?
+          return if calls < 1
+
+          # Will inform you if there needs to be `calls_gitaly: true` as a kwarg in the field declaration
+          # if there is at least 1 Gitaly call involved with the field resolution.
+          error = RuntimeError.new("Gitaly is called for field '#{type_object.name}' on #{type_object.owner.try(:name)} - please add `calls_gitaly: true` to the field declaration")
+          Gitlab::Sentry.track_exception(error)
+        end
       end
     end
   end
diff --git a/spec/graphql/types/base_field_spec.rb b/spec/graphql/types/base_field_spec.rb
index 0be83ea60c4..10913e530cf 100644
--- a/spec/graphql/types/base_field_spec.rb
+++ b/spec/graphql/types/base_field_spec.rb
@@ -74,9 +74,11 @@ describe Types::BaseField do
     context 'calls_gitaly' do
       context 'for fields with a resolver' do
         it 'adds 1 if true' do
-          field = described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: true)
+          with_gitaly_field = described_class.new(name: 'test', type: GraphQL::STRING_TYPE, resolver_class: resolver, null: true, calls_gitaly: true)
+          without_gitaly_field = described_class.new(name: 'test', type: GraphQL::STRING_TYPE, resolver_class: resolver, null: true)
+          base_result = without_gitaly_field.to_graphql.complexity.call({}, {}, 2)
 
-          expect(field.to_graphql.complexity).to eq 2
+          expect(with_gitaly_field.to_graphql.complexity.call({}, {}, 2)).to eq base_result + 1
         end
       end
 
@@ -100,26 +102,5 @@ describe Types::BaseField do
         expect(field.to_graphql.complexity).to eq 12
       end
     end
-
-    describe '#calls_gitaly_check' do
-      let(:gitaly_field) { described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: true) }
-      let(:no_gitaly_field) { described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: false) }
-
-      context 'if there are no Gitaly calls' do
-        it 'does not raise an error if calls_gitaly is false' do
-          expect { no_gitaly_field.send(:calls_gitaly_check, 0) }.not_to raise_error
-        end
-      end
-
-      context 'if there is at least 1 Gitaly call' do
-        it 'does not raise an error if calls_gitaly is true' do
-          expect { gitaly_field.send(:calls_gitaly_check, 1) }.not_to raise_error
-        end
-
-        it 'raises an error if calls_gitaly: is false or not defined' do
-          expect { no_gitaly_field.send(:calls_gitaly_check, 1) }.to raise_error(/please add `calls_gitaly: true`/)
-        end
-      end
-    end
   end
 end
diff --git a/spec/lib/gitlab/graphql/calls_gitaly/instrumentation_spec.rb b/spec/lib/gitlab/graphql/calls_gitaly/instrumentation_spec.rb
new file mode 100644
index 00000000000..92d200bfd4e
--- /dev/null
+++ b/spec/lib/gitlab/graphql/calls_gitaly/instrumentation_spec.rb
@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+require 'spec_helper'
+
+describe Gitlab::Graphql::CallsGitaly::Instrumentation do
+  subject { described_class.new }
+
+  context 'when considering complexity' do
+    describe '#calls_gitaly_check' do
+      let(:gitaly_field) { Types::BaseField.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: true) }
+      let(:no_gitaly_field) { Types::BaseField.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: false) }
+
+      context 'if there are no Gitaly calls' do
+        it 'does not raise an error if calls_gitaly is false' do
+          expect { subject.send(:calls_gitaly_check, no_gitaly_field, 0) }.not_to raise_error
+        end
+      end
+
+      context 'if there is at least 1 Gitaly call' do
+        it 'does not raise an error if calls_gitaly is true' do
+          expect { subject.send(:calls_gitaly_check, gitaly_field, 1) }.not_to raise_error
+        end
+
+        it 'raises an error if calls_gitaly: is false or not defined' do
+          expect { subject.send(:calls_gitaly_check, no_gitaly_field, 1) }.to raise_error(/please add `calls_gitaly: true`/)
+        end
+      end
+    end
+  end
+end
diff --git a/spec/requests/api/graphql_spec.rb b/spec/requests/api/graphql_spec.rb
index d78b17827a6..67371cb35b6 100644
--- a/spec/requests/api/graphql_spec.rb
+++ b/spec/requests/api/graphql_spec.rb
@@ -137,7 +137,7 @@ describe 'GraphQL' do
     let(:user) { create(:user) }
 
     let(:query) do
-      graphql_query_for('project', { 'fullPath' => project.full_path }, %w(forksCount))
+      graphql_query_for('project', { 'fullPath' => project.full_path }, %w(id))
     end
 
     before do

From 1e225340190187c96960e138ab218504165cb351 Mon Sep 17 00:00:00 2001
From: Sanad Liaquat <sliaquat@gitlab.com>
Date: Wed, 3 Jul 2019 18:22:55 +0500
Subject: [PATCH 018/195] Return created group id

---
 qa/qa/tools/generate_perf_testdata.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/qa/qa/tools/generate_perf_testdata.rb b/qa/qa/tools/generate_perf_testdata.rb
index 1b053622f1b..26bcb2fe958 100644
--- a/qa/qa/tools/generate_perf_testdata.rb
+++ b/qa/qa/tools/generate_perf_testdata.rb
@@ -59,8 +59,8 @@ module QA
         group_search_response = create_a_group_api_req(@group_name, @visibility)
         group = JSON.parse(group_search_response.body)
         @urls[:group_page] = group["web_url"]
-        group["id"]
         STDOUT.puts "Created a group: #{@urls[:group_page]}"
+        group["id"]
       end
 
       def create_project(group_id)

From c3cf460f34649661a3e22fbb6417d57e0873bc43 Mon Sep 17 00:00:00 2001
From: Aurelien <a.coget@gmail.com>
Date: Wed, 3 Jul 2019 13:28:01 +0000
Subject: [PATCH 019/195] Minor spelling errors fixed

---
 doc/user/project/settings/index.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/user/project/settings/index.md b/doc/user/project/settings/index.md
index 2bf8d4dfe7b..01763c49207 100644
--- a/doc/user/project/settings/index.md
+++ b/doc/user/project/settings/index.md
@@ -9,7 +9,7 @@ to your project's homepage and clicking **Settings**.
 
 ## General settings
 
-Under a project's general settings you can find everything concerning the
+Under a project's general settings, you can find everything concerning the
 functionality of a project.
 
 ### General project settings
@@ -26,7 +26,7 @@ Set up your project's access, [visibility](../../../public_access/public_access.
 
 ![projects sharing permissions](img/sharing_and_permissions_settings.png)
 
-If Issues are disabled, or you can't access Issues because you're not a project member, then Lables and Milestones
+If Issues are disabled, or you can't access Issues because you're not a project member, then Labels and Milestones
 links will be missing from the sidebar UI.
 
 You can still access them with direct links if you can access Merge Requests. This is deliberate, if you can see
@@ -96,7 +96,7 @@ To rename a repository:
 1. Hit **Rename project**.
 
 Remember that this can have unintended side effects since everyone with the
-old URL will not be able to push or pull. Read more about what happens with the
+old URL will not be able to push or pull. Read more about what happens with the 
 [redirects when renaming repositories](../index.md#redirects-when-changing-repository-paths).
 
 #### Transferring an existing project into another namespace

From eaf58debac14474dc7ad5e5a6a6fc88da0af1370 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9my=20Coutable?= <remy@rymai.me>
Date: Wed, 3 Jul 2019 16:02:03 +0200
Subject: [PATCH 020/195] Only save Peek session in Redis when Peek is enabled
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Rémy Coutable <remy@rymai.me>
---
 config/initializers/peek.rb                          |  3 +++
 .../redis_adapter_when_peek_enabled.rb               | 12 ++++++++++++
 2 files changed, 15 insertions(+)
 create mode 100644 lib/gitlab/performance_bar/redis_adapter_when_peek_enabled.rb

diff --git a/config/initializers/peek.rb b/config/initializers/peek.rb
index cb108416b10..d492b60705d 100644
--- a/config/initializers/peek.rb
+++ b/config/initializers/peek.rb
@@ -42,3 +42,6 @@ class PEEK_DB_CLIENT
 end
 
 PEEK_DB_VIEW.prepend ::Gitlab::PerformanceBar::PeekQueryTracker
+
+require 'peek/adapters/redis'
+Peek::Adapters::Redis.prepend ::Gitlab::PerformanceBar::RedisAdapterWhenPeekEnabled
diff --git a/lib/gitlab/performance_bar/redis_adapter_when_peek_enabled.rb b/lib/gitlab/performance_bar/redis_adapter_when_peek_enabled.rb
new file mode 100644
index 00000000000..2d997760c46
--- /dev/null
+++ b/lib/gitlab/performance_bar/redis_adapter_when_peek_enabled.rb
@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# Adapted from https://github.com/peek/peek/blob/master/lib/peek/adapters/redis.rb
+module Gitlab
+  module PerformanceBar
+    module RedisAdapterWhenPeekEnabled
+      def save
+        super unless ::Peek.request_id.blank?
+      end
+    end
+  end
+end

From 564acca1119b78b0d86f1d214c2d4deebfa09e8b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ma=C5=82gorzata=20Ksionek?= <meksionek@gmail.com>
Date: Wed, 29 May 2019 10:11:27 +0200
Subject: [PATCH 021/195] Add salesforce logo

---
 app/assets/images/auth_buttons/salesforce_64.png | Bin 0 -> 8774 bytes
 app/helpers/auth_helper.rb                       |   2 +-
 2 files changed, 1 insertion(+), 1 deletion(-)
 create mode 100644 app/assets/images/auth_buttons/salesforce_64.png

diff --git a/app/assets/images/auth_buttons/salesforce_64.png b/app/assets/images/auth_buttons/salesforce_64.png
new file mode 100644
index 0000000000000000000000000000000000000000..c8a86a0c5153da2802a38009c2e9781d86b4ad23
GIT binary patch
literal 8774
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

literal 0
HcmV?d00001

diff --git a/app/helpers/auth_helper.rb b/app/helpers/auth_helper.rb
index 076976175a9..31c4b27273b 100644
--- a/app/helpers/auth_helper.rb
+++ b/app/helpers/auth_helper.rb
@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module AuthHelper
-  PROVIDERS_WITH_ICONS = %w(twitter github gitlab bitbucket google_oauth2 facebook azure_oauth2 authentiq).freeze
+  PROVIDERS_WITH_ICONS = %w(twitter github gitlab bitbucket google_oauth2 facebook azure_oauth2 authentiq salesforce).freeze
   LDAP_PROVIDER = /\Aldap/.freeze
 
   def ldap_enabled?

From 55ed4a405e814453f2f1722214e61deffd799c4f Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ma=C5=82gorzata=20Ksionek?= <meksionek@gmail.com>
Date: Wed, 29 May 2019 10:25:47 +0200
Subject: [PATCH 022/195] Add changelog entry

---
 changelogs/unreleased/add-salesforce-logo.yml | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 changelogs/unreleased/add-salesforce-logo.yml

diff --git a/changelogs/unreleased/add-salesforce-logo.yml b/changelogs/unreleased/add-salesforce-logo.yml
new file mode 100644
index 00000000000..13766821b88
--- /dev/null
+++ b/changelogs/unreleased/add-salesforce-logo.yml
@@ -0,0 +1,5 @@
+---
+title: Add salesforce logo for salesforce SSO
+merge_request: 28857
+author:
+type: changed

From def94f5043abe57f453094fa570407e5b806c48a Mon Sep 17 00:00:00 2001
From: Maneschi Romain <rmaneschi@gmail.com>
Date: Wed, 3 Jul 2019 16:09:51 +0000
Subject: [PATCH 023/195] Add Grafana to Admin > Monitoring menu when enabled

---
 app/helpers/application_settings_helper.rb     |  2 ++
 .../application_settings/_grafana.html.haml    | 17 +++++++++++++++++
 .../metrics_and_profiling.html.haml            | 11 +++++++++++
 app/views/layouts/nav/sidebar/_admin.html.haml |  5 +++++
 ...05-grafanaInAdminSettingsMonitoringMenu.yml |  5 +++++
 .../20190617123615_add_grafana_to_settings.rb  | 18 ++++++++++++++++++
 ...190624123615_add_grafana_url_to_settings.rb | 18 ++++++++++++++++++
 db/schema.rb                                   |  2 ++
 .../performance/grafana_configuration.md       | 15 +++++++++++++++
 lib/api/settings.rb                            |  2 ++
 locale/gitlab.pot                              | 18 ++++++++++++++++++
 11 files changed, 113 insertions(+)
 create mode 100644 app/views/admin/application_settings/_grafana.html.haml
 create mode 100644 changelogs/unreleased/61005-grafanaInAdminSettingsMonitoringMenu.yml
 create mode 100644 db/migrate/20190617123615_add_grafana_to_settings.rb
 create mode 100644 db/migrate/20190624123615_add_grafana_url_to_settings.rb

diff --git a/app/helpers/application_settings_helper.rb b/app/helpers/application_settings_helper.rb
index a7a4e945a99..4bf9b708401 100644
--- a/app/helpers/application_settings_helper.rb
+++ b/app/helpers/application_settings_helper.rb
@@ -187,6 +187,8 @@ module ApplicationSettingsHelper
       :gitaly_timeout_default,
       :gitaly_timeout_medium,
       :gitaly_timeout_fast,
+      :grafana_enabled,
+      :grafana_url,
       :gravatar_enabled,
       :hashed_storage_enabled,
       :help_page_hide_commercial_content,
diff --git a/app/views/admin/application_settings/_grafana.html.haml b/app/views/admin/application_settings/_grafana.html.haml
new file mode 100644
index 00000000000..b6e02bde895
--- /dev/null
+++ b/app/views/admin/application_settings/_grafana.html.haml
@@ -0,0 +1,17 @@
+= form_for @application_setting, url: admin_application_settings_path(anchor: 'js-grafana-settings'), html: { class: 'fieldset-form' } do |f|
+  = form_errors(@application_setting)
+
+  %fieldset
+    %p
+      = _("Add a Grafana button in the admin sidebar, monitoring section, to access a variety of statistics on the health and performance of GitLab.")
+      = link_to icon('question-circle'), help_page_path('administration/monitoring/performance/grafana_configuration.md')
+    .form-group
+      .form-check
+        = f.check_box :grafana_enabled, class: 'form-check-input'
+        = f.label :grafana_enabled, class: 'form-check-label' do
+          = _('Enable access to Grafana')
+    .form-group
+      = f.label :grafana_url, _('Grafana URL'), class: 'label-bold'
+      = f.text_field :grafana_url, class: 'form-control', placeholder: '/-/grafana'
+
+  = f.submit _('Save changes'), class: "btn btn-success"
diff --git a/app/views/admin/application_settings/metrics_and_profiling.html.haml b/app/views/admin/application_settings/metrics_and_profiling.html.haml
index 01d61beaf53..55a48da8342 100644
--- a/app/views/admin/application_settings/metrics_and_profiling.html.haml
+++ b/app/views/admin/application_settings/metrics_and_profiling.html.haml
@@ -24,6 +24,17 @@
   .settings-content
     = render 'prometheus'
 
+%section.settings.as-grafana.no-animate#js-grafana-settings{ class: ('expanded' if expanded_by_default?) }
+  .settings-header
+    %h4
+      = _('Metrics - Grafana')
+    %button.btn.btn-default.js-settings-toggle{ type: 'button' }
+      = expanded_by_default? ? _('Collapse') : _('Expand')
+    %p
+      = _('Enable and configure Grafana.')
+  .settings-content
+    = render 'grafana'
+
 %section.settings.qa-performance-bar-settings.as-performance-bar.no-animate#js-performance-bar-settings{ class: ('expanded' if expanded_by_default?) }
   .settings-header
     %h4
diff --git a/app/views/layouts/nav/sidebar/_admin.html.haml b/app/views/layouts/nav/sidebar/_admin.html.haml
index 83fe871285a..87133c7ba22 100644
--- a/app/views/layouts/nav/sidebar/_admin.html.haml
+++ b/app/views/layouts/nav/sidebar/_admin.html.haml
@@ -81,6 +81,11 @@
             = link_to admin_requests_profiles_path, title: _('Requests Profiles') do
               %span
                 = _('Requests Profiles')
+          - if Gitlab::CurrentSettings.current_application_settings.grafana_enabled?
+            = nav_link do
+              = link_to Gitlab::CurrentSettings.current_application_settings.grafana_url, target: '_blank', title: _('Metrics Dashboard') do
+                %span
+                  = _('Metrics Dashboard')
           = render_if_exists 'layouts/nav/ee/admin/new_monitoring_sidebar'
 
       = nav_link(controller: :broadcast_messages) do
diff --git a/changelogs/unreleased/61005-grafanaInAdminSettingsMonitoringMenu.yml b/changelogs/unreleased/61005-grafanaInAdminSettingsMonitoringMenu.yml
new file mode 100644
index 00000000000..3ee512f3448
--- /dev/null
+++ b/changelogs/unreleased/61005-grafanaInAdminSettingsMonitoringMenu.yml
@@ -0,0 +1,5 @@
+---
+title: Adds link to Grafana in Admin > Monitoring settings when grafana is enabled in config
+merge_request: 28937
+author: Romain Maneschi
+type: added
diff --git a/db/migrate/20190617123615_add_grafana_to_settings.rb b/db/migrate/20190617123615_add_grafana_to_settings.rb
new file mode 100644
index 00000000000..f9c6f4d883e
--- /dev/null
+++ b/db/migrate/20190617123615_add_grafana_to_settings.rb
@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+class AddGrafanaToSettings < ActiveRecord::Migration[5.1]
+  include Gitlab::Database::MigrationHelpers
+
+  disable_ddl_transaction!
+
+  DOWNTIME = false
+
+  def up
+    add_column_with_default(:application_settings, :grafana_enabled, :boolean,
+                            default: false, allow_null: false)
+  end
+
+  def down
+    remove_column(:application_settings, :grafana_enabled)
+  end
+end
diff --git a/db/migrate/20190624123615_add_grafana_url_to_settings.rb b/db/migrate/20190624123615_add_grafana_url_to_settings.rb
new file mode 100644
index 00000000000..61efe64a7a1
--- /dev/null
+++ b/db/migrate/20190624123615_add_grafana_url_to_settings.rb
@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+class AddGrafanaUrlToSettings < ActiveRecord::Migration[5.1]
+  include Gitlab::Database::MigrationHelpers
+
+  disable_ddl_transaction!
+
+  DOWNTIME = false
+
+  def up
+    add_column_with_default(:application_settings, :grafana_url, :string,
+                            default: '/-/grafana', allow_null: false)
+  end
+
+  def down
+    remove_column(:application_settings, :grafana_url)
+  end
+end
diff --git a/db/schema.rb b/db/schema.rb
index 32a25f643ce..4bcc8b5f1d7 100644
--- a/db/schema.rb
+++ b/db/schema.rb
@@ -193,6 +193,7 @@ ActiveRecord::Schema.define(version: 20190628185004) do
     t.string "required_instance_ci_template"
     t.boolean "dns_rebinding_protection_enabled", default: true, null: false
     t.boolean "default_project_deletion_protection", default: false, null: false
+    t.boolean "grafana_enabled", default: false, null: false
     t.boolean "lock_memberships_to_ldap", default: false, null: false
     t.text "help_text"
     t.boolean "elasticsearch_indexing", default: false, null: false
@@ -226,6 +227,7 @@ ActiveRecord::Schema.define(version: 20190628185004) do
     t.boolean "elasticsearch_limit_indexing", default: false, null: false
     t.string "geo_node_allowed_ips", default: "0.0.0.0/0, ::/0"
     t.boolean "time_tracking_limit_to_hours", default: false, null: false
+    t.string "grafana_url", default: "/-/grafana", null: false
     t.index ["custom_project_templates_group_id"], name: "index_application_settings_on_custom_project_templates_group_id", using: :btree
     t.index ["file_template_project_id"], name: "index_application_settings_on_file_template_project_id", using: :btree
     t.index ["usage_stats_set_by_user_id"], name: "index_application_settings_on_usage_stats_set_by_user_id", using: :btree
diff --git a/doc/administration/monitoring/performance/grafana_configuration.md b/doc/administration/monitoring/performance/grafana_configuration.md
index 187fb2f73a1..51b0d78681d 100644
--- a/doc/administration/monitoring/performance/grafana_configuration.md
+++ b/doc/administration/monitoring/performance/grafana_configuration.md
@@ -103,6 +103,21 @@ repository for more information on this process.
 
 [grafana-dashboards]: https://gitlab.com/gitlab-org/grafana-dashboards
 
+## Integration with GitLab UI
+
+> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/61005) in GitLab 12.1.
+
+If you have set up Grafana, you can enable a link to access it easily from the sidebar:
+
+1. Go to the admin area under **Settings > Metrics and profiling**
+   and expand "Metrics - Grafana".
+1. Check the "Enable access to Grafana" checkbox.
+1. If Grafana is enabled through Omnibus GitLab and on the same server,
+   leave "Grafana URL" unchanged. In any other case, enter the full URL
+   path of the Grafana instance.
+1. Click **Save changes**.
+1. The new link will be available in the admin area under **Monitoring > Metrics Dashboard**.
+
 ---
 
 Read more on:
diff --git a/lib/api/settings.rb b/lib/api/settings.rb
index 3c5c1a9fd5f..4275d911708 100644
--- a/lib/api/settings.rb
+++ b/lib/api/settings.rb
@@ -55,6 +55,8 @@ module API
       optional :gitaly_timeout_default, type: Integer, desc: 'Default Gitaly timeout, in seconds. Set to 0 to disable timeouts.'
       optional :gitaly_timeout_fast, type: Integer, desc: 'Gitaly fast operation timeout, in seconds. Set to 0 to disable timeouts.'
       optional :gitaly_timeout_medium, type: Integer, desc: 'Medium Gitaly timeout, in seconds. Set to 0 to disable timeouts.'
+      optional :grafana_enabled, type: Boolean, desc: 'Enable Grafana'
+      optional :grafana_url, type: String, desc: 'Grafana URL'
       optional :gravatar_enabled, type: Boolean, desc: 'Flag indicating if the Gravatar service is enabled'
       optional :help_page_hide_commercial_content, type: Boolean, desc: 'Hide marketing-related entries from help'
       optional :help_page_support_url, type: String, desc: 'Alternate support URL for help page'
diff --git a/locale/gitlab.pot b/locale/gitlab.pot
index 0738df663fb..8a4f57c5b13 100644
--- a/locale/gitlab.pot
+++ b/locale/gitlab.pot
@@ -605,6 +605,9 @@ msgstr ""
 msgid "Add a GPG key"
 msgstr ""
 
+msgid "Add a Grafana button in the admin sidebar, monitoring section, to access a variety of statistics on the health and performance of GitLab."
+msgstr ""
+
 msgid "Add a bullet list"
 msgstr ""
 
@@ -3923,9 +3926,15 @@ msgstr ""
 msgid "Enable HTML emails"
 msgstr ""
 
+msgid "Enable access to Grafana"
+msgstr ""
+
 msgid "Enable access to the Performance Bar for a given group."
 msgstr ""
 
+msgid "Enable and configure Grafana."
+msgstr ""
+
 msgid "Enable and configure InfluxDB metrics."
 msgstr ""
 
@@ -4933,6 +4942,9 @@ msgstr ""
 msgid "Got it!"
 msgstr ""
 
+msgid "Grafana URL"
+msgstr ""
+
 msgid "Grant access"
 msgstr ""
 
@@ -6391,12 +6403,18 @@ msgstr ""
 msgid "Metrics"
 msgstr ""
 
+msgid "Metrics - Grafana"
+msgstr ""
+
 msgid "Metrics - Influx"
 msgstr ""
 
 msgid "Metrics - Prometheus"
 msgstr ""
 
+msgid "Metrics Dashboard"
+msgstr ""
+
 msgid "Metrics and profiling"
 msgstr ""
 

From d0b76d065289b50a14b151f45fbb2718e8a50f86 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9my=20Coutable?= <remy@rymai.me>
Date: Wed, 3 Jul 2019 15:56:07 +0200
Subject: [PATCH 024/195] Cache PerformanceBar.allowed_user_ids list locally
 and in Redis
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Rémy Coutable <remy@rymai.me>
---
 lib/gitlab/performance_bar.rb           | 28 ++++++++++++++++++-------
 spec/lib/gitlab/performance_bar_spec.rb | 27 +++++++++++++++++++++++-
 2 files changed, 46 insertions(+), 9 deletions(-)

diff --git a/lib/gitlab/performance_bar.rb b/lib/gitlab/performance_bar.rb
index 4b0c7b5c7f8..07439d8e011 100644
--- a/lib/gitlab/performance_bar.rb
+++ b/lib/gitlab/performance_bar.rb
@@ -3,7 +3,8 @@
 module Gitlab
   module PerformanceBar
     ALLOWED_USER_IDS_KEY = 'performance_bar_allowed_user_ids:v2'.freeze
-    EXPIRY_TIME = 5.minutes
+    EXPIRY_TIME_L1_CACHE = 1.minute
+    EXPIRY_TIME_L2_CACHE = 5.minutes
 
     def self.enabled?(user = nil)
       return true if Rails.env.development?
@@ -19,20 +20,31 @@ module Gitlab
 
     # rubocop: disable CodeReuse/ActiveRecord
     def self.allowed_user_ids
-      Rails.cache.fetch(ALLOWED_USER_IDS_KEY, expires_in: EXPIRY_TIME) do
-        group = Group.find_by_id(allowed_group_id)
+      l1_cache_backend.fetch(ALLOWED_USER_IDS_KEY, expires_in: EXPIRY_TIME_L1_CACHE) do
+        l2_cache_backend.fetch(ALLOWED_USER_IDS_KEY, expires_in: EXPIRY_TIME_L2_CACHE) do
+          group = Group.find_by_id(allowed_group_id)
 
-        if group
-          GroupMembersFinder.new(group).execute.pluck(:user_id)
-        else
-          []
+          if group
+            GroupMembersFinder.new(group).execute.pluck(:user_id)
+          else
+            []
+          end
         end
       end
     end
     # rubocop: enable CodeReuse/ActiveRecord
 
     def self.expire_allowed_user_ids_cache
-      Rails.cache.delete(ALLOWED_USER_IDS_KEY)
+      l1_cache_backend.delete(ALLOWED_USER_IDS_KEY)
+      l2_cache_backend.delete(ALLOWED_USER_IDS_KEY)
+    end
+
+    def self.l1_cache_backend
+      Gitlab::ThreadMemoryCache.cache_backend
+    end
+
+    def self.l2_cache_backend
+      Rails.cache
     end
   end
 end
diff --git a/spec/lib/gitlab/performance_bar_spec.rb b/spec/lib/gitlab/performance_bar_spec.rb
index f480376acb4..ee3c571c9c0 100644
--- a/spec/lib/gitlab/performance_bar_spec.rb
+++ b/spec/lib/gitlab/performance_bar_spec.rb
@@ -3,17 +3,42 @@ require 'spec_helper'
 describe Gitlab::PerformanceBar do
   shared_examples 'allowed user IDs are cached' do
     before do
-      # Warm the Redis cache
+      # Warm the caches
       described_class.enabled?(user)
     end
 
     it 'caches the allowed user IDs in cache', :use_clean_rails_memory_store_caching do
       expect do
+        expect(described_class.l1_cache_backend).to receive(:fetch).and_call_original
+        expect(described_class.l2_cache_backend).not_to receive(:fetch)
         expect(described_class.enabled?(user)).to be_truthy
       end.not_to exceed_query_limit(0)
     end
+
+    it 'caches the allowed user IDs in L1 cache for 1 minute', :use_clean_rails_memory_store_caching do
+      Timecop.travel 2.minutes do
+        expect do
+          expect(described_class.l1_cache_backend).to receive(:fetch).and_call_original
+          expect(described_class.l2_cache_backend).to receive(:fetch).and_call_original
+          expect(described_class.enabled?(user)).to be_truthy
+        end.not_to exceed_query_limit(0)
+      end
+    end
+
+    it 'caches the allowed user IDs in L2 cache for 5 minutes', :use_clean_rails_memory_store_caching do
+      Timecop.travel 6.minutes do
+        expect do
+          expect(described_class.l1_cache_backend).to receive(:fetch).and_call_original
+          expect(described_class.l2_cache_backend).to receive(:fetch).and_call_original
+          expect(described_class.enabled?(user)).to be_truthy
+        end.not_to exceed_query_limit(2)
+      end
+    end
   end
 
+  it { expect(described_class.l1_cache_backend).to eq(Gitlab::ThreadMemoryCache.cache_backend) }
+  it { expect(described_class.l2_cache_backend).to eq(Rails.cache) }
+
   describe '.enabled?' do
     let(:user) { create(:user) }
 

From 9af6dd3e8d1579d55759de49032a78f277162f66 Mon Sep 17 00:00:00 2001
From: Igor <idrozdov@gitlab.com>
Date: Wed, 3 Jul 2019 17:56:17 +0000
Subject: [PATCH 025/195] Put a failed example from appearance_spec in
 quarantine

---
 spec/models/appearance_spec.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec/models/appearance_spec.rb b/spec/models/appearance_spec.rb
index 209d138f956..75d850623f4 100644
--- a/spec/models/appearance_spec.rb
+++ b/spec/models/appearance_spec.rb
@@ -21,7 +21,7 @@ describe Appearance do
     end
   end
 
-  context 'with uploads' do
+  context 'with uploads', :quarantine do
     it_behaves_like 'model with uploads', false do
       let(:model_object) { create(:appearance, :with_logo) }
       let(:upload_attribute) { :logo }

From 3b924c13460d4afe26c386633241d1362d10e824 Mon Sep 17 00:00:00 2001
From: Stan Hu <stanhu@gmail.com>
Date: Wed, 3 Jul 2019 11:27:16 -0700
Subject: [PATCH 026/195] Fix order-dependent spec failure in
 appearance_spec.rb

When file_mover_spec.rb ran, it would initialize fog-aws with
`Fog::AWS::Storage::Real` service instead of `Fog::AWS::Storage::Mock`
because `Fog.mock!` was not called. Ensure that we use
`stub_uploads_object_storage` to prevent that from happening.

Closes https://gitlab.com/gitlab-org/gitlab-ce/issues/64083
---
 spec/models/appearance_spec.rb    | 2 +-
 spec/uploaders/file_mover_spec.rb | 3 +--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/spec/models/appearance_spec.rb b/spec/models/appearance_spec.rb
index 75d850623f4..209d138f956 100644
--- a/spec/models/appearance_spec.rb
+++ b/spec/models/appearance_spec.rb
@@ -21,7 +21,7 @@ describe Appearance do
     end
   end
 
-  context 'with uploads', :quarantine do
+  context 'with uploads' do
     it_behaves_like 'model with uploads', false do
       let(:model_object) { create(:appearance, :with_logo) }
       let(:upload_attribute) { :logo }
diff --git a/spec/uploaders/file_mover_spec.rb b/spec/uploaders/file_mover_spec.rb
index a9e03f3d4e5..5ee0a10f38d 100644
--- a/spec/uploaders/file_mover_spec.rb
+++ b/spec/uploaders/file_mover_spec.rb
@@ -85,8 +85,7 @@ describe FileMover do
 
     context 'when tmp uploader is not local storage' do
       before do
-        allow(PersonalFileUploader).to receive(:object_store_enabled?) { true }
-        tmp_uploader.object_store = ObjectStorage::Store::REMOTE
+        stub_uploads_object_storage(uploader: PersonalFileUploader)
         allow_any_instance_of(PersonalFileUploader).to receive(:file_storage?) { false }
       end
 

From ee685e228a4e1eac4567287aaa84ad27db2face1 Mon Sep 17 00:00:00 2001
From: Walmyr Lima <walmyr@gitlab.com>
Date: Wed, 3 Jul 2019 19:12:41 +0200
Subject: [PATCH 027/195] Backport EE MR that improves end-to-end tests

https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/14533
---
 .../collapse_comments_in_discussions_spec.rb  | 26 ++++++++++++-------
 .../issue/filter_issue_comments_spec.rb       | 23 +++++++++-------
 .../2_plan/issue/issue_suggestions_spec.rb    |  2 +-
 3 files changed, 31 insertions(+), 20 deletions(-)

diff --git a/qa/qa/specs/features/browser_ui/2_plan/issue/collapse_comments_in_discussions_spec.rb b/qa/qa/specs/features/browser_ui/2_plan/issue/collapse_comments_in_discussions_spec.rb
index 4478ea41662..2101311f065 100644
--- a/qa/qa/specs/features/browser_ui/2_plan/issue/collapse_comments_in_discussions_spec.rb
+++ b/qa/qa/specs/features/browser_ui/2_plan/issue/collapse_comments_in_discussions_spec.rb
@@ -9,27 +9,33 @@ module QA
         Runtime::Browser.visit(:gitlab, Page::Main::Login)
         Page::Main::Login.perform(&:sign_in_using_credentials)
 
-        Resource::Issue.fabricate_via_browser_ui! do |issue|
+        issue = Resource::Issue.fabricate_via_api! do |issue|
           issue.title = issue_title
         end
 
+        issue.visit!
+
         expect(page).to have_content(issue_title)
 
         Page::Project::Issue::Show.perform do |show_page|
-          show_page.select_all_activities_filter
-          show_page.start_discussion("My first discussion")
-          expect(show_page).to have_content("My first discussion")
+          my_first_discussion = "My first discussion"
+          my_first_reply = "My First Reply"
+          one_reply = "1 reply"
 
-          show_page.reply_to_discussion("My First Reply")
-          expect(show_page).to have_content("My First Reply")
+          show_page.select_all_activities_filter
+          show_page.start_discussion(my_first_discussion)
+          expect(show_page).to have_content(my_first_discussion)
+
+          show_page.reply_to_discussion(my_first_reply)
+          expect(show_page).to have_content(my_first_reply)
 
           show_page.collapse_replies
-          expect(show_page).to have_content("1 reply")
-          expect(show_page).not_to have_content("My First Reply")
+          expect(show_page).to have_content(one_reply)
+          expect(show_page).not_to have_content(my_first_reply)
 
           show_page.expand_replies
-          expect(show_page).to have_content("My First Reply")
-          expect(show_page).not_to have_content("1 reply")
+          expect(show_page).to have_content(my_first_reply)
+          expect(show_page).not_to have_content(one_reply)
         end
       end
     end
diff --git a/qa/qa/specs/features/browser_ui/2_plan/issue/filter_issue_comments_spec.rb b/qa/qa/specs/features/browser_ui/2_plan/issue/filter_issue_comments_spec.rb
index ad2773b41ac..301836f5ce8 100644
--- a/qa/qa/specs/features/browser_ui/2_plan/issue/filter_issue_comments_spec.rb
+++ b/qa/qa/specs/features/browser_ui/2_plan/issue/filter_issue_comments_spec.rb
@@ -9,28 +9,33 @@ module QA
         Runtime::Browser.visit(:gitlab, Page::Main::Login)
         Page::Main::Login.act { sign_in_using_credentials }
 
-        Resource::Issue.fabricate_via_browser_ui! do |issue|
+        issue = Resource::Issue.fabricate_via_api! do |issue|
           issue.title = issue_title
         end
 
+        issue.visit!
+
         expect(page).to have_content(issue_title)
 
         Page::Project::Issue::Show.perform do |show_page|
-          show_page.comment('/confidential', filter: :comments_only)
-          show_page.comment('My own comment', filter: :comments_only)
+          my_own_comment = "My own comment"
+          made_the_issue_confidential = "made the issue confidential"
 
-          expect(show_page).not_to have_content("made the issue confidential")
-          expect(show_page).to have_content("My own comment")
+          show_page.comment('/confidential', filter: :comments_only)
+          show_page.comment(my_own_comment, filter: :comments_only)
+
+          expect(show_page).not_to have_content(made_the_issue_confidential)
+          expect(show_page).to have_content(my_own_comment)
 
           show_page.select_all_activities_filter
 
-          expect(show_page).to have_content("made the issue confidential")
-          expect(show_page).to have_content("My own comment")
+          expect(show_page).to have_content(made_the_issue_confidential)
+          expect(show_page).to have_content(my_own_comment)
 
           show_page.select_history_only_filter
 
-          expect(show_page).to have_content("made the issue confidential")
-          expect(show_page).not_to have_content("My own comment")
+          expect(show_page).to have_content(made_the_issue_confidential)
+          expect(show_page).not_to have_content(my_own_comment)
         end
       end
     end
diff --git a/qa/qa/specs/features/browser_ui/2_plan/issue/issue_suggestions_spec.rb b/qa/qa/specs/features/browser_ui/2_plan/issue/issue_suggestions_spec.rb
index 530fc684437..24dcb32f63f 100644
--- a/qa/qa/specs/features/browser_ui/2_plan/issue/issue_suggestions_spec.rb
+++ b/qa/qa/specs/features/browser_ui/2_plan/issue/issue_suggestions_spec.rb
@@ -14,7 +14,7 @@ module QA
           resource.description = 'project for issue suggestions'
         end
 
-        Resource::Issue.fabricate_via_browser_ui! do |issue|
+        Resource::Issue.fabricate_via_api! do |issue|
           issue.title = issue_title
           issue.project = project
         end

From 76b0518f334090294d4ad7db7be64846f6018e80 Mon Sep 17 00:00:00 2001
From: Heinrich Lee Yu <heinrich@gitlab.com>
Date: Fri, 21 Jun 2019 05:01:14 +0800
Subject: [PATCH 028/195] Use #filename when generating upload URLs

We don't need to find the filename from the remote URL
---
 app/uploaders/file_uploader.rb                |  2 +-
 app/uploaders/personal_file_uploader.rb       |  2 +-
 .../53357-fix-plus-in-upload-file-names.yml   |  5 ++
 spec/uploaders/file_uploader_spec.rb          | 68 +++++++++++--------
 4 files changed, 46 insertions(+), 31 deletions(-)
 create mode 100644 changelogs/unreleased/53357-fix-plus-in-upload-file-names.yml

diff --git a/app/uploaders/file_uploader.rb b/app/uploaders/file_uploader.rb
index 1c7582533ad..b326b266017 100644
--- a/app/uploaders/file_uploader.rb
+++ b/app/uploaders/file_uploader.rb
@@ -203,6 +203,6 @@ class FileUploader < GitlabUploader
   end
 
   def secure_url
-    File.join('/uploads', @secret, file.filename)
+    File.join('/uploads', @secret, filename)
   end
 end
diff --git a/app/uploaders/personal_file_uploader.rb b/app/uploaders/personal_file_uploader.rb
index b43162f0935..1ac69601d18 100644
--- a/app/uploaders/personal_file_uploader.rb
+++ b/app/uploaders/personal_file_uploader.rb
@@ -93,6 +93,6 @@ class PersonalFileUploader < FileUploader
   end
 
   def secure_url
-    File.join('/', base_dir, secret, file.filename)
+    File.join('/', base_dir, secret, filename)
   end
 end
diff --git a/changelogs/unreleased/53357-fix-plus-in-upload-file-names.yml b/changelogs/unreleased/53357-fix-plus-in-upload-file-names.yml
new file mode 100644
index 00000000000..c11d74bd4fe
--- /dev/null
+++ b/changelogs/unreleased/53357-fix-plus-in-upload-file-names.yml
@@ -0,0 +1,5 @@
+---
+title: Fix broken URLs for uploads with a plus in the filename
+merge_request: 29915
+author:
+type: fixed
diff --git a/spec/uploaders/file_uploader_spec.rb b/spec/uploaders/file_uploader_spec.rb
index 185c62491ce..04206de3dc6 100644
--- a/spec/uploaders/file_uploader_spec.rb
+++ b/spec/uploaders/file_uploader_spec.rb
@@ -184,40 +184,37 @@ describe FileUploader do
     end
   end
 
-  describe '#cache!' do
-    subject do
+  context 'when remote file is used' do
+    let(:temp_file) { Tempfile.new("test") }
+
+    let!(:fog_connection) do
+      stub_uploads_object_storage(described_class)
+    end
+
+    let(:filename) { "my file.txt" }
+    let(:uploaded_file) do
+      UploadedFile.new(temp_file.path, filename: filename, remote_id: "test/123123")
+    end
+
+    let!(:fog_file) do
+      fog_connection.directories.new(key: 'uploads').files.create(
+        key: 'tmp/uploads/test/123123',
+        body: 'content'
+      )
+    end
+
+    before do
+      FileUtils.touch(temp_file)
+
       uploader.store!(uploaded_file)
     end
 
-    context 'when remote file is used' do
-      let(:temp_file) { Tempfile.new("test") }
-
-      let!(:fog_connection) do
-        stub_uploads_object_storage(described_class)
-      end
-
-      let(:uploaded_file) do
-        UploadedFile.new(temp_file.path, filename: "my file.txt", remote_id: "test/123123")
-      end
-
-      let!(:fog_file) do
-        fog_connection.directories.new(key: 'uploads').files.create(
-          key: 'tmp/uploads/test/123123',
-          body: 'content'
-        )
-      end
-
-      before do
-        FileUtils.touch(temp_file)
-      end
-
-      after do
-        FileUtils.rm_f(temp_file)
-      end
+    after do
+      FileUtils.rm_f(temp_file)
+    end
 
+    describe '#cache!' do
       it 'file is stored remotely in permament location with sanitized name' do
-        subject
-
         expect(uploader).to be_exists
         expect(uploader).not_to be_cached
         expect(uploader).not_to be_file_storage
@@ -228,5 +225,18 @@ describe FileUploader do
         expect(uploader.object_store).to eq(described_class::Store::REMOTE)
       end
     end
+
+    describe '#to_h' do
+      subject { uploader.to_h }
+
+      let(:filename) { 'my+file.txt' }
+
+      it 'generates URL using original file name instead of filename returned by object storage' do
+        # GCS returns a URL with a `+` instead of `%2B`
+        allow(uploader.file).to receive(:url).and_return('https://storage.googleapis.com/gitlab-test-uploads/@hashed/6b/86/6b86b273ff34fce19d6b804eff5a3f5747ada4eaa22f1d49c01e52ddb7875b4b/64c5065e62100b1a12841644256a98be/my+file.txt')
+
+        expect(subject[:url]).to end_with(filename)
+      end
+    end
   end
 end

From 9dc1850524b8c3ea784ed61b40c8b6be5ffa8831 Mon Sep 17 00:00:00 2001
From: Cynthia Ng <cng@gitlab.com>
Date: Wed, 3 Jul 2019 20:02:07 +0000
Subject: [PATCH 029/195] Update link to page instead of redirect

---
 doc/user/project/deploy_boards.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/user/project/deploy_boards.md b/doc/user/project/deploy_boards.md
index 175384bc985..0d51e8ae19a 100644
--- a/doc/user/project/deploy_boards.md
+++ b/doc/user/project/deploy_boards.md
@@ -125,6 +125,6 @@ version of your application.
 [kube-service]: integrations/kubernetes.md "Kubernetes project service"
 [review apps]: ../../ci/review_apps/index.md "Review Apps documentation"
 [variables]: ../../ci/variables/README.md "GitLab CI variables"
-[autodeploy]: ../../ci/autodeploy/index.md "GitLab Autodeploy"
+[autodeploy]: ../../topics/autodevops/index.md#auto-deploy "GitLab Autodeploy"
 [kube-image]: https://gitlab.com/gitlab-examples/kubernetes-deploy/container_registry "Kubernetes deploy Container Registry"
 [runners]: ../../ci/runners/README.md

From 49b5ef5c3110ec25b65e20c75c3f98dbb2c8dfea Mon Sep 17 00:00:00 2001
From: Reuben Pereira <rpereira@gitlab.com>
Date: Wed, 3 Jul 2019 20:02:17 +0000
Subject: [PATCH 030/195] Change occurrence of Sidekiq::Testing.inline!

- Change it to perform_enqueued_jobs
---
 .../migrations/backfill_store_project_full_path_in_repo_spec.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec/migrations/backfill_store_project_full_path_in_repo_spec.rb b/spec/migrations/backfill_store_project_full_path_in_repo_spec.rb
index 34f4a36d63d..65a918d5440 100644
--- a/spec/migrations/backfill_store_project_full_path_in_repo_spec.rb
+++ b/spec/migrations/backfill_store_project_full_path_in_repo_spec.rb
@@ -13,7 +13,7 @@ describe BackfillStoreProjectFullPathInRepo, :migration do
   subject(:migration) { described_class.new }
 
   around do |example|
-    Sidekiq::Testing.inline! do
+    perform_enqueued_jobs do
       example.run
     end
   end

From a08209ffa35a29cd84271895389b4537dee92e86 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Trzci=C5=84ski?= <ayufan@ayufan.eu>
Date: Tue, 2 Jul 2019 19:40:21 +0200
Subject: [PATCH 031/195] Limit amount of JUnit tests returned

Currently, we do not cap amount of tests returned to frontend,
thus in some extreme cases we can see a MBs of data stored in Redis.

This adds an upper limit of 100 tests per-suite.

We will continue showing the total counters correctly,
but we will limit amount of tests that will be presented.
---
 app/serializers/test_suite_comparer_entity.rb | 29 +++++-
 .../ci/compare_reports_base_service.rb        |  6 +-
 .../limit-amount-of-tests-returned.yml        |  5 +
 .../user_sees_merge_widget_spec.rb            | 62 ++++++++++---
 .../ci/reports/test_reports_comparer_spec.rb  |  8 +-
 .../ci/reports/test_suite_comparer_spec.rb    | 23 ++---
 spec/serializers/test_case_entity_spec.rb     |  2 +-
 .../test_reports_comparer_entity_spec.rb      |  8 +-
 .../test_reports_comparer_serializer_spec.rb  |  8 +-
 .../test_suite_comparer_entity_spec.rb        | 92 ++++++++++++++++---
 .../test_reports/test_reports_helper.rb       | 34 +++----
 11 files changed, 189 insertions(+), 88 deletions(-)
 create mode 100644 changelogs/unreleased/limit-amount-of-tests-returned.yml

diff --git a/app/serializers/test_suite_comparer_entity.rb b/app/serializers/test_suite_comparer_entity.rb
index 9fa3a897ebe..d402a4d5718 100644
--- a/app/serializers/test_suite_comparer_entity.rb
+++ b/app/serializers/test_suite_comparer_entity.rb
@@ -1,6 +1,9 @@
 # frozen_string_literal: true
 
 class TestSuiteComparerEntity < Grape::Entity
+  DEFAULT_MAX_TESTS = 100
+  DEFAULT_MIN_TESTS = 10
+
   expose :name
   expose :total_status, as: :status
 
@@ -10,7 +13,27 @@ class TestSuiteComparerEntity < Grape::Entity
     expose :failed_count, as: :failed
   end
 
-  expose :new_failures, using: TestCaseEntity
-  expose :resolved_failures, using: TestCaseEntity
-  expose :existing_failures, using: TestCaseEntity
+  # rubocop: disable CodeReuse/ActiveRecord
+  expose :new_failures, using: TestCaseEntity do |suite|
+    suite.new_failures.take(max_tests)
+  end
+
+  expose :existing_failures, using: TestCaseEntity do |suite|
+    suite.existing_failures.take(
+      max_tests(suite.new_failures))
+  end
+
+  expose :resolved_failures, using: TestCaseEntity do |suite|
+    suite.resolved_failures.take(
+      max_tests(suite.new_failures, suite.existing_failures))
+  end
+
+  private
+
+  def max_tests(*used)
+    return Integer::MAX unless Feature.enabled?(:ci_limit_test_reports_size, default_enabled: true)
+
+    [DEFAULT_MAX_TESTS - used.map(&:count).sum, DEFAULT_MIN_TESTS].max
+  end
+  # rubocop: enable CodeReuse/ActiveRecord
 end
diff --git a/app/services/ci/compare_reports_base_service.rb b/app/services/ci/compare_reports_base_service.rb
index d5625857599..6c2d80d8f45 100644
--- a/app/services/ci/compare_reports_base_service.rb
+++ b/app/services/ci/compare_reports_base_service.rb
@@ -8,7 +8,7 @@ module Ci
         status: :parsed,
         key: key(base_pipeline, head_pipeline),
         data: serializer_class
-          .new(project: project)
+          .new(**serializer_params)
           .represent(comparer).as_json
       }
     rescue Gitlab::Ci::Parsers::ParserError => e
@@ -40,6 +40,10 @@ module Ci
       raise NotImplementedError
     end
 
+    def serializer_params
+      { project: project }
+    end
+
     def get_report(pipeline)
       raise NotImplementedError
     end
diff --git a/changelogs/unreleased/limit-amount-of-tests-returned.yml b/changelogs/unreleased/limit-amount-of-tests-returned.yml
new file mode 100644
index 00000000000..0e80a64b6b7
--- /dev/null
+++ b/changelogs/unreleased/limit-amount-of-tests-returned.yml
@@ -0,0 +1,5 @@
+---
+title: Limit amount of JUnit tests returned
+merge_request: 30274
+author:
+type: performance
diff --git a/spec/features/merge_request/user_sees_merge_widget_spec.rb b/spec/features/merge_request/user_sees_merge_widget_spec.rb
index 733e8aa3eba..30e30751693 100644
--- a/spec/features/merge_request/user_sees_merge_widget_spec.rb
+++ b/spec/features/merge_request/user_sees_merge_widget_spec.rb
@@ -519,6 +519,8 @@ describe 'Merge request > User sees merge widget', :js do
       end
 
       before do
+        allow_any_instance_of(TestSuiteComparerEntity)
+          .to receive(:max_tests).and_return(2)
         allow_any_instance_of(MergeRequest)
           .to receive(:has_test_reports?).and_return(true)
         allow_any_instance_of(MergeRequest)
@@ -551,7 +553,7 @@ describe 'Merge request > User sees merge widget', :js do
               expect(page).to have_content('rspec found no changed test results out of 1 total test')
               expect(page).to have_content('junit found 1 failed test result out of 1 total test')
               expect(page).to have_content('New')
-              expect(page).to have_content('subtractTest')
+              expect(page).to have_content('addTest')
             end
           end
         end
@@ -562,7 +564,7 @@ describe 'Merge request > User sees merge widget', :js do
               click_button 'Expand'
 
               within(".js-report-section-container") do
-                click_button 'subtractTest'
+                click_button 'addTest'
 
                 expect(page).to have_content('6.66')
                 expect(page).to have_content(sample_java_failed_message.gsub!(/\s+/, ' ').strip)
@@ -596,7 +598,7 @@ describe 'Merge request > User sees merge widget', :js do
               expect(page).to have_content('rspec found 1 failed test result out of 1 total test')
               expect(page).to have_content('junit found no changed test results out of 1 total test')
               expect(page).not_to have_content('New')
-              expect(page).to have_content('Test#sum when a is 2 and b is 2 returns summary')
+              expect(page).to have_content('Test#sum when a is 1 and b is 3 returns summary')
             end
           end
         end
@@ -607,7 +609,7 @@ describe 'Merge request > User sees merge widget', :js do
               click_button 'Expand'
 
               within(".js-report-section-container") do
-                click_button 'Test#sum when a is 2 and b is 2 returns summary'
+                click_button 'Test#sum when a is 1 and b is 3 returns summary'
 
                 expect(page).to have_content('2.22')
                 expect(page).to have_content(sample_rspec_failed_message.gsub!(/\s+/, ' ').strip)
@@ -628,13 +630,7 @@ describe 'Merge request > User sees merge widget', :js do
         let(:head_reports) do
           Gitlab::Ci::Reports::TestReports.new.tap do |reports|
             reports.get_suite('rspec').add_test_case(create_test_case_rspec_success)
-            reports.get_suite('junit').add_test_case(create_test_case_java_resolved)
-          end
-        end
-
-        let(:create_test_case_java_resolved) do
-          create_test_case_java_failed.tap do |test_case|
-            test_case.instance_variable_set("@status", Gitlab::Ci::Reports::TestCase::STATUS_SUCCESS)
+            reports.get_suite('junit').add_test_case(create_test_case_java_success)
           end
         end
 
@@ -646,7 +642,7 @@ describe 'Merge request > User sees merge widget', :js do
             within(".js-report-section-container") do
               expect(page).to have_content('rspec found no changed test results out of 1 total test')
               expect(page).to have_content('junit found 1 fixed test result out of 1 total test')
-              expect(page).to have_content('subtractTest')
+              expect(page).to have_content('addTest')
             end
           end
         end
@@ -657,15 +653,53 @@ describe 'Merge request > User sees merge widget', :js do
               click_button 'Expand'
 
               within(".js-report-section-container") do
-                click_button 'subtractTest'
+                click_button 'addTest'
 
-                expect(page).to have_content('6.66')
+                expect(page).to have_content('5.55')
               end
             end
           end
         end
       end
 
+      context 'properly truncates the report' do
+        let(:base_reports) do
+          Gitlab::Ci::Reports::TestReports.new.tap do |reports|
+            10.times do |index|
+              reports.get_suite('rspec').add_test_case(
+                create_test_case_rspec_failed(index))
+              reports.get_suite('junit').add_test_case(
+                create_test_case_java_success(index))
+            end
+          end
+        end
+
+        let(:head_reports) do
+          Gitlab::Ci::Reports::TestReports.new.tap do |reports|
+            10.times do |index|
+              reports.get_suite('rspec').add_test_case(
+                create_test_case_rspec_failed(index))
+              reports.get_suite('junit').add_test_case(
+                create_test_case_java_failed(index))
+            end
+          end
+        end
+
+        it 'shows test reports summary which includes the resolved failure' do
+          within(".js-reports-container") do
+            click_button 'Expand'
+
+            expect(page).to have_content('Test summary contained 20 failed test results out of 20 total tests')
+            within(".js-report-section-container") do
+              expect(page).to have_content('rspec found 10 failed test results out of 10 total tests')
+              expect(page).to have_content('junit found 10 failed test results out of 10 total tests')
+
+              expect(page).to have_content('Test#sum when a is 1 and b is 3 returns summary', count: 2)
+            end
+          end
+        end
+      end
+
       def comparer
         Gitlab::Ci::Reports::TestReportsComparer.new(base_reports, head_reports)
       end
diff --git a/spec/lib/gitlab/ci/reports/test_reports_comparer_spec.rb b/spec/lib/gitlab/ci/reports/test_reports_comparer_spec.rb
index 71c61e0345f..36582204cc1 100644
--- a/spec/lib/gitlab/ci/reports/test_reports_comparer_spec.rb
+++ b/spec/lib/gitlab/ci/reports/test_reports_comparer_spec.rb
@@ -74,17 +74,11 @@ describe Gitlab::Ci::Reports::TestReportsComparer do
     subject { comparer.resolved_count }
 
     context 'when there is a resolved test case in head suites' do
-      let(:create_test_case_java_resolved) do
-        create_test_case_java_failed.tap do |test_case|
-          test_case.instance_variable_set("@status", Gitlab::Ci::Reports::TestCase::STATUS_SUCCESS)
-        end
-      end
-
       before do
         base_reports.get_suite('rspec').add_test_case(create_test_case_rspec_success)
         base_reports.get_suite('junit').add_test_case(create_test_case_java_failed)
         head_reports.get_suite('rspec').add_test_case(create_test_case_rspec_success)
-        head_reports.get_suite('junit').add_test_case(create_test_case_java_resolved)
+        head_reports.get_suite('junit').add_test_case(create_test_case_java_success)
       end
 
       it 'returns the correct count' do
diff --git a/spec/lib/gitlab/ci/reports/test_suite_comparer_spec.rb b/spec/lib/gitlab/ci/reports/test_suite_comparer_spec.rb
index 6ab16e5518d..579b3e6fd24 100644
--- a/spec/lib/gitlab/ci/reports/test_suite_comparer_spec.rb
+++ b/spec/lib/gitlab/ci/reports/test_suite_comparer_spec.rb
@@ -10,12 +10,6 @@ describe Gitlab::Ci::Reports::TestSuiteComparer do
   let(:test_case_success) { create_test_case_rspec_success }
   let(:test_case_failed) { create_test_case_rspec_failed }
 
-  let(:test_case_resolved) do
-    create_test_case_rspec_failed.tap do |test_case|
-      test_case.instance_variable_set("@status", Gitlab::Ci::Reports::TestCase::STATUS_SUCCESS)
-    end
-  end
-
   describe '#new_failures' do
     subject { comparer.new_failures }
 
@@ -44,7 +38,7 @@ describe Gitlab::Ci::Reports::TestSuiteComparer do
     context 'when head sutie has a success test case which failed in base' do
       before do
         base_suite.add_test_case(test_case_failed)
-        head_suite.add_test_case(test_case_resolved)
+        head_suite.add_test_case(test_case_success)
       end
 
       it 'does not return the failed test case' do
@@ -81,7 +75,7 @@ describe Gitlab::Ci::Reports::TestSuiteComparer do
     context 'when head sutie has a success test case which failed in base' do
       before do
         base_suite.add_test_case(test_case_failed)
-        head_suite.add_test_case(test_case_resolved)
+        head_suite.add_test_case(test_case_success)
       end
 
       it 'does not return the failed test case' do
@@ -126,11 +120,11 @@ describe Gitlab::Ci::Reports::TestSuiteComparer do
     context 'when head sutie has a success test case which failed in base' do
       before do
         base_suite.add_test_case(test_case_failed)
-        head_suite.add_test_case(test_case_resolved)
+        head_suite.add_test_case(test_case_success)
       end
 
       it 'does not return the resolved test case' do
-        is_expected.to eq([test_case_resolved])
+        is_expected.to eq([test_case_success])
       end
 
       it 'returns the correct resolved count' do
@@ -156,13 +150,8 @@ describe Gitlab::Ci::Reports::TestSuiteComparer do
 
     context 'when there are a new failure and an existing failure' do
       let(:test_case_1_success) { create_test_case_rspec_success }
-      let(:test_case_2_failed) { create_test_case_rspec_failed }
-
-      let(:test_case_1_failed) do
-        create_test_case_rspec_success.tap do |test_case|
-          test_case.instance_variable_set("@status", Gitlab::Ci::Reports::TestCase::STATUS_FAILED)
-        end
-      end
+      let(:test_case_1_failed) { create_test_case_rspec_failed }
+      let(:test_case_2_failed) { create_test_case_rspec_failed('case2') }
 
       before do
         base_suite.add_test_case(test_case_1_success)
diff --git a/spec/serializers/test_case_entity_spec.rb b/spec/serializers/test_case_entity_spec.rb
index 986c9feb07b..cc5f086ca4e 100644
--- a/spec/serializers/test_case_entity_spec.rb
+++ b/spec/serializers/test_case_entity_spec.rb
@@ -24,7 +24,7 @@ describe TestCaseEntity do
 
       it 'contains correct test case details' do
         expect(subject[:status]).to eq('failed')
-        expect(subject[:name]).to eq('Test#sum when a is 2 and b is 2 returns summary')
+        expect(subject[:name]).to eq('Test#sum when a is 1 and b is 3 returns summary')
         expect(subject[:classname]).to eq('spec.test_spec')
         expect(subject[:execution_time]).to eq(2.22)
       end
diff --git a/spec/serializers/test_reports_comparer_entity_spec.rb b/spec/serializers/test_reports_comparer_entity_spec.rb
index 59c058fe368..4a951bbbde4 100644
--- a/spec/serializers/test_reports_comparer_entity_spec.rb
+++ b/spec/serializers/test_reports_comparer_entity_spec.rb
@@ -53,13 +53,7 @@ describe TestReportsComparerEntity do
           base_reports.get_suite('rspec').add_test_case(create_test_case_rspec_success)
           base_reports.get_suite('junit').add_test_case(create_test_case_java_failed)
           head_reports.get_suite('rspec').add_test_case(create_test_case_rspec_success)
-          head_reports.get_suite('junit').add_test_case(create_test_case_java_resolved)
-        end
-
-        let(:create_test_case_java_resolved) do
-          create_test_case_java_failed.tap do |test_case|
-            test_case.instance_variable_set("@status", Gitlab::Ci::Reports::TestCase::STATUS_SUCCESS)
-          end
+          head_reports.get_suite('junit').add_test_case(create_test_case_java_success)
         end
 
         it 'contains correct compared test reports details' do
diff --git a/spec/serializers/test_reports_comparer_serializer_spec.rb b/spec/serializers/test_reports_comparer_serializer_spec.rb
index 9ea86c0dd83..62dc6f486c5 100644
--- a/spec/serializers/test_reports_comparer_serializer_spec.rb
+++ b/spec/serializers/test_reports_comparer_serializer_spec.rb
@@ -44,13 +44,7 @@ describe TestReportsComparerSerializer do
           base_reports.get_suite('rspec').add_test_case(create_test_case_rspec_success)
           base_reports.get_suite('junit').add_test_case(create_test_case_java_failed)
           head_reports.get_suite('rspec').add_test_case(create_test_case_rspec_success)
-          head_reports.get_suite('junit').add_test_case(create_test_case_java_resolved)
-        end
-
-        let(:create_test_case_java_resolved) do
-          create_test_case_java_failed.tap do |test_case|
-            test_case.instance_variable_set("@status", Gitlab::Ci::Reports::TestCase::STATUS_SUCCESS)
-          end
+          head_reports.get_suite('junit').add_test_case(create_test_case_java_success)
         end
 
         it 'matches the schema' do
diff --git a/spec/serializers/test_suite_comparer_entity_spec.rb b/spec/serializers/test_suite_comparer_entity_spec.rb
index f61331f53a0..4b2cca2c68c 100644
--- a/spec/serializers/test_suite_comparer_entity_spec.rb
+++ b/spec/serializers/test_suite_comparer_entity_spec.rb
@@ -11,16 +11,10 @@ describe TestSuiteComparerEntity do
   let(:test_case_success) { create_test_case_rspec_success }
   let(:test_case_failed) { create_test_case_rspec_failed }
 
-  let(:test_case_resolved) do
-    create_test_case_rspec_failed.tap do |test_case|
-      test_case.instance_variable_set("@status", Gitlab::Ci::Reports::TestCase::STATUS_SUCCESS)
-    end
-  end
-
   describe '#as_json' do
     subject { entity.as_json }
 
-    context 'when head sutie has a newly failed test case which does not exist in base' do
+    context 'when head suite has a newly failed test case which does not exist in base' do
       before do
         base_suite.add_test_case(test_case_success)
         head_suite.add_test_case(test_case_failed)
@@ -41,7 +35,7 @@ describe TestSuiteComparerEntity do
       end
     end
 
-    context 'when head sutie still has a failed test case which failed in base' do
+    context 'when head suite still has a failed test case which failed in base' do
       before do
         base_suite.add_test_case(test_case_failed)
         head_suite.add_test_case(test_case_failed)
@@ -62,10 +56,10 @@ describe TestSuiteComparerEntity do
       end
     end
 
-    context 'when head sutie has a success test case which failed in base' do
+    context 'when head suite has a success test case which failed in base' do
       before do
         base_suite.add_test_case(test_case_failed)
-        head_suite.add_test_case(test_case_resolved)
+        head_suite.add_test_case(test_case_success)
       end
 
       it 'contains correct compared test suite details' do
@@ -74,13 +68,83 @@ describe TestSuiteComparerEntity do
         expect(subject[:summary]).to include(total: 1, resolved: 1, failed: 0)
         expect(subject[:new_failures]).to be_empty
         subject[:resolved_failures].first.tap do |resolved_failure|
-          expect(resolved_failure[:status]).to eq(test_case_resolved.status)
-          expect(resolved_failure[:name]).to eq(test_case_resolved.name)
-          expect(resolved_failure[:execution_time]).to eq(test_case_resolved.execution_time)
-          expect(resolved_failure[:system_output]).to eq(test_case_resolved.system_output)
+          expect(resolved_failure[:status]).to eq(test_case_success.status)
+          expect(resolved_failure[:name]).to eq(test_case_success.name)
+          expect(resolved_failure[:execution_time]).to eq(test_case_success.execution_time)
+          expect(resolved_failure[:system_output]).to eq(test_case_success.system_output)
         end
         expect(subject[:existing_failures]).to be_empty
       end
     end
+
+    context 'limits amount of tests returned' do
+      before do
+        stub_const('TestSuiteComparerEntity::DEFAULT_MAX_TESTS', 2)
+        stub_const('TestSuiteComparerEntity::DEFAULT_MIN_TESTS', 1)
+      end
+
+      context 'prefers new over existing and resolved' do
+        before do
+          3.times { add_new_failure }
+          3.times { add_existing_failure }
+          3.times { add_resolved_failure }
+        end
+
+        it 'returns 2 new failures, and 1 of resolved and existing' do
+          expect(subject[:summary]).to include(total: 9, resolved: 3, failed: 6)
+          expect(subject[:new_failures].count).to eq(2)
+          expect(subject[:existing_failures].count).to eq(1)
+          expect(subject[:resolved_failures].count).to eq(1)
+        end
+      end
+
+      context 'prefers existing over resolved' do
+        before do
+          3.times { add_existing_failure }
+          3.times { add_resolved_failure }
+        end
+
+        it 'returns 2 existing failures, and 1 resolved' do
+          expect(subject[:summary]).to include(total: 6, resolved: 3, failed: 3)
+          expect(subject[:new_failures].count).to eq(0)
+          expect(subject[:existing_failures].count).to eq(2)
+          expect(subject[:resolved_failures].count).to eq(1)
+        end
+      end
+
+      context 'limits amount of resolved' do
+        before do
+          3.times { add_resolved_failure }
+        end
+
+        it 'returns 2 resolved failures' do
+          expect(subject[:summary]).to include(total: 3, resolved: 3, failed: 0)
+          expect(subject[:new_failures].count).to eq(0)
+          expect(subject[:existing_failures].count).to eq(0)
+          expect(subject[:resolved_failures].count).to eq(2)
+        end
+      end
+
+      private
+
+      def add_new_failure
+        failed_case = create_test_case_rspec_failed(SecureRandom.hex)
+        head_suite.add_test_case(failed_case)
+      end
+
+      def add_existing_failure
+        failed_case = create_test_case_rspec_failed(SecureRandom.hex)
+        base_suite.add_test_case(failed_case)
+        head_suite.add_test_case(failed_case)
+      end
+
+      def add_resolved_failure
+        case_name = SecureRandom.hex
+        failed_case = create_test_case_rspec_failed(case_name)
+        success_case = create_test_case_rspec_success(case_name)
+        base_suite.add_test_case(failed_case)
+        head_suite.add_test_case(success_case)
+      end
+    end
   end
 end
diff --git a/spec/support/test_reports/test_reports_helper.rb b/spec/support/test_reports/test_reports_helper.rb
index 45c6e04dbf3..6840fb9a860 100644
--- a/spec/support/test_reports/test_reports_helper.rb
+++ b/spec/support/test_reports/test_reports_helper.rb
@@ -1,36 +1,36 @@
 module TestReportsHelper
-  def create_test_case_rspec_success
+  def create_test_case_rspec_success(name = 'test_spec')
     Gitlab::Ci::Reports::TestCase.new(
       name: 'Test#sum when a is 1 and b is 3 returns summary',
-      classname: 'spec.test_spec',
+      classname: "spec.#{name}",
       file: './spec/test_spec.rb',
       execution_time: 1.11,
       status: Gitlab::Ci::Reports::TestCase::STATUS_SUCCESS)
   end
 
-  def create_test_case_rspec_failed
+  def create_test_case_rspec_failed(name = 'test_spec')
     Gitlab::Ci::Reports::TestCase.new(
-      name: 'Test#sum when a is 2 and b is 2 returns summary',
-      classname: 'spec.test_spec',
+      name: 'Test#sum when a is 1 and b is 3 returns summary',
+      classname: "spec.#{name}",
       file: './spec/test_spec.rb',
       execution_time: 2.22,
       system_output: sample_rspec_failed_message,
       status: Gitlab::Ci::Reports::TestCase::STATUS_FAILED)
   end
 
-  def create_test_case_rspec_skipped
+  def create_test_case_rspec_skipped(name = 'test_spec')
     Gitlab::Ci::Reports::TestCase.new(
       name: 'Test#sum when a is 3 and b is 3 returns summary',
-      classname: 'spec.test_spec',
+      classname: "spec.#{name}",
       file: './spec/test_spec.rb',
       execution_time: 3.33,
       status: Gitlab::Ci::Reports::TestCase::STATUS_SKIPPED)
   end
 
-  def create_test_case_rspec_error
+  def create_test_case_rspec_error(name = 'test_spec')
     Gitlab::Ci::Reports::TestCase.new(
       name: 'Test#sum when a is 4 and b is 4 returns summary',
-      classname: 'spec.test_spec',
+      classname: "spec.#{name}",
       file: './spec/test_spec.rb',
       execution_time: 4.44,
       status: Gitlab::Ci::Reports::TestCase::STATUS_ERROR)
@@ -48,34 +48,34 @@ module TestReportsHelper
     EOF
   end
 
-  def create_test_case_java_success
+  def create_test_case_java_success(name = 'addTest')
     Gitlab::Ci::Reports::TestCase.new(
-      name: 'addTest',
+      name: name,
       classname: 'CalculatorTest',
       execution_time: 5.55,
       status: Gitlab::Ci::Reports::TestCase::STATUS_SUCCESS)
   end
 
-  def create_test_case_java_failed
+  def create_test_case_java_failed(name = 'addTest')
     Gitlab::Ci::Reports::TestCase.new(
-      name: 'subtractTest',
+      name: name,
       classname: 'CalculatorTest',
       execution_time: 6.66,
       system_output: sample_java_failed_message,
       status: Gitlab::Ci::Reports::TestCase::STATUS_FAILED)
   end
 
-  def create_test_case_java_skipped
+  def create_test_case_java_skipped(name = 'addTest')
     Gitlab::Ci::Reports::TestCase.new(
-      name: 'multiplyTest',
+      name: name,
       classname: 'CalculatorTest',
       execution_time: 7.77,
       status: Gitlab::Ci::Reports::TestCase::STATUS_SKIPPED)
   end
 
-  def create_test_case_java_error
+  def create_test_case_java_error(name = 'addTest')
     Gitlab::Ci::Reports::TestCase.new(
-      name: 'divideTest',
+      name: name,
       classname: 'CalculatorTest',
       execution_time: 8.88,
       status: Gitlab::Ci::Reports::TestCase::STATUS_ERROR)

From b7ebf1b531ee75658f1ccb37019304b2edb051c5 Mon Sep 17 00:00:00 2001
From: Mark Lapierre <mlapierre@gitlab.com>
Date: Wed, 3 Jul 2019 05:01:57 +0000
Subject: [PATCH 032/195] Update docs environment:action:stop GIT_STRATEGY

Notes that `GIT_STRATEGY` should be set to `none` so that the
job doesn't fail when triggered automatically when the branch
is deleted.
---
 doc/ci/yaml/README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/ci/yaml/README.md b/doc/ci/yaml/README.md
index 2759f1c5160..3e564e4244c 100644
--- a/doc/ci/yaml/README.md
+++ b/doc/ci/yaml/README.md
@@ -973,6 +973,8 @@ review_app:
 
 stop_review_app:
   stage: deploy
+  variables:
+    GIT_STRATEGY: none  
   script: make delete-app
   when: manual
   environment:
@@ -987,6 +989,10 @@ Once the `review_app` job is successfully finished, it will trigger the
 set it up to `manual` so it will need a [manual action](#whenmanual) via
 GitLab's web interface in order to run.
 
+Also in the example, `GIT_STRATEGY` is set to `none` so that GitLab Runner won’t
+try to check out the code after the branch is deleted when the `stop_review_app`
+job is [automatically triggered](../environments.md#automatically-stopping-an-environment).
+
 The `stop_review_app` job is **required** to have the following keywords defined:
 
 - `when` - [reference](#when)

From 2db7c5762b41acbcbd71bc4bd5a8aa3d90e1a383 Mon Sep 17 00:00:00 2001
From: Stan Hu <stanhu@gmail.com>
Date: Tue, 2 Jul 2019 11:19:30 -0700
Subject: [PATCH 033/195] Cache Flipper feature flags in L1 and L2 caches

In https://gitlab.com/gitlab-com/gl-infra/production/issues/928, we saw
a significant amount of network traffic and CPU usage due to Redis
checking feature flags via Flipper. Since these flags are hit with every
request, the overhead becomes significant. To alleviate Redis overhead,
we now cache the data in the following way:

* L1: A thread-local memory store for 1 minute
* L2: Redis for 1 hour
---
 .../sh-cache-flipper-checks-in-memory.yml     |  5 ++
 lib/feature.rb                                | 23 ++++++-
 spec/lib/feature_spec.rb                      | 62 +++++++++++++++++++
 3 files changed, 87 insertions(+), 3 deletions(-)
 create mode 100644 changelogs/unreleased/sh-cache-flipper-checks-in-memory.yml

diff --git a/changelogs/unreleased/sh-cache-flipper-checks-in-memory.yml b/changelogs/unreleased/sh-cache-flipper-checks-in-memory.yml
new file mode 100644
index 00000000000..125b6244d80
--- /dev/null
+++ b/changelogs/unreleased/sh-cache-flipper-checks-in-memory.yml
@@ -0,0 +1,5 @@
+---
+title: Cache Flipper feature flags in L1 and L2 caches
+merge_request: 30276
+author:
+type: performance
diff --git a/lib/feature.rb b/lib/feature.rb
index 22420e95ea2..e28333aa58e 100644
--- a/lib/feature.rb
+++ b/lib/feature.rb
@@ -103,10 +103,27 @@ class Feature
         feature_class: FlipperFeature,
         gate_class: FlipperGate)
 
+      # Redis L2 cache
+      redis_cache_adapter =
+        Flipper::Adapters::ActiveSupportCacheStore.new(
+          active_record_adapter,
+          l2_cache_backend,
+          expires_in: 1.hour)
+
+      # Thread-local L1 cache: use a short timeout since we don't have a
+      # way to expire this cache all at once
       Flipper::Adapters::ActiveSupportCacheStore.new(
-        active_record_adapter,
-        Rails.cache,
-        expires_in: 1.hour)
+        redis_cache_adapter,
+        l1_cache_backend,
+        expires_in: 1.minute)
+    end
+
+    def l1_cache_backend
+      Gitlab::ThreadMemoryCache.cache_backend
+    end
+
+    def l2_cache_backend
+      Rails.cache
     end
   end
 
diff --git a/spec/lib/feature_spec.rb b/spec/lib/feature_spec.rb
index 403e0785d1b..127463a57e8 100644
--- a/spec/lib/feature_spec.rb
+++ b/spec/lib/feature_spec.rb
@@ -144,6 +144,68 @@ describe Feature do
       expect(described_class.enabled?(:enabled_feature_flag)).to be_truthy
     end
 
+    it { expect(described_class.l1_cache_backend).to eq(Gitlab::ThreadMemoryCache.cache_backend) }
+    it { expect(described_class.l2_cache_backend).to eq(Rails.cache) }
+
+    it 'caches the status in L1 and L2 caches',
+       :request_store, :use_clean_rails_memory_store_caching do
+      described_class.enable(:enabled_feature_flag)
+      flipper_key = "flipper/v1/feature/enabled_feature_flag"
+
+      expect(described_class.l2_cache_backend)
+        .to receive(:fetch)
+        .once
+        .with(flipper_key, expires_in: 1.hour)
+        .and_call_original
+
+      expect(described_class.l1_cache_backend)
+        .to receive(:fetch)
+        .once
+        .with(flipper_key, expires_in: 1.minute)
+        .and_call_original
+
+      2.times do
+        expect(described_class.enabled?(:enabled_feature_flag)).to be_truthy
+      end
+    end
+
+    context 'cached feature flag', :request_store do
+      let(:flag) { :some_feature_flag }
+
+      before do
+        described_class.flipper.memoize = false
+        described_class.enabled?(flag)
+      end
+
+      it 'caches the status in L1 cache for the first minute' do
+        expect do
+          expect(described_class.l1_cache_backend).to receive(:fetch).once.and_call_original
+          expect(described_class.l2_cache_backend).not_to receive(:fetch)
+          expect(described_class.enabled?(flag)).to be_truthy
+        end.not_to exceed_query_limit(0)
+      end
+
+      it 'caches the status in L2 cache after 2 minutes' do
+        Timecop.travel 2.minutes do
+          expect do
+            expect(described_class.l1_cache_backend).to receive(:fetch).once.and_call_original
+            expect(described_class.l2_cache_backend).to receive(:fetch).once.and_call_original
+            expect(described_class.enabled?(flag)).to be_truthy
+          end.not_to exceed_query_limit(0)
+        end
+      end
+
+      it 'fetches the status after an hour' do
+        Timecop.travel 61.minutes do
+          expect do
+            expect(described_class.l1_cache_backend).to receive(:fetch).once.and_call_original
+            expect(described_class.l2_cache_backend).to receive(:fetch).once.and_call_original
+            expect(described_class.enabled?(flag)).to be_truthy
+          end.not_to exceed_query_limit(1)
+        end
+      end
+    end
+
     context 'with an individual actor' do
       CustomActor = Struct.new(:flipper_id)
 

From 4efc8574cb45369797cf902d4e9676506a6e4cf7 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <ravlen@gmail.com>
Date: Thu, 4 Jul 2019 00:55:35 +0000
Subject: [PATCH 034/195] Fix notes and update links to issues doc

After review, heading was changed and links to
it needed to be updated, and minor tweaks to
the issues docs such as note formatting
---
 doc/README.md                                 |   2 +-
 doc/administration/incoming_email.md          |   2 +-
 doc/administration/index.md                   |   2 +-
 doc/administration/issue_closing_pattern.md   |   4 +-
 doc/customization/issue_closing.md            |   4 +-
 .../contributing/merge_request_workflow.md    |   2 +-
 doc/gitlab-basics/README.md                   |   2 +-
 doc/gitlab-basics/create-issue.md             |   4 +-
 doc/intro/README.md                           |   4 +-
 doc/user/project/cycle_analytics.md           |   2 +-
 .../project/issues/automatic_issue_closing.md |  64 +-----
 doc/user/project/issues/closing_issues.md     |  62 +-----
 doc/user/project/issues/create_new_issue.md   | 107 +--------
 .../project/issues/crosslinking_issues.md     |  23 +-
 doc/user/project/issues/csv_import.md         |  29 +--
 doc/user/project/issues/deleting_issues.md    |  16 +-
 doc/user/project/issues/due_dates.md          |  33 +--
 doc/user/project/issues/index.md              |  97 ++++++---
 .../project/issues/issue_data_and_actions.md  |   2 +-
 doc/user/project/issues/managing_issues.md    | 204 ++++++++++++++++++
 doc/user/project/issues/moving_issues.md      |  38 +---
 doc/user/project/issues/similar_issues.md     |  19 +-
 doc/user/project/merge_requests/index.md      |   2 +-
 doc/user/project/repository/branches/index.md |   2 +-
 doc/user/project/repository/web_editor.md     |   3 +-
 doc/workflow/README.md                        |   2 +-
 26 files changed, 352 insertions(+), 379 deletions(-)
 create mode 100644 doc/user/project/issues/managing_issues.md

diff --git a/doc/README.md b/doc/README.md
index 489c8117b9d..5eaa998a7b8 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -111,7 +111,7 @@ The following documentation relates to the DevOps **Plan** stage:
 | [Discussions](user/discussions/index.md)                                                                                                                                                                                                                           | Threads, comments, and resolvable discussions in issues, commits, and  merge requests.                                                           |
 | [Due Dates](user/project/issues/due_dates.md)                                                                                                                                                                                                                      | Keep track of issue deadlines.                                                                                                                   |
 | [Epics](user/group/epics/index.md) **[ULTIMATE]**                                                                                                                                                                                                                  | Tracking groups of issues that share a theme.                                                                                                    |
-| [Issues](user/project/issues/index.md), including [confidential issues](user/project/issues/confidential_issues.md),<br/>[issue and merge request templates](user/project/description_templates.md),<br/>and [moving issues](user/project/issues/moving_issues.md) | Project issues, restricting access to issues, create templates for submitting new issues and merge requests, and moving issues between projects. |
+| [Issues](user/project/issues/index.md), including [confidential issues](user/project/issues/confidential_issues.md),<br/>[issue and merge request templates](user/project/description_templates.md),<br/>and [moving issues](user/project/issues/managing_issues.md#moving-issues) | Project issues, restricting access to issues, create templates for submitting new issues and merge requests, and moving issues between projects. |
 | [Labels](user/project/labels.md)                                                                                                                                                                                                                                   | Categorize issues or merge requests with descriptive labels.                                                                                     |
 | [Milestones](user/project/milestones/index.md)                                                                                                                                                                                                                     | Set milestones for delivery of issues and merge requests, with optional due date.                                                                |
 | [Project Issue Board](user/project/issue_board.md)                                                                                                                                                                                                                 | Display issues on a Scrum or Kanban board.                                                                                                       |
diff --git a/doc/administration/incoming_email.md b/doc/administration/incoming_email.md
index 8271c579f5b..84a34ae7d6e 100644
--- a/doc/administration/incoming_email.md
+++ b/doc/administration/incoming_email.md
@@ -4,7 +4,7 @@ GitLab has several features based on receiving incoming emails:
 
 - [Reply by Email](reply_by_email.md): allow GitLab users to comment on issues
   and merge requests by replying to notification emails.
-- [New issue by email](../user/project/issues/create_new_issue.md#new-issue-via-email):
+- [New issue by email](../user/project/issues/managing_issues.md#new-issue-via-email):
   allow GitLab users to create a new issue by sending an email to a
   user-specific email address.
 - [New merge request by email](../user/project/merge_requests/index.md#create-new-merge-requests-by-email):
diff --git a/doc/administration/index.md b/doc/administration/index.md
index 602eecb9746..f480d18ea00 100644
--- a/doc/administration/index.md
+++ b/doc/administration/index.md
@@ -117,7 +117,7 @@ Learn how to install, configure, update, and maintain your GitLab instance.
   - Instances. **[PREMIUM ONLY]**
 - [Auditor users](auditor_users.md): Users with read-only access to all projects, groups, and other resources on the GitLab instance. **[PREMIUM ONLY]**
 - [Incoming email](incoming_email.md): Configure incoming emails to allow
-  users to [reply by email](reply_by_email.md), create [issues by email](../user/project/issues/create_new_issue.md#new-issue-via-email) and
+  users to [reply by email](reply_by_email.md), create [issues by email](../user/project/issues/managing_issues.md#new-issue-via-email) and
   [merge requests by email](../user/project/merge_requests/index.md#create-new-merge-requests-by-email), and to enable [Service Desk](../user/project/service_desk.md).
   - [Postfix for incoming email](reply_by_email_postfix_setup.md): Set up a
   basic Postfix mail server with IMAP authentication on Ubuntu for incoming
diff --git a/doc/administration/issue_closing_pattern.md b/doc/administration/issue_closing_pattern.md
index 160da47c780..9c352096ecc 100644
--- a/doc/administration/issue_closing_pattern.md
+++ b/doc/administration/issue_closing_pattern.md
@@ -1,4 +1,4 @@
-# Issue closing pattern
+# Issue closing pattern **[CORE ONLY]**
 
 >**Note:**
 This is the administration documentation.
@@ -46,4 +46,4 @@ Because Rubular doesn't understand `%{issue_ref}`, you can replace this by
 [gitlab.yml.example]: https://gitlab.com/gitlab-org/gitlab-ce/blob/master/config/gitlab.yml.example
 [reconfigure]: restart_gitlab.md#omnibus-gitlab-reconfigure
 [restart]: restart_gitlab.md#installations-from-source
-[user documentation]: ../user/project/issues/automatic_issue_closing.md
+[user documentation]: ../user/project/issues/managing_issues.md#closing-issues-automatically
diff --git a/doc/customization/issue_closing.md b/doc/customization/issue_closing.md
index 680c51e7524..9333f55ca9c 100644
--- a/doc/customization/issue_closing.md
+++ b/doc/customization/issue_closing.md
@@ -1,3 +1,5 @@
 ---
-redirect_to: '../user/project/issues/automatic_issue_closing.md'
+redirect_to: '../user/project/issues/managing_issues.md#closing-issues-automatically'
 ---
+
+This document was moved to [another location](../user/project/issues/managing_issues.md#closing-issues-automatically).
diff --git a/doc/development/contributing/merge_request_workflow.md b/doc/development/contributing/merge_request_workflow.md
index 6064f59ed10..ce5d9786e6e 100644
--- a/doc/development/contributing/merge_request_workflow.md
+++ b/doc/development/contributing/merge_request_workflow.md
@@ -65,7 +65,7 @@ request is as follows:
    1. If you are contributing documentation, choose `Documentation` from the
       "Choose a template" menu and fill in the description according to the template.
    1. Mention the issue(s) your merge request solves, using the `Solves #XXX` or
-      `Closes #XXX` syntax to [auto-close](../../user/project/issues/automatic_issue_closing.md)
+      `Closes #XXX` syntax to [auto-close](../../user/project/issues/managing_issues.md#closing-issues-automatically)
       the issue(s) once the merge request is merged.
 1. If you're allowed to (Core team members, for example), set a relevant milestone
    and [labels](issue_workflow.md).
diff --git a/doc/gitlab-basics/README.md b/doc/gitlab-basics/README.md
index 0c268eff9f1..fd16047b8e4 100644
--- a/doc/gitlab-basics/README.md
+++ b/doc/gitlab-basics/README.md
@@ -22,7 +22,7 @@ The following are guides to basic GitLab functionality:
 - [Fork a project](fork-project.md), to duplicate projects so they can be worked on in parallel.
 - [Add a file](add-file.md), to add new files to a project's repository.
 - [Add an image](add-image.md), to add new images to a project's repository.
-- [Create an issue](../user/project/issues/create_new_issue.md), to start collaborating within a project.
+- [Create an issue](../user/project/issues/managing_issues.md#create-a-new-issue), to start collaborating within a project.
 - [Create a merge request](add-merge-request.md), to request changes made in a branch be merged into a project's repository.
 - See how these features come together in the [GitLab Flow introduction video](https://youtu.be/InKNIvky2KE) and [GitLab Flow page](../workflow/gitlab_flow.md).
 
diff --git a/doc/gitlab-basics/create-issue.md b/doc/gitlab-basics/create-issue.md
index 6e2a09fc030..5fa5f1bf2e2 100644
--- a/doc/gitlab-basics/create-issue.md
+++ b/doc/gitlab-basics/create-issue.md
@@ -1,5 +1,5 @@
 ---
-redirect_to: '../user/project/issues/index.md#issue-actions'
+redirect_to: '../user/project/issues/index.md#viewing-and-managing-issues'
 ---
 
-This document was moved to [another location](../user/project/issues/index.md#issue-actions).
+This document was moved to [another location](../user/project/issues/index.md#viewing-and-managing-issues).
diff --git a/doc/intro/README.md b/doc/intro/README.md
index d9c733d4285..9a8cd925e48 100644
--- a/doc/intro/README.md
+++ b/doc/intro/README.md
@@ -15,7 +15,7 @@ Create projects and groups.
 
 Create issues, labels, milestones, cast your vote, and review issues.
 
-- [Create an issue](../user/project/issues/create_new_issue.md)
+- [Create an issue](../user/project/issues/managing_issues.md#create-a-new-issue)
 - [Assign labels to issues](../user/project/labels.md)
 - [Use milestones as an overview of your project's tracker](../user/project/milestones/index.md)
 - [Use voting to express your like/dislike to issues and merge requests](../workflow/award_emoji.md)
@@ -26,7 +26,7 @@ Create merge requests and review code.
 
 - [Fork a project and contribute to it](../workflow/forking_workflow.md)
 - [Create a new merge request](../gitlab-basics/add-merge-request.md)
-- [Automatically close issues from merge requests](../user/project/issues/automatic_issue_closing.md)
+- [Automatically close issues from merge requests](../user/project/issues/managing_issues.md#closing-issues-automatically)
 - [Automatically merge when pipeline succeeds](../user/project/merge_requests/merge_when_pipeline_succeeds.md)
 - [Revert any commit](../user/project/merge_requests/revert_changes.md)
 - [Cherry-pick any commit](../user/project/merge_requests/cherry_pick_changes.md)
diff --git a/doc/user/project/cycle_analytics.md b/doc/user/project/cycle_analytics.md
index dc97a44fd68..5d36e1d4be3 100644
--- a/doc/user/project/cycle_analytics.md
+++ b/doc/user/project/cycle_analytics.md
@@ -156,6 +156,6 @@ Learn more about Cycle Analytics in the following resources:
 [environment]: ../../ci/yaml/README.md#environment
 [GitLab flow]: ../../workflow/gitlab_flow.md
 [idea to production]: https://about.gitlab.com/2016/08/05/continuous-integration-delivery-and-deployment-with-gitlab/#from-idea-to-production-with-gitlab
-[issue closing pattern]: issues/automatic_issue_closing.md
+[issue closing pattern]: issues/managing_issues.md#closing-issues-automatically
 [permissions]: ../permissions.md
 [yml]: ../../ci/yaml/README.md
diff --git a/doc/user/project/issues/automatic_issue_closing.md b/doc/user/project/issues/automatic_issue_closing.md
index c3e06b219ff..dab79327d6a 100644
--- a/doc/user/project/issues/automatic_issue_closing.md
+++ b/doc/user/project/issues/automatic_issue_closing.md
@@ -1,63 +1,5 @@
-# Automatic issue closing
-
->**Notes:**
->
-> - This is the user docs. In order to change the default issue closing pattern,
->   follow the steps in the [administration docs].
-> - For performance reasons, automatic issue closing is disabled for the very
->   first push from an existing repository.
-
-When a commit or merge request resolves one or more issues, it is possible to
-automatically have these issues closed when the commit or merge request lands
-in the project's default branch.
-
-If a commit message or merge request description contains a sentence matching
-a certain regular expression, all issues referenced from the matched text will
-be closed. This happens when the commit is pushed to a project's
-[**default** branch](../repository/branches/index.md#default-branch), or when a
-commit or merge request is merged into it.
-
-## Default closing pattern value
-
-When not specified, the default issue closing pattern as shown below will be
-used:
-
-```bash
-((?:[Cc]los(?:e[sd]?|ing)|[Ff]ix(?:e[sd]|ing)?|[Rr]esolv(?:e[sd]?|ing)|[Ii]mplement(?:s|ed|ing)?)(:?) +(?:(?:issues? +)?%{issue_ref}(?:(?:, *| +and +)?)|([A-Z][A-Z0-9_]+-\d+))+)
-```
-
-Note that `%{issue_ref}` is a complex regular expression defined inside GitLab's
-source code that can match references to:
-
-- A local issue (`#123`).
-- A cross-project issue (`group/project#123`).
-- A link to an issue
-  (`https://gitlab.example.com/group/project/issues/123`).
-
+---
+redirect_to: 'managing_issues.md#closing-issues-automatically'
 ---
 
-This translates to the following keywords:
-
-- Close, Closes, Closed, Closing, close, closes, closed, closing
-- Fix, Fixes, Fixed, Fixing, fix, fixes, fixed, fixing
-- Resolve, Resolves, Resolved, Resolving, resolve, resolves, resolved, resolving
-- Implement, Implements, Implemented, Implementing, implement, implements, implemented, implementing
-
----
-
-For example the following commit message:
-
-```
-Awesome commit message
-
-Fix #20, Fixes #21 and Closes group/otherproject#22.
-This commit is also related to #17 and fixes #18, #19
-and https://gitlab.example.com/group/otherproject/issues/23.
-```
-
-will close `#18`, `#19`, `#20`, and `#21` in the project this commit is pushed
-to, as well as `#22` and `#23` in group/otherproject. `#17` won't be closed as
-it does not match the pattern. It works with multi-line commit messages as well
-as one-liners when used with `git commit -m`.
-
-[administration docs]: ../../../administration/issue_closing_pattern.md
+This document was moved to [another location](managing_issues.md#closing-issues-automatically).
diff --git a/doc/user/project/issues/closing_issues.md b/doc/user/project/issues/closing_issues.md
index 1d88745af9f..04f1c8e1a4a 100644
--- a/doc/user/project/issues/closing_issues.md
+++ b/doc/user/project/issues/closing_issues.md
@@ -1,59 +1,5 @@
-# Closing Issues
+---
+redirect_to: 'managing_issues.md#closing-issues'
+---
 
-Please read through the [GitLab Issue Documentation](index.md) for an overview on GitLab Issues.
-
-## Directly
-
-Whenever you decide that's no longer need for that issue,
-close the issue using the close button:
-
-![close issue - button](img/button_close_issue.png)
-
-## Via Merge Request
-
-When a merge request resolves the discussion over an issue, you can
-make it close that issue(s) when merged.
-
-All you need is to use a [keyword](automatic_issue_closing.md)
-accompanying the issue number, add to the description of that MR.
-
-In this example, the keyword "closes" prefixing the issue number will create a relationship
-in such a way that the merge request will close the issue when merged. 
-
-Mentioning various issues in the same line also works for this purpose:
-
-```md
-Closes #333, #444, #555 and #666
-```
-
-If the issue is in a different repository rather then the MR's,
-add the full URL for that issue(s):
-
-```md
-Closes #333, #444, and https://gitlab.com/<username>/<projectname>/issues/<xxx>
-```
-
-All the following keywords will produce the same behaviour:
-
-- Close, Closes, Closed, Closing, close, closes, closed, closing
-- Fix, Fixes, Fixed, Fixing, fix, fixes, fixed, fixing
-- Resolve, Resolves, Resolved, Resolving, resolve, resolves, resolved, resolving
-
-![merge request closing issue when merged](img/merge_request_closes_issue.png)
-
-If you use any other word before the issue number, the issue and the MR will
-link to each other, but the MR will NOT close the issue(s) when merged.
-
-![mention issues in MRs - closing and related](img/closing_and_related_issues.png)
-
-## From the Issue Board
-
-You can close an issue from [Issue Boards](../issue_board.md) by dragging an issue card
-from its list and dropping into **Closed**.
-
-![close issue from the Issue Board](img/close_issue_from_board.gif)
-
-## Customizing the issue closing pattern
-
-Alternatively, a GitLab **administrator** can
-[customize the issue closing pattern](../../../administration/issue_closing_pattern.md).
+This document was moved to [another location](managing_issues.md#closing-issues).
diff --git a/doc/user/project/issues/create_new_issue.md b/doc/user/project/issues/create_new_issue.md
index c2916c79876..8eec29716c1 100644
--- a/doc/user/project/issues/create_new_issue.md
+++ b/doc/user/project/issues/create_new_issue.md
@@ -1,104 +1,5 @@
-# Create a new Issue
+---
+redirect_to: 'managing_issues.md#create-a-new-issue'
+---
 
-Please read through the [GitLab Issue Documentation](index.md) for an overview on GitLab Issues.
-
-When you create a new issue, you'll be prompted to fill in
-the information illustrated on the image below.
-
-![New issue from the issues list](img/new_issue.png)
-
-Read through the [issue data and actions documentation](issue_data_and_actions.md#parts-of-an-issue)
-to understand these fields one by one.
-
-## New issue from the Issue Tracker
-
-Navigate to your **Project's Dashboard** > **Issues** > **New Issue** to create a new issue:
-
-![New issue from the issue list view](img/new_issue_from_tracker_list.png)
-
-## New issue from an opened issue
-
-From an **opened issue** in your project, click **New Issue** to create a new
-issue in the same project:
-
-![New issue from an open issue](img/new_issue_from_open_issue.png)
-
-## New issue from the project's dashboard
-
-From your **Project's Dashboard**, click the plus sign (**+**) to open a dropdown
-menu with a few options. Select **New Issue** to create an issue in that project:
-
-![New issue from a project's dashboard](img/new_issue_from_projects_dashboard.png)
-
-## New issue from the Issue Board
-
-From an Issue Board, create a new issue by clicking on the plus sign (**+**) on the top of a list.
-It opens a new issue for that project labeled after its respective list.
-
-![From the issue board](img/new_issue_from_issue_board.png)
-
-## New issue via email
-
-At the bottom of a project's Issues List page, a link to **Email a new issue to this project**
-is displayed if your GitLab instance has [incoming email](../../../administration/incoming_email.md) configured.
-
-![Bottom of a project issues page](img/new_issue_from_email.png)
-
-When you click this link, an email address is displayed which belongs to you for creating issues in this project.
-You can save this address as a contact in your email client for easy acceess.
-
-CAUTION: **Caution:**
-This is a private email address, generated just for you. **Keep it to yourself**,
-as anyone who gets ahold of it can create issues or merge requests as if they
-were you. If the address is compromised, or you'd like it to be regenerated for
-any reason, click **Email a new issue to this project** again and click the reset link.
-
-Sending an email to this address will create a new issue on your behalf for
-this project, where:
-
-- The email subject becomes the issue title.
-- The email body becomes the issue description.
-- [Markdown](../../markdown.md) and [quick actions](../quick_actions.md) are supported.
-
-NOTE: **Note:**
-In GitLab 11.7, we updated the format of the generated email address.
-However the older format is still supported, allowing existing aliases
-or contacts to continue working._
-
-## New issue via Service Desk **[PREMIUM]**
-
-Enable [Service Desk](../service_desk.md) to your project and offer email support.
-By doing so, when your customer sends a new email, a new issue can be created in
-the appropriate project and followed up from there.
-
-## New issue from the group-level Issue Tracker
-
-Head to the Group dashboard and click "Issues" in the sidebar to visit the Issue Tracker
-for all projects in your Group. Select the project you'd like to add an issue for
-using the dropdown button at the top-right of the page.
-
-![Select project to create issue](img/select_project_from_group_level_issue_tracker.png)
-
-We'll keep track of the project you selected most recently, and use it as the default
-for your next visit. This should save you a lot of time and clicks, if you mostly
-create issues for the same project.
-
-![Create issue from group-level issue tracker](img/create_issue_from_group_level_issue_tracker.png)
-
-## New issue via URL with prefilled fields
-
-You can link directly to the new issue page for a given project, with prefilled
-field values using query string parameters in a URL. This is useful for embedding
-a URL in an external HTML page, and also certain scenarios where you want the user to
-create an issue with certain fields prefilled.
-
-The title, description, and description template fields can be prefilled using
-this method. The description and description template fields cannot be pre-entered
-in the same URL (since a description template just populates the description field).
-
-Follow these examples to form your new issue URL with prefilled fields.
-
-- For a new issue in the GitLab Community Edition project with a pre-entered title
-  and a pre-entered description, the URL would be `https://gitlab.com/gitlab-org/gitlab-ce/issues/new?issue[title]=Validate%20new%20concept&issue[description]=Research%20idea`
-- For a new issue in the GitLab Community Edition project with a pre-entered title
-  and a pre-entered description template, the URL would be `https://gitlab.com/gitlab-org/gitlab-ce/issues/new?issue[title]=Validate%20new%20concept&issuable_template=Research%20proposal`
+This document was moved to [another location](managing_issues.md#create-a-new-issue).
diff --git a/doc/user/project/issues/crosslinking_issues.md b/doc/user/project/issues/crosslinking_issues.md
index ff5b1f2ce50..93dc2a2e4ca 100644
--- a/doc/user/project/issues/crosslinking_issues.md
+++ b/doc/user/project/issues/crosslinking_issues.md
@@ -25,9 +25,8 @@ git commit -m "this is my commit message. Related to https://gitlab.com/<usernam
 
 Of course, you can replace `gitlab.com` with the URL of your own GitLab instance.
 
-**Note:** Linking your first commit to your issue is going to be relevant
-for tracking your process far ahead with
-[GitLab Cycle Analytics](https://about.gitlab.com/features/cycle-analytics/)).
+NOTE: **Note:** Linking your first commit to your issue is going to be relevant
+for tracking your process with [GitLab Cycle Analytics](https://about.gitlab.com/features/cycle-analytics/).
 It will measure the time taken for planning the implementation of that issue,
 which is the time between creating an issue and making the first commit.
 
@@ -35,14 +34,13 @@ which is the time between creating an issue and making the first commit.
 
 Mentioning related issues in merge requests and other issues is useful
 for your team members and collaborators to know that there are opened
-issues around that same idea.
+issues regarding the same topic.
 
-You do that as explained above, when
-[mentioning an issue from a commit message](#from-commit-messages).
+You do that as explained above, when [mentioning an issue from a commit message](#from-commit-messages).
 
-When mentioning the issue "A" in issue "B", the issue "A" will also
-display a notification in its tracker. The same is valid for mentioning
-issues in merge requests.
+When mentioning issue `#111` in issue `#222`, issue `#111` will also display a notification
+in its tracker. That is, you only need to mention the relationship once for it to
+display in both issues. The same is valid when mentioning issues in [merge requests](#from-merge-requests).
 
 ![issue mentioned in issue](img/mention_in_issue.png)
 
@@ -53,10 +51,7 @@ they do for [related issues](#from-related-issues).
 
 When you mention an issue in a merge request description, it will simply
 [link the issue and merge request together](#from-related-issues). Additionally,
-you can also [set an issue to close as soon as the merge request is merged](closing_issues.md#via-merge-request).
+you can also [set an issue to close automatically](managing_issues.md#closing-issues-automatically)
+as soon as the merge request is merged.
 
 ![issue mentioned in MR](img/mention_in_merge_request.png)
-
-### Close an issue by merging a merge request
-
-To [close an issue when a merge request is merged](closing_issues.md#via-merge-request), use the [automatic issue closing pattern](automatic_issue_closing.md).
diff --git a/doc/user/project/issues/csv_import.md b/doc/user/project/issues/csv_import.md
index b0b1cfcfdf7..e1e58e5ab24 100644
--- a/doc/user/project/issues/csv_import.md
+++ b/doc/user/project/issues/csv_import.md
@@ -7,7 +7,8 @@ Issues can be imported to a project by uploading a CSV file with the columns
 
 The user uploading the CSV file will be set as the author of the imported issues.
 
-> **Note:** A permission level of `Developer` or higher is required to import issues.
+NOTE: **Note:** A permission level of [Developer](../../permissions.md), or higher, is required
+to import issues.
 
 ## Prepare for the import
 
@@ -24,34 +25,38 @@ To import issues:
 1. Select the file and click the **Import issues** button.
 
 The file is processed in the background and a notification email is sent
-to you once the import is completed.
+to you once the import is complete.
 
 ## CSV file format
 
-### Header row
+Sample CSV file data: 
 
 CSV files must contain a header row where the first column header is `title` and the second is `description`.
 If additional columns are present, they will be ignored.
 
-### Column separator
+### Header row
 
-The column separator is automatically detected from the header row.
+CSV files must contain a header row beginning with at least two columns, `title` and
+`description`, in that order. If additional columns are present, they will be ignored.
 
-Supported separator characters are: commas (`,`), semicolons (`;`), and tabs (`\t`).
+### Separators
 
-### Row separator
+The column separator is automatically detected from the header row. Supported separator
+characters are: commas (`,`), semicolons (`;`), and tabs (`\t`).
 
-Lines ending in either `CRLF` or `LF` are supported.
+The row separator can be either `CRLF` or `LF`.
 
 ### Quote character
 
-The double-quote (`"`) character is used to quote fields so you can use the column separator within a field. To insert
-a double-quote (`"`) within a quoted field, use two double-quote characters in succession, i.e. `""`.
+The double-quote (`"`) character is used to quote fields, enabling the use of the column
+separator within a field (see the third line in the [sample CSV](#csv-file-format)).
+To insert a double-quote (`"`) within a quoted field, use two double-quote characters
+in succession, i.e. `""`.
 
 ### Data rows
 
-After the header row, succeeding rows must follow the same column order. The issue title is required while the
-description is optional.
+After the header row, succeeding rows must follow the same column order. The issue
+title is required while the description is optional.
 
 ### File size
 
diff --git a/doc/user/project/issues/deleting_issues.md b/doc/user/project/issues/deleting_issues.md
index 536a0de8974..e50259e0dcf 100644
--- a/doc/user/project/issues/deleting_issues.md
+++ b/doc/user/project/issues/deleting_issues.md
@@ -1,13 +1,5 @@
-# Deleting Issues
+---
+redirect_to: 'managing_issues.md#deleting-issues'
+---
 
-> [Introduced][ce-2982] in GitLab 8.6
-
-Please read through the [GitLab Issue Documentation](index.md) for an overview on GitLab Issues.
-
-You can delete an issue by editing it and clicking on the delete button. 
-
-![delete issue - button](img/delete_issue.png)
-
->**Note:** Only [project owners](../../permissions.md) can delete issues.
-
-[ce-2982]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/2982
\ No newline at end of file
+This document was moved to [another location](managing_issues.md#deleting-issues).
diff --git a/doc/user/project/issues/due_dates.md b/doc/user/project/issues/due_dates.md
index 987c16dfab6..be577b3f24c 100644
--- a/doc/user/project/issues/due_dates.md
+++ b/doc/user/project/issues/due_dates.md
@@ -4,30 +4,32 @@
 
 Please read through the [GitLab Issue Documentation](index.md) for an overview on GitLab Issues.
 
-Due dates can be used in issues to keep track of deadlines and make sure
-features are shipped on time. Due dates require at least [Reporter permissions](../../permissions.md#project-members-permissions)
-to be able to edit them. On the contrary, they can be seen by everybody.
+Due dates can be used in issues to keep track of deadlines and make sure features are
+shipped on time. Users must have at least [Reporter permissions](../../permissions.md)
+to be able to edit them, but they can be seen by everybody with permission to view
+the issue.
 
 ## Setting a due date
 
-When creating or editing an issue, you can see the due date field from where
-a calendar will appear to help you choose the date you want. To remove it,
-select the date text and delete it.
+When creating or editing an issue, you can click in the **due date** field and a calendar
+will appear to help you choose the date you want. To remove the date, select the date
+text and delete it. The date is related to the server's timezone, not the timezone of
+the user setting the due date.
 
 ![Create a due date](img/due_dates_create.png)
 
-A quicker way to set a due date is via the issue sidebar. Simply expand the
-sidebar and select **Edit** to pick a due date or remove the existing one.
+You can also set a due date via the issue sidebar. Expand the
+sidebar and click **Edit** to pick a due date or remove the existing one.
 Changes are saved immediately.
 
 ![Edit a due date via the sidebar](img/due_dates_edit_sidebar.png)
 
 ## Making use of due dates
 
-Issues that have a due date can be distinctively seen in the issue tracker
+Issues that have a due date can be easily seen in the issue tracker,
 displaying a date next to them. Issues where the date is overdue will have
 the icon and the date colored red. You can sort issues by those that are
-_Due soon_ or _Due later_ from the dropdown menu in the right.
+`Due soon` or `Due later` from the dropdown menu on the right.
 
 ![Issues with due dates in the issues index page](img/due_dates_issues_index_page.png)
 
@@ -36,14 +38,13 @@ Due dates also appear in your [todos list](../../../workflow/todos.md).
 ![Issues with due dates in the todos](img/due_dates_todos.png)
 
 The day before an open issue is due, an email will be sent to all participants
-of the issue. Both the due date and the day before are calculated using the
-server's timezone.
+of the issue. Like the due date, the "day before the due date" is determined by the
+server's timezone, ignoring the participants' timezones.
 
 Issues with due dates can also be exported as an iCalendar feed. The URL of the
-feed can be added to calendar applications. The feed is accessible by clicking
-on the _Subscribe to calendar_ button on the following pages:
+feed can be added to many calendar applications. The feed is accessible by clicking
+on the **Subscribe to calendar** button on the following pages:
 
-- on the **Assigned Issues** page that is linked on the right-hand side of the
-  GitLab header
+- on the **Assigned Issues** page that is linked on the right-hand side of the GitLab header
 - on the **Project Issues** page
 - on the **Group Issues** page
diff --git a/doc/user/project/issues/index.md b/doc/user/project/issues/index.md
index 4acbb4cc3f6..86c2f2f3959 100644
--- a/doc/user/project/issues/index.md
+++ b/doc/user/project/issues/index.md
@@ -6,8 +6,9 @@ Issues are the fundamental medium for collaborating on ideas and planning work i
 
 The GitLab issue tracker is an advanced tool for collaboratively developing ideas, solving problems, and planning work.
 
-Issues can allow you, your team, and your collaborators to share and discuss proposals before and during their implementation.
-However, they can be used for a variety of other purposes, customized to your needs and workflow.
+Issues can allow you, your team, and your collaborators to share and discuss proposals
+before, and during, their implementation. However, they can be used for a variety of
+other purposes, customized to your needs and workflow.
 
 Issues are always associated with a specific project, but if you have multiple projects in a group,
 you can also view all the issues collectively at the group level.
@@ -17,13 +18,15 @@ you can also view all the issues collectively at the group level.
 - Discussing the implementation of a new idea
 - Tracking tasks and work status
 - Accepting feature proposals, questions, support requests, or bug reports
-- Elaborating new code implementations
+- Elaborating on new code implementations
 
-See also the blog post "[Always start a discussion with an issue](https://about.gitlab.com/2016/03/03/start-with-an-issue/)".
+See also [Always start a discussion with an issue](https://about.gitlab.com/2016/03/03/start-with-an-issue/).
 
 ## Parts of an issue
 
-Issues contain a variety of content and metadata, enabling a large range of flexibility in how they are used. Each issue can contain the following attributes, though some items may remain unset.
+Issues contain a variety of content and metadata, enabling a large range of flexibility
+in how they are used. Each issue can contain the following attributes, though not all items
+must be set.
 
 <table class="borderless-table fixed-table">
 <tr>
@@ -70,23 +73,36 @@ Issues contain a variety of content and metadata, enabling a large range of flex
 
 ## Viewing and managing issues
 
-While you can view and manage the full detail of an issue at its URL, you can also work with multiple issues at a time using the Issues List, Issue Boards, Epics **[ULTIMATE]**, and issue references.
+While you can view and manage the full details of an issue on the [issue page](#issue-page),
+you can also work with multiple issues at a time using the [Issues List](#issues-list),
+[Issue Boards](#issue-boards), Issue references, and [Epics](#epics-ultimate)**[ULTIMATE]**.
+
+Key actions for Issues include:
+
+- [Creating issues](managing_issues.md#create-a-new-issue)
+- [Moving issues](managing_issues.md#moving-issues)
+- [Closing issues](managing_issues.md#closing-issues)
+- [Deleting issues](managing_issues.md#deleting-issues)
 
 ### Issue page
 
 ![Issue view](img/issues_main_view.png)
 
-On an issue’s page, you can view all aspects of the issue, and you can also modify them if you you have the necessary [permissions](../../permissions.md).
-
-For more information, see the [Issue Data and Actions](issue_data_and_actions.md) page.
+On an issue's page, you can view [all aspects of the issue](issue_data_and_actions.md),
+and modify them if you you have the necessary [permissions](../../permissions.md).
 
 ### Issues list
 
 ![Project issues list view](img/project_issues_list_view.png)
 
-On the Issues List, you can view all issues in the current project, or from multiple projects when opening the Issues List from the higher-level group context. Filter the issue list by [any search query](../../search/index.md#issues-and-merge-requests-per-project) and/or specific metadata, such as label(s), assignees(s), status, and more. From this view, you can also make certain changes [in bulk](../bulk_editing.md) to the displayed issues.
+On the Issues List, you can view all issues in the current project, or from multiple
+projects when opening the Issues List from the higher-level group context. Filter the
+issue list with a [search query](../../search/index.md#issues-and-merge-requests-per-project),
+including specific metadata, such as label(s), assignees(s), status, and more. From this
+view, you can also make certain changes [in bulk](../bulk_editing.md) to the displayed issues.
 
-For more information on interacting with Issues, see the [Issue Data and Actions](issue_data_and_actions.md) page.
+For more information, see the [Issue Data and Actions](issue_data_and_actions.md) page
+for a rundown of all the fields and information in an issue.
 
 For sorting by issue priority, see [Label Priority](../labels.md#label-priority).
 
@@ -94,44 +110,55 @@ For sorting by issue priority, see [Label Priority](../labels.md#label-priority)
 
 ![Issue board](img/issue_board.png)
 
-Issue boards are Kanban boards with columns that display issues based on their labels or their assignees**[PREMIUM]**. They offer the flexibility to manage issues using highly customizable workflows.
+[Issue boards](../issue_board.md) are Kanban boards with columns that display issues based on their labels
+or their assignees**[PREMIUM]**. They offer the flexibility to manage issues using
+highly customizable workflows.
 
-You can reorder issues within a column, or drag an issue card to another column; its associated label or assignee will change to match that of the new column. The entire board can also be filtered to only include issues from a certain milestone or an overarching label.
-
-For more information, see the [Issue Boards](../issue_board.md) page.
+You can reorder issues within a column. If you drag an issue card to another column, its
+associated label or assignee will change to match that of the new column. The entire
+board can also be filtered to only include issues from a certain milestone or an overarching
+label.
 
 ### Epics **[ULTIMATE]**
 
-Epics let you manage your portfolio of projects more efficiently and with less effort by tracking groups of issues that share a theme, across projects and milestones.
-
-For more information, see the [Epics](../../group/epics/index.md) page.
+[Epics](../../group/epics/index.md) let you manage your portfolio of projects more
+efficiently and with less effort by tracking groups of issues that share a theme, across
+projects and milestones.
 
 ### Related issues **[STARTER]**
 
-You can mark two issues as related, so that when viewing each one, the other is always listed in its Related Issues section. This can help display important context, such as past work, dependencies, or duplicates.
-
-For more information, see [Related Issues](related_issues.md).
+You can mark two issues as related, so that when viewing one, the other is always
+listed in its [Related Issues](related_issues.md) section. This can help display important
+context, such as past work, dependencies, or duplicates.
 
 ### Crosslinking issues
 
-When you reference an issue from another issue or merge request by including its URL or ID, the referenced issue displays a message in the Activity stream about the reference, with a link to the other issue or MR.
+You can [crosslink issues](crosslinking_issues.md) by referencing an issue from another
+issue or merge request by including its URL or ID. The referenced issue displays a
+message in the Activity stream about the reference, with a link to the other issue or MR.
 
-For more information, see [Crosslinking issues](crosslinking_issues.md).
+### Similar issues
 
-## Issue actions
+> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/22866) in GitLab 11.6.
+
+To prevent duplication of issues for the same topic, GitLab searches for similar issues
+when new issues are being created.
+
+When typing in the title in the new issue form, GitLab searches titles and descriptions
+across all issues the user has access to in the current project. Up 5 similar issues,
+sorted by most recently updated, are displayed below the title box. Note that this feature
+requires [GraphQL](../../../api/graphql/index.md) to be enabled.
+
+![Similar issues](img/similar_issues.png)
+
+## Other Issue actions
 
-- [Create an issue](create_new_issue.md)
 - [Create an issue from a template](../../project/description_templates.md#using-the-templates)
-- [Close an issue](closing_issues.md)
-- [Move an issue](moving_issues.md)
-- [Delete an issue](deleting_issues.md)
-- [Create a merge request from an issue](issue_data_and_actions.md#22-create-merge-request)
-
-## Advanced issue management
-
-- [Bulk edit issues](../bulk_editing.md) - From the Issues List, select multiple issues in order to change their status, assignee, milestone, or labels in bulk.
+- [Set a due date](due_dates.md)
+- [Bulk edit issues](../bulk_editing.md) - From the Issues List, select multiple issues
+  in order to change their status, assignee, milestone, or labels in bulk.
 - [Import issues](csv_import.md)
 - [Export issues](csv_export.md) **[STARTER]**
 - [Issues API](../../../api/issues.md)
-- Configure an [external issue tracker](../../../integration/external-issue-tracker.md) such as Jira, Redmine,
-  or Bugzilla.
+- Configure an [external issue tracker](../../../integration/external-issue-tracker.md)
+  such as Jira, Redmine, or Bugzilla.
diff --git a/doc/user/project/issues/issue_data_and_actions.md b/doc/user/project/issues/issue_data_and_actions.md
index 2103f331aa2..9898cd6cf15 100644
--- a/doc/user/project/issues/issue_data_and_actions.md
+++ b/doc/user/project/issues/issue_data_and_actions.md
@@ -48,7 +48,7 @@ which you can click to mark that issue as done (which will be reflected in the T
 #### 3. Assignee
 
 An issue can be assigned to yourself, another person, or [many people](#31-multiple-assignees-STARTER).
-The assignee(s) can be changed as much as needed. The idea is that the assignees are
+The assignee(s) can be changed as often as needed. The idea is that the assignees are
 responsible for that issue until it's reassigned to someone else to take it from there.
 When assigned to someone, it will appear in their assigned issues list.
 
diff --git a/doc/user/project/issues/managing_issues.md b/doc/user/project/issues/managing_issues.md
new file mode 100644
index 00000000000..663bacf4a45
--- /dev/null
+++ b/doc/user/project/issues/managing_issues.md
@@ -0,0 +1,204 @@
+# Managing Issues
+
+[GitLab Issues](index.md) are the fundamental medium for collaborating on ideas and
+planning work in GitLab. [Creating](#create-a-new-issue), [moving](#moving-issues),
+[closing](#closing-issues), and [deleting](#deleting-issues) are key actions that
+you can do with issues.
+
+## Create a new Issue
+
+When you create a new issue, you'll be prompted to fill in the [data and fields of the issue](issue_data_and_actions.md#parts-of-an-issue), as illustrated below.
+
+![New issue from the issues list](img/new_issue.png)
+
+### Accessing the new Issue form
+
+There are many ways to get to the new Issue form from within a project:
+
+- Navigate to your **Project's Dashboard** > **Issues** > **New Issue**:
+
+  ![New issue from the issue list view](img/new_issue_from_tracker_list.png)
+
+- From an **opened issue** in your project, click **New Issue** to create a new
+  issue in the same project:
+
+  ![New issue from an open issue](img/new_issue_from_open_issue.png)
+
+- From your **Project's Dashboard**, click the plus sign (**+**) to open a dropdown
+  menu with a few options. Select **New Issue** to create an issue in that project:
+
+  ![New issue from a project's dashboard](img/new_issue_from_projects_dashboard.png)
+
+- From an **Issue Board**, create a new issue by clicking on the plus sign (**+**) at the top of a list.
+  It opens a new issue for that project, pre-labeled with its respective list.
+
+  ![From the issue board](img/new_issue_from_issue_board.png)
+
+### New issue from the group-level Issue Tracker
+
+Go to the Group dashboard and click "Issues" in the sidebar to visit the Issue Tracker
+for all projects in your Group. Select the project you'd like to add an issue for
+using the dropdown button at the top-right of the page.
+
+![Select project to create issue](img/select_project_from_group_level_issue_tracker.png)
+
+We'll keep track of the project you selected most recently, and use it as the default
+for your next visit. This should save you a lot of time and clicks, if you mostly
+create issues for the same project.
+
+![Create issue from group-level issue tracker](img/create_issue_from_group_level_issue_tracker.png)
+
+### New issue via Service Desk **[PREMIUM]**
+
+Enable [Service Desk](../service_desk.md) for your project and offer email support.
+By doing so, when your customer sends a new email, a new issue can be created in
+the appropriate project and followed up from there.
+
+### New issue via email
+
+A link to **Email a new issue to this project** is displayed at the bottom of a project's
+**Issues List** page, if your GitLab instance has [incoming email](../../../administration/incoming_email.md)
+configured.
+
+![Bottom of a project issues page](img/new_issue_from_email.png)
+
+When you click this link, an email address is generated and displayed, which should be used
+by **you only**, to create issues in this project. You can save this address as a
+contact in your email client for easy acceess.
+
+CAUTION: **Caution:**
+This is a private email address, generated just for you. **Keep it to yourself**,
+as anyone who knows it can create issues or merge requests as if they
+were you. If the address is compromised, or you'd like it to be regenerated for
+any reason, click **Email a new issue to this project** again and click the reset link.
+
+Sending an email to this address will create a new issue in your name for
+this project, where:
+
+- The email subject becomes the issue title.
+- The email body becomes the issue description.
+- [Markdown](../../markdown.md) and [quick actions](../quick_actions.md) are supported.
+
+NOTE: **Note:**
+In GitLab 11.7, we updated the format of the generated email address. However the
+older format is still supported, allowing existing aliases or contacts to continue working.
+
+### New issue via URL with prefilled fields
+
+You can link directly to the new issue page for a given project, with prefilled
+field values using query string parameters in a URL. This is useful for embedding
+a URL in an external HTML page, and also certain scenarios where you want the user to
+create an issue with certain fields prefilled.
+
+The title, description, and description template fields can be prefilled using
+this method. You cannot pre-fill both the description and description template fields
+in the same URL (since a description template also populates the description field).
+
+Follow these examples to form your new issue URL with prefilled fields.
+
+- For a new issue in the GitLab Community Edition project with a pre-filled title
+  and a pre-filled description, the URL would be `https://gitlab.com/gitlab-org/gitlab-ce/issues/new?issue[title]=Validate%20new%20concept&issue[description]=Research%20idea`
+- For a new issue in the GitLab Community Edition project with a pre-filled title
+  and a pre-filled description template, the URL would be `https://gitlab.com/gitlab-org/gitlab-ce/issues/new?issue[title]=Validate%20new%20concept&issuable_template=Research%20proposal`
+
+## Moving Issues
+
+Moving an issue will copy it to a new location (project), and close it in the old project,
+but it will not be deleted. There will also be a system note added to both issues
+indicating where it came from and went to.
+
+The "Move issue" button is at the bottom of the right-sidebar when viewing the issue.
+
+![move issue - button](img/sidebar_move_issue.png)
+
+## Closing Issues
+
+When you decide that an issue is resolved, or no longer needed, you can close the issue
+using the close button:
+
+![close issue - button](img/button_close_issue.png)
+
+You can also close an issue from the [Issue Boards](../issue_board.md) by dragging an issue card
+from its list and dropping it into the **Closed** list.
+
+![close issue from the Issue Board](img/close_issue_from_board.gif)
+
+### Closing issues automatically
+
+NOTE: **Note:**
+For performance reasons, automatic issue closing is disabled for the very first
+push from an existing repository.
+
+When a commit or merge request resolves one or more issues, it is possible to have
+these issues closed automatically when the commit or merge request reaches the project's
+default branch.
+
+If a commit message or merge request description contains text matching a [defined pattern](#default-closing-pattern),
+all issues referenced in the matched text will be closed. This happens when the commit
+is pushed to a project's [**default** branch](../repository/branches/index.md#default-branch),
+or when a commit or merge request is merged into it.
+
+For example, if `Closes #4, #6, Related to #5` is included in a Merge Request
+description, issues `#4` and `#6` will close automatically when the MR is merged, but not `#5`.
+Using `Related to` flags `#5` as a [related issue](related_issues.md),
+but it will not close automatically.
+
+![merge request closing issue when merged](img/merge_request_closes_issue.png)
+
+If the issue is in a different repository than the MR, add the full URL for the issue(s):
+
+```md
+Closes #4, #6, and https://gitlab.com/<username>/<projectname>/issues/<xxx>
+```
+
+#### Default closing pattern
+
+When not specified, the default issue closing pattern as shown below will be used:
+
+```bash
+((?:[Cc]los(?:e[sd]?|ing)|[Ff]ix(?:e[sd]|ing)?|[Rr]esolv(?:e[sd]?|ing)|[Ii]mplement(?:s|ed|ing)?)(:?) +(?:(?:issues? +)?%{issue_ref}(?:(?:, *| +and +)?)|([A-Z][A-Z0-9_]+-\d+))+)
+```
+
+This translates to the following keywords:
+
+- Close, Closes, Closed, Closing, close, closes, closed, closing
+- Fix, Fixes, Fixed, Fixing, fix, fixes, fixed, fixing
+- Resolve, Resolves, Resolved, Resolving, resolve, resolves, resolved, resolving
+- Implement, Implements, Implemented, Implementing, implement, implements, implemented, implementing
+
+Note that `%{issue_ref}` is a complex regular expression defined inside GitLab's
+source code that can match references to:
+
+- A local issue (`#123`).
+- A cross-project issue (`group/project#123`).
+- A link to an issue (`https://gitlab.example.com/group/project/issues/123`).
+
+For example the following commit message:
+
+```
+Awesome commit message
+
+Fix #20, Fixes #21 and Closes group/otherproject#22.
+This commit is also related to #17 and fixes #18, #19
+and https://gitlab.example.com/group/otherproject/issues/23.
+```
+
+will close `#18`, `#19`, `#20`, and `#21` in the project this commit is pushed to,
+as well as `#22` and `#23` in group/otherproject. `#17` won't be closed as it does
+not match the pattern. It works with multi-line commit messages as well as one-liners
+when used from the command line with `git commit -m`.
+
+#### Customizing the issue closing pattern **[CORE ONLY]**
+
+In order to change the default issue closing pattern, you must edit the
+[`gitlab.rb` or `gitlab.yml` file](../../../administration/issue_closing_pattern.md)
+of your installation.
+
+## Deleting Issues
+
+> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/2982) in GitLab 8.6
+
+Users with [project owner permission](../../permissions.md) can delete an issue by
+editing it and clicking on the delete button. 
+
+![delete issue - button](img/delete_issue.png)
diff --git a/doc/user/project/issues/moving_issues.md b/doc/user/project/issues/moving_issues.md
index 8aac2c01444..8331f865b83 100644
--- a/doc/user/project/issues/moving_issues.md
+++ b/doc/user/project/issues/moving_issues.md
@@ -1,35 +1,5 @@
-# Moving Issues
-
-Please read through the [GitLab Issue Documentation](index.md) for an overview on GitLab Issues.
-
-Moving an issue will close it and duplicate it on the specified project.
-There will also be a system note added to both issues indicating where it came from or went to.
-
-You can move an issue with the "Move issue" button at the bottom of the right-sidebar when viewing the issue.
-
-![move issue - button](img/sidebar_move_issue.png)
-
-## Troubleshooting
-
-### Moving Issues in Bulk
-
-If you have advanced technical skills you can also bulk move all the issues from one project to another in the rails console. The below script will move all the issues from one project to another that are not in status **closed**.
-
-To access rails console run `sudo gitlab-rails console` on the GitLab server and run the below script. Please be sure to change **project**, **admin_user** and **target_project** to your values. We do also recommend [creating a backup](https://docs.gitlab.com/ee/raketasks/backup_restore.html#creating-a-backup-of-the-gitlab-system) before attempting any changes in the console.
-
-```ruby
-project = Project.find_by_full_path('full path of the project where issues are moved from')
-issues = project.issues
-admin_user = User.find_by_username('username of admin user') # make sure user has permissions to move the issues
-target_project = Project.find_by_full_path('full path of target project where issues moved to')
-
-issues.each do |issue|
-   if issue.state != "closed" && issue.moved_to.nil?
-      Issues::MoveService.new(project, admin_user).execute(issue, target_project)
-   else
-      puts "issue with id: #{issue.id} and title: #{issue.title} was not moved"
-   end
-end; nil
-
-```
+---
+redirect_to: 'managing_issues.md#moving-issues'
+---
 
+This document was moved to [another location](managing_issues.md#moving-issues).
diff --git a/doc/user/project/issues/similar_issues.md b/doc/user/project/issues/similar_issues.md
index e90ecd88ec6..9cbac53ee41 100644
--- a/doc/user/project/issues/similar_issues.md
+++ b/doc/user/project/issues/similar_issues.md
@@ -1,16 +1,5 @@
-# Similar issues
+---
+redirect_to: 'index.md#similar-issues'
+---
 
-> [Introduced][ce-22866] in GitLab 11.6.
-
-Similar issues suggests issues that are similar when new issues are being created.
-This features requires [GraphQL] to be enabled.
-
-![Similar issues](img/similar_issues.png)
-
-You can see the similar issues when typing in the title in the new issue form.
-This searches both titles and descriptions across all issues the user has access
-to in the current project. It then displays the first 5 issues sorted by most
-recently updated.
-
-[GraphQL]: ../../../api/graphql/index.md
-[ce-22866]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/22866
+This document was moved to [another location](index.md#similar-issues).
diff --git a/doc/user/project/merge_requests/index.md b/doc/user/project/merge_requests/index.md
index 447b338928c..169b10572b0 100644
--- a/doc/user/project/merge_requests/index.md
+++ b/doc/user/project/merge_requests/index.md
@@ -23,7 +23,7 @@ With GitLab merge requests, you can:
 - Build, test, and deploy your code in a per-branch basis with built-in [GitLab CI/CD](../../../ci/README.md)
 - Prevent the merge request from being merged before it's ready with [WIP MRs](#work-in-progress-merge-requests)
 - View the deployment process through [Pipeline Graphs](../../../ci/pipelines.md#visualizing-pipelines)
-- [Automatically close the issue(s)](../../project/issues/closing_issues.md#via-merge-request) that originated the implementation proposed in the merge request
+- [Automatically close the issue(s)](../../project/issues/managing_issues.md#closing-issues-automatically) that originated the implementation proposed in the merge request
 - Assign it to any registered user, and change the assignee how many times you need
 - Assign a [milestone](../../project/milestones/index.md) and track the development of a broader implementation
 - Organize your issues and merge requests consistently throughout the project with [labels](../../project/labels.md)
diff --git a/doc/user/project/repository/branches/index.md b/doc/user/project/repository/branches/index.md
index 13e4f2ce163..a81c9197ec1 100644
--- a/doc/user/project/repository/branches/index.md
+++ b/doc/user/project/repository/branches/index.md
@@ -21,7 +21,7 @@ branch for your project. You can choose another branch to be your project's
 default under your project's **Settings > Repository**.
 
 The default branch is the branch affected by the
-[issue closing pattern](../../issues/automatic_issue_closing.md),
+[issue closing pattern](../../issues/managing_issues.md#closing-issues-automatically),
 which means that _an issue will be closed when a merge request is merged to
 the **default branch**_.
 
diff --git a/doc/user/project/repository/web_editor.md b/doc/user/project/repository/web_editor.md
index ce9d23bf911..253e5374f52 100644
--- a/doc/user/project/repository/web_editor.md
+++ b/doc/user/project/repository/web_editor.md
@@ -114,7 +114,7 @@ If your [project is already configured with a deployment service][project-servic
 
 After the branch is created, you can edit files in the repository to fix
 the issue. When a merge request is created based on the newly created branch,
-the description field will automatically display the [issue closing pattern]
+the description field will automatically display the [issue closing pattern](../issues/managing_issues.md#closing-issues-automatically)
 `Closes #ID`, where `ID` the ID of the issue. This will close the issue once the
 merge request is merged.
 
@@ -181,4 +181,3 @@ through the web editor, you can choose to use another of your linked email
 addresses from the **User Settings > Edit Profile** page.
 
 [ce-2808]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/2808
-[issue closing pattern]: ../issues/automatic_issue_closing.md
diff --git a/doc/workflow/README.md b/doc/workflow/README.md
index 40e2486ace5..45bd8c29a48 100644
--- a/doc/workflow/README.md
+++ b/doc/workflow/README.md
@@ -4,7 +4,7 @@ comments: false
 
 # Workflow
 
-- [Automatic issue closing](../user/project/issues/automatic_issue_closing.md)
+- [Automatic issue closing](../user/project/issues/managing_issues.md#closing-issues-automatically)
 - [Change your time zone](timezone.md)
 - [Cycle Analytics](../user/project/cycle_analytics.md)
 - [Description templates](../user/project/description_templates.md)

From 93be669e16b71a00362187a690e573209d80d960 Mon Sep 17 00:00:00 2001
From: Shinya Maeda <shinya@gitlab.com>
Date: Wed, 26 Jun 2019 19:29:35 +0700
Subject: [PATCH 035/195] Refactor pipeline errors_message

Use the shared method in Ci::Pipeline
---
 app/models/ci/pipeline.rb                  |  4 ++++
 app/services/ci/create_pipeline_service.rb |  2 +-
 spec/models/ci/pipeline_spec.rb            | 24 ++++++++++++++++++++++
 3 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/app/models/ci/pipeline.rb b/app/models/ci/pipeline.rb
index fd5aa216174..20ca4a9ab24 100644
--- a/app/models/ci/pipeline.rb
+++ b/app/models/ci/pipeline.rb
@@ -790,6 +790,10 @@ module Ci
       stages.find_by!(name: name)
     end
 
+    def error_messages
+      errors ? errors.full_messages.to_sentence : ""
+    end
+
     private
 
     def ci_yaml_from_repo
diff --git a/app/services/ci/create_pipeline_service.rb b/app/services/ci/create_pipeline_service.rb
index c17712355af..cdcc4b15bea 100644
--- a/app/services/ci/create_pipeline_service.rb
+++ b/app/services/ci/create_pipeline_service.rb
@@ -65,7 +65,7 @@ module Ci
     def execute!(*args, &block)
       execute(*args, &block).tap do |pipeline|
         unless pipeline.persisted?
-          raise CreateError, pipeline.errors.full_messages.join(',')
+          raise CreateError, pipeline.error_messages
         end
       end
     end
diff --git a/spec/models/ci/pipeline_spec.rb b/spec/models/ci/pipeline_spec.rb
index 55cea48b641..e24bbc39761 100644
--- a/spec/models/ci/pipeline_spec.rb
+++ b/spec/models/ci/pipeline_spec.rb
@@ -2998,4 +2998,28 @@ describe Ci::Pipeline, :mailer do
       end
     end
   end
+
+  describe '#error_messages' do
+    subject { pipeline.error_messages }
+
+    before do
+      pipeline.valid?
+    end
+
+    context 'when pipeline has errors' do
+      let(:pipeline) { build(:ci_pipeline, sha: nil, ref: nil) }
+
+      it 'returns the full error messages' do
+        is_expected.to eq("Sha can't be blank and Ref can't be blank")
+      end
+    end
+
+    context 'when pipeline does not have errors' do
+      let(:pipeline) { build(:ci_pipeline) }
+
+      it 'returns empty string' do
+        is_expected.to be_empty
+      end
+    end
+  end
 end

From 824ec018a1f9bafe3d7b5ff5f7db2a04d3cb4993 Mon Sep 17 00:00:00 2001
From: Simon Knox <psimyn@gmail.com>
Date: Wed, 3 Jul 2019 00:51:32 +1000
Subject: [PATCH 036/195] Use gl-empty-state for monitor charts

Move a unit test to jest and use snapshot tests
---
 .../monitoring/components/dashboard.vue       |   6 ++
 .../monitoring/components/empty_state.vue     |  65 +++++------
 locale/gitlab.pot                             |   6 +-
 .../dashboard_state_spec.js.snap              |  37 +++++++
 .../monitoring/dashboard_state_spec.js        |  43 ++++++++
 .../monitoring/dashboard_state_spec.js        | 101 ------------------
 6 files changed, 117 insertions(+), 141 deletions(-)
 create mode 100644 spec/frontend/monitoring/__snapshots__/dashboard_state_spec.js.snap
 create mode 100644 spec/frontend/monitoring/dashboard_state_spec.js
 delete mode 100644 spec/javascripts/monitoring/dashboard_state_spec.js

diff --git a/app/assets/javascripts/monitoring/components/dashboard.vue b/app/assets/javascripts/monitoring/components/dashboard.vue
index 2cbda8ea05d..ed25a6e3684 100644
--- a/app/assets/javascripts/monitoring/components/dashboard.vue
+++ b/app/assets/javascripts/monitoring/components/dashboard.vue
@@ -124,6 +124,11 @@ export default {
       required: false,
       default: '',
     },
+    smallEmptyState: {
+      type: Boolean,
+      required: false,
+      default: false,
+    },
   },
   data() {
     return {
@@ -386,6 +391,7 @@ export default {
       :empty-loading-svg-path="emptyLoadingSvgPath"
       :empty-no-data-svg-path="emptyNoDataSvgPath"
       :empty-unable-to-connect-svg-path="emptyUnableToConnectSvgPath"
+      :compact="smallEmptyState"
     />
   </div>
 </template>
diff --git a/app/assets/javascripts/monitoring/components/empty_state.vue b/app/assets/javascripts/monitoring/components/empty_state.vue
index a3c6de14aa4..1bb40447a3e 100644
--- a/app/assets/javascripts/monitoring/components/empty_state.vue
+++ b/app/assets/javascripts/monitoring/components/empty_state.vue
@@ -1,7 +1,11 @@
 <script>
 import { __ } from '~/locale';
+import { GlEmptyState } from '@gitlab/ui';
 
 export default {
+  components: {
+    GlEmptyState,
+  },
   props: {
     documentationPath: {
       type: String,
@@ -37,6 +41,11 @@ export default {
       type: String,
       required: true,
     },
+    compact: {
+      type: Boolean,
+      required: false,
+      default: false,
+    },
   },
   data() {
     return {
@@ -58,6 +67,8 @@ export default {
               If this takes a long time, ensure that data is available.`),
           buttonText: __('View documentation'),
           buttonPath: this.documentationPath,
+          secondaryButtonText: '',
+          secondaryButtonPath: '',
         },
         noData: {
           svgUrl: this.emptyNoDataSvgPath,
@@ -66,13 +77,19 @@ export default {
               no data to display.`),
           buttonText: __('Configure Prometheus'),
           buttonPath: this.settingsPath,
+          secondaryButtonText: '',
+          secondaryButtonPath: '',
         },
         unableToConnect: {
           svgUrl: this.emptyUnableToConnectSvgPath,
           title: __('Unable to connect to Prometheus server'),
-          description: 'Ensure connectivity is available from the GitLab server to the ',
+          description: __(
+            'Ensure connectivity is available from the GitLab server to the Prometheus server',
+          ),
           buttonText: __('View documentation'),
           buttonPath: this.documentationPath,
+          secondaryButtonText: __('Configure Prometheus'),
+          secondaryButtonPath: this.settingsPath,
         },
       },
     };
@@ -81,45 +98,19 @@ export default {
     currentState() {
       return this.states[this.selectedState];
     },
-    showButtonDescription() {
-      if (this.selectedState === 'unableToConnect') return true;
-      return false;
-    },
   },
 };
 </script>
 
 <template>
-  <div class="row empty-state js-empty-state">
-    <div class="col-12">
-      <div class="state-svg svg-content">
-        <img :src="currentState.svgUrl" />
-      </div>
-    </div>
-
-    <div class="col-12">
-      <div class="text-content">
-        <h4 class="state-title text-center">{{ currentState.title }}</h4>
-        <p class="state-description">
-          {{ currentState.description }}
-          <a v-if="showButtonDescription" :href="settingsPath">{{ __('Prometheus server') }}</a>
-        </p>
-
-        <div class="text-center">
-          <a
-            v-if="currentState.buttonPath"
-            :href="currentState.buttonPath"
-            class="btn btn-success"
-            >{{ currentState.buttonText }}</a
-          >
-          <a
-            v-if="currentState.secondaryButtonPath"
-            :href="currentState.secondaryButtonPath"
-            class="btn"
-            >{{ currentState.secondaryButtonText }}</a
-          >
-        </div>
-      </div>
-    </div>
-  </div>
+  <gl-empty-state
+    :title="currentState.title"
+    :description="currentState.description"
+    :primary-button-text="currentState.buttonText"
+    :primary-button-link="currentState.buttonPath"
+    :secondary-button-text="currentState.secondaryButtonText"
+    :secondary-button-link="currentState.secondaryButtonPath"
+    :svg-path="currentState.svgUrl"
+    :compact="compact"
+  />
 </template>
diff --git a/locale/gitlab.pot b/locale/gitlab.pot
index 8a4f57c5b13..7e5e2f8df7b 100644
--- a/locale/gitlab.pot
+++ b/locale/gitlab.pot
@@ -3995,6 +3995,9 @@ msgstr ""
 msgid "Enforce DNS rebinding attack protection"
 msgstr ""
 
+msgid "Ensure connectivity is available from the GitLab server to the Prometheus server"
+msgstr ""
+
 msgid "Enter at least three characters to search"
 msgstr ""
 
@@ -8330,9 +8333,6 @@ msgstr ""
 msgid "ProjectsDropdown|This feature requires browser localStorage support"
 msgstr ""
 
-msgid "Prometheus server"
-msgstr ""
-
 msgid "PrometheusService|%{exporters} with %{metrics} were found"
 msgstr ""
 
diff --git a/spec/frontend/monitoring/__snapshots__/dashboard_state_spec.js.snap b/spec/frontend/monitoring/__snapshots__/dashboard_state_spec.js.snap
new file mode 100644
index 00000000000..5f24bab600c
--- /dev/null
+++ b/spec/frontend/monitoring/__snapshots__/dashboard_state_spec.js.snap
@@ -0,0 +1,37 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`EmptyState shows gettingStarted state 1`] = `
+<glemptystate-stub
+  description="Stay updated about the performance and health of your environment by configuring Prometheus to monitor your deployments."
+  primarybuttonlink="/clustersPath"
+  primarybuttontext="Install on clusters"
+  secondarybuttonlink="/settingsPath"
+  secondarybuttontext="Configure existing installation"
+  svgpath="/path/to/getting-started.svg"
+  title="Get started with performance monitoring"
+/>
+`;
+
+exports[`EmptyState shows loading state 1`] = `
+<glemptystate-stub
+  description="Creating graphs uses the data from the Prometheus server. If this takes a long time, ensure that data is available."
+  primarybuttonlink="/documentationPath"
+  primarybuttontext="View documentation"
+  secondarybuttonlink=""
+  secondarybuttontext=""
+  svgpath="/path/to/loading.svg"
+  title="Waiting for performance data"
+/>
+`;
+
+exports[`EmptyState shows unableToConnect state 1`] = `
+<glemptystate-stub
+  description="Ensure connectivity is available from the GitLab server to the Prometheus server"
+  primarybuttonlink="/documentationPath"
+  primarybuttontext="View documentation"
+  secondarybuttonlink="/settingsPath"
+  secondarybuttontext="Configure Prometheus"
+  svgpath="/path/to/unable-to-connect.svg"
+  title="Unable to connect to Prometheus server"
+/>
+`;
diff --git a/spec/frontend/monitoring/dashboard_state_spec.js b/spec/frontend/monitoring/dashboard_state_spec.js
new file mode 100644
index 00000000000..950422911eb
--- /dev/null
+++ b/spec/frontend/monitoring/dashboard_state_spec.js
@@ -0,0 +1,43 @@
+import { shallowMount } from '@vue/test-utils';
+import EmptyState from '~/monitoring/components/empty_state.vue';
+
+function createComponent(props) {
+  return shallowMount(EmptyState, {
+    propsData: {
+      ...props,
+      settingsPath: '/settingsPath',
+      clustersPath: '/clustersPath',
+      documentationPath: '/documentationPath',
+      emptyGettingStartedSvgPath: '/path/to/getting-started.svg',
+      emptyLoadingSvgPath: '/path/to/loading.svg',
+      emptyNoDataSvgPath: '/path/to/no-data.svg',
+      emptyUnableToConnectSvgPath: '/path/to/unable-to-connect.svg',
+    },
+  });
+}
+
+describe('EmptyState', () => {
+  it('shows gettingStarted state', () => {
+    const wrapper = createComponent({
+      selectedState: 'gettingStarted',
+    });
+
+    expect(wrapper.element).toMatchSnapshot();
+  });
+
+  it('shows loading state', () => {
+    const wrapper = createComponent({
+      selectedState: 'loading',
+    });
+
+    expect(wrapper.element).toMatchSnapshot();
+  });
+
+  it('shows unableToConnect state', () => {
+    const wrapper = createComponent({
+      selectedState: 'unableToConnect',
+    });
+
+    expect(wrapper.element).toMatchSnapshot();
+  });
+});
diff --git a/spec/javascripts/monitoring/dashboard_state_spec.js b/spec/javascripts/monitoring/dashboard_state_spec.js
deleted file mode 100644
index 6b2be83aa8c..00000000000
--- a/spec/javascripts/monitoring/dashboard_state_spec.js
+++ /dev/null
@@ -1,101 +0,0 @@
-import Vue from 'vue';
-import EmptyState from '~/monitoring/components/empty_state.vue';
-import { statePaths } from './mock_data';
-
-function createComponent(props) {
-  const Component = Vue.extend(EmptyState);
-
-  return new Component({
-    propsData: {
-      ...props,
-      settingsPath: statePaths.settingsPath,
-      clustersPath: statePaths.clustersPath,
-      documentationPath: statePaths.documentationPath,
-      emptyGettingStartedSvgPath: '/path/to/getting-started.svg',
-      emptyLoadingSvgPath: '/path/to/loading.svg',
-      emptyNoDataSvgPath: '/path/to/no-data.svg',
-      emptyUnableToConnectSvgPath: '/path/to/unable-to-connect.svg',
-    },
-  }).$mount();
-}
-
-function getTextFromNode(component, selector) {
-  return component.$el.querySelector(selector).firstChild.nodeValue.trim();
-}
-
-describe('EmptyState', () => {
-  describe('Computed props', () => {
-    it('currentState', () => {
-      const component = createComponent({
-        selectedState: 'gettingStarted',
-      });
-
-      expect(component.currentState).toBe(component.states.gettingStarted);
-    });
-
-    it('showButtonDescription returns a description with a link for the unableToConnect state', () => {
-      const component = createComponent({
-        selectedState: 'unableToConnect',
-      });
-
-      expect(component.showButtonDescription).toEqual(true);
-    });
-
-    it('showButtonDescription returns the description without a link for any other state', () => {
-      const component = createComponent({
-        selectedState: 'loading',
-      });
-
-      expect(component.showButtonDescription).toEqual(false);
-    });
-  });
-
-  it('should show the gettingStarted state', () => {
-    const component = createComponent({
-      selectedState: 'gettingStarted',
-    });
-
-    expect(component.$el.querySelector('svg')).toBeDefined();
-    expect(getTextFromNode(component, '.state-title')).toEqual(
-      component.states.gettingStarted.title,
-    );
-
-    expect(getTextFromNode(component, '.state-description')).toEqual(
-      component.states.gettingStarted.description,
-    );
-
-    expect(getTextFromNode(component, '.btn-success')).toEqual(
-      component.states.gettingStarted.buttonText,
-    );
-  });
-
-  it('should show the loading state', () => {
-    const component = createComponent({
-      selectedState: 'loading',
-    });
-
-    expect(component.$el.querySelector('svg')).toBeDefined();
-    expect(getTextFromNode(component, '.state-title')).toEqual(component.states.loading.title);
-    expect(getTextFromNode(component, '.state-description')).toEqual(
-      component.states.loading.description,
-    );
-
-    expect(getTextFromNode(component, '.btn-success')).toEqual(component.states.loading.buttonText);
-  });
-
-  it('should show the unableToConnect state', () => {
-    const component = createComponent({
-      selectedState: 'unableToConnect',
-    });
-
-    expect(component.$el.querySelector('svg')).toBeDefined();
-    expect(getTextFromNode(component, '.state-title')).toEqual(
-      component.states.unableToConnect.title,
-    );
-
-    expect(component.$el.querySelector('.state-description a')).toBeDefined();
-    expect(getTextFromNode(component, '.btn-success')).toEqual(
-      component.states.unableToConnect.buttonText,
-    );
-  });
-});

From 4e75c7135a4c5309c02a6335de583cd097cc72c7 Mon Sep 17 00:00:00 2001
From: Ramya Authappan <rauthappan@gitlab.com>
Date: Thu, 4 Jul 2019 04:21:09 +0000
Subject: [PATCH 037/195] E2E Test to check XSS issue in @mentions autocomplete

---
 qa/qa/page/project/show.rb                    |  1 +
 qa/qa/page/project/sub_menus/ci_cd.rb         |  2 +
 qa/qa/page/project/sub_menus/issues.rb        |  2 +
 qa/qa/page/project/sub_menus/operations.rb    |  2 +
 qa/qa/page/project/sub_menus/repository.rb    |  2 +
 qa/qa/page/project/sub_menus/settings.rb      |  2 +
 .../issue/check_mentions_for_xss_spec.rb      | 43 +++++++++++++++++++
 7 files changed, 54 insertions(+)
 create mode 100644 qa/qa/specs/features/browser_ui/2_plan/issue/check_mentions_for_xss_spec.rb

diff --git a/qa/qa/page/project/show.rb b/qa/qa/page/project/show.rb
index 1a9a2fd413f..9fd668f812b 100644
--- a/qa/qa/page/project/show.rb
+++ b/qa/qa/page/project/show.rb
@@ -5,6 +5,7 @@ module QA
     module Project
       class Show < Page::Base
         include Page::Component::ClonePanel
+        include Page::Project::SubMenus::Settings
 
         view 'app/views/layouts/header/_new_dropdown.haml' do
           element :new_menu_toggle
diff --git a/qa/qa/page/project/sub_menus/ci_cd.rb b/qa/qa/page/project/sub_menus/ci_cd.rb
index adae2ce08c4..2f0bc8b9ba6 100644
--- a/qa/qa/page/project/sub_menus/ci_cd.rb
+++ b/qa/qa/page/project/sub_menus/ci_cd.rb
@@ -5,6 +5,8 @@ module QA
     module Project
       module SubMenus
         module CiCd
+          include Page::Project::SubMenus::Common
+
           def self.included(base)
             base.class_eval do
               view 'app/views/layouts/nav/sidebar/_project.html.haml' do
diff --git a/qa/qa/page/project/sub_menus/issues.rb b/qa/qa/page/project/sub_menus/issues.rb
index f81e4f34909..8fb8fa06346 100644
--- a/qa/qa/page/project/sub_menus/issues.rb
+++ b/qa/qa/page/project/sub_menus/issues.rb
@@ -5,6 +5,8 @@ module QA
     module Project
       module SubMenus
         module Issues
+          include Page::Project::SubMenus::Common
+
           def self.included(base)
             base.class_eval do
               view 'app/views/layouts/nav/sidebar/_project.html.haml' do
diff --git a/qa/qa/page/project/sub_menus/operations.rb b/qa/qa/page/project/sub_menus/operations.rb
index 24a99a9464c..d266cb21417 100644
--- a/qa/qa/page/project/sub_menus/operations.rb
+++ b/qa/qa/page/project/sub_menus/operations.rb
@@ -5,6 +5,8 @@ module QA
     module Project
       module SubMenus
         module Operations
+          include Page::Project::SubMenus::Common
+
           def self.included(base)
             base.class_eval do
               view 'app/views/layouts/nav/sidebar/_project.html.haml' do
diff --git a/qa/qa/page/project/sub_menus/repository.rb b/qa/qa/page/project/sub_menus/repository.rb
index 4cc73a6b25a..c53d805c61d 100644
--- a/qa/qa/page/project/sub_menus/repository.rb
+++ b/qa/qa/page/project/sub_menus/repository.rb
@@ -5,6 +5,8 @@ module QA
     module Project
       module SubMenus
         module Repository
+          include Page::Project::SubMenus::Common
+
           def self.included(base)
             base.class_eval do
               view 'app/views/layouts/nav/sidebar/_project.html.haml' do
diff --git a/qa/qa/page/project/sub_menus/settings.rb b/qa/qa/page/project/sub_menus/settings.rb
index 88b45ec55ae..1cd39fcff58 100644
--- a/qa/qa/page/project/sub_menus/settings.rb
+++ b/qa/qa/page/project/sub_menus/settings.rb
@@ -5,6 +5,8 @@ module QA
     module Project
       module SubMenus
         module Settings
+          include Page::Project::SubMenus::Common
+
           def self.included(base)
             base.class_eval do
               view 'app/views/layouts/nav/sidebar/_project.html.haml' do
diff --git a/qa/qa/specs/features/browser_ui/2_plan/issue/check_mentions_for_xss_spec.rb b/qa/qa/specs/features/browser_ui/2_plan/issue/check_mentions_for_xss_spec.rb
new file mode 100644
index 00000000000..013cea0a40e
--- /dev/null
+++ b/qa/qa/specs/features/browser_ui/2_plan/issue/check_mentions_for_xss_spec.rb
@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module QA
+  context 'Plan' do
+    describe 'check xss occurence in @mentions in issues' do
+      let(:issue_title) { 'issue title' }
+
+      it 'user mentions a user in comment' do
+        Runtime::Browser.visit(:gitlab, Page::Main::Login)
+        Page::Main::Login.perform(&:sign_in_using_credentials)
+
+        user = Resource::User.fabricate! do |user|
+          user.name = "eve <img src=x onerror=alert(2)&lt;img src=x onerror=alert(1)&gt;"
+          user.password = "test1234"
+        end
+
+        project = Resource::Project.fabricate! do |resource|
+          resource.name = 'xss-test-for-mentions-project'
+        end
+        project.visit!
+
+        Page::Project::Show.perform(&:go_to_members_settings)
+        Page::Project::Settings::Members.perform do |page|
+          page.add_member(user.username)
+        end
+
+        Resource::Issue.fabricate_via_browser_ui! do |issue|
+          issue.title = issue_title
+          issue.project = project
+        end
+
+        Page::Project::Issue::Show.perform do |show_page|
+          show_page.select_all_activities_filter
+          show_page.comment('cc-ing you here @eve')
+
+          expect do
+            expect(show_page).to have_content("cc-ing you here")
+          end.not_to raise_error # Selenium::WebDriver::Error::UnhandledAlertError
+        end
+      end
+    end
+  end
+end

From 34b2ad373bc8a4b3e8ce138c1cdb56241acd840c Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Thu, 4 Jul 2019 06:24:39 +0000
Subject: [PATCH 038/195] Resolve proclems with issues documentation

Change csv import section to bullet list, add back missing
bulk import section, and resolve minor issues raised in
https://gitlab.com/gitlab-org/gitlab-ce/issues/64102
---
 doc/user/project/issues/csv_import.md      | 54 ++++++++--------------
 doc/user/project/issues/due_dates.md       |  4 +-
 doc/user/project/issues/index.md           |  2 +-
 doc/user/project/issues/managing_issues.md | 25 +++++++++-
 4 files changed, 46 insertions(+), 39 deletions(-)

diff --git a/doc/user/project/issues/csv_import.md b/doc/user/project/issues/csv_import.md
index e1e58e5ab24..cc0d5ac9028 100644
--- a/doc/user/project/issues/csv_import.md
+++ b/doc/user/project/issues/csv_import.md
@@ -29,42 +29,22 @@ to you once the import is complete.
 
 ## CSV file format
 
-Sample CSV file data: 
+When importing issues from a CSV file, it must be formatted in a certain way:
 
-CSV files must contain a header row where the first column header is `title` and the second is `description`.
-If additional columns are present, they will be ignored.
+- **header row:** CSV files must contain a header row where the first column header
+  is `title` and the second is `description`. If additional columns are present, they
+  will be ignored.
+- **separators:** The column separator is automatically detected from the header row.
+  Supported separator characters are: commas (`,`), semicolons (`;`), and tabs (`\t`).
+  The row separator can be either `CRLF` or `LF`.
+- **double-quote character:** The double-quote (`"`) character is used to quote fields,
+  enabling the use of the column separator within a field (see the third line in the
+  sample CSV data below). To insert a double-quote (`"`) within a quoted
+  field, use two double-quote characters in succession, i.e. `""`.
+- **data rows:** After the header row, succeeding rows must follow the same column
+  order. The issue title is required while the description is optional.
 
-### Header row
-
-CSV files must contain a header row beginning with at least two columns, `title` and
-`description`, in that order. If additional columns are present, they will be ignored.
-
-### Separators
-
-The column separator is automatically detected from the header row. Supported separator
-characters are: commas (`,`), semicolons (`;`), and tabs (`\t`).
-
-The row separator can be either `CRLF` or `LF`.
-
-### Quote character
-
-The double-quote (`"`) character is used to quote fields, enabling the use of the column
-separator within a field (see the third line in the [sample CSV](#csv-file-format)).
-To insert a double-quote (`"`) within a quoted field, use two double-quote characters
-in succession, i.e. `""`.
-
-### Data rows
-
-After the header row, succeeding rows must follow the same column order. The issue
-title is required while the description is optional.
-
-### File size
-
-The limit depends on the configuration value of Max Attachment Size for the GitLab instance.
-
-For GitLab.com, it is set to 10 MB.
-
-## Sample data
+Sample CSV data:
 
 ```csv
 title,description
@@ -72,3 +52,9 @@ My Issue Title,My Issue Description
 Another Title,"A description, with a comma"
 "One More Title","One More Description"
 ```
+
+### File size
+
+The limit depends on the configuration value of Max Attachment Size for the GitLab instance.
+
+For GitLab.com, it is set to 10 MB.
diff --git a/doc/user/project/issues/due_dates.md b/doc/user/project/issues/due_dates.md
index be577b3f24c..bd3298497d2 100644
--- a/doc/user/project/issues/due_dates.md
+++ b/doc/user/project/issues/due_dates.md
@@ -39,10 +39,10 @@ Due dates also appear in your [todos list](../../../workflow/todos.md).
 
 The day before an open issue is due, an email will be sent to all participants
 of the issue. Like the due date, the "day before the due date" is determined by the
-server's timezone, ignoring the participants' timezones.
+server's timezone.
 
 Issues with due dates can also be exported as an iCalendar feed. The URL of the
-feed can be added to many calendar applications. The feed is accessible by clicking
+feed can be added to calendar applications. The feed is accessible by clicking
 on the **Subscribe to calendar** button on the following pages:
 
 - on the **Assigned Issues** page that is linked on the right-hand side of the GitLab header
diff --git a/doc/user/project/issues/index.md b/doc/user/project/issues/index.md
index 86c2f2f3959..f69b841e908 100644
--- a/doc/user/project/issues/index.md
+++ b/doc/user/project/issues/index.md
@@ -144,7 +144,7 @@ message in the Activity stream about the reference, with a link to the other iss
 To prevent duplication of issues for the same topic, GitLab searches for similar issues
 when new issues are being created.
 
-When typing in the title in the new issue form, GitLab searches titles and descriptions
+When typing in the title in the **New Issue** page, GitLab searches titles and descriptions
 across all issues the user has access to in the current project. Up 5 similar issues,
 sorted by most recently updated, are displayed below the title box. Note that this feature
 requires [GraphQL](../../../api/graphql/index.md) to be enabled.
diff --git a/doc/user/project/issues/managing_issues.md b/doc/user/project/issues/managing_issues.md
index 663bacf4a45..91dbf0d848e 100644
--- a/doc/user/project/issues/managing_issues.md
+++ b/doc/user/project/issues/managing_issues.md
@@ -111,6 +111,27 @@ The "Move issue" button is at the bottom of the right-sidebar when viewing the i
 
 ![move issue - button](img/sidebar_move_issue.png)
 
+### Moving Issues in Bulk
+
+If you have advanced technical skills you can also bulk move all the issues from one project to another in the rails console. The below script will move all the issues from one project to another that are not in status **closed**.
+
+To access rails console run `sudo gitlab-rails console` on the GitLab server and run the below script. Please be sure to change **project**, **admin_user** and **target_project** to your values. We do also recommend [creating a backup](https://docs.gitlab.com/ee/raketasks/backup_restore.html#creating-a-backup-of-the-gitlab-system) before attempting any changes in the console.
+
+```ruby
+project = Project.find_by_full_path('full path of the project where issues are moved from')
+issues = project.issues
+admin_user = User.find_by_username('username of admin user') # make sure user has permissions to move the issues
+target_project = Project.find_by_full_path('full path of target project where issues moved to')
+
+issues.each do |issue|
+   if issue.state != "closed" && issue.moved_to.nil?
+      Issues::MoveService.new(project, admin_user).execute(issue, target_project)
+   else
+      puts "issue with id: #{issue.id} and title: #{issue.title} was not moved"
+   end
+end; nil
+```
+
 ## Closing Issues
 
 When you decide that an issue is resolved, or no longer needed, you can close the issue
@@ -190,7 +211,7 @@ when used from the command line with `git commit -m`.
 
 #### Customizing the issue closing pattern **[CORE ONLY]**
 
-In order to change the default issue closing pattern, you must edit the
+In order to change the default issue closing pattern, GitLab administrators must edit the
 [`gitlab.rb` or `gitlab.yml` file](../../../administration/issue_closing_pattern.md)
 of your installation.
 
@@ -199,6 +220,6 @@ of your installation.
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/2982) in GitLab 8.6
 
 Users with [project owner permission](../../permissions.md) can delete an issue by
-editing it and clicking on the delete button. 
+editing it and clicking on the delete button.
 
 ![delete issue - button](img/delete_issue.png)

From df3a0f261360b319d553c7122ac1e7abe6099de0 Mon Sep 17 00:00:00 2001
From: Shinya Maeda <shinya@gitlab.com>
Date: Wed, 26 Jun 2019 18:58:24 +0700
Subject: [PATCH 039/195] Fix MWPS system notes shows inconsistent sha

Fix the system note service
---
 .../auto_merge/merge_when_pipeline_succeeds_service.rb       | 2 +-
 app/services/system_note_service.rb                          | 4 ++--
 spec/services/auto_merge/base_service_spec.rb                | 5 +++++
 .../auto_merge/merge_when_pipeline_succeeds_service_spec.rb  | 5 ++++-
 spec/services/system_note_service_spec.rb                    | 2 +-
 5 files changed, 13 insertions(+), 5 deletions(-)

diff --git a/app/services/auto_merge/merge_when_pipeline_succeeds_service.rb b/app/services/auto_merge/merge_when_pipeline_succeeds_service.rb
index c41073a73e9..cde8c19e8fc 100644
--- a/app/services/auto_merge/merge_when_pipeline_succeeds_service.rb
+++ b/app/services/auto_merge/merge_when_pipeline_succeeds_service.rb
@@ -5,7 +5,7 @@ module AutoMerge
     def execute(merge_request)
       super do
         if merge_request.saved_change_to_auto_merge_enabled?
-          SystemNoteService.merge_when_pipeline_succeeds(merge_request, project, current_user, merge_request.diff_head_commit)
+          SystemNoteService.merge_when_pipeline_succeeds(merge_request, project, current_user, merge_request.actual_head_pipeline.sha)
         end
       end
     end
diff --git a/app/services/system_note_service.rb b/app/services/system_note_service.rb
index 237ddbcf2c2..4783417ad6d 100644
--- a/app/services/system_note_service.rb
+++ b/app/services/system_note_service.rb
@@ -221,8 +221,8 @@ module SystemNoteService
   end
 
   # Called when 'merge when pipeline succeeds' is executed
-  def merge_when_pipeline_succeeds(noteable, project, author, last_commit)
-    body = "enabled an automatic merge when the pipeline for #{last_commit.to_reference(project)} succeeds"
+  def merge_when_pipeline_succeeds(noteable, project, author, sha)
+    body = "enabled an automatic merge when the pipeline for #{sha} succeeds"
 
     create_note(NoteSummary.new(noteable, project, author, body, action: 'merge'))
   end
diff --git a/spec/services/auto_merge/base_service_spec.rb b/spec/services/auto_merge/base_service_spec.rb
index cd08e0b6f32..24cb63a0d61 100644
--- a/spec/services/auto_merge/base_service_spec.rb
+++ b/spec/services/auto_merge/base_service_spec.rb
@@ -59,6 +59,11 @@ describe AutoMerge::BaseService do
     context 'when strategy is merge when pipeline succeeds' do
       let(:service) { AutoMerge::MergeWhenPipelineSucceedsService.new(project, user) }
 
+      before do
+        pipeline = build(:ci_pipeline)
+        allow(merge_request).to receive(:actual_head_pipeline) { pipeline }
+      end
+
       it 'sets the auto merge strategy' do
         subject
 
diff --git a/spec/services/auto_merge/merge_when_pipeline_succeeds_service_spec.rb b/spec/services/auto_merge/merge_when_pipeline_succeeds_service_spec.rb
index a20bf8e17e4..5e84ef052ce 100644
--- a/spec/services/auto_merge/merge_when_pipeline_succeeds_service_spec.rb
+++ b/spec/services/auto_merge/merge_when_pipeline_succeeds_service_spec.rb
@@ -64,8 +64,11 @@ describe AutoMerge::MergeWhenPipelineSucceedsService do
       end
 
       it 'creates a system note' do
+        pipeline = build(:ci_pipeline)
+        allow(merge_request).to receive(:actual_head_pipeline) { pipeline }
+
         note = merge_request.notes.last
-        expect(note.note).to match %r{enabled an automatic merge when the pipeline for (\w+/\w+@)?\h{8}}
+        expect(note.note).to match "enabled an automatic merge when the pipeline for #{pipeline.sha}"
       end
     end
 
diff --git a/spec/services/system_note_service_spec.rb b/spec/services/system_note_service_spec.rb
index 2a2547f9400..9f60e49290e 100644
--- a/spec/services/system_note_service_spec.rb
+++ b/spec/services/system_note_service_spec.rb
@@ -332,7 +332,7 @@ describe SystemNoteService do
       create(:merge_request, source_project: project, target_project: project)
     end
 
-    subject { described_class.merge_when_pipeline_succeeds(noteable, project, author, noteable.diff_head_commit) }
+    subject { described_class.merge_when_pipeline_succeeds(noteable, project, author, pipeline.sha) }
 
     it_behaves_like 'a system note' do
       let(:action) { 'merge' }

From 152a100a188a7b7abfdaba27ceec8d3156fb6ab5 Mon Sep 17 00:00:00 2001
From: Pirate Praveen <praveen@debian.org>
Date: Thu, 4 Jul 2019 09:06:06 +0200
Subject: [PATCH 040/195] Update net-ssh gem to ~> 5.2

---
 Gemfile      | 2 +-
 Gemfile.lock | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Gemfile b/Gemfile
index 1264d75eac6..a37b65f459c 100644
--- a/Gemfile
+++ b/Gemfile
@@ -419,7 +419,7 @@ gem 'vmstat', '~> 2.3.0'
 gem 'sys-filesystem', '~> 1.1.6'
 
 # SSH host key support
-gem 'net-ssh', '~> 5.0'
+gem 'net-ssh', '~> 5.2'
 gem 'sshkey', '~> 2.0'
 
 # Required for ED25519 SSH host key support
diff --git a/Gemfile.lock b/Gemfile.lock
index 5b648d43137..8b548c08f92 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -515,7 +515,7 @@ GEM
     mysql2 (0.4.10)
     nakayoshi_fork (0.0.4)
     net-ldap (0.16.0)
-    net-ssh (5.0.1)
+    net-ssh (5.2.0)
     netrc (0.11.0)
     nio4r (2.3.1)
     nokogiri (1.10.3)
@@ -1142,7 +1142,7 @@ DEPENDENCIES
   mysql2 (~> 0.4.10)
   nakayoshi_fork (~> 0.0.4)
   net-ldap
-  net-ssh (~> 5.0)
+  net-ssh (~> 5.2)
   nokogiri (~> 1.10.3)
   oauth2 (~> 1.4)
   octokit (~> 4.9)

From aed3fadb556a120ad4b4efda173c460d0af9bded Mon Sep 17 00:00:00 2001
From: Alexander Tanayno <atanayno@gitlab.com>
Date: Thu, 4 Jul 2019 07:24:11 +0000
Subject: [PATCH 041/195] Replace the variable DOCKER_AUTH_LOGIN with
 DOCKER_AUTH_CONFIG

---
 doc/ci/docker/using_docker_images.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/doc/ci/docker/using_docker_images.md b/doc/ci/docker/using_docker_images.md
index e012f4f8595..816bd35018a 100644
--- a/doc/ci/docker/using_docker_images.md
+++ b/doc/ci/docker/using_docker_images.md
@@ -489,17 +489,17 @@ runtime.
 ### Using statically-defined credentials
 There are two approaches that you can take in order to access a
 private registry. Both require setting the environment variable
-`DOCKER_AUTH_LOGIN` with appropriate authentication info.
+`DOCKER_AUTH_CONFIG` with appropriate authentication info.
 
 1. Per-job: To configure one job to access a private registry, add
-   `DOCKER_AUTH_LOGIN` as a job variable.
+   `DOCKER_AUTH_CONFIG` as a job variable.
 1. Per-runner: To configure a Runner so all its jobs can access a
-   private registry, add `DOCKER_AUTH_LOGIN` to the environment in the
+   private registry, add `DOCKER_AUTH_CONFIG` to the environment in the
    Runner's configuration.
 
 See below for examples of each.
 
-#### Determining your `DOCKER_AUTH_LOGIN` data
+#### Determining your `DOCKER_AUTH_CONFIG` data
 
 As an example, let's assume that you want to use the `registry.example.com:5000/private/image:latest`
 image which is private and requires you to login into a private container registry.

From c1d09cfdfdcdcc2b36450b262826b18acdfd698e Mon Sep 17 00:00:00 2001
From: Tomislav Nikic <tnikic@gitlab.com>
Date: Thu, 4 Jul 2019 09:44:35 +0200
Subject: [PATCH 042/195] Removing Quarantine tag after testing

Tested the two tests inside the suite,
both passed and thus are being
dequarantined.
---
 .../merge_request/view_merge_request_diff_patch_spec.rb        | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/qa/qa/specs/features/browser_ui/3_create/merge_request/view_merge_request_diff_patch_spec.rb b/qa/qa/specs/features/browser_ui/3_create/merge_request/view_merge_request_diff_patch_spec.rb
index db33c6330ff..9e48ee7ca2a 100644
--- a/qa/qa/specs/features/browser_ui/3_create/merge_request/view_merge_request_diff_patch_spec.rb
+++ b/qa/qa/specs/features/browser_ui/3_create/merge_request/view_merge_request_diff_patch_spec.rb
@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 module QA
-  # https://gitlab.com/gitlab-org/quality/staging/issues/55
-  context 'Create', :quarantine do
+  context 'Create' do
     describe 'Download merge request patch and diff' do
       before(:context) do
         Runtime::Browser.visit(:gitlab, Page::Main::Login)

From 9ef0c8559de925d0a72a3fe421d95209c2b81d8f Mon Sep 17 00:00:00 2001
From: Nick Thomas <nick@gitlab.com>
Date: Wed, 3 Jul 2019 14:46:13 +0100
Subject: [PATCH 043/195] Clarify documentation of Gitlab::SidekiqStatus

The "running" state is ambiguous. Clarify that it covers both enqueued
and actually running jobs.
---
 lib/gitlab/sidekiq_status.rb | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/lib/gitlab/sidekiq_status.rb b/lib/gitlab/sidekiq_status.rb
index 583a970bf4e..0f890a12134 100644
--- a/lib/gitlab/sidekiq_status.rb
+++ b/lib/gitlab/sidekiq_status.rb
@@ -53,14 +53,14 @@ module Gitlab
       self.num_running(job_ids).zero?
     end
 
-    # Returns true if the given job is running
+    # Returns true if the given job is running or enqueued.
     #
     # job_id - The Sidekiq job ID to check.
     def self.running?(job_id)
       num_running([job_id]) > 0
     end
 
-    # Returns the number of jobs that are running.
+    # Returns the number of jobs that are running or enqueued.
     #
     # job_ids - The Sidekiq job IDs to check.
     def self.num_running(job_ids)
@@ -81,7 +81,7 @@ module Gitlab
     # job_ids - The Sidekiq job IDs to check.
     #
     # Returns an array of true or false indicating job completion.
-    # true = job is still running
+    # true = job is still running or enqueued
     # false = job completed
     def self.job_status(job_ids)
       keys = job_ids.map { |jid| key_for(jid) }

From 381468d0cc6e5b528a4b2207c0a534569035a73f Mon Sep 17 00:00:00 2001
From: Nick Thomas <nick@gitlab.com>
Date: Fri, 21 Jun 2019 17:56:47 +0100
Subject: [PATCH 044/195] Allow asynchronous rebase operations to be monitored

This MR introduces tracking of the `rebase_jid` for merge requests. As
with `merge_ongoing?`, `rebase_in_progress?` will now return true if a
rebase is proceeding in sidekiq.

After one release, we should remove the Gitaly-based lookup of rebases.
It is much better to track this kind of thing via the database.
---
 .../projects/merge_requests_controller.rb     |   2 +-
 app/models/merge_request.rb                   |  28 ++++-
 app/services/merge_requests/rebase_service.rb |   4 +-
 app/workers/rebase_worker.rb                  |   2 +
 .../unreleased/54117-transactional-rebase.yml |   5 +
 ...0621151636_add_merge_request_rebase_jid.rb |   9 ++
 db/schema.rb                                  |   1 +
 doc/api/merge_requests.md                     |  10 +-
 lib/api/api.rb                                |   5 +-
 lib/api/merge_requests.rb                     |   3 +-
 lib/gitlab/import_export/import_export.yml    |   1 +
 spec/models/merge_request_spec.rb             | 115 ++++++++++++++----
 spec/requests/api/merge_requests_spec.rb      |  13 ++
 .../merge_requests/rebase_service_spec.rb     |  28 +++--
 14 files changed, 188 insertions(+), 38 deletions(-)
 create mode 100644 changelogs/unreleased/54117-transactional-rebase.yml
 create mode 100644 db/migrate/20190621151636_add_merge_request_rebase_jid.rb

diff --git a/app/controllers/projects/merge_requests_controller.rb b/app/controllers/projects/merge_requests_controller.rb
index 7ee8e0ea8f8..2aa2508be16 100644
--- a/app/controllers/projects/merge_requests_controller.rb
+++ b/app/controllers/projects/merge_requests_controller.rb
@@ -201,7 +201,7 @@ class Projects::MergeRequestsController < Projects::MergeRequests::ApplicationCo
   end
 
   def rebase
-    RebaseWorker.perform_async(@merge_request.id, current_user.id)
+    @merge_request.rebase_async(current_user.id)
 
     head :ok
   end
diff --git a/app/models/merge_request.rb b/app/models/merge_request.rb
index 8391d526d18..e96e26cc773 100644
--- a/app/models/merge_request.rb
+++ b/app/models/merge_request.rb
@@ -223,7 +223,13 @@ class MergeRequest < ApplicationRecord
   end
 
   def rebase_in_progress?
-    strong_memoize(:rebase_in_progress) do
+    (rebase_jid.present? && Gitlab::SidekiqStatus.running?(rebase_jid)) ||
+      gitaly_rebase_in_progress?
+  end
+
+  # TODO: remove the Gitaly lookup after v12.1, when rebase_jid will be reliable
+  def gitaly_rebase_in_progress?
+    strong_memoize(:gitaly_rebase_in_progress) do
       # The source project can be deleted
       next false unless source_project
 
@@ -389,6 +395,26 @@ class MergeRequest < ApplicationRecord
     update_column(:merge_jid, jid)
   end
 
+  # Set off a rebase asynchronously, atomically updating the `rebase_jid` of
+  # the MR so that the status of the operation can be tracked.
+  def rebase_async(user_id)
+    transaction do
+      lock!
+
+      raise ActiveRecord::StaleObjectError if !open? || rebase_in_progress?
+
+      # Although there is a race between setting rebase_jid here and clearing it
+      # in the RebaseWorker, it can't do any harm since we check both that the
+      # attribute is set *and* that the sidekiq job is still running. So a JID
+      # for a completed RebaseWorker is equivalent to a nil JID.
+      jid = Sidekiq::Worker.skipping_transaction_check do
+        RebaseWorker.perform_async(id, user_id)
+      end
+
+      update_column(:rebase_jid, jid)
+    end
+  end
+
   def merge_participants
     participants = [author]
 
diff --git a/app/services/merge_requests/rebase_service.rb b/app/services/merge_requests/rebase_service.rb
index 4b9921c28ba..8d3b9b05819 100644
--- a/app/services/merge_requests/rebase_service.rb
+++ b/app/services/merge_requests/rebase_service.rb
@@ -15,7 +15,7 @@ module MergeRequests
     end
 
     def rebase
-      if merge_request.rebase_in_progress?
+      if merge_request.gitaly_rebase_in_progress?
         log_error('Rebase task canceled: Another rebase is already in progress', save_message_on_model: true)
         return false
       end
@@ -27,6 +27,8 @@ module MergeRequests
       log_error(REBASE_ERROR, save_message_on_model: true)
       log_error(e.message)
       false
+    ensure
+      merge_request.update_column(:rebase_jid, nil)
     end
   end
 end
diff --git a/app/workers/rebase_worker.rb b/app/workers/rebase_worker.rb
index a6baebc1443..8d06adcd993 100644
--- a/app/workers/rebase_worker.rb
+++ b/app/workers/rebase_worker.rb
@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+# The RebaseWorker must be wrapped in important concurrency code, so should only
+# be scheduled via MergeRequest#rebase_async
 class RebaseWorker
   include ApplicationWorker
 
diff --git a/changelogs/unreleased/54117-transactional-rebase.yml b/changelogs/unreleased/54117-transactional-rebase.yml
new file mode 100644
index 00000000000..d0c93114c49
--- /dev/null
+++ b/changelogs/unreleased/54117-transactional-rebase.yml
@@ -0,0 +1,5 @@
+---
+title: Allow asynchronous rebase operations to be monitored
+merge_request: 29940
+author:
+type: fixed
diff --git a/db/migrate/20190621151636_add_merge_request_rebase_jid.rb b/db/migrate/20190621151636_add_merge_request_rebase_jid.rb
new file mode 100644
index 00000000000..1fed5690ead
--- /dev/null
+++ b/db/migrate/20190621151636_add_merge_request_rebase_jid.rb
@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+class AddMergeRequestRebaseJid < ActiveRecord::Migration[5.1]
+  DOWNTIME = false
+
+  def change
+    add_column :merge_requests, :rebase_jid, :string
+  end
+end
diff --git a/db/schema.rb b/db/schema.rb
index 4bcc8b5f1d7..9cc45bb1e47 100644
--- a/db/schema.rb
+++ b/db/schema.rb
@@ -1989,6 +1989,7 @@ ActiveRecord::Schema.define(version: 20190628185004) do
     t.boolean "allow_maintainer_to_push"
     t.integer "state_id", limit: 2
     t.integer "approvals_before_merge"
+    t.string "rebase_jid"
     t.index ["assignee_id"], name: "index_merge_requests_on_assignee_id", using: :btree
     t.index ["author_id"], name: "index_merge_requests_on_author_id", using: :btree
     t.index ["created_at"], name: "index_merge_requests_on_created_at", using: :btree
diff --git a/doc/api/merge_requests.md b/doc/api/merge_requests.md
index 69db9f97a35..5a20db4b647 100644
--- a/doc/api/merge_requests.md
+++ b/doc/api/merge_requests.md
@@ -1485,8 +1485,14 @@ PUT /projects/:id/merge_requests/:merge_request_iid/rebase
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/projects/76/merge_requests/1/rebase
 ```
 
-This is an asynchronous request. The API will return an empty `202 Accepted`
-response if the request is enqueued successfully.
+This is an asynchronous request. The API will return a `202 Accepted` response
+if the request is enqueued successfully, with a response containing:
+
+```json
+{
+  "rebase_in_progress": true
+}
+```
 
 You can poll the [Get single MR](#get-single-mr) endpoint with the
 `include_rebase_in_progress` parameter to check the status of the
diff --git a/lib/api/api.rb b/lib/api/api.rb
index 20f8c637274..42499c5b41e 100644
--- a/lib/api/api.rb
+++ b/lib/api/api.rb
@@ -52,7 +52,10 @@ module API
       rack_response({ 'message' => '404 Not found' }.to_json, 404)
     end
 
-    rescue_from ::Gitlab::ExclusiveLeaseHelpers::FailedToObtainLockError do
+    rescue_from(
+      ::ActiveRecord::StaleObjectError,
+      ::Gitlab::ExclusiveLeaseHelpers::FailedToObtainLockError
+    ) do
       rack_response({ 'message' => '409 Conflict: Resource lock' }.to_json, 409)
     end
 
diff --git a/lib/api/merge_requests.rb b/lib/api/merge_requests.rb
index 6b8c1a2c0e8..64ee82cd775 100644
--- a/lib/api/merge_requests.rb
+++ b/lib/api/merge_requests.rb
@@ -429,9 +429,10 @@ module API
 
         authorize_push_to_merge_request!(merge_request)
 
-        RebaseWorker.perform_async(merge_request.id, current_user.id)
+        merge_request.rebase_async(current_user.id)
 
         status :accepted
+        present rebase_in_progress: merge_request.rebase_in_progress?
       end
 
       desc 'List issues that will be closed on merge' do
diff --git a/lib/gitlab/import_export/import_export.yml b/lib/gitlab/import_export/import_export.yml
index a0fb051e806..01437c67fa9 100644
--- a/lib/gitlab/import_export/import_export.yml
+++ b/lib/gitlab/import_export/import_export.yml
@@ -160,6 +160,7 @@ excluded_attributes:
     - :milestone_id
     - :ref_fetched
     - :merge_jid
+    - :rebase_jid
     - :latest_merge_request_diff_id
   award_emoji:
     - :awardable_id
diff --git a/spec/models/merge_request_spec.rb b/spec/models/merge_request_spec.rb
index a2547755510..fe6d68aff3f 100644
--- a/spec/models/merge_request_spec.rb
+++ b/spec/models/merge_request_spec.rb
@@ -7,6 +7,8 @@ describe MergeRequest do
   include ProjectForksHelper
   include ReactiveCachingHelpers
 
+  using RSpec::Parameterized::TableSyntax
+
   subject { create(:merge_request) }
 
   describe 'associations' do
@@ -1996,6 +1998,47 @@ describe MergeRequest do
     end
   end
 
+  describe '#rebase_async' do
+    let(:merge_request) { create(:merge_request) }
+    let(:user_id) { double(:user_id) }
+    let(:rebase_jid) { 'rebase-jid' }
+
+    subject(:execute) { merge_request.rebase_async(user_id) }
+
+    it 'atomically enqueues a RebaseWorker job and updates rebase_jid' do
+      expect(RebaseWorker)
+        .to receive(:perform_async)
+        .with(merge_request.id, user_id)
+        .and_return(rebase_jid)
+
+      expect(merge_request).to receive(:lock!).and_call_original
+
+      execute
+
+      expect(merge_request.rebase_jid).to eq(rebase_jid)
+    end
+
+    it 'refuses to enqueue a job if a rebase is in progress' do
+      merge_request.update_column(:rebase_jid, rebase_jid)
+
+      expect(RebaseWorker).not_to receive(:perform_async)
+      expect(Gitlab::SidekiqStatus)
+        .to receive(:running?)
+        .with(rebase_jid)
+        .and_return(true)
+
+      expect { execute }.to raise_error(ActiveRecord::StaleObjectError)
+    end
+
+    it 'refuses to enqueue a job if the MR is not open' do
+      merge_request.update_column(:state, 'foo')
+
+      expect(RebaseWorker).not_to receive(:perform_async)
+
+      expect { execute }.to raise_error(ActiveRecord::StaleObjectError)
+    end
+  end
+
   describe '#mergeable?' do
     let(:project) { create(:project) }
 
@@ -2946,40 +2989,64 @@ describe MergeRequest do
   end
 
   describe '#rebase_in_progress?' do
-    shared_examples 'checking whether a rebase is in progress' do
-      let(:repo_path) do
-        Gitlab::GitalyClient::StorageSettings.allow_disk_access do
-          subject.source_project.repository.path
-        end
+    where(:rebase_jid, :jid_valid, :result) do
+      'foo' | true  | true
+      'foo' | false | false
+      ''    | true  | false
+      nil   | true  | false
+    end
+
+    with_them do
+      let(:merge_request) { create(:merge_request) }
+
+      subject { merge_request.rebase_in_progress? }
+
+      it do
+        # Stub out the legacy gitaly implementation
+        allow(merge_request).to receive(:gitaly_rebase_in_progress?) { false }
+
+        allow(Gitlab::SidekiqStatus).to receive(:running?).with(rebase_jid) { jid_valid }
+
+        merge_request.rebase_jid = rebase_jid
+
+        is_expected.to eq(result)
       end
-      let(:rebase_path) { File.join(repo_path, "gitlab-worktree", "rebase-#{subject.id}") }
+    end
+  end
 
-      before do
-        system(*%W(#{Gitlab.config.git.bin_path} -C #{repo_path} worktree add --detach #{rebase_path} master))
+  describe '#gitaly_rebase_in_progress?' do
+    let(:repo_path) do
+      Gitlab::GitalyClient::StorageSettings.allow_disk_access do
+        subject.source_project.repository.path
       end
+    end
+    let(:rebase_path) { File.join(repo_path, "gitlab-worktree", "rebase-#{subject.id}") }
 
-      it 'returns true when there is a current rebase directory' do
-        expect(subject.rebase_in_progress?).to be_truthy
-      end
+    before do
+      system(*%W(#{Gitlab.config.git.bin_path} -C #{repo_path} worktree add --detach #{rebase_path} master))
+    end
 
-      it 'returns false when there is no rebase directory' do
-        FileUtils.rm_rf(rebase_path)
+    it 'returns true when there is a current rebase directory' do
+      expect(subject.rebase_in_progress?).to be_truthy
+    end
 
-        expect(subject.rebase_in_progress?).to be_falsey
-      end
+    it 'returns false when there is no rebase directory' do
+      FileUtils.rm_rf(rebase_path)
 
-      it 'returns false when the rebase directory has expired' do
-        time = 20.minutes.ago.to_time
-        File.utime(time, time, rebase_path)
+      expect(subject.rebase_in_progress?).to be_falsey
+    end
 
-        expect(subject.rebase_in_progress?).to be_falsey
-      end
+    it 'returns false when the rebase directory has expired' do
+      time = 20.minutes.ago.to_time
+      File.utime(time, time, rebase_path)
 
-      it 'returns false when the source project has been removed' do
-        allow(subject).to receive(:source_project).and_return(nil)
+      expect(subject.rebase_in_progress?).to be_falsey
+    end
 
-        expect(subject.rebase_in_progress?).to be_falsey
-      end
+    it 'returns false when the source project has been removed' do
+      allow(subject).to receive(:source_project).and_return(nil)
+
+      expect(subject.rebase_in_progress?).to be_falsey
     end
   end
 
diff --git a/spec/requests/api/merge_requests_spec.rb b/spec/requests/api/merge_requests_spec.rb
index a82ecb4fd63..ced853caab4 100644
--- a/spec/requests/api/merge_requests_spec.rb
+++ b/spec/requests/api/merge_requests_spec.rb
@@ -2033,6 +2033,9 @@ describe API::MergeRequests do
 
       expect(response).to have_gitlab_http_status(202)
       expect(RebaseWorker.jobs.size).to eq(1)
+
+      expect(merge_request.reload).to be_rebase_in_progress
+      expect(json_response['rebase_in_progress']).to be(true)
     end
 
     it 'returns 403 if the user cannot push to the branch' do
@@ -2043,6 +2046,16 @@ describe API::MergeRequests do
 
       expect(response).to have_gitlab_http_status(403)
     end
+
+    it 'returns 409 if a rebase is already in progress' do
+      Sidekiq::Testing.fake! do
+        merge_request.rebase_async(user.id)
+
+        put api("/projects/#{project.id}/merge_requests/#{merge_request.iid}/rebase", user)
+      end
+
+      expect(response).to have_gitlab_http_status(409)
+    end
   end
 
   describe 'Time tracking' do
diff --git a/spec/services/merge_requests/rebase_service_spec.rb b/spec/services/merge_requests/rebase_service_spec.rb
index 7e2f03d1097..ee9caaf2f47 100644
--- a/spec/services/merge_requests/rebase_service_spec.rb
+++ b/spec/services/merge_requests/rebase_service_spec.rb
@@ -6,10 +6,12 @@ describe MergeRequests::RebaseService do
   include ProjectForksHelper
 
   let(:user) { create(:user) }
+  let(:rebase_jid) { 'fake-rebase-jid' }
   let(:merge_request) do
-    create(:merge_request,
+    create :merge_request,
            source_branch: 'feature_conflict',
-           target_branch: 'master')
+           target_branch: 'master',
+           rebase_jid: rebase_jid
   end
   let(:project) { merge_request.project }
   let(:repository) { project.repository.raw }
@@ -23,11 +25,11 @@ describe MergeRequests::RebaseService do
   describe '#execute' do
     context 'when another rebase is already in progress' do
       before do
-        allow(merge_request).to receive(:rebase_in_progress?).and_return(true)
+        allow(merge_request).to receive(:gitaly_rebase_in_progress?).and_return(true)
       end
 
       it 'saves the error message' do
-        subject.execute(merge_request)
+        service.execute(merge_request)
 
         expect(merge_request.reload.merge_error).to eq 'Rebase task canceled: Another rebase is already in progress'
       end
@@ -36,6 +38,13 @@ describe MergeRequests::RebaseService do
         expect(service.execute(merge_request)).to match(status: :error,
                                                         message: described_class::REBASE_ERROR)
       end
+
+      it 'clears rebase_jid' do
+        expect { service.execute(merge_request) }
+          .to change { merge_request.rebase_jid }
+          .from(rebase_jid)
+          .to(nil)
+      end
     end
 
     shared_examples 'sequence of failure and success' do
@@ -43,14 +52,19 @@ describe MergeRequests::RebaseService do
         allow(repository).to receive(:gitaly_operation_client).and_raise('Something went wrong')
 
         service.execute(merge_request)
+        merge_request.reload
 
-        expect(merge_request.reload.merge_error).to eq described_class::REBASE_ERROR
+        expect(merge_request.reload.merge_error).to eq(described_class::REBASE_ERROR)
+        expect(merge_request.rebase_jid).to eq(nil)
 
         allow(repository).to receive(:gitaly_operation_client).and_call_original
+        merge_request.update!(rebase_jid: rebase_jid)
 
         service.execute(merge_request)
+        merge_request.reload
 
-        expect(merge_request.reload.merge_error).to eq nil
+        expect(merge_request.merge_error).to eq(nil)
+        expect(merge_request.rebase_jid).to eq(nil)
       end
     end
 
@@ -72,7 +86,7 @@ describe MergeRequests::RebaseService do
       it 'saves a generic error message' do
         subject.execute(merge_request)
 
-        expect(merge_request.reload.merge_error).to eq described_class::REBASE_ERROR
+        expect(merge_request.reload.merge_error).to eq(described_class::REBASE_ERROR)
       end
 
       it 'returns an error' do

From 8ac2c3ef434db3b6437811b7a198a086cd155a38 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Thu, 4 Jul 2019 08:22:41 +0000
Subject: [PATCH 045/195] Clean up EE api docs that were merged to CE

Many small fixes to api docs which were merged from EE to CE,
and tables cleaned up, as noted in issue
https://gitlab.com/gitlab-org/gitlab-ce/issues/64072
---
 doc/api/group_boards.md          |  32 +++----
 doc/api/groups.md                | 153 ++++++++++++++++---------------
 doc/api/merge_requests.md        |   8 +-
 doc/api/namespaces.md            |   2 +-
 doc/api/notification_settings.md |   5 +-
 doc/api/pipeline_schedules.md    |  12 +--
 doc/api/projects.md              |  25 +++--
 doc/api/settings.md              |  77 ++++++++--------
 doc/api/users.md                 | 127 +++++++++++++------------
 9 files changed, 231 insertions(+), 210 deletions(-)

diff --git a/doc/api/group_boards.md b/doc/api/group_boards.md
index a677a9c9a33..4157b25477f 100644
--- a/doc/api/group_boards.md
+++ b/doc/api/group_boards.md
@@ -5,7 +5,7 @@ Every API call to group boards must be authenticated.
 If a user is not a member of a group and the group is private, a `GET`
 request will result in `404` status code.
 
-## Group Board
+## List all group issue boards in a group
 
 Lists Issue Boards in the given group.
 
@@ -71,8 +71,7 @@ Example response:
 ```
 
 Users on GitLab [Premium, Silver, or higher](https://about.gitlab.com/pricing/) will see
-different parameters, due to the ability to have multiple group boards. Refer to the table
-above to see what enpoint(s) belong to each tier.
+different parameters, due to the ability to have multiple group boards.
 
 Example response:
 
@@ -123,9 +122,9 @@ Example response:
 ]
 ```
 
-## Single board
+## Single group issue board
 
-Gets a single board.
+Gets a single group issue board.
 
 ```
 GET /groups/:id/boards/:board_id
@@ -188,7 +187,7 @@ Example response:
 ```
 
 Users on GitLab [Premium, Silver, or higher](https://about.gitlab.com/pricing/) will see
-different parameters, due to the ability to have multiple group boards:
+different parameters, due to the ability to have multiple group issue boards.s
 
 Example response:
 
@@ -237,7 +236,7 @@ Example response:
   }
 ```
 
-## Create a Group Issue Board **[PREMIUM]**
+## Create a group issue board **[PREMIUM]**
 
 Creates a Group Issue Board.
 
@@ -301,9 +300,9 @@ Example response:
   }
 ```
 
-## Update a Group Issue Board **[PREMIUM]**
+## Update a group issue board **[PREMIUM]**
 
-> [Introduced][ee-5954] in GitLab 11.1.
+> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/5954) in GitLab 11.1.
 
 Updates a Group Issue Board.
 
@@ -321,7 +320,6 @@ PUT /groups/:id/boards/:board_id
 | `labels`            | string         | no       | Comma-separated list of label names which the board should be scoped to |
 | `weight`            | integer        | no       | The weight range from 0 to 9, to which the board should be scoped to |
 
-
 ```bash
 curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/5/boards/1?name=new_name&milestone_id=44&assignee_id=1&labels=GroupLabel&weight=4
 ```
@@ -370,7 +368,7 @@ Example response:
   }
 ```
 
-## Delete a Group Issue Board **[PREMIUM]**
+## Delete a group issue board **[PREMIUM]**
 
 Deletes a Group Issue Board.
 
@@ -387,7 +385,7 @@ DELETE /groups/:id/boards/:board_id
 curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/5/boards/1
 ```
 
-## List board lists
+## List group issue board lists
 
 Get a list of the board's lists.
 Does not include `open` and `closed` lists
@@ -439,7 +437,7 @@ Example response:
 ]
 ```
 
-## Single board list
+## Single group issue board list
 
 Get a single board list.
 
@@ -471,7 +469,7 @@ Example response:
 }
 ```
 
-## New board list
+## New group issue board list
 
 Creates a new Issue Board list.
 
@@ -503,7 +501,7 @@ Example response:
 }
 ```
 
-## Edit board list
+## Edit group issue board list
 
 Updates an existing Issue Board list. This call is used to change list position.
 
@@ -536,7 +534,7 @@ Example response:
 }
 ```
 
-## Delete a board list
+## Delete a group issue board list
 
 Only for admins and group owners. Soft deletes the board list in question.
 
@@ -553,5 +551,3 @@ DELETE /groups/:id/boards/:board_id/lists/:list_id
 ```bash
 curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/5/boards/1/lists/1
 ```
-
-[ee-5954]: https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/5954
diff --git a/doc/api/groups.md b/doc/api/groups.md
index 80a2fb8e4d9..e1bf296bc41 100644
--- a/doc/api/groups.md
+++ b/doc/api/groups.md
@@ -7,17 +7,17 @@ authentication, only public groups are returned.
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `skip_groups` | array of integers | no | Skip the group IDs passed |
-| `all_available` | boolean | no | Show all the groups you have access to (defaults to `false` for authenticated users, `true` for admin); Attributes `owned` and `min_access_level` have precedence |
-| `search` | string | no | Return the list of authorized groups matching the search criteria |
-| `order_by` | string | no | Order groups by `name`, `path` or `id`. Default is `name` |
-| `sort` | string | no | Order groups in `asc` or `desc` order. Default is `asc` |
-| `statistics` | boolean | no | Include group statistics (admins only) |
-| `with_custom_attributes` | boolean | no | Include [custom attributes](custom_attributes.md) in response (admins only) |
-| `owned` | boolean | no | Limit to groups explicitly owned by the current user |
-| `min_access_level` | integer | no | Limit to groups where current user has at least this [access level](members.md) |
+| Attribute                | Type              | Required | Description |
+| ------------------------ | ----------------- | -------- | ---------- |
+| `skip_groups`            | array of integers | no       | Skip the group IDs passed |
+| `all_available`          | boolean           | no       | Show all the groups you have access to (defaults to `false` for authenticated users, `true` for admin); Attributes `owned` and `min_access_level` have precedence |
+| `search`                 | string            | no       | Return the list of authorized groups matching the search criteria |
+| `order_by`               | string            | no       | Order groups by `name`, `path` or `id`. Default is `name` |
+| `sort`                   | string            | no       | Order groups in `asc` or `desc` order. Default is `asc` |
+| `statistics`             | boolean           | no       | Include group statistics (admins only) |
+| `with_custom_attributes` | boolean           | no       | Include [custom attributes](custom_attributes.md) in response (admins only) |
+| `owned`                  | boolean           | no       | Limit to groups explicitly owned by the current user |
+| `min_access_level`       | integer           | no       | Limit to groups where current user has at least this [access level](members.md) |
 
 ```
 GET /groups
@@ -94,18 +94,18 @@ When accessed without authentication, only public groups are returned.
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id` | integer/string | yes | The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) of the parent group |
-| `skip_groups` | array of integers | no | Skip the group IDs passed |
-| `all_available` | boolean | no | Show all the groups you have access to (defaults to `false` for authenticated users, `true` for admin); Attributes `owned` and `min_access_level` have precedence |
-| `search` | string | no | Return the list of authorized groups matching the search criteria |
-| `order_by` | string | no | Order groups by `name`, `path` or `id`. Default is `name` |
-| `sort` | string | no | Order groups in `asc` or `desc` order. Default is `asc` |
-| `statistics` | boolean | no | Include group statistics (admins only) |
-| `with_custom_attributes` | boolean | no | Include [custom attributes](custom_attributes.md) in response (admins only) |
-| `owned` | boolean | no | Limit to groups explicitly owned by the current user |
-| `min_access_level` | integer | no | Limit to groups where current user has at least this [access level](members.md) |
+| Attribute                | Type              | Required | Description |
+| ------------------------ | ----------------- | -------- | ----------- |
+| `id`                     | integer/string    | yes      | The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) of the parent group |
+| `skip_groups`            | array of integers | no       | Skip the group IDs passed |
+| `all_available`          | boolean           | no       | Show all the groups you have access to (defaults to `false` for authenticated users, `true` for admin); Attributes `owned` and `min_access_level` have preceden |
+| `search`                 | string            | no       | Return the list of authorized groups matching the search criteria |
+| `order_by`               | string            | no       | Order groups by `name`, `path` or `id`. Default is `name` |
+| `sort`                   | string            | no       | Order groups in `asc` or `desc` order. Default is `asc` |
+| `statistics`             | boolean           | no       | Include group statistics (admins only) |
+| `with_custom_attributes` | boolean           | no       | Include [custom attributes](custom_attributes.md) in response (admins only) |
+| `owned`                  | boolean           | no       | Limit to groups explicitly owned by the current user |
+| `min_access_level`       | integer           | no       | Limit to groups where current user has at least this [access level](members.md) |
 
 ```
 GET /groups/:id/subgroups
@@ -142,22 +142,22 @@ GET /groups/:id/projects
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id` | integer/string | yes | The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user |
-| `archived` | boolean | no | Limit by archived status |
-| `visibility` | string | no | Limit by visibility `public`, `internal`, or `private` |
-| `order_by` | string | no | Return projects ordered by `id`, `name`, `path`, `created_at`, `updated_at`, or `last_activity_at` fields. Default is `created_at` |
-| `sort` | string | no | Return projects sorted in `asc` or `desc` order. Default is `desc` |
-| `search` | string | no | Return list of authorized projects matching the search criteria |
-| `simple` | boolean | no | Return only the ID, URL, name, and path of each project |
-| `owned` | boolean | no | Limit by projects owned by the current user |
-| `starred` | boolean | no | Limit by projects starred by the current user |
-| `with_issues_enabled` | boolean | no | Limit by projects with issues feature enabled. Default is `false` |
-| `with_merge_requests_enabled` | boolean | no | Limit by projects with merge requests feature enabled. Default is `false` |
-| `with_shared` | boolean | no | Include projects shared to this group. Default is `true` |
-| `include_subgroups` | boolean | no | Include projects in subgroups of this group. Default is `false` |
-| `with_custom_attributes` | boolean | no | Include [custom attributes](custom_attributes.md) in response (admins only) |
+| Attribute                     | Type           | Required | Description |
+| ----------------------------- | -------------- | -------- | ----------- |
+| `id`                          | integer/string | yes      | The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user |
+| `archived`                    | boolean        | no       | Limit by archived status |
+| `visibility`                  | string         | no       | Limit by visibility `public`, `internal`, or `private` |
+| `order_by`                    | string         | no       | Return projects ordered by `id`, `name`, `path`, `created_at`, `updated_at`, or `last_activity_at` fields. Default is `created_at` |
+| `sort`                        | string         | no       | Return projects sorted in `asc` or `desc` order. Default is `desc` |
+| `search`                      | string         | no       | Return list of authorized projects matching the search criteria |
+| `simple`                      | boolean        | no       | Return only the ID, URL, name, and path of each project |
+| `owned`                       | boolean        | no       | Limit by projects owned by the current user |
+| `starred`                     | boolean        | no       | Limit by projects starred by the current user |
+| `with_issues_enabled`         | boolean        | no       | Limit by projects with issues feature enabled. Default is `false` |
+| `with_merge_requests_enabled` | boolean        | no       | Limit by projects with merge requests feature enabled. Default is `false` |
+| `with_shared`                 | boolean        | no       | Include projects shared to this group. Default is `true` |
+| `include_subgroups`           | boolean        | no       | Include projects in subgroups of this group. Default is `false` |
+| `with_custom_attributes`      | boolean        | no       | Include [custom attributes](custom_attributes.md) in response (admins only) |
 
 Example response:
 
@@ -214,11 +214,11 @@ GET /groups/:id
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id` | integer/string | yes | The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user |
-| `with_custom_attributes` | boolean | no | Include [custom attributes](custom_attributes.md) in response (admins only) |
-| `with_projects` | boolean | no | Include details from projects that belong to the specified group (defaults to `true`). |
+| Attribute                | Type           | Required | Description |
+| ------------------------ | -------------- | -------- | ----------- |
+| `id`                     | integer/string | yes      | The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user. |
+| `with_custom_attributes` | boolean        | no       | Include [custom attributes](custom_attributes.md) in response (admins only). |
+| `with_projects`          | boolean        | no       | Include details from projects that belong to the specified group (defaults to `true`). |
 
 ```bash
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/4
@@ -378,11 +378,16 @@ Example response:
 Users on GitLab [Starter, Bronze, or higher](https://about.gitlab.com/pricing/) will also see
 the `shared_runners_minutes_limit` and `extra_shared_runners_minutes_limit` parameters:
 
-Additional response parameters: **[STARTER]**
+Additional response parameters:
 
 ```json
+{
+  "id": 4,
+  "description": "Aliquid qui quis dignissimos distinctio ut commodi voluptas est.",
   "shared_runners_minutes_limit": 133,
   "extra_shared_runners_minutes_limit": 133,
+  ...
+}
 ```
 
 When adding the parameter `with_projects=false`, projects will not be returned.
@@ -420,17 +425,17 @@ POST /groups
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `name`                               | string  | yes | The name of the group |
-| `path`                               | string  | yes | The path of the group |
-| `description`                        | string  | no  | The group's description |
-| `visibility`                         | string  | no  | The group's visibility. Can be `private`, `internal`, or `public`. |
-| `lfs_enabled`                        | boolean | no  | Enable/disable Large File Storage (LFS) for the projects in this group |
-| `request_access_enabled`             | boolean | no  | Allow users to request member access. |
-| `parent_id`                          | integer | no  | The parent group ID for creating nested group. |
-| `shared_runners_minutes_limit`       | integer | no  | **[STARTER ONLY]** Pipeline minutes quota for this group. |
-| `extra_shared_runners_minutes_limit` | integer | no  | **[STARTER ONLY]** Extra pipeline minutes quota for this group. |
+| Attribute                            | Type    | Required | Description |
+| ------------------------------------ | ------- | -------- | ----------- |
+| `name`                               | string  | yes      | The name of the group. |
+| `path`                               | string  | yes      | The path of the group. |
+| `description`                        | string  | no       | The group's description. |
+| `visibility`                         | string  | no       | The group's visibility. Can be `private`, `internal`, or `public`. |
+| `lfs_enabled`                        | boolean | no       | Enable/disable Large File Storage (LFS) for the projects in this group. |
+| `request_access_enabled`             | boolean | no       | Allow users to request member access. |
+| `parent_id`                          | integer | no       | The parent group ID for creating nested group. |
+| `shared_runners_minutes_limit`       | integer | no       | **[STARTER ONLY]** Pipeline minutes quota for this group. |
+| `extra_shared_runners_minutes_limit` | integer | no       | **[STARTER ONLY]** Extra pipeline minutes quota for this group. |
 
 ## Transfer project to group
 
@@ -442,10 +447,10 @@ POST  /groups/:id/projects/:project_id
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id` | integer/string | yes | The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user |
-| `project_id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) |
+| Attribute    | Type           | Required | Description |
+| ------------ | -------------- | -------- | ----------- |
+| `id`         | integer/string | yes      | The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user |
+| `project_id` | integer/string | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) |
 
 ## Update group
 
@@ -455,20 +460,20 @@ Updates the project group. Only available to group owners and administrators.
 PUT /groups/:id
 ```
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id`                                 | integer | yes | The ID of the group |
-| `name`                               | string  | no  | The name of the group |
-| `path`                               | string  | no  | The path of the group |
-| `description`                        | string  | no  | The description of the group |
-| `membership_lock`                    | boolean | no  | **[STARTER]** Prevent adding new members to project membership within this group |
-| `share_with_group_lock`              | boolean | no  | Prevent sharing a project with another group within this group |
-| `visibility`                         | string  | no  | The visibility level of the group. Can be `private`, `internal`, or `public`. |
-| `lfs_enabled` (optional)             | boolean | no  | Enable/disable Large File Storage (LFS) for the projects in this group |
-| `request_access_enabled`             | boolean | no  | Allow users to request member access. |
-| `file_template_project_id`           | integer | no  | **[PREMIUM]** The ID of a project to load custom file templates from |
-| `shared_runners_minutes_limit`       | integer | no  | **[STARTER ONLY]** Pipeline minutes quota for this group |
-| `extra_shared_runners_minutes_limit` | integer | no  | **[STARTER ONLY]** Extra pipeline minutes quota for this group |
+| Attribute                            | Type    | Required | Description |
+| ------------------------------------ | ------- | -------- | ----------- |
+| `id`                                 | integer | yes      | The ID of the group. |
+| `name`                               | string  | no       | The name of the group. |
+| `path`                               | string  | no       | The path of the group. |
+| `description`                        | string  | no       | The description of the group. |
+| `membership_lock`                    | boolean | no       | **[STARTER]** Prevent adding new members to project membership within this group. |
+| `share_with_group_lock`              | boolean | no       | Prevent sharing a project with another group within this group. |
+| `visibility`                         | string  | no       | The visibility level of the group. Can be `private`, `internal`, or `public`. |
+| `lfs_enabled` (optional)             | boolean | no       | Enable/disable Large File Storage (LFS) for the projects in this group. |
+| `request_access_enabled`             | boolean | no       | Allow users to request member access. |
+| `file_template_project_id`           | integer | no       | **[PREMIUM]** The ID of a project to load custom file templates from. |
+| `shared_runners_minutes_limit`       | integer | no       | **[STARTER ONLY]** Pipeline minutes quota for this group. |
+| `extra_shared_runners_minutes_limit` | integer | no       | **[STARTER ONLY]** Extra pipeline minutes quota for this group. |
 
 ```bash
 curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5?name=Experimental"
diff --git a/doc/api/merge_requests.md b/doc/api/merge_requests.md
index 69db9f97a35..4a00ab66446 100644
--- a/doc/api/merge_requests.md
+++ b/doc/api/merge_requests.md
@@ -850,9 +850,9 @@ If `approvals_before_merge` **[STARTER]** is not provided, it inherits the value
 target project. If it is provided, then the following conditions must hold in
 order for it to take effect:
 
-1. The target project's `approvals_before_merge` must be greater than zero. (A
-   value of zero disables approvals for that project.)
-2. The provided value of `approvals_before_merge` must be greater than the
+1. The target project's `approvals_before_merge` must be greater than zero. A
+   value of zero disables approvals for that project.
+1. The provided value of `approvals_before_merge` must be greater than the
    target project's `approvals_before_merge`.
 
 ```json
@@ -1296,7 +1296,7 @@ the `approvals_before_merge` parameter:
 
 ## Merge to default merge ref path
 
-Merge the changes between the merge request source and target branches into `refs/merge-requests/:iid/merge` 
+Merge the changes between the merge request source and target branches into `refs/merge-requests/:iid/merge`
 ref, of the target project repository, if possible. This ref will have the state the target branch would have if
 a regular merge action was taken.
 
diff --git a/doc/api/namespaces.md b/doc/api/namespaces.md
index b354e2b9ab2..5db7035fd90 100644
--- a/doc/api/namespaces.md
+++ b/doc/api/namespaces.md
@@ -68,7 +68,7 @@ the `plan` parameter associated with a namespace:
 ]
 ```
 
-**Note**: Only group maintainers/owners are presented with `members_count_with_descendants`, as well as `plan` **[BRONZE ONLY]**.
+NOTE: **Note:** Only group maintainers/owners are presented with `members_count_with_descendants`, as well as `plan` **[BRONZE ONLY]**.
 
 ## Search for namespace
 
diff --git a/doc/api/notification_settings.md b/doc/api/notification_settings.md
index 0342622f384..ccc1cccf7a4 100644
--- a/doc/api/notification_settings.md
+++ b/doc/api/notification_settings.md
@@ -1,8 +1,8 @@
 # Notification settings API
 
->**Note:** This feature was [introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/5632) in GitLab 8.12.
+> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/5632) in GitLab 8.12.
 
-**Valid notification levels**
+## Valid notification levels
 
 The notification levels are defined in the `NotificationSetting.level` model enumeration. Currently, these levels are recognized:
 
@@ -33,7 +33,6 @@ If the `custom` level is used, specific email events can be controlled. Availabl
 - `success_pipeline`
 - `new_epic` **[ULTIMATE]**
 
-
 ## Global notification settings
 
 Get current notification settings and email address.
diff --git a/doc/api/pipeline_schedules.md b/doc/api/pipeline_schedules.md
index 470e55425f8..acf1ac90315 100644
--- a/doc/api/pipeline_schedules.md
+++ b/doc/api/pipeline_schedules.md
@@ -108,9 +108,9 @@ POST /projects/:id/pipeline_schedules
 | `id`          | integer/string | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user      |
 | `description` | string  | yes      | The description of pipeline schedule         |
 | `ref` | string  | yes      | The branch/tag name will be triggered         |
-| `cron ` | string  | yes      | The cron (e.g. `0 1 * * *`) ([Cron syntax](https://en.wikipedia.org/wiki/Cron))       |
-| `cron_timezone ` | string  | no      | The timezone supported by `ActiveSupport::TimeZone` (e.g. `Pacific Time (US & Canada)`) (default: `'UTC'`)     |
-| `active ` | boolean  | no      | The activation of pipeline schedule. If false is set, the pipeline schedule will deactivated initially (default: `true`) |
+| `cron` | string  | yes      | The cron (e.g. `0 1 * * *`) ([Cron syntax](https://en.wikipedia.org/wiki/Cron))       |
+| `cron_timezone` | string  | no      | The timezone supported by `ActiveSupport::TimeZone` (e.g. `Pacific Time (US & Canada)`) (default: `'UTC'`)     |
+| `active` | boolean  | no      | The activation of pipeline schedule. If false is set, the pipeline schedule will deactivated initially (default: `true`) |
 
 ```sh
 curl --request POST --header "PRIVATE-TOKEN: k5ESFgWY2Qf5xEvDcFxZ" --form description="Build packages" --form ref="master" --form cron="0 1 * * 5" --form cron_timezone="UTC" --form active="true" "https://gitlab.example.com/api/v4/projects/29/pipeline_schedules"
@@ -153,9 +153,9 @@ PUT /projects/:id/pipeline_schedules/:pipeline_schedule_id
 | `pipeline_schedule_id`  | integer | yes      | The pipeline schedule id           |
 | `description` | string  | no      | The description of pipeline schedule         |
 | `ref` | string  | no      | The branch/tag name will be triggered         |
-| `cron ` | string  | no      | The cron (e.g. `0 1 * * *`) ([Cron syntax](https://en.wikipedia.org/wiki/Cron))       |
-| `cron_timezone ` | string  | no      | The timezone supported by `ActiveSupport::TimeZone` (e.g. `Pacific Time (US & Canada)`) or `TZInfo::Timezone` (e.g. `America/Los_Angeles`)      |
-| `active ` | boolean  | no      | The activation of pipeline schedule. If false is set, the pipeline schedule will deactivated initially. |
+| `cron` | string  | no      | The cron (e.g. `0 1 * * *`) ([Cron syntax](https://en.wikipedia.org/wiki/Cron))       |
+| `cron_timezone` | string  | no      | The timezone supported by `ActiveSupport::TimeZone` (e.g. `Pacific Time (US & Canada)`) or `TZInfo::Timezone` (e.g. `America/Los_Angeles`)      |
+| `active` | boolean  | no      | The activation of pipeline schedule. If false is set, the pipeline schedule will deactivated initially. |
 
 ```sh
 curl --request PUT --header "PRIVATE-TOKEN: k5ESFgWY2Qf5xEvDcFxZ" --form cron="0 2 * * *" "https://gitlab.example.com/api/v4/projects/29/pipeline_schedules/13"
diff --git a/doc/api/projects.md b/doc/api/projects.md
index b8ccf25581e..e07d6ce9a42 100644
--- a/doc/api/projects.md
+++ b/doc/api/projects.md
@@ -55,8 +55,8 @@ GET /projects
 | `with_issues_enabled`         | boolean | no | Limit by enabled issues feature |
 | `with_merge_requests_enabled` | boolean | no | Limit by enabled merge requests feature |
 | `with_programming_language`   | string  | no | Limit by projects which use the given programming language |
-| `wiki_checksum_failed`        | boolean | no | **[PREMIUM]** Limit projects where the wiki checksum calculation has failed *([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6137) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2)* |
-| `repository_checksum_failed`  | boolean | no | **[PREMIUM]** Limit projects where the repository checksum calculation has failed *([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6137) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2)* |
+| `wiki_checksum_failed`        | boolean | no | **[PREMIUM]** Limit projects where the wiki checksum calculation has failed ([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6137) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2) |
+| `repository_checksum_failed`  | boolean | no | **[PREMIUM]** Limit projects where the repository checksum calculation has failed ([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6137) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2) |
 | `min_access_level`            | integer | no | Limit by current user minimal [access level](members.md) |
 
 When `simple=true` or the user is unauthenticated this returns something like:
@@ -734,7 +734,7 @@ POST /projects
 | `mirror_trigger_builds` | boolean | no | **[STARTER]** Pull mirroring triggers builds |
 | `initialize_with_readme` | boolean | no | `false` by default |
 
->**Note**: If your HTTP repository is not publicly accessible,
+NOTE: **Note:** If your HTTP repository is not publicly accessible,
 add authentication information to the URL: `https://username:password@gitlab.company.com/group/project.git`
 where `password` is a public access key with the `api` scope enabled.
 
@@ -779,7 +779,7 @@ POST /projects/user/:user_id
 | `mirror` | boolean | no | **[STARTER]** Enables pull mirroring in a project |
 | `mirror_trigger_builds` | boolean | no | **[STARTER]** Pull mirroring triggers builds |
 
->**Note**: If your HTTP repository is not publicly accessible,
+NOTE: **Note:** If your HTTP repository is not publicly accessible,
 add authentication information to the URL: `https://username:password@gitlab.company.com/group/project.git`
 where `password` is a public access key with the `api` scope enabled.
 
@@ -828,7 +828,7 @@ PUT /projects/:id
 | `mirror_overwrites_diverged_branches` | boolean | no | **[STARTER]** Pull mirror overwrites diverged branches |
 | `packages_enabled` | boolean | no | **[PREMIUM ONLY]** Enable or disable packages repository feature |
 
->**Note**: If your HTTP repository is not publicly accessible,
+NOTE: **Note:** If your HTTP repository is not publicly accessible,
 add authentication information to the URL: `https://username:password@gitlab.company.com/group/project.git`
 where `password` is a public access key with the `api` scope enabled.
 
@@ -1354,7 +1354,7 @@ Example response:
 
 ## Remove project
 
-Removes a project including all associated resources (issues, merge requests etc.)
+Removes a project including all associated resources (issues, merge requests etc).
 
 ```
 DELETE /projects/:id
@@ -1643,10 +1643,17 @@ GET /projects/:id/push_rule
 }
 ```
 
-The following attributes are restricted to certain plans, and will not appear if
-you do not have access to those features:
+Users on GitLab [Premium, Silver, or higher](https://about.gitlab.com/pricing/) will also see
+the `commit_committer_check` parameter:
 
-* `commit_committer_check` only available on **[PREMIUM]**
+```json
+{
+  "id": 1,
+  "project_id": 3,
+  "commit_committer_check": false
+  ...
+}
+```
 
 ### Add project push rule
 
diff --git a/doc/api/settings.md b/doc/api/settings.md
index 876a5a75590..0f46662a8ae 100644
--- a/doc/api/settings.md
+++ b/doc/api/settings.md
@@ -68,11 +68,16 @@ Example response:
 ```
 
 Users on GitLab [Premium or Ultimate](https://about.gitlab.com/pricing/) may also see
-the `file_template_project_id` or the `geo_node_allowed_ips` parameters: **[PREMIUM ONLY]**
+the `file_template_project_id` or the `geo_node_allowed_ips` parameters:
 
 ```json
+{
+   "id" : 1,
+   "signup_enabled" : true,
    "file_template_project_id": 1,
    "geo_node_allowed_ips": "0.0.0.0/0, ::/0"
+   ...
+}
 ```
 
 ## Change application settings
@@ -169,12 +174,12 @@ are listed in the descriptions of the relevant settings.
 | `after_sign_up_text`                     | string           | no                                   | Text shown to the user after signing up |
 | `akismet_api_key`                        | string           | required by: `akismet_enabled`       | API key for akismet spam protection. |
 | `akismet_enabled`                        | boolean          | no                                   | (**If enabled, requires:** `akismet_api_key`) Enable or disable akismet spam protection. |
-| `allow_group_owners_to_manage_ldap`      | boolean          | no                                   | **[Premium]** Set to `true` to allow group owners to manage LDAP |
+| `allow_group_owners_to_manage_ldap`      | boolean          | no                                   | **[PREMIUM]** Set to `true` to allow group owners to manage LDAP |
 | `allow_local_requests_from_hooks_and_services` | boolean    | no                                   | Allow requests to the local network from hooks and services. |
 | `authorized_keys_enabled`                | boolean          | no                                   | By default, we write to the `authorized_keys` file to support Git over SSH without additional configuration. GitLab can be optimized to authenticate SSH keys via the database file. Only disable this if you have configured your OpenSSH server to use the AuthorizedKeysCommand. |
 | `auto_devops_domain`                     | string           | no                                   | Specify a domain to use by default for every project's Auto Review Apps and Auto Deploy stages. |
 | `auto_devops_enabled`                    | boolean          | no                                   | Enable Auto DevOps for projects by default. It will automatically build, test, and deploy applications based on a predefined CI/CD configuration. |
-| `check_namespace_plan`                   | boolean          | no                                   | **[Premium]** Enabling this will make only licensed EE features available to projects if the project namespace's plan includes the feature or if the project is public. |
+| `check_namespace_plan`                   | boolean          | no                                   | **[PREMIUM]** Enabling this will make only licensed EE features available to projects if the project namespace's plan includes the feature or if the project is public. |
 | `clientside_sentry_dsn`                  | string           | required by: `clientside_sentry_enabled` | Clientside Sentry Data Source Name. |
 | `clientside_sentry_enabled`              | boolean          | no                                   | (**If enabled, requires:** `clientside_sentry_dsn`) Enable Sentry error reporting for the client side. |
 | `container_registry_token_expire_delay`  | integer          | no                                   | Container Registry token duration in minutes. |
@@ -191,31 +196,31 @@ are listed in the descriptions of the relevant settings.
 | `dsa_key_restriction`                    | integer          | no                                   | The minimum allowed bit length of an uploaded DSA key. Default is `0` (no restriction). `-1` disables DSA keys. |
 | `ecdsa_key_restriction`                  | integer          | no                                   | The minimum allowed curve size (in bits) of an uploaded ECDSA key. Default is `0` (no restriction). `-1` disables ECDSA keys. |
 | `ed25519_key_restriction`                | integer          | no                                   | The minimum allowed curve size (in bits) of an uploaded ED25519 key. Default is `0` (no restriction). `-1` disables ED25519 keys. |
-| `elasticsearch_aws`                      | boolean          | no                                   | **[Premium]** Enable the use of AWS hosted Elasticsearch |
-| `elasticsearch_aws_access_key`           | string           | no                                   | **[Premium]** AWS IAM access key |
-| `elasticsearch_aws_region`               | string           | no                                   | **[Premium]** The AWS region the elasticsearch domain is configured |
-| `elasticsearch_aws_secret_access_key`    | string           | no                                   | **[Premium]** AWS IAM secret access key |
-| `elasticsearch_experimental_indexer`     | boolean          | no                                   | **[Premium]** Use the experimental elasticsearch indexer. More info: <https://gitlab.com/gitlab-org/gitlab-elasticsearch-indexer> |
-| `elasticsearch_indexing`                 | boolean          | no                                   | **[Premium]** Enable Elasticsearch indexing |
-| `elasticsearch_search`                   | boolean          | no                                   | **[Premium]** Enable Elasticsearch search |
-| `elasticsearch_url`                      | string           | no                                   | **[Premium]** The url to use for connecting to Elasticsearch. Use a comma-separated list to support cluster (e.g., `http://localhost:9200, http://localhost:9201"`). If your Elasticsearch instance is password protected, pass the `username:password` in the URL (e.g., `http://<username>:<password>@<elastic_host>:9200/`). |
-| `elasticsearch_limit_indexing`           | boolean          | no                                   | **[Premium]** Limit Elasticsearch to index certain namespaces and projects |
-| `elasticsearch_project_ids`              | array of integers | no                                  | **[Premium]** The projects to index via Elasticsearch if `elasticsearch_limit_indexing` is enabled. |
-| `elasticsearch_namespace_ids`            | array of integers | no                                  | **[Premium]** The namespaces to index via Elasticsearch if `elasticsearch_limit_indexing` is enabled. |
-| `email_additional_text`                  | string           | no                                   | **[Premium]** Additional text added to the bottom of every email for legal/auditing/compliance reasons |
+| `elasticsearch_aws`                      | boolean          | no                                   | **[PREMIUM]** Enable the use of AWS hosted Elasticsearch |
+| `elasticsearch_aws_access_key`           | string           | no                                   | **[PREMIUM]** AWS IAM access key |
+| `elasticsearch_aws_region`               | string           | no                                   | **[PREMIUM]** The AWS region the elasticsearch domain is configured |
+| `elasticsearch_aws_secret_access_key`    | string           | no                                   | **[PREMIUM]** AWS IAM secret access key |
+| `elasticsearch_experimental_indexer`     | boolean          | no                                   | **[PREMIUM]** Use the experimental elasticsearch indexer. More info: <https://gitlab.com/gitlab-org/gitlab-elasticsearch-indexer> |
+| `elasticsearch_indexing`                 | boolean          | no                                   | **[PREMIUM]** Enable Elasticsearch indexing |
+| `elasticsearch_search`                   | boolean          | no                                   | **[PREMIUM]** Enable Elasticsearch search |
+| `elasticsearch_url`                      | string           | no                                   | **[PREMIUM]** The url to use for connecting to Elasticsearch. Use a comma-separated list to support cluster (e.g., `http://localhost:9200, http://localhost:9201"`). If your Elasticsearch instance is password protected, pass the `username:password` in the URL (e.g., `http://<username>:<password>@<elastic_host>:9200/`). |
+| `elasticsearch_limit_indexing`           | boolean          | no                                   | **[PREMIUM]** Limit Elasticsearch to index certain namespaces and projects |
+| `elasticsearch_project_ids`              | array of integers | no                                  | **[PREMIUM]** The projects to index via Elasticsearch if `elasticsearch_limit_indexing` is enabled. |
+| `elasticsearch_namespace_ids`            | array of integers | no                                  | **[PREMIUM]** The namespaces to index via Elasticsearch if `elasticsearch_limit_indexing` is enabled. |
+| `email_additional_text`                  | string           | no                                   | **[PREMIUM]** Additional text added to the bottom of every email for legal/auditing/compliance reasons |
 | `email_author_in_body`                   | boolean          | no                                   | Some email servers do not support overriding the email sender name. Enable this option to include the name of the author of the issue, merge request or comment in the email body instead. |
 | `enabled_git_access_protocol`            | string           | no                                   | Enabled protocols for Git access. Allowed values are: `ssh`, `http`, and `nil` to allow both protocols. |
 | `enforce_terms`                          | boolean          | no                                   | (**If enabled, requires:** `terms`) Enforce application ToS to all users. |
-| `external_auth_client_cert`              | string           | no                                   | **[Premium]** (**If enabled, requires:** `external_auth_client_key`) The certificate to use to authenticate with the external authorization service |
-| `external_auth_client_key`               | string           | required by: `external_auth_client_cert` | **[Premium]** Private key for the certificate when authentication is required for the external authorization service, this is encrypted when stored |
-| `external_auth_client_key_pass`          | string           | no                                   | **[Premium]** Passphrase to use for the private key when authenticating with the external service this is encrypted when stored |
-| `external_authorization_service_enabled` | boolean          | no                                   | **[Premium]** (**If enabled, requires:** `external_authorization_service_default_label`, `external_authorization_service_timeout` and `external_authorization_service_url` )  Enable using an external authorization service for accessing projects |
-| `external_authorization_service_default_label` | string     | required by: `external_authorization_service_enabled` | **[Premium]** The default classification label to use when requesting authorization and no classification label has been specified on the project |
-| `external_authorization_service_timeout` | float            | required by: `external_authorization_service_enabled` | **[Premium]** The timeout after which an authorization request is aborted, in seconds. When a request times out, access is denied to the user. (min: 0.001, max: 10, step: 0.001) |
-| `external_authorization_service_url`     | string           | required by: `external_authorization_service_enabled` | **[Premium]** URL to which authorization requests will be directed |
-| `file_template_project_id`               | integer          | no                                   | **[Premium]** The ID of a project to load custom file templates from |
+| `external_auth_client_cert`              | string           | no                                   | **[PREMIUM]** (**If enabled, requires:** `external_auth_client_key`) The certificate to use to authenticate with the external authorization service |
+| `external_auth_client_key`               | string           | required by: `external_auth_client_cert` | **[PREMIUM]** Private key for the certificate when authentication is required for the external authorization service, this is encrypted when stored |
+| `external_auth_client_key_pass`          | string           | no                                   | **[PREMIUM]** Passphrase to use for the private key when authenticating with the external service this is encrypted when stored |
+| `external_authorization_service_enabled` | boolean          | no                                   | **[PREMIUM]** (**If enabled, requires:** `external_authorization_service_default_label`, `external_authorization_service_timeout` and `external_authorization_service_url` )  Enable using an external authorization service for accessing projects |
+| `external_authorization_service_default_label` | string     | required by: `external_authorization_service_enabled` | **[PREMIUM]** The default classification label to use when requesting authorization and no classification label has been specified on the project |
+| `external_authorization_service_timeout` | float            | required by: `external_authorization_service_enabled` | **[PREMIUM]** The timeout after which an authorization request is aborted, in seconds. When a request times out, access is denied to the user. (min: 0.001, max: 10, step: 0.001) |
+| `external_authorization_service_url`     | string           | required by: `external_authorization_service_enabled` | **[PREMIUM]** URL to which authorization requests will be directed |
+| `file_template_project_id`               | integer          | no                                   | **[PREMIUM]** The ID of a project to load custom file templates from |
 | `first_day_of_week`                      | integer          | no                                   | Start day of the week for calendar views and date pickers. Valid values are `0` (default) for Sunday, `1` for Monday, and `6` for Saturday. |
-| `geo_status_timeout`                     | integer          | no                                   | **[Premium]** The amount of seconds after which a request to get a secondary node status will time out. |
+| `geo_status_timeout`                     | integer          | no                                   | **[PREMIUM]** The amount of seconds after which a request to get a secondary node status will time out. |
 | `gitaly_timeout_default`                 | integer          | no                                   | Default Gitaly timeout, in seconds. This timeout is not enforced for git fetch/push operations or Sidekiq jobs. Set to `0` to disable timeouts. |
 | `gitaly_timeout_fast`                    | integer          | no                                   | Gitaly fast operation timeout, in seconds. Some Gitaly operations are expected to be fast. If they exceed this threshold, there may be a problem with a storage shard and 'failing fast' can help maintain the stability of the GitLab instance. Set to `0` to disable timeouts. |
 | `gitaly_timeout_medium`                  | integer          | no                                   | Medium Gitaly timeout, in seconds. This should be a value between the Fast and the Default timeout. Set to `0` to disable timeouts. |
@@ -224,7 +229,7 @@ are listed in the descriptions of the relevant settings.
 | `help_page_hide_commercial_content`      | boolean          | no                                   | Hide marketing-related entries from help. |
 | `help_page_support_url`                  | string           | no                                   | Alternate support URL for help page. |
 | `help_page_text`                         | string           | no                                   | Custom text displayed on the help page. |
-| `help_text`                              | string           | no                                   | **[Premium]** GitLab server administrator information |
+| `help_text`                              | string           | no                                   | **[PREMIUM]** GitLab server administrator information |
 | `hide_third_party_offers`                | boolean          | no                                   | Do not display offers from third parties within GitLab. |
 | `home_page_url`                          | string           | no                                   | Redirect to this URL when not logged in. |
 | `housekeeping_bitmaps_enabled`           | boolean          | required by: `housekeeping_enabled`  | Enable Git pack file bitmap creation. |
@@ -247,9 +252,9 @@ are listed in the descriptions of the relevant settings.
 | `metrics_sample_interval`                | integer          | required by: `metrics_enabled`       | The sampling interval in seconds. |
 | `metrics_timeout`                        | integer          | required by: `metrics_enabled`       | The amount of seconds after which InfluxDB will time out. |
 | `mirror_available`                       | boolean          | no                                   | Allow mirrors to be set up for projects. If disabled, only admins will be able to set up mirrors in projects. |
-| `mirror_capacity_threshold`              | integer          | no                                   | **[Premium]** Minimum capacity to be available before scheduling more mirrors preemptively |
-| `mirror_max_capacity`                    | integer          | no                                   | **[Premium]** Maximum number of mirrors that can be synchronizing at the same time. |
-| `mirror_max_delay`                       | integer          | no                                   | **[Premium]** Maximum time (in minutes) between updates that a mirror can have when scheduled to synchronize. |
+| `mirror_capacity_threshold`              | integer          | no                                   | **[PREMIUM]** Minimum capacity to be available before scheduling more mirrors preemptively |
+| `mirror_max_capacity`                    | integer          | no                                   | **[PREMIUM]** Maximum number of mirrors that can be synchronizing at the same time. |
+| `mirror_max_delay`                       | integer          | no                                   | **[PREMIUM]** Maximum time (in minutes) between updates that a mirror can have when scheduled to synchronize. |
 | `pages_domain_verification_enabled`      | boolean          | no                                   | Require users to prove ownership of custom domains. Domain verification is an essential security measure for public GitLab sites. Users are required to demonstrate they control a domain before it is enabled. |
 | `password_authentication_enabled_for_git` | boolean         | no                                   | Enable authentication for Git over HTTP(S) via a GitLab account password. Default is `true`. |
 | `password_authentication_enabled_for_web` | boolean         | no                                   | Enable authentication for the web interface via a GitLab account password. Default is `true`. |
@@ -261,12 +266,12 @@ are listed in the descriptions of the relevant settings.
 | `polling_interval_multiplier`            | decimal          | no                                   | Interval multiplier used by endpoints that perform polling. Set to `0` to disable polling. |
 | `project_export_enabled`                 | boolean          | no                                   | Enable project export. |
 | `prometheus_metrics_enabled`             | boolean          | no                                   | Enable prometheus metrics. |
-| `pseudonymizer_enabled`                  | boolean          | no                                   | **[Premium]** When enabled, GitLab will run a background job that will produce pseudonymized CSVs of the GitLab database that will be uploaded to your configured object storage directory.
+| `pseudonymizer_enabled`                  | boolean          | no                                   | **[PREMIUM]** When enabled, GitLab will run a background job that will produce pseudonymized CSVs of the GitLab database that will be uploaded to your configured object storage directory.
 | `recaptcha_enabled`                      | boolean          | no                                   | (**If enabled, requires:** `recaptcha_private_key` and `recaptcha_site_key`) Enable recaptcha. |
 | `recaptcha_private_key`                  | string           | required by: `recaptcha_enabled`     | Private key for recaptcha. |
 | `recaptcha_site_key`                     | string           | required by: `recaptcha_enabled`     | Site key for recaptcha. |
 | `repository_checks_enabled`              | boolean          | no                                   | GitLab will periodically run `git fsck` in all project and wiki repositories to look for silent disk corruption issues. |
-| `repository_size_limit`                  | integer          | no                                   | **[Premium]** Size limit per repository (MB) |
+| `repository_size_limit`                  | integer          | no                                   | **[PREMIUM]** Size limit per repository (MB) |
 | `repository_storages`                    | array of strings | no                                   | A list of names of enabled storage paths, taken from `gitlab.yml`. New projects will be created in one of these stores, chosen at random. |
 | `require_two_factor_authentication`      | boolean          | no                                   | (**If enabled, requires:** `two_factor_grace_period`) Require all users to set up Two-factor authentication. |
 | `restricted_visibility_levels`           | array of strings | no                                   | Selected levels cannot be used by non-admin users for groups, projects or snippets. Can take `private`, `internal` and `public` as a parameter. Default is `null` which means there is no restriction. |
@@ -274,15 +279,15 @@ are listed in the descriptions of the relevant settings.
 | `send_user_confirmation_email`           | boolean          | no                                   | Send confirmation email on sign-up. |
 | `session_expire_delay`                   | integer          | no                                   | Session duration in minutes. GitLab restart is required to apply changes |
 | `shared_runners_enabled`                 | boolean          | no                                   | (**If enabled, requires:** `shared_runners_text` and `shared_runners_minutes`) Enable shared runners for new projects. |
-| `shared_runners_minutes`                 | integer          | required by: `shared_runners_enabled` | **[Premium]** Set the maximum number of pipeline minutes that a group can use on shared Runners per month. |
+| `shared_runners_minutes`                 | integer          | required by: `shared_runners_enabled` | **[PREMIUM]** Set the maximum number of pipeline minutes that a group can use on shared Runners per month. |
 | `shared_runners_text`                    | string           | required by: `shared_runners_enabled` | Shared runners text. |
 | `sign_in_text`                           | string           | no                                   | Text on the login page. |
 | `signin_enabled`                         | string           | no                                   | (Deprecated: Use `password_authentication_enabled_for_web` instead) Flag indicating if password authentication is enabled for the web interface. |
 | `signup_enabled`                         | boolean          | no                                   | Enable registration. Default is `true`. |
-| `slack_app_enabled`                      | boolean          | no                                   | **[Premium]** (**If enabled, requires:** `slack_app_id`, `slack_app_secret` and `slack_app_secret`) Enable Slack app. |
-| `slack_app_id`                           | string           | required by: `slack_app_enabled`      | **[Premium]** The app id of the Slack-app. |
-| `slack_app_secret`                       | string           | required by: `slack_app_enabled`      | **[Premium]** The app secret of the Slack-app. |
-| `slack_app_verification_token`           | string           | required by: `slack_app_enabled`      | **[Premium]** The verification token of the Slack-app. |
+| `slack_app_enabled`                      | boolean          | no                                   | **[PREMIUM]** (**If enabled, requires:** `slack_app_id`, `slack_app_secret` and `slack_app_secret`) Enable Slack app. |
+| `slack_app_id`                           | string           | required by: `slack_app_enabled`      | **[PREMIUM]** The app id of the Slack-app. |
+| `slack_app_secret`                       | string           | required by: `slack_app_enabled`      | **[PREMIUM]** The app secret of the Slack-app. |
+| `slack_app_verification_token`           | string           | required by: `slack_app_enabled`      | **[PREMIUM]** The verification token of the Slack-app. |
 | `terminal_max_session_time`              | integer          | no                                   | Maximum time for web terminal websocket connection (in seconds). Set to `0` for unlimited time. |
 | `terms`                                  | text             | required by: `enforce_terms`         | (**Required by:** `enforce_terms`) Markdown content for the ToS. |
 | `throttle_authenticated_api_enabled`     | boolean          | no                                   | (**If enabled, requires:** `throttle_authenticated_api_period_in_seconds` and `throttle_authenticated_api_requests_per_period`) Enable authenticated API request rate limit. Helps reduce request volume (e.g. from crawlers or abusive bots). |
@@ -305,4 +310,4 @@ are listed in the descriptions of the relevant settings.
 | `user_show_add_ssh_key_message`          | boolean          | no                                   | When set to `false` disable the "You won't be able to pull or push project code via SSH" warning shown to users with no uploaded SSH key. |
 | `version_check_enabled`                  | boolean          | no                                   | Let GitLab inform you when an update is available. |
 | `local_markdown_version`                 | integer          | no                                   | Increase this value when any cached markdown should be invalidated. |
-| `geo_node_allowed_ips`                   | string           | yes                                  | **[Premium]** Comma-separated list of IPs and CIDRs of allowed secondary nodes. For example, `1.1.1.1, 2.2.2.0/24`. |
+| `geo_node_allowed_ips`                   | string           | yes                                  | **[PREMIUM]** Comma-separated list of IPs and CIDRs of allowed secondary nodes. For example, `1.1.1.1, 2.2.2.0/24`. |
diff --git a/doc/api/users.md b/doc/api/users.md
index 6be097e6364..e1fccc14df3 100644
--- a/doc/api/users.md
+++ b/doc/api/users.md
@@ -70,11 +70,11 @@ Username search is case insensitive.
 GET /users
 ```
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `order_by` | string | no | Return users ordered by `id`, `name`, `username`, `created_at`, or `updated_at` fields. Default is `id` |
-| `sort` | string | no | Return users sorted in `asc` or `desc` order. Default is `desc` |
-| `two_factor` | string | no | Filter users by Two-factor authentication. Filter values are `enabled` or `disabled`. By default it returns all users |
+| Attribute    | Type   | Required | Description |
+| ------------ | ------ | -------- | ----------- |
+| `order_by`   | string | no       | Return users ordered by `id`, `name`, `username`, `created_at`, or `updated_at` fields. Default is `id` |
+| `sort`       | string | no       | Return users sorted in `asc` or `desc` order. Default is `desc` |
+| `two_factor` | string | no       | Filter users by Two-factor authentication. Filter values are `enabled` or `disabled`. By default it returns all users |
 
 ```json
 [
@@ -284,7 +284,19 @@ Example Responses:
 
 Users on GitLab [Starter, Bronze, or higher](https://about.gitlab.com/pricing/) will also see
 the `shared_runners_minutes_limit` and `extra_shared_runners_minutes_limit` parameters.
-Users on GitLab Silver will also see the `group_saml` option:
+
+```json
+{
+  "id": 1,
+  "username": "john_smith",
+  "shared_runners_minutes_limit": 133,
+  "extra_shared_runners_minutes_limit": 133
+  ...
+}
+```
+
+Users on GitLab.com [Silver, or higher](https://about.gitlab.com/pricing/) will also
+see the `group_saml` option:
 
 ```json
 {
@@ -408,9 +420,7 @@ Parameters:
   [moved to the ghost user](../user/profile/account/delete_account.md#associated-records)
   will be deleted instead, as well as groups owned solely by this user.
 
-## User
-
-### For normal users
+## List current user (for normal users)
 
 Gets currently authenticated user.
 
@@ -456,7 +466,7 @@ GET /user
 }
 ```
 
-### For admins
+## List current user (for admins)
 
 Parameters:
 
@@ -535,9 +545,9 @@ Get the status of a user.
 GET /users/:id_or_username/status
 ```
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id_or_username` | string | yes    | The id or username of the user to get a status of |
+| Attribute        | Type   | Required | Description |
+| ---------------- | ------ | -------- | ----------- |
+| `id_or_username` | string | yes      | The id or username of the user to get a status of |
 
 ```bash
 curl "https://gitlab.example.com/users/janedoe/status"
@@ -561,8 +571,8 @@ Set the status of the current user.
 PUT /user/status
 ```
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
+| Attribute | Type   | Required | Description |
+| --------- | ------ | -------- | ----------- |
 | `emoji`   | string | no     | The name of the emoji to use as status, if omitted `speech_balloon` is used. Emoji name can be one of the specified names in the [Gemojione index][gemojione-index]. |
 | `message` | string | no     | The message to set as a status. It can also contain emoji codes. |
 
@@ -584,7 +594,7 @@ Example responses
 
 ## List user projects
 
-Please refer to the [List of user projects ](projects.md#list-user-projects).
+Please refer to the [List of user projects](projects.md#list-user-projects).
 
 ## List SSH keys
 
@@ -760,9 +770,9 @@ GET /user/gpg_keys/:key_id
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `key_id`  | integer | yes   | The ID of the GPG key |
+| Attribute | Type    | Required | Description |
+| --------- | ------- | -------- | ----------- |
+| `key_id`  | integer | yes      | The ID of the GPG key |
 
 ```bash
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/user/gpg_keys/1
@@ -788,9 +798,9 @@ POST /user/gpg_keys
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| key       | string | yes    | The new GPG key |
+| Attribute | Type   | Required | Description |
+| --------- | ------ | -------- | ----------- |
+| key       | string | yes      | The new GPG key |
 
 ```bash
 curl --data "key=-----BEGIN PGP PUBLIC KEY BLOCK-----\r\n\r\nxsBNBFV..."  --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/user/gpg_keys
@@ -818,9 +828,9 @@ DELETE /user/gpg_keys/:key_id
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `key_id`  | integer | yes   | The ID of the GPG key |
+| Attribute | Type    | Required | Description |
+| --------- | ------- | -------- | ----------- |
+| `key_id`  | integer | yes      | The ID of the GPG key |
 
 ```bash
 curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/user/gpg_keys/1
@@ -838,9 +848,9 @@ GET /users/:id/gpg_keys
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id`      | integer | yes   | The ID of the user |
+| Attribute | Type    | Required | Description |
+| --------- | ------- | -------- | ----------- |
+| `id`      | integer | yes      | The ID of the user |
 
 ```bash
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/users/2/gpg_keys
@@ -868,10 +878,10 @@ GET /users/:id/gpg_keys/:key_id
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id`      | integer | yes   | The ID of the user |
-| `key_id`  | integer | yes   | The ID of the GPG key |
+| Attribute | Type    | Required | Description |
+| --------- | ------- | -------- | ----------- |
+| `id`      | integer | yes      | The ID of the user |
+| `key_id`  | integer | yes      | The ID of the GPG key |
 
 ```bash
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/users/2/gpg_keys/1
@@ -897,10 +907,10 @@ POST /users/:id/gpg_keys
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id`      | integer | yes   | The ID of the user |
-| `key_id`  | integer | yes   | The ID of the GPG key |
+| Attribute | Type    | Required | Description |
+| --------- | ------- | -------- | ----------- |
+| `id`      | integer | yes      | The ID of the user |
+| `key_id`  | integer | yes      | The ID of the GPG key |
 
 ```bash
 curl --data "key=-----BEGIN PGP PUBLIC KEY BLOCK-----\r\n\r\nxsBNBFV..."  --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/users/2/gpg_keys
@@ -928,10 +938,10 @@ DELETE /users/:id/gpg_keys/:key_id
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id`      | integer | yes   | The ID of the user |
-| `key_id`  | integer | yes   | The ID of the GPG key |
+| Attribute | Type    | Required | Description |
+| --------- | ------- | -------- | ----------- |
+| `id`      | integer | yes      | The ID of the user |
+| `key_id`  | integer | yes      | The ID of the GPG key |
 
 ```bash
 curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/users/2/gpg_keys/1
@@ -1112,10 +1122,10 @@ GET /users/:user_id/impersonation_tokens
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `user_id` | integer | yes | The ID of the user |
-| `state`   | string  | no | filter tokens based on state (`all`, `active`, `inactive`) |
+| Attribute | Type    | Required | Description                                                |
+| --------- | ------- | -------- | ---------------------------------------------------------- |
+| `user_id` | integer | yes      | The ID of the user                                         |
+| `state`   | string  | no       | filter tokens based on state (`all`, `active`, `inactive`) |
 
 ```
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/users/42/impersonation_tokens
@@ -1164,10 +1174,10 @@ GET /users/:user_id/impersonation_tokens/:impersonation_token_id
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `user_id` | integer | yes | The ID of the user |
-| `impersonation_token_id` | integer | yes | The ID of the impersonation token |
+| Attribute                | Type    | Required | Description                       |
+| ------------------------ | ------- | -------- | --------------------------------- |
+| `user_id`                | integer | yes      | The ID of the user                |
+| `impersonation_token_id` | integer | yes      | The ID of the impersonation token |
 
 ```
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/users/42/impersonation_tokens/2
@@ -1193,7 +1203,6 @@ Example response:
 ## Create an impersonation token
 
 > Requires admin permissions.
-
 > Token values are returned once. Make sure you save it - you won't be able to access it again.
 
 It creates a new impersonation token. Note that only administrators can do this.
@@ -1205,12 +1214,12 @@ settings page.
 POST /users/:user_id/impersonation_tokens
 ```
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `user_id` | integer | yes | The ID of the user |
-| `name`    | string  | yes | The name of the impersonation token |
-| `expires_at` | date | no  | The expiration date of the impersonation token in ISO format (`YYYY-MM-DD`)|
-| `scopes` | array    | yes | The array of scopes of the impersonation token (`api`, `read_user`) |
+| Attribute    | Type    | Required | Description |
+| ------------ | ------- | -------- | ----------- |
+| `user_id`    | integer | yes      | The ID of the user |
+| `name`       | string  | yes      | The name of the impersonation token |
+| `expires_at` | date    | no       | The expiration date of the impersonation token in ISO format (`YYYY-MM-DD`)|
+| `scopes`     | array   | yes      | The array of scopes of the impersonation token (`api`, `read_user`) |
 
 ```
 curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --data "name=mytoken" --data "expires_at=2017-04-04" --data "scopes[]=api" https://gitlab.example.com/api/v4/users/42/impersonation_tokens
@@ -1257,15 +1266,15 @@ Parameters:
 
 ### Get user activities (admin only)
 
->**Note:** This API endpoint is only available on 8.15 (EE) and 9.1 (CE) and above.
+NOTE: **Note:** This API endpoint is only available on 8.15 (EE) and 9.1 (CE) and above.
 
 Get the last activity date for all users, sorted from oldest to newest.
 
 The activities that update the timestamp are:
 
-  - Git HTTP/SSH activities (such as clone, push)
-  - User logging in into GitLab
-  - User visiting pages related to Dashboards, Projects, Issues and Merge Requests ([introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/54947) in GitLab 11.8)
+- Git HTTP/SSH activities (such as clone, push)
+- User logging in into GitLab
+- User visiting pages related to Dashboards, Projects, Issues and Merge Requests ([introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/54947) in GitLab 11.8)
 
 By default, it shows the activity for all users in the last 6 months, but this can be
 amended by using the `from` parameter.

From 73d4425327d4860935472a130457c43ea4c7ea9f Mon Sep 17 00:00:00 2001
From: Marcia Ramos <marcia@gitlab.com>
Date: Thu, 4 Jul 2019 08:53:04 +0000
Subject: [PATCH 046/195] Docs: Clearly state "access control" from Pages index

---
 doc/user/project/pages/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/user/project/pages/index.md b/doc/user/project/pages/index.md
index fa79c393b72..64b1e259292 100644
--- a/doc/user/project/pages/index.md
+++ b/doc/user/project/pages/index.md
@@ -140,7 +140,7 @@ To learn more about configuration options for GitLab Pages, read the following:
 | [Static websites and Pages domains](getting_started_part_one.md) | Understand what is a static website, and how GitLab Pages default domains work. |
 | [Projects and URL structure](getting_started_part_two.md) | Forking projects and creating new ones from scratch, understanding URLs structure and baseurls. |
 | [GitLab CI/CD for GitLab Pages](getting_started_part_four.md) | Understand how to create your own `.gitlab-ci.yml` for your site. |
-| [Exploring GitLab Pages](introduction.md) | Requirements, technical aspects, specific GitLab CI's configuration options, custom 404 pages, limitations, FAQ. |
+| [Exploring GitLab Pages](introduction.md) | Requirements, technical aspects, specific GitLab CI's configuration options, Access Control, custom 404 pages, limitations, FAQ. |
 |---+---|
 | [Custom domains and SSL/TLS Certificates](getting_started_part_three.md) | How to add custom domains and subdomains to your website, configure DNS records and SSL/TLS certificates. |
 | [CloudFlare certificates](https://about.gitlab.com/2017/02/07/setting-up-gitlab-pages-with-cloudflare-certificates/) | Secure your Pages site with CloudFlare certificates. |

From efde6f7db97bd3962732b6885040dcc98ab46cd4 Mon Sep 17 00:00:00 2001
From: James Edwards-Jones <jedwardsjones@gitlab.com>
Date: Thu, 4 Jul 2019 08:53:31 +0000
Subject: [PATCH 047/195] OmniAuth full_host spec helper

Allows us to correctly set omniauth's full_host
so redirects take the port into account.

Needed when running selenium tests on a different port
---
 spec/features/oauth_login_spec.rb       | 12 ++----------
 spec/support/helpers/devise_helpers.rb  | 12 ++++++++++++
 spec/support/helpers/fake_u2f_device.rb |  4 ++++
 spec/support/helpers/login_helpers.rb   | 12 +++++++++++-
 4 files changed, 29 insertions(+), 11 deletions(-)

diff --git a/spec/features/oauth_login_spec.rb b/spec/features/oauth_login_spec.rb
index 5ebfc32952d..86331728f88 100644
--- a/spec/features/oauth_login_spec.rb
+++ b/spec/features/oauth_login_spec.rb
@@ -16,16 +16,8 @@ describe 'OAuth Login', :js, :allow_forgery_protection do
   providers = [:github, :twitter, :bitbucket, :gitlab, :google_oauth2,
                :facebook, :cas3, :auth0, :authentiq, :salesforce]
 
-  before(:all) do
-    # The OmniAuth `full_host` parameter doesn't get set correctly (it gets set to something like `http://localhost`
-    # here), and causes integration tests to fail with 404s. We set the `full_host` by removing the request path (and
-    # anything after it) from the request URI.
-    @omniauth_config_full_host = OmniAuth.config.full_host
-    OmniAuth.config.full_host = ->(request) { request['REQUEST_URI'].sub(/#{request['REQUEST_PATH']}.*/, '') }
-  end
-
-  after(:all) do
-    OmniAuth.config.full_host = @omniauth_config_full_host
+  around(:all) do |example|
+    with_omniauth_full_host { example.run }
   end
 
   def login_with_provider(provider, enter_two_factor: false)
diff --git a/spec/support/helpers/devise_helpers.rb b/spec/support/helpers/devise_helpers.rb
index d32bc2424c0..fb2a110422a 100644
--- a/spec/support/helpers/devise_helpers.rb
+++ b/spec/support/helpers/devise_helpers.rb
@@ -21,4 +21,16 @@ module DeviseHelpers
       context.env
     end
   end
+
+  def with_omniauth_full_host(&block)
+    # The OmniAuth `full_host` parameter doesn't get set correctly (it gets set to something like `http://localhost`
+    # here), and causes integration tests to fail with 404s. We set the `full_host` by removing the request path (and
+    # anything after it) from the request URI.
+    omniauth_config_full_host = OmniAuth.config.full_host
+    OmniAuth.config.full_host = ->(request) { ActionDispatch::Request.new(request).base_url }
+
+    yield
+
+    OmniAuth.config.full_host = omniauth_config_full_host
+  end
 end
diff --git a/spec/support/helpers/fake_u2f_device.rb b/spec/support/helpers/fake_u2f_device.rb
index a7605cd483a..22cd8152d77 100644
--- a/spec/support/helpers/fake_u2f_device.rb
+++ b/spec/support/helpers/fake_u2f_device.rb
@@ -32,6 +32,10 @@ class FakeU2fDevice
     ")
   end
 
+  def fake_u2f_authentication
+    @page.execute_script("window.gl.u2fAuthenticate.renderAuthenticated('abc');")
+  end
+
   private
 
   def u2f_device(app_id)
diff --git a/spec/support/helpers/login_helpers.rb b/spec/support/helpers/login_helpers.rb
index 0bb2d2510c2..0cb99b4e087 100644
--- a/spec/support/helpers/login_helpers.rb
+++ b/spec/support/helpers/login_helpers.rb
@@ -87,12 +87,17 @@ module LoginHelpers
     click_link "oauth-login-#{provider}"
   end
 
+  def fake_successful_u2f_authentication
+    allow(U2fRegistration).to receive(:authenticate).and_return(true)
+    FakeU2fDevice.new(page, nil).fake_u2f_authentication
+  end
+
   def mock_auth_hash_with_saml_xml(provider, uid, email, saml_response)
     response_object = { document: saml_xml(saml_response) }
     mock_auth_hash(provider, uid, email, response_object: response_object)
   end
 
-  def mock_auth_hash(provider, uid, email, response_object: nil)
+  def configure_mock_auth(provider, uid, email, response_object: nil)
     # The mock_auth configuration allows you to set per-provider (or default)
     # authentication hashes to return during integration testing.
     OmniAuth.config.mock_auth[provider.to_sym] = OmniAuth::AuthHash.new({
@@ -118,6 +123,11 @@ module LoginHelpers
         response_object: response_object
       }
     })
+  end
+
+  def mock_auth_hash(provider, uid, email, response_object: nil)
+    configure_mock_auth(provider, uid, email, response_object: response_object)
+
     original_env_config_omniauth_auth = Rails.application.env_config['omniauth.auth']
     Rails.application.env_config['omniauth.auth'] = OmniAuth.config.mock_auth[provider.to_sym]
 

From ae7041d4dae5650172858ec86bcb6ca92ec4512a Mon Sep 17 00:00:00 2001
From: Igor <idrozdov@gitlab.com>
Date: Thu, 4 Jul 2019 09:13:50 +0000
Subject: [PATCH 048/195] Backports for EE's "Allow adding groups to CODEOWNERS
 file"

Some general code has been added/removed in EE version
which needs to be backported in CE
---
 app/models/group.rb                    |  2 +
 doc/user/project/code_owners.md        | 15 +++--
 lib/gitlab/user_extractor.rb           | 56 ------------------
 spec/lib/gitlab/user_extractor_spec.rb | 78 --------------------------
 4 files changed, 13 insertions(+), 138 deletions(-)
 delete mode 100644 lib/gitlab/user_extractor.rb
 delete mode 100644 spec/lib/gitlab/user_extractor_spec.rb

diff --git a/app/models/group.rb b/app/models/group.rb
index 8e89c7ecfb1..9520db1bc0a 100644
--- a/app/models/group.rb
+++ b/app/models/group.rb
@@ -63,6 +63,8 @@ class Group < Namespace
   after_save :update_two_factor_requirement
   after_update :path_changed_hook, if: :saved_change_to_path?
 
+  scope :with_users, -> { includes(:users) }
+
   class << self
     def sort_by_attribute(method)
       if method == 'storage_size_desc'
diff --git a/doc/user/project/code_owners.md b/doc/user/project/code_owners.md
index ae04616943f..c76847616b3 100644
--- a/doc/user/project/code_owners.md
+++ b/doc/user/project/code_owners.md
@@ -1,10 +1,12 @@
 # Code Owners **[STARTER]**
 
-> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6916)
+> - [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6916)
 in [GitLab Starter](https://about.gitlab.com/pricing/) 11.3.
+> - [Support for group namespaces](https://gitlab.com/gitlab-org/gitlab-ce/issues/53182) added in GitLab Starter 12.1.
 
-You can use a `CODEOWNERS` file to specify users that are responsible
-for certain files in a repository.
+You can use a `CODEOWNERS` file to specify users or
+[shared groups](members/share_project_with_groups.md)
+that are responsible for certain files in a repository.
 
 You can choose and add the `CODEOWNERS` file in three places:
 
@@ -25,7 +27,8 @@ the given file.
 
 Files can be specified using the same kind of patterns you would use
 in the `.gitignore` file followed by the `@username` or email of one
-or more users that should be owners of the file.
+or more users or by the `@name` of one or more groups that should
+be owners of the file.
 
 The order in which the paths are defined is significant: the last
 pattern that matches a given path will be used to find the code
@@ -63,6 +66,10 @@ CODEOWNERS @multiple @owners	@tab-separated
 # owner for the LICENSE file
 LICENSE @legal this_does_not_match janedoe@gitlab.com
 
+# Group names can be used to match groups and nested groups to specify
+# them as owners for a file
+README @group @group/with-nested/subgroup
+
 # Ending a path in a `/` will specify the code owners for every file
 # nested in that directory, on any level
 /docs/ @all-docs
diff --git a/lib/gitlab/user_extractor.rb b/lib/gitlab/user_extractor.rb
deleted file mode 100644
index ede60c9ab1d..00000000000
--- a/lib/gitlab/user_extractor.rb
+++ /dev/null
@@ -1,56 +0,0 @@
-# frozen_string_literal: true
-
-# This class extracts all users found in a piece of text by the username or the
-# email address
-
-module Gitlab
-  class UserExtractor
-    # Not using `Devise.email_regexp` to filter out any chars that an email
-    # does not end with and not pinning the email to a start of end of a string.
-    EMAIL_REGEXP = /(?<email>([^@\s]+@[^@\s]+(?<!\W)))/.freeze
-    USERNAME_REGEXP = User.reference_pattern
-
-    def initialize(text)
-      # EE passes an Array to `text` in a few places, so we want to support both
-      # here.
-      @text = Array(text).join(' ')
-    end
-
-    def users
-      return User.none unless @text.present?
-      return User.none if references.empty?
-
-      @users ||= User.from_union(union_relations)
-    end
-
-    def usernames
-      matches[:usernames]
-    end
-
-    def emails
-      matches[:emails]
-    end
-
-    def references
-      @references ||= matches.values.flatten
-    end
-
-    def matches
-      @matches ||= {
-        emails: @text.scan(EMAIL_REGEXP).flatten.uniq,
-        usernames: @text.scan(USERNAME_REGEXP).flatten.uniq
-      }
-    end
-
-    private
-
-    def union_relations
-      relations = []
-
-      relations << User.by_any_email(emails) if emails.any?
-      relations << User.by_username(usernames) if usernames.any?
-
-      relations
-    end
-  end
-end
diff --git a/spec/lib/gitlab/user_extractor_spec.rb b/spec/lib/gitlab/user_extractor_spec.rb
deleted file mode 100644
index b86ec5445b8..00000000000
--- a/spec/lib/gitlab/user_extractor_spec.rb
+++ /dev/null
@@ -1,78 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-
-describe Gitlab::UserExtractor do
-  let(:text) do
-    <<~TXT
-    This is a long texth that mentions some users.
-    @user-1, @user-2 and user@gitlab.org take a walk in the park.
-    There they meet @user-4 that was out with other-user@gitlab.org.
-    @user-1 thought it was late, so went home straight away
-    TXT
-  end
-  subject(:extractor) { described_class.new(text) }
-
-  describe '#users' do
-    it 'returns an empty relation when nil was passed' do
-      extractor = described_class.new(nil)
-
-      expect(extractor.users).to be_empty
-      expect(extractor.users).to be_a(ActiveRecord::Relation)
-    end
-
-    it 'returns the user case insensitive for usernames' do
-      user = create(:user, username: "USER-4")
-
-      expect(extractor.users).to include(user)
-    end
-
-    it 'returns users by primary email' do
-      user = create(:user, email: 'user@gitlab.org')
-
-      expect(extractor.users).to include(user)
-    end
-
-    it 'returns users by secondary email' do
-      user = create(:email, email: 'other-user@gitlab.org').user
-
-      expect(extractor.users).to include(user)
-    end
-
-    context 'input as array of strings' do
-      it 'is treated as one string' do
-        extractor = described_class.new(text.lines)
-
-        user_1 = create(:user, username: "USER-1")
-        user_4 = create(:user, username: "USER-4")
-        user_email = create(:user, email: 'user@gitlab.org')
-
-        expect(extractor.users).to contain_exactly(user_1, user_4, user_email)
-      end
-    end
-  end
-
-  describe '#matches' do
-    it 'includes all mentioned email adresses' do
-      expect(extractor.matches[:emails]).to contain_exactly('user@gitlab.org', 'other-user@gitlab.org')
-    end
-
-    it 'includes all mentioned usernames' do
-      expect(extractor.matches[:usernames]).to contain_exactly('user-1', 'user-2', 'user-4')
-    end
-
-    context 'input has no matching e-mail or usernames' do
-      it 'returns an empty list of users' do
-        extractor = described_class.new('My test')
-
-        expect(extractor.users).to be_empty
-      end
-    end
-  end
-
-  describe '#references' do
-    it 'includes all user-references once' do
-      expect(extractor.references).to contain_exactly('user-1', 'user-2', 'user@gitlab.org', 'user-4', 'other-user@gitlab.org')
-    end
-  end
-end

From 643100a9b25253e122dcd2531e5457707d52818d Mon Sep 17 00:00:00 2001
From: David Palubin <dpalubin@gmail.com>
Date: Thu, 4 Jul 2019 09:29:06 +0000
Subject: [PATCH 049/195] Set default project sort method prior to initial sort
 on page loading

---
 .../dashboard/projects_controller.rb           |  2 +-
 changelogs/unreleased/issue-63222.yml          |  5 +++++
 .../dashboard/projects_controller_spec.rb      | 18 +++++++++++++++++-
 3 files changed, 23 insertions(+), 2 deletions(-)
 create mode 100644 changelogs/unreleased/issue-63222.yml

diff --git a/app/controllers/dashboard/projects_controller.rb b/app/controllers/dashboard/projects_controller.rb
index d43f5393ecc..daeb8fda417 100644
--- a/app/controllers/dashboard/projects_controller.rb
+++ b/app/controllers/dashboard/projects_controller.rb
@@ -7,8 +7,8 @@ class Dashboard::ProjectsController < Dashboard::ApplicationController
 
   prepend_before_action(only: [:index]) { authenticate_sessionless_user!(:rss) }
   before_action :set_non_archived_param
-  before_action :projects, only: [:index]
   before_action :default_sorting
+  before_action :projects, only: [:index]
   skip_cross_project_access_check :index, :starred
 
   def index
diff --git a/changelogs/unreleased/issue-63222.yml b/changelogs/unreleased/issue-63222.yml
new file mode 100644
index 00000000000..bc6520b9fc5
--- /dev/null
+++ b/changelogs/unreleased/issue-63222.yml
@@ -0,0 +1,5 @@
+---
+title: Set default sort method for dashboard projects list
+merge_request: 29830
+author: David Palubin
+type: fixed
diff --git a/spec/controllers/dashboard/projects_controller_spec.rb b/spec/controllers/dashboard/projects_controller_spec.rb
index ea68eae12ed..6591901a9dc 100644
--- a/spec/controllers/dashboard/projects_controller_spec.rb
+++ b/spec/controllers/dashboard/projects_controller_spec.rb
@@ -11,8 +11,10 @@ describe Dashboard::ProjectsController do
     end
 
     context 'user logged in' do
+      let(:user) { create(:user) }
+
       before do
-        sign_in create(:user)
+        sign_in(user)
       end
 
       context 'external authorization' do
@@ -24,6 +26,20 @@ describe Dashboard::ProjectsController do
           expect(response).to have_gitlab_http_status(200)
         end
       end
+
+      it 'orders the projects by last activity by default' do
+        project = create(:project)
+        project.add_developer(user)
+        project.update!(last_repository_updated_at: 3.days.ago, last_activity_at: 3.days.ago)
+
+        project2 = create(:project)
+        project2.add_developer(user)
+        project2.update!(last_repository_updated_at: 10.days.ago, last_activity_at: 10.days.ago)
+
+        get :index
+
+        expect(assigns(:projects)).to eq([project, project2])
+      end
     end
   end
 

From de69040f70718042d7041752ef64bc15d97b3191 Mon Sep 17 00:00:00 2001
From: Filipa Lacerda <filipa@gitlab.com>
Date: Thu, 4 Jul 2019 10:55:45 +0100
Subject: [PATCH 050/195] Removes EE differences

---
 app/views/projects/_flash_messages.html.haml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/app/views/projects/_flash_messages.html.haml b/app/views/projects/_flash_messages.html.haml
index b2dab0b5348..d95045c9cce 100644
--- a/app/views/projects/_flash_messages.html.haml
+++ b/app/views/projects/_flash_messages.html.haml
@@ -5,6 +5,7 @@
   - if current_user && can?(current_user, :download_code, project)
     = render 'shared/no_ssh'
     = render 'shared/no_password'
+    = render_if_exists 'shared/shared_runners_minutes_limit', project: project
     - unless project.empty_repo?
       = render 'shared/auto_devops_implicitly_enabled_banner', project: project
     = render_if_exists 'projects/above_size_limit_warning', project: project

From ac8bb05f0994787d720fd365dd27cb67172e9b58 Mon Sep 17 00:00:00 2001
From: Marin Jankovski <maxlazio@gmail.com>
Date: Thu, 4 Jul 2019 12:02:54 +0200
Subject: [PATCH 051/195] Remove empty lines in config/README.md

---
 config/README.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/config/README.md b/config/README.md
index 2778d0d4f02..9226f71a374 100644
--- a/config/README.md
+++ b/config/README.md
@@ -39,7 +39,7 @@ If desired, the routing URL provided by these settings can be used with:
     1. `host name` or IP for each Redis instance desired
     2. TCP port number for each Redis instance desired
     3. `database number` for each Redis instance desired
-    
+
 ## Example URL attribute formats for GitLab Redis `.yml` configuration files
 * Unix Socket, default Redis database (0)
     * `url: unix:/path/to/redis.sock`
@@ -147,4 +147,3 @@ searched):
 3. the configuration file pointed to by the
 `GITLAB_REDIS_CONFIG_FILE` environment variable
 4. the configuration file `resque.yml`
-

From 0e4cef8589e36d22e5da125e1fe83475f1b27856 Mon Sep 17 00:00:00 2001
From: Lukas Eipert <leipert@gitlab.com>
Date: Thu, 4 Jul 2019 12:18:51 +0200
Subject: [PATCH 052/195] Resolve CE/EE diff in main.js

Moving ee/main.js to ee/main_ee.js allows to add a noop file in CE and
utilize ee_else_ce.
---
 app/assets/javascripts/main.js    | 2 ++
 app/assets/javascripts/main_ee.js | 1 +
 2 files changed, 3 insertions(+)
 create mode 100644 app/assets/javascripts/main_ee.js

diff --git a/app/assets/javascripts/main.js b/app/assets/javascripts/main.js
index 9f30a989295..7b42f267890 100644
--- a/app/assets/javascripts/main.js
+++ b/app/assets/javascripts/main.js
@@ -33,6 +33,8 @@ import GlFieldErrors from './gl_field_errors';
 import initUserPopovers from './user_popovers';
 import { __ } from './locale';
 
+import 'ee_else_ce/main_ee';
+
 // expose jQuery as global (TODO: remove these)
 window.jQuery = jQuery;
 window.$ = jQuery;
diff --git a/app/assets/javascripts/main_ee.js b/app/assets/javascripts/main_ee.js
new file mode 100644
index 00000000000..84d74775163
--- /dev/null
+++ b/app/assets/javascripts/main_ee.js
@@ -0,0 +1 @@
+// This is an empty file to satisfy ee_else_ce import for the EE main entry point

From 0c028a816b6d8941b435291f298e1fffaa7b5af0 Mon Sep 17 00:00:00 2001
From: Ezekiel Kigbo <ekigbo@gitlab.com>
Date: Thu, 4 Jul 2019 10:20:38 +0000
Subject: [PATCH 053/195] Vue-i18n: app/assets/javascripts/notes directory

i18n linting for .vue files under the
app/assets/javascripts/notes directory
---
 .../notes/components/comment_form.vue         | 43 +++++++++--------
 .../notes/components/diff_with_note.vue       |  2 +-
 .../notes/components/note_awards_list.vue     | 16 ++++---
 .../notes/components/note_form.vue            | 32 +++++++++----
 .../notes/components/note_header.vue          |  2 +-
 .../components/note_signed_out_widget.vue     | 19 ++++++--
 .../notes/components/noteable_discussion.vue  |  5 +-
 .../notes/components/noteable_note.vue        | 18 ++++---
 .../notes/components/notes_app.vue            |  3 +-
 locale/gitlab.pot                             | 48 +++++++++++++++++++
 10 files changed, 138 insertions(+), 50 deletions(-)

diff --git a/app/assets/javascripts/notes/components/comment_form.vue b/app/assets/javascripts/notes/components/comment_form.vue
index 5a4b5f9398b..6c1738f0f1b 100644
--- a/app/assets/javascripts/notes/components/comment_form.vue
+++ b/app/assets/javascripts/notes/components/comment_form.vue
@@ -65,14 +65,12 @@ export default {
       return this.getUserData.id;
     },
     commentButtonTitle() {
-      return this.noteType === constants.COMMENT ? 'Comment' : 'Start thread';
+      return this.noteType === constants.COMMENT ? __('Comment') : __('Start thread');
     },
     startDiscussionDescription() {
-      let text = 'Discuss a specific suggestion or question';
-      if (this.getNoteableData.noteableType === constants.MERGE_REQUEST_NOTEABLE_TYPE) {
-        text += ' that needs to be resolved';
-      }
-      return `${text}.`;
+      return this.getNoteableData.noteableType === constants.MERGE_REQUEST_NOTEABLE_TYPE
+        ? __('Discuss a specific suggestion or question that needs to be resolved.')
+        : __('Discuss a specific suggestion or question.');
     },
     isOpen() {
       return this.openState === constants.OPENED || this.openState === constants.REOPENED;
@@ -127,8 +125,8 @@ export default {
     },
     issuableTypeTitle() {
       return this.noteableType === constants.MERGE_REQUEST_NOTEABLE_TYPE
-        ? 'merge request'
-        : 'issue';
+        ? __('merge request')
+        : __('issue');
     },
     trackingLabel() {
       return slugifyWithUnderscore(`${this.commentButtonTitle} button`);
@@ -203,7 +201,7 @@ export default {
                 this.discard();
               } else {
                 Flash(
-                  'Something went wrong while adding your comment. Please try again.',
+                  __('Something went wrong while adding your comment. Please try again.'),
                   'alert',
                   this.$refs.commentForm,
                 );
@@ -219,8 +217,9 @@ export default {
           .catch(() => {
             this.enableButton();
             this.discard(false);
-            const msg = `Your comment could not be submitted!
-Please check your network connection and try again.`;
+            const msg = __(
+              'Your comment could not be submitted! Please check your network connection and try again.',
+            );
             Flash(msg, 'alert', this.$el);
             this.note = noteData.data.note.note; // Restore textarea content.
             this.removePlaceholderNotes();
@@ -298,7 +297,7 @@ Please check your network connection and try again.`;
         const noteableType = capitalizeFirstCharacter(convertToCamelCase(this.noteableType));
 
         this.autosave = new Autosave($(this.$refs.textarea), [
-          'Note',
+          __('Note'),
           noteableType,
           this.getNoteableData.id,
         ]);
@@ -359,8 +358,8 @@ Please check your network connection and try again.`;
                 class="note-textarea js-vue-comment-form js-note-text
 js-gfm-input js-autosize markdown-area js-vue-textarea qa-comment-input"
                 data-supports-quick-actions="true"
-                aria-label="Description"
-                placeholder="Write a comment or drag your files here…"
+                :aria-label="__('Description')"
+                :placeholder="__('Write a comment or drag your files here…')"
                 @keydown.up="editCurrentUserLastNote()"
                 @keydown.meta.enter="handleSave()"
                 @keydown.ctrl.enter="handleSave()"
@@ -381,7 +380,7 @@ append-right-10 comment-type-dropdown js-comment-type-dropdown droplab-dropdown"
                   data-track-event="click_button"
                   @click.prevent="handleSave()"
                 >
-                  {{ __(commentButtonTitle) }}
+                  {{ commentButtonTitle }}
                 </button>
                 <button
                   :disabled="isSubmitButtonDisabled"
@@ -390,7 +389,7 @@ append-right-10 comment-type-dropdown js-comment-type-dropdown droplab-dropdown"
                   class="btn btn-success note-type-toggle js-note-new-discussion dropdown-toggle qa-note-dropdown"
                   data-display="static"
                   data-toggle="dropdown"
-                  aria-label="Open comment type dropdown"
+                  :aria-label="__('Open comment type dropdown')"
                 >
                   <i aria-hidden="true" class="fa fa-caret-down toggle-icon"> </i>
                 </button>
@@ -404,8 +403,14 @@ append-right-10 comment-type-dropdown js-comment-type-dropdown droplab-dropdown"
                     >
                       <i aria-hidden="true" class="fa fa-check icon"> </i>
                       <div class="description">
-                        <strong>Comment</strong>
-                        <p>Add a general comment to this {{ noteableDisplayName }}.</p>
+                        <strong>{{ __('Comment') }}</strong>
+                        <p>
+                          {{
+                            sprintf(__('Add a general comment to this %{noteableDisplayName}.'), {
+                              noteableDisplayName,
+                            })
+                          }}
+                        </p>
                       </div>
                     </button>
                   </li>
@@ -418,7 +423,7 @@ append-right-10 comment-type-dropdown js-comment-type-dropdown droplab-dropdown"
                     >
                       <i aria-hidden="true" class="fa fa-check icon"> </i>
                       <div class="description">
-                        <strong>Start thread</strong>
+                        <strong>{{ __('Start thread') }}</strong>
                         <p>{{ startDiscussionDescription }}</p>
                       </div>
                     </button>
diff --git a/app/assets/javascripts/notes/components/diff_with_note.vue b/app/assets/javascripts/notes/components/diff_with_note.vue
index 54c242b2fda..164e79c6294 100644
--- a/app/assets/javascripts/notes/components/diff_with_note.vue
+++ b/app/assets/javascripts/notes/components/diff_with_note.vue
@@ -100,7 +100,7 @@ export default {
               class="btn-link btn-link-retry btn-no-padding js-toggle-lazy-diff-retry-button"
               @click="fetchDiff"
             >
-              Try again
+              {{ __('Try again') }}
             </button>
           </td>
           <td v-else class="line_content js-success-lazy-load">
diff --git a/app/assets/javascripts/notes/components/note_awards_list.vue b/app/assets/javascripts/notes/components/note_awards_list.vue
index 941b6d5cab3..d4a57d5d58d 100644
--- a/app/assets/javascripts/notes/components/note_awards_list.vue
+++ b/app/assets/javascripts/notes/components/note_awards_list.vue
@@ -4,6 +4,7 @@ import tooltip from '~/vue_shared/directives/tooltip';
 import Icon from '~/vue_shared/components/icon.vue';
 import Flash from '../../flash';
 import { glEmojiTag } from '../../emoji';
+import { __, sprintf } from '~/locale';
 
 export default {
   components: {
@@ -108,23 +109,26 @@ export default {
 
       // Add myself to the beginning of the list so title will start with You.
       if (hasReactionByCurrentUser) {
-        namesToShow.unshift('You');
+        namesToShow.unshift(__('You'));
       }
 
       let title = '';
 
       // We have 10+ awarded user, join them with comma and add `and x more`.
       if (remainingAwardList.length) {
-        title = `${namesToShow.join(', ')}, and ${remainingAwardList.length} more.`;
+        title = sprintf(__(`%{listToShow}, and %{awardsListLength} more.`), {
+          listToShow: namesToShow.join(', '),
+          awardsListLength: remainingAwardList.length,
+        });
       } else if (namesToShow.length > 1) {
         // Join all names with comma but not the last one, it will be added with and text.
         title = namesToShow.slice(0, namesToShow.length - 1).join(', ');
         // If we have more than 2 users we need an extra comma before and text.
         title += namesToShow.length > 2 ? ',' : '';
-        title += ` and ${namesToShow.slice(-1)}`; // Append and text
+        title += sprintf(__(` and %{sliced}`), { sliced: namesToShow.slice(-1) }); // Append and text
       } else {
         // We have only 2 users so join them with and.
-        title = namesToShow.join(' and ');
+        title = namesToShow.join(__(' and '));
       }
 
       return title;
@@ -155,7 +159,7 @@ export default {
         awardName: parsedName,
       };
 
-      this.toggleAwardRequest(data).catch(() => Flash('Something went wrong on our end.'));
+      this.toggleAwardRequest(data).catch(() => Flash(__('Something went wrong on our end.')));
     },
   },
 };
@@ -184,7 +188,7 @@ export default {
           :class="{ 'js-user-authored': isAuthoredByMe }"
           class="award-control btn js-add-award"
           title="Add reaction"
-          aria-label="Add reaction"
+          :aria-label="__('Add reaction')"
           data-boundary="viewport"
           type="button"
         >
diff --git a/app/assets/javascripts/notes/components/note_form.vue b/app/assets/javascripts/notes/components/note_form.vue
index 01be4f2b094..3823861c0b9 100644
--- a/app/assets/javascripts/notes/components/note_form.vue
+++ b/app/assets/javascripts/notes/components/note_form.vue
@@ -1,14 +1,14 @@
 <script>
 import { mergeUrlParams } from '~/lib/utils/url_utility';
 import { mapGetters, mapActions } from 'vuex';
+import noteFormMixin from 'ee_else_ce/notes/mixins/note_form';
 import eventHub from '../event_hub';
 import issueWarning from '../../vue_shared/components/issue/issue_warning.vue';
 import markdownField from '../../vue_shared/components/markdown/field.vue';
 import issuableStateMixin from '../mixins/issuable_state';
 import resolvable from '../mixins/resolvable';
-import { __ } from '~/locale';
+import { __, sprintf } from '~/locale';
 import { getDraft, updateDraft } from '~/lib/utils/autosave';
-import noteFormMixin from 'ee_else_ce/notes/mixins/note_form';
 
 export default {
   name: 'NoteForm',
@@ -174,6 +174,18 @@ export default {
         (this.line && this.line.can_receive_suggestion)
       );
     },
+    changedCommentText() {
+      return sprintf(
+        __(
+          'This comment has changed since you started editing, please review the %{startTag}updated comment%{endTag} to ensure information is not lost.',
+        ),
+        {
+          startTag: `<a href="${this.noteHash}" target="_blank" rel="noopener noreferrer">`,
+          endTag: '</a>',
+        },
+        false,
+      );
+    },
   },
   watch: {
     noteBody() {
@@ -228,11 +240,11 @@ export default {
 
 <template>
   <div ref="editNoteForm" class="note-edit-form current-note-edit-form js-discussion-note-form">
-    <div v-if="conflictWhileEditing" class="js-conflict-edit-warning alert alert-danger">
-      This comment has changed since you started editing, please review the
-      <a :href="noteHash" target="_blank" rel="noopener noreferrer">updated comment</a> to ensure
-      information is not lost.
-    </div>
+    <div
+      v-if="conflictWhileEditing"
+      class="js-conflict-edit-warning alert alert-danger"
+      v-html="changedCommentText"
+    ></div>
     <div class="flash-container timeline-content"></div>
     <form :data-line-code="lineCode" class="edit-note common-note-form js-quick-submit gfm-form">
       <issue-warning
@@ -264,8 +276,8 @@ export default {
           name="note[note]"
           class="note-textarea js-gfm-input js-note-text js-autosize markdown-area js-vue-issue-note-form js-vue-textarea qa-reply-input"
           dir="auto"
-          aria-label="Description"
-          placeholder="Write a comment or drag your files here…"
+          :aria-label="__('Description')"
+          :placeholder="__('Write a comment or drag your files here…')"
           @keydown.meta.enter="handleKeySubmit()"
           @keydown.ctrl.enter="handleKeySubmit()"
           @keydown.exact.up="editMyLastNote()"
@@ -339,7 +351,7 @@ export default {
             type="button"
             @click="cancelHandler()"
           >
-            Cancel
+            {{ __('Cancel') }}
           </button>
         </template>
       </div>
diff --git a/app/assets/javascripts/notes/components/note_header.vue b/app/assets/javascripts/notes/components/note_header.vue
index 6466ab3acbe..3158e086f6c 100644
--- a/app/assets/javascripts/notes/components/note_header.vue
+++ b/app/assets/javascripts/notes/components/note_header.vue
@@ -103,7 +103,7 @@ export default {
       </template>
       <i
         class="fa fa-spinner fa-spin editing-spinner"
-        aria-label="Comment is being updated"
+        :aria-label="__('Comment is being updated')"
         aria-hidden="true"
       ></i>
     </span>
diff --git a/app/assets/javascripts/notes/components/note_signed_out_widget.vue b/app/assets/javascripts/notes/components/note_signed_out_widget.vue
index e3eb92956b1..ccfe84ab098 100644
--- a/app/assets/javascripts/notes/components/note_signed_out_widget.vue
+++ b/app/assets/javascripts/notes/components/note_signed_out_widget.vue
@@ -1,5 +1,6 @@
 <script>
 import { mapGetters } from 'vuex';
+import { __, sprintf } from '~/locale';
 
 export default {
   computed: {
@@ -10,12 +11,24 @@ export default {
     signInLink() {
       return this.getNotesDataByProp('newSessionPath');
     },
+    signedOutText() {
+      return sprintf(
+        __(
+          'Please %{startTagRegister}register%{endRegisterTag} or %{startTagSignIn}sign in%{endSignInTag} to reply',
+        ),
+        {
+          startTagRegister: `<a href="${this.registerLink}">`,
+          startTagSignIn: `<a href="${this.signInLink}">`,
+          endRegisterTag: '</a>',
+          endSignInTag: '</a>',
+        },
+        false,
+      );
+    },
   },
 };
 </script>
 
 <template>
-  <div class="disabled-comment text-center">
-    Please <a :href="registerLink">register</a> or <a :href="signInLink">sign in</a> to reply
-  </div>
+  <div class="disabled-comment text-center" v-html="signedOutText"></div>
 </template>
diff --git a/app/assets/javascripts/notes/components/noteable_discussion.vue b/app/assets/javascripts/notes/components/noteable_discussion.vue
index a71a89cfffc..3fbd0a9f715 100644
--- a/app/assets/javascripts/notes/components/noteable_discussion.vue
+++ b/app/assets/javascripts/notes/components/noteable_discussion.vue
@@ -283,8 +283,9 @@ export default {
           this.removePlaceholderNotes();
           this.isReplying = true;
           this.$nextTick(() => {
-            const msg = `Your comment could not be submitted!
-Please check your network connection and try again.`;
+            const msg = __(
+              'Your comment could not be submitted! Please check your network connection and try again.',
+            );
             Flash(msg, 'alert', this.$el);
             this.$refs.noteForm.note = noteText;
             callback(err);
diff --git a/app/assets/javascripts/notes/components/noteable_note.vue b/app/assets/javascripts/notes/components/noteable_note.vue
index aa80e25a3e0..2f201839d45 100644
--- a/app/assets/javascripts/notes/components/noteable_note.vue
+++ b/app/assets/javascripts/notes/components/noteable_note.vue
@@ -5,7 +5,7 @@ import { escape } from 'underscore';
 import { truncateSha } from '~/lib/utils/text_utility';
 import TimelineEntryItem from '~/vue_shared/components/notes/timeline_entry_item.vue';
 import draftMixin from 'ee_else_ce/notes/mixins/draft';
-import { s__, sprintf } from '../../locale';
+import { __, s__, sprintf } from '../../locale';
 import Flash from '../../flash';
 import userAvatarLink from '../../vue_shared/components/user_avatar/user_avatar_link.vue';
 import noteHeader from './note_header.vue';
@@ -128,9 +128,13 @@ export default {
       this.$emit('handleEdit');
     },
     deleteHandler() {
-      const typeOfComment = this.note.isDraft ? 'pending comment' : 'comment';
-      // eslint-disable-next-line no-alert
-      if (window.confirm(`Are you sure you want to delete this ${typeOfComment}?`)) {
+      const typeOfComment = this.note.isDraft ? __('pending comment') : __('comment');
+      if (
+        // eslint-disable-next-line no-alert
+        window.confirm(
+          sprintf(__('Are you sure you want to delete this %{typeOfComment}?'), { typeOfComment }),
+        )
+      ) {
         this.isDeleting = true;
         this.$emit('handleDeleteNote', this.note);
 
@@ -141,7 +145,7 @@ export default {
             this.isDeleting = false;
           })
           .catch(() => {
-            Flash('Something went wrong while deleting your note. Please try again.');
+            Flash(__('Something went wrong while deleting your note. Please try again.'));
             this.isDeleting = false;
           });
       }
@@ -185,7 +189,7 @@ export default {
           this.isRequesting = false;
           this.isEditing = true;
           this.$nextTick(() => {
-            const msg = 'Something went wrong while editing your comment. Please try again.';
+            const msg = __('Something went wrong while editing your comment. Please try again.');
             Flash(msg, 'alert', this.$el);
             this.recoverNoteContent(noteText);
             callback();
@@ -195,7 +199,7 @@ export default {
     formCancelHandler(shouldConfirm, isDirty) {
       if (shouldConfirm && isDirty) {
         // eslint-disable-next-line no-alert
-        if (!window.confirm('Are you sure you want to cancel editing this comment?')) return;
+        if (!window.confirm(__('Are you sure you want to cancel editing this comment?'))) return;
       }
       this.$refs.noteBody.resetAutoSave();
       if (this.oldContent) {
diff --git a/app/assets/javascripts/notes/components/notes_app.vue b/app/assets/javascripts/notes/components/notes_app.vue
index 4d00e957973..a0695f9e191 100644
--- a/app/assets/javascripts/notes/components/notes_app.vue
+++ b/app/assets/javascripts/notes/components/notes_app.vue
@@ -1,4 +1,5 @@
 <script>
+import { __ } from '~/locale';
 import { mapGetters, mapActions } from 'vuex';
 import { getLocationHash } from '../../lib/utils/url_utility';
 import Flash from '../../flash';
@@ -170,7 +171,7 @@ export default {
         .catch(() => {
           this.setLoadingState(false);
           this.setNotesFetchedState(true);
-          Flash('Something went wrong while fetching comments. Please try again.');
+          Flash(__('Something went wrong while fetching comments. Please try again.'));
         });
     },
     initPolling() {
diff --git a/locale/gitlab.pot b/locale/gitlab.pot
index 7e5e2f8df7b..b9bea9bd31a 100644
--- a/locale/gitlab.pot
+++ b/locale/gitlab.pot
@@ -28,6 +28,12 @@ msgstr ""
 msgid " You need to do this before %{grace_period_deadline}."
 msgstr ""
 
+msgid " and "
+msgstr ""
+
+msgid " and %{sliced}"
+msgstr ""
+
 msgid " or "
 msgstr ""
 
@@ -168,6 +174,9 @@ msgstr ""
 msgid "%{link_start}Read more%{link_end} about role permissions"
 msgstr ""
 
+msgid "%{listToShow}, and %{awardsListLength} more."
+msgstr ""
+
 msgid "%{loadingIcon} Started"
 msgstr ""
 
@@ -611,6 +620,9 @@ msgstr ""
 msgid "Add a bullet list"
 msgstr ""
 
+msgid "Add a general comment to this %{noteableDisplayName}."
+msgstr ""
+
 msgid "Add a general comment to this %{noteable_name}."
 msgstr ""
 
@@ -1202,6 +1214,9 @@ msgstr ""
 msgid "Are you sure you want to cancel editing this comment?"
 msgstr ""
 
+msgid "Are you sure you want to delete this %{typeOfComment}?"
+msgstr ""
+
 msgid "Are you sure you want to delete this device? This action cannot be undone."
 msgstr ""
 
@@ -3722,6 +3737,12 @@ msgstr ""
 msgid "Discuss a specific suggestion or question that needs to be resolved"
 msgstr ""
 
+msgid "Discuss a specific suggestion or question that needs to be resolved."
+msgstr ""
+
+msgid "Discuss a specific suggestion or question."
+msgstr ""
+
 msgid "Discussion"
 msgstr ""
 
@@ -6906,6 +6927,9 @@ msgstr ""
 msgid "Not started"
 msgstr ""
 
+msgid "Note"
+msgstr ""
+
 msgid "Note that this invitation was sent to %{mail_to_invite_email}, but you are signed in as %{link_to_current_user} with email %{mail_to_current_user}."
 msgstr ""
 
@@ -7532,6 +7556,9 @@ msgstr ""
 msgid "Please %{link_to_register} or %{link_to_sign_in} to comment"
 msgstr ""
 
+msgid "Please %{startTagRegister}register%{endRegisterTag} or %{startTagSignIn}sign in%{endSignInTag} to reply"
+msgstr ""
+
 msgid "Please accept the Terms of Service before continuing."
 msgstr ""
 
@@ -9593,6 +9620,9 @@ msgstr ""
 msgid "Something went wrong while adding your award. Please try again."
 msgstr ""
 
+msgid "Something went wrong while adding your comment. Please try again."
+msgstr ""
+
 msgid "Something went wrong while applying the suggestion. Please try again."
 msgstr ""
 
@@ -9602,6 +9632,12 @@ msgstr ""
 msgid "Something went wrong while deleting the source branch. Please try again."
 msgstr ""
 
+msgid "Something went wrong while deleting your note. Please try again."
+msgstr ""
+
+msgid "Something went wrong while editing your comment. Please try again."
+msgstr ""
+
 msgid "Something went wrong while fetching comments. Please try again."
 msgstr ""
 
@@ -10618,6 +10654,9 @@ msgstr ""
 msgid "This branch has changed since you started editing. Would you like to create a new branch?"
 msgstr ""
 
+msgid "This comment has changed since you started editing, please review the %{startTag}updated comment%{endTag} to ensure information is not lost."
+msgstr ""
+
 msgid "This commit is part of merge request %{link_to_merge_request}. Comments created here will be created in the context of that merge request."
 msgstr ""
 
@@ -12472,6 +12511,9 @@ msgstr ""
 msgid "cannot include leading slash or directory traversal."
 msgstr ""
 
+msgid "comment"
+msgstr ""
+
 msgid "commented on %{link_to_project}"
 msgstr ""
 
@@ -12597,6 +12639,9 @@ msgstr ""
 msgid "is not an email you own"
 msgstr ""
 
+msgid "issue"
+msgstr ""
+
 msgid "issue boards"
 msgstr ""
 
@@ -12897,6 +12942,9 @@ msgstr[1] ""
 msgid "password"
 msgstr ""
 
+msgid "pending comment"
+msgstr ""
+
 msgid "private"
 msgstr ""
 

From 04962880ad5325e4386528cfebb1d8a599de6494 Mon Sep 17 00:00:00 2001
From: Ryan Cobb <rcobb@gitlab.com>
Date: Thu, 4 Jul 2019 10:24:19 +0000
Subject: [PATCH 054/195] Fix process start time

Previously we were recording process start time as seconds from boot.
This makes it so we record as epoch time.
---
 .../unreleased/63873-process-start-time.yml      |  6 ++++++
 .../monitoring/prometheus/gitlab_metrics.md      |  2 +-
 lib/gitlab/metrics/samplers/ruby_sampler.rb      |  7 ++++++-
 lib/gitlab/metrics/system.rb                     | 12 ------------
 .../gitlab/metrics/samplers/ruby_sampler_spec.rb | 16 ++++++++--------
 spec/lib/gitlab/metrics/system_spec.rb           | 12 ------------
 6 files changed, 21 insertions(+), 34 deletions(-)
 create mode 100644 changelogs/unreleased/63873-process-start-time.yml

diff --git a/changelogs/unreleased/63873-process-start-time.yml b/changelogs/unreleased/63873-process-start-time.yml
new file mode 100644
index 00000000000..b11a66ca106
--- /dev/null
+++ b/changelogs/unreleased/63873-process-start-time.yml
@@ -0,0 +1,6 @@
+---
+title: Change ruby_process_start_time_seconds metric to unix timestamp instead of
+  seconds from boot.
+merge_request: 30195
+author: 
+type: fixed
diff --git a/doc/administration/monitoring/prometheus/gitlab_metrics.md b/doc/administration/monitoring/prometheus/gitlab_metrics.md
index 2d9e3f7f18b..f09548aa024 100644
--- a/doc/administration/monitoring/prometheus/gitlab_metrics.md
+++ b/doc/administration/monitoring/prometheus/gitlab_metrics.md
@@ -104,7 +104,7 @@ Some basic Ruby runtime metrics are available:
 | ruby_process_cpu_seconds_total         | Gauge     | 12.0  | Total amount of CPU time per process |
 | ruby_process_max_fds                   | Gauge     | 12.0  | Maximum number of open file descriptors per process |
 | ruby_process_resident_memory_bytes     | Gauge     | 12.0  | Memory usage by process, measured in bytes |
-| ruby_process_start_time_seconds        | Gauge     | 12.0  | The elapsed time between system boot and the process started, measured in seconds |
+| ruby_process_start_time_seconds        | Gauge     | 12.0  | UNIX timestamp of process start time |
 
 [GC.stat]: https://ruby-doc.org/core-2.3.0/GC.html#method-c-stat
 
diff --git a/lib/gitlab/metrics/samplers/ruby_sampler.rb b/lib/gitlab/metrics/samplers/ruby_sampler.rb
index 17eacbd21d8..eef802caabb 100644
--- a/lib/gitlab/metrics/samplers/ruby_sampler.rb
+++ b/lib/gitlab/metrics/samplers/ruby_sampler.rb
@@ -6,6 +6,12 @@ module Gitlab
   module Metrics
     module Samplers
       class RubySampler < BaseSampler
+        def initialize(interval)
+          metrics[:process_start_time_seconds].set(labels.merge(worker_label), Time.now.to_i)
+
+          super
+        end
+
         def metrics
           @metrics ||= init_metrics
         end
@@ -47,7 +53,6 @@ module Gitlab
           metrics[:file_descriptors].set(labels.merge(worker_label), System.file_descriptor_count)
           metrics[:process_cpu_seconds_total].set(labels.merge(worker_label), ::Gitlab::Metrics::System.cpu_time)
           metrics[:process_max_fds].set(labels.merge(worker_label), ::Gitlab::Metrics::System.max_open_file_descriptors)
-          metrics[:process_start_time_seconds].set(labels.merge(worker_label), ::Gitlab::Metrics::System.process_start_time)
           set_memory_usage_metrics
           sample_gc
 
diff --git a/lib/gitlab/metrics/system.rb b/lib/gitlab/metrics/system.rb
index 34de40ca72f..5c2f07b95e2 100644
--- a/lib/gitlab/metrics/system.rb
+++ b/lib/gitlab/metrics/system.rb
@@ -31,14 +31,6 @@ module Gitlab
 
           match[1].to_i
         end
-
-        def self.process_start_time
-          fields = File.read('/proc/self/stat').split
-
-          # fields[21] is linux proc stat field "(22) starttime".
-          # The value is expressed in clock ticks, divide by clock ticks for seconds.
-          ( fields[21].to_i || 0 ) / clk_tck
-        end
       else
         def self.memory_usage
           0.0
@@ -51,10 +43,6 @@ module Gitlab
         def self.max_open_file_descriptors
           0
         end
-
-        def self.process_start_time
-          0
-        end
       end
 
       def self.cpu_time
diff --git a/spec/lib/gitlab/metrics/samplers/ruby_sampler_spec.rb b/spec/lib/gitlab/metrics/samplers/ruby_sampler_spec.rb
index aaf8c9fa2a0..4d93b70e6e3 100644
--- a/spec/lib/gitlab/metrics/samplers/ruby_sampler_spec.rb
+++ b/spec/lib/gitlab/metrics/samplers/ruby_sampler_spec.rb
@@ -8,12 +8,19 @@ describe Gitlab::Metrics::Samplers::RubySampler do
     allow(Gitlab::Metrics::NullMetric).to receive(:instance).and_return(null_metric)
   end
 
+  describe '#initialize' do
+    it 'sets process_start_time_seconds' do
+      Timecop.freeze do
+        expect(sampler.metrics[:process_start_time_seconds].get).to eq(Time.now.to_i)
+      end
+    end
+  end
+
   describe '#sample' do
     it 'samples various statistics' do
       expect(Gitlab::Metrics::System).to receive(:cpu_time)
       expect(Gitlab::Metrics::System).to receive(:file_descriptor_count)
       expect(Gitlab::Metrics::System).to receive(:memory_usage)
-      expect(Gitlab::Metrics::System).to receive(:process_start_time)
       expect(Gitlab::Metrics::System).to receive(:max_open_file_descriptors)
       expect(sampler).to receive(:sample_gc)
 
@@ -44,13 +51,6 @@ describe Gitlab::Metrics::Samplers::RubySampler do
       sampler.sample
     end
 
-    it 'adds a metric containing the process start time' do
-      expect(Gitlab::Metrics::System).to receive(:process_start_time).and_return(12345)
-      expect(sampler.metrics[:process_start_time_seconds]).to receive(:set).with({}, 12345)
-
-      sampler.sample
-    end
-
     it 'adds a metric containing the process max file descriptors' do
       expect(Gitlab::Metrics::System).to receive(:max_open_file_descriptors).and_return(1024)
       expect(sampler.metrics[:process_max_fds]).to receive(:set).with({}, 1024)
diff --git a/spec/lib/gitlab/metrics/system_spec.rb b/spec/lib/gitlab/metrics/system_spec.rb
index da87df15746..3b434a02f63 100644
--- a/spec/lib/gitlab/metrics/system_spec.rb
+++ b/spec/lib/gitlab/metrics/system_spec.rb
@@ -19,12 +19,6 @@ describe Gitlab::Metrics::System do
         expect(described_class.max_open_file_descriptors).to be > 0
       end
     end
-
-    describe '.process_start_time' do
-      it 'returns the process start time' do
-        expect(described_class.process_start_time).to be > 0
-      end
-    end
   else
     describe '.memory_usage' do
       it 'returns 0.0' do
@@ -43,12 +37,6 @@ describe Gitlab::Metrics::System do
         expect(described_class.max_open_file_descriptors).to eq(0)
       end
     end
-
-    describe 'process_start_time' do
-      it 'returns 0' do
-        expect(described_class.process_start_time).to eq(0)
-      end
-    end
   end
 
   describe '.cpu_time' do

From 656bac08de24d7be98f28811b047f31a65d61356 Mon Sep 17 00:00:00 2001
From: Ezekiel Kigbo <ekigbo@gitlab.com>
Date: Thu, 4 Jul 2019 10:24:51 +0000
Subject: [PATCH 055/195] Vue-i18n: app/assets/javascripts/sidebar directory

i18n linting for .vue files under the
app/assets/javascripts/sidebar directory
---
 .../components/assignees/assignee_title.vue   | 10 +++--
 .../components/assignees/assignees.vue        | 29 +++++++------
 .../assignees/sidebar_assignees.vue           |  3 +-
 .../confidential/edit_form_buttons.vue        |  3 +-
 .../time_tracking/collapsed_state.vue         |  2 +-
 .../time_tracking/comparison_pane.vue         | 19 +++++---
 .../time_tracking/spent_only_pane.vue         | 19 ++++++--
 locale/gitlab.pot                             | 43 ++++++++++++++++++-
 8 files changed, 99 insertions(+), 29 deletions(-)

diff --git a/app/assets/javascripts/sidebar/components/assignees/assignee_title.vue b/app/assets/javascripts/sidebar/components/assignees/assignee_title.vue
index 0ad2b3a73a2..fa6b6bfaef1 100644
--- a/app/assets/javascripts/sidebar/components/assignees/assignee_title.vue
+++ b/app/assets/javascripts/sidebar/components/assignees/assignee_title.vue
@@ -1,4 +1,6 @@
 <script>
+import { n__ } from '~/locale';
+
 export default {
   name: 'AssigneeTitle',
   props: {
@@ -24,7 +26,7 @@ export default {
   computed: {
     assigneeTitle() {
       const assignees = this.numberOfAssignees;
-      return assignees > 1 ? `${assignees} Assignees` : 'Assignee';
+      return n__('Assignee', `%d Assignees`, assignees);
     },
   },
 };
@@ -32,18 +34,18 @@ export default {
 <template>
   <div class="title hide-collapsed">
     {{ assigneeTitle }}
-    <i v-if="loading" aria-hidden="true" class="fa fa-spinner fa-spin block-loading"> </i>
+    <i v-if="loading" aria-hidden="true" class="fa fa-spinner fa-spin block-loading"></i>
     <a v-if="editable" class="js-sidebar-dropdown-toggle edit-link float-right" href="#">
       {{ __('Edit') }}
     </a>
     <a
       v-if="showToggle"
-      aria-label="Toggle sidebar"
+      :aria-label="__('Toggle sidebar')"
       class="gutter-toggle float-right js-sidebar-toggle"
       href="#"
       role="button"
     >
-      <i aria-hidden="true" data-hidden="true" class="fa fa-angle-double-right"> </i>
+      <i aria-hidden="true" data-hidden="true" class="fa fa-angle-double-right"></i>
     </a>
   </div>
 </template>
diff --git a/app/assets/javascripts/sidebar/components/assignees/assignees.vue b/app/assets/javascripts/sidebar/components/assignees/assignees.vue
index 0074d7099dc..805c21d0965 100644
--- a/app/assets/javascripts/sidebar/components/assignees/assignees.vue
+++ b/app/assets/javascripts/sidebar/components/assignees/assignees.vue
@@ -1,5 +1,5 @@
 <script>
-import { __ } from '~/locale';
+import { __, sprintf } from '~/locale';
 import tooltip from '~/vue_shared/directives/tooltip';
 
 export default {
@@ -62,7 +62,8 @@ export default {
       return this.numberOfHiddenAssignees > 0;
     },
     hiddenAssigneesLabel() {
-      return `+ ${this.numberOfHiddenAssignees} more`;
+      const { numberOfHiddenAssignees } = this;
+      return sprintf(__('+ %{numberOfHiddenAssignees} more'), { numberOfHiddenAssignees });
     },
     collapsedTooltipTitle() {
       const maxRender = Math.min(this.defaultRenderCount, this.users.length);
@@ -103,12 +104,15 @@ export default {
         // Everyone can merge
         return null;
       } else if (cannotMergeCount === assigneesCount && assigneesCount > 1) {
-        return 'No one can merge';
+        return __('No one can merge');
       } else if (assigneesCount === 1) {
-        return 'Cannot merge';
+        return __('Cannot merge');
       }
 
-      return `${canMergeCount}/${assigneesCount} can merge`;
+      return sprintf(__('%{canMergeCount}/%{assigneesCount} can merge'), {
+        canMergeCount,
+        assigneesCount,
+      });
     },
   },
   methods: {
@@ -128,7 +132,7 @@ export default {
       return `${this.rootPath}${user.username}`;
     },
     assigneeAlt(user) {
-      return `${user.name}'s avatar`;
+      return sprintf(__("%{userName}'s avatar"), { userName: user.name });
     },
     assigneeUsername(user) {
       return `@${user.username}`;
@@ -153,7 +157,7 @@ export default {
       data-placement="left"
       data-boundary="viewport"
     >
-      <i v-if="hasNoUsers" aria-label="None" class="fa fa-user"> </i>
+      <i v-if="hasNoUsers" :aria-label="__('None')" class="fa fa-user"> </i>
       <button
         v-for="(user, index) in users"
         v-if="shouldRenderCollapsedAssignee(index)"
@@ -185,9 +189,12 @@ export default {
       </span>
       <template v-if="hasNoUsers">
         <span class="assign-yourself no-value qa-assign-yourself">
-          None
+          {{ __('None') }}
           <template v-if="editable">
-            - <button type="button" class="btn-link" @click="assignSelf">assign yourself</button>
+            -
+            <button type="button" class="btn-link" @click="assignSelf">
+              {{ __('assign yourself') }}
+            </button>
           </template>
         </span>
       </template>
@@ -232,9 +239,7 @@ export default {
             <template v-if="showLess">
               {{ hiddenAssigneesLabel }}
             </template>
-            <template v-else>
-              - show less
-            </template>
+            <template v-else>{{ __('- show less') }}</template>
           </button>
         </div>
       </template>
diff --git a/app/assets/javascripts/sidebar/components/assignees/sidebar_assignees.vue b/app/assets/javascripts/sidebar/components/assignees/sidebar_assignees.vue
index cfa7029b388..70dc3d2cdfa 100644
--- a/app/assets/javascripts/sidebar/components/assignees/sidebar_assignees.vue
+++ b/app/assets/javascripts/sidebar/components/assignees/sidebar_assignees.vue
@@ -4,6 +4,7 @@ import eventHub from '~/sidebar/event_hub';
 import Store from '~/sidebar/stores/sidebar_store';
 import AssigneeTitle from './assignee_title.vue';
 import Assignees from './assignees.vue';
+import { __ } from '~/locale';
 
 export default {
   name: 'SidebarAssignees',
@@ -74,7 +75,7 @@ export default {
         .then(setLoadingFalse.bind(this))
         .catch(() => {
           setLoadingFalse();
-          return new Flash('Error occurred when saving assignees');
+          return new Flash(__('Error occurred when saving assignees'));
         });
     },
   },
diff --git a/app/assets/javascripts/sidebar/components/confidential/edit_form_buttons.vue b/app/assets/javascripts/sidebar/components/confidential/edit_form_buttons.vue
index 4b9bb5c7b0e..5d0e39e8195 100644
--- a/app/assets/javascripts/sidebar/components/confidential/edit_form_buttons.vue
+++ b/app/assets/javascripts/sidebar/components/confidential/edit_form_buttons.vue
@@ -1,6 +1,7 @@
 <script>
 import $ from 'jquery';
 import eventHub from '../../event_hub';
+import { __ } from '~/locale';
 
 export default {
   props: {
@@ -15,7 +16,7 @@ export default {
   },
   computed: {
     toggleButtonText() {
-      return this.isConfidential ? 'Turn Off' : 'Turn On';
+      return this.isConfidential ? __('Turn Off') : __('Turn On');
     },
     updateConfidentialBool() {
       return !this.isConfidential;
diff --git a/app/assets/javascripts/sidebar/components/time_tracking/collapsed_state.vue b/app/assets/javascripts/sidebar/components/time_tracking/collapsed_state.vue
index 657ac837baf..24d5b14ded9 100644
--- a/app/assets/javascripts/sidebar/components/time_tracking/collapsed_state.vue
+++ b/app/assets/javascripts/sidebar/components/time_tracking/collapsed_state.vue
@@ -79,7 +79,7 @@ export default {
       } else if (this.showSpentOnlyState) {
         return `${this.timeSpent} / --`;
       } else if (this.showNoTimeTrackingState) {
-        return 'None';
+        return __('None');
       }
 
       return '';
diff --git a/app/assets/javascripts/sidebar/components/time_tracking/comparison_pane.vue b/app/assets/javascripts/sidebar/components/time_tracking/comparison_pane.vue
index bc263bc36e4..06aca547183 100644
--- a/app/assets/javascripts/sidebar/components/time_tracking/comparison_pane.vue
+++ b/app/assets/javascripts/sidebar/components/time_tracking/comparison_pane.vue
@@ -2,6 +2,7 @@
 import { parseSeconds, stringifyTime } from '~/lib/utils/datetime_utility';
 import tooltip from '../../../vue_shared/directives/tooltip';
 import { GlProgressBar } from '@gitlab/ui';
+import { s__, sprintf } from '~/locale';
 
 export default {
   name: 'TimeTrackingComparisonPane',
@@ -43,8 +44,14 @@ export default {
       return stringifyTime(this.parsedTimeRemaining);
     },
     timeRemainingTooltip() {
-      const prefix = this.timeRemainingMinutes < 0 ? 'Over by' : 'Time remaining:';
-      return `${prefix} ${this.timeRemainingHumanReadable}`;
+      const { timeRemainingHumanReadable, timeRemainingMinutes } = this;
+      return timeRemainingMinutes < 0
+        ? sprintf(s__('TimeTracking|Over by %{timeRemainingHumanReadable}'), {
+            timeRemainingHumanReadable,
+          })
+        : sprintf(s__('TimeTracking|Time remaining: %{timeRemainingHumanReadable}'), {
+            timeRemainingHumanReadable,
+          });
     },
     /* Diff values for comparison meter */
     timeRemainingMinutes() {
@@ -74,12 +81,12 @@ export default {
       <gl-progress-bar :value="timeRemainingPercent" :variant="progressBarVariant" />
       <div class="compare-display-container">
         <div class="compare-display float-left">
-          <span class="compare-label"> {{ s__('TimeTracking|Spent') }} </span>
-          <span class="compare-value spent"> {{ timeSpentHumanReadable }} </span>
+          <span class="compare-label">{{ s__('TimeTracking|Spent') }}</span>
+          <span class="compare-value spent">{{ timeSpentHumanReadable }}</span>
         </div>
         <div class="compare-display estimated float-right">
-          <span class="compare-label"> {{ s__('TimeTrackingEstimated|Est') }} </span>
-          <span class="compare-value"> {{ timeEstimateHumanReadable }} </span>
+          <span class="compare-label">{{ s__('TimeTrackingEstimated|Est') }}</span>
+          <span class="compare-value">{{ timeEstimateHumanReadable }}</span>
         </div>
       </div>
     </div>
diff --git a/app/assets/javascripts/sidebar/components/time_tracking/spent_only_pane.vue b/app/assets/javascripts/sidebar/components/time_tracking/spent_only_pane.vue
index 7c7356e2afa..c2f30310e2e 100644
--- a/app/assets/javascripts/sidebar/components/time_tracking/spent_only_pane.vue
+++ b/app/assets/javascripts/sidebar/components/time_tracking/spent_only_pane.vue
@@ -1,4 +1,6 @@
 <script>
+import { sprintf, s__ } from '~/locale';
+
 export default {
   name: 'TimeTrackingSpentOnlyPane',
   props: {
@@ -7,11 +9,22 @@ export default {
       required: true,
     },
   },
+  computed: {
+    timeSpent() {
+      return sprintf(
+        s__('TimeTracking|%{startTag}Spent: %{endTag}%{timeSpentHumanReadable}'),
+        {
+          startTag: '<span class="bold">',
+          endTag: '</span>',
+          timeSpentHumanReadable: this.timeSpentHumanReadable,
+        },
+        false,
+      );
+    },
+  },
 };
 </script>
 
 <template>
-  <div class="time-tracking-spend-only-pane">
-    <span class="bold">Spent:</span> {{ timeSpentHumanReadable }}
-  </div>
+  <div class="time-tracking-spend-only-pane" v-html="timeSpent"></div>
 </template>
diff --git a/locale/gitlab.pot b/locale/gitlab.pot
index b9bea9bd31a..ed6245bf242 100644
--- a/locale/gitlab.pot
+++ b/locale/gitlab.pot
@@ -118,6 +118,9 @@ msgstr[1] ""
 msgid "%{actionText} & %{openOrClose} %{noteable}"
 msgstr ""
 
+msgid "%{canMergeCount}/%{assigneesCount} can merge"
+msgstr ""
+
 msgid "%{commit_author_link} authored %{commit_timeago}"
 msgstr ""
 
@@ -260,6 +263,9 @@ msgstr ""
 msgid "%{usage_ping_link_start}Learn more%{usage_ping_link_end} about what information is shared with GitLab Inc."
 msgstr ""
 
+msgid "%{userName}'s avatar"
+msgstr ""
+
 msgid "%{user_name} profile page"
 msgstr ""
 
@@ -284,6 +290,9 @@ msgstr ""
 msgid "+ %{moreCount} more"
 msgstr ""
 
+msgid "+ %{numberOfHiddenAssignees} more"
+msgstr ""
+
 msgid ", or "
 msgstr ""
 
@@ -1335,7 +1344,9 @@ msgid "Assigned to me"
 msgstr ""
 
 msgid "Assignee"
-msgstr ""
+msgid_plural "%d Assignees"
+msgstr[0] ""
+msgstr[1] ""
 
 msgid "Assignee(s)"
 msgstr ""
@@ -1906,6 +1917,9 @@ msgstr ""
 msgid "Cannot create the abuse report. This user has been blocked."
 msgstr ""
 
+msgid "Cannot merge"
+msgstr ""
+
 msgid "Cannot modify managed Kubernetes cluster"
 msgstr ""
 
@@ -4244,6 +4258,9 @@ msgstr ""
 msgid "Error occurred when fetching sidebar data"
 msgstr ""
 
+msgid "Error occurred when saving assignees"
+msgstr ""
+
 msgid "Error occurred when toggling the notification subscription"
 msgstr ""
 
@@ -6867,6 +6884,9 @@ msgstr ""
 msgid "No milestones to show"
 msgstr ""
 
+msgid "No one can merge"
+msgstr ""
+
 msgid "No other labels with such name or description"
 msgstr ""
 
@@ -10906,12 +10926,21 @@ msgstr ""
 msgid "TimeTrackingEstimated|Est"
 msgstr ""
 
+msgid "TimeTracking|%{startTag}Spent: %{endTag}%{timeSpentHumanReadable}"
+msgstr ""
+
 msgid "TimeTracking|Estimated:"
 msgstr ""
 
+msgid "TimeTracking|Over by %{timeRemainingHumanReadable}"
+msgstr ""
+
 msgid "TimeTracking|Spent"
 msgstr ""
 
+msgid "TimeTracking|Time remaining: %{timeRemainingHumanReadable}"
+msgstr ""
+
 msgid "Timeago|%s days ago"
 msgstr ""
 
@@ -11177,6 +11206,9 @@ msgstr ""
 msgid "Toggle navigation"
 msgstr ""
 
+msgid "Toggle sidebar"
+msgstr ""
+
 msgid "Toggle thread"
 msgstr ""
 
@@ -11294,6 +11326,12 @@ msgstr ""
 msgid "Tuesday"
 msgstr ""
 
+msgid "Turn Off"
+msgstr ""
+
+msgid "Turn On"
+msgstr ""
+
 msgid "Twitter"
 msgstr ""
 
@@ -12493,6 +12531,9 @@ msgstr ""
 msgid "among other things"
 msgstr ""
 
+msgid "assign yourself"
+msgstr ""
+
 msgid "attach a new file"
 msgstr ""
 

From 2e630a18a3a895ef8e64891b67868b84651914c7 Mon Sep 17 00:00:00 2001
From: Winnie Hellmann <winnie@gitlab.com>
Date: Thu, 4 Jul 2019 10:53:09 +0000
Subject: [PATCH 056/195] Extract mounting of multiple boards switcher

---
 app/assets/javascripts/boards/index.js                         | 3 +++
 .../javascripts/boards/mount_multiple_boards_switcher.js       | 2 ++
 2 files changed, 5 insertions(+)
 create mode 100644 app/assets/javascripts/boards/mount_multiple_boards_switcher.js

diff --git a/app/assets/javascripts/boards/index.js b/app/assets/javascripts/boards/index.js
index a020765f335..ae9537fcb86 100644
--- a/app/assets/javascripts/boards/index.js
+++ b/app/assets/javascripts/boards/index.js
@@ -1,6 +1,7 @@
 import $ from 'jquery';
 import Vue from 'vue';
 
+import mountMultipleBoardsSwitcher from 'ee_else_ce/boards/mount_multiple_boards_switcher';
 import Flash from '~/flash';
 import { __ } from '~/locale';
 import './models/label';
@@ -278,4 +279,6 @@ export default () => {
       `,
     });
   }
+
+  mountMultipleBoardsSwitcher();
 };
diff --git a/app/assets/javascripts/boards/mount_multiple_boards_switcher.js b/app/assets/javascripts/boards/mount_multiple_boards_switcher.js
new file mode 100644
index 00000000000..bdb14a7f2f2
--- /dev/null
+++ b/app/assets/javascripts/boards/mount_multiple_boards_switcher.js
@@ -0,0 +1,2 @@
+// this will be moved from EE to CE as part of https://gitlab.com/gitlab-org/gitlab-ce/issues/53811
+export default () => {};

From d505f2a8f04b249541423fa301a8c8c6ee3b2bb2 Mon Sep 17 00:00:00 2001
From: Zeger-Jan van de Weg <git@zjvandeweg.nl>
Date: Wed, 3 Jul 2019 15:18:01 +0200
Subject: [PATCH 057/195] Remove unused Gitaly feature flags

When GitLab was migrating to Gitaly, feature flags were used. These are
now out of use, and essentially a no-op. But they do make the output of
chatops ugly and the feature table is selected in full by the
application.
---
 ...90703130053_remove_gitaly_feature_flags.rb | 48 +++++++++++++++++++
 db/schema.rb                                  |  2 +-
 2 files changed, 49 insertions(+), 1 deletion(-)
 create mode 100644 db/migrate/20190703130053_remove_gitaly_feature_flags.rb

diff --git a/db/migrate/20190703130053_remove_gitaly_feature_flags.rb b/db/migrate/20190703130053_remove_gitaly_feature_flags.rb
new file mode 100644
index 00000000000..13ac10a5e21
--- /dev/null
+++ b/db/migrate/20190703130053_remove_gitaly_feature_flags.rb
@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+class RemoveGitalyFeatureFlags < ActiveRecord::Migration[5.1]
+  include Gitlab::Database::MigrationHelpers
+
+  DOWNTIME = false
+
+  FEATURES = %w[
+    gitaly_batch_lfs_pointers gitaly_blame gitaly_blob_get_all_lfs_pointers gitaly_blob_get_new_lfs_pointers
+    gitaly_branch_names gitaly_branch_names_contains_sha gitaly_branches gitaly_bundle_to_disk
+    gitaly_calculate_checksum gitaly_can_be_merged gitaly_cherry_pick gitaly_commit_count
+    gitaly_commit_deltas gitaly_commit_languages gitaly_commit_messages gitaly_commit_patch
+    gitaly_commit_raw_diffs gitaly_commit_stats gitaly_commit_tree_entry gitaly_commits_between
+    gitaly_commits_by_message gitaly_conflicts_list_conflict_files gitaly_conflicts_resolve_conflicts gitaly_count_commits
+    gitaly_count_diverging_commits_no_max gitaly_create_branch gitaly_create_repo_from_bundle gitaly_create_repository
+    gitaly_delete_branch gitaly_delete_refs gitaly_delta_islands gitaly_deny_disk_acces
+    gitaly_diff_between gitaly_extract_commit_signature gitaly_fetch_ref gitaly_fetch_remote
+    gitaly_fetch_source_branch gitaly_filter_shas_with_signature gitaly_filter_shas_with_signatures gitaly_find_all_commits
+    gitaly_find_branch gitaly_find_commit gitaly_find_commits gitaly_find_ref_name
+    gitaly_force_push gitaly_fork_repository gitaly_garbage_collect gitaly_get_info_attributes
+    gitaly_git_blob_load_all_data gitaly_git_blob_raw gitaly_git_fsck gitaly_go-find-all-tags
+    gitaly_has_local_branches gitaly_import_repository gitaly_is_ancestor gitaly_last_commit_for_path
+    gitaly_license_short_name gitaly_list_blobs_by_sha_path gitaly_list_commits_by_oid gitaly_local_branches
+    gitaly_ls_files gitaly_merge_base gitaly_merged_branch_names gitaly_new_commits
+    gitaly_operation_user_add_tag gitaly_operation_user_commit_file gitaly_operation_user_commit_files gitaly_operation_user_create_branch
+    gitaly_operation_user_delete_branch gitaly_operation_user_delete_tag gitaly_operation_user_ff_branch gitaly_operation_user_merge_branch
+    gitaly_post_receive_pack gitaly_post_upload_pack gitaly_project_raw_show gitaly_raw_changes_between
+    gitaly_rebase gitaly_rebase_in_progress gitaly_ref_delete_refs gitaly_ref_exists
+    gitaly_ref_exists_branch gitaly_ref_exists_branches gitaly_ref_find_all_remote_branches gitaly_remote_add_remote
+    gitaly_remote_fetch_internal_remote gitaly_remote_remove_remote gitaly_remote_update_remote_mirror gitaly_remove_namespace
+    gitaly_repack_full gitaly_repack_incremental gitaly_repository_cleanup gitaly_repository_exists
+    gitaly_repository_size gitaly_root_ref gitaly_search_files_by_content gitaly_search_files_by_name
+    gitaly_squash gitaly_squash_in_progress gitaly_ssh_receive_pack gitaly_ssh_upload_pack
+    gitaly_submodule_url_for gitaly_tag_messages gitaly_tag_names gitaly_tag_names_contains_sha
+    gitaly_tags gitaly_tree_entries gitaly_wiki_delete_page gitaly_wiki_find_file
+    gitaly_wiki_find_page gitaly_wiki_get_all_pages gitaly_wiki_page_formatted_data gitaly_wiki_page_versions
+    gitaly_wiki_update_page gitaly_wiki_write_page gitaly_workhorse_archive gitaly_workhorse_raw_show
+    gitaly_workhorse_send_git_diff gitaly_workhorse_send_git_patch gitaly_write_config gitaly_write_ref
+  ]
+
+  class Feature < ActiveRecord::Base
+    self.table_name = 'features'
+  end
+
+  def up
+    Feature.where(key: FEATURES).delete_all
+  end
+end
diff --git a/db/schema.rb b/db/schema.rb
index 32a25f643ce..00ca19c1e6e 100644
--- a/db/schema.rb
+++ b/db/schema.rb
@@ -10,7 +10,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema.define(version: 20190628185004) do
+ActiveRecord::Schema.define(version: 20190703130053) do
 
   # These are extensions that must be enabled in order to support this database
   enable_extension "plpgsql"

From bca7fa81bf438861346328e8b970d714c78ece3d Mon Sep 17 00:00:00 2001
From: Ben Bodenmiller <bbodenmiller@hotmail.com>
Date: Thu, 4 Jul 2019 13:44:52 +0000
Subject: [PATCH 058/195] Omit Gitaly path where not needed, add where required

---
 doc/administration/gitaly/index.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/administration/gitaly/index.md b/doc/administration/gitaly/index.md
index a3cbc4272f0..7c7bb9045c7 100644
--- a/doc/administration/gitaly/index.md
+++ b/doc/administration/gitaly/index.md
@@ -247,8 +247,10 @@ gitlab:
   repositories:
     storages:
       default:
+        path: /mnt/gitlab/default/repositories
         gitaly_address: tcp://gitaly.internal:8075
       storage1:
+        path: /mnt/gitlab/storage1/repositories
         gitaly_address: tcp://gitaly.internal:8075
 
   gitaly:
@@ -293,8 +295,8 @@ sum(rate(gitaly_connections_total[5m])) by (type)
 ```ruby
 # /etc/gitlab/gitlab.rb
 git_data_dirs({
-  'default' => { 'path' => '/mnt/gitlab/default', 'gitaly_address' => 'tls://gitaly.internal:9999' },
-  'storage1' => { 'path' => '/mnt/gitlab/storage1', 'gitaly_address' => 'tls://gitaly.internal:9999' },
+  'default' => { 'gitaly_address' => 'tls://gitaly.internal:9999' },
+  'storage1' => { 'gitaly_address' => 'tls://gitaly.internal:9999' },
 })
 
 gitlab_rails['gitaly_token'] = 'abc123secret'

From 0a169cb80586c76517230e177af58fcdc012bca2 Mon Sep 17 00:00:00 2001
From: Winnie Hellmann <winnie@gitlab.com>
Date: Thu, 4 Jul 2019 14:08:48 +0000
Subject: [PATCH 059/195] Create EE-specific initNewListDropdown() function

(cherry picked from commit 844666193f0740ab9c5f91d60d61acb6ce14cfaf)
---
 app/assets/javascripts/boards/index.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app/assets/javascripts/boards/index.js b/app/assets/javascripts/boards/index.js
index ae9537fcb86..ca359da60d4 100644
--- a/app/assets/javascripts/boards/index.js
+++ b/app/assets/javascripts/boards/index.js
@@ -21,7 +21,7 @@ import modalMixin from './mixins/modal_mixins';
 import './filters/due_date_filters';
 import Board from './components/board';
 import BoardSidebar from './components/board_sidebar';
-import initNewListDropdown from './components/new_list_dropdown';
+import initNewListDropdown from 'ee_else_ce/boards/components/new_list_dropdown';
 import BoardAddIssuesModal from './components/modal/index.vue';
 import '~/vue_shared/vue_resource_interceptor';
 import {

From 3c89dc99d9ac063feab29a25157280df53cd8f53 Mon Sep 17 00:00:00 2001
From: Winnie Hellmann <winnie@gitlab.com>
Date: Thu, 4 Jul 2019 14:11:03 +0000
Subject: [PATCH 060/195] Copy content from BoardService to boardsStore

(cherry picked from commit 813299edd83ace98256b7fc9302f586f0dc2cabc)
---
 app/assets/javascripts/boards/index.js        |   3 +-
 .../boards/services/board_service.js          |  76 +++---------
 .../javascripts/boards/stores/boards_store.js | 111 ++++++++++++++++++
 .../boards/services/board_service_spec.js     |   4 +-
 spec/javascripts/boards/mock_data.js          |   5 +-
 5 files changed, 138 insertions(+), 61 deletions(-)

diff --git a/app/assets/javascripts/boards/index.js b/app/assets/javascripts/boards/index.js
index ca359da60d4..23b107abefa 100644
--- a/app/assets/javascripts/boards/index.js
+++ b/app/assets/javascripts/boards/index.js
@@ -79,13 +79,14 @@ export default () => {
       },
     },
     created() {
-      gl.boardService = new BoardService({
+      boardsStore.setEndpoints({
         boardsEndpoint: this.boardsEndpoint,
         recentBoardsEndpoint: this.recentBoardsEndpoint,
         listsEndpoint: this.listsEndpoint,
         bulkUpdatePath: this.bulkUpdatePath,
         boardId: this.boardId,
       });
+      gl.boardService = new BoardService();
       boardsStore.rootPath = this.boardsEndpoint;
 
       eventHub.$on('updateTokens', this.updateTokens);
diff --git a/app/assets/javascripts/boards/services/board_service.js b/app/assets/javascripts/boards/services/board_service.js
index 7d463f17ab1..580d04a3649 100644
--- a/app/assets/javascripts/boards/services/board_service.js
+++ b/app/assets/javascripts/boards/services/board_service.js
@@ -1,106 +1,66 @@
-import axios from '../../lib/utils/axios_utils';
-import { mergeUrlParams } from '../../lib/utils/url_utility';
+/* eslint-disable class-methods-use-this */
+
+import boardsStore from '~/boards/stores/boards_store';
 
 export default class BoardService {
-  constructor({ boardsEndpoint, listsEndpoint, bulkUpdatePath, boardId, recentBoardsEndpoint }) {
-    this.boardsEndpoint = boardsEndpoint;
-    this.boardId = boardId;
-    this.listsEndpoint = listsEndpoint;
-    this.listsEndpointGenerate = `${listsEndpoint}/generate.json`;
-    this.bulkUpdatePath = bulkUpdatePath;
-    this.recentBoardsEndpoint = `${recentBoardsEndpoint}.json`;
-  }
-
   generateBoardsPath(id) {
-    return `${this.boardsEndpoint}${id ? `/${id}` : ''}.json`;
+    return boardsStore.generateBoardsPath(id);
   }
 
   generateIssuesPath(id) {
-    return `${this.listsEndpoint}${id ? `/${id}` : ''}/issues`;
+    return boardsStore.generateIssuesPath(id);
   }
 
   static generateIssuePath(boardId, id) {
-    return `${gon.relative_url_root}/-/boards/${boardId ? `${boardId}` : ''}/issues${
-      id ? `/${id}` : ''
-    }`;
+    return boardsStore.generateIssuePath(boardId, id);
   }
 
   all() {
-    return axios.get(this.listsEndpoint);
+    return boardsStore.all();
   }
 
   generateDefaultLists() {
-    return axios.post(this.listsEndpointGenerate, {});
+    return boardsStore.generateDefaultLists();
   }
 
   createList(entityId, entityType) {
-    const list = {
-      [entityType]: entityId,
-    };
-
-    return axios.post(this.listsEndpoint, {
-      list,
-    });
+    return boardsStore.createList(entityId, entityType);
   }
 
   updateList(id, position) {
-    return axios.put(`${this.listsEndpoint}/${id}`, {
-      list: {
-        position,
-      },
-    });
+    return boardsStore.updateList(id, position);
   }
 
   destroyList(id) {
-    return axios.delete(`${this.listsEndpoint}/${id}`);
+    return boardsStore.destroyList(id);
   }
 
   getIssuesForList(id, filter = {}) {
-    const data = { id };
-    Object.keys(filter).forEach(key => {
-      data[key] = filter[key];
-    });
-
-    return axios.get(mergeUrlParams(data, this.generateIssuesPath(id)));
+    return boardsStore.getIssuesForList(id, filter);
   }
 
   moveIssue(id, fromListId = null, toListId = null, moveBeforeId = null, moveAfterId = null) {
-    return axios.put(BoardService.generateIssuePath(this.boardId, id), {
-      from_list_id: fromListId,
-      to_list_id: toListId,
-      move_before_id: moveBeforeId,
-      move_after_id: moveAfterId,
-    });
+    return boardsStore.moveIssue(id, fromListId, toListId, moveBeforeId, moveAfterId);
   }
 
   newIssue(id, issue) {
-    return axios.post(this.generateIssuesPath(id), {
-      issue,
-    });
+    return boardsStore.newIssue(id, issue);
   }
 
   getBacklog(data) {
-    return axios.get(
-      mergeUrlParams(data, `${gon.relative_url_root}/-/boards/${this.boardId}/issues.json`),
-    );
+    return boardsStore.getBacklog(data);
   }
 
   bulkUpdate(issueIds, extraData = {}) {
-    const data = {
-      update: Object.assign(extraData, {
-        issuable_ids: issueIds.join(','),
-      }),
-    };
-
-    return axios.post(this.bulkUpdatePath, data);
+    return boardsStore.bulkUpdate(issueIds, extraData);
   }
 
   static getIssueInfo(endpoint) {
-    return axios.get(endpoint);
+    return boardsStore.getIssueInfo(endpoint);
   }
 
   static toggleIssueSubscription(endpoint) {
-    return axios.post(endpoint);
+    return boardsStore.toggleIssueSubscription(endpoint);
   }
 }
 
diff --git a/app/assets/javascripts/boards/stores/boards_store.js b/app/assets/javascripts/boards/stores/boards_store.js
index 4ba4cde6bae..b9cd4a143ef 100644
--- a/app/assets/javascripts/boards/stores/boards_store.js
+++ b/app/assets/javascripts/boards/stores/boards_store.js
@@ -8,6 +8,8 @@ import Cookies from 'js-cookie';
 import BoardsStoreEE from 'ee_else_ce/boards/stores/boards_store_ee';
 import { getUrlParamsArray, parseBoolean } from '~/lib/utils/common_utils';
 import { __ } from '~/locale';
+import axios from '~/lib/utils/axios_utils';
+import { mergeUrlParams } from '~/lib/utils/url_utility';
 import eventHub from '../eventhub';
 
 const boardsStore = {
@@ -28,6 +30,7 @@ const boardsStore = {
     },
     currentPage: '',
     reload: false,
+    endpoints: {},
   },
   detail: {
     issue: {},
@@ -36,6 +39,19 @@ const boardsStore = {
     issue: {},
     list: {},
   },
+
+  setEndpoints({ boardsEndpoint, listsEndpoint, bulkUpdatePath, boardId, recentBoardsEndpoint }) {
+    const listsEndpointGenerate = `${listsEndpoint}/generate.json`;
+    this.state.endpoints = {
+      boardsEndpoint,
+      boardId,
+      listsEndpoint,
+      listsEndpointGenerate,
+      bulkUpdatePath,
+      recentBoardsEndpoint: `${recentBoardsEndpoint}.json`,
+    };
+  },
+
   create() {
     this.state.lists = [];
     this.filter.path = getUrlParamsArray().join('&');
@@ -229,6 +245,101 @@ const boardsStore = {
   setTimeTrackingLimitToHours(limitToHours) {
     this.timeTracking.limitToHours = parseBoolean(limitToHours);
   },
+
+  generateBoardsPath(id) {
+    return `${this.state.endpoints.boardsEndpoint}${id ? `/${id}` : ''}.json`;
+  },
+
+  generateIssuesPath(id) {
+    return `${this.state.endpoints.listsEndpoint}${id ? `/${id}` : ''}/issues`;
+  },
+
+  generateIssuePath(boardId, id) {
+    return `${gon.relative_url_root}/-/boards/${boardId ? `${boardId}` : ''}/issues${
+      id ? `/${id}` : ''
+    }`;
+  },
+
+  all() {
+    return axios.get(this.state.endpoints.listsEndpoint);
+  },
+
+  generateDefaultLists() {
+    return axios.post(this.state.endpoints.listsEndpointGenerate, {});
+  },
+
+  createList(entityId, entityType) {
+    const list = {
+      [entityType]: entityId,
+    };
+
+    return axios.post(this.state.endpoints.listsEndpoint, {
+      list,
+    });
+  },
+
+  updateList(id, position) {
+    return axios.put(`${this.state.endpoints.listsEndpoint}/${id}`, {
+      list: {
+        position,
+      },
+    });
+  },
+
+  destroyList(id) {
+    return axios.delete(`${this.state.endpoints.listsEndpoint}/${id}`);
+  },
+
+  getIssuesForList(id, filter = {}) {
+    const data = { id };
+    Object.keys(filter).forEach(key => {
+      data[key] = filter[key];
+    });
+
+    return axios.get(mergeUrlParams(data, this.generateIssuesPath(id)));
+  },
+
+  moveIssue(id, fromListId = null, toListId = null, moveBeforeId = null, moveAfterId = null) {
+    return axios.put(this.generateIssuePath(this.state.endpoints.boardId, id), {
+      from_list_id: fromListId,
+      to_list_id: toListId,
+      move_before_id: moveBeforeId,
+      move_after_id: moveAfterId,
+    });
+  },
+
+  newIssue(id, issue) {
+    return axios.post(this.generateIssuesPath(id), {
+      issue,
+    });
+  },
+
+  getBacklog(data) {
+    return axios.get(
+      mergeUrlParams(
+        data,
+        `${gon.relative_url_root}/-/boards/${this.state.endpoints.boardId}/issues.json`,
+      ),
+    );
+  },
+
+  bulkUpdate(issueIds, extraData = {}) {
+    const data = {
+      update: Object.assign(extraData, {
+        issuable_ids: issueIds.join(','),
+      }),
+    };
+
+    return axios.post(this.state.endpoints.bulkUpdatePath, data);
+  },
+
+  getIssueInfo(endpoint) {
+    return axios.get(endpoint);
+  },
+
+  toggleIssueSubscription(endpoint) {
+    return axios.post(endpoint);
+  },
 };
 
 BoardsStoreEE.initEESpecific(boardsStore);
diff --git a/spec/frontend/boards/services/board_service_spec.js b/spec/frontend/boards/services/board_service_spec.js
index de9fc998360..a8a322e7237 100644
--- a/spec/frontend/boards/services/board_service_spec.js
+++ b/spec/frontend/boards/services/board_service_spec.js
@@ -2,6 +2,7 @@ import BoardService from '~/boards/services/board_service';
 import { TEST_HOST } from 'helpers/test_constants';
 import AxiosMockAdapter from 'axios-mock-adapter';
 import axios from '~/lib/utils/axios_utils';
+import boardsStore from '~/boards/stores/boards_store';
 
 describe('BoardService', () => {
   const dummyResponse = "without type checking this doesn't matter";
@@ -18,10 +19,11 @@ describe('BoardService', () => {
 
   beforeEach(() => {
     axiosMock = new AxiosMockAdapter(axios);
-    service = new BoardService({
+    boardsStore.setEndpoints({
       ...endpoints,
       boardId,
     });
+    service = new BoardService();
   });
 
   describe('all', () => {
diff --git a/spec/javascripts/boards/mock_data.js b/spec/javascripts/boards/mock_data.js
index 9854cf49e97..ea22ae5c4e7 100644
--- a/spec/javascripts/boards/mock_data.js
+++ b/spec/javascripts/boards/mock_data.js
@@ -1,4 +1,5 @@
 import BoardService from '~/boards/services/board_service';
+import boardsStore from '~/boards/stores/boards_store';
 
 export const boardObj = {
   id: 1,
@@ -76,12 +77,14 @@ export const mockBoardService = (opts = {}) => {
   const bulkUpdatePath = opts.bulkUpdatePath || '';
   const boardId = opts.boardId || '1';
 
-  return new BoardService({
+  boardsStore.setEndpoints({
     boardsEndpoint,
     listsEndpoint,
     bulkUpdatePath,
     boardId,
   });
+
+  return new BoardService();
 };
 
 export const mockAssigneesList = [

From 6e560ea39bcd3f7ae43b5f76e9e4fb68e6708f74 Mon Sep 17 00:00:00 2001
From: GitalyBot <gitalybot@zjvandeweg.nl>
Date: Thu, 4 Jul 2019 14:18:08 +0000
Subject: [PATCH 061/195] Upgrade Gitaly to v1.51.0

---
 GITALY_SERVER_VERSION                            | 2 +-
 changelogs/unreleased/gitaly-version-v1.51.0.yml | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)
 create mode 100644 changelogs/unreleased/gitaly-version-v1.51.0.yml

diff --git a/GITALY_SERVER_VERSION b/GITALY_SERVER_VERSION
index 7f3a46a841e..ba0a719118c 100644
--- a/GITALY_SERVER_VERSION
+++ b/GITALY_SERVER_VERSION
@@ -1 +1 @@
-1.49.0
+1.51.0
diff --git a/changelogs/unreleased/gitaly-version-v1.51.0.yml b/changelogs/unreleased/gitaly-version-v1.51.0.yml
new file mode 100644
index 00000000000..00d52a190f3
--- /dev/null
+++ b/changelogs/unreleased/gitaly-version-v1.51.0.yml
@@ -0,0 +1,5 @@
+---
+title: Upgrade to Gitaly v1.51.0
+merge_request: 30353
+author:
+type: changed

From 4c32824640693cb1c8f4f18f1d4264aee128198b Mon Sep 17 00:00:00 2001
From: Eugenia Grieff <egrieff@gitlab.com>
Date: Thu, 4 Jul 2019 14:24:56 +0000
Subject: [PATCH 062/195] Add documentation on quick actions for add/remove
 epic parent relations.

---
 doc/user/project/quick_actions.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/user/project/quick_actions.md b/doc/user/project/quick_actions.md
index 1281ba561b8..01371b43819 100644
--- a/doc/user/project/quick_actions.md
+++ b/doc/user/project/quick_actions.md
@@ -88,3 +88,5 @@ The following quick actions are applicable for epics threads and description:
 | `/relabel ~label1 ~label2` | Replace label                           |
 | <code>/child_epic &lt;&epic &#124;  group&epic &#124; Epic URL&gt;</code> | Adds child epic to epic ([introduced in GitLab 12.0](https://gitlab.com/gitlab-org/gitlab-ee/issues/7330)) |
 | <code>/remove_child_epic &lt;&epic &#124; group&epic &#124; Epic URL&gt;</code> | Removes child epic from epic ([introduced in GitLab 12.0](https://gitlab.com/gitlab-org/gitlab-ee/issues/7330)) |
+| <code>/parent_epic &lt;&epic &#124;  group&epic &#124; Epic URL&gt;</code> | Sets parent epic to epic ([introduced in GitLab 12.1](https://gitlab.com/gitlab-org/gitlab-ee/issues/10556)) |
+| <code>/remove_parent_epic | Removes parent epic from epic ([introduced in GitLab 12.1](https://gitlab.com/gitlab-org/gitlab-ee/issues/10556)) |

From 4e68cf9457f7eefe3fb2cdbbc0f25901edd87bb6 Mon Sep 17 00:00:00 2001
From: Marin Jankovski <maxlazio@gmail.com>
Date: Thu, 4 Jul 2019 16:55:06 +0200
Subject: [PATCH 063/195] Definition of done includes deployed change

---
 doc/development/contributing/merge_request_workflow.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/development/contributing/merge_request_workflow.md b/doc/development/contributing/merge_request_workflow.md
index ce5d9786e6e..3f61ad7cb13 100644
--- a/doc/development/contributing/merge_request_workflow.md
+++ b/doc/development/contributing/merge_request_workflow.md
@@ -193,6 +193,7 @@ requirements.
 1. [Changelog entry added](../changelog.md), if necessary.
 1. Reviewed by relevant (UX/FE/BE/tech writing) reviewers and all concerns are addressed.
 1. Merged by a project maintainer.
+1. Confirmed to be working in the [Canary stage](https://about.gitlab.com/handbook/engineering/#canary-testing) or on GitLab.com once the contribution is deployed.
 1. Added to the [release post](https://about.gitlab.com/handbook/marketing/blog/release-posts/),
    if relevant.
 1. Added to [the website](https://gitlab.com/gitlab-com/www-gitlab-com/blob/master/data/features.yml), if relevant.

From 133b9f41088288a53d0b7cca0e9d5bab4a633567 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Kamil=20Trzci=C5=84ski?= <ayufan@ayufan.eu>
Date: Thu, 4 Jul 2019 15:46:46 +0200
Subject: [PATCH 064/195] Fix race in forbid_sidekiq_in_transactions.rb

Current code uses module attribute which stores value
global instead of locally (thread locally). This results
in concurrent accesses to overwrite the each other values
---
 .../fix-sidekiq-transaction-check-race.yml          |  5 +++++
 .../initializers/forbid_sidekiq_in_transactions.rb  | 13 +++++++------
 2 files changed, 12 insertions(+), 6 deletions(-)
 create mode 100644 changelogs/unreleased/fix-sidekiq-transaction-check-race.yml

diff --git a/changelogs/unreleased/fix-sidekiq-transaction-check-race.yml b/changelogs/unreleased/fix-sidekiq-transaction-check-race.yml
new file mode 100644
index 00000000000..89ae4abfe11
--- /dev/null
+++ b/changelogs/unreleased/fix-sidekiq-transaction-check-race.yml
@@ -0,0 +1,5 @@
+---
+title: Fix race in forbid_sidekiq_in_transactions.rb
+merge_request: 30359
+author:
+type: fixed
diff --git a/config/initializers/forbid_sidekiq_in_transactions.rb b/config/initializers/forbid_sidekiq_in_transactions.rb
index a69f1ba090e..bb190af60b5 100644
--- a/config/initializers/forbid_sidekiq_in_transactions.rb
+++ b/config/initializers/forbid_sidekiq_in_transactions.rb
@@ -2,15 +2,16 @@ module Sidekiq
   module Worker
     EnqueueFromTransactionError = Class.new(StandardError)
 
-    mattr_accessor :skip_transaction_check
-    self.skip_transaction_check = false
-
     def self.skipping_transaction_check(&block)
-      skip_transaction_check = self.skip_transaction_check
-      self.skip_transaction_check = true
+      previous_skip_transaction_check = self.skip_transaction_check
+      Thread.current[:sidekiq_worker_skip_transaction_check] = true
       yield
     ensure
-      self.skip_transaction_check = skip_transaction_check
+      Thread.current[:sidekiq_worker_skip_transaction_check] = previous_skip_transaction_check
+    end
+
+    def self.skip_transaction_check
+      Thread.current[:sidekiq_worker_skip_transaction_check]
     end
 
     module ClassMethods

From c433082f89f65f944262040454e53ca460ec08be Mon Sep 17 00:00:00 2001
From: Christie Lenneville <clenneville@gitlab.com>
Date: Thu, 4 Jul 2019 15:45:54 +0000
Subject: [PATCH 065/195] Change 'Todo' to 'To Do'
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Currently, we label items to be done as "Todo." This is grammatically
incorrect and (therefore) confusing—especially to our Spanish-speaking
users for whom "todo" has a specific and unrelated meaning.

We should use "To Do" and always use it as singular (not "To Dos").

Updates to wording in a few places per MR (ee) discussion

Updating locale/gitlab.pot

Updates to wording in a few places per MR (ee) discussion

Updating locale/gitlab.pot
---
 .../pages/dashboard/todos/index/todos.js      |   4 +-
 .../sidebar/components/todo_toggle/todo.vue   |   4 +-
 app/controllers/dashboard/todos_controller.rb |   4 +-
 app/helpers/issuables_helper.rb               |   4 +-
 app/helpers/preferences_helper.rb             |   2 +-
 app/views/dashboard/todos/_todo.html.haml     |   2 +-
 app/views/dashboard/todos/index.html.haml     |  24 +--
 app/views/layouts/header/_default.html.haml   |   2 +-
 app/views/shared/issuable/_sidebar.html.haml  |   2 +-
 changelogs/unreleased/update-todo-in-ui.yml   |   5 +
 config/no_todos_messages.yml                  |   8 +-
 .../project/issues/issue_data_and_actions.md  |  19 ++-
 doc/user/project/quick_actions.md             |   8 +-
 doc/user/search/index.md                      |   6 +-
 doc/workflow/todos.md                         | 138 ++++++++++--------
 lib/gitlab/quick_actions/issuable_actions.rb  |   4 +-
 locale/gitlab.pot                             |  40 ++---
 spec/features/dashboard/shortcuts_spec.rb     |   2 +-
 spec/features/dashboard/todos/todos_spec.rb   |  14 +-
 spec/features/issues/todo_spec.rb             |   8 +-
 spec/helpers/preferences_helper_spec.rb       |   2 +-
 .../collapsed_sidebar_todo_spec.js            |  16 +-
 spec/javascripts/sidebar/todo_spec.js         |   8 +-
 23 files changed, 181 insertions(+), 145 deletions(-)
 create mode 100644 changelogs/unreleased/update-todo-in-ui.yml

diff --git a/app/assets/javascripts/pages/dashboard/todos/index/todos.js b/app/assets/javascripts/pages/dashboard/todos/index/todos.js
index 1b56b97f751..d51d411f3c6 100644
--- a/app/assets/javascripts/pages/dashboard/todos/index/todos.js
+++ b/app/assets/javascripts/pages/dashboard/todos/index/todos.js
@@ -82,7 +82,7 @@ export default class Todos {
       })
       .catch(() => {
         this.updateRowState(target, true);
-        return flash(__('Error updating todo status.'));
+        return flash(__('Error updating status of to-do item.'));
       });
   }
 
@@ -124,7 +124,7 @@ export default class Todos {
         this.updateAllState(target, data);
         this.updateBadges(data);
       })
-      .catch(() => flash(__('Error updating status for all todos.')));
+      .catch(() => flash(__('Error updating status for all to-do items.')));
   }
 
   updateAllState(target, data) {
diff --git a/app/assets/javascripts/sidebar/components/todo_toggle/todo.vue b/app/assets/javascripts/sidebar/components/todo_toggle/todo.vue
index 57125c78cf6..e6f2fe2b5fc 100644
--- a/app/assets/javascripts/sidebar/components/todo_toggle/todo.vue
+++ b/app/assets/javascripts/sidebar/components/todo_toggle/todo.vue
@@ -5,8 +5,8 @@ import { GlLoadingIcon } from '@gitlab/ui';
 
 import Icon from '~/vue_shared/components/icon.vue';
 
-const MARK_TEXT = __('Mark todo as done');
-const TODO_TEXT = __('Add todo');
+const MARK_TEXT = __('Mark as done');
+const TODO_TEXT = __('Add a To Do');
 
 export default {
   directives: {
diff --git a/app/controllers/dashboard/todos_controller.rb b/app/controllers/dashboard/todos_controller.rb
index 27980466a42..8f6fcb362d2 100644
--- a/app/controllers/dashboard/todos_controller.rb
+++ b/app/controllers/dashboard/todos_controller.rb
@@ -22,7 +22,7 @@ class Dashboard::TodosController < Dashboard::ApplicationController
       format.html do
         redirect_to dashboard_todos_path,
                     status: 302,
-                    notice: _('Todo was successfully marked as done.')
+                    notice: _('To-do item successfully marked as done.')
       end
       format.js { head :ok }
       format.json { render json: todos_counts }
@@ -33,7 +33,7 @@ class Dashboard::TodosController < Dashboard::ApplicationController
     updated_ids = TodoService.new.mark_todos_as_done(@todos, current_user)
 
     respond_to do |format|
-      format.html { redirect_to dashboard_todos_path, status: 302, notice: _('All todos were marked as done.') }
+      format.html { redirect_to dashboard_todos_path, status: 302, notice: _('Everything on your to-do list is marked as done.') }
       format.js { head :ok }
       format.json { render json: todos_counts.merge(updated_ids: updated_ids) }
     end
diff --git a/app/helpers/issuables_helper.rb b/app/helpers/issuables_helper.rb
index cd2669ef6ad..67685ba4e1d 100644
--- a/app/helpers/issuables_helper.rb
+++ b/app/helpers/issuables_helper.rb
@@ -390,8 +390,8 @@ module IssuablesHelper
 
   def issuable_todo_button_data(issuable, is_collapsed)
     {
-      todo_text: _('Add todo'),
-      mark_text: _('Mark todo as done'),
+      todo_text: _('Add a To Do'),
+      mark_text: _('Mark as done'),
       todo_icon: sprite_icon('todo-add'),
       mark_icon: sprite_icon('todo-done', css_class: 'todo-undone'),
       issuable_id: issuable[:id],
diff --git a/app/helpers/preferences_helper.rb b/app/helpers/preferences_helper.rb
index 766508b6609..3672d8b1b03 100644
--- a/app/helpers/preferences_helper.rb
+++ b/app/helpers/preferences_helper.rb
@@ -16,7 +16,7 @@ module PreferencesHelper
     project_activity: _("Your Projects' Activity"),
     starred_project_activity: _("Starred Projects' Activity"),
     groups: _("Your Groups"),
-    todos: _("Your Todos"),
+    todos: _("Your To-Do List"),
     issues: _("Assigned Issues"),
     merge_requests: _("Assigned Merge Requests"),
     operations: _("Operations Dashboard")
diff --git a/app/views/dashboard/todos/_todo.html.haml b/app/views/dashboard/todos/_todo.html.haml
index db6e40a6fd0..8cdfc7369a0 100644
--- a/app/views/dashboard/todos/_todo.html.haml
+++ b/app/views/dashboard/todos/_todo.html.haml
@@ -49,5 +49,5 @@
   - else
     .todo-actions
       = link_to restore_dashboard_todo_path(todo), method: :patch, class: 'btn btn-loading js-add-todo', data: { href: restore_dashboard_todo_path(todo) } do
-        Add todo
+        Add a To Do
         = icon('spinner spin')
diff --git a/app/views/dashboard/todos/index.html.haml b/app/views/dashboard/todos/index.html.haml
index 8212fb8bb33..731e763f2be 100644
--- a/app/views/dashboard/todos/index.html.haml
+++ b/app/views/dashboard/todos/index.html.haml
@@ -1,11 +1,11 @@
 - @hide_top_links = true
-- page_title "Todos"
-- header_title "Todos", dashboard_todos_path
+- page_title "To-Do List"
+- header_title "To-Do List", dashboard_todos_path
 
 = render_dashboard_gold_trial(current_user)
 
 .page-title-holder.d-flex.align-items-center
-  %h1.page-title= _('Todos')
+  %h1.page-title= _('To-Do List')
 
 - if current_user.todos.any?
   .top-area
@@ -13,7 +13,7 @@
       %li.todos-pending{ class: active_when(params[:state].blank? || params[:state] == 'pending') }>
         = link_to todos_filter_path(state: 'pending') do
           %span
-            Todos
+            To Do
           %span.badge.badge-pill
             = number_with_delimiter(todos_pending_count)
       %li.todos-done{ class: active_when(params[:state] == 'done') }>
@@ -102,24 +102,24 @@
         %p
           Are you looking for things to do? Take a look at
           = succeed "," do
-            = link_to "the opened issues", issues_dashboard_path
+            = link_to "open issues", issues_dashboard_path
           contribute to
-          = link_to "merge requests", merge_requests_dashboard_path
-          or mention someone in a comment to assign a new todo automatically.
+          = link_to "a merge request\,", merge_requests_dashboard_path
+          or mention someone in a comment to automatically assign them a new to-do item.
       - else
         %h4.text-center
-          There are no todos to show.
+          Nothing is on your to-do list. Nice work!
   - else
     .todos-empty
       .todos-empty-hero.svg-content
         = image_tag 'illustrations/todos_empty.svg'
       .todos-empty-content
         %h4
-          Todos let you see what you should do next
+          Your To-Do List shows what to work on next
         %p
-          When an issue or merge request is assigned to you, or when you
+          When an issue or merge request is assigned to you, or when you receive a
           %strong
             @mention
-          in a comment, this will trigger a new item in your todo list, automatically.
+          in a comment, this automatically triggers a new item in your To-Do List.
         %p
-          You will always know what to work on next.
+          It's how you always know what to work on next.
diff --git a/app/views/layouts/header/_default.html.haml b/app/views/layouts/header/_default.html.haml
index f8b7d0c530a..f9ee6f42e23 100644
--- a/app/views/layouts/header/_default.html.haml
+++ b/app/views/layouts/header/_default.html.haml
@@ -53,7 +53,7 @@
                   = number_with_delimiter(merge_requests_count)
           - if header_link?(:todos)
             = nav_link(controller: 'dashboard/todos', html_options: { class: "user-counter" }) do
-              = link_to dashboard_todos_path, title: _('Todos'), aria: { label: _('Todos') }, class: 'shortcuts-todos', data: {toggle: 'tooltip', placement: 'bottom', container: 'body'} do
+              = link_to dashboard_todos_path, title: _('To-Do List'), aria: { label: _('To-Do List') }, class: 'shortcuts-todos', data: {toggle: 'tooltip', placement: 'bottom', container: 'body'} do
                 = sprite_icon('todo-done', size: 16)
                 %span.badge.badge-pill.todos-count{ class: ('hidden' if todos_pending_count.zero?) }
                   = todos_count_format(todos_pending_count)
diff --git a/app/views/shared/issuable/_sidebar.html.haml b/app/views/shared/issuable/_sidebar.html.haml
index e87e560266f..b4f8377c008 100644
--- a/app/views/shared/issuable/_sidebar.html.haml
+++ b/app/views/shared/issuable/_sidebar.html.haml
@@ -10,7 +10,7 @@
     .block.issuable-sidebar-header
       - if signed_in
         %span.issuable-header-text.hide-collapsed.float-left
-          = _('Todo')
+          = _('To Do')
       %a.gutter-toggle.float-right.js-sidebar-toggle.has-tooltip{ role: "button", href: "#", "aria-label" => "Toggle sidebar", title: sidebar_gutter_tooltip_text, data: { container: 'body', placement: 'left', boundary: 'viewport' } }
         = sidebar_gutter_toggle_icon
       - if signed_in
diff --git a/changelogs/unreleased/update-todo-in-ui.yml b/changelogs/unreleased/update-todo-in-ui.yml
new file mode 100644
index 00000000000..dddcf0f3983
--- /dev/null
+++ b/changelogs/unreleased/update-todo-in-ui.yml
@@ -0,0 +1,5 @@
+---
+title: Changes "Todo" to "To Do" in the UI for clarity
+merge_request: 28844
+author:
+type: other
diff --git a/config/no_todos_messages.yml b/config/no_todos_messages.yml
index da721a9b6e6..d2076f235fd 100644
--- a/config/no_todos_messages.yml
+++ b/config/no_todos_messages.yml
@@ -4,8 +4,8 @@
 # If you come up with a fun one, please feel free to contribute it to GitLab!
 # https://about.gitlab.com/contributing/
 ---
-- Good job! Looks like you don't have any todos left
-- Isn't an empty todo list beautiful?
+- Good job! Looks like you don't have anything left on your To-Do List
+- Isn't an empty To-Do List beautiful?
 - Give yourself a pat on the back!
-- Nothing left to do, high five!
-- Henceforth you shall be known as "Todo Destroyer"
+- Nothing left to do. High five!
+- Henceforth, you shall be known as "To-Do Destroyer"
diff --git a/doc/user/project/issues/issue_data_and_actions.md b/doc/user/project/issues/issue_data_and_actions.md
index 9898cd6cf15..b34263f0eec 100644
--- a/doc/user/project/issues/issue_data_and_actions.md
+++ b/doc/user/project/issues/issue_data_and_actions.md
@@ -39,11 +39,14 @@ after it is closed.
 
 ![Report Abuse](img/report-abuse.png)
 
-#### 2. Todos
+#### 2. To Do
 
-You can click **add todo** to add the issue to your [GitLab Todo](../../../workflow/todos.md)
-list. If it is already on your todo list, the buttom will show **mark todo as done**,
-which you can click to mark that issue as done (which will be reflected in the Todo list).
+You can add issues to and remove issues from your [GitLab To-Do List](../../../workflow/todos.md).
+
+The button to do this has a different label depending on whether the issue is already on your To-Do List or not. If the issue is:
+
+- Already on your To-Do List: The button is labeled **Mark as done**. Click the button to remove the issue from your To-Do List.
+- Not on your To-Do List: The button is labelled **Add a To Do**. Click the button to add the issue to your To-Do List.
 
 #### 3. Assignee
 
@@ -206,6 +209,14 @@ You can filter what is displayed in the issue history by clicking on **Show all
 and selecting either **Show comments only**, which only shows discussions and hides
 updates to the issue, or **Show history only**, which hides discussions and only shows updates.
 
+- You can mention a user or a group present in your GitLab instance with
+  `@username` or `@groupname` and they will be notified via To-Do items 
+  and email, unless they have [disabled all notifications](#13-notifications)
+  in their profile settings.
+- Mentions for yourself (the current logged in user), will be highlighted
+  in a different color, allowing you to easily see which comments involve you,
+  helping you focus on them quickly.
+
 ![Show all activity](img/show-all-activity.png)
 
 #### 22. Create Merge Request
diff --git a/doc/user/project/quick_actions.md b/doc/user/project/quick_actions.md
index 01371b43819..d20b44d4b92 100644
--- a/doc/user/project/quick_actions.md
+++ b/doc/user/project/quick_actions.md
@@ -16,8 +16,8 @@ discussions, and descriptions:
 |:---------------------------|:------------------------------ |:------|:--------------|
 | `/tableflip <Comment>`     | Append the comment with `(╯°□°)╯︵ ┻━┻` | ✓ | ✓        |
 | `/shrug <Comment>`         | Append the comment with `¯\＿(ツ)＿/¯` | ✓ | ✓         |
-| `/todo`                    | Add a todo                     | ✓     | ✓             |
-| `/done`                    | Mark todo as done              | ✓     | ✓             |
+| `/todo`                    | Add a To Do                    | ✓     | ✓             |
+| `/done`                    | Mark To Do as done             | ✓     | ✓             |
 | `/subscribe`               | Subscribe                      | ✓     | ✓             |
 | `/unsubscribe`             | Unsubscribe                    | ✓     | ✓             |
 | `/close`                   | Close                          | ✓     | ✓             |
@@ -75,8 +75,8 @@ The following quick actions are applicable for epics threads and description:
 |:---------------------------|:----------------------------------------|
 | `/tableflip <Comment>`     | Append the comment with `(╯°□°)╯︵ ┻━┻` |
 | `/shrug <Comment>`         | Append the comment with `¯\＿(ツ)＿/¯`  |
-| `/todo`                    | Add a todo                              |
-| `/done`                    | Mark todo as done                       |
+| `/todo`                    | Add a To Do                              |
+| `/done`                    | Mark To Do as done                       |
 | `/subscribe`               | Subscribe                               |
 | `/unsubscribe`             | Unsubscribe                             |
 | `/close`                   | Close                                   |
diff --git a/doc/user/search/index.md b/doc/user/search/index.md
index bb6c48471c7..d6e2f036cf2 100644
--- a/doc/user/search/index.md
+++ b/doc/user/search/index.md
@@ -97,10 +97,10 @@ quickly access issues and merge requests created or assigned to you within that
 
 ![search per project - shortcut](img/project_search.png)
 
-## Todos
+## To-Do List
 
-Your [todos](../../workflow/todos.md#gitlab-todos) can be searched by "to do" and "done".
-You can [filter](../../workflow/todos.md#filtering-your-todos) them per project,
+Your [To-Do List](../../workflow/todos.md#gitlab-to-do-list) can be searched by "to do" and "done".
+You can [filter](../../workflow/todos.md#filtering-your-to-do-list) them per project,
 author, type, and action. Also, you can sort them by
 [**Label priority**](../../user/project/labels.md#label-priority),
 **Last created** and **Oldest created**.
diff --git a/doc/workflow/todos.md b/doc/workflow/todos.md
index 3eac79427cf..f501a222cd5 100644
--- a/doc/workflow/todos.md
+++ b/doc/workflow/todos.md
@@ -1,50 +1,57 @@
-# GitLab Todos
+# GitLab To-Do List
 
 > [Introduced][ce-2817] in GitLab 8.5.
 
 When you log into GitLab, you normally want to see where you should spend your
-time and take some action, or what you need to keep an eye on. All without the
-mess of a huge pile of e-mail notifications. GitLab is where you do your work,
-so being able to get started quickly is very important.
+time, take some action, or know what you need to keep an eye on without
+a huge pile of e-mail notifications. GitLab is where you do your work,
+so being able to get started quickly is important.
 
-Todos is a chronological list of to-dos that are waiting for your input, all
+Your To-Do List offers a chronological list of items that are waiting for your input, all
 in a simple dashboard.
 
-![Todos screenshot showing a list of items to check on](img/todos_index.png)
+![To Do screenshot showing a list of items to check on](img/todos_index.png)
 
 ---
 
-You can quickly access the Todos dashboard using the checkmark icon next to the
-search bar in the upper right corner. The number in blue is the number of Todos
-you still have open if the count is < 100, else it's 99+. The exact number
-will still be shown in the body of the _To do_ tab.
+You can quickly access your To-Do List by clicking the checkmark icon next to the
+search bar in the top navigation. If the count is:
 
-![Todos icon](img/todos_icon.png)
+- Less than 100, the number in blue is the number of To-Do items.
+- 100 or more, the number displays as 99+. The exact number displays
+  on the To-Do List.
+you still have open. Otherwise, the number displays as 99+. The exact number
+displays on the To-Do List.
 
-## What triggers a Todo
+![To Do icon](img/todos_icon.png)
 
-A Todo appears in your Todos dashboard when:
+## What triggers a To Do
 
-- an issue or merge request is assigned to you
-- you are `@mentioned` in the description or in a comment of an issue, merge request, or epic **[ULTIMATE]**
-- you are `@mentioned` in a comment on a commit,
-- a job in the CI pipeline running for your merge request failed, but this
-  job is not allowed to fail.
-- an open merge request becomes unmergeable due to conflict, and you are either:
-  - the author, or
-  - have set it to automatically merge once pipeline succeeds.
+A To Do displays on your To-Do List when:
 
-Todo triggers are not affected by [GitLab Notification Email settings](notifications.md).
+- An issue or merge request is assigned to you
+- You are `@mentioned` in the description or comment of an:
+    - Issue
+    - Merge Request
+    - Epic **[ULTIMATE]**
+- You are `@mentioned` in a comment on a commit
+- A job in the CI pipeline running for your merge request failed, but this
+  job is not allowed to fail
+- An open merge request becomes unmergeable due to conflict, and you are either: 
+    - The author 
+    - Have set it to automatically merge once the pipeline succeeds
+
+To-do triggers are not affected by [GitLab Notification Email settings](notifications.md).
 
 NOTE: **Note:**
-When an user no longer has access to a resource related to a Todo like an issue, merge request, project or group the related Todos, for security reasons, gets deleted within the next hour. The delete is delayed to prevent data loss in case user got their access revoked by mistake.
+When a user no longer has access to a resource related to a To Do (like an issue, merge request, project, or group) the related To-Do items are deleted within the next hour for security reasons. The delete is delayed to prevent data loss, in case the user's access was revoked by mistake.
 
-### Directly addressed Todos
+### Directly addressing a To Do
 
 > [Introduced][ce-7926] in GitLab 9.0.
 
-If you are mentioned at the start of a line, the todo you receive will be listed
-as 'directly addressed'. For instance, in this comment:
+If you are mentioned at the start of a line, the To Do you receive will be listed
+as 'directly addressed'. For example, in this comment:
 
 ```markdown
 @alice What do you think? cc: @bob
@@ -58,67 +65,80 @@ as 'directly addressed'. For instance, in this comment:
 @erin @frank thank you!
 ```
 
-The people receiving directly addressed todos are `@alice`, `@erin`, and
-`@frank`. Directly addressed todos only differ from mention todos in their type,
-for filtering; otherwise, they appear as normal.
+The people receiving directly addressed To-Do items are `@alice`, `@erin`, and
+`@frank`. Directly addressed To-Do items only differ from mentions in their type
+for filtering purposes; otherwise, they appear as normal.
 
-### Manually creating a Todo
+### Manually creating a To Do
 
-You can also add an issue, merge request or epic to your Todos dashboard by clicking
-the "Add todo" button in the sidebar of the issue, merge request, or epic **[ULTIMATE]**.
+You can also add the following to your To-Do List by clicking the **Add a To Do** button on an:
 
-![Adding a Todo from the issuable sidebar](img/todos_add_todo_sidebar.png)
+- Issue
+- Merge Request
+- Epic **[ULTIMATE]**
 
-## Marking a Todo as done
+![Adding a To Do from the issuable sidebar](img/todos_add_todo_sidebar.png)
 
-Any action to the corresponding issue, merge request or epic **[ULTIMATE]** will mark your Todo as
-**Done**. Actions that dismiss Todos include:
+## Marking a To Do as done
 
-- changing the assignee
-- changing the milestone
-- adding/removing a label
-- commenting on the issue
+Any action to the following will mark the corresponding To Do as done:
+
+- Issue
+- Merge Request
+- Epic **[ULTIMATE]**
+
+Actions that dismiss To-Do items include:
+
+- Changing the assignee
+- Changing the milestone
+- Adding/removing a label
+- Commenting on the issue
 
 ---
 
-Todos are personal, and they're only marked as done if the action is coming from
-you. If you close the issue or merge request, your Todo will automatically
-be marked as done.
+Your To-Do List is personal, and items are only marked as done if the action comes from
+you. If you close the issue or merge request, your To Do is automatically
+marked as done.
 
-If someone else closes, merges, or takes action on the issue, epic or merge
-request, your Todo will remain pending. This prevents other users from closing issues without you being notified.
+To prevent other users from closing issues without you being notified, if someone else closes, merges, or takes action on the any of the following, your To Do will remain pending:
 
-There is just one Todo per issue, epic or merge request, so mentioning a user a
-hundred times in an issue will only trigger one Todo.
+- Issue
+- Merge request
+- Epic **[ULTIMATE]**
+
+There is just one To Do for each of these, so mentioning a user a hundred times in an issue will only trigger one To Do.
 
 ---
 
-If no action is needed, you can manually mark the Todo as done by clicking the
-corresponding **Done** button, and it will disappear from your Todo list.
+If no action is needed, you can manually mark the To Do as done by clicking the
+corresponding **Done** button, and it will disappear from your To-Do List.
 
-![A Todo in the Todos dashboard](img/todo_list_item.png)
+![A To Do in the To-Do List](img/todo_list_item.png)
 
-A Todo can also be marked as done from the issue, merge request or epic sidebar using
-the "Mark todo as done" button.
+You can also mark a To Do as done by clicking the **Mark as done** button in the sidebar of the following:
 
-![Mark todo as done from the issuable sidebar](img/todos_mark_done_sidebar.png)
+- Issue
+- Merge Request
+- Epic **[ULTIMATE]**
 
-You can mark all your Todos as done at once by clicking on the **Mark all as
+![Mark as done from the issuable sidebar](img/todos_mark_done_sidebar.png)
+
+You can mark all your To-Do items as done at once by clicking the **Mark all as
 done** button.
 
-## Filtering your Todos
+## Filtering your To-Do List
 
-There are four kinds of filters you can use on your Todos dashboard.
+There are four kinds of filters you can use on your To-Do List.
 
 | Filter  | Description |
 | ------- | ----------- |
 | Project | Filter by project |
 | Group   | Filter by group |
-| Author  | Filter by the author that triggered the Todo |
+| Author  | Filter by the author that triggered the To Do |
 | Type    | Filter by issue, merge request, or epic **[ULTIMATE]** |
-| Action  | Filter by the action that triggered the Todo |
+| Action  | Filter by the action that triggered the To Do |
 
-You can also filter by more than one of these at the same time. The possible Actions are `Any Action`, `Assigned`, `Mentioned`, `Added`, `Pipelines`, and `Directly Addressed`, [as described above](#what-triggers-a-todo).
+You can also filter by more than one of these at the same time. The possible Actions are `Any Action`, `Assigned`, `Mentioned`, `Added`, `Pipelines`, and `Directly Addressed`, [as described above](#what-triggers-a-to-do).
 
 [ce-2817]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/2817
 [ce-7926]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/7926
diff --git a/lib/gitlab/quick_actions/issuable_actions.rb b/lib/gitlab/quick_actions/issuable_actions.rb
index 572c55efcc2..f7f89d4e897 100644
--- a/lib/gitlab/quick_actions/issuable_actions.rb
+++ b/lib/gitlab/quick_actions/issuable_actions.rb
@@ -146,8 +146,8 @@ module Gitlab
           @updates[:todo_event] = 'add'
         end
 
-        desc _('Mark todo as done')
-        explanation _('Marks todo as done.')
+        desc _('Mark to do as done')
+        explanation _('Marks to do as done.')
         types Issuable
         condition do
           quick_action_target.persisted? &&
diff --git a/locale/gitlab.pot b/locale/gitlab.pot
index ed6245bf242..01bf4949213 100644
--- a/locale/gitlab.pot
+++ b/locale/gitlab.pot
@@ -626,6 +626,9 @@ msgstr ""
 msgid "Add a Grafana button in the admin sidebar, monitoring section, to access a variety of statistics on the health and performance of GitLab."
 msgstr ""
 
+msgid "Add a To Do"
+msgstr ""
+
 msgid "Add a bullet list"
 msgstr ""
 
@@ -704,9 +707,6 @@ msgstr ""
 msgid "Add to review"
 msgstr ""
 
-msgid "Add todo"
-msgstr ""
-
 msgid "Add user(s) to the group:"
 msgstr ""
 
@@ -893,9 +893,6 @@ msgstr ""
 msgid "All projects"
 msgstr ""
 
-msgid "All todos were marked as done."
-msgstr ""
-
 msgid "All users"
 msgstr ""
 
@@ -4288,10 +4285,10 @@ msgstr ""
 msgid "Error updating %{issuableType}"
 msgstr ""
 
-msgid "Error updating status for all todos."
+msgid "Error updating status for all to-do items."
 msgstr ""
 
-msgid "Error updating todo status."
+msgid "Error updating status of to-do item."
 msgstr ""
 
 msgid "Error uploading file"
@@ -4390,6 +4387,9 @@ msgstr ""
 msgid "Everyone can contribute"
 msgstr ""
 
+msgid "Everything on your to-do list is marked as done."
+msgstr ""
+
 msgid "Everything you need to create a GitLab Pages site using GitBook."
 msgstr ""
 
@@ -6249,6 +6249,9 @@ msgstr ""
 msgid "March"
 msgstr ""
 
+msgid "Mark as done"
+msgstr ""
+
 msgid "Mark as resolved"
 msgstr ""
 
@@ -6258,7 +6261,7 @@ msgstr ""
 msgid "Mark this issue as a duplicate of another issue"
 msgstr ""
 
-msgid "Mark todo as done"
+msgid "Mark to do as done"
 msgstr ""
 
 msgid "Markdown"
@@ -6273,7 +6276,7 @@ msgstr ""
 msgid "Marks this issue as a duplicate of %{duplicate_reference}."
 msgstr ""
 
-msgid "Marks todo as done."
+msgid "Marks to do as done."
 msgstr ""
 
 msgid "Max access level"
@@ -11173,18 +11176,15 @@ msgstr ""
 msgid "To widen your search, change or remove filters above"
 msgstr ""
 
+msgid "To-Do List"
+msgstr ""
+
+msgid "To-do item successfully marked as done."
+msgstr ""
+
 msgid "Today"
 msgstr ""
 
-msgid "Todo"
-msgstr ""
-
-msgid "Todo was successfully marked as done."
-msgstr ""
-
-msgid "Todos"
-msgstr ""
-
 msgid "Toggle Sidebar"
 msgstr ""
 
@@ -12429,7 +12429,7 @@ msgstr ""
 msgid "Your SSH keys (%{count})"
 msgstr ""
 
-msgid "Your Todos"
+msgid "Your To-Do List"
 msgstr ""
 
 msgid "Your U2F device did not send a valid JSON response."
diff --git a/spec/features/dashboard/shortcuts_spec.rb b/spec/features/dashboard/shortcuts_spec.rb
index 55f5ff04d01..254bb12573c 100644
--- a/spec/features/dashboard/shortcuts_spec.rb
+++ b/spec/features/dashboard/shortcuts_spec.rb
@@ -22,7 +22,7 @@ describe 'Dashboard shortcuts', :js do
 
       find('body').send_keys([:shift, 'T'])
 
-      check_page_title('Todos')
+      check_page_title('To-Do List')
 
       find('body').send_keys([:shift, 'P'])
 
diff --git a/spec/features/dashboard/todos/todos_spec.rb b/spec/features/dashboard/todos/todos_spec.rb
index d58e3b2841e..c48229fc0a0 100644
--- a/spec/features/dashboard/todos/todos_spec.rb
+++ b/spec/features/dashboard/todos/todos_spec.rb
@@ -13,7 +13,7 @@ describe 'Dashboard Todos' do
     end
 
     it 'shows "All done" message' do
-      expect(page).to have_content 'Todos let you see what you should do next'
+      expect(page).to have_content 'Your To-Do List shows what to work on next'
     end
   end
 
@@ -72,7 +72,7 @@ describe 'Dashboard Todos' do
       end
 
       it 'updates todo count' do
-        expect(page).to have_content 'Todos 0'
+        expect(page).to have_content 'To Do 0'
         expect(page).to have_content 'Done 1'
       end
 
@@ -101,7 +101,7 @@ describe 'Dashboard Todos' do
       end
 
       it 'updates todo count' do
-        expect(page).to have_content 'Todos 1'
+        expect(page).to have_content 'To Do 1'
         expect(page).to have_content 'Done 0'
       end
     end
@@ -211,7 +211,7 @@ describe 'Dashboard Todos' do
     describe 'restoring the todo' do
       before do
         within first('.todo') do
-          click_link 'Add todo'
+          click_link 'Add a To Do'
         end
       end
 
@@ -220,7 +220,7 @@ describe 'Dashboard Todos' do
       end
 
       it 'updates todo count' do
-        expect(page).to have_content 'Todos 1'
+        expect(page).to have_content 'To Do 1'
         expect(page).to have_content 'Done 0'
       end
     end
@@ -276,7 +276,7 @@ describe 'Dashboard Todos' do
       end
 
       it 'shows "All done" message!' do
-        expect(page).to have_content 'Todos 0'
+        expect(page).to have_content 'To Do 0'
         expect(page).to have_content "You're all done!"
         expect(page).not_to have_selector('.gl-pagination')
       end
@@ -303,7 +303,7 @@ describe 'Dashboard Todos' do
       it 'updates todo count' do
         mark_all_and_undo
 
-        expect(page).to have_content 'Todos 2'
+        expect(page).to have_content 'To Do 2'
         expect(page).to have_content 'Done 0'
       end
 
diff --git a/spec/features/issues/todo_spec.rb b/spec/features/issues/todo_spec.rb
index 0114178b9be..07ae159eef4 100644
--- a/spec/features/issues/todo_spec.rb
+++ b/spec/features/issues/todo_spec.rb
@@ -13,8 +13,8 @@ describe 'Manually create a todo item from issue', :js do
 
   it 'creates todo when clicking button' do
     page.within '.issuable-sidebar' do
-      click_button 'Add todo'
-      expect(page).to have_content 'Mark todo as done'
+      click_button 'Add a To Do'
+      expect(page).to have_content 'Mark as done'
     end
 
     page.within '.header-content .todos-count' do
@@ -30,8 +30,8 @@ describe 'Manually create a todo item from issue', :js do
 
   it 'marks a todo as done' do
     page.within '.issuable-sidebar' do
-      click_button 'Add todo'
-      click_button 'Mark todo as done'
+      click_button 'Add a To Do'
+      click_button 'Mark as done'
     end
 
     expect(page).to have_selector('.todos-count', visible: false)
diff --git a/spec/helpers/preferences_helper_spec.rb b/spec/helpers/preferences_helper_spec.rb
index db0d45c3692..554c08add2d 100644
--- a/spec/helpers/preferences_helper_spec.rb
+++ b/spec/helpers/preferences_helper_spec.rb
@@ -28,7 +28,7 @@ describe PreferencesHelper do
         ["Your Projects' Activity", 'project_activity'],
         ["Starred Projects' Activity", 'starred_project_activity'],
         ["Your Groups", 'groups'],
-        ["Your Todos", 'todos'],
+        ["Your To-Do List", 'todos'],
         ["Assigned Issues", 'issues'],
         ["Assigned Merge Requests", 'merge_requests']
       ]
diff --git a/spec/javascripts/collapsed_sidebar_todo_spec.js b/spec/javascripts/collapsed_sidebar_todo_spec.js
index bb90e53e525..f75d63c8f57 100644
--- a/spec/javascripts/collapsed_sidebar_todo_spec.js
+++ b/spec/javascripts/collapsed_sidebar_todo_spec.js
@@ -58,7 +58,7 @@ describe('Issuable right sidebar collapsed todo toggle', () => {
   it('sets default tooltip title', () => {
     expect(
       document.querySelector('.js-issuable-todo.sidebar-collapsed-icon').getAttribute('title'),
-    ).toBe('Add todo');
+    ).toBe('Add a To Do');
   });
 
   it('toggle todo state', done => {
@@ -85,7 +85,7 @@ describe('Issuable right sidebar collapsed todo toggle', () => {
     setTimeout(() => {
       expect(
         document.querySelector('.issuable-sidebar-header .js-issuable-todo').textContent.trim(),
-      ).toBe('Mark todo as done');
+      ).toBe('Mark as done');
 
       done();
     });
@@ -99,7 +99,7 @@ describe('Issuable right sidebar collapsed todo toggle', () => {
         document
           .querySelector('.js-issuable-todo.sidebar-collapsed-icon')
           .getAttribute('data-original-title'),
-      ).toBe('Mark todo as done');
+      ).toBe('Mark as done');
 
       done();
     });
@@ -124,13 +124,13 @@ describe('Issuable right sidebar collapsed todo toggle', () => {
 
         expect(
           document.querySelector('.issuable-sidebar-header .js-issuable-todo').textContent.trim(),
-        ).toBe('Add todo');
+        ).toBe('Add a To Do');
       })
       .then(done)
       .catch(done.fail);
   });
 
-  it('updates aria-label to mark todo as done', done => {
+  it('updates aria-label to Mark as done', done => {
     document.querySelector('.js-issuable-todo.sidebar-collapsed-icon').click();
 
     setTimeout(() => {
@@ -138,7 +138,7 @@ describe('Issuable right sidebar collapsed todo toggle', () => {
         document
           .querySelector('.js-issuable-todo.sidebar-collapsed-icon')
           .getAttribute('aria-label'),
-      ).toBe('Mark todo as done');
+      ).toBe('Mark as done');
 
       done();
     });
@@ -153,7 +153,7 @@ describe('Issuable right sidebar collapsed todo toggle', () => {
           document
             .querySelector('.js-issuable-todo.sidebar-collapsed-icon')
             .getAttribute('aria-label'),
-        ).toBe('Mark todo as done');
+        ).toBe('Mark as done');
 
         document.querySelector('.js-issuable-todo.sidebar-collapsed-icon').click();
       })
@@ -163,7 +163,7 @@ describe('Issuable right sidebar collapsed todo toggle', () => {
           document
             .querySelector('.js-issuable-todo.sidebar-collapsed-icon')
             .getAttribute('aria-label'),
-        ).toBe('Add todo');
+        ).toBe('Add a To Do');
       })
       .then(done)
       .catch(done.fail);
diff --git a/spec/javascripts/sidebar/todo_spec.js b/spec/javascripts/sidebar/todo_spec.js
index f46ea5a0499..e7abd19c865 100644
--- a/spec/javascripts/sidebar/todo_spec.js
+++ b/spec/javascripts/sidebar/todo_spec.js
@@ -53,14 +53,14 @@ describe('SidebarTodo', () => {
 
     describe('buttonLabel', () => {
       it('returns todo button text for marking todo as done when `isTodo` prop is `true`', () => {
-        expect(vm.buttonLabel).toBe('Mark todo as done');
+        expect(vm.buttonLabel).toBe('Mark as done');
       });
 
       it('returns todo button text for add todo when `isTodo` prop is `false`', done => {
         vm.isTodo = false;
         Vue.nextTick()
           .then(() => {
-            expect(vm.buttonLabel).toBe('Add todo');
+            expect(vm.buttonLabel).toBe('Add a To Do');
           })
           .then(done)
           .catch(done.fail);
@@ -131,14 +131,14 @@ describe('SidebarTodo', () => {
     });
 
     it('check button label computed property', () => {
-      expect(vm.buttonLabel).toEqual('Mark todo as done');
+      expect(vm.buttonLabel).toEqual('Mark as done');
     });
 
     it('renders button label element when `collapsed` prop is `false`', () => {
       const buttonLabelEl = vm.$el.querySelector('span.issuable-todo-inner');
 
       expect(buttonLabelEl).not.toBeNull();
-      expect(buttonLabelEl.innerText.trim()).toBe('Mark todo as done');
+      expect(buttonLabelEl.innerText.trim()).toBe('Mark as done');
     });
 
     it('renders button icon when `collapsed` prop is `true`', done => {

From d132f73d42aec530c78680f53bf8a612bac61a3b Mon Sep 17 00:00:00 2001
From: Mayra Cabrera <mcabrera@gitlab.com>
Date: Thu, 4 Jul 2019 15:52:02 +0000
Subject: [PATCH 066/195] Implements lease_release on NamespaceAggregation

Sets lease_release? to false to prevent the job to be re-executed more
often than lease timeout

Closes https://gitlab.com/gitlab-org/gitlab-ce/issues/64079
---
 app/models/namespace/aggregation_schedule.rb  |  8 ++++
 .../namespace/aggregation_schedule_spec.rb    | 31 ++++++++++++-
 .../schedule_aggregation_worker_spec.rb       | 43 ++++++++++++-------
 3 files changed, 65 insertions(+), 17 deletions(-)

diff --git a/app/models/namespace/aggregation_schedule.rb b/app/models/namespace/aggregation_schedule.rb
index 355593597c6..0bef352cf24 100644
--- a/app/models/namespace/aggregation_schedule.rb
+++ b/app/models/namespace/aggregation_schedule.rb
@@ -44,4 +44,12 @@ class Namespace::AggregationSchedule < ApplicationRecord
   def lease_key
     "namespace:namespaces_root_statistics:#{namespace_id}"
   end
+
+  # Used by ExclusiveLeaseGuard
+  # Overriding value as we never release the lease
+  # before the timeout in order to prevent multiple
+  # RootStatisticsWorker to start in a short span of time
+  def lease_release?
+    false
+  end
 end
diff --git a/spec/models/namespace/aggregation_schedule_spec.rb b/spec/models/namespace/aggregation_schedule_spec.rb
index 8ed0248e1b2..0f1283717e0 100644
--- a/spec/models/namespace/aggregation_schedule_spec.rb
+++ b/spec/models/namespace/aggregation_schedule_spec.rb
@@ -53,10 +53,39 @@ RSpec.describe Namespace::AggregationSchedule, :clean_gitlab_redis_shared_state,
 
         expect(Namespaces::RootStatisticsWorker)
           .to receive(:perform_in).once
-          .with(described_class::DEFAULT_LEASE_TIMEOUT, aggregation_schedule.namespace_id )
+          .with(described_class::DEFAULT_LEASE_TIMEOUT, aggregation_schedule.namespace_id)
 
         aggregation_schedule.save!
       end
+
+      it 'does not release the lease' do
+        stub_exclusive_lease(lease_key, timeout: described_class::DEFAULT_LEASE_TIMEOUT)
+
+        aggregation_schedule.save!
+
+        exclusive_lease = aggregation_schedule.exclusive_lease
+        expect(exclusive_lease.exists?).to be_truthy
+      end
+
+      it 'only executes the workers once' do
+        # Avoid automatic deletion of Namespace::AggregationSchedule
+        # for testing purposes.
+        expect(Namespaces::RootStatisticsWorker)
+          .to receive(:perform_async).once
+          .and_return(nil)
+
+        expect(Namespaces::RootStatisticsWorker)
+          .to receive(:perform_in).once
+          .with(described_class::DEFAULT_LEASE_TIMEOUT, aggregation_schedule.namespace_id)
+          .and_return(nil)
+
+        # Scheduling workers for the first time
+        aggregation_schedule.schedule_root_storage_statistics
+
+        # Executing again, this time workers should not be scheduled
+        # due to the lease not been released.
+        aggregation_schedule.schedule_root_storage_statistics
+      end
     end
 
     context 'with a personalized lease timeout' do
diff --git a/spec/workers/namespaces/schedule_aggregation_worker_spec.rb b/spec/workers/namespaces/schedule_aggregation_worker_spec.rb
index 7432ca12f2a..d4a49a3f53a 100644
--- a/spec/workers/namespaces/schedule_aggregation_worker_spec.rb
+++ b/spec/workers/namespaces/schedule_aggregation_worker_spec.rb
@@ -2,7 +2,7 @@
 
 require 'spec_helper'
 
-describe Namespaces::ScheduleAggregationWorker, '#perform' do
+describe Namespaces::ScheduleAggregationWorker, '#perform', :clean_gitlab_redis_shared_state do
   let(:group) { create(:group) }
 
   subject(:worker) { described_class.new }
@@ -10,6 +10,8 @@ describe Namespaces::ScheduleAggregationWorker, '#perform' do
   context 'when group is the root ancestor' do
     context 'when aggregation schedule exists' do
       it 'does not create a new one' do
+        stub_aggregation_schedule_statistics
+
         Namespace::AggregationSchedule.safe_find_or_create_by!(namespace_id: group.id)
 
         expect do
@@ -18,6 +20,18 @@ describe Namespaces::ScheduleAggregationWorker, '#perform' do
       end
     end
 
+    context 'when aggregation schedule does not exist' do
+      it 'creates one' do
+        stub_aggregation_schedule_statistics
+
+        expect do
+          worker.perform(group.id)
+        end.to change(Namespace::AggregationSchedule, :count).by(1)
+
+        expect(group.aggregation_schedule).to be_present
+      end
+    end
+
     context 'when update_statistics_namespace is off' do
       it 'does not create a new one' do
         stub_feature_flags(update_statistics_namespace: false, namespace: group)
@@ -27,19 +41,6 @@ describe Namespaces::ScheduleAggregationWorker, '#perform' do
         end.not_to change(Namespace::AggregationSchedule, :count)
       end
     end
-
-    context 'when aggregation schedule does not exist' do
-      it 'creates one' do
-        allow_any_instance_of(Namespace::AggregationSchedule)
-          .to receive(:schedule_root_storage_statistics).and_return(nil)
-
-        expect do
-          worker.perform(group.id)
-        end.to change(Namespace::AggregationSchedule, :count).by(1)
-
-        expect(group.aggregation_schedule).to be_present
-      end
-    end
   end
 
   context 'when group is not the root ancestor' do
@@ -47,8 +48,7 @@ describe Namespaces::ScheduleAggregationWorker, '#perform' do
     let(:group) { create(:group, parent: parent_group) }
 
     it 'creates an aggregation schedule for the root' do
-      allow_any_instance_of(Namespace::AggregationSchedule)
-        .to receive(:schedule_root_storage_statistics).and_return(nil)
+      stub_aggregation_schedule_statistics
 
       worker.perform(group.id)
 
@@ -63,4 +63,15 @@ describe Namespaces::ScheduleAggregationWorker, '#perform' do
       worker.perform(12345)
     end
   end
+
+  def stub_aggregation_schedule_statistics
+    # Namespace::Aggregations are deleted by
+    # Namespace::AggregationSchedule::schedule_root_storage_statistics,
+    # which is executed async. Stubing the service so instances are not deleted
+    # while still running the specs.
+    expect_next_instance_of(Namespace::AggregationSchedule) do |aggregation_schedule|
+      expect(aggregation_schedule)
+        .to receive(:schedule_root_storage_statistics)
+    end
+  end
 end

From 69e1ed0dc85be33395d5c050923c71b53268b2a2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9my=20Coutable?= <remy@rymai.me>
Date: Fri, 28 Jun 2019 09:18:28 +0200
Subject: [PATCH 067/195] Retry review-deploy only once
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Rémy Coutable <remy@rymai.me>
---
 .gitlab/ci/review.gitlab-ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.gitlab/ci/review.gitlab-ci.yml b/.gitlab/ci/review.gitlab-ci.yml
index 61fd48fd72e..ce019de213b 100644
--- a/.gitlab/ci/review.gitlab-ci.yml
+++ b/.gitlab/ci/review.gitlab-ci.yml
@@ -77,7 +77,7 @@ schedule:review-build-cng:
 .review-deploy-base: &review-deploy-base
   <<: *review-base
   allow_failure: true
-  retry: 2
+  retry: 1
   stage: review
   variables:
     HOST_SUFFIX: "${CI_ENVIRONMENT_SLUG}"

From 29dbac2e124f67f27407d2f9324730b223f7846b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9my=20Coutable?= <remy@rymai.me>
Date: Fri, 28 Jun 2019 11:38:38 +0200
Subject: [PATCH 068/195] Add resources requests and limits for all Review Apps
 resources
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Rémy Coutable <remy@rymai.me>
---
 scripts/review_apps/review-apps.sh | 128 +++++++++++++++++++++++------
 1 file changed, 105 insertions(+), 23 deletions(-)

diff --git a/scripts/review_apps/review-apps.sh b/scripts/review_apps/review-apps.sh
index 633ea28e96c..2bf654b1e24 100755
--- a/scripts/review_apps/review-apps.sh
+++ b/scripts/review_apps/review-apps.sh
@@ -131,6 +131,7 @@ function install_external_dns() {
   if ! deploy_exists "${KUBE_NAMESPACE}" "${release_name}" || previous_deploy_failed "${release_name}" ; then
     echoinfo "Installing external-dns Helm chart"
     helm repo update
+    # Default requested: CPU => 0, memory => 0
     helm install stable/external-dns \
       -n "${release_name}" \
       --namespace "${KUBE_NAMESPACE}" \
@@ -141,7 +142,11 @@ function install_external_dns() {
       --set domainFilters[0]="${domain}" \
       --set txtOwnerId="${KUBE_NAMESPACE}" \
       --set rbac.create="true" \
-      --set policy="sync"
+      --set policy="sync" \
+      --set resources.requests.cpu=50m \
+      --set resources.limits.cpu=100m \
+      --set resources.requests.memory=100M \
+      --set resources.limits.memory=200M
   else
     echoinfo "The external-dns Helm chart is already successfully deployed."
   fi
@@ -196,45 +201,122 @@ HELM_CMD=$(cat << EOF
   helm upgrade --install \
     --wait \
     --timeout 600 \
-    --set global.appConfig.enableUsagePing=false \
     --set releaseOverride="$CI_ENVIRONMENT_SLUG" \
+    --set global.appConfig.enableUsagePing=false \
     --set global.imagePullPolicy=Always \
     --set global.hosts.hostSuffix="$HOST_SUFFIX" \
     --set global.hosts.domain="$REVIEW_APPS_DOMAIN" \
-    --set certmanager.install=false \
-    --set prometheus.install=false \
     --set global.ingress.configureCertmanager=false \
     --set global.ingress.tls.secretName=tls-cert \
     --set global.ingress.annotations."external-dns\.alpha\.kubernetes\.io/ttl"="10" \
+    --set certmanager.install=false \
+    --set prometheus.install=false \
     --set nginx-ingress.controller.service.enableHttp=false \
-    --set nginx-ingress.defaultBackend.resources.requests.memory=7Mi \
-    --set nginx-ingress.controller.resources.requests.memory=440M \
     --set nginx-ingress.controller.replicaCount=2 \
-    --set gitlab.unicorn.resources.requests.cpu=200m \
-    --set gitlab.sidekiq.resources.requests.cpu=100m \
-    --set gitlab.sidekiq.resources.requests.memory=800M \
-    --set gitlab.gitlab-shell.resources.requests.cpu=100m \
-    --set redis.resources.requests.cpu=100m \
-    --set minio.resources.requests.cpu=100m \
+    --set nginx-ingress.controller.config.ssl-ciphers="ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-SHA:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-SHA256:AES128-SHA256:AES256-SHA:AES128-SHA:!aNULL:!eNULL:!EXPORT:!DES:!MD5:!PSK:!RC4" \
     --set gitlab.migrations.image.repository="$gitlab_migrations_image_repository" \
     --set gitlab.migrations.image.tag="$CI_COMMIT_REF_SLUG" \
-    --set gitlab.sidekiq.image.repository="$gitlab_sidekiq_image_repository" \
-    --set gitlab.sidekiq.image.tag="$CI_COMMIT_REF_SLUG" \
-    --set gitlab.unicorn.image.repository="$gitlab_unicorn_image_repository" \
-    --set gitlab.unicorn.image.tag="$CI_COMMIT_REF_SLUG" \
-    --set gitlab.task-runner.image.repository="$gitlab_task_runner_image_repository" \
-    --set gitlab.task-runner.image.tag="$CI_COMMIT_REF_SLUG" \
     --set gitlab.gitaly.image.repository="$gitlab_gitaly_image_repository" \
     --set gitlab.gitaly.image.tag="v$GITALY_VERSION" \
     --set gitlab.gitlab-shell.image.repository="$gitlab_shell_image_repository" \
     --set gitlab.gitlab-shell.image.tag="v$GITLAB_SHELL_VERSION" \
+    --set gitlab.sidekiq.image.repository="$gitlab_sidekiq_image_repository" \
+    --set gitlab.sidekiq.image.tag="$CI_COMMIT_REF_SLUG" \
+    --set gitlab.unicorn.image.repository="$gitlab_unicorn_image_repository" \
+    --set gitlab.unicorn.image.tag="$CI_COMMIT_REF_SLUG" \
     --set gitlab.unicorn.workhorse.image="$gitlab_workhorse_image_repository" \
     --set gitlab.unicorn.workhorse.tag="$CI_COMMIT_REF_SLUG" \
-    --set nginx-ingress.controller.config.ssl-ciphers="ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-SHA:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-SHA256:AES128-SHA256:AES256-SHA:AES128-SHA:!aNULL:!eNULL:!EXPORT:!DES:!MD5:!PSK:!RC4" \
-    --namespace="$KUBE_NAMESPACE" \
-    --version="$CI_PIPELINE_ID-$CI_JOB_ID" \
-    "$name" \
-    .
+    --set gitlab.task-runner.image.repository="$gitlab_task_runner_image_repository" \
+    --set gitlab.task-runner.image.tag="$CI_COMMIT_REF_SLUG"
+EOF
+)
+
+# Default requested: CPU => 100m, memory => 100Mi
+HELM_CMD=$(cat << EOF
+  $HELM_CMD \
+  --set nginx-ingress.controller.resources.limits.cpu=200m \
+  --set nginx-ingress.controller.resources.requests.memory=210M \
+  --set nginx-ingress.controller.resources.limits.memory=420M
+EOF
+)
+
+# Default requested: CPU => 5m, memory => 5Mi
+HELM_CMD=$(cat << EOF
+  $HELM_CMD \
+  --set nginx-ingress.defaultBackend.resources.limits.cpu=10m \
+  --set nginx-ingress.defaultBackend.resources.requests.memory=12M \
+  --set nginx-ingress.defaultBackend.resources.limits.memory=24M
+EOF
+)
+
+# Default requested: CPU => 100m, memory => 200Mi
+HELM_CMD=$(cat << EOF
+  $HELM_CMD \
+  --set gitlab.gitaly.resources.requests.cpu=150m \
+  --set gitlab.gitaly.resources.limits.cpu=300m \
+  --set gitlab.gitaly.resources.limits.memory=420M
+EOF
+)
+
+# Default requested: CPU => 0, memory => 6M
+HELM_CMD=$(cat << EOF
+  $HELM_CMD \
+  --set gitlab.gitlab-shell.resources.requests.cpu=70m \
+  --set gitlab.gitlab-shell.resources.limits.cpu=140m \
+  --set gitlab.gitlab-shell.resources.requests.memory=20M \
+  --set gitlab.gitlab-shell.resources.limits.memory=40M
+EOF
+)
+
+# Default requested: CPU => 50m, memory => 650M
+HELM_CMD=$(cat << EOF
+  $HELM_CMD \
+  --set gitlab.sidekiq.resources.requests.cpu=200m \
+  --set gitlab.sidekiq.resources.limits.cpu=300m \
+  --set gitlab.sidekiq.resources.requests.memory=800M \
+  --set gitlab.sidekiq.resources.limits.memory=1.2G
+EOF
+)
+
+# Default requested: CPU => 300m + 100m (workhorse), memory => 1.2G + 100M (workhorse)
+HELM_CMD=$(cat << EOF
+  $HELM_CMD \
+  --set gitlab.unicorn.resources.limits.cpu=800m \
+  --set gitlab.unicorn.resources.limits.memory=2.6G
+EOF
+)
+
+# Default requested: CPU => 100m, memory => 64Mi
+HELM_CMD=$(cat << EOF
+  $HELM_CMD \
+  --set redis.resources.limits.cpu=200m \
+  --set redis.resources.limits.memory=130M
+EOF
+)
+
+# Default requested: CPU => 100m, memory => 128Mi
+HELM_CMD=$(cat << EOF
+  $HELM_CMD \
+  --set minio.resources.limits.cpu=200m \
+  --set minio.resources.limits.memory=280M
+EOF
+)
+
+# Default requested: CPU => 0, memory => 0
+HELM_CMD=$(cat << EOF
+  $HELM_CMD \
+  --set gitlab-runner.resources.requests.cpu=300m \
+  --set gitlab-runner.resources.limits.cpu=600m \
+  --set gitlab-runner.resources.requests.memory=300M \
+  --set gitlab-runner.resources.limits.memory=600M
+EOF
+)
+
+HELM_CMD=$(cat << EOF
+  $HELM_CMD \
+  --namespace="$KUBE_NAMESPACE" \
+  --version="$CI_PIPELINE_ID-$CI_JOB_ID" \
+  "$name" .
 EOF
 )
 

From 4f04c4c90b2db8ddcf5f3e28a9bbefd20c8bbda0 Mon Sep 17 00:00:00 2001
From: Mario de la Ossa <mariodelaossa@gmail.com>
Date: Wed, 12 Jun 2019 18:08:44 -0600
Subject: [PATCH 069/195] Ignore min_chars_for_partial_matching unles trigrm

If we're not using a trigram index, then ignore the
min_chars_for_partial_matching setting
---
 app/finders/issuable_finder.rb                |  2 +-
 app/models/concerns/issuable.rb               |  4 ++--
 .../unreleased/40379-CJK-search-min-chars.yml |  5 ++++
 lib/gitlab/sql/pattern.rb                     | 24 +++++++++++--------
 spec/lib/gitlab/sql/pattern_spec.rb           | 12 ++++++++++
 spec/models/concerns/issuable_spec.rb         | 10 ++++++++
 6 files changed, 44 insertions(+), 13 deletions(-)
 create mode 100644 changelogs/unreleased/40379-CJK-search-min-chars.yml

diff --git a/app/finders/issuable_finder.rb b/app/finders/issuable_finder.rb
index 3592505a977..f4fbeacfaba 100644
--- a/app/finders/issuable_finder.rb
+++ b/app/finders/issuable_finder.rb
@@ -429,7 +429,7 @@ class IssuableFinder
       items = klass.with(cte.to_arel).from(klass.table_name)
     end
 
-    items.full_search(search, matched_columns: params[:in])
+    items.full_search(search, matched_columns: params[:in], use_minimum_char_limit: !use_cte_for_search?)
   end
   # rubocop: enable CodeReuse/ActiveRecord
 
diff --git a/app/models/concerns/issuable.rb b/app/models/concerns/issuable.rb
index 299e413321d..952de92cae1 100644
--- a/app/models/concerns/issuable.rb
+++ b/app/models/concerns/issuable.rb
@@ -168,7 +168,7 @@ module Issuable
     # matched_columns - Modify the scope of the query. 'title', 'description' or joining them with a comma.
     #
     # Returns an ActiveRecord::Relation.
-    def full_search(query, matched_columns: 'title,description')
+    def full_search(query, matched_columns: 'title,description', use_minimum_char_limit: true)
       allowed_columns = [:title, :description]
       matched_columns = matched_columns.to_s.split(',').map(&:to_sym)
       matched_columns &= allowed_columns
@@ -176,7 +176,7 @@ module Issuable
       # Matching title or description if the matched_columns did not contain any allowed columns.
       matched_columns = [:title, :description] if matched_columns.empty?
 
-      fuzzy_search(query, matched_columns)
+      fuzzy_search(query, matched_columns, use_minimum_char_limit: use_minimum_char_limit)
     end
 
     def simple_sorts
diff --git a/changelogs/unreleased/40379-CJK-search-min-chars.yml b/changelogs/unreleased/40379-CJK-search-min-chars.yml
new file mode 100644
index 00000000000..6f6c4df464f
--- /dev/null
+++ b/changelogs/unreleased/40379-CJK-search-min-chars.yml
@@ -0,0 +1,5 @@
+---
+title: Remove minimum character limits for fuzzy searches when using a CTE
+merge_request: 29810
+author:
+type: fixed
diff --git a/lib/gitlab/sql/pattern.rb b/lib/gitlab/sql/pattern.rb
index fd108b4c124..f6edbfced7f 100644
--- a/lib/gitlab/sql/pattern.rb
+++ b/lib/gitlab/sql/pattern.rb
@@ -9,14 +9,16 @@ module Gitlab
       REGEX_QUOTED_WORD = /(?<=\A| )"[^"]+"(?= |\z)/.freeze
 
       class_methods do
-        def fuzzy_search(query, columns)
-          matches = columns.map { |col| fuzzy_arel_match(col, query) }.compact.reduce(:or)
+        def fuzzy_search(query, columns, use_minimum_char_limit: true)
+          matches = columns.map do |col|
+            fuzzy_arel_match(col, query, use_minimum_char_limit: use_minimum_char_limit)
+          end.compact.reduce(:or)
 
           where(matches)
         end
 
-        def to_pattern(query)
-          if partial_matching?(query)
+        def to_pattern(query, use_minimum_char_limit: true)
+          if partial_matching?(query, use_minimum_char_limit: use_minimum_char_limit)
             "%#{sanitize_sql_like(query)}%"
           else
             sanitize_sql_like(query)
@@ -27,7 +29,9 @@ module Gitlab
           MIN_CHARS_FOR_PARTIAL_MATCHING
         end
 
-        def partial_matching?(query)
+        def partial_matching?(query, use_minimum_char_limit: true)
+          return true unless use_minimum_char_limit
+
           query.length >= min_chars_for_partial_matching
         end
 
@@ -35,14 +39,14 @@ module Gitlab
         # query - The text to search for.
         # lower_exact_match - When set to `true` we'll fall back to using
         #                     `LOWER(column) = query` instead of using `ILIKE`.
-        def fuzzy_arel_match(column, query, lower_exact_match: false)
+        def fuzzy_arel_match(column, query, lower_exact_match: false, use_minimum_char_limit: true)
           query = query.squish
           return unless query.present?
 
-          words = select_fuzzy_words(query)
+          words = select_fuzzy_words(query, use_minimum_char_limit: use_minimum_char_limit)
 
           if words.any?
-            words.map { |word| arel_table[column].matches(to_pattern(word)) }.reduce(:and)
+            words.map { |word| arel_table[column].matches(to_pattern(word, use_minimum_char_limit: use_minimum_char_limit)) }.reduce(:and)
           else
             # No words of at least 3 chars, but we can search for an exact
             # case insensitive match with the query as a whole
@@ -56,7 +60,7 @@ module Gitlab
           end
         end
 
-        def select_fuzzy_words(query)
+        def select_fuzzy_words(query, use_minimum_char_limit: true)
           quoted_words = query.scan(REGEX_QUOTED_WORD)
 
           query = quoted_words.reduce(query) { |q, quoted_word| q.sub(quoted_word, '') }
@@ -67,7 +71,7 @@ module Gitlab
 
           words.concat(quoted_words)
 
-          words.select { |word| partial_matching?(word) }
+          words.select { |word| partial_matching?(word, use_minimum_char_limit: use_minimum_char_limit) }
         end
       end
     end
diff --git a/spec/lib/gitlab/sql/pattern_spec.rb b/spec/lib/gitlab/sql/pattern_spec.rb
index 5b5052de372..98838712eae 100644
--- a/spec/lib/gitlab/sql/pattern_spec.rb
+++ b/spec/lib/gitlab/sql/pattern_spec.rb
@@ -10,6 +10,12 @@ describe Gitlab::SQL::Pattern do
       it 'returns exact matching pattern' do
         expect(to_pattern).to eq('12')
       end
+
+      context 'and ignore_minimum_char_limit is true' do
+        it 'returns partial matching pattern' do
+          expect(User.to_pattern(query, use_minimum_char_limit:  false)).to eq('%12%')
+        end
+      end
     end
 
     context 'when a query with a escape character is shorter than 3 chars' do
@@ -18,6 +24,12 @@ describe Gitlab::SQL::Pattern do
       it 'returns sanitized exact matching pattern' do
         expect(to_pattern).to eq('\_2')
       end
+
+      context 'and ignore_minimum_char_limit is true' do
+        it 'returns sanitized partial matching pattern' do
+          expect(User.to_pattern(query, use_minimum_char_limit:  false)).to eq('%\_2%')
+        end
+      end
     end
 
     context 'when a query is equal to 3 chars' do
diff --git a/spec/models/concerns/issuable_spec.rb b/spec/models/concerns/issuable_spec.rb
index 64f02978d79..68224a56515 100644
--- a/spec/models/concerns/issuable_spec.rb
+++ b/spec/models/concerns/issuable_spec.rb
@@ -223,6 +223,16 @@ describe Issuable do
       expect(issuable_class.full_search(searchable_issue2.description.downcase)).to eq([searchable_issue2])
     end
 
+    it 'returns issues with a fuzzy matching description for a query shorter than 3 chars if told to do so' do
+      search = searchable_issue2.description.downcase.scan(/\w+/).sample[-1]
+
+      expect(issuable_class.full_search(search, use_minimum_char_limit: false)).to include(searchable_issue2)
+    end
+
+    it 'returns issues with a fuzzy matching title for a query shorter than 3 chars if told to do so' do
+      expect(issuable_class.full_search('i', use_minimum_char_limit: false)).to include(searchable_issue)
+    end
+
     context 'when matching columns is "title"' do
       it 'returns issues with a matching title' do
         expect(issuable_class.full_search(searchable_issue.title, matched_columns: 'title'))

From d34f43499e23469c82d293d4a43efa53f56d8fb0 Mon Sep 17 00:00:00 2001
From: Mayra Cabrera <mcabrera@gitlab.com>
Date: Thu, 4 Jul 2019 16:58:42 +0000
Subject: [PATCH 070/195] Add new info for auth.log

From 12.1, user information (id and username) are also included on
auth.log. Documentation was updated to reflect this.

Related to https://gitlab.com/gitlab-org/gitlab-ce/issues/62756
---
 doc/administration/logs.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/administration/logs.md b/doc/administration/logs.md
index 9921ffd8ea0..b49d8c8a28f 100644
--- a/doc/administration/logs.md
+++ b/doc/administration/logs.md
@@ -288,6 +288,9 @@ installations from source.
 
 It logs information whenever [Rack Attack] registers an abusive request.
 
+NOTE: **Note:**
+From [%12.1](https://gitlab.com/gitlab-org/gitlab-ce/issues/62756), user id and username are available on this log.
+
 ## `graphql_json.log`
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/59587) in GitLab 12.0.

From f33707d54444d28bb618e00084f2825f554b207e Mon Sep 17 00:00:00 2001
From: Markus Koller <mkoller@gitlab.com>
Date: Mon, 1 Jul 2019 11:19:04 +0200
Subject: [PATCH 071/195] Fix call to removed GitPushService

---
 db/fixtures/development/17_cycle_analytics.rb | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

diff --git a/db/fixtures/development/17_cycle_analytics.rb b/db/fixtures/development/17_cycle_analytics.rb
index 7a86fe2eb7c..78ceb74da65 100644
--- a/db/fixtures/development/17_cycle_analytics.rb
+++ b/db/fixtures/development/17_cycle_analytics.rb
@@ -146,11 +146,13 @@ class Gitlab::Seeder::CycleAnalytics
       commit_sha = issue.project.repository.create_file(@user, filename, "content", message: "Commit for #{issue.to_reference}", branch_name: branch_name)
       issue.project.repository.commit(commit_sha)
 
-      GitPushService.new(issue.project,
-                         @user,
-                         oldrev: issue.project.repository.commit("master").sha,
-                         newrev: commit_sha,
-                         ref: 'refs/heads/master').execute
+      Git::BranchPushService.new(
+        issue.project,
+        @user,
+        oldrev: issue.project.repository.commit("master").sha,
+        newrev: commit_sha,
+        ref: 'refs/heads/master'
+      ).execute
 
       branch_name
     end

From e169b030b94bad0cd60995686feeac8d84033aaf Mon Sep 17 00:00:00 2001
From: Cynthia Ng <cng@gitlab.com>
Date: Thu, 4 Jul 2019 17:23:06 +0000
Subject: [PATCH 072/195] Docs: Clarify project and repo size

---
 .../settings/account_and_limit_settings.md          |  4 +++-
 doc/user/project/container_registry.md              |  2 +-
 doc/user/project/repository/index.md                | 13 +++++--------
 3 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/doc/user/admin_area/settings/account_and_limit_settings.md b/doc/user/admin_area/settings/account_and_limit_settings.md
index 001e4b6bf48..756a07e0b80 100644
--- a/doc/user/admin_area/settings/account_and_limit_settings.md
+++ b/doc/user/admin_area/settings/account_and_limit_settings.md
@@ -44,10 +44,12 @@ The first push of a new project, including LFS objects, will be checked for size
 and **will** be rejected if the sum of their sizes exceeds the maximum allowed 
 repository size.
 
+**Note:** The repository size limit includes repository files and LFS, and does not include artifacts.
+
 For details on manually purging files, see [reducing the repository size using Git](../../project/repository/reducing_the_repo_size_using_git.md).
 
 NOTE: **Note:**
-For GitLab.com, the repository size limit is 10 GB.
+GitLab.com repository size [is set by GitLab](../../gitlab_com/index.md#repository-size-limit).
 
 <!-- ## Troubleshooting
 
diff --git a/doc/user/project/container_registry.md b/doc/user/project/container_registry.md
index 7d567da1c9a..eac7fc6b195 100644
--- a/doc/user/project/container_registry.md
+++ b/doc/user/project/container_registry.md
@@ -29,7 +29,7 @@ to enable it.
    following the [administration documentation](../../administration/container_registry.md).
    If you are using GitLab.com, this is enabled by default so you can start using
    the Registry immediately. Currently there is a soft (10GB) size restriction for
-   registry on GitLab.com, as part of the [repository size limit](repository/index.html#repository-size).
+   registry on GitLab.com, as part of the [repository size limit](repository/index.md).
 1. Go to your [project's General settings](settings/index.md#sharing-and-permissions)
    and enable the **Container Registry** feature on your project. For new
    projects this might be enabled by default. For existing projects
diff --git a/doc/user/project/repository/index.md b/doc/user/project/repository/index.md
index 165f4c15165..5e0f4c69b5e 100644
--- a/doc/user/project/repository/index.md
+++ b/doc/user/project/repository/index.md
@@ -171,17 +171,14 @@ Via command line, you can commit multiple times before pushing.
 - **Sign a commit:**
   Use GPG to [sign your commits](gpg_signed_commits/index.md).
 
-## Repository size
+## Project and repository size
 
-A project's repository size is reported on the project's **Details** page. The reported size is
-updated every 15 minutes at most, so may not reflect recent activity.
+A project's size is reported on the project's **Details** page. The reported size is
+updated every 15 minutes at most, so may not reflect recent activity. The displayed files size includes repository files, artifacts, and LFS.
 
-The repository size for:
+The project size may differ slightly from one instance to another due to compression, housekeeping, and other factors.
 
-- GitLab.com [is set by GitLab](../../gitlab_com/index.md#repository-size-limit).
-- Self-managed instances is set by your GitLab administrators.
-
-You can [reduce a repository's size using Git](reducing_the_repo_size_using_git.md).
+[Repository size limit](../../admin_area/settings/account_and_limit_settings.md) may be set by admins. GitLab.com's repository size limit [is set by GitLab](../../gitlab_com/index.md#repository-size-limit).
 
 ## Contributors
 

From 398c0e48f70af0a0b1984ea5c4c58ea4d5cb9512 Mon Sep 17 00:00:00 2001
From: James Fargher <proglottis@gmail.com>
Date: Fri, 21 Jun 2019 08:54:43 +0100
Subject: [PATCH 073/195] Remove now unused KubernetesService methods

Now that KubernetesService can no longer be a DeploymentPlatform we can
remove all kubernetes client code and KubernetesService edge cases.
---
 .rubocop_todo.yml                             |   3 -
 .../project_services/kubernetes_service.rb    | 129 ----------
 app/services/prometheus/adapter_service.rb    |   7 +-
 spec/models/deployment_spec.rb                |   6 -
 .../kubernetes_service_spec.rb                | 229 ------------------
 5 files changed, 2 insertions(+), 372 deletions(-)

diff --git a/.rubocop_todo.yml b/.rubocop_todo.yml
index 698570efb07..41714eefa97 100644
--- a/.rubocop_todo.yml
+++ b/.rubocop_todo.yml
@@ -466,12 +466,10 @@ Rails/LinkToBlank:
 Rails/Presence:
   Exclude:
     - 'app/models/ci/pipeline.rb'
-    - 'app/models/clusters/platforms/kubernetes.rb'
     - 'app/models/concerns/mentionable.rb'
     - 'app/models/project_services/hipchat_service.rb'
     - 'app/models/project_services/irker_service.rb'
     - 'app/models/project_services/jira_service.rb'
-    - 'app/models/project_services/kubernetes_service.rb'
     - 'app/models/project_services/packagist_service.rb'
     - 'app/models/wiki_page.rb'
     - 'lib/gitlab/github_import/importer/releases_importer.rb'
@@ -514,7 +512,6 @@ Security/YAMLLoad:
     - 'spec/config/mail_room_spec.rb'
     - 'spec/initializers/secret_token_spec.rb'
     - 'spec/lib/gitlab/prometheus/additional_metrics_parser_spec.rb'
-    - 'spec/models/project_services/kubernetes_service_spec.rb'
 
 # Offense count: 34
 # Configuration parameters: EnforcedStyle.
diff --git a/app/models/project_services/kubernetes_service.rb b/app/models/project_services/kubernetes_service.rb
index 27b7827d55e..9f5c226f4c9 100644
--- a/app/models/project_services/kubernetes_service.rb
+++ b/app/models/project_services/kubernetes_service.rb
@@ -1,18 +1,8 @@
 # frozen_string_literal: true
 
-##
-# NOTE:
-# We'll move this class to Clusters::Platforms::Kubernetes, which contains exactly the same logic.
-# After we've migrated data, we'll remove KubernetesService. This would happen in a few months.
-# If you're modyfiyng this class, please note that you should update the same change in Clusters::Platforms::Kubernetes.
 class KubernetesService < Service
-  include Gitlab::Kubernetes
-  include ReactiveCaching
-
   default_value_for :category, 'deployment'
 
-  self.reactive_cache_key = ->(service) { [service.class.model_name.singular, service.project_id] }
-
   # Namespace defaults to the project path, but can be overridden in case that
   # is an invalid or inappropriate name
   prop_accessor :namespace
@@ -47,8 +37,6 @@ class KubernetesService < Service
       message: Gitlab::Regex.kubernetes_namespace_regex_message
     }
 
-  after_save :clear_reactive_cache!
-
   def self.supported_events
     %w()
   end
@@ -94,72 +82,6 @@ class KubernetesService < Service
     ]
   end
 
-  def kubernetes_namespace_for(project)
-    if namespace.present?
-      namespace
-    else
-      default_namespace
-    end
-  end
-
-  # Check we can connect to the Kubernetes API
-  def test(*args)
-    kubeclient = build_kube_client!
-
-    kubeclient.core_client.discover
-    { success: kubeclient.core_client.discovered, result: "Checked API discovery endpoint" }
-  rescue => err
-    { success: false, result: err }
-  end
-
-  # Project param was added on
-  # https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/22011,
-  # as a way to keep this service compatible with
-  # Clusters::Platforms::Kubernetes, it won't be used on this method
-  # as it's only needed for Clusters::Cluster.
-  def predefined_variables(project:)
-    Gitlab::Ci::Variables::Collection.new.tap do |variables|
-      variables
-        .append(key: 'KUBE_URL', value: api_url)
-        .append(key: 'KUBE_TOKEN', value: token, public: false, masked: true)
-        .append(key: 'KUBE_NAMESPACE', value: kubernetes_namespace_for(project))
-        .append(key: 'KUBECONFIG', value: kubeconfig, public: false, file: true)
-
-      if ca_pem.present?
-        variables
-          .append(key: 'KUBE_CA_PEM', value: ca_pem)
-          .append(key: 'KUBE_CA_PEM_FILE', value: ca_pem, file: true)
-      end
-    end
-  end
-
-  # Constructs a list of terminals from the reactive cache
-  #
-  # Returns nil if the cache is empty, in which case you should try again a
-  # short time later
-  def terminals(environment)
-    with_reactive_cache do |data|
-      project = environment.project
-
-      pods = filter_by_project_environment(data[:pods], project.full_path_slug, environment.slug)
-      terminals = pods.flat_map { |pod| terminals_for_pod(api_url, kubernetes_namespace_for(project), pod) }.compact
-      terminals.each { |terminal| add_terminal_auth(terminal, terminal_auth) }
-    end
-  end
-
-  # Caches resources in the namespace so other calls don't need to block on
-  # network access
-  def calculate_reactive_cache
-    return unless active? && project && !project.pending_delete?
-
-    # We may want to cache extra things in the future
-    { pods: read_pods }
-  end
-
-  def kubeclient
-    @kubeclient ||= build_kube_client!
-  end
-
   def deprecated?
     true
   end
@@ -186,14 +108,6 @@ class KubernetesService < Service
 
   private
 
-  def kubeconfig
-    to_kubeconfig(
-      url: api_url,
-      namespace: kubernetes_namespace_for(project),
-      token: token,
-      ca_pem: ca_pem)
-  end
-
   def namespace_placeholder
     default_namespace || TEMPLATE_PLACEHOLDER
   end
@@ -205,49 +119,6 @@ class KubernetesService < Service
     slug.gsub(/[^-a-z0-9]/, '-').gsub(/^-+/, '')
   end
 
-  def build_kube_client!
-    raise "Incomplete settings" unless api_url && kubernetes_namespace_for(project) && token
-
-    Gitlab::Kubernetes::KubeClient.new(
-      api_url,
-      auth_options: kubeclient_auth_options,
-      ssl_options: kubeclient_ssl_options,
-      http_proxy_uri: ENV['http_proxy']
-    )
-  end
-
-  # Returns a hash of all pods in the namespace
-  def read_pods
-    kubeclient = build_kube_client!
-
-    kubeclient.get_pods(namespace: kubernetes_namespace_for(project)).as_json
-  rescue Kubeclient::ResourceNotFoundError
-    []
-  end
-
-  def kubeclient_ssl_options
-    opts = { verify_ssl: OpenSSL::SSL::VERIFY_PEER }
-
-    if ca_pem.present?
-      opts[:cert_store] = OpenSSL::X509::Store.new
-      opts[:cert_store].add_cert(OpenSSL::X509::Certificate.new(ca_pem))
-    end
-
-    opts
-  end
-
-  def kubeclient_auth_options
-    { bearer_token: token }
-  end
-
-  def terminal_auth
-    {
-      token: token,
-      ca_pem: ca_pem,
-      max_session_time: Gitlab::CurrentSettings.terminal_max_session_time
-    }
-  end
-
   def enforce_namespace_to_lower_case
     self.namespace = self.namespace&.downcase
   end
diff --git a/app/services/prometheus/adapter_service.rb b/app/services/prometheus/adapter_service.rb
index 3be958e1613..399f4c35d66 100644
--- a/app/services/prometheus/adapter_service.rb
+++ b/app/services/prometheus/adapter_service.rb
@@ -27,12 +27,9 @@ module Prometheus
     end
 
     def cluster_prometheus_adapter
-      return unless deployment_platform.respond_to?(:cluster)
+      application = deployment_platform&.cluster&.application_prometheus
 
-      cluster = deployment_platform.cluster
-      return unless cluster.application_prometheus&.available?
-
-      cluster.application_prometheus
+      application if application&.available?
     end
   end
 end
diff --git a/spec/models/deployment_spec.rb b/spec/models/deployment_spec.rb
index 8d0eb0f4a06..713fb647708 100644
--- a/spec/models/deployment_spec.rb
+++ b/spec/models/deployment_spec.rb
@@ -462,12 +462,6 @@ describe Deployment do
       it { is_expected.to be_nil }
     end
 
-    context 'project uses the kubernetes service for deployments' do
-      let!(:service) { create(:kubernetes_service, project: project) }
-
-      it { is_expected.to be_nil }
-    end
-
     context 'project has a deployment platform' do
       let!(:cluster) { create(:cluster, projects: [project]) }
       let!(:platform) { create(:cluster_platform_kubernetes, cluster: cluster) }
diff --git a/spec/models/project_services/kubernetes_service_spec.rb b/spec/models/project_services/kubernetes_service_spec.rb
index 5d7d6c34e67..d33bbb0470f 100644
--- a/spec/models/project_services/kubernetes_service_spec.rb
+++ b/spec/models/project_services/kubernetes_service_spec.rb
@@ -142,235 +142,6 @@ describe KubernetesService, :use_clean_rails_memory_store_caching do
     end
   end
 
-  describe '#kubernetes_namespace_for' do
-    subject { service.kubernetes_namespace_for(project) }
-
-    shared_examples 'a correctly formatted namespace' do
-      it 'returns a valid Kubernetes namespace name' do
-        expect(subject).to match(Gitlab::Regex.kubernetes_namespace_regex)
-        expect(subject).to eq(expected_namespace)
-      end
-    end
-
-    it_behaves_like 'a correctly formatted namespace' do
-      let(:expected_namespace) { service.send(:default_namespace) }
-    end
-
-    context 'when the project path contains forbidden characters' do
-      before do
-        project.path = '-a_Strange.Path--forSure'
-      end
-
-      it_behaves_like 'a correctly formatted namespace' do
-        let(:expected_namespace) { "a-strange-path--forsure-#{project.id}" }
-      end
-    end
-
-    context 'when namespace is specified' do
-      before do
-        service.namespace = 'my-namespace'
-      end
-
-      it_behaves_like 'a correctly formatted namespace' do
-        let(:expected_namespace) { 'my-namespace' }
-      end
-    end
-
-    context 'when service is not assigned to project' do
-      before do
-        service.project = nil
-      end
-
-      it 'does not return namespace' do
-        is_expected.to be_nil
-      end
-    end
-  end
-
-  describe '#test' do
-    let(:discovery_url) { 'https://kubernetes.example.com/api/v1' }
-
-    before do
-      stub_kubeclient_discover(service.api_url)
-    end
-
-    context 'with path prefix in api_url' do
-      let(:discovery_url) { 'https://kubernetes.example.com/prefix/api/v1' }
-
-      it 'tests with the prefix' do
-        service.api_url = 'https://kubernetes.example.com/prefix'
-        stub_kubeclient_discover(service.api_url)
-
-        expect(service.test[:success]).to be_truthy
-        expect(WebMock).to have_requested(:get, discovery_url).once
-      end
-    end
-
-    context 'with custom CA certificate' do
-      it 'is added to the certificate store' do
-        service.ca_pem = "CA PEM DATA"
-
-        cert = double("certificate")
-        expect(OpenSSL::X509::Certificate).to receive(:new).with(service.ca_pem).and_return(cert)
-        expect_any_instance_of(OpenSSL::X509::Store).to receive(:add_cert).with(cert)
-
-        expect(service.test[:success]).to be_truthy
-        expect(WebMock).to have_requested(:get, discovery_url).once
-      end
-    end
-
-    context 'success' do
-      it 'reads the discovery endpoint' do
-        expect(service.test[:success]).to be_truthy
-        expect(WebMock).to have_requested(:get, discovery_url).once
-      end
-    end
-
-    context 'failure' do
-      it 'fails to read the discovery endpoint' do
-        WebMock.stub_request(:get, service.api_url + '/api/v1').to_return(status: 404)
-
-        expect(service.test[:success]).to be_falsy
-        expect(WebMock).to have_requested(:get, discovery_url).once
-      end
-    end
-  end
-
-  describe '#predefined_variable' do
-    let(:kubeconfig) do
-      config_file = expand_fixture_path('config/kubeconfig.yml')
-      config = YAML.load(File.read(config_file))
-      config.dig('users', 0, 'user')['token'] = 'token'
-      config.dig('contexts', 0, 'context')['namespace'] = namespace
-      config.dig('clusters', 0, 'cluster')['certificate-authority-data'] =
-        Base64.strict_encode64('CA PEM DATA')
-
-      YAML.dump(config)
-    end
-
-    before do
-      subject.api_url = 'https://kube.domain.com'
-      subject.token = 'token'
-      subject.ca_pem = 'CA PEM DATA'
-      subject.project = project
-    end
-
-    shared_examples 'setting variables' do
-      it 'sets the variables' do
-        expect(subject.predefined_variables(project: project)).to include(
-          { key: 'KUBE_URL', value: 'https://kube.domain.com', public: true },
-          { key: 'KUBE_TOKEN', value: 'token', public: false, masked: true },
-          { key: 'KUBE_NAMESPACE', value: namespace, public: true },
-          { key: 'KUBECONFIG', value: kubeconfig, public: false, file: true },
-          { key: 'KUBE_CA_PEM', value: 'CA PEM DATA', public: true },
-          { key: 'KUBE_CA_PEM_FILE', value: 'CA PEM DATA', public: true, file: true }
-        )
-      end
-    end
-
-    context 'namespace is provided' do
-      let(:namespace) { 'my-project' }
-
-      before do
-        subject.namespace = namespace
-      end
-
-      it_behaves_like 'setting variables'
-    end
-
-    context 'no namespace provided' do
-      let(:namespace) { subject.kubernetes_namespace_for(project) }
-
-      it_behaves_like 'setting variables'
-
-      it 'sets the KUBE_NAMESPACE' do
-        kube_namespace = subject.predefined_variables(project: project).find { |h| h[:key] == 'KUBE_NAMESPACE' }
-
-        expect(kube_namespace).not_to be_nil
-        expect(kube_namespace[:value]).to match(/\A#{Gitlab::PathRegex::PATH_REGEX_STR}-\d+\z/)
-      end
-    end
-  end
-
-  describe '#terminals' do
-    let(:environment) { build(:environment, project: project, name: "env", slug: "env-000000") }
-
-    subject { service.terminals(environment) }
-
-    context 'with invalid pods' do
-      it 'returns no terminals' do
-        stub_reactive_cache(service, pods: [{ "bad" => "pod" }])
-
-        is_expected.to be_empty
-      end
-    end
-
-    context 'with valid pods' do
-      let(:pod) { kube_pod(environment_slug: environment.slug, namespace: service.kubernetes_namespace_for(project), project_slug: project.full_path_slug) }
-      let(:pod_with_no_terminal) { kube_pod(environment_slug: environment.slug, project_slug: project.full_path_slug, status: "Pending") }
-      let(:terminals) { kube_terminals(service, pod) }
-
-      before do
-        stub_reactive_cache(
-          service,
-          pods: [pod, pod, pod_with_no_terminal, kube_pod(environment_slug: "should-be-filtered-out")]
-        )
-      end
-
-      it 'returns terminals' do
-        is_expected.to eq(terminals + terminals)
-      end
-
-      it 'uses max session time from settings' do
-        stub_application_setting(terminal_max_session_time: 600)
-
-        times = subject.map { |terminal| terminal[:max_session_time] }
-        expect(times).to eq [600, 600, 600, 600]
-      end
-    end
-  end
-
-  describe '#calculate_reactive_cache' do
-    subject { service.calculate_reactive_cache }
-
-    let(:namespace) { service.kubernetes_namespace_for(project) }
-
-    context 'when service is inactive' do
-      before do
-        service.active = false
-      end
-
-      it { is_expected.to be_nil }
-    end
-
-    context 'when kubernetes responds with valid pods' do
-      before do
-        stub_kubeclient_pods(namespace)
-        stub_kubeclient_deployments(namespace) # Used by EE
-      end
-
-      it { is_expected.to include(pods: [kube_pod]) }
-    end
-
-    context 'when kubernetes responds with 500s' do
-      before do
-        stub_kubeclient_pods(namespace, status: 500)
-        stub_kubeclient_deployments(namespace, status: 500) # Used by EE
-      end
-
-      it { expect { subject }.to raise_error(Kubeclient::HttpError) }
-    end
-
-    context 'when kubernetes responds with 404s' do
-      before do
-        stub_kubeclient_pods(namespace, status: 404)
-        stub_kubeclient_deployments(namespace, status: 404) # Used by EE
-      end
-
-      it { is_expected.to include(pods: []) }
-    end
-  end
-
   describe "#deprecated?" do
     let(:kubernetes_service) { create(:kubernetes_service) }
 

From 37e4d6d991ac8e712ea99c621f98831955b6ebf5 Mon Sep 17 00:00:00 2001
From: Toon Claes <toon@gitlab.com>
Date: Thu, 4 Jul 2019 18:47:16 +0000
Subject: [PATCH 074/195] DRY up conditions for files require DB review

Stop using two separate lists for the conditions which files require a
database review.

Related discussion:
https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/30156#note_187732053
---
 danger/database/Dangerfile            | 32 +--------------------------
 lib/gitlab/danger/helper.rb           |  6 ++++-
 spec/lib/gitlab/danger/helper_spec.rb | 21 ++++++++++++++----
 3 files changed, 23 insertions(+), 36 deletions(-)

diff --git a/danger/database/Dangerfile b/danger/database/Dangerfile
index 4dadf60ad24..083e95b8da7 100644
--- a/danger/database/Dangerfile
+++ b/danger/database/Dangerfile
@@ -1,21 +1,5 @@
 # frozen_string_literal: true
 
-# All the files/directories that should be reviewed by the DB team.
-DB_FILES = [
-  'db/',
-  'app/models/project_authorization.rb',
-  'app/services/users/refresh_authorized_projects_service.rb',
-  'lib/gitlab/background_migration.rb',
-  'lib/gitlab/background_migration/',
-  'lib/gitlab/database.rb',
-  'lib/gitlab/database/',
-  'lib/gitlab/github_import.rb',
-  'lib/gitlab/github_import/',
-  'lib/gitlab/sql/',
-  'rubocop/cop/migration',
-  'ee/lib/gitlab/database/'
-].freeze
-
 SCHEMA_NOT_UPDATED_MESSAGE = <<~MSG
 **New %<migrations>s added but %<schema>s wasn't updated.**
 
@@ -24,20 +8,6 @@ updated too (unless the migration isn't changing the DB schema
 and isn't the most recent one).
 MSG
 
-def database_paths_requiring_review(files)
-  to_review = []
-
-  files.each do |file|
-    review = DB_FILES.any? do |pattern|
-      file.start_with?(pattern)
-    end
-
-    to_review << file if review
-  end
-
-  to_review
-end
-
 non_geo_db_schema_updated = !git.modified_files.grep(%r{\Adb/schema\.rb}).empty?
 geo_db_schema_updated = !git.modified_files.grep(%r{\Aee/db/geo/schema\.rb}).empty?
 
@@ -52,7 +22,7 @@ if geo_migration_created && !geo_db_schema_updated
   warn format(SCHEMA_NOT_UPDATED_MESSAGE, migrations: 'Geo migrations', schema: gitlab.html_link("ee/db/geo/schema.rb"))
 end
 
-db_paths_to_review = database_paths_requiring_review(helper.all_changed_files)
+db_paths_to_review = helper.changes_by_category[:database]
 
 unless db_paths_to_review.empty?
   message 'This merge request adds or changes files that require a ' \
diff --git a/lib/gitlab/danger/helper.rb b/lib/gitlab/danger/helper.rb
index 1ecf4a12db7..0fc145534bf 100644
--- a/lib/gitlab/danger/helper.rb
+++ b/lib/gitlab/danger/helper.rb
@@ -103,6 +103,11 @@ module Gitlab
           yarn\.lock
         )\z}x => :frontend,
 
+        %r{\A(ee/)?db/} => :database,
+        %r{\A(ee/)?lib/gitlab/(database|background_migration|sql|github_import)(/|\.rb)} => :database,
+        %r{\A(app/models/project_authorization|app/services/users/refresh_authorized_projects_service)(/|\.rb)} => :database,
+        %r{\Arubocop/cop/migration(/|\.rb)} => :database,
+
         %r{\A(ee/)?app/(?!assets|views)[^/]+} => :backend,
         %r{\A(ee/)?(bin|config|danger|generator_templates|lib|rubocop|scripts)/} => :backend,
         %r{\A(ee/)?spec/features/} => :test,
@@ -112,7 +117,6 @@ module Gitlab
         %r{\A(Dangerfile|Gemfile|Gemfile.lock|Procfile|Rakefile|\.gitlab-ci\.yml)\z} => :backend,
         %r{\A[A-Z_]+_VERSION\z} => :backend,
 
-        %r{\A(ee/)?db/} => :database,
         %r{\A(ee/)?qa/} => :qa,
 
         # Files that don't fit into any category are marked with :none
diff --git a/spec/lib/gitlab/danger/helper_spec.rb b/spec/lib/gitlab/danger/helper_spec.rb
index c8e65a3e59d..92d90ac2fef 100644
--- a/spec/lib/gitlab/danger/helper_spec.rb
+++ b/spec/lib/gitlab/danger/helper_spec.rb
@@ -87,13 +87,13 @@ describe Gitlab::Danger::Helper do
 
   describe '#changes_by_category' do
     it 'categorizes changed files' do
-      expect(fake_git).to receive(:added_files) { %w[foo foo.md foo.rb foo.js db/foo qa/foo ee/changelogs/foo.yml] }
+      expect(fake_git).to receive(:added_files) { %w[foo foo.md foo.rb foo.js db/foo lib/gitlab/database/foo.rb qa/foo ee/changelogs/foo.yml] }
       allow(fake_git).to receive(:modified_files) { [] }
       allow(fake_git).to receive(:renamed_files) { [] }
 
       expect(helper.changes_by_category).to eq(
         backend: %w[foo.rb],
-        database: %w[db/foo],
+        database: %w[db/foo lib/gitlab/database/foo.rb],
         frontend: %w[foo.js],
         none: %w[ee/changelogs/foo.yml foo.md],
         qa: %w[qa/foo],
@@ -159,9 +159,22 @@ describe Gitlab::Danger::Helper do
 
       'ee/FOO_VERSION' | :unknown
 
-      'db/foo' | :database
-      'qa/foo' | :qa
+      'db/foo'                                                    | :database
+      'ee/db/foo'                                                 | :database
+      'app/models/project_authorization.rb'                       | :database
+      'app/services/users/refresh_authorized_projects_service.rb' | :database
+      'lib/gitlab/background_migration.rb'                        | :database
+      'lib/gitlab/background_migration/foo'                       | :database
+      'ee/lib/gitlab/background_migration/foo'                    | :database
+      'lib/gitlab/database.rb'                                    | :database
+      'lib/gitlab/database/foo'                                   | :database
+      'ee/lib/gitlab/database/foo'                                | :database
+      'lib/gitlab/github_import.rb'                               | :database
+      'lib/gitlab/github_import/foo'                              | :database
+      'lib/gitlab/sql/foo'                                        | :database
+      'rubocop/cop/migration/foo'                                 | :database
 
+      'qa/foo' | :qa
       'ee/qa/foo' | :qa
 
       'changelogs/foo'    | :none

From 2ecad462a087958433cc886c08830e0a36964cd0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ma=C5=82gorzata=20Ksionek?= <mksionek@gitlab.com>
Date: Mon, 1 Jul 2019 13:27:47 +0200
Subject: [PATCH 075/195] Add where condition to count in median class

---
 lib/gitlab/database/median.rb                 |  2 +-
 .../gitlab/cycle_analytics/test_stage_spec.rb | 34 +++++++++++++++++++
 2 files changed, 35 insertions(+), 1 deletion(-)

diff --git a/lib/gitlab/database/median.rb b/lib/gitlab/database/median.rb
index 1455e410d4b..b8d895dee7d 100644
--- a/lib/gitlab/database/median.rb
+++ b/lib/gitlab/database/median.rb
@@ -158,7 +158,7 @@ module Gitlab
               Arel::Nodes::Window.new.order(arel_table[column_sym])
             ).as('row_id')
 
-          count = arel_table.project("COUNT(1)").as('ct')
+          count = arel_table.where(arel_table[column_sym].gteq(zero_interval)).project("COUNT(1)").as('ct')
 
           [column_row, row_id, count]
         end
diff --git a/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb b/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb
index eacde22cd56..1d4ad1b319d 100644
--- a/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb
+++ b/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb
@@ -3,6 +3,40 @@ require 'lib/gitlab/cycle_analytics/shared_stage_spec'
 
 describe Gitlab::CycleAnalytics::TestStage do
   let(:stage_name) { :test }
+  let(:project) { create(:project) }
+  let!(:issue_1) { create(:issue, project: project, created_at: 90.minutes.ago) }
+  let!(:issue_2) { create(:issue, project: project, created_at: 60.minutes.ago) }
+  let!(:issue_3) { create(:issue, project: project, created_at: 60.minutes.ago) }
+  let!(:mr_1) { create(:merge_request, :closed, source_project: project, created_at: 60.minutes.ago) }
+  let!(:mr_2) { create(:merge_request, :closed, source_project: project, created_at: 40.minutes.ago, source_branch: 'A') }
+  let!(:mr_3) { create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'B') }
+  let!(:mr_4) { create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'C') }
+  let!(:mr_5) { create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'D') }
+  let(:stage) { described_class.new(project: project, options: { from: 2.days.ago, current_user: project.creator }) }
+
+  before do
+    mr_1.metrics.update!(latest_build_started_at: 32.minutes.ago, latest_build_finished_at: 2.minutes.ago)
+    mr_2.metrics.update!(latest_build_started_at: 62.minutes.ago, latest_build_finished_at: 32.minute.ago)
+    mr_3.metrics.update!(latest_build_started_at: nil, latest_build_finished_at: nil)
+    mr_4.metrics.update!(latest_build_started_at: nil, latest_build_finished_at: nil)
+    mr_5.metrics.update!(latest_build_started_at: nil, latest_build_finished_at: nil)
+
+    create(:merge_requests_closing_issues, merge_request: mr_1, issue: issue_1)
+    create(:merge_requests_closing_issues, merge_request: mr_2, issue: issue_2)
+    create(:merge_requests_closing_issues, merge_request: mr_3, issue: issue_3)
+    create(:merge_requests_closing_issues, merge_request: mr_4, issue: issue_3)
+    create(:merge_requests_closing_issues, merge_request: mr_5, issue: issue_3)
+  end
 
   it_behaves_like 'base stage'
+
+  describe '#median' do
+    around do |example|
+      Timecop.freeze { example.run }
+    end
+
+    it 'counts median from issues with metrics' do
+      expect(stage.median).to eq(ISSUES_MEDIAN)
+    end
+  end
 end

From f47956f0fd3b73eb1bc6ab352b076b937753a549 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ma=C5=82gorzata=20Ksionek?= <mksionek@gitlab.com>
Date: Mon, 1 Jul 2019 15:27:15 +0200
Subject: [PATCH 076/195] Add changelog entry

---
 .../unreleased/fix-median-counting-for-cycle-analytics.yml   | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 changelogs/unreleased/fix-median-counting-for-cycle-analytics.yml

diff --git a/changelogs/unreleased/fix-median-counting-for-cycle-analytics.yml b/changelogs/unreleased/fix-median-counting-for-cycle-analytics.yml
new file mode 100644
index 00000000000..6ae6db08ba1
--- /dev/null
+++ b/changelogs/unreleased/fix-median-counting-for-cycle-analytics.yml
@@ -0,0 +1,5 @@
+---
+title: Fix median counting for cycle analytics
+merge_request: 30229
+author:
+type: fixed

From d26f2708a2abe439f57101c2b359cd6dce33e90a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ma=C5=82gorzata=20Ksionek?= <mksionek@gitlab.com>
Date: Mon, 1 Jul 2019 22:06:27 +0200
Subject: [PATCH 077/195] Fix rubocop offence

---
 spec/lib/gitlab/cycle_analytics/test_stage_spec.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb b/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb
index 1d4ad1b319d..0692f8145b9 100644
--- a/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb
+++ b/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb
@@ -16,7 +16,7 @@ describe Gitlab::CycleAnalytics::TestStage do
 
   before do
     mr_1.metrics.update!(latest_build_started_at: 32.minutes.ago, latest_build_finished_at: 2.minutes.ago)
-    mr_2.metrics.update!(latest_build_started_at: 62.minutes.ago, latest_build_finished_at: 32.minute.ago)
+    mr_2.metrics.update!(latest_build_started_at: 62.minutes.ago, latest_build_finished_at: 32.minutes.ago)
     mr_3.metrics.update!(latest_build_started_at: nil, latest_build_finished_at: nil)
     mr_4.metrics.update!(latest_build_started_at: nil, latest_build_finished_at: nil)
     mr_5.metrics.update!(latest_build_started_at: nil, latest_build_finished_at: nil)

From 23aad1279762136dbfbcb01c01b30d1929db1bcb Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ma=C5=82gorzata=20Ksionek?= <mksionek@gitlab.com>
Date: Tue, 2 Jul 2019 12:25:02 +0200
Subject: [PATCH 078/195] Rearrange spec for readability

---
 .../gitlab/cycle_analytics/test_stage_spec.rb | 45 ++++++++++---------
 1 file changed, 23 insertions(+), 22 deletions(-)

diff --git a/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb b/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb
index 0692f8145b9..7881fbe589a 100644
--- a/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb
+++ b/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb
@@ -4,33 +4,34 @@ require 'lib/gitlab/cycle_analytics/shared_stage_spec'
 describe Gitlab::CycleAnalytics::TestStage do
   let(:stage_name) { :test }
   let(:project) { create(:project) }
-  let!(:issue_1) { create(:issue, project: project, created_at: 90.minutes.ago) }
-  let!(:issue_2) { create(:issue, project: project, created_at: 60.minutes.ago) }
-  let!(:issue_3) { create(:issue, project: project, created_at: 60.minutes.ago) }
-  let!(:mr_1) { create(:merge_request, :closed, source_project: project, created_at: 60.minutes.ago) }
-  let!(:mr_2) { create(:merge_request, :closed, source_project: project, created_at: 40.minutes.ago, source_branch: 'A') }
-  let!(:mr_3) { create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'B') }
-  let!(:mr_4) { create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'C') }
-  let!(:mr_5) { create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'D') }
   let(:stage) { described_class.new(project: project, options: { from: 2.days.ago, current_user: project.creator }) }
 
-  before do
-    mr_1.metrics.update!(latest_build_started_at: 32.minutes.ago, latest_build_finished_at: 2.minutes.ago)
-    mr_2.metrics.update!(latest_build_started_at: 62.minutes.ago, latest_build_finished_at: 32.minutes.ago)
-    mr_3.metrics.update!(latest_build_started_at: nil, latest_build_finished_at: nil)
-    mr_4.metrics.update!(latest_build_started_at: nil, latest_build_finished_at: nil)
-    mr_5.metrics.update!(latest_build_started_at: nil, latest_build_finished_at: nil)
-
-    create(:merge_requests_closing_issues, merge_request: mr_1, issue: issue_1)
-    create(:merge_requests_closing_issues, merge_request: mr_2, issue: issue_2)
-    create(:merge_requests_closing_issues, merge_request: mr_3, issue: issue_3)
-    create(:merge_requests_closing_issues, merge_request: mr_4, issue: issue_3)
-    create(:merge_requests_closing_issues, merge_request: mr_5, issue: issue_3)
-  end
-
   it_behaves_like 'base stage'
 
   describe '#median' do
+    let!(:issue_1) { create(:issue, project: project, created_at: 90.minutes.ago) }
+    let!(:issue_2) { create(:issue, project: project, created_at: 60.minutes.ago) }
+    let!(:issue_3) { create(:issue, project: project, created_at: 60.minutes.ago) }
+    let!(:mr_1) { create(:merge_request, :closed, source_project: project, created_at: 60.minutes.ago) }
+    let!(:mr_2) { create(:merge_request, :closed, source_project: project, created_at: 40.minutes.ago, source_branch: 'A') }
+    let!(:mr_3) { create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'B') }
+    let!(:mr_4) { create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'C') }
+    let!(:mr_5) { create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'D') }
+
+    before do
+      mr_1.metrics.update!(latest_build_started_at: 32.minutes.ago, latest_build_finished_at: 2.minutes.ago)
+      mr_2.metrics.update!(latest_build_started_at: 62.minutes.ago, latest_build_finished_at: 32.minutes.ago)
+      mr_3.metrics.update!(latest_build_started_at: nil, latest_build_finished_at: nil)
+      mr_4.metrics.update!(latest_build_started_at: nil, latest_build_finished_at: nil)
+      mr_5.metrics.update!(latest_build_started_at: nil, latest_build_finished_at: nil)
+
+      create(:merge_requests_closing_issues, merge_request: mr_1, issue: issue_1)
+      create(:merge_requests_closing_issues, merge_request: mr_2, issue: issue_2)
+      create(:merge_requests_closing_issues, merge_request: mr_3, issue: issue_3)
+      create(:merge_requests_closing_issues, merge_request: mr_4, issue: issue_3)
+      create(:merge_requests_closing_issues, merge_request: mr_5, issue: issue_3)
+    end
+
     around do |example|
       Timecop.freeze { example.run }
     end

From 9d2747a6a18561c3186567908323db1ea2d43ff7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ma=C5=82gorzata=20Ksionek?= <mksionek@gitlab.com>
Date: Thu, 4 Jul 2019 11:13:29 +0200
Subject: [PATCH 079/195] Modify specs according to review

---
 .../gitlab/cycle_analytics/test_stage_spec.rb   | 17 ++++++++---------
 1 file changed, 8 insertions(+), 9 deletions(-)

diff --git a/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb b/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb
index 7881fbe589a..8633a63849f 100644
--- a/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb
+++ b/spec/lib/gitlab/cycle_analytics/test_stage_spec.rb
@@ -9,16 +9,15 @@ describe Gitlab::CycleAnalytics::TestStage do
   it_behaves_like 'base stage'
 
   describe '#median' do
-    let!(:issue_1) { create(:issue, project: project, created_at: 90.minutes.ago) }
-    let!(:issue_2) { create(:issue, project: project, created_at: 60.minutes.ago) }
-    let!(:issue_3) { create(:issue, project: project, created_at: 60.minutes.ago) }
-    let!(:mr_1) { create(:merge_request, :closed, source_project: project, created_at: 60.minutes.ago) }
-    let!(:mr_2) { create(:merge_request, :closed, source_project: project, created_at: 40.minutes.ago, source_branch: 'A') }
-    let!(:mr_3) { create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'B') }
-    let!(:mr_4) { create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'C') }
-    let!(:mr_5) { create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'D') }
-
     before do
+      issue_1 = create(:issue, project: project, created_at: 90.minutes.ago)
+      issue_2 = create(:issue, project: project, created_at: 60.minutes.ago)
+      issue_3 = create(:issue, project: project, created_at: 60.minutes.ago)
+      mr_1 = create(:merge_request, :closed, source_project: project, created_at: 60.minutes.ago)
+      mr_2 = create(:merge_request, :closed, source_project: project, created_at: 40.minutes.ago, source_branch: 'A')
+      mr_3 = create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'B')
+      mr_4 = create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'C')
+      mr_5 = create(:merge_request, source_project: project, created_at: 10.minutes.ago, source_branch: 'D')
       mr_1.metrics.update!(latest_build_started_at: 32.minutes.ago, latest_build_finished_at: 2.minutes.ago)
       mr_2.metrics.update!(latest_build_started_at: 62.minutes.ago, latest_build_finished_at: 32.minutes.ago)
       mr_3.metrics.update!(latest_build_started_at: nil, latest_build_finished_at: nil)

From 675c9b9f6bec35f1e6988a42c4fa6a6f8331d14f Mon Sep 17 00:00:00 2001
From: charlieablett <cablett@gitlab.com>
Date: Tue, 2 Jul 2019 17:32:44 +1200
Subject: [PATCH 080/195] Address reviewer comments

- Remove Gitaly call check for fields that have a constant complexity
declared
- Add associated test
---
 app/graphql/types/base_field.rb               |  5 ++++
 app/graphql/types/tree/tree_type.rb           |  2 +-
 lib/gitlab/graphql/calls_gitaly.rb            |  4 +--
 .../graphql/calls_gitaly/instrumentation.rb   |  7 ++---
 spec/graphql/types/base_field_spec.rb         | 15 ++++++++---
 .../calls_gitaly/instrumentation_spec.rb      | 26 +++++++------------
 6 files changed, 34 insertions(+), 25 deletions(-)

diff --git a/app/graphql/types/base_field.rb b/app/graphql/types/base_field.rb
index 6b377e88e16..efeee4a7a4d 100644
--- a/app/graphql/types/base_field.rb
+++ b/app/graphql/types/base_field.rb
@@ -8,6 +8,7 @@ module Types
 
     def initialize(*args, **kwargs, &block)
       @calls_gitaly = !!kwargs.delete(:calls_gitaly)
+      @constant_complexity = !!kwargs[:complexity]
       kwargs[:complexity] ||= field_complexity(kwargs[:resolver_class])
 
       super(*args, **kwargs, &block)
@@ -23,6 +24,10 @@ module Types
       @calls_gitaly
     end
 
+    def constant_complexity?
+      @constant_complexity
+    end
+
     private
 
     def field_complexity(resolver_class)
diff --git a/app/graphql/types/tree/tree_type.rb b/app/graphql/types/tree/tree_type.rb
index 2023abc13f9..fbdc1597461 100644
--- a/app/graphql/types/tree/tree_type.rb
+++ b/app/graphql/types/tree/tree_type.rb
@@ -7,7 +7,7 @@ module Types
       graphql_name 'Tree'
 
       # Complexity 10 as it triggers a Gitaly call on each render
-      field :last_commit, Types::CommitType, null: true, complexity: 10, resolve: -> (tree, args, ctx) do
+      field :last_commit, Types::CommitType, null: true, complexity: 10, calls_gitaly: true, resolve: -> (tree, args, ctx) do
         tree.repository.last_commit_for_path(tree.sha, tree.path)
       end
 
diff --git a/lib/gitlab/graphql/calls_gitaly.rb b/lib/gitlab/graphql/calls_gitaly.rb
index f75941e269f..40cd74a34f2 100644
--- a/lib/gitlab/graphql/calls_gitaly.rb
+++ b/lib/gitlab/graphql/calls_gitaly.rb
@@ -2,8 +2,8 @@
 
 module Gitlab
   module Graphql
-    # Allow fields to declare permissions their objects must have. The field
-    # will be set to nil unless all required permissions are present.
+    # Wraps the field resolution to count Gitaly calls before and after.
+    # Raises an error if the field calls Gitaly but hadn't declared such.
     module CallsGitaly
       extend ActiveSupport::Concern
 
diff --git a/lib/gitlab/graphql/calls_gitaly/instrumentation.rb b/lib/gitlab/graphql/calls_gitaly/instrumentation.rb
index e2733a1416f..fbd5e348c7d 100644
--- a/lib/gitlab/graphql/calls_gitaly/instrumentation.rb
+++ b/lib/gitlab/graphql/calls_gitaly/instrumentation.rb
@@ -5,9 +5,11 @@ module Gitlab
     module CallsGitaly
       class Instrumentation
         # Check if any `calls_gitaly: true` declarations need to be added
+        # Do nothing if a constant complexity was provided
         def instrument(_type, field)
           type_object = field.metadata[:type_class]
-          return field unless type_object && type_object.respond_to?(:calls_gitaly?)
+          return field unless type_object.respond_to?(:calls_gitaly?)
+          return field if type_object.constant_complexity? || type_object.calls_gitaly?
 
           old_resolver_proc = field.resolve_proc
 
@@ -25,12 +27,11 @@ module Gitlab
         end
 
         def calls_gitaly_check(type_object, calls)
-          return if type_object.calls_gitaly?
           return if calls < 1
 
           # Will inform you if there needs to be `calls_gitaly: true` as a kwarg in the field declaration
           # if there is at least 1 Gitaly call involved with the field resolution.
-          error = RuntimeError.new("Gitaly is called for field '#{type_object.name}' on #{type_object.owner.try(:name)} - please add `calls_gitaly: true` to the field declaration")
+          error = RuntimeError.new("Gitaly is called for field '#{type_object.name}' on #{type_object.owner.try(:name)} - please either specify a constant complexity or add `calls_gitaly: true` to the field declaration")
           Gitlab::Sentry.track_exception(error)
         end
       end
diff --git a/spec/graphql/types/base_field_spec.rb b/spec/graphql/types/base_field_spec.rb
index 10913e530cf..77ef8933717 100644
--- a/spec/graphql/types/base_field_spec.rb
+++ b/spec/graphql/types/base_field_spec.rb
@@ -96,10 +96,19 @@ describe Types::BaseField do
         expect(field.base_complexity).to eq Types::BaseField::DEFAULT_COMPLEXITY
       end
 
-      it 'is overridden by declared complexity value' do
-        field = described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: true, complexity: 12)
+      context 'with declared constant complexity value' do
+        it 'has complexity set to that constant' do
+          field = described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, complexity: 12)
 
-        expect(field.to_graphql.complexity).to eq 12
+          expect(field.to_graphql.complexity).to eq 12
+        end
+
+        it 'does not raise an error even with Gitaly calls' do
+          allow(Gitlab::GitalyClient).to receive(:get_request_count).and_return([0, 1])
+          field = described_class.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, complexity: 12)
+
+          expect(field.to_graphql.complexity).to eq 12
+        end
       end
     end
   end
diff --git a/spec/lib/gitlab/graphql/calls_gitaly/instrumentation_spec.rb b/spec/lib/gitlab/graphql/calls_gitaly/instrumentation_spec.rb
index 92d200bfd4e..d93ce464a92 100644
--- a/spec/lib/gitlab/graphql/calls_gitaly/instrumentation_spec.rb
+++ b/spec/lib/gitlab/graphql/calls_gitaly/instrumentation_spec.rb
@@ -4,25 +4,19 @@ require 'spec_helper'
 describe Gitlab::Graphql::CallsGitaly::Instrumentation do
   subject { described_class.new }
 
-  context 'when considering complexity' do
-    describe '#calls_gitaly_check' do
-      let(:gitaly_field) { Types::BaseField.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: true) }
-      let(:no_gitaly_field) { Types::BaseField.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: false) }
+  describe '#calls_gitaly_check' do
+    let(:gitaly_field) { Types::BaseField.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: true) }
+    let(:no_gitaly_field) { Types::BaseField.new(name: 'test', type: GraphQL::STRING_TYPE, null: true, calls_gitaly: false) }
 
-      context 'if there are no Gitaly calls' do
-        it 'does not raise an error if calls_gitaly is false' do
-          expect { subject.send(:calls_gitaly_check, no_gitaly_field, 0) }.not_to raise_error
-        end
+    context 'if there are no Gitaly calls' do
+      it 'does not raise an error if calls_gitaly is false' do
+        expect { subject.send(:calls_gitaly_check, no_gitaly_field, 0) }.not_to raise_error
       end
+    end
 
-      context 'if there is at least 1 Gitaly call' do
-        it 'does not raise an error if calls_gitaly is true' do
-          expect { subject.send(:calls_gitaly_check, gitaly_field, 1) }.not_to raise_error
-        end
-
-        it 'raises an error if calls_gitaly: is false or not defined' do
-          expect { subject.send(:calls_gitaly_check, no_gitaly_field, 1) }.to raise_error(/please add `calls_gitaly: true`/)
-        end
+    context 'if there is at least 1 Gitaly call' do
+      it 'raises an error if calls_gitaly: is false or not defined' do
+        expect { subject.send(:calls_gitaly_check, no_gitaly_field, 1) }.to raise_error(/specify a constant complexity or add `calls_gitaly: true`/)
       end
     end
   end

From e108f0d9610d0e019791920bb5adbc0b493d7b74 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Thu, 4 Jul 2019 22:46:12 +0000
Subject: [PATCH 081/195] Small markdown tweaks to clear kramdown warnings

Fixing square brackets, links, etc in:
  merge_requests.md
  vulnerabilities.md
  issues.md
  issues_statistics.md
  pipelines.md
  services.md
  group_milestones.md
  milestones.md
  runners.md
  changelog.md
  issue_workflow.md
  elasticsearch.md
  api_graphql_styleguide.md
  automatic_ce_ee_merge.md
  file_storage.md
  architecture.md
  database_debugging.md
  index.md
  index.md
  frontend_testing.md
  pry_debugging.md
  vue.md
  development_process.md
---
 doc/api/group_milestones.md                   | 14 ++---
 doc/api/issues.md                             | 22 ++++----
 doc/api/issues_statistics.md                  | 12 ++---
 doc/api/merge_requests.md                     |  8 +--
 doc/api/milestones.md                         | 14 ++---
 doc/api/pipelines.md                          | 10 ++--
 doc/api/runners.md                            | 36 ++++++-------
 doc/api/services.md                           |  2 +-
 doc/api/vulnerabilities.md                    | 14 ++---
 doc/development/api_graphql_styleguide.md     | 15 +++---
 doc/development/architecture.md               |  4 +-
 doc/development/automatic_ce_ee_merge.md      | 53 ++++++++++---------
 doc/development/changelog.md                  |  2 +-
 .../contributing/issue_workflow.md            |  4 +-
 doc/development/database_debugging.md         |  2 +-
 doc/development/elasticsearch.md              |  2 +-
 .../fe_guide/development_process.md           | 24 ++++-----
 doc/development/file_storage.md               |  6 +--
 .../testing_guide/end_to_end/index.md         |  2 +-
 .../testing_guide/frontend_testing.md         |  1 -
 doc/development/testing_guide/index.md        |  2 -
 21 files changed, 123 insertions(+), 126 deletions(-)

diff --git a/doc/api/group_milestones.md b/doc/api/group_milestones.md
index e780a60a416..98e81217875 100644
--- a/doc/api/group_milestones.md
+++ b/doc/api/group_milestones.md
@@ -18,13 +18,13 @@ GET /groups/:id/milestones?search=version
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id` | integer/string | yes | The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user |
-| `iids[]` | Array[integer] | optional | Return only the milestones having the given `iid` |
-| `state` | string | optional | Return only `active` or `closed` milestones |
-| `title` | string | optional | Return only the milestones having the given `title` |
-| `search` | string | optional | Return only milestones with a title or description matching the provided string |
+| Attribute | Type   | Required | Description |
+| --------- | ------ | -------- | ----------- |
+| `id`      | integer/string | yes | The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user |
+| `iids[]`  | integer array | optional | Return only the milestones having the given `iid` |
+| `state`   | string | optional | Return only `active` or `closed` milestones |
+| `title`   | string | optional | Return only the milestones having the given `title` |
+| `search`  | string | optional | Return only milestones with a title or description matching the provided string |
 
 ```bash
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/5/milestones
diff --git a/doc/api/issues.md b/doc/api/issues.md
index b29626525da..544da1e262c 100644
--- a/doc/api/issues.md
+++ b/doc/api/issues.md
@@ -43,12 +43,12 @@ GET /issues?confidential=true
 | `milestone`         | string           | no         | The milestone title. `None` lists all issues with no milestone. `Any` lists all issues that have an assigned milestone.                             |
 | `scope`             | string           | no         | Return issues for the given scope: `created_by_me`, `assigned_to_me` or `all`. Defaults to `created_by_me`<br> For versions before 11.0, use the now deprecated `created-by-me` or `assigned-to-me` scopes instead.<br> _([Introduced][ce-13004] in GitLab 9.5. [Changed to snake_case][ce-18935] in GitLab 11.0)_ |
 | `author_id`         | integer          | no         | Return issues created by the given user `id`. Mutually exclusive with `author_username`. Combine with `scope=all` or `scope=assigned_to_me`. _([Introduced][ce-13004] in GitLab 9.5)_ |
-| `author_username`   | string           | no         | Return issues created by the given `username`. Simillar to `author_id` and mutually exclusive with `author_id`. |
+| `author_username`   | string           | no         | Return issues created by the given `username`. Similar to `author_id` and mutually exclusive with `author_id`. |
 | `assignee_id`       | integer          | no         | Return issues assigned to the given user `id`. Mutually exclusive with `assignee_username`. `None` returns unassigned issues. `Any` returns issues with an assignee. _([Introduced][ce-13004] in GitLab 9.5)_ |
-| `assignee_username` | Array[String]    | no         | Return issues assigned to the given `username`. Simillar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
+| `assignee_username` | string array     | no         | Return issues assigned to the given `username`. Similar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
 | `my_reaction_emoji` | string           | no         | Return issues reacted by the authenticated user by the given `emoji`. `None` returns issues not given a reaction. `Any` returns issues given at least one reaction. _([Introduced][ce-14016] in GitLab 10.0)_ |
 | `weight` **[STARTER]** | integer       | no         | Return issues with the specified `weight`. `None` returns issues with no weight assigned. `Any` returns issues with a weight assigned.              |
-| `iids[]`            | Array[integer]   | no         | Return only the issues having the given `iid`                                                                                                       |
+| `iids[]`            | integer array    | no         | Return only the issues having the given `iid`                                                                                                       |
 | `order_by`          | string           | no         | Return issues ordered by `created_at` or `updated_at` fields. Default is `created_at`                                                               |
 | `sort`              | string           | no         | Return issues sorted in `asc` or `desc` order. Default is `desc`                                                                                    |
 | `search`            | string           | no         | Search issues against their `title` and `description`                                                                                               |
@@ -190,13 +190,13 @@ GET /groups/:id/issues?confidential=true
 | `state`             | string           | no         | Return all issues or just those that are `opened` or `closed`                                                                 |
 | `labels`            | string           | no         | Comma-separated list of label names, issues must have all labels to be returned. `None` lists all issues with no labels. `Any` lists all issues with at least one label. `No+Label` (Deprecated) lists all issues with no labels. Predefined names are case-insensitive. |
 | `with_labels_details` | Boolean        | no         | If `true`, response will return more details for each label in labels field: `:name`, `:color`, `:description`, `:text_color`. Default is `false`. |
-| `iids[]`            | Array[integer]   | no         | Return only the issues having the given `iid`                                                                                 |
+| `iids[]`            | integer array    | no         | Return only the issues having the given `iid`                                                                                 |
 | `milestone`         | string           | no         | The milestone title. `None` lists all issues with no milestone. `Any` lists all issues that have an assigned milestone.       |
 | `scope`             | string           | no         | Return issues for the given scope: `created_by_me`, `assigned_to_me` or `all`.<br> For versions before 11.0, use the now deprecated `created-by-me` or `assigned-to-me` scopes instead.<br> _([Introduced][ce-13004] in GitLab 9.5. [Changed to snake_case][ce-18935] in GitLab 11.0)_ |
 | `author_id`         | integer          | no         | Return issues created by the given user `id`. Mutually exclusive with `author_username`. Combine with `scope=all` or `scope=assigned_to_me`. _([Introduced][ce-13004] in GitLab 9.5)_ |
-| `author_username`   | string           | no         | Return issues created by the given `username`. Simillar to `author_id` and mutually exclusive with `author_id`. |
+| `author_username`   | string           | no         | Return issues created by the given `username`. Similar to `author_id` and mutually exclusive with `author_id`. |
 | `assignee_id`       | integer          | no         | Return issues assigned to the given user `id`. Mutually exclusive with `assignee_username`. `None` returns unassigned issues. `Any` returns issues with an assignee. _([Introduced][ce-13004] in GitLab 9.5)_ |
-| `assignee_username` | Array[String]    | no         | Return issues assigned to the given `username`. Simillar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
+| `assignee_username` | string array     | no         | Return issues assigned to the given `username`. Similar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
 | `my_reaction_emoji` | string           | no         | Return issues reacted by the authenticated user by the given `emoji`. `None` returns issues not given a reaction. `Any` returns issues given at least one reaction. _([Introduced][ce-14016] in GitLab 10.0)_ |
 | `weight` **[STARTER]** | integer       | no         | Return issues with the specified `weight`. `None` returns issues with no weight assigned. `Any` returns issues with a weight assigned. |
 | `order_by`          | string           | no         | Return issues ordered by `created_at` or `updated_at` fields. Default is `created_at`                                         |
@@ -336,16 +336,16 @@ GET /projects/:id/issues?confidential=true
 | Attribute           | Type             | Required   | Description                                                                                                                   |
 | ------------------- | ---------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------- |
 | `id`                | integer/string   | yes        | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user               |
-| `iids[]`            | Array[integer]   | no         | Return only the milestone having the given `iid`                                                                              |
+| `iids[]`            | integer array    | no         | Return only the milestone having the given `iid`                                                                              |
 | `state`             | string           | no         | Return all issues or just those that are `opened` or `closed`                                                                 |
 | `labels`            | string           | no         | Comma-separated list of label names, issues must have all labels to be returned. `None` lists all issues with no labels. `Any` lists all issues with at least one label. `No+Label` (Deprecated) lists all issues with no labels. Predefined names are case-insensitive. |
 | `with_labels_details` | Boolean        | no         | If `true`, response will return more details for each label in labels field: `:name`, `:color`, `:description`, `:text_color`. Default is `false`. |
 | `milestone`         | string           | no         | The milestone title. `None` lists all issues with no milestone. `Any` lists all issues that have an assigned milestone.       |
 | `scope`             | string           | no         | Return issues for the given scope: `created_by_me`, `assigned_to_me` or `all`.<br> For versions before 11.0, use the now deprecated `created-by-me` or `assigned-to-me` scopes instead.<br> _([Introduced][ce-13004] in GitLab 9.5. [Changed to snake_case][ce-18935] in GitLab 11.0)_ |
 | `author_id`         | integer          | no         | Return issues created by the given user `id`. Mutually exclusive with `author_username`. Combine with `scope=all` or `scope=assigned_to_me`. _([Introduced][ce-13004] in GitLab 9.5)_ |
-| `author_username`   | string           | no         | Return issues created by the given `username`. Simillar to `author_id` and mutually exclusive with `author_id`. |
+| `author_username`   | string           | no         | Return issues created by the given `username`. Similar to `author_id` and mutually exclusive with `author_id`. |
 | `assignee_id`       | integer          | no         | Return issues assigned to the given user `id`. Mutually exclusive with `assignee_username`. `None` returns unassigned issues. `Any` returns issues with an assignee. _([Introduced][ce-13004] in GitLab 9.5)_ |
-| `assignee_username` | Array[String]    | no         | Return issues assigned to the given `username`. Simillar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
+| `assignee_username` | string array     | no         | Return issues assigned to the given `username`. Similar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
 | `my_reaction_emoji` | string           | no         | Return issues reacted by the authenticated user by the given `emoji`. `None` returns issues not given a reaction. `Any` returns issues given at least one reaction. _([Introduced][ce-14016] in GitLab 10.0)_ |
 | `weight` **[STARTER]** | integer       | no         | Return issues with the specified `weight`. `None` returns issues with no weight assigned. `Any` returns issues with a weight assigned. |
 | `order_by`          | string           | no         | Return issues ordered by `created_at` or `updated_at` fields. Default is `created_at`                                         |
@@ -596,7 +596,7 @@ POST /projects/:id/issues
 | `title`                                   | string         | yes      | The title of an issue |
 | `description`                             | string         | no       | The description of an issue  |
 | `confidential`                            | boolean        | no       | Set an issue to be confidential. Default is `false`.  |
-| `assignee_ids`                            | Array[integer] | no       | The ID of a user to assign issue |
+| `assignee_ids`                            | integer array  | no       | The ID of a user to assign issue |
 | `milestone_id`                            | integer        | no       | The global ID of a milestone to assign issue  |
 | `labels`                                  | string         | no       | Comma-separated label names for an issue  |
 | `created_at`                              | string         | no       | Date time string, ISO 8601 formatted, e.g. `2016-03-11T03:45:40Z` (requires admin or project/group owner rights) |
@@ -697,7 +697,7 @@ PUT /projects/:id/issues/:issue_iid
 | `title`        | string  | no       | The title of an issue                                                                                      |
 | `description`  | string  | no       | The description of an issue                                                                                |
 | `confidential` | boolean | no       | Updates an issue to be confidential                                                                        |
-| `assignee_ids` | Array[integer] | no  | The ID of the user(s) to assign the issue to. Set to `0` or provide an empty value to unassign all assignees.  |
+| `assignee_ids` | integer array | no | The ID of the user(s) to assign the issue to. Set to `0` or provide an empty value to unassign all assignees. |
 | `milestone_id` | integer | no       | The global ID of a milestone to assign the issue to. Set to `0` or provide an empty value to unassign a milestone.|
 | `labels`       | string  | no       | Comma-separated label names for an issue. Set to an empty string to unassign all labels.                   |
 | `state_event`  | string  | no       | The state event of an issue. Set `close` to close the issue and `reopen` to reopen it                      |
diff --git a/doc/api/issues_statistics.md b/doc/api/issues_statistics.md
index 82bc9c142cc..58a32e879d7 100644
--- a/doc/api/issues_statistics.md
+++ b/doc/api/issues_statistics.md
@@ -34,9 +34,9 @@ GET /issues_statistics?confidential=true
 | `author_id`         | integer          | no         | Return issues created by the given user `id`. Mutually exclusive with `author_username`. Combine with `scope=all` or `scope=assigned_to_me`. |
 | `author_username`   | string           | no         | Return issues created by the given `username`. Similar to `author_id` and mutually exclusive with `author_id`. |
 | `assignee_id`       | integer          | no         | Return issues assigned to the given user `id`. Mutually exclusive with `assignee_username`. `None` returns unassigned issues. `Any` returns issues with an assignee. |
-| `assignee_username` | Array[String]    | no         | Return issues assigned to the given `username`. Similar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
+| `assignee_username` | string array     | no         | Return issues assigned to the given `username`. Similar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
 | `my_reaction_emoji` | string           | no         | Return issues reacted by the authenticated user by the given `emoji`. `None` returns issues not given a reaction. `Any` returns issues given at least one reaction. |
-| `iids[]`            | Array[integer]   | no         | Return only the issues having the given `iid`                                                                                                       |
+| `iids[]`            | integer array    | no         | Return only the issues having the given `iid`                                                                                                       |
 | `search`            | string           | no         | Search issues against their `title` and `description`                                                                                               |
 | `in`                | string           | no         | Modify the scope of the `search` attribute. `title`, `description`, or a string joining them with comma. Default is `title,description`             |
 | `created_after`     | datetime         | no         | Return issues created on or after the given time                                                                                                    |
@@ -86,13 +86,13 @@ GET /groups/:id/issues_statistics?confidential=true
 | ------------------- | ---------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------- |
 | `id`                | integer/string   | yes        | The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user                 |
 | `labels`            | string           | no         | Comma-separated list of label names, issues must have all labels to be returned. `None` lists all issues with no labels. `Any` lists all issues with at least one label. |
-| `iids[]`            | Array[integer]   | no         | Return only the issues having the given `iid`                                                                                 |
+| `iids[]`            | integer array    | no         | Return only the issues having the given `iid`                                                                                 |
 | `milestone`         | string           | no         | The milestone title. `None` lists all issues with no milestone. `Any` lists all issues that have an assigned milestone.       |
 | `scope`             | string           | no         | Return issues for the given scope: `created_by_me`, `assigned_to_me` or `all`. |
 | `author_id`         | integer          | no         | Return issues created by the given user `id`. Mutually exclusive with `author_username`. Combine with `scope=all` or `scope=assigned_to_me`. |
 | `author_username`   | string           | no         | Return issues created by the given `username`. Similar to `author_id` and mutually exclusive with `author_id`. |
 | `assignee_id`       | integer          | no         | Return issues assigned to the given user `id`. Mutually exclusive with `assignee_username`. `None` returns unassigned issues. `Any` returns issues with an assignee. |
-| `assignee_username` | Array[String]    | no         | Return issues assigned to the given `username`. Similar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
+| `assignee_username` | string array     | no         | Return issues assigned to the given `username`. Similar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
 | `my_reaction_emoji` | string           | no         | Return issues reacted by the authenticated user by the given `emoji`. `None` returns issues not given a reaction. `Any` returns issues given at least one reaction. |
 | `search`            | string           | no         | Search group issues against their `title` and `description`                                                                   |
 | `created_after`     | datetime         | no         | Return issues created on or after the given time                                                                              |
@@ -141,14 +141,14 @@ GET /projects/:id/issues_statistics?confidential=true
 | Attribute           | Type             | Required   | Description                                                                                                                   |
 | ------------------- | ---------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------- |
 | `id`                | integer/string   | yes        | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user               |
-| `iids[]`            | Array[integer]   | no         | Return only the milestone having the given `iid`                                                                              |
+| `iids[]`            | integer array    | no         | Return only the milestone having the given `iid`                                                                              |
 | `labels`            | string           | no         | Comma-separated list of label names, issues must have all labels to be returned. `None` lists all issues with no labels. `Any` lists all issues with at least one label. |
 | `milestone`         | string           | no         | The milestone title. `None` lists all issues with no milestone. `Any` lists all issues that have an assigned milestone.       |
 | `scope`             | string           | no         | Return issues for the given scope: `created_by_me`, `assigned_to_me` or `all`. |
 | `author_id`         | integer          | no         | Return issues created by the given user `id`. Mutually exclusive with `author_username`. Combine with `scope=all` or `scope=assigned_to_me`. |
 | `author_username`   | string           | no         | Return issues created by the given `username`. Similar to `author_id` and mutually exclusive with `author_id`. |
 | `assignee_id`       | integer          | no         | Return issues assigned to the given user `id`. Mutually exclusive with `assignee_username`. `None` returns unassigned issues. `Any` returns issues with an assignee. |
-| `assignee_username` | Array[String]    | no         | Return issues assigned to the given `username`. Similar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
+| `assignee_username` | string array     | no         | Return issues assigned to the given `username`. Similar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
 | `my_reaction_emoji` | string           | no         | Return issues reacted by the authenticated user by the given `emoji`. `None` returns issues not given a reaction. `Any` returns issues given at least one reaction. |
 | `search`            | string           | no         | Search project issues against their `title` and `description`                                                                 |
 | `created_after`     | datetime         | no         | Return issues created on or after the given time                                                                              |
diff --git a/doc/api/merge_requests.md b/doc/api/merge_requests.md
index eeb035ef49c..850e3be42d5 100644
--- a/doc/api/merge_requests.md
+++ b/doc/api/merge_requests.md
@@ -192,7 +192,7 @@ Parameters:
 | Attribute           | Type           | Required | Description                                                                                                                    |
 | ------------------- | -------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
 | `id`                | integer        | yes      | The ID of a project                                                                                                            |
-| `iids[]`            | Array[integer] | no       | Return the request having the given `iid`                                                                                      |
+| `iids[]`            | integer array  | no     | Return the request having the given `iid`                                                                                      |
 | `state`             | string         | no       | Return all merge requests or just those that are `opened`, `closed`, `locked`, or `merged`                                     |
 | `order_by`          | string         | no       | Return requests ordered by `created_at` or `updated_at` fields. Default is `created_at`                                        |
 | `sort`              | string         | no       | Return requests sorted in `asc` or `desc` order. Default is `desc`                                                             |
@@ -831,12 +831,12 @@ POST /projects/:id/merge_requests
 
 | Attribute                  | Type    | Required | Description                                                                     |
 | ---------                  | ----    | -------- | -----------                                                                     |
-| `id`                       | integer/string  | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
+| `id`                       | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
 | `source_branch`            | string  | yes      | The source branch                                                               |
 | `target_branch`            | string  | yes      | The target branch                                                               |
 | `title`                    | string  | yes      | Title of MR                                                                     |
 | `assignee_id`              | integer | no       | Assignee user ID                                                                |
-| `assignee_ids`             | Array[integer] | no  | The ID of the user(s) to assign the MR to. Set to `0` or provide an empty value to unassign all assignees.  |
+| `assignee_ids`             | integer array | no | The ID of the user(s) to assign the MR to. Set to `0` or provide an empty value to unassign all assignees.  |
 | `description`              | string  | no       | Description of MR                                                               |
 | `target_project_id`        | integer | no       | The target project (numeric id)                                                 |
 | `labels`                   | string  | no       | Labels for MR as a comma-separated list                                         |
@@ -987,7 +987,7 @@ PUT /projects/:id/merge_requests/:merge_request_iid
 | `target_branch`            | string  | no       | The target branch                                                               |
 | `title`                    | string  | no       | Title of MR                                                                     |
 | `assignee_id`              | integer | no       | The ID of the user to assign the merge request to. Set to `0` or provide an empty value to unassign all assignees.  |
-| `assignee_ids`             | Array[integer] | no  | The ID of the user(s) to assign the MR to. Set to `0` or provide an empty value to unassign all assignees.  |
+| `assignee_ids`             | integer array | no | The ID of the user(s) to assign the MR to. Set to `0` or provide an empty value to unassign all assignees.  |
 | `milestone_id`             | integer | no       | The global ID of a milestone to assign the merge request to. Set to `0` or provide an empty value to unassign a milestone.|
 | `labels`                   | string  | no       | Comma-separated label names for a merge request. Set to an empty string to unassign all labels.                    |
 | `description`              | string  | no       | Description of MR                                                               |
diff --git a/doc/api/milestones.md b/doc/api/milestones.md
index e745d0c2e6c..8f69378dac3 100644
--- a/doc/api/milestones.md
+++ b/doc/api/milestones.md
@@ -16,13 +16,13 @@ GET /projects/:id/milestones?search=version
 
 Parameters:
 
-| Attribute | Type | Required | Description |
-| --------- | ---- | -------- | ----------- |
-| `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
-| `iids[]` | Array[integer] | optional | Return only the milestones having the given `iid` |
-| `state` | string | optional | Return only `active` or `closed` milestones |
-| `title` | string | optional | Return only the milestones having the given `title` |
-| `search` | string | optional | Return only milestones with a title or description matching the provided string |
+| Attribute | Type   | Required | Description |
+| --------- | ------ | -------- | ----------- |
+| `id`      | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
+| `iids[]`  | integer array | optional | Return only the milestones having the given `iid` |
+| `state`   | string | optional | Return only `active` or `closed` milestones |
+| `title`   | string | optional | Return only the milestones having the given `title` |
+| `search`  | string | optional | Return only milestones with a title or description matching the provided string |
 
 ```bash
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/projects/5/milestones
diff --git a/doc/api/pipelines.md b/doc/api/pipelines.md
index 753faec3cc8..e36f74e7c77 100644
--- a/doc/api/pipelines.md
+++ b/doc/api/pipelines.md
@@ -132,11 +132,11 @@ Example of response
 POST /projects/:id/pipeline
 ```
 
-| Attribute  | Type    | Required | Description         |
-|------------|---------|----------|---------------------|
-| `id`       | integer/string | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
-| `ref`       | string | yes      | Reference to commit |
-| `variables` | array | no | An array containing the variables available in the pipeline, matching the structure [{ 'key' => 'UPLOAD_TO_S3', 'variable_type' => 'file', 'value' => 'true' }] |
+| Attribute   | Type    | Required | Description         |
+|-------------|---------|----------|---------------------|
+| `id`        | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
+| `ref`       | string  | yes      | Reference to commit |
+| `variables` | array   | no       | An array containing the variables available in the pipeline, matching the structure `[{ 'key' => 'UPLOAD_TO_S3', 'variable_type' => 'file', 'value' => 'true' }]` |
 
 ```
 curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/pipeline?ref=master"
diff --git a/doc/api/runners.md b/doc/api/runners.md
index 2d91428d1c1..90e9fbff247 100644
--- a/doc/api/runners.md
+++ b/doc/api/runners.md
@@ -44,7 +44,7 @@ GET /runners?tag_list=tag1,tag2
 | `scope`     | string         | no       | Deprecated: Use `type` or `status` instead. The scope of specific runners to show, one of: `active`, `paused`, `online`, `offline`; showing all runners if none provided |
 | `type`      | string         | no       | The type of runners to show, one of: `instance_type`, `group_type`, `project_type` |
 | `status`    | string         | no       | The status of runners to show, one of: `active`, `paused`, `online`, `offline` |
-| `tag_list`  | Array[String]  | no       | List of of the runner's tags |
+| `tag_list`  | string array   | no       | List of of the runner's tags |
 
 ```
 curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/runners"
@@ -95,7 +95,7 @@ GET /runners/all?tag_list=tag1,tag2
 | `scope`     | string         | no       | Deprecated: Use `type` or `status` instead. The scope of runners to show, one of: `specific`, `shared`, `active`, `paused`, `online`, `offline`; showing all runners if none provided |
 | `type`      | string         | no       | The type of runners to show, one of: `instance_type`, `group_type`, `project_type` |
 | `status`    | string         | no       | The status of runners to show, one of: `active`, `paused`, `online`, `offline` |
-| `tag_list`  | Array[String]  | no       | List of of the runner's tags |
+| `tag_list`  | string array   | no       | List of of the runner's tags |
 
 ```
 curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/runners/all"
@@ -214,10 +214,10 @@ PUT /runners/:id
 | `description` | string  | no       | The description of a runner |
 | `active`      | boolean | no       | The state of a runner; can be set to `true` or `false` |
 | `tag_list`    | array   | no       | The list of tags for a runner; put array of tags, that should be finally assigned to a runner |
-| `run_untagged`    | boolean   | no       | Flag indicating the runner can execute untagged jobs |
-| `locked`    | boolean   | no       | Flag indicating the runner is locked |
-| `access_level`    | string   | no       | The access_level of the runner; `not_protected` or `ref_protected` |
-| `maximum_timeout` | integer | no | Maximum timeout set when this Runner will handle the job |
+| `run_untagged`| boolean | no       | Flag indicating the runner can execute untagged jobs |
+| `locked`      | boolean | no       | Flag indicating the runner is locked |
+| `access_level` | string | no       | The access_level of the runner; `not_protected` or `ref_protected` |
+| `maximum_timeout` | integer | no   | Maximum timeout set when this Runner will handle the job |
 
 ```
 curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/runners/6" --form "description=test-1-20150125-test" --form "tag_list=ruby,mysql,tag1,tag2"
@@ -385,7 +385,7 @@ GET /projects/:id/runners?tag_list=tag1,tag2
 | `scope`    | string         | no       | Deprecated: Use `type` or `status` instead. The scope of specific runners to show, one of: `active`, `paused`, `online`, `offline`; showing all runners if none provided |
 | `type`     | string         | no       | The type of runners to show, one of: `instance_type`, `group_type`, `project_type` |
 | `status`   | string         | no       | The status of runners to show, one of: `active`, `paused`, `online`, `offline` |
-| `tag_list` | Array[String]  | no       | List of of the runner's tags |
+| `tag_list` | string array   | no       | List of of the runner's tags |
 
 ```
 curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/9/runners"
@@ -477,17 +477,17 @@ Register a new Runner for the instance.
 POST /runners
 ```
 
-| Attribute   | Type    | Required | Description         |
-|-------------|---------|----------|---------------------|
-| `token`     | string  | yes      | [Registration token](#registration-and-authentication-tokens).  |
-| `description`| string | no       | Runner's description|
-| `info`       | hash   | no       | Runner's metadata   |
-| `active`     | boolean| no       | Whether the Runner is active   |
-| `locked`     | boolean| no       | Whether the Runner should be locked for current project |
-| `run_untagged` | boolean | no | Whether the Runner should handle untagged jobs |
-| `tag_list` | Array[String] | no | List of Runner's tags |
-| `access_level`    | string   | no       | The access_level of the runner; `not_protected` or `ref_protected` |
-| `maximum_timeout` | integer | no | Maximum timeout set when this Runner will handle the job |
+| Attribute    | Type    | Required | Description         |
+|--------------|---------|----------|---------------------|
+| `token`      | string  | yes      | [Registration token](#registration-and-authentication-tokens).  |
+| `description`| string  | no       | Runner's description|
+| `info`       | hash    | no       | Runner's metadata   |
+| `active`     | boolean | no       | Whether the Runner is active   |
+| `locked`     | boolean | no       | Whether the Runner should be locked for current project |
+| `run_untagged` | boolean | no     | Whether the Runner should handle untagged jobs |
+| `tag_list`   | string array | no  | List of Runner's tags |
+| `access_level`    | string | no   | The access_level of the runner; `not_protected` or `ref_protected` |
+| `maximum_timeout` | integer | no  | Maximum timeout set when this Runner will handle the job |
 
 ```
 curl --request POST "https://gitlab.example.com/api/v4/runners" --form "token=<registration_token>" --form "description=test-1-20150125-test" --form "tag_list=ruby,mysql,tag1,tag2"
diff --git a/doc/api/services.md b/doc/api/services.md
index c811d0e84ca..4f35c17e927 100644
--- a/doc/api/services.md
+++ b/doc/api/services.md
@@ -583,7 +583,7 @@ Parameters:
 | `username`      | string | yes  | The username of the user created to be used with GitLab/Jira. |
 | `password`      | string | yes  | The password of the user created to be used with GitLab/Jira. |
 | `active`        | boolean | no  | Activates or deactivates the service. Defaults to false (deactivated). |
-| `jira_issue_transition_id` | string | no | The ID of a transition that moves issues to a closed state. You can find this number under the Jira workflow administration (**Administration > Issues > Workflows**) by selecting **View** under **Operations** of the desired workflow of your project. The ID of each state can be found inside the parenthesis of each transition name under the **Transitions (id)** column ([see screenshot][trans]). By default, this ID is set to `2`. |
+| `jira_issue_transition_id` | string | no | The ID of a transition that moves issues to a closed state. You can find this number under the Jira workflow administration (**Administration > Issues > Workflows**) by selecting **View** under **Operations** of the desired workflow of your project. The ID of each state can be found inside the parenthesis of each transition name under the **Transitions (id)** column. By default, this ID is set to `2`. |
 | `commit_events` | boolean | false | Enable notifications for commit events |
 | `merge_requests_events` | boolean | false | Enable notifications for merge request events |
 
diff --git a/doc/api/vulnerabilities.md b/doc/api/vulnerabilities.md
index 390d0966244..f1b11c7bceb 100644
--- a/doc/api/vulnerabilities.md
+++ b/doc/api/vulnerabilities.md
@@ -32,13 +32,13 @@ GET /projects/:id/vulnerabilities?severity=high
 GET /projects/:id/vulnerabilities?confidence=unknown,experimental
 ```
 
-| Attribute           | Type             | Required   | Description                                                                                                                                                                 |
-| ------------------- | ---------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| `id`                | integer/string   | yes        | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user.                                                            |
-| `report_type`       | Array[string]    | no         | Returns vulnerabilities belonging to specified report type. Valid values: `sast`, `dast`, `dependency_scanning`, or `container_scanning`.                                   |
-| `scope`             | string           | no         | Returns vulnerabilities for the given scope: `all` or `dismissed`. Defaults to `dismissed`                                                                                  |
-| `severity`          | Array[string]    | no         | Returns vulnerabilities belonging to specified severity level: `undefined`, `info`, `unknown`, `low`, `medium`, `high`, or `critical`. Defaults to all'                     |
-| `confidence`        | Array[string]    | no         | Returns vulnerabilities belonging to specified confidence level: `undefined`, `ignore`, `unknown`, `experimental`, `low`, `medium`, `high`, or `confirmed`. Defaults to all |
+| Attribute     | Type           | Required | Description                                                                                                                                                                 |
+| ------------- | -------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `id`          | integer/string | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user.                                                            |
+| `report_type` | string array   | no       | Returns vulnerabilities belonging to specified report type. Valid values: `sast`, `dast`, `dependency_scanning`, or `container_scanning`.                                   |
+| `scope`       | string         | no       | Returns vulnerabilities for the given scope: `all` or `dismissed`. Defaults to `dismissed`                                                                                  |
+| `severity`    | string array   | no       | Returns vulnerabilities belonging to specified severity level: `undefined`, `info`, `unknown`, `low`, `medium`, `high`, or `critical`. Defaults to all'                     |
+| `confidence`  | string array   | no       | Returns vulnerabilities belonging to specified confidence level: `undefined`, `ignore`, `unknown`, `experimental`, `low`, `medium`, `high`, or `confirmed`. Defaults to all |
 
 ```bash
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/projects/4/vulnerabilities
diff --git a/doc/development/api_graphql_styleguide.md b/doc/development/api_graphql_styleguide.md
index aeddad14995..c83a0427c98 100644
--- a/doc/development/api_graphql_styleguide.md
+++ b/doc/development/api_graphql_styleguide.md
@@ -2,13 +2,14 @@
 
 ## Deep Dive
 
-In March 2019, Nick Thomas hosted a [Deep Dive] on GitLab's [GraphQL API] to share his domain specific knowledge with anyone who may work in this part of the code base in the future. You can find the [recording on YouTube], and the slides on [Google Slides] and in [PDF]. Everything covered in this deep dive was accurate as of GitLab 11.9, and while specific details may have changed since then, it should still serve as a good introduction.
-
-[Deep Dive]: https://gitlab.com/gitlab-org/create-stage/issues/1
-[Pull Repository Mirroring functionality]: ../api/graphql/
-[recording on YouTube]: https://www.youtube.com/watch?v=-9L_1MWrjkg
-[Google Slides]: https://docs.google.com/presentation/d/1qOTxpkTdHIp1CRjuTvO-aXg0_rUtzE3ETfLUdnBB5uQ/edit
-[PDF]: https://gitlab.com/gitlab-org/create-stage/uploads/8e78ea7f326b2ef649e7d7d569c26d56/GraphQL_Deep_Dive__Create_.pdf
+In March 2019, Nick Thomas hosted a [Deep Dive](https://gitlab.com/gitlab-org/create-stage/issues/1)
+on GitLab's [GraphQL API](../api/graphql/index.md) to share his domain specific knowledge
+with anyone who may work in this part of the code base in the future. You can find the
+[recording on YouTube](https://www.youtube.com/watch?v=-9L_1MWrjkg), and the slides on
+[Google Slides](https://docs.google.com/presentation/d/1qOTxpkTdHIp1CRjuTvO-aXg0_rUtzE3ETfLUdnBB5uQ/edit)
+and in [PDF](https://gitlab.com/gitlab-org/create-stage/uploads/8e78ea7f326b2ef649e7d7d569c26d56/GraphQL_Deep_Dive__Create_.pdf).
+Everything covered in this deep dive was accurate as of GitLab 11.9, and while specific
+details may have changed since then, it should still serve as a good introduction.
 
 ## Authentication
 
diff --git a/doc/development/architecture.md b/doc/development/architecture.md
index ee6d00331e3..8319603fea2 100644
--- a/doc/development/architecture.md
+++ b/doc/development/architecture.md
@@ -267,7 +267,7 @@ GitLab CI is the open-source continuous integration service included with GitLab
 #### Gitlab Workhorse
 
 - [Project page](https://gitlab.com/gitlab-org/gitlab-workhorse/blob/master/README.md)
-- Configuration: [Omnibus][gitlab-workhorse-omnibus], [Charts][gitlab-workhorse-charts], [Source][workhorse-source]
+- Configuration: [Omnibus][workhorse-omnibus], [Charts][workhorse-charts], [Source][workhorse-source]
 - Layer: Core Service (Processor)
 - Process: `gitlab-workhorse`
 
@@ -681,7 +681,7 @@ We've also detailed [our architecture of GitLab.com](https://about.gitlab.com/ha
 [pgbouncer-exporter-omnibus]: ../administration/monitoring/prometheus/pgbouncer_exporter.md
 [pgbouncer-exporter-charts]: https://docs.gitlab.com/charts/installation/deployment.html#postgresql
 [gitlab-monitor-omnibus]: ../administration/monitoring/prometheus/gitlab_monitor_exporter.md
-[gitab-monitor-charts]: https://docs.gitlab.com/charts/charts/gitlab/gitlab-monitor/index.html
+[gitlab-monitor-charts]: https://docs.gitlab.com/charts/charts/gitlab/gitlab-monitor/index.html
 [node-exporter-omnibus]: ../administration/monitoring/prometheus/node_exporter.md
 [node-exporter-charts]: https://gitlab.com/charts/gitlab/issues/1332
 [mattermost-omnibus]: https://docs.gitlab.com/omnibus/gitlab-mattermost/
diff --git a/doc/development/automatic_ce_ee_merge.md b/doc/development/automatic_ce_ee_merge.md
index 3ca841353e6..423b35a9e3a 100644
--- a/doc/development/automatic_ce_ee_merge.md
+++ b/doc/development/automatic_ce_ee_merge.md
@@ -115,7 +115,7 @@ Now, every time you create an MR for CE and EE:
    1. Continue cherry-picking: `git cherry-pick --continue`
    1. Push to EE: `git push origin branch-example-ee`
 1. Create the EE-equivalent MR and link to the CE MR from the
-   description "Ports [CE-MR-LINK] to EE"
+   description `Ports [CE-MR-LINK] to EE`
 1. Once all the jobs are passing in both CE and EE, you've addressed the
    feedback from your own team, and got them approved, the merge requests can be merged.
 1. When both MRs are ready, the EE merge request will be merged first, and the
@@ -125,42 +125,43 @@ Now, every time you create an MR for CE and EE:
 
 - The commit SHA can be easily found from the GitLab UI. From a merge request,
   open the tab **Commits** and click the copy icon to copy the commit SHA.
-- To cherry-pick a **commit range**, such as [A > B > C > D] use:
+- To cherry-pick a **commit range**, such as (A > B > C > D) use:
 
-    ```shell
-    git cherry-pick "oldest-commit-SHA^..newest-commit-SHA"
-    ```
+  ```shell
+  git cherry-pick "oldest-commit-SHA^..newest-commit-SHA"
+  ```
 
-    For example, suppose the commit A is the oldest, and its SHA is `4f5e4018c09ed797fdf446b3752f82e46f5af502`,
-    and the commit D is the newest, and its SHA is `80e1c9e56783bd57bd7129828ec20b252ebc0538`.
-    The cherry-pick command will be:
+  For example, suppose the commit A is the oldest, and its SHA is `4f5e4018c09ed797fdf446b3752f82e46f5af502`,
+  and the commit D is the newest, and its SHA is `80e1c9e56783bd57bd7129828ec20b252ebc0538`.
+  The cherry-pick command will be:
 
-    ```shell
-    git cherry-pick "4f5e4018c09ed797fdf446b3752f82e46f5af502^..80e1c9e56783bd57bd7129828ec20b252ebc0538"
-    ```
+  ```shell
+  git cherry-pick "4f5e4018c09ed797fdf446b3752f82e46f5af502^..80e1c9e56783bd57bd7129828ec20b252ebc0538"
+  ```
 
 - To cherry-pick a **merge commit**, use the flag `-m 1`. For example, suppose that the
   merge commit SHA is `138f5e2f20289bb376caffa0303adb0cac859ce1`:
 
-    ```shell
-    git cherry-pick -m 1 138f5e2f20289bb376caffa0303adb0cac859ce1
-    ```
-- To cherry-pick multiple commits, such as B and D in a range [A > B > C > D], use:
+  ```shell
+  git cherry-pick -m 1 138f5e2f20289bb376caffa0303adb0cac859ce1
+  ```
 
-    ```shell
-    git cherry-pick commit-B-SHA commit-D-SHA
-    ```
+- To cherry-pick multiple commits, such as B and D in a range (A > B > C > D), use:
 
-    For example, suppose commit B SHA = `4f5e4018c09ed797fdf446b3752f82e46f5af502`,
-    and the commit D SHA = `80e1c9e56783bd57bd7129828ec20b252ebc0538`.
-    The cherry-pick command will be:
+  ```shell
+  git cherry-pick commit-B-SHA commit-D-SHA
+  ```
 
-    ```shell
-    git cherry-pick 4f5e4018c09ed797fdf446b3752f82e46f5af502 80e1c9e56783bd57bd7129828ec20b252ebc0538
-    ```
+  For example, suppose commit B SHA = `4f5e4018c09ed797fdf446b3752f82e46f5af502`,
+  and the commit D SHA = `80e1c9e56783bd57bd7129828ec20b252ebc0538`.
+  The cherry-pick command will be:
 
-    This case is particularly useful when you have a merge commit in a sequence of
-    commits and you want to cherry-pick all but the merge commit.
+  ```shell
+  git cherry-pick 4f5e4018c09ed797fdf446b3752f82e46f5af502 80e1c9e56783bd57bd7129828ec20b252ebc0538
+  ```
+
+  This case is particularly useful when you have a merge commit in a sequence of
+  commits and you want to cherry-pick all but the merge commit.
 
 - If you push more commits to the CE branch, you can safely repeat the procedure
   to cherry-pick them to the EE-equivalent branch. You can do that as many times as
diff --git a/doc/development/changelog.md b/doc/development/changelog.md
index 45b3d5a23a1..33c1c3bd9e4 100644
--- a/doc/development/changelog.md
+++ b/doc/development/changelog.md
@@ -62,7 +62,7 @@ making it both concise and descriptive, err on the side of descriptive.
 The first example provides no context of where the change was made, or why, or
 how it benefits the user.
 
-- **Bad:** Copy [some text] to clipboard.
+- **Bad:** Copy (some text) to clipboard.
 - **Good:** Update the "Copy to clipboard" tooltip to indicate what's being
   copied.
 
diff --git a/doc/development/contributing/issue_workflow.md b/doc/development/contributing/issue_workflow.md
index f4fa0caeb01..27c349c03aa 100644
--- a/doc/development/contributing/issue_workflow.md
+++ b/doc/development/contributing/issue_workflow.md
@@ -345,7 +345,7 @@ For feature proposals for EE, open an issue on the
 
 In order to help track the feature proposals, we have created a
 [`feature`][fl] label. For the time being, users that are not members
-of the project cannot add labels. You can instead ask one of the [core team]
+of the project cannot add labels. You can instead ask one of the [core team](https://about.gitlab.com/community/core-team/)
 members to add the label ~feature to the issue or add the following
 code snippet right after your description in a new line: `~feature`.
 
@@ -356,7 +356,7 @@ Please submit Feature Proposals using the ['Feature Proposal' issue template](ht
 
 For changes in the interface, it is helpful to include a mockup. Issues that add to, or change, the interface should
 be given the ~"UX" label. This will allow the UX team to provide input and guidance. You may
-need to ask one of the [core team] members to add the label, if you do not have permissions to do it by yourself.
+need to ask one of the [core team](https://about.gitlab.com/community/core-team/) members to add the label, if you do not have permissions to do it by yourself.
 
 If you want to create something yourself, consider opening an issue first to
 discuss whether it is interesting to include this in GitLab.
diff --git a/doc/development/database_debugging.md b/doc/development/database_debugging.md
index de2c5b43411..0311eda1ff1 100644
--- a/doc/development/database_debugging.md
+++ b/doc/development/database_debugging.md
@@ -3,7 +3,7 @@
 This section is to help give some copy-pasta you can use as a reference when you
 run into some head-banging database problems.
 
-An easy first step is to search for your error in Slack or google "GitLab <my error>".
+An easy first step is to search for your error in Slack or google "GitLab (my error)".
 
 ---
 
diff --git a/doc/development/elasticsearch.md b/doc/development/elasticsearch.md
index 603a756ff56..e5da47ba16e 100644
--- a/doc/development/elasticsearch.md
+++ b/doc/development/elasticsearch.md
@@ -150,7 +150,7 @@ Uses an [Edge NGram token filter](https://www.elastic.co/guide/en/elasticsearch/
 
 ## Troubleshooting
 
-### Getting "flood stage disk watermark [95%] exceeded"
+### Getting `flood stage disk watermark [95%] exceeded`
 
 You might get an error such as
 
diff --git a/doc/development/fe_guide/development_process.md b/doc/development/fe_guide/development_process.md
index f3fdaa3b883..ae0e2361840 100644
--- a/doc/development/fe_guide/development_process.md
+++ b/doc/development/fe_guide/development_process.md
@@ -12,8 +12,7 @@ This checklist is intended to help us during development of bigger features/refa
 
 Please use your best judgement when to use it and please contribute new points through merge requests if something comes to your mind.
 
----
-
+```
 ### Frontend development
 
 #### Planning development
@@ -24,15 +23,15 @@ Please use your best judgement when to use it and please contribute new points t
 - [ ] Are all necessary UX specifications available that you will need in order to implement? Are there new UX components/patterns in the designs? Then contact the UI component team early on. How should error messages or validation be handled?
 - [ ] **Library usage** Use Vuex as soon as you have even a medium state to manage, use Vue router if you need to have different views internally and want to link from the outside. Check what libraries we already have for which occasions.
 - [ ] **Plan your implementation:**
-    - [ ] **Architecture plan:** Create a plan aligned with GitLab's architecture, how you are going to do the implementation, for example Vue application setup and its components (through [onion skinning](https://gitlab.com/gitlab-org/gitlab-ce/issues/35873#note_39994091)), Store structure and data flow, which existing Vue components can you reuse. It's a good idea to go through your plan with another engineer to refine it.
-    - [ ] **Backend:** The best way is to kickoff the implementation in a call and discuss with the assigned Backend engineer what you will need from the backend and also when. Can you reuse existing API's? How is the performance with the planned architecture? Maybe create together a JSON mock object to already start with development.
-    - [ ] **Communication:** It also makes sense to have for bigger features an own slack channel (normally called #f_{feature_name}) and even weekly demo calls with all people involved.
-    - [ ] **Dependency Plan:** Are there big dependencies in the plan between you and others, then maybe create an execution diagram to show what is blocking which part and the order of the different parts.
-    - [ ] **Task list:** Create a simple checklist of the subtasks that are needed for the implementation, also consider creating even sub issues. (for example show a comment, delete a comment, update a comment, etc.). This helps you and also everyone else following the implementation
+  - [ ] **Architecture plan:** Create a plan aligned with GitLab's architecture, how you are going to do the implementation, for example Vue application setup and its components (through [onion skinning](https://gitlab.com/gitlab-org/gitlab-ce/issues/35873#note_39994091)), Store structure and data flow, which existing Vue components can you reuse. It's a good idea to go through your plan with another engineer to refine it.
+  - [ ] **Backend:** The best way is to kickoff the implementation in a call and discuss with the assigned Backend engineer what you will need from the backend and also when. Can you reuse existing API's? How is the performance with the planned architecture? Maybe create together a JSON mock object to already start with development.
+  - [ ] **Communication:** It also makes sense to have for bigger features an own slack channel (normally called #f_{feature_name}) and even weekly demo calls with all people involved.
+  - [ ] **Dependency Plan:** Are there big dependencies in the plan between you and others, then maybe create an execution diagram to show what is blocking which part and the order of the different parts.
+  - [ ] **Task list:** Create a simple checklist of the subtasks that are needed for the implementation, also consider creating even sub issues. (for example show a comment, delete a comment, update a comment, etc.). This helps you and also everyone else following the implementation
 - [ ] **Keep it small** To make it easier for you and also all reviewers try to keep merge requests small and merge into a feature branch if needed. To accomplish that you need to plan that from the start. Different methods are:
-    - [ ] **Skeleton based plan** Start with an MR that has the skeleton of the components with placeholder content. In following MRs you can fill the components with interactivity. This also makes it easier to spread out development on multiple people.
-    - [ ] **Cookie Mode** Think about hiding the feature behind a cookie flag if the implementation is on top of existing features
-    - [ ] **New route** Are you refactoring something big then you might consider adding a new route where you implement the new feature and when finished delete the current route and rename the new one. (for example 'merge_request' and 'new_merge_request')
+  - [ ] **Skeleton based plan** Start with an MR that has the skeleton of the components with placeholder content. In following MRs you can fill the components with interactivity. This also makes it easier to spread out development on multiple people.
+  - [ ] **Cookie Mode** Think about hiding the feature behind a cookie flag if the implementation is on top of existing features
+  - [ ] **New route** Are you refactoring something big then you might consider adding a new route where you implement the new feature and when finished delete the current route and rename the new one. (for example 'merge_request' and 'new_merge_request')
 - [ ] **Setup** Is there any specific setup needed for your implementation (for example a kubernetes cluster)? Then let everyone know if it is not already mentioned where they can find documentation (if it doesn't exist - create it)
 - [ ] **Security** Are there any new security relevant implementations? Then please contact the security team for an app security review. If you are not sure ask our [domain expert](https://about.gitlab.com/handbook/engineering/frontend/#frontend-domain-experts)
 
@@ -57,8 +56,7 @@ Please use your best judgement when to use it and please contribute new points t
 - [ ] Are there any big changes on how and especially how frequently we use the API then let production know about it
 - [ ] Smoke test of the RC on dev., staging., canary deployments and .com
 - [ ] Follow up on issues that came out of the review. Create issues for discovered edge cases that should be covered in future iterations.
-
----
+```
 
 ### Share your work early
 
@@ -66,7 +64,7 @@ Please use your best judgement when to use it and please contribute new points t
    GitLab's architecture.
 1. Add a diagram to the issue and ask a frontend architect in the slack channel `#fe_architectural` about it.
 
-  ![Diagram of Issue Boards Architecture](img/boards_diagram.png)
+   ![Diagram of Issue Boards Architecture](img/boards_diagram.png)
 
 1. Don't take more than one week between starting work on a feature and
    sharing a Merge Request with a reviewer or a maintainer.
diff --git a/doc/development/file_storage.md b/doc/development/file_storage.md
index 18e4dc2ca0c..02874d18a30 100644
--- a/doc/development/file_storage.md
+++ b/doc/development/file_storage.md
@@ -33,9 +33,9 @@ they are still not 100% standardized. You can see them below:
 | User avatars                          | yes    | uploads/-/system/user/avatar/:id/:filename                  | `AvatarUploader`       | User       |
 | User snippet attachments              | yes    | uploads/-/system/personal_snippet/:id/:random_hex/:filename | `PersonalFileUploader` | Snippet    |
 | Project avatars                       | yes    | uploads/-/system/project/avatar/:id/:filename               | `AvatarUploader`       | Project    |
-| Issues/MR/Notes Markdown attachments        | yes    | uploads/:project_path_with_namespace/:random_hex/:filename  | `FileUploader`         | Project    |
-| Issues/MR/Notes Legacy Markdown attachments | no     | uploads/-/system/note/attachment/:id/:filename              | `AttachmentUploader`   | Note       |
-| CI Artifacts (CE)                     | yes    | shared/artifacts/:disk_hash[0..1]/:disk_hash[2..3]/:disk_hash/:year_:month_:date/:job_id/:job_artifact_id (:disk_hash is SHA256 digest of project_id) | `JobArtifactUploader`  | Ci::JobArtifact  |
+| Issues/MR/Notes Markdown attachments  | yes    | uploads/:project_path_with_namespace/:random_hex/:filename  | `FileUploader`         | Project    |
+| Issues/MR/Notes Legacy Markdown attachments | no | uploads/-/system/note/attachment/:id/:filename            | `AttachmentUploader`   | Note       |
+| CI Artifacts (CE)                     | yes    | `shared/artifacts/:disk_hash[0..1]/:disk_hash[2..3]/:disk_hash/:year_:month_:date/:job_id/:job_artifact_id` (:disk_hash is SHA256 digest of project_id) | `JobArtifactUploader`  | Ci::JobArtifact  |
 | LFS Objects  (CE)                     | yes    | shared/lfs-objects/:hex/:hex/:object_hash                   | `LfsObjectUploader`    | LfsObject  |
 | External merge request diffs          | yes    | shared/external-diffs/merge_request_diffs/mr-:parent_id/diff-:id | `ExternalDiffUploader` | MergeRequestDiff |
 
diff --git a/doc/development/testing_guide/end_to_end/index.md b/doc/development/testing_guide/end_to_end/index.md
index 527cd350633..59eb3ecfd7e 100644
--- a/doc/development/testing_guide/end_to_end/index.md
+++ b/doc/development/testing_guide/end_to_end/index.md
@@ -79,7 +79,7 @@ subgraph gitlab-ce/ee pipeline
     end
 
 subgraph omnibus-gitlab pipeline
-    A2[<b>`Trigger-docker` stage</b></b><br />`Trigger:gitlab-docker` job] -->|once done| B2
+    A2[<b>`Trigger-docker` stage</b><br />`Trigger:gitlab-docker` job] -->|once done| B2
     end
 
 subgraph gitlab-qa pipeline
diff --git a/doc/development/testing_guide/frontend_testing.md b/doc/development/testing_guide/frontend_testing.md
index 28ebb6f0f64..98df0b5ea7c 100644
--- a/doc/development/testing_guide/frontend_testing.md
+++ b/doc/development/testing_guide/frontend_testing.md
@@ -560,7 +560,6 @@ end
 [vue-test]: https://docs.gitlab.com/ce/development/fe_guide/vue.html#testing-vue-components
 [rspec]: https://github.com/rspec/rspec-rails#feature-specs
 [capybara]: https://github.com/teamcapybara/capybara
-[karma]: http://karma-runner.github.io/
 [jasmine]: https://jasmine.github.io/
 
 ---
diff --git a/doc/development/testing_guide/index.md b/doc/development/testing_guide/index.md
index 93ee2a6371a..c4b18391cb2 100644
--- a/doc/development/testing_guide/index.md
+++ b/doc/development/testing_guide/index.md
@@ -80,8 +80,6 @@ Everything you should know about how to run end-to-end tests using
 
 [Return to Development documentation](../README.md)
 
-[^1]: /ci/yaml/README.html#dependencies
-
 [rails]: http://rubyonrails.org/
 [RSpec]: https://github.com/rspec/rspec-rails#feature-specs
 [Capybara]: https://github.com/teamcapybara/capybara

From d23a654fc5fa1a3c36538b8f0206e34a549689aa Mon Sep 17 00:00:00 2001
From: Mark Lapierre <mlapierre@gitlab.com>
Date: Fri, 5 Jul 2019 09:13:29 +1000
Subject: [PATCH 082/195] Initialize Issue labels

This provides a valid default value when labels are
not specified explicitly.
---
 qa/qa/resource/issue.rb | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/qa/qa/resource/issue.rb b/qa/qa/resource/issue.rb
index 9c57a0f5afb..51b2af8b4ef 100644
--- a/qa/qa/resource/issue.rb
+++ b/qa/qa/resource/issue.rb
@@ -16,6 +16,10 @@ module QA
       attribute :labels
       attribute :title
 
+      def initialize
+        @labels = []
+      end
+
       def fabricate!
         project.visit!
 
@@ -38,7 +42,7 @@ module QA
 
       def api_post_body
         {
-          labels: [labels],
+          labels: labels,
           title: title
         }
       end

From 02530168067d671eb4c1ee7212390e274bef02f9 Mon Sep 17 00:00:00 2001
From: Mayra Cabrera <mcabrera@gitlab.com>
Date: Fri, 5 Jul 2019 01:54:18 +0000
Subject: [PATCH 083/195] Add pgFormatter as a database tooling

Includes a PostgreSQL syntax beautifier as a database tooling.
---
 doc/development/README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/development/README.md b/doc/development/README.md
index 5df6ec5fd56..1566173992a 100644
--- a/doc/development/README.md
+++ b/doc/development/README.md
@@ -82,6 +82,7 @@ description: 'Learn how to contribute to GitLab.'
 - [Understanding EXPLAIN plans](understanding_explain_plans.md)
 - [explain.depesz.com](https://explain.depesz.com/) for visualising the output
   of `EXPLAIN`
+- [pgFormatter](http://sqlformat.darold.net/) a PostgreSQL SQL syntax beautifier
 
 ### Migrations
 

From da767e3c689cd45a12fa0b37e1acf8cc995cecf6 Mon Sep 17 00:00:00 2001
From: Mark Lapierre <mlapierre@gitlab.com>
Date: Fri, 5 Jul 2019 04:00:20 +0000
Subject: [PATCH 084/195] Revert "Merge branch
 'qa-quarantine-failing-push-mirror-repo-spec' into 'master'"

This reverts merge request !25590
---
 .../3_create/repository/push_mirroring_over_http_spec.rb       | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/qa/qa/specs/features/browser_ui/3_create/repository/push_mirroring_over_http_spec.rb b/qa/qa/specs/features/browser_ui/3_create/repository/push_mirroring_over_http_spec.rb
index 23008a58af8..448d4980727 100644
--- a/qa/qa/specs/features/browser_ui/3_create/repository/push_mirroring_over_http_spec.rb
+++ b/qa/qa/specs/features/browser_ui/3_create/repository/push_mirroring_over_http_spec.rb
@@ -1,8 +1,7 @@
 # frozen_string_literal: true
 
 module QA
-  # https://gitlab.com/gitlab-org/quality/staging/issues/40
-  context 'Create', :quarantine do
+  context 'Create' do
     describe 'Push mirror a repository over HTTP' do
       it 'configures and syncs a (push) mirrored repository' do
         Runtime::Browser.visit(:gitlab, Page::Main::Login)

From b9b3ec83540a82fc96ddd64715a51d7adeb7312c Mon Sep 17 00:00:00 2001
From: Imre Farkas <ifarkas@gitlab.com>
Date: Fri, 5 Jul 2019 08:12:29 +0200
Subject: [PATCH 085/195] CE port of "Require session with smartcard login for
 Git access"

---
 lib/gitlab/namespaced_session_store.rb        | 15 ++++++----
 .../gitlab/namespaced_session_store_spec.rb   | 30 ++++++++++++++-----
 2 files changed, 32 insertions(+), 13 deletions(-)

diff --git a/lib/gitlab/namespaced_session_store.rb b/lib/gitlab/namespaced_session_store.rb
index 34520078bfb..f0f24c081c3 100644
--- a/lib/gitlab/namespaced_session_store.rb
+++ b/lib/gitlab/namespaced_session_store.rb
@@ -4,19 +4,24 @@ module Gitlab
   class NamespacedSessionStore
     delegate :[], :[]=, to: :store
 
-    def initialize(key)
+    def initialize(key, session = Session.current)
       @key = key
+      @session = session
     end
 
     def initiated?
-      !Session.current.nil?
+      !session.nil?
     end
 
     def store
-      return unless Session.current
+      return unless session
 
-      Session.current[@key] ||= {}
-      Session.current[@key]
+      session[@key] ||= {}
+      session[@key]
     end
+
+    private
+
+    attr_reader :session
   end
 end
diff --git a/spec/lib/gitlab/namespaced_session_store_spec.rb b/spec/lib/gitlab/namespaced_session_store_spec.rb
index c0af2ede32a..e177c44ad67 100644
--- a/spec/lib/gitlab/namespaced_session_store_spec.rb
+++ b/spec/lib/gitlab/namespaced_session_store_spec.rb
@@ -4,19 +4,33 @@ require 'spec_helper'
 
 describe Gitlab::NamespacedSessionStore do
   let(:key) { :some_key }
-  subject { described_class.new(key) }
 
-  it 'stores data under the specified key' do
-    Gitlab::Session.with_session({}) do
-      subject[:new_data] = 123
+  context 'current session' do
+    subject { described_class.new(key) }
 
-      expect(Thread.current[:session_storage][key]).to eq(new_data: 123)
+    it 'stores data under the specified key' do
+      Gitlab::Session.with_session({}) do
+        subject[:new_data] = 123
+
+        expect(Thread.current[:session_storage][key]).to eq(new_data: 123)
+      end
+    end
+
+    it 'retrieves data from the given key' do
+      Thread.current[:session_storage] = { key => { existing_data: 123 } }
+
+      expect(subject[:existing_data]).to eq 123
     end
   end
 
-  it 'retrieves data from the given key' do
-    Thread.current[:session_storage] = { key => { existing_data: 123 } }
+  context 'passed in session' do
+    let(:data) { { 'data' => 42 } }
+    let(:session) { { 'some_key' => data } }
 
-    expect(subject[:existing_data]).to eq 123
+    subject { described_class.new(key, session.with_indifferent_access) }
+
+    it 'retrieves data from the given key' do
+      expect(subject['data']).to eq 42
+    end
   end
 end

From 587ffd11480db3ed492459ec2b6fac32a459ebaa Mon Sep 17 00:00:00 2001
From: Shinya Maeda <shinya@gitlab.com>
Date: Wed, 26 Jun 2019 19:24:09 +0700
Subject: [PATCH 086/195] Split AutoMergeService interfaces into two `cancel`
 and `abort`

Create explicit endpoint - abort.
---
 app/services/auto_merge/base_service.rb       | 14 ++++++-
 .../merge_when_pipeline_succeeds_service.rb   |  8 +++-
 app/services/auto_merge_service.rb            |  6 +++
 app/services/merge_requests/base_service.rb   |  4 +-
 app/services/merge_requests/close_service.rb  |  2 +-
 .../merge_requests/refresh_service.rb         |  6 +--
 app/services/merge_requests/update_service.rb |  2 +-
 app/services/system_note_service.rb           | 10 +++++
 spec/services/auto_merge/base_service_spec.rb | 40 ++++++++++++++++---
 ...rge_when_pipeline_succeeds_service_spec.rb | 11 +++++
 spec/services/auto_merge_service_spec.rb      | 25 ++++++++++++
 spec/services/system_note_service_spec.rb     | 16 ++++++++
 12 files changed, 129 insertions(+), 15 deletions(-)

diff --git a/app/services/auto_merge/base_service.rb b/app/services/auto_merge/base_service.rb
index d726085b89a..e06659a39cd 100644
--- a/app/services/auto_merge/base_service.rb
+++ b/app/services/auto_merge/base_service.rb
@@ -29,7 +29,7 @@ module AutoMerge
     end
 
     def cancel(merge_request)
-      if cancel_auto_merge(merge_request)
+      if clear_auto_merge_parameters(merge_request)
         yield if block_given?
 
         success
@@ -38,6 +38,16 @@ module AutoMerge
       end
     end
 
+    def abort(merge_request, reason)
+      if clear_auto_merge_parameters(merge_request)
+        yield if block_given?
+
+        success
+      else
+        error("Can't abort the automatic merge", 406)
+      end
+    end
+
     private
 
     def strategy
@@ -46,7 +56,7 @@ module AutoMerge
       end
     end
 
-    def cancel_auto_merge(merge_request)
+    def clear_auto_merge_parameters(merge_request)
       merge_request.auto_merge_enabled = false
       merge_request.merge_user = nil
 
diff --git a/app/services/auto_merge/merge_when_pipeline_succeeds_service.rb b/app/services/auto_merge/merge_when_pipeline_succeeds_service.rb
index cde8c19e8fc..6a33ec071db 100644
--- a/app/services/auto_merge/merge_when_pipeline_succeeds_service.rb
+++ b/app/services/auto_merge/merge_when_pipeline_succeeds_service.rb
@@ -19,7 +19,13 @@ module AutoMerge
 
     def cancel(merge_request)
       super do
-        SystemNoteService.cancel_merge_when_pipeline_succeeds(merge_request, @project, @current_user)
+        SystemNoteService.cancel_merge_when_pipeline_succeeds(merge_request, project, current_user)
+      end
+    end
+
+    def abort(merge_request, reason)
+      super do
+        SystemNoteService.abort_merge_when_pipeline_succeeds(merge_request, project, current_user, reason)
       end
     end
 
diff --git a/app/services/auto_merge_service.rb b/app/services/auto_merge_service.rb
index 926d2f5fc66..95bf2db2018 100644
--- a/app/services/auto_merge_service.rb
+++ b/app/services/auto_merge_service.rb
@@ -42,6 +42,12 @@ class AutoMergeService < BaseService
     get_service_instance(merge_request.auto_merge_strategy).cancel(merge_request)
   end
 
+  def abort(merge_request, reason)
+    return error("Can't abort the automatic merge", 406) unless merge_request.auto_merge_enabled?
+
+    get_service_instance(merge_request.auto_merge_strategy).abort(merge_request, reason)
+  end
+
   def available_strategies(merge_request)
     self.class.all_strategies.select do |strategy|
       get_service_instance(strategy).available_for?(merge_request)
diff --git a/app/services/merge_requests/base_service.rb b/app/services/merge_requests/base_service.rb
index c34fbeb2adb..067510a8a0a 100644
--- a/app/services/merge_requests/base_service.rb
+++ b/app/services/merge_requests/base_service.rb
@@ -68,8 +68,8 @@ module MergeRequests
         !merge_request.for_fork?
     end
 
-    def cancel_auto_merge(merge_request)
-      AutoMergeService.new(project, current_user).cancel(merge_request)
+    def abort_auto_merge(merge_request, reason)
+      AutoMergeService.new(project, current_user).abort(merge_request, reason)
     end
 
     # Returns all origin and fork merge requests from `@project` satisfying passed arguments.
diff --git a/app/services/merge_requests/close_service.rb b/app/services/merge_requests/close_service.rb
index b81a4dd81d2..c2174d2a130 100644
--- a/app/services/merge_requests/close_service.rb
+++ b/app/services/merge_requests/close_service.rb
@@ -18,7 +18,7 @@ module MergeRequests
         invalidate_cache_counts(merge_request, users: merge_request.assignees)
         merge_request.update_project_counter_caches
         cleanup_environments(merge_request)
-        cancel_auto_merge(merge_request)
+        abort_auto_merge(merge_request, 'merge request was closed')
       end
 
       merge_request
diff --git a/app/services/merge_requests/refresh_service.rb b/app/services/merge_requests/refresh_service.rb
index 4b199bd8fa8..8961d2e1023 100644
--- a/app/services/merge_requests/refresh_service.rb
+++ b/app/services/merge_requests/refresh_service.rb
@@ -24,7 +24,7 @@ module MergeRequests
       reload_merge_requests
       outdate_suggestions
       refresh_pipelines_on_merge_requests
-      cancel_auto_merges
+      abort_auto_merges
       mark_pending_todos_done
       cache_merge_requests_closing_issues
 
@@ -142,9 +142,9 @@ module MergeRequests
       end
     end
 
-    def cancel_auto_merges
+    def abort_auto_merges
       merge_requests_for_source_branch.each do |merge_request|
-        cancel_auto_merge(merge_request)
+        abort_auto_merge(merge_request, 'source branch was updated')
       end
     end
 
diff --git a/app/services/merge_requests/update_service.rb b/app/services/merge_requests/update_service.rb
index 0066cd0491f..d361e96babf 100644
--- a/app/services/merge_requests/update_service.rb
+++ b/app/services/merge_requests/update_service.rb
@@ -44,7 +44,7 @@ module MergeRequests
                                   merge_request.previous_changes['target_branch'].first,
                                   merge_request.target_branch)
 
-        cancel_auto_merge(merge_request)
+        abort_auto_merge(merge_request, 'target branch was changed')
       end
 
       if merge_request.assignees != old_assignees
diff --git a/app/services/system_note_service.rb b/app/services/system_note_service.rb
index 4783417ad6d..005050ad08b 100644
--- a/app/services/system_note_service.rb
+++ b/app/services/system_note_service.rb
@@ -234,6 +234,16 @@ module SystemNoteService
     create_note(NoteSummary.new(noteable, project, author, body, action: 'merge'))
   end
 
+  # Called when 'merge when pipeline succeeds' is aborted
+  def abort_merge_when_pipeline_succeeds(noteable, project, author, reason)
+    body = "aborted the automatic merge because #{reason}"
+
+    ##
+    # TODO: Abort message should be sent by the system, not a particular user.
+    # See https://gitlab.com/gitlab-org/gitlab-ce/issues/63187.
+    create_note(NoteSummary.new(noteable, project, author, body, action: 'merge'))
+  end
+
   def handle_merge_request_wip(noteable, project, author)
     prefix = noteable.work_in_progress? ? "marked" : "unmarked"
 
diff --git a/spec/services/auto_merge/base_service_spec.rb b/spec/services/auto_merge/base_service_spec.rb
index 24cb63a0d61..a409f21a7e4 100644
--- a/spec/services/auto_merge/base_service_spec.rb
+++ b/spec/services/auto_merge/base_service_spec.rb
@@ -121,11 +121,7 @@ describe AutoMerge::BaseService do
     end
   end
 
-  describe '#cancel' do
-    subject { service.cancel(merge_request) }
-
-    let(:merge_request) { create(:merge_request, :merge_when_pipeline_succeeds) }
-
+  shared_examples_for 'Canceled or Dropped' do
     it 'removes properies from the merge request' do
       subject
 
@@ -173,6 +169,20 @@ describe AutoMerge::BaseService do
       it 'does not yield block' do
         expect { |b| service.execute(merge_request, &b) }.not_to yield_control
       end
+    end
+  end
+
+  describe '#cancel' do
+    subject { service.cancel(merge_request) }
+
+    let(:merge_request) { create(:merge_request, :merge_when_pipeline_succeeds) }
+
+    it_behaves_like 'Canceled or Dropped'
+
+    context 'when failed to save' do
+      before do
+        allow(merge_request).to receive(:save) { false }
+      end
 
       it 'returns error status' do
         expect(subject[:status]).to eq(:error)
@@ -180,4 +190,24 @@ describe AutoMerge::BaseService do
       end
     end
   end
+
+  describe '#abort' do
+    subject { service.abort(merge_request, reason) }
+
+    let(:merge_request) { create(:merge_request, :merge_when_pipeline_succeeds) }
+    let(:reason) { 'an error'}
+
+    it_behaves_like 'Canceled or Dropped'
+
+    context 'when failed to save' do
+      before do
+        allow(merge_request).to receive(:save) { false }
+      end
+
+      it 'returns error status' do
+        expect(subject[:status]).to eq(:error)
+        expect(subject[:message]).to eq("Can't abort the automatic merge")
+      end
+    end
+  end
 end
diff --git a/spec/services/auto_merge/merge_when_pipeline_succeeds_service_spec.rb b/spec/services/auto_merge/merge_when_pipeline_succeeds_service_spec.rb
index 5e84ef052ce..931b52470c4 100644
--- a/spec/services/auto_merge/merge_when_pipeline_succeeds_service_spec.rb
+++ b/spec/services/auto_merge/merge_when_pipeline_succeeds_service_spec.rb
@@ -177,6 +177,17 @@ describe AutoMerge::MergeWhenPipelineSucceedsService do
     end
   end
 
+  describe "#abort" do
+    before do
+      service.abort(mr_merge_if_green_enabled, 'an error')
+    end
+
+    it 'posts a system note' do
+      note = mr_merge_if_green_enabled.notes.last
+      expect(note.note).to include 'aborted the automatic merge'
+    end
+  end
+
   describe 'pipeline integration' do
     context 'when there are multiple stages in the pipeline' do
       let(:ref) { mr_merge_if_green_enabled.source_branch }
diff --git a/spec/services/auto_merge_service_spec.rb b/spec/services/auto_merge_service_spec.rb
index 93a22e60498..50dfc49a59c 100644
--- a/spec/services/auto_merge_service_spec.rb
+++ b/spec/services/auto_merge_service_spec.rb
@@ -161,4 +161,29 @@ describe AutoMergeService do
       end
     end
   end
+
+  describe '#abort' do
+    subject { service.abort(merge_request, error) }
+
+    let(:merge_request) { create(:merge_request, :merge_when_pipeline_succeeds) }
+    let(:error) { 'an error' }
+
+    it 'delegates to a relevant service instance' do
+      expect_next_instance_of(AutoMerge::MergeWhenPipelineSucceedsService) do |service|
+        expect(service).to receive(:abort).with(merge_request, error)
+      end
+
+      subject
+    end
+
+    context 'when auto merge is not enabled' do
+      let(:merge_request) { create(:merge_request) }
+
+      it 'returns error' do
+        expect(subject[:message]).to eq("Can't abort the automatic merge")
+        expect(subject[:status]).to eq(:error)
+        expect(subject[:http_status]).to eq(406)
+      end
+    end
+  end
 end
diff --git a/spec/services/system_note_service_spec.rb b/spec/services/system_note_service_spec.rb
index 9f60e49290e..2d33e1c37eb 100644
--- a/spec/services/system_note_service_spec.rb
+++ b/spec/services/system_note_service_spec.rb
@@ -359,6 +359,22 @@ describe SystemNoteService do
     end
   end
 
+  describe '.abort_merge_when_pipeline_succeeds' do
+    let(:noteable) do
+      create(:merge_request, source_project: project, target_project: project)
+    end
+
+    subject { described_class.abort_merge_when_pipeline_succeeds(noteable, project, author, 'merge request was closed') }
+
+    it_behaves_like 'a system note' do
+      let(:action) { 'merge' }
+    end
+
+    it "posts the 'merge when pipeline succeeds' system note" do
+      expect(subject.note).to eq "aborted the automatic merge because merge request was closed"
+    end
+  end
+
   describe '.change_title' do
     let(:noteable) { create(:issue, project: project, title: 'Lorem ipsum') }
 

From 6e552981248a551e8c70c8d2866a401a8d1090b5 Mon Sep 17 00:00:00 2001
From: Thong Kuah <tkuah@gitlab.com>
Date: Fri, 5 Jul 2019 07:07:46 +0000
Subject: [PATCH 087/195] Remove obsolete comment

---
 lib/gitlab/ci/templates/Jobs/Deploy.gitlab-ci.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/lib/gitlab/ci/templates/Jobs/Deploy.gitlab-ci.yml b/lib/gitlab/ci/templates/Jobs/Deploy.gitlab-ci.yml
index dcf8254ef94..108f0119ae1 100644
--- a/lib/gitlab/ci/templates/Jobs/Deploy.gitlab-ci.yml
+++ b/lib/gitlab/ci/templates/Jobs/Deploy.gitlab-ci.yml
@@ -246,7 +246,6 @@ rollout 100%:
   auto_database_url=postgres://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${CI_ENVIRONMENT_SLUG}-postgres:5432/${POSTGRES_DB}
   export DATABASE_URL=${DATABASE_URL-$auto_database_url}
   export TILLER_NAMESPACE=$KUBE_NAMESPACE
-  # Extract "MAJOR.MINOR" from CI_SERVER_VERSION and generate "MAJOR-MINOR-stable" for Security Products
 
   function get_replicas() {
     track="${1:-stable}"

From ef66b8db797b63c8207cfa6a21f097ac00ce1731 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Fri, 5 Jul 2019 08:17:39 +0000
Subject: [PATCH 088/195] Move workflow images to img dir

Clean out workflow directory by moving images
from gitlab_flow doc to /img
---
 doc/workflow/gitlab_flow.md                   |  35 +++++++++---------
 doc/workflow/{ => img}/ci_mr.png              | Bin
 doc/workflow/{ => img}/close_issue_mr.png     | Bin
 .../{ => img}/environment_branches.png        | Bin
 doc/workflow/{ => img}/four_stages.png        | Bin
 doc/workflow/{ => img}/git_pull.png           | Bin
 doc/workflow/{ => img}/gitdashflow.png        | Bin
 doc/workflow/{ => img}/github_flow.png        | Bin
 doc/workflow/{ => img}/gitlab_flow.png        | Bin
 doc/workflow/{ => img}/good_commit.png        | Bin
 doc/workflow/{ => img}/merge_commits.png      | Bin
 doc/workflow/{ => img}/merge_request.png      | Bin
 doc/workflow/{ => img}/messy_flow.png         | Bin
 doc/workflow/{ => img}/mr_inline_comments.png | Bin
 doc/workflow/{ => img}/production_branch.png  | Bin
 doc/workflow/{ => img}/rebase.png             | Bin
 doc/workflow/{ => img}/release_branches.png   | Bin
 doc/workflow/{ => img}/remove_checkbox.png    | Bin
 18 files changed, 18 insertions(+), 17 deletions(-)
 rename doc/workflow/{ => img}/ci_mr.png (100%)
 rename doc/workflow/{ => img}/close_issue_mr.png (100%)
 rename doc/workflow/{ => img}/environment_branches.png (100%)
 rename doc/workflow/{ => img}/four_stages.png (100%)
 rename doc/workflow/{ => img}/git_pull.png (100%)
 rename doc/workflow/{ => img}/gitdashflow.png (100%)
 rename doc/workflow/{ => img}/github_flow.png (100%)
 rename doc/workflow/{ => img}/gitlab_flow.png (100%)
 rename doc/workflow/{ => img}/good_commit.png (100%)
 rename doc/workflow/{ => img}/merge_commits.png (100%)
 rename doc/workflow/{ => img}/merge_request.png (100%)
 rename doc/workflow/{ => img}/messy_flow.png (100%)
 rename doc/workflow/{ => img}/mr_inline_comments.png (100%)
 rename doc/workflow/{ => img}/production_branch.png (100%)
 rename doc/workflow/{ => img}/rebase.png (100%)
 rename doc/workflow/{ => img}/release_branches.png (100%)
 rename doc/workflow/{ => img}/remove_checkbox.png (100%)

diff --git a/doc/workflow/gitlab_flow.md b/doc/workflow/gitlab_flow.md
index 0cb390e1242..2f365e42cc9 100644
--- a/doc/workflow/gitlab_flow.md
+++ b/doc/workflow/gitlab_flow.md
@@ -1,7 +1,8 @@
-![GitLab Flow](gitlab_flow.png)
 
 # Introduction to GitLab Flow
 
+![GitLab Flow](img/gitlab_flow.png)
+
 Git allows a wide variety of branching strategies and workflows.
 Because of this, many organizations end up with workflows that are too complicated, not clearly defined, or not integrated with issue tracking systems.
 Therefore, we propose GitLab flow as a clearly defined set of best practices.
@@ -11,7 +12,7 @@ Organizations coming to Git from other version control systems frequently find i
 This article describes GitLab flow, which integrates the Git workflow with an issue tracking system.
 It offers a simple, transparent, and effective way to work with Git.
 
-![Four stages (working copy, index, local repo, remote repo) and three steps between them](four_stages.png)
+![Four stages (working copy, index, local repo, remote repo) and three steps between them](img/four_stages.png)
 
 When converting to Git, you have to get used to the fact that it takes three steps to share a commit with colleagues.
 Most version control systems have only one step: committing from the working copy to a shared server.
@@ -19,7 +20,7 @@ In Git, you add files from the working copy to the staging area. After that, you
 The third step is pushing to a shared remote repository.
 After getting used to these three steps, the next challenge is the branching model.
 
-![Multiple long-running branches and merging in all directions](messy_flow.png)
+![Multiple long-running branches and merging in all directions](img/messy_flow.png)
 
 Since many organizations new to Git have no conventions for how to work with it, their repositories can quickly become messy.
 The biggest problem is that many long-running branches emerge that all contain part of the changes.
@@ -31,7 +32,7 @@ For a video introduction of how this works in GitLab, see [GitLab Flow](https://
 
 ## Git flow and its problems
 
-![Git Flow timeline by Vincent Driessen, used with permission](gitdashflow.png)
+![Git Flow timeline by Vincent Driessen, used with permission](img/gitdashflow.png)
 
 Git flow was one of the first proposals to use Git branches, and it has received a lot of attention.
 It suggests a `master` branch and a separate `develop` branch, as well as supporting branches for features, releases, and hotfixes.
@@ -54,7 +55,7 @@ For example, many projects do releases but don't need to do hotfixes.
 
 ## GitHub flow as a simpler alternative
 
-![Master branch with feature branches merged in](github_flow.png)
+![Master branch with feature branches merged in](img/github_flow.png)
 
 In reaction to Git flow, GitHub created a simpler alternative.
 [GitHub flow](https://guides.github.com/introduction/flow/index.html) has only feature branches and a `master` branch.
@@ -66,7 +67,7 @@ With GitLab flow, we offer additional guidance for these questions.
 
 ## Production branch with GitLab flow
 
-![Master branch and production branch with an arrow that indicates a deployment](production_branch.png)
+![Master branch and production branch with an arrow that indicates a deployment](img/production_branch.png)
 
 GitHub flow assumes you can deploy to production every time you merge a feature branch.
 While this is possible in some cases, such as SaaS applications, there are many cases where this is not possible.
@@ -82,7 +83,7 @@ This flow prevents the overhead of releasing, tagging, and merging that happens
 
 ## Environment branches with GitLab flow
 
-![Multiple branches with the code cascading from one to another](environment_branches.png)
+![Multiple branches with the code cascading from one to another](img/environment_branches.png)
 
 It might be a good idea to have an environment that is automatically updated to the `master` branch.
 Only, in this case, the name of this environment might differ from the branch name.
@@ -98,7 +99,7 @@ If this is not possible because more manual testing is required, you can send me
 
 ## Release branches with GitLab flow
 
-![Master and multiple release branches that vary in length with cherry-picks from master](release_branches.png)
+![Master and multiple release branches that vary in length with cherry-picks from master](img/release_branches.png)
 
 You only need to work with release branches if you need to release software to the outside world.
 In this case, each branch contains a minor version, for example, 2-3-stable, 2-4-stable, etc.
@@ -114,7 +115,7 @@ In this flow, it is not common to have a production branch (or Git flow `master`
 
 ## Merge/pull requests with GitLab flow
 
-![Merge request with inline comments](mr_inline_comments.png)
+![Merge request with inline comments](img/mr_inline_comments.png)
 
 Merge or pull requests are created in a Git management application. They ask an assigned person to merge two branches.
 Tools such as GitHub and Bitbucket choose the name "pull request" since the first manual action is to pull the feature branch.
@@ -147,11 +148,11 @@ It also ensures that if someone reopens the issue, they can use the same branch
 NOTE: **Note:**
 When you reopen an issue you need to create a new merge request.
 
-![Remove checkbox for branch in merge requests](remove_checkbox.png)
+![Remove checkbox for branch in merge requests](img/remove_checkbox.png)
 
 ## Issue tracking with GitLab flow
 
-![Merge request with the branch name "15-require-a-password-to-change-it" and assignee field shown](merge_request.png)
+![Merge request with the branch name "15-require-a-password-to-change-it" and assignee field shown](img/merge_request.png)
 
 GitLab flow is a way to make the relation between the code and the issue tracker more transparent.
 
@@ -192,7 +193,7 @@ It is possible that one feature branch solves more than one issue.
 
 ## Linking and closing issues from merge requests
 
-![Merge request showing the linked issues that will be closed](close_issue_mr.png)
+![Merge request showing the linked issues that will be closed](img/close_issue_mr.png)
 
 Link to issues by mentioning them in commit messages or the description of a merge request, for example, "Fixes #16" or "Duck typing is preferred. See #12."
 GitLab then creates links to the mentioned issues and creates comments in the issues linking back to the merge request.
@@ -203,7 +204,7 @@ If you have an issue that spans across multiple repositories, create an issue fo
 
 ## Squashing commits with rebase
 
-![Vim screen showing the rebase view](rebase.png)
+![Vim screen showing the rebase view](img/rebase.png)
 
 With Git, you can use an interactive rebase (`rebase -i`) to squash multiple commits into one or reorder them.
 This functionality is useful if you want to replace a couple of small commits with a single commit, or if you want to make the order more logical.
@@ -229,7 +230,7 @@ Git does not allow you to merge the code again otherwise.
 
 ## Reducing merge commits in feature branches
 
-![List of sequential merge commits](merge_commits.png)
+![List of sequential merge commits](img/merge_commits.png)
 
 Having lots of merge commits can make your repository history messy.
 Therefore, you should try to avoid merge commits in feature branches.
@@ -289,7 +290,7 @@ Sharing your work before it's complete also allows for discussion and feedback a
 
 ## How to write a good commit message
 
-![Good and bad commit message](good_commit.png)
+![Good and bad commit message](img/good_commit.png)
 
 A commit message should reflect your intention, not just the contents of the commit.
 It is easy to see the changes in a commit, so the commit message should explain why you made those changes.
@@ -300,7 +301,7 @@ For more information about formatting commit messages, please see this excellent
 
 ## Testing before merging
 
-![Merge requests showing the test states: red, yellow, and green](ci_mr.png)
+![Merge requests showing the test states: red, yellow, and green](img/ci_mr.png)
 
 In old workflows, the continuous integration (CI) server commonly ran tests on the `master` branch only.
 Developers had to ensure their code did not break the `master` branch.
@@ -317,7 +318,7 @@ As said before, if you often have feature branches that last for more than a few
 
 ## Working with feature branches
 
-![Shell output showing git pull output](git_pull.png)
+![Shell output showing git pull output](img/git_pull.png)
 
 When creating a feature branch, always branch from an up-to-date `master`.
 If you know before you start that your work depends on another branch, you can also branch from there.
diff --git a/doc/workflow/ci_mr.png b/doc/workflow/img/ci_mr.png
similarity index 100%
rename from doc/workflow/ci_mr.png
rename to doc/workflow/img/ci_mr.png
diff --git a/doc/workflow/close_issue_mr.png b/doc/workflow/img/close_issue_mr.png
similarity index 100%
rename from doc/workflow/close_issue_mr.png
rename to doc/workflow/img/close_issue_mr.png
diff --git a/doc/workflow/environment_branches.png b/doc/workflow/img/environment_branches.png
similarity index 100%
rename from doc/workflow/environment_branches.png
rename to doc/workflow/img/environment_branches.png
diff --git a/doc/workflow/four_stages.png b/doc/workflow/img/four_stages.png
similarity index 100%
rename from doc/workflow/four_stages.png
rename to doc/workflow/img/four_stages.png
diff --git a/doc/workflow/git_pull.png b/doc/workflow/img/git_pull.png
similarity index 100%
rename from doc/workflow/git_pull.png
rename to doc/workflow/img/git_pull.png
diff --git a/doc/workflow/gitdashflow.png b/doc/workflow/img/gitdashflow.png
similarity index 100%
rename from doc/workflow/gitdashflow.png
rename to doc/workflow/img/gitdashflow.png
diff --git a/doc/workflow/github_flow.png b/doc/workflow/img/github_flow.png
similarity index 100%
rename from doc/workflow/github_flow.png
rename to doc/workflow/img/github_flow.png
diff --git a/doc/workflow/gitlab_flow.png b/doc/workflow/img/gitlab_flow.png
similarity index 100%
rename from doc/workflow/gitlab_flow.png
rename to doc/workflow/img/gitlab_flow.png
diff --git a/doc/workflow/good_commit.png b/doc/workflow/img/good_commit.png
similarity index 100%
rename from doc/workflow/good_commit.png
rename to doc/workflow/img/good_commit.png
diff --git a/doc/workflow/merge_commits.png b/doc/workflow/img/merge_commits.png
similarity index 100%
rename from doc/workflow/merge_commits.png
rename to doc/workflow/img/merge_commits.png
diff --git a/doc/workflow/merge_request.png b/doc/workflow/img/merge_request.png
similarity index 100%
rename from doc/workflow/merge_request.png
rename to doc/workflow/img/merge_request.png
diff --git a/doc/workflow/messy_flow.png b/doc/workflow/img/messy_flow.png
similarity index 100%
rename from doc/workflow/messy_flow.png
rename to doc/workflow/img/messy_flow.png
diff --git a/doc/workflow/mr_inline_comments.png b/doc/workflow/img/mr_inline_comments.png
similarity index 100%
rename from doc/workflow/mr_inline_comments.png
rename to doc/workflow/img/mr_inline_comments.png
diff --git a/doc/workflow/production_branch.png b/doc/workflow/img/production_branch.png
similarity index 100%
rename from doc/workflow/production_branch.png
rename to doc/workflow/img/production_branch.png
diff --git a/doc/workflow/rebase.png b/doc/workflow/img/rebase.png
similarity index 100%
rename from doc/workflow/rebase.png
rename to doc/workflow/img/rebase.png
diff --git a/doc/workflow/release_branches.png b/doc/workflow/img/release_branches.png
similarity index 100%
rename from doc/workflow/release_branches.png
rename to doc/workflow/img/release_branches.png
diff --git a/doc/workflow/remove_checkbox.png b/doc/workflow/img/remove_checkbox.png
similarity index 100%
rename from doc/workflow/remove_checkbox.png
rename to doc/workflow/img/remove_checkbox.png

From 0fd2a53061baf4af112a38f4993f115d8a17bb59 Mon Sep 17 00:00:00 2001
From: Lukas Eipert <leipert@gitlab.com>
Date: Fri, 5 Jul 2019 08:31:57 +0000
Subject: [PATCH 089/195] Update dependency @gitlab/ui to ^5.3.2

---
 package.json | 2 +-
 yarn.lock    | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/package.json b/package.json
index e645eb8ed1c..47e7dd9c9c9 100644
--- a/package.json
+++ b/package.json
@@ -38,7 +38,7 @@
     "@babel/preset-env": "^7.4.4",
     "@gitlab/csslab": "^1.9.0",
     "@gitlab/svgs": "^1.66.0",
-    "@gitlab/ui": "^5.1.0",
+    "@gitlab/ui": "^5.3.2",
     "apollo-cache-inmemory": "^1.5.1",
     "apollo-client": "^2.5.1",
     "apollo-link": "^1.2.11",
diff --git a/yarn.lock b/yarn.lock
index 1e04c82df1c..b76eba830b1 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -705,10 +705,10 @@
   resolved "https://registry.yarnpkg.com/@gitlab/svgs/-/svgs-1.66.0.tgz#3c02da455421ea241f32e915671842435df027ff"
   integrity sha512-nxOoQPnofMs3BjRr3SVzQcclM0G6QFrLM8L4nnUCN+8Gxq2u8ukfSU5FCrkivXz+FP9Qo/FYilWV7CY8kDkt6A==
 
-"@gitlab/ui@^5.1.0":
-  version "5.1.0"
-  resolved "https://registry.yarnpkg.com/@gitlab/ui/-/ui-5.1.0.tgz#b8c8f266edc68f616e92c0ba3a18a692002393e4"
-  integrity sha512-IPgk5W7mSXcbni+zNuJeVU89Co72jSQAXTxU7AtmItt5XT6nI9US2ZAWNUl8XCiOOw81jzYv0PLp4bMiXdLkww==
+"@gitlab/ui@^5.3.2":
+  version "5.3.2"
+  resolved "https://registry.yarnpkg.com/@gitlab/ui/-/ui-5.3.2.tgz#8ee906cf0586834de0077e165f25764c0bf8a9e9"
+  integrity sha512-VgxlDXqG2q+u72Km+/Ljdvjh0DzvljvsztiXTxnOO+Eb+/I26JBWfdboqFr3E02JzT8W4s4rRinhRttLWfcM/A==
   dependencies:
     "@babel/standalone" "^7.0.0"
     "@gitlab/vue-toasted" "^1.2.1"

From b71250ca0f1b9df4f728bdb322502e3544058ca5 Mon Sep 17 00:00:00 2001
From: sujay patel <sujaypatel1996@gmail.com>
Date: Thu, 13 Jun 2019 01:33:21 +0530
Subject: [PATCH 090/195] Adding order by to list runner jobs api.

---
 app/finders/runner_jobs_finder.rb             | 22 ++++++++++-
 .../51794-add-ordering-to-runner-jobs-api.yml |  5 +++
 doc/api/runners.md                            |  2 +
 spec/finders/runner_jobs_finder_spec.rb       | 37 +++++++++++++++++++
 4 files changed, 65 insertions(+), 1 deletion(-)
 create mode 100644 changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml

diff --git a/app/finders/runner_jobs_finder.rb b/app/finders/runner_jobs_finder.rb
index 4fca4ec94f3..f1ee1d38255 100644
--- a/app/finders/runner_jobs_finder.rb
+++ b/app/finders/runner_jobs_finder.rb
@@ -3,6 +3,8 @@
 class RunnerJobsFinder
   attr_reader :runner, :params
 
+  ALLOWED_INDEXED_COLUMNS = %w[id created_at].freeze
+
   def initialize(runner, params = {})
     @runner = runner
     @params = params
@@ -11,7 +13,7 @@ class RunnerJobsFinder
   def execute
     items = @runner.builds
     items = by_status(items)
-    items
+    sort_items(items)
   end
 
   private
@@ -23,4 +25,22 @@ class RunnerJobsFinder
     items.where(status: params[:status])
   end
   # rubocop: enable CodeReuse/ActiveRecord
+
+  # rubocop: disable CodeReuse/ActiveRecord
+  def sort_items(items)
+    order_by = if ALLOWED_INDEXED_COLUMNS.include?(params[:order_by])
+                 params[:order_by]
+               else
+                 :id
+               end
+
+    sort = if params[:sort] =~ /\A(ASC|DESC)\z/i
+             params[:sort]
+           else
+             :desc
+           end
+
+    items.order(order_by => sort)
+  end
+  # rubocop: enable CodeReuse/ActiveRecord
 end
diff --git a/changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml b/changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml
new file mode 100644
index 00000000000..6af61d7b145
--- /dev/null
+++ b/changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml
@@ -0,0 +1,5 @@
+---
+title: 51794-add-order-by-to-list-runner-jobs-api
+merge_request:
+author: Sujay Patel
+type: added
diff --git a/doc/api/runners.md b/doc/api/runners.md
index 90e9fbff247..425b9aeef1b 100644
--- a/doc/api/runners.md
+++ b/doc/api/runners.md
@@ -291,6 +291,8 @@ GET /runners/:id/jobs
 |-----------|---------|----------|---------------------|
 | `id`      | integer | yes      | The ID of a runner  |
 | `status`  | string  | no       | Status of the job; one of: `running`, `success`, `failed`, `canceled` |
+| `order_by`| string  | no       | Order jobs by `id` or `created_at` (default: id) |
+| `sort`    | string  | no       | Sort jobs in `asc` or `desc` order (default: `desc`) |
 
 ```
 curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/runners/1/jobs?status=running"
diff --git a/spec/finders/runner_jobs_finder_spec.rb b/spec/finders/runner_jobs_finder_spec.rb
index 97304170c4e..9ed6f50ddfb 100644
--- a/spec/finders/runner_jobs_finder_spec.rb
+++ b/spec/finders/runner_jobs_finder_spec.rb
@@ -35,5 +35,42 @@ describe RunnerJobsFinder do
         end
       end
     end
+
+    context 'when order_by and sort are specified' do
+      context 'when order_by created_at' do
+        let(:params) { { order_by: 'created_at', sort: 'asc' } }
+        let!(:jobs) { Array.new(2) { create(:ci_build, runner: runner, project: project, user: create(:user)) } }
+
+        it 'sorts as created_at: :asc' do
+          is_expected.to match_array(jobs)
+        end
+
+        context 'when sort is invalid' do
+          let(:params) { { order_by: 'created_at', sort: 'invalid_sort' } }
+
+          it 'sorts as created_at: :desc' do
+            is_expected.to eq(jobs.sort_by { |p| -p.user.id })
+          end
+        end
+      end
+
+      context 'when order_by is invalid' do
+        let(:params) { { order_by: 'invalid_column', sort: 'asc' } }
+        let!(:jobs) { Array.new(2) { create(:ci_build, runner: runner, project: project, user: create(:user)) } }
+
+        it 'sorts as id: :asc' do
+          is_expected.to eq(jobs.sort_by { |p| p.id })
+        end
+      end
+
+      context 'when both are nil' do
+        let(:params) { { order_by: nil, sort: nil } }
+        let!(:jobs) { Array.new(2) { create(:ci_build, runner: runner, project: project, user: create(:user)) } }
+
+        it 'sorts as id: :desc' do
+          is_expected.to eq(jobs.sort_by { |p| -p.id })
+        end
+      end
+    end
   end
 end

From 7fd7406d56f93db751d7ec3c69e3a30c1e6df14c Mon Sep 17 00:00:00 2001
From: Sarah Yasonik <syasonik@gitlab.com>
Date: Fri, 5 Jul 2019 08:49:33 +0000
Subject: [PATCH 091/195] Fix alert creation dropdown menu

---
 .../javascripts/monitoring/stores/utils.js    | 17 +++++++--
 .../monitoring/store/utils_spec.js            | 37 +++++++++++++++++++
 2 files changed, 51 insertions(+), 3 deletions(-)
 create mode 100644 spec/javascripts/monitoring/store/utils_spec.js

diff --git a/app/assets/javascripts/monitoring/stores/utils.js b/app/assets/javascripts/monitoring/stores/utils.js
index 84e1f1c4c20..721942f9d3b 100644
--- a/app/assets/javascripts/monitoring/stores/utils.js
+++ b/app/assets/javascripts/monitoring/stores/utils.js
@@ -36,15 +36,26 @@ function removeTimeSeriesNoData(queries) {
 //                                                       { metricId: 2, ...query2Attrs }] },
 //            { title: 'new title', y_label: 'MB', queries: [{ metricId: 3, ...query3Attrs }]}
 //          ]
-function groupQueriesByChartInfo(metrics) {
+export function groupQueriesByChartInfo(metrics) {
   const metricsByChart = metrics.reduce((accumulator, metric) => {
     const { queries, ...chart } = metric;
-    const metricId = chart.id ? chart.id.toString() : null;
 
     const chartKey = `${chart.title}|${chart.y_label}`;
     accumulator[chartKey] = accumulator[chartKey] || { ...chart, queries: [] };
 
-    queries.forEach(queryAttrs => accumulator[chartKey].queries.push({ metricId, ...queryAttrs }));
+    queries.forEach(queryAttrs => {
+      let metricId;
+
+      if (chart.id) {
+        metricId = chart.id.toString();
+      } else if (queryAttrs.metric_id) {
+        metricId = queryAttrs.metric_id.toString();
+      } else {
+        metricId = null;
+      }
+
+      accumulator[chartKey].queries.push({ metricId, ...queryAttrs });
+    });
 
     return accumulator;
   }, {});
diff --git a/spec/javascripts/monitoring/store/utils_spec.js b/spec/javascripts/monitoring/store/utils_spec.js
new file mode 100644
index 00000000000..73dd370ffb3
--- /dev/null
+++ b/spec/javascripts/monitoring/store/utils_spec.js
@@ -0,0 +1,37 @@
+import { groupQueriesByChartInfo } from '~/monitoring/stores/utils';
+
+describe('groupQueriesByChartInfo', () => {
+  let input;
+  let output;
+
+  it('groups metrics with the same chart title and y_axis label', () => {
+    input = [
+      { title: 'title', y_label: 'MB', queries: [{}] },
+      { title: 'title', y_label: 'MB', queries: [{}] },
+      { title: 'new title', y_label: 'MB', queries: [{}] },
+    ];
+
+    output = [
+      { title: 'title', y_label: 'MB', queries: [{ metricId: null }, { metricId: null }] },
+      { title: 'new title', y_label: 'MB', queries: [{ metricId: null }] },
+    ];
+
+    expect(groupQueriesByChartInfo(input)).toEqual(output);
+  });
+
+  // Functionality associated with the /additional_metrics endpoint
+  it("associates a chart's stringified metric_id with the metric", () => {
+    input = [{ id: 3, title: 'new title', y_label: 'MB', queries: [{}] }];
+    output = [{ id: 3, title: 'new title', y_label: 'MB', queries: [{ metricId: '3' }] }];
+
+    expect(groupQueriesByChartInfo(input)).toEqual(output);
+  });
+
+  // Functionality associated with the /metrics_dashboard endpoint
+  it('aliases a stringified metrics_id on the metric to the metricId key', () => {
+    input = [{ title: 'new title', y_label: 'MB', queries: [{ metric_id: 3 }] }];
+    output = [{ title: 'new title', y_label: 'MB', queries: [{ metricId: '3', metric_id: 3 }] }];
+
+    expect(groupQueriesByChartInfo(input)).toEqual(output);
+  });
+});

From 1391ba13b788f7c7c1042c8499019a32299947e5 Mon Sep 17 00:00:00 2001
From: Lucas Charles <me@lucascharles.me>
Date: Fri, 5 Jul 2019 08:50:39 +0000
Subject: [PATCH 092/195] Update SAST.gitlab-ci.yml w/ FAIL_NEVER ENV

https://gitlab.com/gitlab-org/gitlab-ee/issues/10564
---
 lib/gitlab/ci/templates/Security/SAST.gitlab-ci.yml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/lib/gitlab/ci/templates/Security/SAST.gitlab-ci.yml b/lib/gitlab/ci/templates/Security/SAST.gitlab-ci.yml
index 8713b833011..0a97a16b83c 100644
--- a/lib/gitlab/ci/templates/Security/SAST.gitlab-ci.yml
+++ b/lib/gitlab/ci/templates/Security/SAST.gitlab-ci.yml
@@ -54,6 +54,7 @@ sast:
           MAVEN_PATH \
           MAVEN_REPO_PATH \
           SBT_PATH \
+          FAIL_NEVER \
         ) \
         --volume "$PWD:/code" \
         --volume /var/run/docker.sock:/var/run/docker.sock \

From e241c89977c32fabbbe5a49c1ba69564d5e09e31 Mon Sep 17 00:00:00 2001
From: sujay patel <sujaypatel1996@gmail.com>
Date: Thu, 13 Jun 2019 01:33:21 +0530
Subject: [PATCH 093/195] Adding order by to list runner jobs api.

---
 app/finders/runner_jobs_finder.rb             | 11 ++---
 .../51794-add-ordering-to-runner-jobs-api.yml |  4 +-
 doc/api/runners.md                            |  2 +-
 lib/api/runners.rb                            |  2 +
 spec/finders/runner_jobs_finder_spec.rb       | 35 +++++----------
 spec/requests/api/runners_spec.rb             | 44 +++++++++++++++++++
 6 files changed, 63 insertions(+), 35 deletions(-)

diff --git a/app/finders/runner_jobs_finder.rb b/app/finders/runner_jobs_finder.rb
index f1ee1d38255..ef90817416a 100644
--- a/app/finders/runner_jobs_finder.rb
+++ b/app/finders/runner_jobs_finder.rb
@@ -3,7 +3,7 @@
 class RunnerJobsFinder
   attr_reader :runner, :params
 
-  ALLOWED_INDEXED_COLUMNS = %w[id created_at].freeze
+  ALLOWED_INDEXED_COLUMNS = %w[id].freeze
 
   def initialize(runner, params = {})
     @runner = runner
@@ -28,13 +28,10 @@ class RunnerJobsFinder
 
   # rubocop: disable CodeReuse/ActiveRecord
   def sort_items(items)
-    order_by = if ALLOWED_INDEXED_COLUMNS.include?(params[:order_by])
-                 params[:order_by]
-               else
-                 :id
-               end
+    return items unless ALLOWED_INDEXED_COLUMNS.include?(params[:order_by])
 
-    sort = if params[:sort] =~ /\A(ASC|DESC)\z/i
+    order_by = params[:order_by]
+    sort = if /\A(ASC|DESC)\z/i.match?(params[:sort])
              params[:sort]
            else
              :desc
diff --git a/changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml b/changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml
index 6af61d7b145..908a132688c 100644
--- a/changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml
+++ b/changelogs/unreleased/51794-add-ordering-to-runner-jobs-api.yml
@@ -1,5 +1,5 @@
 ---
-title: 51794-add-order-by-to-list-runner-jobs-api
-merge_request:
+title: Add order_by and sort params to list runner jobs api
+merge_request: 29629
 author: Sujay Patel
 type: added
diff --git a/doc/api/runners.md b/doc/api/runners.md
index 425b9aeef1b..1318b9ca828 100644
--- a/doc/api/runners.md
+++ b/doc/api/runners.md
@@ -291,7 +291,7 @@ GET /runners/:id/jobs
 |-----------|---------|----------|---------------------|
 | `id`      | integer | yes      | The ID of a runner  |
 | `status`  | string  | no       | Status of the job; one of: `running`, `success`, `failed`, `canceled` |
-| `order_by`| string  | no       | Order jobs by `id` or `created_at` (default: id) |
+| `order_by`| string  | no       | Order jobs by `id`. |
 | `sort`    | string  | no       | Sort jobs in `asc` or `desc` order (default: `desc`) |
 
 ```
diff --git a/lib/api/runners.rb b/lib/api/runners.rb
index f3fea463e7f..c2d371b6867 100644
--- a/lib/api/runners.rb
+++ b/lib/api/runners.rb
@@ -115,6 +115,8 @@ module API
       params do
         requires :id, type: Integer, desc: 'The ID of the runner'
         optional :status, type: String, desc: 'Status of the job', values: Ci::Build::AVAILABLE_STATUSES
+        optional :order_by, type: String, desc: 'Order by `id` or not', values: RunnerJobsFinder::ALLOWED_INDEXED_COLUMNS
+        optional :sort, type: String, values: %w[asc desc], default: 'desc', desc: 'Sort by asc (ascending) or desc (descending)'
         use :pagination
       end
       get ':id/jobs' do
diff --git a/spec/finders/runner_jobs_finder_spec.rb b/spec/finders/runner_jobs_finder_spec.rb
index 9ed6f50ddfb..01f45a37ba8 100644
--- a/spec/finders/runner_jobs_finder_spec.rb
+++ b/spec/finders/runner_jobs_finder_spec.rb
@@ -37,38 +37,23 @@ describe RunnerJobsFinder do
     end
 
     context 'when order_by and sort are specified' do
-      context 'when order_by created_at' do
-        let(:params) { { order_by: 'created_at', sort: 'asc' } }
-        let!(:jobs) { Array.new(2) { create(:ci_build, runner: runner, project: project, user: create(:user)) } }
-
-        it 'sorts as created_at: :asc' do
-          is_expected.to match_array(jobs)
-        end
-
-        context 'when sort is invalid' do
-          let(:params) { { order_by: 'created_at', sort: 'invalid_sort' } }
-
-          it 'sorts as created_at: :desc' do
-            is_expected.to eq(jobs.sort_by { |p| -p.user.id })
-          end
-        end
-      end
-
-      context 'when order_by is invalid' do
-        let(:params) { { order_by: 'invalid_column', sort: 'asc' } }
-        let!(:jobs) { Array.new(2) { create(:ci_build, runner: runner, project: project, user: create(:user)) } }
+      context 'when order_by id and sort is asc' do
+        let(:params) { { order_by: 'id', sort: 'asc' } }
+        let!(:jobs) { create_list(:ci_build, 2, runner: runner, project: project, user: create(:user)) }
 
         it 'sorts as id: :asc' do
-          is_expected.to eq(jobs.sort_by { |p| p.id })
+          is_expected.to eq(jobs.sort_by(&:id))
         end
       end
+    end
 
-      context 'when both are nil' do
-        let(:params) { { order_by: nil, sort: nil } }
-        let!(:jobs) { Array.new(2) { create(:ci_build, runner: runner, project: project, user: create(:user)) } }
+    context 'when order_by is specified and sort is not specified' do
+      context 'when order_by id and sort is not specified' do
+        let(:params) { { order_by: 'id' } }
+        let!(:jobs) { create_list(:ci_build, 2, runner: runner, project: project, user: create(:user)) }
 
         it 'sorts as id: :desc' do
-          is_expected.to eq(jobs.sort_by { |p| -p.id })
+          is_expected.to eq(jobs.sort_by(&:id).reverse)
         end
       end
     end
diff --git a/spec/requests/api/runners_spec.rb b/spec/requests/api/runners_spec.rb
index 5548e3fd01a..f5ce3a3570e 100644
--- a/spec/requests/api/runners_spec.rb
+++ b/spec/requests/api/runners_spec.rb
@@ -584,6 +584,34 @@ describe API::Runners do
           end
         end
 
+        context 'when valid order_by is provided' do
+          context 'when sort order is not specified' do
+            it 'return jobs in descending order' do
+              get api("/runners/#{project_runner.id}/jobs?order_by=id", admin)
+
+              expect(response).to have_gitlab_http_status(200)
+              expect(response).to include_pagination_headers
+
+              expect(json_response).to be_an(Array)
+              expect(json_response.length).to eq(2)
+              expect(json_response.first).to include('id' => job_5.id)
+            end
+          end
+
+          context 'when sort order is specified as asc' do
+            it 'return jobs sorted in ascending order' do
+              get api("/runners/#{project_runner.id}/jobs?order_by=id&sort=asc", admin)
+
+              expect(response).to have_gitlab_http_status(200)
+              expect(response).to include_pagination_headers
+
+              expect(json_response).to be_an(Array)
+              expect(json_response.length).to eq(2)
+              expect(json_response.first).to include('id' => job_4.id)
+            end
+          end
+        end
+
         context 'when invalid status is provided' do
           it 'return 400' do
             get api("/runners/#{project_runner.id}/jobs?status=non-existing", admin)
@@ -591,6 +619,22 @@ describe API::Runners do
             expect(response).to have_gitlab_http_status(400)
           end
         end
+
+        context 'when invalid order_by is provided' do
+          it 'return 400' do
+            get api("/runners/#{project_runner.id}/jobs?order_by=non-existing", admin)
+
+            expect(response).to have_gitlab_http_status(400)
+          end
+        end
+
+        context 'when invalid sort is provided' do
+          it 'return 400' do
+            get api("/runners/#{project_runner.id}/jobs?sort=non-existing", admin)
+
+            expect(response).to have_gitlab_http_status(400)
+          end
+        end
       end
 
       context "when runner doesn't exist" do

From 8e6dea3a3d11a8bf5c3fb15ce9dade4cd71936e8 Mon Sep 17 00:00:00 2001
From: Filipa Lacerda <filipa@gitlab.com>
Date: Fri, 5 Jul 2019 11:14:46 +0100
Subject: [PATCH 094/195] Removes EE differences

---
 app/views/profiles/preferences/show.html.haml | 12 ++++++------
 changelogs/unreleased/12553-preferences.yml   |  5 +++++
 2 files changed, 11 insertions(+), 6 deletions(-)
 create mode 100644 changelogs/unreleased/12553-preferences.yml

diff --git a/app/views/profiles/preferences/show.html.haml b/app/views/profiles/preferences/show.html.haml
index 4ebfaff0860..d16e2dddbe0 100644
--- a/app/views/profiles/preferences/show.html.haml
+++ b/app/views/profiles/preferences/show.html.haml
@@ -92,21 +92,21 @@
     .col-lg-8
       .form-group
         %h5= s_('Preferences|Time format')
-        .checkbox-icon-inline-wrapper.form-check
+        .checkbox-icon-inline-wrapper
           - time_format_label = capture do
             = s_('Preferences|Display time in 24-hour format')
-          = f.check_box :time_format_in_24h, class: 'form-check-input'
+          = f.check_box :time_format_in_24h
           = f.label :time_format_in_24h do
             = time_format_label
         %h5= s_('Preferences|Time display')
-        .checkbox-icon-inline-wrapper.form-check
+        .checkbox-icon-inline-wrapper
           - time_display_label = capture do
             = s_('Preferences|Use relative times')
-          = f.check_box :time_display_relative, class: 'form-check-input'
+          = f.check_box :time_display_relative
           = f.label :time_display_relative do
             = time_display_label
-            .text-muted
-              = s_('Preferences|For example: 30 mins ago.')
+          .form-text.text-muted
+            = s_('Preferences|For example: 30 mins ago.')
   .col-lg-4.profile-settings-sidebar
   .col-lg-8
     .form-group
diff --git a/changelogs/unreleased/12553-preferences.yml b/changelogs/unreleased/12553-preferences.yml
new file mode 100644
index 00000000000..c41a8c98e4e
--- /dev/null
+++ b/changelogs/unreleased/12553-preferences.yml
@@ -0,0 +1,5 @@
+---
+title: Removes EE diff for app/views/profiles/preferences/show.html.haml
+merge_request:
+author:
+type: other

From 48307fac1ec7cd207fbd53762fd1226a9d6fb1a2 Mon Sep 17 00:00:00 2001
From: Shinya Maeda <shinya@gitlab.com>
Date: Thu, 20 Jun 2019 19:45:46 +0700
Subject: [PATCH 095/195] Extend MergeToRefService for creating merge ref from
 the other ref

Currently, MergeToRefService is specifically designed for
createing merge commits from source branch and target branch of
merge reqeusts. We extend this behavior to source branch and any
target ref paths.
---
 Gemfile                                       |  2 +-
 Gemfile.lock                                  |  4 +-
 app/models/repository.rb                      |  4 +-
 .../merge_requests/merge_to_ref_service.rb    | 16 +++++-
 .../unreleased/create-merge-train-ref-ce.yml  |  5 ++
 lib/gitlab/git/repository.rb                  |  4 +-
 lib/gitlab/gitaly_client/operation_service.rb |  5 +-
 spec/lib/gitlab/git/repository_spec.rb        |  7 ++-
 .../gitaly_client/operation_service_spec.rb   |  4 +-
 spec/models/repository_spec.rb                |  5 +-
 .../merge_to_ref_service_spec.rb              | 55 ++++++++++++++++---
 11 files changed, 85 insertions(+), 26 deletions(-)
 create mode 100644 changelogs/unreleased/create-merge-train-ref-ce.yml

diff --git a/Gemfile b/Gemfile
index 1264d75eac6..b1750afec91 100644
--- a/Gemfile
+++ b/Gemfile
@@ -429,7 +429,7 @@ group :ed25519 do
 end
 
 # Gitaly GRPC client
-gem 'gitaly-proto', '~> 1.32.0', require: 'gitaly'
+gem 'gitaly-proto', '~> 1.36.0', require: 'gitaly'
 
 gem 'grpc', '~> 1.19.0'
 
diff --git a/Gemfile.lock b/Gemfile.lock
index 5b648d43137..5099167e03f 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -303,7 +303,7 @@ GEM
       gettext_i18n_rails (>= 0.7.1)
       po_to_json (>= 1.0.0)
       rails (>= 3.2.0)
-    gitaly-proto (1.32.0)
+    gitaly-proto (1.36.0)
       grpc (~> 1.0)
     github-markup (1.7.0)
     gitlab-labkit (0.3.0)
@@ -1092,7 +1092,7 @@ DEPENDENCIES
   gettext (~> 3.2.2)
   gettext_i18n_rails (~> 1.8.0)
   gettext_i18n_rails_js (~> 1.3)
-  gitaly-proto (~> 1.32.0)
+  gitaly-proto (~> 1.36.0)
   github-markup (~> 1.7.0)
   gitlab-labkit (~> 0.3.0)
   gitlab-markup (~> 1.7.0)
diff --git a/app/models/repository.rb b/app/models/repository.rb
index d087a5a7bbd..a408db7ebbe 100644
--- a/app/models/repository.rb
+++ b/app/models/repository.rb
@@ -839,10 +839,10 @@ class Repository
     end
   end
 
-  def merge_to_ref(user, source_sha, merge_request, target_ref, message)
+  def merge_to_ref(user, source_sha, merge_request, target_ref, message, first_parent_ref)
     branch = merge_request.target_branch
 
-    raw.merge_to_ref(user, source_sha, branch, target_ref, message)
+    raw.merge_to_ref(user, source_sha, branch, target_ref, message, first_parent_ref)
   end
 
   def ff_merge(user, source, target_branch, merge_request: nil)
diff --git a/app/services/merge_requests/merge_to_ref_service.rb b/app/services/merge_requests/merge_to_ref_service.rb
index efe4dcd6255..0ea50a5dbf5 100644
--- a/app/services/merge_requests/merge_to_ref_service.rb
+++ b/app/services/merge_requests/merge_to_ref_service.rb
@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module MergeRequests
-  # Performs the merge between source SHA and the target branch. Instead
+  # Performs the merge between source SHA and the target branch or the specified first parent ref. Instead
   # of writing the result to the MR target branch, it targets the `target_ref`.
   #
   # Ideally this should leave the `target_ref` state with the same state the
@@ -56,12 +56,22 @@ module MergeRequests
       raise_error(error) if error
     end
 
+    ##
+    # The parameter `target_ref` is where the merge result will be written.
+    # Default is the merge ref i.e. `refs/merge-requests/:iid/merge`.
     def target_ref
-      merge_request.merge_ref_path
+      params[:target_ref] || merge_request.merge_ref_path
+    end
+
+    ##
+    # The parameter `first_parent_ref` is the main line of the merge commit.
+    # Default is the target branch ref of the merge request.
+    def first_parent_ref
+      params[:first_parent_ref] || merge_request.target_branch_ref
     end
 
     def commit
-      repository.merge_to_ref(current_user, source, merge_request, target_ref, commit_message)
+      repository.merge_to_ref(current_user, source, merge_request, target_ref, commit_message, first_parent_ref)
     rescue Gitlab::Git::PreReceiveError => error
       raise MergeError, error.message
     end
diff --git a/changelogs/unreleased/create-merge-train-ref-ce.yml b/changelogs/unreleased/create-merge-train-ref-ce.yml
new file mode 100644
index 00000000000..b0b95275f58
--- /dev/null
+++ b/changelogs/unreleased/create-merge-train-ref-ce.yml
@@ -0,0 +1,5 @@
+---
+title: Extend `MergeToRefService` to create merge ref from an arbitrary ref
+merge_request: 30361
+author:
+type: added
diff --git a/lib/gitlab/git/repository.rb b/lib/gitlab/git/repository.rb
index 19b6aab1c4f..060a29be782 100644
--- a/lib/gitlab/git/repository.rb
+++ b/lib/gitlab/git/repository.rb
@@ -536,9 +536,9 @@ module Gitlab
         tags.find { |tag| tag.name == name }
       end
 
-      def merge_to_ref(user, source_sha, branch, target_ref, message)
+      def merge_to_ref(user, source_sha, branch, target_ref, message, first_parent_ref)
         wrapped_gitaly_errors do
-          gitaly_operation_client.user_merge_to_ref(user, source_sha, branch, target_ref, message)
+          gitaly_operation_client.user_merge_to_ref(user, source_sha, branch, target_ref, message, first_parent_ref)
         end
       end
 
diff --git a/lib/gitlab/gitaly_client/operation_service.rb b/lib/gitlab/gitaly_client/operation_service.rb
index b42e6cbad8d..783c2ff0915 100644
--- a/lib/gitlab/gitaly_client/operation_service.rb
+++ b/lib/gitlab/gitaly_client/operation_service.rb
@@ -100,14 +100,15 @@ module Gitlab
         end
       end
 
-      def user_merge_to_ref(user, source_sha, branch, target_ref, message)
+      def user_merge_to_ref(user, source_sha, branch, target_ref, message, first_parent_ref)
         request = Gitaly::UserMergeToRefRequest.new(
           repository: @gitaly_repo,
           source_sha: source_sha,
           branch: encode_binary(branch),
           target_ref: encode_binary(target_ref),
           user: Gitlab::Git::User.from_gitlab(user).to_gitaly,
-          message: encode_binary(message)
+          message: encode_binary(message),
+          first_parent_ref: encode_binary(first_parent_ref)
         )
 
         response = GitalyClient.call(@repository.storage, :operation_service, :user_merge_to_ref, request)
diff --git a/spec/lib/gitlab/git/repository_spec.rb b/spec/lib/gitlab/git/repository_spec.rb
index cceeae8afe6..a28b95e5bff 100644
--- a/spec/lib/gitlab/git/repository_spec.rb
+++ b/spec/lib/gitlab/git/repository_spec.rb
@@ -1694,14 +1694,15 @@ describe Gitlab::Git::Repository, :seed_helper do
     let(:branch_head) { '6d394385cf567f80a8fd85055db1ab4c5295806f' }
     let(:left_sha) { 'cfe32cf61b73a0d5e9f13e774abde7ff789b1660' }
     let(:right_branch) { 'test-master' }
+    let(:first_parent_ref) { 'refs/heads/test-master' }
     let(:target_ref) { 'refs/merge-requests/999/merge' }
 
     before do
-      repository.create_branch(right_branch, branch_head) unless repository.branch_exists?(right_branch)
+      repository.create_branch(right_branch, branch_head) unless repository.ref_exists?(first_parent_ref)
     end
 
     def merge_to_ref
-      repository.merge_to_ref(user, left_sha, right_branch, target_ref, 'Merge message')
+      repository.merge_to_ref(user, left_sha, right_branch, target_ref, 'Merge message', first_parent_ref)
     end
 
     it 'generates a commit in the target_ref' do
@@ -1716,7 +1717,7 @@ describe Gitlab::Git::Repository, :seed_helper do
     end
 
     it 'does not change the right branch HEAD' do
-      expect { merge_to_ref }.not_to change { repository.find_branch(right_branch).target }
+      expect { merge_to_ref }.not_to change { repository.commit(first_parent_ref).sha }
     end
   end
 
diff --git a/spec/lib/gitlab/gitaly_client/operation_service_spec.rb b/spec/lib/gitlab/gitaly_client/operation_service_spec.rb
index 18663a72fcd..f38b8d31237 100644
--- a/spec/lib/gitlab/gitaly_client/operation_service_spec.rb
+++ b/spec/lib/gitlab/gitaly_client/operation_service_spec.rb
@@ -79,13 +79,13 @@ describe Gitlab::GitalyClient::OperationService do
     end
 
     describe '#user_merge_to_ref' do
-      let(:branch) { 'my-branch' }
+      let(:first_parent_ref) { 'refs/heads/my-branch' }
       let(:source_sha) { 'cfe32cf61b73a0d5e9f13e774abde7ff789b1660' }
       let(:ref) { 'refs/merge-requests/x/merge' }
       let(:message) { 'validación' }
       let(:response) { Gitaly::UserMergeToRefResponse.new(commit_id: 'new-commit-id') }
 
-      subject { client.user_merge_to_ref(user, source_sha, branch, ref, message) }
+      subject { client.user_merge_to_ref(user, source_sha, nil, ref, message, first_parent_ref) }
 
       it 'sends a user_merge_to_ref message' do
         expect_any_instance_of(Gitaly::OperationService::Stub)
diff --git a/spec/models/repository_spec.rb b/spec/models/repository_spec.rb
index 13da7bd7407..3d967aa4ab8 100644
--- a/spec/models/repository_spec.rb
+++ b/spec/models/repository_spec.rb
@@ -1420,12 +1420,13 @@ describe Repository do
                              source_project: project)
     end
 
-    it 'writes merge of source and target to MR merge_ref_path' do
+    it 'writes merge of source SHA and first parent ref to MR merge_ref_path' do
       merge_commit_id = repository.merge_to_ref(user,
                                                 merge_request.diff_head_sha,
                                                 merge_request,
                                                 merge_request.merge_ref_path,
-                                                'Custom message')
+                                                'Custom message',
+                                                merge_request.target_branch_ref)
 
       merge_commit = repository.commit(merge_commit_id)
 
diff --git a/spec/services/merge_requests/merge_to_ref_service_spec.rb b/spec/services/merge_requests/merge_to_ref_service_spec.rb
index 61f99f82a76..e2f201677fa 100644
--- a/spec/services/merge_requests/merge_to_ref_service_spec.rb
+++ b/spec/services/merge_requests/merge_to_ref_service_spec.rb
@@ -22,7 +22,6 @@ describe MergeRequests::MergeToRefService do
   shared_examples_for 'successfully merges to ref with merge method' do
     it 'writes commit to merge ref' do
       repository = project.repository
-      target_ref = merge_request.merge_ref_path
 
       expect(repository.ref_exists?(target_ref)).to be(false)
 
@@ -33,7 +32,7 @@ describe MergeRequests::MergeToRefService do
       expect(result[:status]).to eq(:success)
       expect(result[:commit_id]).to be_present
       expect(result[:source_id]).to eq(merge_request.source_branch_sha)
-      expect(result[:target_id]).to eq(merge_request.target_branch_sha)
+      expect(result[:target_id]).to eq(repository.commit(first_parent_ref).sha)
       expect(repository.ref_exists?(target_ref)).to be(true)
       expect(ref_head.id).to eq(result[:commit_id])
     end
@@ -74,17 +73,22 @@ describe MergeRequests::MergeToRefService do
 
   describe '#execute' do
     let(:service) do
-      described_class.new(project, user, commit_message: 'Awesome message',
-                                         should_remove_source_branch: true)
+      described_class.new(project, user, **params)
     end
 
+    let(:params) { { commit_message: 'Awesome message', should_remove_source_branch: true } }
+
     def process_merge_to_ref
       perform_enqueued_jobs do
         service.execute(merge_request)
       end
     end
 
-    it_behaves_like 'successfully merges to ref with merge method'
+    it_behaves_like 'successfully merges to ref with merge method' do
+      let(:first_parent_ref) { 'refs/heads/master' }
+      let(:target_ref) { merge_request.merge_ref_path }
+    end
+
     it_behaves_like 'successfully evaluates pre-condition checks'
 
     context 'commit history comparison with regular MergeService' do
@@ -129,14 +133,22 @@ describe MergeRequests::MergeToRefService do
       context 'when semi-linear merge method' do
         let(:merge_method) { :rebase_merge }
 
-        it_behaves_like 'successfully merges to ref with merge method'
+        it_behaves_like 'successfully merges to ref with merge method' do
+          let(:first_parent_ref) { 'refs/heads/master' }
+          let(:target_ref) { merge_request.merge_ref_path }
+        end
+
         it_behaves_like 'successfully evaluates pre-condition checks'
       end
 
       context 'when fast-forward merge method' do
         let(:merge_method) { :ff }
 
-        it_behaves_like 'successfully merges to ref with merge method'
+        it_behaves_like 'successfully merges to ref with merge method' do
+          let(:first_parent_ref) { 'refs/heads/master' }
+          let(:target_ref) { merge_request.merge_ref_path }
+        end
+
         it_behaves_like 'successfully evaluates pre-condition checks'
       end
 
@@ -178,5 +190,34 @@ describe MergeRequests::MergeToRefService do
 
       it { expect(todo).not_to be_done }
     end
+
+    describe 'cascading merge refs' do
+      set(:project) { create(:project, :repository) }
+      let(:params) { { commit_message: 'Cascading merge', first_parent_ref: first_parent_ref, target_ref: target_ref } }
+
+      context 'when first merge happens' do
+        let(:merge_request) do
+          create(:merge_request, source_project: project, source_branch: 'feature',
+                                 target_project: project, target_branch: 'master')
+        end
+
+        it_behaves_like 'successfully merges to ref with merge method' do
+          let(:first_parent_ref) { 'refs/heads/master' }
+          let(:target_ref) { 'refs/merge-requests/1/train' }
+        end
+
+        context 'when second merge happens' do
+          let(:merge_request) do
+            create(:merge_request, source_project: project, source_branch: 'improve/awesome',
+                                   target_project: project, target_branch: 'master')
+          end
+
+          it_behaves_like 'successfully merges to ref with merge method' do
+            let(:first_parent_ref) { 'refs/merge-requests/1/train' }
+            let(:target_ref) { 'refs/merge-requests/2/train' }
+          end
+        end
+      end
+    end
   end
 end

From 4c954a5c9e54e768aaca0eb787d8d9d2f63ebcae Mon Sep 17 00:00:00 2001
From: Denys Mishunov <dmishunov@gitlab.com>
Date: Wed, 3 Jul 2019 10:19:32 +0200
Subject: [PATCH 096/195] Mark images as binary on init

---
 app/assets/javascripts/ide/lib/files.js                      | 5 +++--
 .../vue_shared/components/content_viewer/lib/viewer_utils.js | 1 +
 spec/frontend/ide/lib/files_spec.js                          | 4 +++-
 3 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/app/assets/javascripts/ide/lib/files.js b/app/assets/javascripts/ide/lib/files.js
index b8abaa41f23..51278640b5b 100644
--- a/app/assets/javascripts/ide/lib/files.js
+++ b/app/assets/javascripts/ide/lib/files.js
@@ -77,6 +77,7 @@ export const decorateFiles = ({
     const fileFolder = parent && insertParent(parent);
 
     if (name) {
+      const previewMode = viewerInformationForPath(name);
       parentPath = fileFolder && fileFolder.path;
 
       file = decorateData({
@@ -92,9 +93,9 @@ export const decorateFiles = ({
         changed: tempFile,
         content,
         base64,
-        binary,
+        binary: (previewMode && previewMode.binary) || binary,
         rawPath,
-        previewMode: viewerInformationForPath(name),
+        previewMode,
         parentPath,
       });
 
diff --git a/app/assets/javascripts/vue_shared/components/content_viewer/lib/viewer_utils.js b/app/assets/javascripts/vue_shared/components/content_viewer/lib/viewer_utils.js
index ba63683f5c0..da0b45110e2 100644
--- a/app/assets/javascripts/vue_shared/components/content_viewer/lib/viewer_utils.js
+++ b/app/assets/javascripts/vue_shared/components/content_viewer/lib/viewer_utils.js
@@ -3,6 +3,7 @@ import { __ } from '~/locale';
 const viewers = {
   image: {
     id: 'image',
+    binary: true,
   },
   markdown: {
     id: 'markdown',
diff --git a/spec/frontend/ide/lib/files_spec.js b/spec/frontend/ide/lib/files_spec.js
index aa1fa0373db..08a31318544 100644
--- a/spec/frontend/ide/lib/files_spec.js
+++ b/spec/frontend/ide/lib/files_spec.js
@@ -12,6 +12,7 @@ const createEntries = paths => {
 
     const { name, parent } = splitParent(path);
     const parentEntry = acc[parent];
+    const previewMode = viewerInformationForPath(name);
 
     acc[path] = {
       ...decorateData({
@@ -22,7 +23,8 @@ const createEntries = paths => {
         path,
         url: createUrl(`/${TEST_PROJECT_ID}/${type}/${TEST_BRANCH_ID}/-/${escapeFileUrl(path)}`),
         type,
-        previewMode: viewerInformationForPath(path),
+        previewMode,
+        binary: (previewMode && previewMode.binary) || false,
         parentPath: parent,
         parentTreeUrl: parentEntry
           ? parentEntry.url

From fad92a2ecd943e52323e9e978df84ba963057a6e Mon Sep 17 00:00:00 2001
From: Phil Hughes <me@iamphill.com>
Date: Fri, 5 Jul 2019 11:50:07 +0100
Subject: [PATCH 097/195] Fix divergence graph loading error

Closes https://gitlab.com/gitlab-org/gitlab-ce/issues/64143
---
 app/assets/javascripts/branches/divergence_graph.js |  4 +++-
 spec/frontend/branches/divergence_graph_spec.js     | 12 ++++++++++--
 2 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/app/assets/javascripts/branches/divergence_graph.js b/app/assets/javascripts/branches/divergence_graph.js
index 96bc6a5f8e8..7dbaf984acf 100644
--- a/app/assets/javascripts/branches/divergence_graph.js
+++ b/app/assets/javascripts/branches/divergence_graph.js
@@ -36,7 +36,9 @@ export default endpoint => {
       }, 100);
 
       Object.entries(data).forEach(([branchName, val]) => {
-        const el = document.querySelector(`.js-branch-${branchName} .js-branch-divergence-graph`);
+        const el = document.querySelector(
+          `[data-name="${branchName}"] .js-branch-divergence-graph`,
+        );
 
         if (!el) return;
 
diff --git a/spec/frontend/branches/divergence_graph_spec.js b/spec/frontend/branches/divergence_graph_spec.js
index 4ed77c3a036..8283bc966e4 100644
--- a/spec/frontend/branches/divergence_graph_spec.js
+++ b/spec/frontend/branches/divergence_graph_spec.js
@@ -10,12 +10,14 @@ describe('Divergence graph', () => {
 
     mock.onGet('/-/diverging_counts').reply(200, {
       master: { ahead: 1, behind: 1 },
+      'test/hello-world': { ahead: 1, behind: 1 },
     });
 
     jest.spyOn(axios, 'get');
 
     document.body.innerHTML = `
-      <div class="js-branch-item" data-name="master"></div>
+      <div class="js-branch-item" data-name="master"><div class="js-branch-divergence-graph"></div></div>
+      <div class="js-branch-item" data-name="test/hello-world"><div class="js-branch-divergence-graph"></div></div>
     `;
   });
 
@@ -26,7 +28,13 @@ describe('Divergence graph', () => {
   it('calls axos get with list of branch names', () =>
     init('/-/diverging_counts').then(() => {
       expect(axios.get).toHaveBeenCalledWith('/-/diverging_counts', {
-        params: { names: ['master'] },
+        params: { names: ['master', 'test/hello-world'] },
       });
     }));
+
+  it('creates Vue components', () =>
+    init('/-/diverging_counts').then(() => {
+      expect(document.querySelector('[data-name="master"]').innerHTML).not.toEqual('');
+      expect(document.querySelector('[data-name="test/hello-world"]').innerHTML).not.toEqual('');
+    }));
 });

From 6ef6693e3767d480362ce528dd0beff159c895ff Mon Sep 17 00:00:00 2001
From: Patrick Bajao <ebajao@gitlab.com>
Date: Fri, 5 Jul 2019 11:03:47 +0000
Subject: [PATCH 098/195] Refactor PositionTracer to support different types

This is to prepare for supporing image type position tracing
---
 .../update_diff_position_service.rb           |    3 +-
 app/services/system_note_service.rb           |    8 +-
 changelogs/unreleased/57793-fix-line-age.yml  |    5 +
 lib/gitlab/diff/position.rb                   |    4 +
 lib/gitlab/diff/position_tracer.rb            |  192 +-
 .../diff/position_tracer/base_strategy.rb     |   26 +
 .../diff/position_tracer/image_strategy.rb    |   50 +
 .../diff/position_tracer/line_strategy.rb     |  201 ++
 spec/lib/gitlab/diff/position_spec.rb         |   13 +
 .../position_tracer/image_strategy_spec.rb    |  238 ++
 .../position_tracer/line_strategy_spec.rb     | 1805 +++++++++++++++
 spec/lib/gitlab/diff/position_tracer_spec.rb  | 1930 +----------------
 spec/services/system_note_service_spec.rb     |   24 +-
 .../helpers/position_tracer_helpers.rb        |   93 +
 14 files changed, 2533 insertions(+), 2059 deletions(-)
 create mode 100644 changelogs/unreleased/57793-fix-line-age.yml
 create mode 100644 lib/gitlab/diff/position_tracer/base_strategy.rb
 create mode 100644 lib/gitlab/diff/position_tracer/image_strategy.rb
 create mode 100644 lib/gitlab/diff/position_tracer/line_strategy.rb
 create mode 100644 spec/lib/gitlab/diff/position_tracer/image_strategy_spec.rb
 create mode 100644 spec/lib/gitlab/diff/position_tracer/line_strategy_spec.rb
 create mode 100644 spec/support/helpers/position_tracer_helpers.rb

diff --git a/app/services/discussions/update_diff_position_service.rb b/app/services/discussions/update_diff_position_service.rb
index c61437fb2e3..7bdf7711155 100644
--- a/app/services/discussions/update_diff_position_service.rb
+++ b/app/services/discussions/update_diff_position_service.rb
@@ -3,7 +3,8 @@
 module Discussions
   class UpdateDiffPositionService < BaseService
     def execute(discussion)
-      result = tracer.trace(discussion.position)
+      old_position = discussion.position
+      result = tracer.trace(old_position)
       return unless result
 
       position = result[:position]
diff --git a/app/services/system_note_service.rb b/app/services/system_note_service.rb
index 4783417ad6d..1d02d7ed787 100644
--- a/app/services/system_note_service.rb
+++ b/app/services/system_note_service.rb
@@ -268,11 +268,13 @@ module SystemNoteService
     merge_request = discussion.noteable
     diff_refs = change_position.diff_refs
     version_index = merge_request.merge_request_diffs.viewable.count
+    position_on_text = change_position.on_text?
+    text_parts = ["changed this #{position_on_text ? 'line' : 'file'} in"]
 
-    text_parts = ["changed this line in"]
     if version_params = merge_request.version_params_for(diff_refs)
-      line_code = change_position.line_code(project.repository)
-      url = url_helpers.diffs_project_merge_request_path(project, merge_request, version_params.merge(anchor: line_code))
+      repository = project.repository
+      anchor = position_on_text ? change_position.line_code(repository) : change_position.file_hash
+      url = url_helpers.diffs_project_merge_request_path(project, merge_request, version_params.merge(anchor: anchor))
 
       text_parts << "[version #{version_index} of the diff](#{url})"
     else
diff --git a/changelogs/unreleased/57793-fix-line-age.yml b/changelogs/unreleased/57793-fix-line-age.yml
new file mode 100644
index 00000000000..cf4e328e54a
--- /dev/null
+++ b/changelogs/unreleased/57793-fix-line-age.yml
@@ -0,0 +1,5 @@
+---
+title: Support note position tracing on an image
+merge_request: 30158
+author:
+type: fixed
diff --git a/lib/gitlab/diff/position.rb b/lib/gitlab/diff/position.rb
index d349c378e53..dfa80eb4a64 100644
--- a/lib/gitlab/diff/position.rb
+++ b/lib/gitlab/diff/position.rb
@@ -134,6 +134,10 @@ module Gitlab
         @line_code ||= diff_file(repository)&.line_code_for_position(self)
       end
 
+      def file_hash
+        @file_hash ||= Digest::SHA1.hexdigest(file_path)
+      end
+
       def on_image?
         position_type == 'image'
       end
diff --git a/lib/gitlab/diff/position_tracer.rb b/lib/gitlab/diff/position_tracer.rb
index af3df820422..a1c82ce9afc 100644
--- a/lib/gitlab/diff/position_tracer.rb
+++ b/lib/gitlab/diff/position_tracer.rb
@@ -17,187 +17,13 @@ module Gitlab
         @paths = paths
       end
 
-      def trace(ab_position)
+      def trace(old_position)
         return unless old_diff_refs&.complete? && new_diff_refs&.complete?
-        return unless ab_position.diff_refs == old_diff_refs
+        return unless old_position.diff_refs == old_diff_refs
 
-        # Suppose we have an MR with source branch `feature` and target branch `master`.
-        # When the MR was created, the head of `master` was commit A, and the
-        # head of `feature` was commit B, resulting in the original diff A->B.
-        # Since creation, `master` was updated to C.
-        # Now `feature` is being updated to D, and the newly generated MR diff is C->D.
-        # It is possible that C and D are direct descendants of A and B respectively,
-        # but this isn't necessarily the case as rebases and merges come into play.
-        #
-        # Suppose we have a diff note on the original diff A->B. Now that the MR
-        # is updated, we need to find out what line in C->D corresponds to the
-        # line the note was originally created on, so that we can update the diff note's
-        # records and continue to display it in the right place in the diffs.
-        # If we cannot find this line in the new diff, this means the diff note is now
-        # outdated, and we will display that fact to the user.
-        #
-        # In the new diff, the file the diff note was originally created on may
-        # have been renamed, deleted or even created, if the file existed in A and B,
-        # but was removed in C, and restored in D.
-        #
-        # Every diff note stores a Position object that defines a specific location,
-        # identified by paths and line numbers, within a specific diff, identified
-        # by start, head and base commit ids.
-        #
-        # For diff notes for diff A->B, the position looks like this:
-        # Position
-        #   start_sha - ID of commit A
-        #   head_sha - ID of commit B
-        #   base_sha - ID of base commit of A and B
-        #   old_path - path as of A (nil if file was newly created)
-        #   new_path - path as of B (nil if file was deleted)
-        #   old_line - line number as of A (nil if file was newly created)
-        #   new_line - line number as of B (nil if file was deleted)
-        #
-        # We can easily update `start_sha` and `head_sha` to hold the IDs of
-        # commits C and D, and can trivially determine `base_sha` based on those,
-        # but need to find the paths and line numbers as of C and D.
-        #
-        # If the file was unchanged or newly created in A->B, the path as of D can be found
-        # by generating diff B->D ("head to head"), finding the diff file with
-        # `diff_file.old_path == position.new_path`, and taking `diff_file.new_path`.
-        # The path as of C can be found by taking diff C->D, finding the diff file
-        # with that same `new_path` and taking `diff_file.old_path`.
-        # The line number as of D can be found by using the LineMapper on diff B->D
-        # and providing the line number as of B.
-        # The line number as of C can be found by using the LineMapper on diff C->D
-        # and providing the line number as of D.
-        #
-        # If the file was deleted in A->B, the path as of C can be found
-        # by generating diff A->C ("base to base"), finding the diff file with
-        # `diff_file.old_path == position.old_path`, and taking `diff_file.new_path`.
-        # The path as of D can be found by taking diff C->D, finding the diff file
-        # with `old_path` set to that `diff_file.new_path` and taking `diff_file.new_path`.
-        # The line number as of C can be found by using the LineMapper on diff A->C
-        # and providing the line number as of A.
-        # The line number as of D can be found by using the LineMapper on diff C->D
-        # and providing the line number as of C.
+        strategy = old_position.on_text? ? LineStrategy : ImageStrategy
 
-        if ab_position.added?
-          trace_added_line(ab_position)
-        elsif ab_position.removed?
-          trace_removed_line(ab_position)
-        else # unchanged
-          trace_unchanged_line(ab_position)
-        end
-      end
-
-      private
-
-      def trace_added_line(ab_position)
-        b_path = ab_position.new_path
-        b_line = ab_position.new_line
-
-        bd_diff = bd_diffs.diff_file_with_old_path(b_path)
-
-        d_path = bd_diff&.new_path || b_path
-        d_line = LineMapper.new(bd_diff).old_to_new(b_line)
-
-        if d_line
-          cd_diff = cd_diffs.diff_file_with_new_path(d_path)
-
-          c_path = cd_diff&.old_path || d_path
-          c_line = LineMapper.new(cd_diff).new_to_old(d_line)
-
-          if c_line
-            # If the line is still in D but also in C, it has turned from an
-            # added line into an unchanged one.
-            new_position = position(cd_diff, c_line, d_line)
-            if valid_position?(new_position)
-              # If the line is still in the MR, we don't treat this as outdated.
-              { position: new_position, outdated: false }
-            else
-              # If the line is no longer in the MR, we unfortunately cannot show
-              # the current state on the CD diff, so we treat it as outdated.
-              ac_diff = ac_diffs.diff_file_with_new_path(c_path)
-
-              { position: position(ac_diff, nil, c_line), outdated: true }
-            end
-          else
-            # If the line is still in D and not in C, it is still added.
-            { position: position(cd_diff, nil, d_line), outdated: false }
-          end
-        else
-          # If the line is no longer in D, it has been removed from the MR.
-          { position: position(bd_diff, b_line, nil), outdated: true }
-        end
-      end
-
-      def trace_removed_line(ab_position)
-        a_path = ab_position.old_path
-        a_line = ab_position.old_line
-
-        ac_diff = ac_diffs.diff_file_with_old_path(a_path)
-
-        c_path = ac_diff&.new_path || a_path
-        c_line = LineMapper.new(ac_diff).old_to_new(a_line)
-
-        if c_line
-          cd_diff = cd_diffs.diff_file_with_old_path(c_path)
-
-          d_path = cd_diff&.new_path || c_path
-          d_line = LineMapper.new(cd_diff).old_to_new(c_line)
-
-          if d_line
-            # If the line is still in C but also in D, it has turned from a
-            # removed line into an unchanged one.
-            bd_diff = bd_diffs.diff_file_with_new_path(d_path)
-
-            { position: position(bd_diff, nil, d_line), outdated: true }
-          else
-            # If the line is still in C and not in D, it is still removed.
-            { position: position(cd_diff, c_line, nil), outdated: false }
-          end
-        else
-          # If the line is no longer in C, it has been removed outside of the MR.
-          { position: position(ac_diff, a_line, nil), outdated: true }
-        end
-      end
-
-      def trace_unchanged_line(ab_position)
-        a_path = ab_position.old_path
-        a_line = ab_position.old_line
-        b_path = ab_position.new_path
-        b_line = ab_position.new_line
-
-        ac_diff = ac_diffs.diff_file_with_old_path(a_path)
-
-        c_path = ac_diff&.new_path || a_path
-        c_line = LineMapper.new(ac_diff).old_to_new(a_line)
-
-        bd_diff = bd_diffs.diff_file_with_old_path(b_path)
-
-        d_line = LineMapper.new(bd_diff).old_to_new(b_line)
-
-        cd_diff = cd_diffs.diff_file_with_old_path(c_path)
-
-        if c_line && d_line
-          # If the line is still in C and D, it is still unchanged.
-          new_position = position(cd_diff, c_line, d_line)
-          if valid_position?(new_position)
-            # If the line is still in the MR, we don't treat this as outdated.
-            { position: new_position, outdated: false }
-          else
-            # If the line is no longer in the MR, we unfortunately cannot show
-            # the current state on the CD diff or any change on the BD diff,
-            # so we treat it as outdated.
-            { position: nil, outdated: true }
-          end
-        elsif d_line # && !c_line
-          # If the line is still in D but no longer in C, it has turned from
-          # an unchanged line into an added one.
-          # We don't treat this as outdated since the line is still in the MR.
-          { position: position(cd_diff, nil, d_line), outdated: false }
-        else # !d_line && (c_line || !c_line)
-          # If the line is no longer in D, it has turned from an unchanged line
-          # into a removed one.
-          { position: position(bd_diff, b_line, nil), outdated: true }
-        end
+        strategy.new(self).trace(old_position)
       end
 
       def ac_diffs
@@ -216,18 +42,12 @@ module Gitlab
         @cd_diffs ||= compare(new_diff_refs.start_sha, new_diff_refs.head_sha)
       end
 
+      private
+
       def compare(start_sha, head_sha, straight: false)
         compare = CompareService.new(project, head_sha).execute(project, start_sha, straight: straight)
         compare.diffs(paths: paths, expanded: true)
       end
-
-      def position(diff_file, old_line, new_line)
-        Position.new(diff_file: diff_file, old_line: old_line, new_line: new_line)
-      end
-
-      def valid_position?(position)
-        !!position.diff_line(project.repository)
-      end
     end
   end
 end
diff --git a/lib/gitlab/diff/position_tracer/base_strategy.rb b/lib/gitlab/diff/position_tracer/base_strategy.rb
new file mode 100644
index 00000000000..65049daabf4
--- /dev/null
+++ b/lib/gitlab/diff/position_tracer/base_strategy.rb
@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Gitlab
+  module Diff
+    class PositionTracer
+      class BaseStrategy
+        attr_reader :tracer
+
+        delegate \
+          :project,
+          :ac_diffs,
+          :bd_diffs,
+          :cd_diffs,
+          to: :tracer
+
+        def initialize(tracer)
+          @tracer = tracer
+        end
+
+        def trace(position)
+          raise NotImplementedError
+        end
+      end
+    end
+  end
+end
diff --git a/lib/gitlab/diff/position_tracer/image_strategy.rb b/lib/gitlab/diff/position_tracer/image_strategy.rb
new file mode 100644
index 00000000000..79244a17951
--- /dev/null
+++ b/lib/gitlab/diff/position_tracer/image_strategy.rb
@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module Gitlab
+  module Diff
+    class PositionTracer
+      class ImageStrategy < BaseStrategy
+        def trace(position)
+          b_path = position.new_path
+
+          # If file exists in B->D (e.g. updated, renamed, removed), let the
+          # note become outdated.
+          bd_diff = bd_diffs.diff_file_with_old_path(b_path)
+
+          return { position: new_position(position, bd_diff), outdated: true } if bd_diff
+
+          # If file still exists in the new diff, update the position.
+          cd_diff = cd_diffs.diff_file_with_new_path(bd_diff&.new_path || b_path)
+
+          return { position: new_position(position, cd_diff), outdated: false } if cd_diff
+
+          # If file exists in A->C (e.g. rebased and same changes were present
+          # in target branch), let the note become outdated.
+          ac_diff = ac_diffs.diff_file_with_old_path(position.old_path)
+
+          return { position: new_position(position, ac_diff), outdated: true } if ac_diff
+
+          # If ever there's a case that the file no longer exists in any diff,
+          # don't set a change position and let the note become outdated.
+          #
+          # This should never happen given the file should exist in one of the
+          # diffs above.
+          { outdated: true }
+        end
+
+        private
+
+        def new_position(position, diff_file)
+          Position.new(
+            diff_file: diff_file,
+            x: position.x,
+            y: position.y,
+            width: position.width,
+            height: position.height,
+            position_type: position.position_type
+          )
+        end
+      end
+    end
+  end
+end
diff --git a/lib/gitlab/diff/position_tracer/line_strategy.rb b/lib/gitlab/diff/position_tracer/line_strategy.rb
new file mode 100644
index 00000000000..8db0fc6f963
--- /dev/null
+++ b/lib/gitlab/diff/position_tracer/line_strategy.rb
@@ -0,0 +1,201 @@
+# frozen_string_literal: true
+
+module Gitlab
+  module Diff
+    class PositionTracer
+      class LineStrategy < BaseStrategy
+        def trace(position)
+          # Suppose we have an MR with source branch `feature` and target branch `master`.
+          # When the MR was created, the head of `master` was commit A, and the
+          # head of `feature` was commit B, resulting in the original diff A->B.
+          # Since creation, `master` was updated to C.
+          # Now `feature` is being updated to D, and the newly generated MR diff is C->D.
+          # It is possible that C and D are direct descendants of A and B respectively,
+          # but this isn't necessarily the case as rebases and merges come into play.
+          #
+          # Suppose we have a diff note on the original diff A->B. Now that the MR
+          # is updated, we need to find out what line in C->D corresponds to the
+          # line the note was originally created on, so that we can update the diff note's
+          # records and continue to display it in the right place in the diffs.
+          # If we cannot find this line in the new diff, this means the diff note is now
+          # outdated, and we will display that fact to the user.
+          #
+          # In the new diff, the file the diff note was originally created on may
+          # have been renamed, deleted or even created, if the file existed in A and B,
+          # but was removed in C, and restored in D.
+          #
+          # Every diff note stores a Position object that defines a specific location,
+          # identified by paths and line numbers, within a specific diff, identified
+          # by start, head and base commit ids.
+          #
+          # For diff notes for diff A->B, the position looks like this:
+          # Position
+          #   start_sha - ID of commit A
+          #   head_sha - ID of commit B
+          #   base_sha - ID of base commit of A and B
+          #   old_path - path as of A (nil if file was newly created)
+          #   new_path - path as of B (nil if file was deleted)
+          #   old_line - line number as of A (nil if file was newly created)
+          #   new_line - line number as of B (nil if file was deleted)
+          #
+          # We can easily update `start_sha` and `head_sha` to hold the IDs of
+          # commits C and D, and can trivially determine `base_sha` based on those,
+          # but need to find the paths and line numbers as of C and D.
+          #
+          # If the file was unchanged or newly created in A->B, the path as of D can be found
+          # by generating diff B->D ("head to head"), finding the diff file with
+          # `diff_file.old_path == position.new_path`, and taking `diff_file.new_path`.
+          # The path as of C can be found by taking diff C->D, finding the diff file
+          # with that same `new_path` and taking `diff_file.old_path`.
+          # The line number as of D can be found by using the LineMapper on diff B->D
+          # and providing the line number as of B.
+          # The line number as of C can be found by using the LineMapper on diff C->D
+          # and providing the line number as of D.
+          #
+          # If the file was deleted in A->B, the path as of C can be found
+          # by generating diff A->C ("base to base"), finding the diff file with
+          # `diff_file.old_path == position.old_path`, and taking `diff_file.new_path`.
+          # The path as of D can be found by taking diff C->D, finding the diff file
+          # with `old_path` set to that `diff_file.new_path` and taking `diff_file.new_path`.
+          # The line number as of C can be found by using the LineMapper on diff A->C
+          # and providing the line number as of A.
+          # The line number as of D can be found by using the LineMapper on diff C->D
+          # and providing the line number as of C.
+
+          if position.added?
+            trace_added_line(position)
+          elsif position.removed?
+            trace_removed_line(position)
+          else # unchanged
+            trace_unchanged_line(position)
+          end
+        end
+
+        private
+
+        def trace_added_line(position)
+          b_path = position.new_path
+          b_line = position.new_line
+
+          bd_diff = bd_diffs.diff_file_with_old_path(b_path)
+
+          d_path = bd_diff&.new_path || b_path
+          d_line = LineMapper.new(bd_diff).old_to_new(b_line)
+
+          if d_line
+            cd_diff = cd_diffs.diff_file_with_new_path(d_path)
+
+            c_path = cd_diff&.old_path || d_path
+            c_line = LineMapper.new(cd_diff).new_to_old(d_line)
+
+            if c_line
+              # If the line is still in D but also in C, it has turned from an
+              # added line into an unchanged one.
+              new_position = new_position(cd_diff, c_line, d_line)
+              if valid_position?(new_position)
+                # If the line is still in the MR, we don't treat this as outdated.
+                { position: new_position, outdated: false }
+              else
+                # If the line is no longer in the MR, we unfortunately cannot show
+                # the current state on the CD diff, so we treat it as outdated.
+                ac_diff = ac_diffs.diff_file_with_new_path(c_path)
+
+                { position: new_position(ac_diff, nil, c_line), outdated: true }
+              end
+            else
+              # If the line is still in D and not in C, it is still added.
+              { position: new_position(cd_diff, nil, d_line), outdated: false }
+            end
+          else
+            # If the line is no longer in D, it has been removed from the MR.
+            { position: new_position(bd_diff, b_line, nil), outdated: true }
+          end
+        end
+
+        def trace_removed_line(position)
+          a_path = position.old_path
+          a_line = position.old_line
+
+          ac_diff = ac_diffs.diff_file_with_old_path(a_path)
+
+          c_path = ac_diff&.new_path || a_path
+          c_line = LineMapper.new(ac_diff).old_to_new(a_line)
+
+          if c_line
+            cd_diff = cd_diffs.diff_file_with_old_path(c_path)
+
+            d_path = cd_diff&.new_path || c_path
+            d_line = LineMapper.new(cd_diff).old_to_new(c_line)
+
+            if d_line
+              # If the line is still in C but also in D, it has turned from a
+              # removed line into an unchanged one.
+              bd_diff = bd_diffs.diff_file_with_new_path(d_path)
+
+              { position: new_position(bd_diff, nil, d_line), outdated: true }
+            else
+              # If the line is still in C and not in D, it is still removed.
+              { position: new_position(cd_diff, c_line, nil), outdated: false }
+            end
+          else
+            # If the line is no longer in C, it has been removed outside of the MR.
+            { position: new_position(ac_diff, a_line, nil), outdated: true }
+          end
+        end
+
+        def trace_unchanged_line(position)
+          a_path = position.old_path
+          a_line = position.old_line
+          b_path = position.new_path
+          b_line = position.new_line
+
+          ac_diff = ac_diffs.diff_file_with_old_path(a_path)
+
+          c_path = ac_diff&.new_path || a_path
+          c_line = LineMapper.new(ac_diff).old_to_new(a_line)
+
+          bd_diff = bd_diffs.diff_file_with_old_path(b_path)
+
+          d_line = LineMapper.new(bd_diff).old_to_new(b_line)
+
+          cd_diff = cd_diffs.diff_file_with_old_path(c_path)
+
+          if c_line && d_line
+            # If the line is still in C and D, it is still unchanged.
+            new_position = new_position(cd_diff, c_line, d_line)
+            if valid_position?(new_position)
+              # If the line is still in the MR, we don't treat this as outdated.
+              { position: new_position, outdated: false }
+            else
+              # If the line is no longer in the MR, we unfortunately cannot show
+              # the current state on the CD diff or any change on the BD diff,
+              # so we treat it as outdated.
+              { position: nil, outdated: true }
+            end
+          elsif d_line # && !c_line
+            # If the line is still in D but no longer in C, it has turned from
+            # an unchanged line into an added one.
+            # We don't treat this as outdated since the line is still in the MR.
+            { position: new_position(cd_diff, nil, d_line), outdated: false }
+          else # !d_line && (c_line || !c_line)
+            # If the line is no longer in D, it has turned from an unchanged line
+            # into a removed one.
+            { position: new_position(bd_diff, b_line, nil), outdated: true }
+          end
+        end
+
+        def new_position(diff_file, old_line, new_line)
+          Position.new(
+            diff_file: diff_file,
+            old_line: old_line,
+            new_line: new_line
+          )
+        end
+
+        def valid_position?(position)
+          !!position.diff_line(project.repository)
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/gitlab/diff/position_spec.rb b/spec/lib/gitlab/diff/position_spec.rb
index aea02d21048..b755cd1aff0 100644
--- a/spec/lib/gitlab/diff/position_spec.rb
+++ b/spec/lib/gitlab/diff/position_spec.rb
@@ -610,4 +610,17 @@ describe Gitlab::Diff::Position do
       it_behaves_like "diff position json"
     end
   end
+
+  describe "#file_hash" do
+    subject do
+      described_class.new(
+        old_path: "image.jpg",
+        new_path: "image.jpg"
+      )
+    end
+
+    it "returns SHA1 representation of the file_path" do
+      expect(subject.file_hash).to eq(Digest::SHA1.hexdigest(subject.file_path))
+    end
+  end
 end
diff --git a/spec/lib/gitlab/diff/position_tracer/image_strategy_spec.rb b/spec/lib/gitlab/diff/position_tracer/image_strategy_spec.rb
new file mode 100644
index 00000000000..900816af53a
--- /dev/null
+++ b/spec/lib/gitlab/diff/position_tracer/image_strategy_spec.rb
@@ -0,0 +1,238 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Gitlab::Diff::PositionTracer::ImageStrategy do
+  include PositionTracerHelpers
+
+  let(:project) { create(:project, :repository) }
+  let(:current_user) { project.owner }
+  let(:file_name) { 'test-file' }
+  let(:new_file_name) { "#{file_name}-new" }
+  let(:second_file_name) { "#{file_name}-2" }
+  let(:branch_name) { 'position-tracer-test' }
+  let(:old_position) { position(old_path: file_name, new_path: file_name, position_type: 'image') }
+
+  let(:tracer) do
+    Gitlab::Diff::PositionTracer.new(
+      project: project,
+      old_diff_refs: old_diff_refs,
+      new_diff_refs: new_diff_refs
+    )
+  end
+
+  let(:strategy) { described_class.new(tracer) }
+
+  subject { strategy.trace(old_position) }
+
+  let(:initial_commit) do
+    project.commit(create_branch(branch_name, 'master')[:branch].name)
+  end
+
+  describe '#trace' do
+    describe 'diff scenarios' do
+      let(:create_file_commit) do
+        initial_commit
+
+        create_file(
+          branch_name,
+          file_name,
+          Base64.encode64('content')
+        )
+      end
+
+      let(:update_file_commit) do
+        create_file_commit
+
+        update_file(
+          branch_name,
+          file_name,
+          Base64.encode64('updatedcontent')
+        )
+      end
+
+      let(:update_file_again_commit) do
+        update_file_commit
+
+        update_file(
+          branch_name,
+          file_name,
+          Base64.encode64('updatedcontentagain')
+        )
+      end
+
+      let(:delete_file_commit) do
+        create_file_commit
+        delete_file(branch_name, file_name)
+      end
+
+      let(:rename_file_commit) do
+        delete_file_commit
+
+        create_file(
+          branch_name,
+          new_file_name,
+          Base64.encode64('renamedcontent')
+        )
+      end
+
+      let(:create_second_file_commit) do
+        create_file_commit
+
+        create_file(
+          branch_name,
+          second_file_name,
+          Base64.encode64('morecontent')
+        )
+      end
+
+      let(:create_another_file_commit) do
+        create_file(
+          branch_name,
+          second_file_name,
+          Base64.encode64('morecontent')
+        )
+      end
+
+      let(:update_another_file_commit) do
+        update_file(
+          branch_name,
+          second_file_name,
+          Base64.encode64('updatedmorecontent')
+        )
+      end
+
+      context 'when the file was created in the old diff' do
+        context 'when the file is unchanged between the old and the new diff' do
+          let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+          let(:new_diff_refs) { diff_refs(initial_commit, create_second_file_commit) }
+
+          it 'returns the new position' do
+            expect_new_position(
+              old_path: file_name,
+              new_path: file_name
+            )
+          end
+        end
+
+        context 'when the file was updated between the old and the new diff' do
+          let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+          let(:new_diff_refs) { diff_refs(initial_commit, update_file_commit) }
+          let(:change_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
+
+          it 'returns the position of the change' do
+            expect_change_position(
+              old_path: file_name,
+              new_path: file_name
+            )
+          end
+        end
+
+        context 'when the file was renamed in between the old and the new diff' do
+          let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+          let(:new_diff_refs) { diff_refs(initial_commit, rename_file_commit) }
+          let(:change_diff_refs) { diff_refs(create_file_commit, rename_file_commit) }
+
+          it 'returns the position of the change' do
+            expect_change_position(
+              old_path: file_name,
+              new_path: file_name
+            )
+          end
+        end
+
+        context 'when the file was removed in between the old and the new diff' do
+          let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+          let(:new_diff_refs) { diff_refs(initial_commit, delete_file_commit) }
+          let(:change_diff_refs) { diff_refs(create_file_commit, delete_file_commit) }
+
+          it 'returns the position of the change' do
+            expect_change_position(
+              old_path: file_name,
+              new_path: file_name
+            )
+          end
+        end
+
+        context 'when the file is unchanged in the new diff' do
+          let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+          let(:new_diff_refs) { diff_refs(create_another_file_commit, update_another_file_commit) }
+          let(:change_diff_refs) { diff_refs(initial_commit, create_another_file_commit) }
+
+          it 'returns the position of the change' do
+            expect_change_position(
+              old_path: file_name,
+              new_path: file_name
+            )
+          end
+        end
+      end
+
+      context 'when the file was changed in the old diff' do
+        context 'when the file is unchanged in between the old and the new diff' do
+          let(:old_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
+          let(:new_diff_refs) { diff_refs(create_file_commit, create_second_file_commit) }
+
+          it 'returns the new position' do
+            expect_new_position(
+              old_path: file_name,
+              new_path: file_name
+            )
+          end
+        end
+
+        context 'when the file was updated in between the old and the new diff' do
+          let(:old_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
+          let(:new_diff_refs) { diff_refs(create_file_commit, update_file_again_commit) }
+          let(:change_diff_refs) { diff_refs(update_file_commit, update_file_again_commit) }
+
+          it 'returns the position of the change' do
+            expect_change_position(
+              old_path: file_name,
+              new_path: file_name
+            )
+          end
+        end
+
+        context 'when the file was renamed in between the old and the new diff' do
+          let(:old_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
+          let(:new_diff_refs) { diff_refs(create_file_commit, rename_file_commit) }
+          let(:change_diff_refs) { diff_refs(update_file_commit, rename_file_commit) }
+
+          it 'returns the position of the change' do
+            expect_change_position(
+              old_path: file_name,
+              new_path: file_name
+            )
+          end
+        end
+
+        context 'when the file was removed in between the old and the new diff' do
+          let(:old_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
+          let(:new_diff_refs) { diff_refs(create_file_commit, delete_file_commit) }
+          let(:change_diff_refs) { diff_refs(update_file_commit, delete_file_commit) }
+
+          it 'returns the position of the change' do
+            expect_change_position(
+              old_path: file_name,
+              new_path: file_name
+            )
+          end
+        end
+
+        context 'when the file is unchanged in the new diff' do
+          let(:old_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
+          let(:new_diff_refs) { diff_refs(create_another_file_commit, update_another_file_commit) }
+          let(:change_diff_refs) { diff_refs(create_file_commit, create_another_file_commit) }
+
+          it 'returns the position of the change' do
+            expect_change_position(
+              old_path: file_name,
+              new_path: file_name
+            )
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/gitlab/diff/position_tracer/line_strategy_spec.rb b/spec/lib/gitlab/diff/position_tracer/line_strategy_spec.rb
new file mode 100644
index 00000000000..7f4902c5b86
--- /dev/null
+++ b/spec/lib/gitlab/diff/position_tracer/line_strategy_spec.rb
@@ -0,0 +1,1805 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Gitlab::Diff::PositionTracer::LineStrategy do
+  # Douwe's diary                                    New York City, 2016-06-28
+  # --------------------------------------------------------------------------
+  #
+  # Dear diary,
+  #
+  # Ideally, we would have a test for every single diff scenario that can
+  # occur and that the PositionTracer should correctly trace a position
+  # through, across the following variables:
+  #
+  # - Old diff file type: created, changed, renamed, deleted, unchanged (5)
+  # - Old diff line type: added, removed, unchanged (3)
+  # - New diff file type: created, changed, renamed, deleted, unchanged (5)
+  # - New diff line type: added, removed, unchanged (3)
+  # - Old-to-new diff line change: kept, moved, undone (3)
+  #
+  # This adds up to 5 * 3 * 5 * 3 * 3 = 675 different potential scenarios,
+  # and 675 different tests to cover them all. In reality, it would be fewer,
+  # since one cannot have a removed line in a created file diff, for example,
+  # but for the sake of this diary entry, let's be pessimistic.
+  #
+  # Writing these tests is a manual and time consuming process, as every test
+  # requires the manual construction or finding of a combination of diffs that
+  # create the exact diff scenario we are looking for, and can take between
+  # 1 and 10 minutes, depending on the farfetchedness of the scenario and
+  # complexity of creating it.
+  #
+  # This means that writing tests to cover all of these scenarios would end up
+  # taking between 11 and 112 hours in total, which I do not believe is the
+  # best use of my time.
+  #
+  # A better course of action would be to think of scenarios that are likely
+  # to occur, but also potentially tricky to trace correctly, and only cover
+  # those, with a few more obvious scenarios thrown in to cover our bases.
+  #
+  # Unfortunately, I only came to the above realization once I was about
+  # 1/5th of the way through the process of writing ALL THE SPECS, having
+  # already wasted about 3 hours trying to be thorough.
+  #
+  # I did find 2 bugs while writing those though, so that's good.
+  #
+  # In any case, all of this means that the tests below will be extremely
+  # (excessively, unjustifiably) thorough for scenarios where "the file was
+  # created in the old diff" and then drop off to comparatively lackluster
+  # testing of other scenarios.
+  #
+  # I did still try to cover most of the obvious and potentially tricky
+  # scenarios, though.
+
+  include RepoHelpers
+  include PositionTracerHelpers
+
+  let(:project) { create(:project, :repository) }
+  let(:current_user) { project.owner }
+  let(:repository) { project.repository }
+  let(:file_name) { "test-file" }
+  let(:new_file_name) { "#{file_name}-new" }
+  let(:second_file_name) { "#{file_name}-2" }
+  let(:branch_name) { "position-tracer-test" }
+
+  let(:old_diff_refs) { raise NotImplementedError }
+  let(:new_diff_refs) { raise NotImplementedError }
+  let(:change_diff_refs) { raise NotImplementedError }
+  let(:old_position) { raise NotImplementedError }
+
+  let(:tracer) do
+    Gitlab::Diff::PositionTracer.new(
+      project: project,
+      old_diff_refs: old_diff_refs,
+      new_diff_refs: new_diff_refs
+    )
+  end
+
+  let(:strategy) { described_class.new(tracer) }
+
+  subject { strategy.trace(old_position) }
+
+  let(:initial_commit) do
+    project.commit(create_branch(branch_name, 'master')[:branch].name)
+  end
+
+  describe "#trace" do
+    describe "diff scenarios" do
+      let(:create_file_commit) do
+        initial_commit
+
+        create_file(
+          branch_name,
+          file_name,
+          <<-CONTENT.strip_heredoc
+            A
+            B
+            C
+          CONTENT
+        )
+      end
+
+      let(:create_second_file_commit) do
+        create_file_commit
+
+        create_file(
+          branch_name,
+          second_file_name,
+          <<-CONTENT.strip_heredoc
+            D
+            E
+          CONTENT
+        )
+      end
+
+      let(:update_line_commit) do
+        create_second_file_commit
+
+        update_file(
+          branch_name,
+          file_name,
+          <<-CONTENT.strip_heredoc
+            A
+            BB
+            C
+          CONTENT
+        )
+      end
+
+      let(:update_second_file_line_commit) do
+        update_line_commit
+
+        update_file(
+          branch_name,
+          second_file_name,
+          <<-CONTENT.strip_heredoc
+            D
+            EE
+          CONTENT
+        )
+      end
+
+      let(:move_line_commit) do
+        update_second_file_line_commit
+
+        update_file(
+          branch_name,
+          file_name,
+          <<-CONTENT.strip_heredoc
+            BB
+            A
+            C
+          CONTENT
+        )
+      end
+
+      let(:add_second_file_line_commit) do
+        move_line_commit
+
+        update_file(
+          branch_name,
+          second_file_name,
+          <<-CONTENT.strip_heredoc
+            D
+            EE
+            F
+          CONTENT
+        )
+      end
+
+      let(:move_second_file_line_commit) do
+        add_second_file_line_commit
+
+        update_file(
+          branch_name,
+          second_file_name,
+          <<-CONTENT.strip_heredoc
+            D
+            F
+            EE
+          CONTENT
+        )
+      end
+
+      let(:delete_line_commit) do
+        move_second_file_line_commit
+
+        update_file(
+          branch_name,
+          file_name,
+          <<-CONTENT.strip_heredoc
+            BB
+            A
+          CONTENT
+        )
+      end
+
+      let(:delete_second_file_line_commit) do
+        delete_line_commit
+
+        update_file(
+          branch_name,
+          second_file_name,
+          <<-CONTENT.strip_heredoc
+            D
+            F
+          CONTENT
+        )
+      end
+
+      let(:delete_file_commit) do
+        delete_second_file_line_commit
+
+        delete_file(branch_name, file_name)
+      end
+
+      let(:rename_file_commit) do
+        delete_file_commit
+
+        create_file(
+          branch_name,
+          new_file_name,
+          <<-CONTENT.strip_heredoc
+            BB
+            A
+          CONTENT
+        )
+      end
+
+      let(:update_line_again_commit) do
+        rename_file_commit
+
+        update_file(
+          branch_name,
+          new_file_name,
+          <<-CONTENT.strip_heredoc
+            BB
+            AA
+          CONTENT
+        )
+      end
+
+      let(:move_line_again_commit) do
+        update_line_again_commit
+
+        update_file(
+          branch_name,
+          new_file_name,
+          <<-CONTENT.strip_heredoc
+            AA
+            BB
+          CONTENT
+        )
+      end
+
+      let(:delete_line_again_commit) do
+        move_line_again_commit
+
+        update_file(
+          branch_name,
+          new_file_name,
+          <<-CONTENT.strip_heredoc
+            AA
+          CONTENT
+        )
+      end
+
+      context "when the file was created in the old diff" do
+        context "when the file is created in the new diff" do
+          context "when the position pointed at an added line in the old diff" do
+            context "when the file's content was unchanged between the old and the new diff" do
+              let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+              let(:new_diff_refs) { diff_refs(initial_commit, create_second_file_commit) }
+              let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+              # old diff:
+              #   1 + A
+              #   2 + B
+              #   3 + C
+              #
+              # new diff:
+              #   1 + A
+              #   2 + B
+              #   3 + C
+
+              it "returns the new position" do
+                expect_new_position(
+                  new_path: old_position.new_path,
+                  new_line: old_position.new_line
+                )
+              end
+            end
+
+            context "when the file's content was changed between the old and the new diff" do
+              context "when that line was unchanged between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+                let(:new_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 1) }
+
+                # old diff:
+                #   1 + A
+                #   2 + B
+                #   3 + C
+                #
+                # new diff:
+                #   1 + A
+                #   2 + BB
+                #   3 + C
+
+                it "returns the new position" do
+                  expect_new_position(
+                    new_path: old_position.new_path,
+                    new_line: old_position.new_line
+                  )
+                end
+              end
+
+              context "when that line was moved between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+                let(:new_diff_refs) { diff_refs(initial_commit, move_line_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+                # old diff:
+                #   1 + A
+                #   2 + BB
+                #   3 + C
+                #
+                # new diff:
+                #   1 + BB
+                #   2 + A
+                #   3 + C
+
+                it "returns the new position" do
+                  expect_new_position(
+                    new_path: old_position.new_path,
+                    new_line: 1
+                  )
+                end
+              end
+
+              context "when that line was changed between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+                let(:new_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+                let(:change_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+                # old diff:
+                #   1 + A
+                #   2 + B
+                #   3 + C
+                #
+                # new diff:
+                #   1 + A
+                #   2 + BB
+                #   3 + C
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: 2,
+                    new_line: nil
+                  )
+                end
+              end
+
+              context "when that line was deleted between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+                let(:new_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
+                let(:change_diff_refs) { diff_refs(update_line_commit, delete_line_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 3) }
+
+                # old diff:
+                #   1 + A
+                #   2 + BB
+                #   3 + C
+                #
+                # new diff:
+                #   1 + A
+                #   2 + BB
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: 3,
+                    new_line: nil
+                  )
+                end
+              end
+            end
+          end
+        end
+
+        context "when the file is changed in the new diff" do
+          context "when the position pointed at an added line in the old diff" do
+            context "when the file's content was unchanged between the old and the new diff" do
+              let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+              let(:new_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
+              let(:old_position) { position(new_path: file_name, new_line: 1) }
+
+              # old diff:
+              #   1 + A
+              #   2 + BB
+              #   3 + C
+              #
+              # new diff:
+              # 1 1   A
+              # 2   - B
+              #   2 + BB
+              # 3 3   C
+
+              it "returns the new position" do
+                expect_new_position(
+                  new_path: old_position.new_path,
+                  new_line: old_position.new_line
+                )
+              end
+            end
+
+            context "when the file's content was changed between the old and the new diff" do
+              context "when that line was unchanged between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+                let(:new_diff_refs) { diff_refs(update_line_commit, move_line_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 3) }
+
+                # old diff:
+                #   1 + A
+                #   2 + BB
+                #   3 + C
+                #
+                # new diff:
+                # 1   - A
+                # 2 1   BB
+                #   2 + A
+                # 3 3   C
+
+                it "returns the new position" do
+                  expect_new_position(
+                    new_path: old_position.new_path,
+                    new_line: old_position.new_line
+                  )
+                end
+              end
+
+              context "when that line was moved between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+                let(:new_diff_refs) { diff_refs(update_line_commit, move_line_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+                # old diff:
+                #   1 + A
+                #   2 + BB
+                #   3 + C
+                #
+                # new diff:
+                # 1   - A
+                # 2 1   BB
+                #   2 + A
+                # 3 3   C
+
+                it "returns the new position" do
+                  expect_new_position(
+                    new_path: old_position.new_path,
+                    new_line: 1
+                  )
+                end
+              end
+
+              context "when that line was changed between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+                let(:new_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
+                let(:change_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+                # old diff:
+                #   1 + A
+                #   2 + B
+                #   3 + C
+                #
+                # new diff:
+                # 1 1   A
+                # 2   - B
+                #   2 + BB
+                # 3 3   C
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: 2,
+                    new_line: nil
+                  )
+                end
+              end
+
+              context "when that line was deleted between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, move_line_commit) }
+                let(:new_diff_refs) { diff_refs(move_line_commit, delete_line_commit) }
+                let(:change_diff_refs) { diff_refs(move_line_commit, delete_line_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 3) }
+
+                # old diff:
+                #   1 + BB
+                #   2 + A
+                #   3 + C
+                #
+                # new diff:
+                # 1 1   BB
+                # 2 2   A
+                # 3   - C
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: 3,
+                    new_line: nil
+                  )
+                end
+              end
+            end
+          end
+        end
+
+        context "when the file is renamed in the new diff" do
+          context "when the position pointed at an added line in the old diff" do
+            context "when the file's content was unchanged between the old and the new diff" do
+              let(:old_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
+              let(:new_diff_refs) { diff_refs(delete_line_commit, rename_file_commit) }
+              let(:change_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
+              let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+              # old diff:
+              #   1 + BB
+              #   2 + A
+              #
+              # new diff:
+              # file_name -> new_file_name
+              # 1 1   BB
+              # 2 2   A
+
+              it "returns the position of the change" do
+                expect_change_position(
+                  old_path: file_name,
+                  new_path: file_name,
+                  old_line: nil,
+                  new_line: 2
+                )
+              end
+            end
+
+            context "when the file's content was changed between the old and the new diff" do
+              context "when that line was unchanged between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
+                let(:new_diff_refs) { diff_refs(delete_line_commit, update_line_again_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 1) }
+
+                # old diff:
+                #   1 + BB
+                #   2 + A
+                #
+                # new diff:
+                # file_name -> new_file_name
+                # 1 1   BB
+                # 2   - A
+                #   2 + AA
+
+                it "returns the new position" do
+                  expect_new_position(
+                    old_path: file_name,
+                    new_path: new_file_name,
+                    old_line: old_position.new_line,
+                    new_line: old_position.new_line
+                  )
+                end
+              end
+
+              context "when that line was moved between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
+                let(:new_diff_refs) { diff_refs(delete_line_commit, move_line_again_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 1) }
+
+                # old diff:
+                #   1 + BB
+                #   2 + A
+                #
+                # new diff:
+                # file_name -> new_file_name
+                #   1 + AA
+                # 1 2   BB
+                # 2   - A
+
+                it "returns the new position" do
+                  expect_new_position(
+                    old_path: file_name,
+                    new_path: new_file_name,
+                    old_line: 1,
+                    new_line: 2
+                  )
+                end
+              end
+
+              context "when that line was changed between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
+                let(:new_diff_refs) { diff_refs(delete_line_commit, update_line_again_commit) }
+                let(:change_diff_refs) { diff_refs(delete_line_commit, update_line_again_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+                # old diff:
+                #   1 + BB
+                #   2 + A
+                #
+                # new diff:
+                # file_name -> new_file_name
+                # 1 1   BB
+                # 2   - A
+                #   2 + AA
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: new_file_name,
+                    old_line: 2,
+                    new_line: nil
+                  )
+                end
+              end
+            end
+          end
+        end
+
+        context "when the file is deleted in the new diff" do
+          context "when the position pointed at an added line in the old diff" do
+            context "when the file's content was unchanged between the old and the new diff" do
+              let(:old_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
+              let(:new_diff_refs) { diff_refs(delete_line_commit, delete_file_commit) }
+              let(:change_diff_refs) { diff_refs(delete_line_commit, delete_file_commit) }
+              let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+              # old diff:
+              #   1 + BB
+              #   2 + A
+              #
+              # new diff:
+              # 1   - BB
+              # 2   - A
+
+              it "returns the position of the change" do
+                expect_change_position(
+                  old_path: file_name,
+                  new_path: file_name,
+                  old_line: 2,
+                  new_line: nil
+                )
+              end
+            end
+
+            context "when the file's content was changed between the old and the new diff" do
+              context "when that line was unchanged between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, move_line_commit) }
+                let(:new_diff_refs) { diff_refs(delete_line_commit, delete_file_commit) }
+                let(:change_diff_refs) { diff_refs(move_line_commit, delete_file_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+                # old diff:
+                #   1 + BB
+                #   2 + A
+                #   3 + C
+                #
+                # new diff:
+                # 1   - BB
+                # 2   - A
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: 2,
+                    new_line: nil
+                  )
+                end
+              end
+
+              context "when that line was moved between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+                let(:new_diff_refs) { diff_refs(move_line_commit, delete_file_commit) }
+                let(:change_diff_refs) { diff_refs(update_line_commit, delete_file_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+                # old diff:
+                #   1 + A
+                #   2 + BB
+                #   3 + C
+                #
+                # new diff:
+                # 1   - BB
+                # 2   - A
+                # 3   - C
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: 2,
+                    new_line: nil
+                  )
+                end
+              end
+
+              context "when that line was changed between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+                let(:new_diff_refs) { diff_refs(update_line_commit, delete_file_commit) }
+                let(:change_diff_refs) { diff_refs(create_file_commit, delete_file_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+                # old diff:
+                #   1 + A
+                #   2 + B
+                #   3 + C
+                #
+                # new diff:
+                # 1   - A
+                # 2   - BB
+                # 3   - C
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: 2,
+                    new_line: nil
+                  )
+                end
+              end
+
+              context "when that line was deleted between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, move_line_commit) }
+                let(:new_diff_refs) { diff_refs(delete_line_commit, delete_file_commit) }
+                let(:change_diff_refs) { diff_refs(move_line_commit, delete_file_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 3) }
+
+                # old diff:
+                #   1 + BB
+                #   2 + A
+                #   3 + C
+                #
+                # new diff:
+                # 1   - BB
+                # 2   - A
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: 3,
+                    new_line: nil
+                  )
+                end
+              end
+            end
+          end
+        end
+
+        context "when the file is unchanged in the new diff" do
+          context "when the position pointed at an added line in the old diff" do
+            context "when the file's content was unchanged between the old and the new diff" do
+              let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+              let(:new_diff_refs) { diff_refs(create_file_commit, create_second_file_commit) }
+              let(:change_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+              let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+              # old diff:
+              #   1 + A
+              #   2 + B
+              #   3 + C
+              #
+              # new diff:
+              # 1 1   A
+              # 2 2   B
+              # 3 3   C
+
+              it "returns the position of the change" do
+                expect_change_position(
+                  old_path: file_name,
+                  new_path: file_name,
+                  old_line: nil,
+                  new_line: 2
+                )
+              end
+            end
+
+            context "when the file's content was changed between the old and the new diff" do
+              context "when that line was unchanged between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+                let(:new_diff_refs) { diff_refs(update_line_commit, update_second_file_line_commit) }
+                let(:change_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 1) }
+
+                # old diff:
+                #   1 + A
+                #   2 + B
+                #   3 + C
+                #
+                # new diff:
+                # 1 1   A
+                # 2 2   BB
+                # 3 3   C
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: nil,
+                    new_line: 1
+                  )
+                end
+              end
+
+              context "when that line was moved between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+                let(:new_diff_refs) { diff_refs(move_line_commit, move_second_file_line_commit) }
+                let(:change_diff_refs) { diff_refs(initial_commit, move_line_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+                # old diff:
+                #   1 + A
+                #   2 + BB
+                #   3 + C
+                #
+                # new diff:
+                # 1 1   BB
+                # 2 2   A
+                # 3 3   C
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: nil,
+                    new_line: 1
+                  )
+                end
+              end
+
+              context "when that line was changed between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+                let(:new_diff_refs) { diff_refs(update_line_commit, update_second_file_line_commit) }
+                let(:change_diff_refs) { diff_refs(create_file_commit, update_second_file_line_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 2) }
+
+                # old diff:
+                #   1 + A
+                #   2 + B
+                #   3 + C
+                #
+                # new diff:
+                # 1 1   A
+                # 2 2   BB
+                # 3 3   C
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: 2,
+                    new_line: nil
+                  )
+                end
+              end
+
+              context "when that line was deleted between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(initial_commit, move_line_commit) }
+                let(:new_diff_refs) { diff_refs(delete_line_commit, delete_second_file_line_commit) }
+                let(:change_diff_refs) { diff_refs(move_line_commit, delete_second_file_line_commit) }
+                let(:old_position) { position(new_path: file_name, new_line: 3) }
+
+                # old diff:
+                #   1 + BB
+                #   2 + A
+                #   3 + C
+                #
+                # new diff:
+                # 1 1   BB
+                # 2 2   A
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: 3,
+                    new_line: nil
+                  )
+                end
+              end
+            end
+          end
+        end
+      end
+
+      context "when the file was changed in the old diff" do
+        context "when the file is created in the new diff" do
+          context "when the position pointed at an added line in the old diff" do
+            context "when the file's content was unchanged between the old and the new diff" do
+              let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
+              let(:new_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+              let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 2) }
+
+              # old diff:
+              # 1 1   A
+              # 2   - B
+              #   2 + BB
+              # 3 3   C
+              #
+              # new diff:
+              #   1 + A
+              #   2 + BB
+              #   3 + C
+
+              it "returns the new position" do
+                expect_new_position(
+                  new_path: old_position.new_path,
+                  old_line: nil,
+                  new_line: old_position.new_line
+                )
+              end
+            end
+
+            context "when the file's content was changed between the old and the new diff" do
+              context "when that line was unchanged between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(create_file_commit, move_line_commit) }
+                let(:new_diff_refs) { diff_refs(initial_commit, move_line_commit) }
+                let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 1) }
+
+                # old diff:
+                #   1 + BB
+                # 1 2   A
+                # 2   - B
+                # 3 3   C
+                #
+                # new diff:
+                #   1 + BB
+                #   2 + A
+
+                it "returns the new position" do
+                  expect_new_position(
+                    new_path: old_position.new_path,
+                    old_line: nil,
+                    new_line: old_position.new_line
+                  )
+                end
+              end
+
+              context "when that line was moved between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
+                let(:new_diff_refs) { diff_refs(initial_commit, move_line_commit) }
+                let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 2) }
+
+                # old diff:
+                # 1 1   A
+                # 2   - B
+                #   2 + BB
+                # 3 3   C
+                #
+                # new diff:
+                #   1 + BB
+                #   2 + A
+                #   3 + C
+
+                it "returns the new position" do
+                  expect_new_position(
+                    new_path: old_position.new_path,
+                    old_line: nil,
+                    new_line: 1
+                  )
+                end
+              end
+
+              context "when that line was changed or deleted between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(create_file_commit, move_line_commit) }
+                let(:new_diff_refs) { diff_refs(initial_commit, create_file_commit) }
+                let(:change_diff_refs) { diff_refs(move_line_commit, create_file_commit) }
+                let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 1) }
+
+                # old diff:
+                #   1 + BB
+                # 1 2   A
+                # 2   - B
+                # 3 3   C
+                #
+                # new diff:
+                #   1 + A
+                #   2 + B
+                #   3 + C
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: 1,
+                    new_line: nil
+                  )
+                end
+              end
+            end
+          end
+
+          context "when the position pointed at a deleted line in the old diff" do
+            let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
+            let(:new_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+            let(:change_diff_refs) { diff_refs(create_file_commit, initial_commit) }
+            let(:old_position) { position(old_path: file_name, new_path: file_name, old_line: 2) }
+
+            # old diff:
+            # 1 1   A
+            # 2   - B
+            #   2 + BB
+            # 3 3   C
+            #
+            # new diff:
+            #   1 + A
+            #   2 + BB
+            #   3 + C
+
+            it "returns the position of the change" do
+              expect_change_position(
+                old_path: file_name,
+                new_path: file_name,
+                old_line: 2,
+                new_line: nil
+              )
+            end
+          end
+
+          context "when the position pointed at an unchanged line in the old diff" do
+            context "when the file's content was unchanged between the old and the new diff" do
+              let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
+              let(:new_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+              let(:old_position) { position(old_path: file_name, new_path: file_name, old_line: 1, new_line: 1) }
+
+              # old diff:
+              # 1 1   A
+              # 2   - B
+              #   2 + BB
+              # 3 3   C
+              #
+              # new diff:
+              #   1 + A
+              #   2 + BB
+              #   3 + C
+
+              it "returns the new position" do
+                expect_new_position(
+                  new_path: old_position.new_path,
+                  old_line: nil,
+                  new_line: old_position.new_line
+                )
+              end
+            end
+
+            context "when the file's content was changed between the old and the new diff" do
+              context "when that line was unchanged between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(create_file_commit, move_line_commit) }
+                let(:new_diff_refs) { diff_refs(initial_commit, move_line_commit) }
+                let(:old_position) { position(old_path: file_name, new_path: file_name, old_line: 1, new_line: 2) }
+
+                # old diff:
+                #   1 + BB
+                # 1 2   A
+                # 2   - B
+                # 3 3   C
+                #
+                # new diff:
+                #   1 + BB
+                #   2 + A
+
+                it "returns the new position" do
+                  expect_new_position(
+                    new_path: old_position.new_path,
+                    old_line: nil,
+                    new_line: old_position.new_line
+                  )
+                end
+              end
+
+              context "when that line was moved between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(move_line_commit, delete_line_commit) }
+                let(:new_diff_refs) { diff_refs(initial_commit, update_line_commit) }
+                let(:old_position) { position(old_path: file_name, new_path: file_name, old_line: 2, new_line: 2) }
+
+                # old diff:
+                # 1 1   BB
+                # 2 2   A
+                # 3   - C
+                #
+                # new diff:
+                #   1 + A
+                #   2 + BB
+                #   3 + C
+
+                it "returns the new position" do
+                  expect_new_position(
+                    new_path: old_position.new_path,
+                    old_line: nil,
+                    new_line: 1
+                  )
+                end
+              end
+
+              context "when that line was changed or deleted between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(create_file_commit, move_line_commit) }
+                let(:new_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
+                let(:change_diff_refs) { diff_refs(move_line_commit, delete_line_commit) }
+                let(:old_position) { position(old_path: file_name, new_path: file_name, old_line: 3, new_line: 3) }
+
+                # old diff:
+                #   1 + BB
+                # 1 2   A
+                # 2   - B
+                # 3 3   C
+                #
+                # new diff:
+                #   1 + A
+                #   2 + B
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: 3,
+                    new_line: nil
+                  )
+                end
+              end
+            end
+          end
+        end
+
+        context "when the file is changed in the new diff" do
+          context "when the position pointed at an added line in the old diff" do
+            context "when the file's content was unchanged between the old and the new diff" do
+              let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
+              let(:new_diff_refs) { diff_refs(create_file_commit, update_second_file_line_commit) }
+              let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 2) }
+
+              # old diff:
+              # 1 1   A
+              # 2   - B
+              #   2 + BB
+              # 3 3   C
+              #
+              # new diff:
+              # 1 1   A
+              # 2   - B
+              #   2 + BB
+              # 3 3   C
+
+              it "returns the new position" do
+                expect_new_position(
+                  old_path: old_position.old_path,
+                  new_path: old_position.new_path,
+                  old_line: nil,
+                  new_line: old_position.new_line
+                )
+              end
+            end
+
+            context "when the file's content was changed between the old and the new diff" do
+              context "when that line was unchanged between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(create_file_commit, move_line_commit) }
+                let(:new_diff_refs) { diff_refs(move_line_commit, delete_line_commit) }
+                let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 1) }
+
+                # old diff:
+                #   1 + BB
+                # 1 2   A
+                # 2   - B
+                # 3 3   C
+                #
+                # new diff:
+                # 1 1   BB
+                # 2 2   A
+                # 3   - C
+
+                it "returns the new position" do
+                  expect_new_position(
+                    old_path: old_position.old_path,
+                    new_path: old_position.new_path,
+                    old_line: 1,
+                    new_line: 1
+                  )
+                end
+              end
+
+              context "when that line was moved between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
+                let(:new_diff_refs) { diff_refs(update_line_commit, move_line_commit) }
+                let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 2) }
+
+                # old diff:
+                # 1 1   A
+                # 2   - B
+                #   2 + BB
+                # 3 3   C
+                #
+                # new diff:
+                # 1   - A
+                # 2 1   BB
+                #   2 + A
+                # 3 3   C
+
+                it "returns the new position" do
+                  expect_new_position(
+                    old_path: old_position.old_path,
+                    new_path: old_position.new_path,
+                    old_line: 2,
+                    new_line: 1
+                  )
+                end
+              end
+
+              context "when that line was changed or deleted between the old and the new diff" do
+                let(:old_diff_refs) { diff_refs(create_file_commit, move_line_commit) }
+                let(:new_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
+                let(:change_diff_refs) { diff_refs(move_line_commit, update_line_commit) }
+                let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 1) }
+
+                # old diff:
+                #   1 + BB
+                # 1 2   A
+                # 2   - B
+                # 3 3   C
+                #
+                # new diff:
+                # 1 1   A
+                # 2   - B
+                #   2 + BB
+                # 3 3   C
+
+                it "returns the position of the change" do
+                  expect_change_position(
+                    old_path: file_name,
+                    new_path: file_name,
+                    old_line: 1,
+                    new_line: nil
+                  )
+                end
+              end
+            end
+          end
+
+          context "when the position pointed at a deleted line in the old diff" do
+            context "when the file's content was unchanged between the old and the new diff" do
+              let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
+              let(:new_diff_refs) { diff_refs(create_file_commit, update_second_file_line_commit) }
+              let(:old_position) { position(old_path: file_name, new_path: file_name, old_line: 2) }
+
+              # old diff:
+              # 1 1   A
+              # 2   - B
+              #   2 + BB
+              # 3 3   C
+              #
+              # new diff:
+              # 1 1   A
+              # 2   - B
+              #   2 + BB
+              # 3 3   C
+
+              it "returns the new position" do
+                expect_new_position(
+                  old_path: old_position.old_path,
+                  new_path: old_position.new_path,
+                  old_line: old_position.old_line,
+                  new_line: nil
+                )
+              end
+            end
+          end
+        end
+      end
+    end
+
+    describe "typical use scenarios" do
+      let(:second_branch_name) { "#{branch_name}-2" }
+
+      def expect_new_positions(old_attrs, new_attrs)
+        old_positions = old_attrs.map do |old_attrs|
+          position(old_attrs)
+        end
+
+        new_positions = old_positions.map do |old_position|
+          strategy.trace(old_position)
+        end
+
+        aggregate_failures do
+          new_positions.zip(new_attrs).each do |new_position, new_attrs|
+            if new_attrs&.delete(:change)
+              expect_change_position(new_attrs, new_position)
+            else
+              expect_new_position(new_attrs, new_position)
+            end
+          end
+        end
+      end
+
+      let(:create_file_commit) do
+        initial_commit
+
+        create_file(
+          branch_name,
+          file_name,
+          <<-CONTENT.strip_heredoc
+            A
+            B
+            C
+            D
+            E
+            F
+          CONTENT
+        )
+      end
+
+      let(:second_create_file_commit) do
+        create_file_commit
+
+        create_branch(second_branch_name, branch_name)
+
+        update_file(
+          second_branch_name,
+          file_name,
+          <<-CONTENT.strip_heredoc
+            Z
+            Z
+            Z
+            A
+            B
+            C
+            D
+            E
+            F
+          CONTENT
+        )
+      end
+
+      let(:update_file_commit) do
+        second_create_file_commit
+
+        update_file(
+          branch_name,
+          file_name,
+          <<-CONTENT.strip_heredoc
+            A
+            C
+            DD
+            E
+            F
+            G
+          CONTENT
+        )
+      end
+
+      let(:update_file_again_commit) do
+        update_file_commit
+
+        update_file(
+          branch_name,
+          file_name,
+          <<-CONTENT.strip_heredoc
+            A
+            BB
+            C
+            D
+            E
+            FF
+            G
+          CONTENT
+        )
+      end
+
+      describe "simple push of new commit" do
+        let(:old_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
+        let(:new_diff_refs) { diff_refs(create_file_commit, update_file_again_commit) }
+        let(:change_diff_refs) { diff_refs(update_file_commit, update_file_again_commit) }
+
+        # old diff:
+        # 1 1   A
+        # 2   - B
+        # 3 2   C
+        # 4   - D
+        #   3 + DD
+        # 5 4   E
+        # 6 5   F
+        #   6 + G
+        #
+        # new diff:
+        # 1 1   A
+        # 2   - B
+        #   2 + BB
+        # 3 3   C
+        # 4 4   D
+        # 5 5   E
+        # 6   - F
+        #   6 + FF
+        #   7 + G
+
+        it "returns the new positions" do
+          old_position_attrs = [
+            { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 }, #   A
+            { old_path: file_name,                      old_line: 2              }, # - B
+            { old_path: file_name, new_path: file_name, old_line: 3, new_line: 2 }, #   C
+            { old_path: file_name,                      old_line: 4              }, # - D
+            {                      new_path: file_name,              new_line: 3 }, # + DD
+            { old_path: file_name, new_path: file_name, old_line: 5, new_line: 4 }, #   E
+            { old_path: file_name, new_path: file_name, old_line: 6, new_line: 5 }, #   F
+            {                      new_path: file_name,              new_line: 6 } # + G
+          ]
+
+          new_position_attrs = [
+            { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 },
+            { old_path: file_name,                      old_line: 2              },
+            { old_path: file_name, new_path: file_name, old_line: 3, new_line: 3 },
+            {                      new_path: file_name,              new_line: 4,   change: true },
+            {                      new_path: file_name, old_line: 3,                change: true },
+            { old_path: file_name, new_path: file_name, old_line: 5, new_line: 5 },
+            {                      new_path: file_name, old_line: 5, change: true },
+            {                      new_path: file_name, new_line: 7 }
+          ]
+
+          expect_new_positions(old_position_attrs, new_position_attrs)
+        end
+      end
+
+      describe "force push to overwrite last commit" do
+        let(:second_create_file_commit) do
+          create_file_commit
+
+          create_branch(second_branch_name, branch_name)
+
+          update_file(
+            second_branch_name,
+            file_name,
+            <<-CONTENT.strip_heredoc
+              A
+              BB
+              C
+              D
+              E
+              FF
+              G
+            CONTENT
+          )
+        end
+
+        let(:old_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
+        let(:new_diff_refs) { diff_refs(create_file_commit, second_create_file_commit) }
+        let(:change_diff_refs) { diff_refs(update_file_commit, second_create_file_commit) }
+
+        # old diff:
+        # 1 1   A
+        # 2   - B
+        # 3 2   C
+        # 4   - D
+        #   3 + DD
+        # 5 4   E
+        # 6 5   F
+        #   6 + G
+        #
+        # new diff:
+        # 1 1   A
+        # 2   - B
+        #   2 + BB
+        # 3 3   C
+        # 4 4   D
+        # 5 5   E
+        # 6   - F
+        #   6 + FF
+        #   7 + G
+
+        it "returns the new positions" do
+          old_position_attrs = [
+            { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 }, #   A
+            { old_path: file_name,                      old_line: 2              }, # - B
+            { old_path: file_name, new_path: file_name, old_line: 3, new_line: 2 }, #   C
+            { old_path: file_name,                      old_line: 4              }, # - D
+            {                      new_path: file_name,              new_line: 3 }, # + DD
+            { old_path: file_name, new_path: file_name, old_line: 5, new_line: 4 }, #   E
+            { old_path: file_name, new_path: file_name, old_line: 6, new_line: 5 }, #   F
+            {                      new_path: file_name,              new_line: 6 } # + G
+          ]
+
+          new_position_attrs = [
+            { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 },
+            { old_path: file_name,                      old_line: 2              },
+            { old_path: file_name, new_path: file_name, old_line: 3, new_line: 3 },
+            {                      new_path: file_name,              new_line: 4,   change: true },
+            { old_path: file_name,                      old_line: 3,                change: true },
+            { old_path: file_name, new_path: file_name, old_line: 5, new_line: 5 },
+            { old_path: file_name,                      old_line: 5, change: true },
+            {                      new_path: file_name,              new_line: 7 }
+          ]
+
+          expect_new_positions(old_position_attrs, new_position_attrs)
+        end
+      end
+
+      describe "force push to delete last commit" do
+        let(:old_diff_refs) { diff_refs(create_file_commit, update_file_again_commit) }
+        let(:new_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
+        let(:change_diff_refs) { diff_refs(update_file_again_commit, update_file_commit) }
+
+        # old diff:
+        # 1 1   A
+        # 2   - B
+        #   2 + BB
+        # 3 3   C
+        # 4 4   D
+        # 5 5   E
+        # 6   - F
+        #   6 + FF
+        #   7 + G
+        #
+        # new diff:
+        # 1 1   A
+        # 2   - B
+        # 3 2   C
+        # 4   - D
+        #   3 + DD
+        # 5 4   E
+        # 6 5   F
+        #   6 + G
+
+        it "returns the new positions" do
+          old_position_attrs = [
+            { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 }, #   A
+            { old_path: file_name,                      old_line: 2              }, # - B
+            {                      new_path: file_name,              new_line: 2 }, # + BB
+            { old_path: file_name, new_path: file_name, old_line: 3, new_line: 3 }, #   C
+            { old_path: file_name, new_path: file_name, old_line: 4, new_line: 4 }, #   D
+            { old_path: file_name, new_path: file_name, old_line: 5, new_line: 5 }, #   E
+            { old_path: file_name,                      old_line: 6              }, # - F
+            {                      new_path: file_name,              new_line: 6 }, # + FF
+            {                      new_path: file_name,              new_line: 7 } # + G
+          ]
+
+          new_position_attrs = [
+            { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 },
+            { old_path: file_name,                      old_line: 2              },
+            { old_path: file_name,                      old_line: 2, change: true },
+            { old_path: file_name, new_path: file_name, old_line: 3, new_line: 2 },
+            { old_path: file_name,                      old_line: 4, change: true },
+            { old_path: file_name, new_path: file_name, old_line: 5, new_line: 4 },
+            {                      new_path: file_name,              new_line: 5, change: true },
+            { old_path: file_name, old_line: 6, change: true },
+            { new_path: file_name, new_line: 6 }
+          ]
+
+          expect_new_positions(old_position_attrs, new_position_attrs)
+        end
+      end
+
+      describe "rebase on top of target branch" do
+        let(:second_update_file_commit) do
+          update_file_commit
+
+          update_file(
+            second_branch_name,
+            file_name,
+            <<-CONTENT.strip_heredoc
+              Z
+              Z
+              Z
+              A
+              C
+              DD
+              E
+              F
+              G
+            CONTENT
+          )
+        end
+
+        let(:update_file_again_commit) do
+          second_update_file_commit
+
+          update_file(
+            branch_name,
+            file_name,
+            <<-CONTENT.strip_heredoc
+              A
+              BB
+              C
+              D
+              E
+              FF
+              G
+            CONTENT
+          )
+        end
+
+        let(:overwrite_update_file_again_commit) do
+          update_file_again_commit
+
+          update_file(
+            second_branch_name,
+            file_name,
+            <<-CONTENT.strip_heredoc
+              Z
+              Z
+              Z
+              A
+              BB
+              C
+              D
+              E
+              FF
+              G
+            CONTENT
+          )
+        end
+
+        let(:old_diff_refs) { diff_refs(create_file_commit, update_file_again_commit) }
+        let(:new_diff_refs) { diff_refs(create_file_commit, overwrite_update_file_again_commit) }
+        let(:change_diff_refs) { diff_refs(update_file_again_commit, overwrite_update_file_again_commit) }
+
+        # old diff:
+        # 1 1   A
+        # 2   - B
+        #   2 + BB
+        # 3 3   C
+        # 4 4   D
+        # 5 5   E
+        # 6   - F
+        #   6 + FF
+        #   7 + G
+        #
+        # new diff:
+        #   1 + Z
+        #   2 + Z
+        #   3 + Z
+        # 1 4   A
+        # 2   - B
+        #   5 + BB
+        # 3 6   C
+        # 4 7   D
+        # 5 8   E
+        # 6   - F
+        #   9 + FF
+        #   0 + G
+
+        it "returns the new positions" do
+          old_position_attrs = [
+            { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 }, #   A
+            { old_path: file_name,                      old_line: 2              }, # - B
+            {                      new_path: file_name,              new_line: 2 }, # + BB
+            { old_path: file_name, new_path: file_name, old_line: 3, new_line: 3 }, #   C
+            { old_path: file_name, new_path: file_name, old_line: 4, new_line: 4 }, #   D
+            { old_path: file_name, new_path: file_name, old_line: 5, new_line: 5 }, #   E
+            { old_path: file_name,                      old_line: 6              }, # - F
+            {                      new_path: file_name,              new_line: 6 }, # + FF
+            {                      new_path: file_name,              new_line: 7 } # + G
+          ]
+
+          new_position_attrs = [
+            { old_path: file_name, new_path: file_name, old_line: 1, new_line: 4 }, #   A
+            { old_path: file_name,                      old_line: 2              }, # - B
+            {                      new_path: file_name,              new_line: 5 }, # + BB
+            { old_path: file_name, new_path: file_name, old_line: 3, new_line: 6 }, #   C
+            { old_path: file_name, new_path: file_name, old_line: 4, new_line: 7 }, #   D
+            { old_path: file_name, new_path: file_name, old_line: 5, new_line: 8 }, #   E
+            { old_path: file_name,                      old_line: 6              }, # - F
+            {                      new_path: file_name,              new_line: 9 }, # + FF
+            {                      new_path: file_name,              new_line: 10 } # + G
+          ]
+
+          expect_new_positions(old_position_attrs, new_position_attrs)
+        end
+      end
+
+      describe "merge of target branch" do
+        let(:merge_commit) do
+          second_create_file_commit
+
+          merge_request = create(:merge_request, source_branch: second_branch_name, target_branch: branch_name, source_project: project)
+
+          repository.merge(current_user, merge_request.diff_head_sha, merge_request, "Merge branches")
+
+          project.commit(branch_name)
+        end
+
+        let(:old_diff_refs) { diff_refs(create_file_commit, update_file_again_commit) }
+        let(:new_diff_refs) { diff_refs(create_file_commit, merge_commit) }
+        let(:change_diff_refs) { diff_refs(update_file_again_commit, merge_commit) }
+
+        # old diff:
+        # 1 1   A
+        # 2   - B
+        #   2 + BB
+        # 3 3   C
+        # 4 4   D
+        # 5 5   E
+        # 6   - F
+        #   6 + FF
+        #   7 + G
+        #
+        # new diff:
+        #   1 + Z
+        #   2 + Z
+        #   3 + Z
+        # 1 4   A
+        # 2   - B
+        #   5 + BB
+        # 3 6   C
+        # 4 7   D
+        # 5 8   E
+        # 6   - F
+        #   9 + FF
+        #   0 + G
+
+        it "returns the new positions" do
+          old_position_attrs = [
+            { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 }, #   A
+            { old_path: file_name,                      old_line: 2              }, # - B
+            {                      new_path: file_name,              new_line: 2 }, # + BB
+            { old_path: file_name, new_path: file_name, old_line: 3, new_line: 3 }, #   C
+            { old_path: file_name, new_path: file_name, old_line: 4, new_line: 4 }, #   D
+            { old_path: file_name, new_path: file_name, old_line: 5, new_line: 5 }, #   E
+            { old_path: file_name,                      old_line: 6              }, # - F
+            {                      new_path: file_name,              new_line: 6 }, # + FF
+            {                      new_path: file_name,              new_line: 7 } # + G
+          ]
+
+          new_position_attrs = [
+            { old_path: file_name, new_path: file_name, old_line: 1, new_line: 4 }, #   A
+            { old_path: file_name,                      old_line: 2              }, # - B
+            {                      new_path: file_name,              new_line: 5 }, # + BB
+            { old_path: file_name, new_path: file_name, old_line: 3, new_line: 6 }, #   C
+            { old_path: file_name, new_path: file_name, old_line: 4, new_line: 7 }, #   D
+            { old_path: file_name, new_path: file_name, old_line: 5, new_line: 8 }, #   E
+            { old_path: file_name,                      old_line: 6              }, # - F
+            {                      new_path: file_name,              new_line: 9 }, # + FF
+            {                      new_path: file_name,              new_line: 10 } # + G
+          ]
+
+          expect_new_positions(old_position_attrs, new_position_attrs)
+        end
+      end
+
+      describe "changing target branch" do
+        let(:old_diff_refs) { diff_refs(create_file_commit, update_file_again_commit) }
+        let(:new_diff_refs) { diff_refs(update_file_commit, update_file_again_commit) }
+        let(:change_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
+
+        # old diff:
+        # 1 1   A
+        # 2   - B
+        #   2 + BB
+        # 3 3   C
+        # 4 4   D
+        # 5 5   E
+        # 6   - F
+        #   6 + FF
+        #   7 + G
+        #
+        # new diff:
+        # 1 1   A
+        #   2 + BB
+        # 2 3   C
+        # 3   - DD
+        #   4 + D
+        # 4 5   E
+        # 5   - F
+        #   6 + FF
+        #   7   G
+
+        it "returns the new positions" do
+          old_position_attrs = [
+            { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 }, #   A
+            { old_path: file_name,                      old_line: 2              }, # - B
+            {                      new_path: file_name,              new_line: 2 }, # + BB
+            { old_path: file_name, new_path: file_name, old_line: 3, new_line: 3 }, #   C
+            { old_path: file_name, new_path: file_name, old_line: 4, new_line: 4 }, #   D
+            { old_path: file_name, new_path: file_name, old_line: 5, new_line: 5 }, #   E
+            { old_path: file_name,                      old_line: 6              }, # - F
+            {                      new_path: file_name,              new_line: 6 }, # + FF
+            {                      new_path: file_name,              new_line: 7 } # + G
+          ]
+
+          new_position_attrs = [
+            { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 },
+            { old_path: file_name,                      old_line: 2, change: true },
+            {                      new_path: file_name,              new_line: 2 },
+            { old_path: file_name, new_path: file_name, old_line: 2, new_line: 3 },
+            {                      new_path: file_name,              new_line: 4 },
+            { old_path: file_name, new_path: file_name, old_line: 4, new_line: 5 },
+            { old_path: file_name,                      old_line: 5              },
+            {                      new_path: file_name,              new_line: 6 },
+            {                      new_path: file_name,              new_line: 7 }
+          ]
+
+          expect_new_positions(old_position_attrs, new_position_attrs)
+        end
+      end
+    end
+  end
+end
diff --git a/spec/lib/gitlab/diff/position_tracer_spec.rb b/spec/lib/gitlab/diff/position_tracer_spec.rb
index 866550753a8..79b33d4d276 100644
--- a/spec/lib/gitlab/diff/position_tracer_spec.rb
+++ b/spec/lib/gitlab/diff/position_tracer_spec.rb
@@ -1,1896 +1,98 @@
 require 'spec_helper'
 
 describe Gitlab::Diff::PositionTracer do
-  # Douwe's diary                                    New York City, 2016-06-28
-  # --------------------------------------------------------------------------
-  #
-  # Dear diary,
-  #
-  # Ideally, we would have a test for every single diff scenario that can
-  # occur and that the PositionTracer should correctly trace a position
-  # through, across the following variables:
-  #
-  # - Old diff file type: created, changed, renamed, deleted, unchanged (5)
-  # - Old diff line type: added, removed, unchanged (3)
-  # - New diff file type: created, changed, renamed, deleted, unchanged (5)
-  # - New diff line type: added, removed, unchanged (3)
-  # - Old-to-new diff line change: kept, moved, undone (3)
-  #
-  # This adds up to 5 * 3 * 5 * 3 * 3 = 675 different potential scenarios,
-  # and 675 different tests to cover them all. In reality, it would be fewer,
-  # since one cannot have a removed line in a created file diff, for example,
-  # but for the sake of this diary entry, let's be pessimistic.
-  #
-  # Writing these tests is a manual and time consuming process, as every test
-  # requires the manual construction or finding of a combination of diffs that
-  # create the exact diff scenario we are looking for, and can take between
-  # 1 and 10 minutes, depending on the farfetchedness of the scenario and
-  # complexity of creating it.
-  #
-  # This means that writing tests to cover all of these scenarios would end up
-  # taking between 11 and 112 hours in total, which I do not believe is the
-  # best use of my time.
-  #
-  # A better course of action would be to think of scenarios that are likely
-  # to occur, but also potentially tricky to trace correctly, and only cover
-  # those, with a few more obvious scenarios thrown in to cover our bases.
-  #
-  # Unfortunately, I only came to the above realization once I was about
-  # 1/5th of the way through the process of writing ALL THE SPECS, having
-  # already wasted about 3 hours trying to be thorough.
-  #
-  # I did find 2 bugs while writing those though, so that's good.
-  #
-  # In any case, all of this means that the tests below will be extremely
-  # (excessively, unjustifiably) thorough for scenarios where "the file was
-  # created in the old diff" and then drop off to comparatively lackluster
-  # testing of other scenarios.
-  #
-  # I did still try to cover most of the obvious and potentially tricky
-  # scenarios, though.
+  include PositionTracerHelpers
 
-  include RepoHelpers
-
-  let(:project) { create(:project, :repository) }
-  let(:current_user) { project.owner }
-  let(:repository) { project.repository }
-  let(:file_name) { "test-file" }
-  let(:new_file_name) { "#{file_name}-new" }
-  let(:second_file_name) { "#{file_name}-2" }
-  let(:branch_name) { "position-tracer-test" }
-
-  let(:old_diff_refs) { raise NotImplementedError }
-  let(:new_diff_refs) { raise NotImplementedError }
-  let(:change_diff_refs) { raise NotImplementedError }
-  let(:old_position) { raise NotImplementedError }
-
-  let(:position_tracer) { described_class.new(project: project, old_diff_refs: old_diff_refs, new_diff_refs: new_diff_refs) }
-  subject { position_tracer.trace(old_position) }
-
-  def diff_refs(base_commit, head_commit)
-    Gitlab::Diff::DiffRefs.new(base_sha: base_commit.id, head_sha: head_commit.id)
-  end
-
-  def text_position_attrs
-    [:old_line, :new_line]
-  end
-
-  def position(attrs = {})
-    attrs.reverse_merge!(
-      diff_refs: old_diff_refs
+  subject do
+    described_class.new(
+      project: project,
+      old_diff_refs: old_diff_refs,
+      new_diff_refs: new_diff_refs
     )
-    Gitlab::Diff::Position.new(attrs)
   end
 
-  def expect_new_position(attrs, result = subject)
-    aggregate_failures("expect new position #{attrs.inspect}") do
-      if attrs.nil?
-        expect(result[:outdated]).to be_truthy
-      else
-        expect(result[:outdated]).to be_falsey
+  describe '#trace' do
+    let(:diff_refs) { double(complete?: true) }
+    let(:project) { double }
+    let(:old_diff_refs) { diff_refs }
+    let(:new_diff_refs) { diff_refs }
+    let(:position) { double(on_text?: on_text?, diff_refs: diff_refs) }
+    let(:tracer) { double }
 
-        new_position = result[:position]
-        expect(new_position).not_to be_nil
+    context 'position is on text' do
+      let(:on_text?) { true }
 
-        expect(new_position.diff_refs).to eq(new_diff_refs)
+      it 'calls LineStrategy#trace' do
+        expect(Gitlab::Diff::PositionTracer::LineStrategy)
+          .to receive(:new)
+          .with(subject)
+          .and_return(tracer)
+        expect(tracer).to receive(:trace).with(position)
 
-        attrs.each do |attr, value|
-          if text_position_attrs.include?(attr)
-            expect(new_position.formatter.send(attr)).to eq(value)
-          else
-            expect(new_position.send(attr)).to eq(value)
-          end
-        end
+        subject.trace(position)
+      end
+    end
+
+    context 'position is not on text' do
+      let(:on_text?) { false }
+
+      it 'calls ImageStrategy#trace' do
+        expect(Gitlab::Diff::PositionTracer::ImageStrategy)
+          .to receive(:new)
+          .with(subject)
+          .and_return(tracer)
+        expect(tracer).to receive(:trace).with(position)
+
+        subject.trace(position)
       end
     end
   end
 
-  def expect_change_position(attrs, result = subject)
-    aggregate_failures("expect change position #{attrs.inspect}") do
-      expect(result[:outdated]).to be_truthy
-
-      change_position = result[:position]
-      if attrs.nil? || attrs.empty?
-        expect(change_position).to be_nil
-      else
-        expect(change_position).not_to be_nil
-
-        expect(change_position.diff_refs).to eq(change_diff_refs)
-
-        attrs.each do |attr, value|
-          if text_position_attrs.include?(attr)
-            expect(change_position.formatter.send(attr)).to eq(value)
-          else
-            expect(change_position.send(attr)).to eq(value)
-          end
-        end
-      end
-    end
-  end
-
-  def create_branch(new_name, branch_name)
-    CreateBranchService.new(project, current_user).execute(new_name, branch_name)
-  end
-
-  def create_file(branch_name, file_name, content)
-    Files::CreateService.new(
-      project,
-      current_user,
-      start_branch: branch_name,
-      branch_name: branch_name,
-      commit_message: "Create file",
-      file_path: file_name,
-      file_content: content
-    ).execute
-    project.commit(branch_name)
-  end
-
-  def update_file(branch_name, file_name, content)
-    Files::UpdateService.new(
-      project,
-      current_user,
-      start_branch: branch_name,
-      branch_name: branch_name,
-      commit_message: "Update file",
-      file_path: file_name,
-      file_content: content
-    ).execute
-    project.commit(branch_name)
-  end
-
-  def delete_file(branch_name, file_name)
-    Files::DeleteService.new(
-      project,
-      current_user,
-      start_branch: branch_name,
-      branch_name: branch_name,
-      commit_message: "Delete file",
-      file_path: file_name
-    ).execute
-    project.commit(branch_name)
-  end
-
-  let(:initial_commit) do
-    create_branch(branch_name, "master")[:branch].name
-    project.commit(branch_name)
-  end
-
-  describe "#trace" do
-    describe "diff scenarios" do
-      let(:create_file_commit) do
-        initial_commit
-
-        create_file(
-          branch_name,
-          file_name,
-          <<-CONTENT.strip_heredoc
-            A
-            B
-            C
-          CONTENT
-        )
-      end
-
-      let(:create_second_file_commit) do
-        create_file_commit
-
-        create_file(
-          branch_name,
-          second_file_name,
-          <<-CONTENT.strip_heredoc
-            D
-            E
-          CONTENT
-        )
-      end
-
-      let(:update_line_commit) do
-        create_second_file_commit
-
-        update_file(
-          branch_name,
-          file_name,
-          <<-CONTENT.strip_heredoc
-            A
-            BB
-            C
-          CONTENT
-        )
-      end
-
-      let(:update_second_file_line_commit) do
-        update_line_commit
-
-        update_file(
-          branch_name,
-          second_file_name,
-          <<-CONTENT.strip_heredoc
-            D
-            EE
-          CONTENT
-        )
-      end
-
-      let(:move_line_commit) do
-        update_second_file_line_commit
-
-        update_file(
-          branch_name,
-          file_name,
-          <<-CONTENT.strip_heredoc
-            BB
-            A
-            C
-          CONTENT
-        )
-      end
-
-      let(:add_second_file_line_commit) do
-        move_line_commit
-
-        update_file(
-          branch_name,
-          second_file_name,
-          <<-CONTENT.strip_heredoc
-            D
-            EE
-            F
-          CONTENT
-        )
-      end
-
-      let(:move_second_file_line_commit) do
-        add_second_file_line_commit
-
-        update_file(
-          branch_name,
-          second_file_name,
-          <<-CONTENT.strip_heredoc
-            D
-            F
-            EE
-          CONTENT
-        )
-      end
-
-      let(:delete_line_commit) do
-        move_second_file_line_commit
-
-        update_file(
-          branch_name,
-          file_name,
-          <<-CONTENT.strip_heredoc
-            BB
-            A
-          CONTENT
-        )
-      end
-
-      let(:delete_second_file_line_commit) do
-        delete_line_commit
-
-        update_file(
-          branch_name,
-          second_file_name,
-          <<-CONTENT.strip_heredoc
-            D
-            F
-          CONTENT
-        )
-      end
-
-      let(:delete_file_commit) do
-        delete_second_file_line_commit
-
-        delete_file(branch_name, file_name)
-      end
-
-      let(:rename_file_commit) do
-        delete_file_commit
-
-        create_file(
-          branch_name,
-          new_file_name,
-          <<-CONTENT.strip_heredoc
-            BB
-            A
-          CONTENT
-        )
-      end
-
-      let(:update_line_again_commit) do
-        rename_file_commit
-
-        update_file(
-          branch_name,
-          new_file_name,
-          <<-CONTENT.strip_heredoc
-            BB
-            AA
-          CONTENT
-        )
-      end
-
-      let(:move_line_again_commit) do
-        update_line_again_commit
-
-        update_file(
-          branch_name,
-          new_file_name,
-          <<-CONTENT.strip_heredoc
-            AA
-            BB
-          CONTENT
-        )
-      end
-
-      let(:delete_line_again_commit) do
-        move_line_again_commit
-
-        update_file(
-          branch_name,
-          new_file_name,
-          <<-CONTENT.strip_heredoc
-            AA
-          CONTENT
-        )
-      end
-
-      context "when the file was created in the old diff" do
-        context "when the file is created in the new diff" do
-          context "when the position pointed at an added line in the old diff" do
-            context "when the file's content was unchanged between the old and the new diff" do
-              let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
-              let(:new_diff_refs) { diff_refs(initial_commit, create_second_file_commit) }
-              let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-              # old diff:
-              #   1 + A
-              #   2 + B
-              #   3 + C
-              #
-              # new diff:
-              #   1 + A
-              #   2 + B
-              #   3 + C
-
-              it "returns the new position" do
-                expect_new_position(
-                  new_path: old_position.new_path,
-                  new_line: old_position.new_line
-                )
-              end
-            end
-
-            context "when the file's content was changed between the old and the new diff" do
-              context "when that line was unchanged between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
-                let(:new_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 1) }
-
-                # old diff:
-                #   1 + A
-                #   2 + B
-                #   3 + C
-                #
-                # new diff:
-                #   1 + A
-                #   2 + BB
-                #   3 + C
-
-                it "returns the new position" do
-                  expect_new_position(
-                    new_path: old_position.new_path,
-                    new_line: old_position.new_line
-                  )
-                end
-              end
-
-              context "when that line was moved between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-                let(:new_diff_refs) { diff_refs(initial_commit, move_line_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-                # old diff:
-                #   1 + A
-                #   2 + BB
-                #   3 + C
-                #
-                # new diff:
-                #   1 + BB
-                #   2 + A
-                #   3 + C
-
-                it "returns the new position" do
-                  expect_new_position(
-                    new_path: old_position.new_path,
-                    new_line: 1
-                  )
-                end
-              end
-
-              context "when that line was changed between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
-                let(:new_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-                let(:change_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-                # old diff:
-                #   1 + A
-                #   2 + B
-                #   3 + C
-                #
-                # new diff:
-                #   1 + A
-                #   2 + BB
-                #   3 + C
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: 2,
-                    new_line: nil
-                  )
-                end
-              end
-
-              context "when that line was deleted between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-                let(:new_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
-                let(:change_diff_refs) { diff_refs(update_line_commit, delete_line_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 3) }
-
-                # old diff:
-                #   1 + A
-                #   2 + BB
-                #   3 + C
-                #
-                # new diff:
-                #   1 + A
-                #   2 + BB
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: 3,
-                    new_line: nil
-                  )
-                end
-              end
-            end
-          end
-        end
-
-        context "when the file is changed in the new diff" do
-          context "when the position pointed at an added line in the old diff" do
-            context "when the file's content was unchanged between the old and the new diff" do
-              let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-              let(:new_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
-              let(:old_position) { position(new_path: file_name, new_line: 1) }
-
-              # old diff:
-              #   1 + A
-              #   2 + BB
-              #   3 + C
-              #
-              # new diff:
-              # 1 1   A
-              # 2   - B
-              #   2 + BB
-              # 3 3   C
-
-              it "returns the new position" do
-                expect_new_position(
-                  new_path: old_position.new_path,
-                  new_line: old_position.new_line
-                )
-              end
-            end
-
-            context "when the file's content was changed between the old and the new diff" do
-              context "when that line was unchanged between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-                let(:new_diff_refs) { diff_refs(update_line_commit, move_line_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 3) }
-
-                # old diff:
-                #   1 + A
-                #   2 + BB
-                #   3 + C
-                #
-                # new diff:
-                # 1   - A
-                # 2 1   BB
-                #   2 + A
-                # 3 3   C
-
-                it "returns the new position" do
-                  expect_new_position(
-                    new_path: old_position.new_path,
-                    new_line: old_position.new_line
-                  )
-                end
-              end
-
-              context "when that line was moved between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-                let(:new_diff_refs) { diff_refs(update_line_commit, move_line_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-                # old diff:
-                #   1 + A
-                #   2 + BB
-                #   3 + C
-                #
-                # new diff:
-                # 1   - A
-                # 2 1   BB
-                #   2 + A
-                # 3 3   C
-
-                it "returns the new position" do
-                  expect_new_position(
-                    new_path: old_position.new_path,
-                    new_line: 1
-                  )
-                end
-              end
-
-              context "when that line was changed between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
-                let(:new_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
-                let(:change_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-                # old diff:
-                #   1 + A
-                #   2 + B
-                #   3 + C
-                #
-                # new diff:
-                # 1 1   A
-                # 2   - B
-                #   2 + BB
-                # 3 3   C
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: 2,
-                    new_line: nil
-                  )
-                end
-              end
-
-              context "when that line was deleted between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, move_line_commit) }
-                let(:new_diff_refs) { diff_refs(move_line_commit, delete_line_commit) }
-                let(:change_diff_refs) { diff_refs(move_line_commit, delete_line_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 3) }
-
-                # old diff:
-                #   1 + BB
-                #   2 + A
-                #   3 + C
-                #
-                # new diff:
-                # 1 1   BB
-                # 2 2   A
-                # 3   - C
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: 3,
-                    new_line: nil
-                  )
-                end
-              end
-            end
-          end
-        end
-
-        context "when the file is renamed in the new diff" do
-          context "when the position pointed at an added line in the old diff" do
-            context "when the file's content was unchanged between the old and the new diff" do
-              let(:old_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
-              let(:new_diff_refs) { diff_refs(delete_line_commit, rename_file_commit) }
-              let(:change_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
-              let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-              # old diff:
-              #   1 + BB
-              #   2 + A
-              #
-              # new diff:
-              # file_name -> new_file_name
-              # 1 1   BB
-              # 2 2   A
-
-              it "returns the position of the change" do
-                expect_change_position(
-                  old_path: file_name,
-                  new_path: file_name,
-                  old_line: nil,
-                  new_line: 2
-                )
-              end
-            end
-
-            context "when the file's content was changed between the old and the new diff" do
-              context "when that line was unchanged between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
-                let(:new_diff_refs) { diff_refs(delete_line_commit, update_line_again_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 1) }
-
-                # old diff:
-                #   1 + BB
-                #   2 + A
-                #
-                # new diff:
-                # file_name -> new_file_name
-                # 1 1   BB
-                # 2   - A
-                #   2 + AA
-
-                it "returns the new position" do
-                  expect_new_position(
-                    old_path: file_name,
-                    new_path: new_file_name,
-                    old_line: old_position.new_line,
-                    new_line: old_position.new_line
-                  )
-                end
-              end
-
-              context "when that line was moved between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
-                let(:new_diff_refs) { diff_refs(delete_line_commit, move_line_again_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 1) }
-
-                # old diff:
-                #   1 + BB
-                #   2 + A
-                #
-                # new diff:
-                # file_name -> new_file_name
-                #   1 + AA
-                # 1 2   BB
-                # 2   - A
-
-                it "returns the new position" do
-                  expect_new_position(
-                    old_path: file_name,
-                    new_path: new_file_name,
-                    old_line: 1,
-                    new_line: 2
-                  )
-                end
-              end
-
-              context "when that line was changed between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
-                let(:new_diff_refs) { diff_refs(delete_line_commit, update_line_again_commit) }
-                let(:change_diff_refs) { diff_refs(delete_line_commit, update_line_again_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-                # old diff:
-                #   1 + BB
-                #   2 + A
-                #
-                # new diff:
-                # file_name -> new_file_name
-                # 1 1   BB
-                # 2   - A
-                #   2 + AA
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: new_file_name,
-                    old_line: 2,
-                    new_line: nil
-                  )
-                end
-              end
-            end
-          end
-        end
-
-        context "when the file is deleted in the new diff" do
-          context "when the position pointed at an added line in the old diff" do
-            context "when the file's content was unchanged between the old and the new diff" do
-              let(:old_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
-              let(:new_diff_refs) { diff_refs(delete_line_commit, delete_file_commit) }
-              let(:change_diff_refs) { diff_refs(delete_line_commit, delete_file_commit) }
-              let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-              # old diff:
-              #   1 + BB
-              #   2 + A
-              #
-              # new diff:
-              # 1   - BB
-              # 2   - A
-
-              it "returns the position of the change" do
-                expect_change_position(
-                  old_path: file_name,
-                  new_path: file_name,
-                  old_line: 2,
-                  new_line: nil
-                )
-              end
-            end
-
-            context "when the file's content was changed between the old and the new diff" do
-              context "when that line was unchanged between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, move_line_commit) }
-                let(:new_diff_refs) { diff_refs(delete_line_commit, delete_file_commit) }
-                let(:change_diff_refs) { diff_refs(move_line_commit, delete_file_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-                # old diff:
-                #   1 + BB
-                #   2 + A
-                #   3 + C
-                #
-                # new diff:
-                # 1   - BB
-                # 2   - A
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: 2,
-                    new_line: nil
-                  )
-                end
-              end
-
-              context "when that line was moved between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-                let(:new_diff_refs) { diff_refs(move_line_commit, delete_file_commit) }
-                let(:change_diff_refs) { diff_refs(update_line_commit, delete_file_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-                # old diff:
-                #   1 + A
-                #   2 + BB
-                #   3 + C
-                #
-                # new diff:
-                # 1   - BB
-                # 2   - A
-                # 3   - C
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: 2,
-                    new_line: nil
-                  )
-                end
-              end
-
-              context "when that line was changed between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
-                let(:new_diff_refs) { diff_refs(update_line_commit, delete_file_commit) }
-                let(:change_diff_refs) { diff_refs(create_file_commit, delete_file_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-                # old diff:
-                #   1 + A
-                #   2 + B
-                #   3 + C
-                #
-                # new diff:
-                # 1   - A
-                # 2   - BB
-                # 3   - C
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: 2,
-                    new_line: nil
-                  )
-                end
-              end
-
-              context "when that line was deleted between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, move_line_commit) }
-                let(:new_diff_refs) { diff_refs(delete_line_commit, delete_file_commit) }
-                let(:change_diff_refs) { diff_refs(move_line_commit, delete_file_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 3) }
-
-                # old diff:
-                #   1 + BB
-                #   2 + A
-                #   3 + C
-                #
-                # new diff:
-                # 1   - BB
-                # 2   - A
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: 3,
-                    new_line: nil
-                  )
-                end
-              end
-            end
-          end
-        end
-
-        context "when the file is unchanged in the new diff" do
-          context "when the position pointed at an added line in the old diff" do
-            context "when the file's content was unchanged between the old and the new diff" do
-              let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
-              let(:new_diff_refs) { diff_refs(create_file_commit, create_second_file_commit) }
-              let(:change_diff_refs) { diff_refs(initial_commit, create_file_commit) }
-              let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-              # old diff:
-              #   1 + A
-              #   2 + B
-              #   3 + C
-              #
-              # new diff:
-              # 1 1   A
-              # 2 2   B
-              # 3 3   C
-
-              it "returns the position of the change" do
-                expect_change_position(
-                  old_path: file_name,
-                  new_path: file_name,
-                  old_line: nil,
-                  new_line: 2
-                )
-              end
-            end
-
-            context "when the file's content was changed between the old and the new diff" do
-              context "when that line was unchanged between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
-                let(:new_diff_refs) { diff_refs(update_line_commit, update_second_file_line_commit) }
-                let(:change_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 1) }
-
-                # old diff:
-                #   1 + A
-                #   2 + B
-                #   3 + C
-                #
-                # new diff:
-                # 1 1   A
-                # 2 2   BB
-                # 3 3   C
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: nil,
-                    new_line: 1
-                  )
-                end
-              end
-
-              context "when that line was moved between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-                let(:new_diff_refs) { diff_refs(move_line_commit, move_second_file_line_commit) }
-                let(:change_diff_refs) { diff_refs(initial_commit, move_line_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-                # old diff:
-                #   1 + A
-                #   2 + BB
-                #   3 + C
-                #
-                # new diff:
-                # 1 1   BB
-                # 2 2   A
-                # 3 3   C
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: nil,
-                    new_line: 1
-                  )
-                end
-              end
-
-              context "when that line was changed between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, create_file_commit) }
-                let(:new_diff_refs) { diff_refs(update_line_commit, update_second_file_line_commit) }
-                let(:change_diff_refs) { diff_refs(create_file_commit, update_second_file_line_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 2) }
-
-                # old diff:
-                #   1 + A
-                #   2 + B
-                #   3 + C
-                #
-                # new diff:
-                # 1 1   A
-                # 2 2   BB
-                # 3 3   C
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: 2,
-                    new_line: nil
-                  )
-                end
-              end
-
-              context "when that line was deleted between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(initial_commit, move_line_commit) }
-                let(:new_diff_refs) { diff_refs(delete_line_commit, delete_second_file_line_commit) }
-                let(:change_diff_refs) { diff_refs(move_line_commit, delete_second_file_line_commit) }
-                let(:old_position) { position(new_path: file_name, new_line: 3) }
-
-                # old diff:
-                #   1 + BB
-                #   2 + A
-                #   3 + C
-                #
-                # new diff:
-                # 1 1   BB
-                # 2 2   A
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: 3,
-                    new_line: nil
-                  )
-                end
-              end
-            end
-          end
-        end
-      end
-
-      context "when the file was changed in the old diff" do
-        context "when the file is created in the new diff" do
-          context "when the position pointed at an added line in the old diff" do
-            context "when the file's content was unchanged between the old and the new diff" do
-              let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
-              let(:new_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-              let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 2) }
-
-              # old diff:
-              # 1 1   A
-              # 2   - B
-              #   2 + BB
-              # 3 3   C
-              #
-              # new diff:
-              #   1 + A
-              #   2 + BB
-              #   3 + C
-
-              it "returns the new position" do
-                expect_new_position(
-                  new_path: old_position.new_path,
-                  old_line: nil,
-                  new_line: old_position.new_line
-                )
-              end
-            end
-
-            context "when the file's content was changed between the old and the new diff" do
-              context "when that line was unchanged between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(create_file_commit, move_line_commit) }
-                let(:new_diff_refs) { diff_refs(initial_commit, move_line_commit) }
-                let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 1) }
-
-                # old diff:
-                #   1 + BB
-                # 1 2   A
-                # 2   - B
-                # 3 3   C
-                #
-                # new diff:
-                #   1 + BB
-                #   2 + A
-
-                it "returns the new position" do
-                  expect_new_position(
-                    new_path: old_position.new_path,
-                    old_line: nil,
-                    new_line: old_position.new_line
-                  )
-                end
-              end
-
-              context "when that line was moved between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
-                let(:new_diff_refs) { diff_refs(initial_commit, move_line_commit) }
-                let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 2) }
-
-                # old diff:
-                # 1 1   A
-                # 2   - B
-                #   2 + BB
-                # 3 3   C
-                #
-                # new diff:
-                #   1 + BB
-                #   2 + A
-                #   3 + C
-
-                it "returns the new position" do
-                  expect_new_position(
-                    new_path: old_position.new_path,
-                    old_line: nil,
-                    new_line: 1
-                  )
-                end
-              end
-
-              context "when that line was changed or deleted between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(create_file_commit, move_line_commit) }
-                let(:new_diff_refs) { diff_refs(initial_commit, create_file_commit) }
-                let(:change_diff_refs) { diff_refs(move_line_commit, create_file_commit) }
-                let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 1) }
-
-                # old diff:
-                #   1 + BB
-                # 1 2   A
-                # 2   - B
-                # 3 3   C
-                #
-                # new diff:
-                #   1 + A
-                #   2 + B
-                #   3 + C
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: 1,
-                    new_line: nil
-                  )
-                end
-              end
-            end
-          end
-
-          context "when the position pointed at a deleted line in the old diff" do
-            let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
-            let(:new_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-            let(:change_diff_refs) { diff_refs(create_file_commit, initial_commit) }
-            let(:old_position) { position(old_path: file_name, new_path: file_name, old_line: 2) }
-
-            # old diff:
-            # 1 1   A
-            # 2   - B
-            #   2 + BB
-            # 3 3   C
-            #
-            # new diff:
-            #   1 + A
-            #   2 + BB
-            #   3 + C
-
-            it "returns the position of the change" do
-              expect_change_position(
-                old_path: file_name,
-                new_path: file_name,
-                old_line: 2,
-                new_line: nil
-              )
-            end
-          end
-
-          context "when the position pointed at an unchanged line in the old diff" do
-            context "when the file's content was unchanged between the old and the new diff" do
-              let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
-              let(:new_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-              let(:old_position) { position(old_path: file_name, new_path: file_name, old_line: 1, new_line: 1) }
-
-              # old diff:
-              # 1 1   A
-              # 2   - B
-              #   2 + BB
-              # 3 3   C
-              #
-              # new diff:
-              #   1 + A
-              #   2 + BB
-              #   3 + C
-
-              it "returns the new position" do
-                expect_new_position(
-                  new_path: old_position.new_path,
-                  old_line: nil,
-                  new_line: old_position.new_line
-                )
-              end
-            end
-
-            context "when the file's content was changed between the old and the new diff" do
-              context "when that line was unchanged between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(create_file_commit, move_line_commit) }
-                let(:new_diff_refs) { diff_refs(initial_commit, move_line_commit) }
-                let(:old_position) { position(old_path: file_name, new_path: file_name, old_line: 1, new_line: 2) }
-
-                # old diff:
-                #   1 + BB
-                # 1 2   A
-                # 2   - B
-                # 3 3   C
-                #
-                # new diff:
-                #   1 + BB
-                #   2 + A
-
-                it "returns the new position" do
-                  expect_new_position(
-                    new_path: old_position.new_path,
-                    old_line: nil,
-                    new_line: old_position.new_line
-                  )
-                end
-              end
-
-              context "when that line was moved between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(move_line_commit, delete_line_commit) }
-                let(:new_diff_refs) { diff_refs(initial_commit, update_line_commit) }
-                let(:old_position) { position(old_path: file_name, new_path: file_name, old_line: 2, new_line: 2) }
-
-                # old diff:
-                # 1 1   BB
-                # 2 2   A
-                # 3   - C
-                #
-                # new diff:
-                #   1 + A
-                #   2 + BB
-                #   3 + C
-
-                it "returns the new position" do
-                  expect_new_position(
-                    new_path: old_position.new_path,
-                    old_line: nil,
-                    new_line: 1
-                  )
-                end
-              end
-
-              context "when that line was changed or deleted between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(create_file_commit, move_line_commit) }
-                let(:new_diff_refs) { diff_refs(initial_commit, delete_line_commit) }
-                let(:change_diff_refs) { diff_refs(move_line_commit, delete_line_commit) }
-                let(:old_position) { position(old_path: file_name, new_path: file_name, old_line: 3, new_line: 3) }
-
-                # old diff:
-                #   1 + BB
-                # 1 2   A
-                # 2   - B
-                # 3 3   C
-                #
-                # new diff:
-                #   1 + A
-                #   2 + B
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: 3,
-                    new_line: nil
-                  )
-                end
-              end
-            end
-          end
-        end
-
-        context "when the file is changed in the new diff" do
-          context "when the position pointed at an added line in the old diff" do
-            context "when the file's content was unchanged between the old and the new diff" do
-              let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
-              let(:new_diff_refs) { diff_refs(create_file_commit, update_second_file_line_commit) }
-              let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 2) }
-
-              # old diff:
-              # 1 1   A
-              # 2   - B
-              #   2 + BB
-              # 3 3   C
-              #
-              # new diff:
-              # 1 1   A
-              # 2   - B
-              #   2 + BB
-              # 3 3   C
-
-              it "returns the new position" do
-                expect_new_position(
-                  old_path: old_position.old_path,
-                  new_path: old_position.new_path,
-                  old_line: nil,
-                  new_line: old_position.new_line
-                )
-              end
-            end
-
-            context "when the file's content was changed between the old and the new diff" do
-              context "when that line was unchanged between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(create_file_commit, move_line_commit) }
-                let(:new_diff_refs) { diff_refs(move_line_commit, delete_line_commit) }
-                let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 1) }
-
-                # old diff:
-                #   1 + BB
-                # 1 2   A
-                # 2   - B
-                # 3 3   C
-                #
-                # new diff:
-                # 1 1   BB
-                # 2 2   A
-                # 3   - C
-
-                it "returns the new position" do
-                  expect_new_position(
-                    old_path: old_position.old_path,
-                    new_path: old_position.new_path,
-                    old_line: 1,
-                    new_line: 1
-                  )
-                end
-              end
-
-              context "when that line was moved between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
-                let(:new_diff_refs) { diff_refs(update_line_commit, move_line_commit) }
-                let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 2) }
-
-                # old diff:
-                # 1 1   A
-                # 2   - B
-                #   2 + BB
-                # 3 3   C
-                #
-                # new diff:
-                # 1   - A
-                # 2 1   BB
-                #   2 + A
-                # 3 3   C
-
-                it "returns the new position" do
-                  expect_new_position(
-                    old_path: old_position.old_path,
-                    new_path: old_position.new_path,
-                    old_line: 2,
-                    new_line: 1
-                  )
-                end
-              end
-
-              context "when that line was changed or deleted between the old and the new diff" do
-                let(:old_diff_refs) { diff_refs(create_file_commit, move_line_commit) }
-                let(:new_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
-                let(:change_diff_refs) { diff_refs(move_line_commit, update_line_commit) }
-                let(:old_position) { position(old_path: file_name, new_path: file_name, new_line: 1) }
-
-                # old diff:
-                #   1 + BB
-                # 1 2   A
-                # 2   - B
-                # 3 3   C
-                #
-                # new diff:
-                # 1 1   A
-                # 2   - B
-                #   2 + BB
-                # 3 3   C
-
-                it "returns the position of the change" do
-                  expect_change_position(
-                    old_path: file_name,
-                    new_path: file_name,
-                    old_line: 1,
-                    new_line: nil
-                  )
-                end
-              end
-            end
-          end
-
-          context "when the position pointed at a deleted line in the old diff" do
-            context "when the file's content was unchanged between the old and the new diff" do
-              let(:old_diff_refs) { diff_refs(create_file_commit, update_line_commit) }
-              let(:new_diff_refs) { diff_refs(create_file_commit, update_second_file_line_commit) }
-              let(:old_position) { position(old_path: file_name, new_path: file_name, old_line: 2) }
-
-              # old diff:
-              # 1 1   A
-              # 2   - B
-              #   2 + BB
-              # 3 3   C
-              #
-              # new diff:
-              # 1 1   A
-              # 2   - B
-              #   2 + BB
-              # 3 3   C
-
-              it "returns the new position" do
-                expect_new_position(
-                  old_path: old_position.old_path,
-                  new_path: old_position.new_path,
-                  old_line: old_position.old_line,
-                  new_line: nil
-                )
-              end
-            end
-          end
-        end
-      end
-    end
-  end
-
-  describe "typical use scenarios" do
-    let(:second_branch_name) { "#{branch_name}-2" }
-
-    def expect_new_positions(old_attrs, new_attrs)
-      old_positions = old_attrs.map do |old_attrs|
-        position(old_attrs)
-      end
-
-      new_positions = old_positions.map do |old_position|
-        position_tracer.trace(old_position)
-      end
-
-      aggregate_failures do
-        new_positions.zip(new_attrs).each do |new_position, new_attrs|
-          if new_attrs&.delete(:change)
-            expect_change_position(new_attrs, new_position)
-          else
-            expect_new_position(new_attrs, new_position)
-          end
-        end
-      end
-    end
-
-    let(:create_file_commit) do
-      initial_commit
-
-      create_file(
-        branch_name,
-        file_name,
-        <<-CONTENT.strip_heredoc
-          A
-          B
-          C
-          D
-          E
-          F
-        CONTENT
+  describe 'diffs methods' do
+    let(:project) { create(:project, :repository) }
+    let(:current_user) { project.owner }
+
+    let(:old_diff_refs) do
+      diff_refs(
+        project.commit(create_branch('new-branch', 'master')[:branch].name),
+        create_file('new-branch', 'file.md', 'content')
       )
     end
 
-    let(:second_create_file_commit) do
-      create_file_commit
-
-      create_branch(second_branch_name, branch_name)
-
-      update_file(
-        second_branch_name,
-        file_name,
-        <<-CONTENT.strip_heredoc
-          Z
-          Z
-          Z
-          A
-          B
-          C
-          D
-          E
-          F
-        CONTENT
+    let(:new_diff_refs) do
+      diff_refs(
+        create_file('new-branch', 'file.md', 'content'),
+        update_file('new-branch', 'file.md', 'updatedcontent')
       )
     end
 
-    let(:update_file_commit) do
-      second_create_file_commit
+    describe '#ac_diffs' do
+      it 'returns the diffs between the base of old and new diff' do
+        diff_refs = subject.ac_diffs.diff_refs
 
-      update_file(
-        branch_name,
-        file_name,
-        <<-CONTENT.strip_heredoc
-          A
-          C
-          DD
-          E
-          F
-          G
-        CONTENT
-      )
-    end
-
-    let(:update_file_again_commit) do
-      update_file_commit
-
-      update_file(
-        branch_name,
-        file_name,
-        <<-CONTENT.strip_heredoc
-          A
-          BB
-          C
-          D
-          E
-          FF
-          G
-        CONTENT
-      )
-    end
-
-    describe "simple push of new commit" do
-      let(:old_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
-      let(:new_diff_refs) { diff_refs(create_file_commit, update_file_again_commit) }
-      let(:change_diff_refs) { diff_refs(update_file_commit, update_file_again_commit) }
-
-      # old diff:
-      # 1 1   A
-      # 2   - B
-      # 3 2   C
-      # 4   - D
-      #   3 + DD
-      # 5 4   E
-      # 6 5   F
-      #   6 + G
-      #
-      # new diff:
-      # 1 1   A
-      # 2   - B
-      #   2 + BB
-      # 3 3   C
-      # 4 4   D
-      # 5 5   E
-      # 6   - F
-      #   6 + FF
-      #   7 + G
-
-      it "returns the new positions" do
-        old_position_attrs = [
-          { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 }, #   A
-          { old_path: file_name,                      old_line: 2              }, # - B
-          { old_path: file_name, new_path: file_name, old_line: 3, new_line: 2 }, #   C
-          { old_path: file_name,                      old_line: 4              }, # - D
-          {                      new_path: file_name,              new_line: 3 }, # + DD
-          { old_path: file_name, new_path: file_name, old_line: 5, new_line: 4 }, #   E
-          { old_path: file_name, new_path: file_name, old_line: 6, new_line: 5 }, #   F
-          {                      new_path: file_name,              new_line: 6 }, # + G
-        ]
-
-        new_position_attrs = [
-          { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 },
-          { old_path: file_name,                      old_line: 2              },
-          { old_path: file_name, new_path: file_name, old_line: 3, new_line: 3 },
-          {                      new_path: file_name,              new_line: 4,   change: true },
-          {                      new_path: file_name, old_line: 3,                change: true },
-          { old_path: file_name, new_path: file_name, old_line: 5, new_line: 5 },
-          {                      new_path: file_name, old_line: 5, change: true },
-          {                      new_path: file_name, new_line: 7 }
-        ]
-
-        expect_new_positions(old_position_attrs, new_position_attrs)
+        expect(diff_refs.base_sha).to eq(old_diff_refs.base_sha)
+        expect(diff_refs.start_sha).to eq(old_diff_refs.base_sha)
+        expect(diff_refs.head_sha).to eq(new_diff_refs.base_sha)
       end
     end
 
-    describe "force push to overwrite last commit" do
-      let(:second_create_file_commit) do
-        create_file_commit
+    describe '#bd_diffs' do
+      it 'returns the diffs between the HEAD of old and new diff' do
+        diff_refs = subject.bd_diffs.diff_refs
 
-        create_branch(second_branch_name, branch_name)
-
-        update_file(
-          second_branch_name,
-          file_name,
-          <<-CONTENT.strip_heredoc
-            A
-            BB
-            C
-            D
-            E
-            FF
-            G
-          CONTENT
-        )
-      end
-
-      let(:old_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
-      let(:new_diff_refs) { diff_refs(create_file_commit, second_create_file_commit) }
-      let(:change_diff_refs) { diff_refs(update_file_commit, second_create_file_commit) }
-
-      # old diff:
-      # 1 1   A
-      # 2   - B
-      # 3 2   C
-      # 4   - D
-      #   3 + DD
-      # 5 4   E
-      # 6 5   F
-      #   6 + G
-      #
-      # new diff:
-      # 1 1   A
-      # 2   - B
-      #   2 + BB
-      # 3 3   C
-      # 4 4   D
-      # 5 5   E
-      # 6   - F
-      #   6 + FF
-      #   7 + G
-
-      it "returns the new positions" do
-        old_position_attrs = [
-          { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 }, #   A
-          { old_path: file_name,                      old_line: 2              }, # - B
-          { old_path: file_name, new_path: file_name, old_line: 3, new_line: 2 }, #   C
-          { old_path: file_name,                      old_line: 4              }, # - D
-          {                      new_path: file_name,              new_line: 3 }, # + DD
-          { old_path: file_name, new_path: file_name, old_line: 5, new_line: 4 }, #   E
-          { old_path: file_name, new_path: file_name, old_line: 6, new_line: 5 }, #   F
-          {                      new_path: file_name,              new_line: 6 }, # + G
-        ]
-
-        new_position_attrs = [
-          { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 },
-          { old_path: file_name,                      old_line: 2              },
-          { old_path: file_name, new_path: file_name, old_line: 3, new_line: 3 },
-          {                      new_path: file_name,              new_line: 4,   change: true },
-          { old_path: file_name,                      old_line: 3,                change: true },
-          { old_path: file_name, new_path: file_name, old_line: 5, new_line: 5 },
-          { old_path: file_name,                      old_line: 5, change: true },
-          {                      new_path: file_name,              new_line: 7 }
-        ]
-
-        expect_new_positions(old_position_attrs, new_position_attrs)
+        expect(diff_refs.base_sha).to eq(old_diff_refs.head_sha)
+        expect(diff_refs.start_sha).to eq(old_diff_refs.head_sha)
+        expect(diff_refs.head_sha).to eq(new_diff_refs.head_sha)
       end
     end
 
-    describe "force push to delete last commit" do
-      let(:old_diff_refs) { diff_refs(create_file_commit, update_file_again_commit) }
-      let(:new_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
-      let(:change_diff_refs) { diff_refs(update_file_again_commit, update_file_commit) }
+    describe '#cd_diffs' do
+      it 'returns the diffs in the new diff' do
+        diff_refs = subject.cd_diffs.diff_refs
 
-      # old diff:
-      # 1 1   A
-      # 2   - B
-      #   2 + BB
-      # 3 3   C
-      # 4 4   D
-      # 5 5   E
-      # 6   - F
-      #   6 + FF
-      #   7 + G
-      #
-      # new diff:
-      # 1 1   A
-      # 2   - B
-      # 3 2   C
-      # 4   - D
-      #   3 + DD
-      # 5 4   E
-      # 6 5   F
-      #   6 + G
-
-      it "returns the new positions" do
-        old_position_attrs = [
-          { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 }, #   A
-          { old_path: file_name,                      old_line: 2              }, # - B
-          {                      new_path: file_name,              new_line: 2 }, # + BB
-          { old_path: file_name, new_path: file_name, old_line: 3, new_line: 3 }, #   C
-          { old_path: file_name, new_path: file_name, old_line: 4, new_line: 4 }, #   D
-          { old_path: file_name, new_path: file_name, old_line: 5, new_line: 5 }, #   E
-          { old_path: file_name,                      old_line: 6              }, # - F
-          {                      new_path: file_name,              new_line: 6 }, # + FF
-          {                      new_path: file_name,              new_line: 7 }, # + G
-        ]
-
-        new_position_attrs = [
-          { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 },
-          { old_path: file_name,                      old_line: 2              },
-          { old_path: file_name,                      old_line: 2, change: true },
-          { old_path: file_name, new_path: file_name, old_line: 3, new_line: 2 },
-          { old_path: file_name,                      old_line: 4, change: true },
-          { old_path: file_name, new_path: file_name, old_line: 5, new_line: 4 },
-          {                      new_path: file_name,              new_line: 5, change: true },
-          { old_path: file_name, old_line: 6, change: true },
-          { new_path: file_name, new_line: 6 }
-        ]
-
-        expect_new_positions(old_position_attrs, new_position_attrs)
-      end
-    end
-
-    describe "rebase on top of target branch" do
-      let(:second_update_file_commit) do
-        update_file_commit
-
-        update_file(
-          second_branch_name,
-          file_name,
-          <<-CONTENT.strip_heredoc
-            Z
-            Z
-            Z
-            A
-            C
-            DD
-            E
-            F
-            G
-          CONTENT
-        )
-      end
-
-      let(:update_file_again_commit) do
-        second_update_file_commit
-
-        update_file(
-          branch_name,
-          file_name,
-          <<-CONTENT.strip_heredoc
-            A
-            BB
-            C
-            D
-            E
-            FF
-            G
-          CONTENT
-        )
-      end
-
-      let(:overwrite_update_file_again_commit) do
-        update_file_again_commit
-
-        update_file(
-          second_branch_name,
-          file_name,
-          <<-CONTENT.strip_heredoc
-            Z
-            Z
-            Z
-            A
-            BB
-            C
-            D
-            E
-            FF
-            G
-          CONTENT
-        )
-      end
-
-      let(:old_diff_refs) { diff_refs(create_file_commit, update_file_again_commit) }
-      let(:new_diff_refs) { diff_refs(create_file_commit, overwrite_update_file_again_commit) }
-      let(:change_diff_refs) { diff_refs(update_file_again_commit, overwrite_update_file_again_commit) }
-
-      # old diff:
-      # 1 1   A
-      # 2   - B
-      #   2 + BB
-      # 3 3   C
-      # 4 4   D
-      # 5 5   E
-      # 6   - F
-      #   6 + FF
-      #   7 + G
-      #
-      # new diff:
-      #   1 + Z
-      #   2 + Z
-      #   3 + Z
-      # 1 4   A
-      # 2   - B
-      #   5 + BB
-      # 3 6   C
-      # 4 7   D
-      # 5 8   E
-      # 6   - F
-      #   9 + FF
-      #   0 + G
-
-      it "returns the new positions" do
-        old_position_attrs = [
-          { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 }, #   A
-          { old_path: file_name,                      old_line: 2              }, # - B
-          {                      new_path: file_name,              new_line: 2 }, # + BB
-          { old_path: file_name, new_path: file_name, old_line: 3, new_line: 3 }, #   C
-          { old_path: file_name, new_path: file_name, old_line: 4, new_line: 4 }, #   D
-          { old_path: file_name, new_path: file_name, old_line: 5, new_line: 5 }, #   E
-          { old_path: file_name,                      old_line: 6              }, # - F
-          {                      new_path: file_name,              new_line: 6 }, # + FF
-          {                      new_path: file_name,              new_line: 7 }, # + G
-        ]
-
-        new_position_attrs = [
-          { old_path: file_name, new_path: file_name, old_line: 1, new_line: 4 }, #   A
-          { old_path: file_name,                      old_line: 2              }, # - B
-          {                      new_path: file_name,              new_line: 5 }, # + BB
-          { old_path: file_name, new_path: file_name, old_line: 3, new_line: 6 }, #   C
-          { old_path: file_name, new_path: file_name, old_line: 4, new_line: 7 }, #   D
-          { old_path: file_name, new_path: file_name, old_line: 5, new_line: 8 }, #   E
-          { old_path: file_name,                      old_line: 6              }, # - F
-          {                      new_path: file_name,              new_line: 9 }, # + FF
-          {                      new_path: file_name,              new_line: 10 }, # + G
-        ]
-
-        expect_new_positions(old_position_attrs, new_position_attrs)
-      end
-    end
-
-    describe "merge of target branch" do
-      let(:merge_commit) do
-        second_create_file_commit
-
-        merge_request = create(:merge_request, source_branch: second_branch_name, target_branch: branch_name, source_project: project)
-
-        repository.merge(current_user, merge_request.diff_head_sha, merge_request, "Merge branches")
-
-        project.commit(branch_name)
-      end
-
-      let(:old_diff_refs) { diff_refs(create_file_commit, update_file_again_commit) }
-      let(:new_diff_refs) { diff_refs(create_file_commit, merge_commit) }
-      let(:change_diff_refs) { diff_refs(update_file_again_commit, merge_commit) }
-
-      # old diff:
-      # 1 1   A
-      # 2   - B
-      #   2 + BB
-      # 3 3   C
-      # 4 4   D
-      # 5 5   E
-      # 6   - F
-      #   6 + FF
-      #   7 + G
-      #
-      # new diff:
-      #   1 + Z
-      #   2 + Z
-      #   3 + Z
-      # 1 4   A
-      # 2   - B
-      #   5 + BB
-      # 3 6   C
-      # 4 7   D
-      # 5 8   E
-      # 6   - F
-      #   9 + FF
-      #   0 + G
-
-      it "returns the new positions" do
-        old_position_attrs = [
-          { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 }, #   A
-          { old_path: file_name,                      old_line: 2              }, # - B
-          {                      new_path: file_name,              new_line: 2 }, # + BB
-          { old_path: file_name, new_path: file_name, old_line: 3, new_line: 3 }, #   C
-          { old_path: file_name, new_path: file_name, old_line: 4, new_line: 4 }, #   D
-          { old_path: file_name, new_path: file_name, old_line: 5, new_line: 5 }, #   E
-          { old_path: file_name,                      old_line: 6              }, # - F
-          {                      new_path: file_name,              new_line: 6 }, # + FF
-          {                      new_path: file_name,              new_line: 7 }, # + G
-        ]
-
-        new_position_attrs = [
-          { old_path: file_name, new_path: file_name, old_line: 1, new_line: 4 }, #   A
-          { old_path: file_name,                      old_line: 2              }, # - B
-          {                      new_path: file_name,              new_line: 5 }, # + BB
-          { old_path: file_name, new_path: file_name, old_line: 3, new_line: 6 }, #   C
-          { old_path: file_name, new_path: file_name, old_line: 4, new_line: 7 }, #   D
-          { old_path: file_name, new_path: file_name, old_line: 5, new_line: 8 }, #   E
-          { old_path: file_name,                      old_line: 6              }, # - F
-          {                      new_path: file_name,              new_line: 9 }, # + FF
-          {                      new_path: file_name,              new_line: 10 }, # + G
-        ]
-
-        expect_new_positions(old_position_attrs, new_position_attrs)
-      end
-    end
-
-    describe "changing target branch" do
-      let(:old_diff_refs) { diff_refs(create_file_commit, update_file_again_commit) }
-      let(:new_diff_refs) { diff_refs(update_file_commit, update_file_again_commit) }
-      let(:change_diff_refs) { diff_refs(create_file_commit, update_file_commit) }
-
-      # old diff:
-      # 1 1   A
-      # 2   - B
-      #   2 + BB
-      # 3 3   C
-      # 4 4   D
-      # 5 5   E
-      # 6   - F
-      #   6 + FF
-      #   7 + G
-      #
-      # new diff:
-      # 1 1   A
-      #   2 + BB
-      # 2 3   C
-      # 3   - DD
-      #   4 + D
-      # 4 5   E
-      # 5   - F
-      #   6 + FF
-      #   7   G
-
-      it "returns the new positions" do
-        old_position_attrs = [
-          { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 }, #   A
-          { old_path: file_name,                      old_line: 2              }, # - B
-          {                      new_path: file_name,              new_line: 2 }, # + BB
-          { old_path: file_name, new_path: file_name, old_line: 3, new_line: 3 }, #   C
-          { old_path: file_name, new_path: file_name, old_line: 4, new_line: 4 }, #   D
-          { old_path: file_name, new_path: file_name, old_line: 5, new_line: 5 }, #   E
-          { old_path: file_name,                      old_line: 6              }, # - F
-          {                      new_path: file_name,              new_line: 6 }, # + FF
-          {                      new_path: file_name,              new_line: 7 }, # + G
-        ]
-
-        new_position_attrs = [
-          { old_path: file_name, new_path: file_name, old_line: 1, new_line: 1 },
-          { old_path: file_name,                      old_line: 2, change: true },
-          {                      new_path: file_name,              new_line: 2 },
-          { old_path: file_name, new_path: file_name, old_line: 2, new_line: 3 },
-          {                      new_path: file_name,              new_line: 4 },
-          { old_path: file_name, new_path: file_name, old_line: 4, new_line: 5 },
-          { old_path: file_name,                      old_line: 5              },
-          {                      new_path: file_name,              new_line: 6 },
-          {                      new_path: file_name,              new_line: 7 }
-        ]
-
-        expect_new_positions(old_position_attrs, new_position_attrs)
+        expect(diff_refs.base_sha).to eq(new_diff_refs.base_sha)
+        expect(diff_refs.start_sha).to eq(new_diff_refs.base_sha)
+        expect(diff_refs.head_sha).to eq(new_diff_refs.head_sha)
       end
     end
   end
diff --git a/spec/services/system_note_service_spec.rb b/spec/services/system_note_service_spec.rb
index 9f60e49290e..b934533b1ab 100644
--- a/spec/services/system_note_service_spec.rb
+++ b/spec/services/system_note_service_spec.rb
@@ -1175,16 +1175,30 @@ describe SystemNoteService do
       end
 
       it 'links to the diff in the system note' do
-        expect(subject.note).to include('version 1')
-
         diff_id = merge_request.merge_request_diff.id
         line_code = change_position.line_code(project.repository)
-        expect(subject.note).to include(diffs_project_merge_request_path(project, merge_request, diff_id: diff_id, anchor: line_code))
+        link = diffs_project_merge_request_path(project, merge_request, diff_id: diff_id, anchor: line_code)
+
+        expect(subject.note).to eq("changed this line in [version 1 of the diff](#{link})")
+      end
+
+      context 'discussion is on an image' do
+        let(:discussion) { create(:image_diff_note_on_merge_request, project: project).to_discussion }
+
+        it 'links to the diff in the system note' do
+          diff_id = merge_request.merge_request_diff.id
+          file_hash = change_position.file_hash
+          link = diffs_project_merge_request_path(project, merge_request, diff_id: diff_id, anchor: file_hash)
+
+          expect(subject.note).to eq("changed this file in [version 1 of the diff](#{link})")
+        end
       end
     end
 
-    context 'when the change_position is invalid for the discussion' do
-      let(:change_position) { project.commit(sample_commit.id) }
+    context 'when the change_position does not point to a valid version' do
+      before do
+        allow(merge_request).to receive(:version_params_for).and_return(nil)
+      end
 
       it 'creates a new note in the discussion' do
         # we need to completely rebuild the merge request object, or the `@discussions` on the merge request are not reloaded.
diff --git a/spec/support/helpers/position_tracer_helpers.rb b/spec/support/helpers/position_tracer_helpers.rb
new file mode 100644
index 00000000000..bbf6e06dd40
--- /dev/null
+++ b/spec/support/helpers/position_tracer_helpers.rb
@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module PositionTracerHelpers
+  def diff_refs(base_commit, head_commit)
+    Gitlab::Diff::DiffRefs.new(base_sha: base_commit.id, head_sha: head_commit.id)
+  end
+
+  def position(attrs = {})
+    attrs.reverse_merge!(
+      diff_refs: old_diff_refs
+    )
+    Gitlab::Diff::Position.new(attrs)
+  end
+
+  def expect_new_position(attrs, result = subject)
+    aggregate_failures("expect new position #{attrs.inspect}") do
+      if attrs.nil?
+        expect(result[:outdated]).to be_truthy
+      else
+        new_position = result[:position]
+
+        expect(result[:outdated]).to be_falsey
+        expect(new_position).not_to be_nil
+        expect(new_position.diff_refs).to eq(new_diff_refs)
+
+        attrs.each do |attr, value|
+          expect(new_position.send(attr)).to eq(value)
+        end
+      end
+    end
+  end
+
+  def expect_change_position(attrs, result = subject)
+    aggregate_failures("expect change position #{attrs.inspect}") do
+      change_position = result[:position]
+
+      expect(result[:outdated]).to be_truthy
+
+      if attrs.nil? || attrs.empty?
+        expect(change_position).to be_nil
+      else
+        expect(change_position).not_to be_nil
+        expect(change_position.diff_refs).to eq(change_diff_refs)
+
+        attrs.each do |attr, value|
+          expect(change_position.send(attr)).to eq(value)
+        end
+      end
+    end
+  end
+
+  def create_branch(new_name, branch_name)
+    CreateBranchService.new(project, current_user).execute(new_name, branch_name)
+  end
+
+  def create_file(branch_name, file_name, content)
+    Files::CreateService.new(
+      project,
+      current_user,
+      start_branch: branch_name,
+      branch_name: branch_name,
+      commit_message: "Create file",
+      file_path: file_name,
+      file_content: content
+    ).execute
+    project.commit(branch_name)
+  end
+
+  def update_file(branch_name, file_name, content)
+    Files::UpdateService.new(
+      project,
+      current_user,
+      start_branch: branch_name,
+      branch_name: branch_name,
+      commit_message: "Update file",
+      file_path: file_name,
+      file_content: content
+    ).execute
+    project.commit(branch_name)
+  end
+
+  def delete_file(branch_name, file_name)
+    Files::DeleteService.new(
+      project,
+      current_user,
+      start_branch: branch_name,
+      branch_name: branch_name,
+      commit_message: "Delete file",
+      file_path: file_name
+    ).execute
+    project.commit(branch_name)
+  end
+end

From 77c35d5d001a0ce0626bc8aeec574eca36c2233b Mon Sep 17 00:00:00 2001
From: Phil Hughes <me@iamphill.com>
Date: Fri, 5 Jul 2019 11:14:56 +0100
Subject: [PATCH 099/195] Create private merge requests in forks

https://gitlab.com/gitlab-org/gitlab-ce/issues/58583
---
 .../components/dropdown.vue                   |  58 ++++++++
 .../components/project_form_group.vue         | 136 ++++++++++++++++++
 .../confidential_merge_request/index.js       |  30 ++++
 .../confidential_merge_request/state.js       |   5 +
 .../create_merge_request_dropdown.js          |  47 +++++-
 .../stylesheets/framework/dropdowns.scss      |   4 +-
 .../projects/branches_controller.rb           |   2 +-
 app/controllers/projects/issues_controller.rb |   2 +-
 app/helpers/issues_helper.rb                  |   2 +-
 .../projects/issues/_new_branch.html.haml     |  13 +-
 locale/gitlab.pot                             |  18 +++
 ...creates_confidential_merge_request_spec.rb |  54 +++++++
 .../project_form_group_spec.js.snap           | 101 +++++++++++++
 .../components/dropdown_spec.js               |  56 ++++++++
 .../components/project_form_group_spec.js     |  77 ++++++++++
 .../create_merge_request_dropdown_spec.js     |   9 +-
 16 files changed, 599 insertions(+), 15 deletions(-)
 create mode 100644 app/assets/javascripts/confidential_merge_request/components/dropdown.vue
 create mode 100644 app/assets/javascripts/confidential_merge_request/components/project_form_group.vue
 create mode 100644 app/assets/javascripts/confidential_merge_request/index.js
 create mode 100644 app/assets/javascripts/confidential_merge_request/state.js
 create mode 100644 spec/features/issues/user_creates_confidential_merge_request_spec.rb
 create mode 100644 spec/frontend/confidential_merge_request/components/__snapshots__/project_form_group_spec.js.snap
 create mode 100644 spec/frontend/confidential_merge_request/components/dropdown_spec.js
 create mode 100644 spec/frontend/confidential_merge_request/components/project_form_group_spec.js
 rename spec/{javascripts => frontend}/create_merge_request_dropdown_spec.js (92%)

diff --git a/app/assets/javascripts/confidential_merge_request/components/dropdown.vue b/app/assets/javascripts/confidential_merge_request/components/dropdown.vue
new file mode 100644
index 00000000000..444640980af
--- /dev/null
+++ b/app/assets/javascripts/confidential_merge_request/components/dropdown.vue
@@ -0,0 +1,58 @@
+<script>
+import { GlDropdown, GlDropdownItem } from '@gitlab/ui';
+import { __ } from '~/locale';
+import Icon from '~/vue_shared/components/icon.vue';
+
+export default {
+  components: {
+    GlDropdown,
+    GlDropdownItem,
+    Icon,
+  },
+  props: {
+    projects: {
+      type: Array,
+      required: true,
+    },
+    selectedProject: {
+      type: Object,
+      required: false,
+      default: () => ({}),
+    },
+  },
+  computed: {
+    dropdownText() {
+      if (Object.keys(this.selectedProject).length) {
+        return this.selectedProject.name;
+      }
+
+      return __('Select private project');
+    },
+  },
+  methods: {
+    selectProject(project) {
+      this.$emit('click', project);
+    },
+  },
+};
+</script>
+
+<template>
+  <gl-dropdown toggle-class="d-flex align-items-center w-100" class="w-100">
+    <template slot="button-content">
+      <span class="str-truncated-100 mr-2">
+        <icon name="lock" />
+        {{ dropdownText }}
+      </span>
+      <icon name="chevron-down" class="ml-auto" />
+    </template>
+    <gl-dropdown-item v-for="project in projects" :key="project.id" @click="selectProject(project)">
+      <icon
+        name="mobile-issue-close"
+        :class="{ icon: project.id !== selectedProject.id }"
+        class="js-active-project-check"
+      />
+      <span class="ml-1">{{ project.name }}</span>
+    </gl-dropdown-item>
+  </gl-dropdown>
+</template>
diff --git a/app/assets/javascripts/confidential_merge_request/components/project_form_group.vue b/app/assets/javascripts/confidential_merge_request/components/project_form_group.vue
new file mode 100644
index 00000000000..b89729375be
--- /dev/null
+++ b/app/assets/javascripts/confidential_merge_request/components/project_form_group.vue
@@ -0,0 +1,136 @@
+<script>
+import { GlLink } from '@gitlab/ui';
+import { __, sprintf } from '../../locale';
+import createFlash from '../../flash';
+import Api from '../../api';
+import state from '../state';
+import Dropdown from './dropdown.vue';
+
+export default {
+  components: {
+    GlLink,
+    Dropdown,
+  },
+  props: {
+    namespacePath: {
+      type: String,
+      required: true,
+    },
+    projectPath: {
+      type: String,
+      required: true,
+    },
+    newForkPath: {
+      type: String,
+      required: true,
+    },
+    helpPagePath: {
+      type: String,
+      required: true,
+    },
+  },
+  data() {
+    return {
+      projects: [],
+    };
+  },
+  computed: {
+    selectedProject() {
+      return state.selectedProject;
+    },
+    noForkText() {
+      return sprintf(
+        __(
+          'To protect this issues confidentiality, %{link_start}fork the project%{link_end} and set the forks visiblity to private.',
+        ),
+        { link_start: `<a href="${this.newForkPath}" class="help-link">`, link_end: '</a>' },
+        false,
+      );
+    },
+  },
+  mounted() {
+    this.fetchProjects();
+    this.createBtn = document.querySelector('.js-create-target');
+    this.warningText = document.querySelector('.js-exposed-info-warning');
+  },
+  methods: {
+    selectProject(project) {
+      if (project) {
+        Object.assign(state, {
+          selectedProject: project,
+        });
+
+        if (project.namespaceFullPath !== this.namespacePath) {
+          this.showWarning();
+        }
+      } else if (this.createBtn) {
+        this.createBtn.setAttribute('disabled', 'disabled');
+      }
+    },
+    normalizeProjectData(data) {
+      return data.map(p => ({
+        id: p.id,
+        name: p.name_with_namespace,
+        pathWithNamespace: p.path_with_namespace,
+        namespaceFullpath: p.namespace.full_path,
+      }));
+    },
+    fetchProjects() {
+      Api.projectForks(this.projectPath, {
+        with_merge_requests_enabled: true,
+        min_access_level: 30,
+        visibility: 'private',
+      })
+        .then(({ data }) => {
+          this.projects = this.normalizeProjectData(data);
+          this.selectProject(this.projects[0]);
+        })
+        .catch(e => {
+          createFlash(__('Error fetching forked projects. Please try again.'));
+          throw e;
+        });
+    },
+    showWarning() {
+      if (this.warningText) {
+        this.warningText.classList.remove('hidden');
+      }
+
+      if (this.createBtn) {
+        this.createBtn.classList.add('btn-warning');
+        this.createBtn.classList.remove('btn-success');
+      }
+    },
+  },
+};
+</script>
+
+<template>
+  <div class="form-group">
+    <label>{{ __('Project') }}</label>
+    <div>
+      <dropdown
+        v-if="projects.length"
+        :projects="projects"
+        :selected-project="selectedProject"
+        @click="selectProject"
+      />
+      <p class="text-muted mt-1 mb-0">
+        <template v-if="projects.length">
+          {{
+            __(
+              'To protect this issues confidentiality, a private fork of this project was selected.',
+            )
+          }}
+        </template>
+        <template v-else>
+          {{ __('No forks available to you.') }}<br />
+          <span v-html="noForkText"></span>
+        </template>
+        <gl-link :href="helpPagePath" class="help-link" target="_blank">
+          <span class="sr-only">{{ __('Read more') }}</span>
+          <i class="fa fa-question-circle" aria-hidden="true"></i>
+        </gl-link>
+      </p>
+    </div>
+  </div>
+</template>
diff --git a/app/assets/javascripts/confidential_merge_request/index.js b/app/assets/javascripts/confidential_merge_request/index.js
new file mode 100644
index 00000000000..9672821d30e
--- /dev/null
+++ b/app/assets/javascripts/confidential_merge_request/index.js
@@ -0,0 +1,30 @@
+import Vue from 'vue';
+import { parseBoolean } from '../lib/utils/common_utils';
+import ProjectFormGroup from './components/project_form_group.vue';
+import state from './state';
+
+export function isConfidentialIssue() {
+  return parseBoolean(document.querySelector('.js-create-mr').dataset.isConfidential);
+}
+
+export function canCreateConfidentialMergeRequest() {
+  return isConfidentialIssue() && Object.keys(state.selectedProject).length > 0;
+}
+
+export function init() {
+  const el = document.getElementById('js-forked-project');
+
+  return new Vue({
+    el,
+    render(h) {
+      return h(ProjectFormGroup, {
+        props: {
+          namespacePath: el.dataset.namespacePath,
+          projectPath: el.dataset.projectPath,
+          newForkPath: el.dataset.newForkPath,
+          helpPagePath: el.dataset.helpPagePath,
+        },
+      });
+    },
+  });
+}
diff --git a/app/assets/javascripts/confidential_merge_request/state.js b/app/assets/javascripts/confidential_merge_request/state.js
new file mode 100644
index 00000000000..95b0580f4b9
--- /dev/null
+++ b/app/assets/javascripts/confidential_merge_request/state.js
@@ -0,0 +1,5 @@
+import Vue from 'vue';
+
+export default Vue.observable({
+  selectedProject: {},
+});
diff --git a/app/assets/javascripts/create_merge_request_dropdown.js b/app/assets/javascripts/create_merge_request_dropdown.js
index 8f5cece0788..052168bb21c 100644
--- a/app/assets/javascripts/create_merge_request_dropdown.js
+++ b/app/assets/javascripts/create_merge_request_dropdown.js
@@ -5,6 +5,12 @@ import Flash from './flash';
 import DropLab from './droplab/drop_lab';
 import ISetter from './droplab/plugins/input_setter';
 import { __, sprintf } from './locale';
+import {
+  init as initConfidentialMergeRequest,
+  isConfidentialIssue,
+  canCreateConfidentialMergeRequest,
+} from './confidential_merge_request';
+import confidentialMergeRequestState from './confidential_merge_request/state';
 
 // Todo: Remove this when fixing issue in input_setter plugin
 const InputSetter = Object.assign({}, ISetter);
@@ -12,6 +18,17 @@ const InputSetter = Object.assign({}, ISetter);
 const CREATE_MERGE_REQUEST = 'create-mr';
 const CREATE_BRANCH = 'create-branch';
 
+function createEndpoint(projectPath, endpoint) {
+  if (canCreateConfidentialMergeRequest()) {
+    return endpoint.replace(
+      projectPath,
+      confidentialMergeRequestState.selectedProject.pathWithNamespace,
+    );
+  }
+
+  return endpoint;
+}
+
 export default class CreateMergeRequestDropdown {
   constructor(wrapperEl) {
     this.wrapperEl = wrapperEl;
@@ -42,6 +59,8 @@ export default class CreateMergeRequestDropdown {
     this.refIsValid = true;
     this.refsPath = this.wrapperEl.dataset.refsPath;
     this.suggestedRef = this.refInput.value;
+    this.projectPath = this.wrapperEl.dataset.projectPath;
+    this.projectId = this.wrapperEl.dataset.projectId;
 
     // These regexps are used to replace
     // a backend generated new branch name and its source (ref)
@@ -58,6 +77,14 @@ export default class CreateMergeRequestDropdown {
     };
 
     this.init();
+
+    if (isConfidentialIssue()) {
+      this.createMergeRequestButton.setAttribute(
+        'data-dropdown-trigger',
+        '#create-merge-request-dropdown',
+      );
+      initConfidentialMergeRequest();
+    }
   }
 
   available() {
@@ -113,7 +140,9 @@ export default class CreateMergeRequestDropdown {
     this.isCreatingBranch = true;
 
     return axios
-      .post(this.createBranchPath)
+      .post(createEndpoint(this.projectPath, this.createBranchPath), {
+        confidential_issue_project_id: canCreateConfidentialMergeRequest() ? this.projectId : null,
+      })
       .then(({ data }) => {
         this.branchCreated = true;
         window.location.href = data.url;
@@ -125,7 +154,11 @@ export default class CreateMergeRequestDropdown {
     this.isCreatingMergeRequest = true;
 
     return axios
-      .post(this.createMrPath)
+      .post(this.createMrPath, {
+        target_project_id: canCreateConfidentialMergeRequest()
+          ? confidentialMergeRequestState.selectedProject.id
+          : null,
+      })
       .then(({ data }) => {
         this.mergeRequestCreated = true;
         window.location.href = data.url;
@@ -149,6 +182,8 @@ export default class CreateMergeRequestDropdown {
   }
 
   enable() {
+    if (!canCreateConfidentialMergeRequest()) return;
+
     this.createMergeRequestButton.classList.remove('disabled');
     this.createMergeRequestButton.removeAttribute('disabled');
 
@@ -205,7 +240,7 @@ export default class CreateMergeRequestDropdown {
     if (!ref) return false;
 
     return axios
-      .get(`${this.refsPath}${encodeURIComponent(ref)}`)
+      .get(`${createEndpoint(this.projectPath, this.refsPath)}${encodeURIComponent(ref)}`)
       .then(({ data }) => {
         const branches = data[Object.keys(data)[0]];
         const tags = data[Object.keys(data)[1]];
@@ -325,6 +360,12 @@ export default class CreateMergeRequestDropdown {
     let xhr = null;
     event.preventDefault();
 
+    if (isConfidentialIssue() && !event.target.classList.contains('js-create-target')) {
+      this.droplab.hooks.forEach(hook => hook.list.toggle());
+
+      return;
+    }
+
     if (this.isBusy()) {
       return;
     }
diff --git a/app/assets/stylesheets/framework/dropdowns.scss b/app/assets/stylesheets/framework/dropdowns.scss
index cd951f67293..a12029d2419 100644
--- a/app/assets/stylesheets/framework/dropdowns.scss
+++ b/app/assets/stylesheets/framework/dropdowns.scss
@@ -287,8 +287,8 @@
     list-style: none;
     padding: 0 1px;
 
-    a,
-    button,
+    a:not(.help-link),
+    button:not(.btn),
     .menu-item {
       @include dropdown-link;
     }
diff --git a/app/controllers/projects/branches_controller.rb b/app/controllers/projects/branches_controller.rb
index d77f64a84f5..141a7dfb923 100644
--- a/app/controllers/projects/branches_controller.rb
+++ b/app/controllers/projects/branches_controller.rb
@@ -169,7 +169,7 @@ class Projects::BranchesController < Projects::ApplicationController
   end
 
   def confidential_issue_project
-    return unless Feature.enabled?(:create_confidential_merge_request, @project)
+    return unless helpers.create_confidential_merge_request_enabled?
     return if params[:confidential_issue_project_id].blank?
 
     confidential_issue_project = Project.find(params[:confidential_issue_project_id])
diff --git a/app/controllers/projects/issues_controller.rb b/app/controllers/projects/issues_controller.rb
index e275b417784..b866f574f67 100644
--- a/app/controllers/projects/issues_controller.rb
+++ b/app/controllers/projects/issues_controller.rb
@@ -172,7 +172,7 @@ class Projects::IssuesController < Projects::ApplicationController
 
   def create_merge_request
     create_params = params.slice(:branch_name, :ref).merge(issue_iid: issue.iid)
-    create_params[:target_project_id] = params[:target_project_id] if Feature.enabled?(:create_confidential_merge_request, @project)
+    create_params[:target_project_id] = params[:target_project_id] if helpers.create_confidential_merge_request_enabled?
     result = ::MergeRequests::CreateFromIssueService.new(project, current_user, create_params).execute
 
     if result[:status] == :success
diff --git a/app/helpers/issues_helper.rb b/app/helpers/issues_helper.rb
index dfadcfc33b2..5476a7cdff6 100644
--- a/app/helpers/issues_helper.rb
+++ b/app/helpers/issues_helper.rb
@@ -137,7 +137,7 @@ module IssuesHelper
   end
 
   def create_confidential_merge_request_enabled?
-    Feature.enabled?(:create_confidential_merge_request, @project)
+    Feature.enabled?(:create_confidential_merge_request, @project, default_enabled: true)
   end
 
   def show_new_branch_button?
diff --git a/app/views/projects/issues/_new_branch.html.haml b/app/views/projects/issues/_new_branch.html.haml
index 52bb797b5b3..8d3e54dc455 100644
--- a/app/views/projects/issues/_new_branch.html.haml
+++ b/app/views/projects/issues/_new_branch.html.haml
@@ -3,13 +3,14 @@
   - data_action = can_create_merge_request ? 'create-mr' : 'create-branch'
   - value = can_create_merge_request ? 'Create merge request' : 'Create branch'
   - value = can_create_confidential_merge_request? ? _('Create confidential merge request') : value
+  - create_mr_text = can_create_confidential_merge_request? ? _('Create confidential merge request') : _('Create merge request')
 
   - can_create_path = can_create_branch_project_issue_path(@project, @issue)
   - create_mr_path = create_merge_request_project_issue_path(@project, @issue, branch_name: @issue.to_branch_name, ref: @project.default_branch)
   - create_branch_path = project_branches_path(@project, branch_name: @issue.to_branch_name, ref: @project.default_branch, issue_iid: @issue.iid)
   - refs_path = refs_namespace_project_path(@project.namespace, @project, search: '')
 
-  .create-mr-dropdown-wrap.d-inline-block.full-width-mobile{ data: { can_create_path: can_create_path, create_mr_path: create_mr_path, create_branch_path: create_branch_path, refs_path: refs_path } }
+  .create-mr-dropdown-wrap.d-inline-block.full-width-mobile.js-create-mr{ data: { project_path: @project.full_path, project_id: @project.id, can_create_path: can_create_path, create_mr_path: create_mr_path, create_branch_path: create_branch_path, refs_path: refs_path, is_confidential: can_create_confidential_merge_request?.to_s } }
     .btn-group.btn-group-sm.unavailable
       %button.btn.btn-grouped{ type: 'button', disabled: 'disabled' }
         = icon('spinner', class: 'fa-spin')
@@ -26,7 +27,7 @@
       .droplab-dropdown
         %ul#create-merge-request-dropdown.create-merge-request-dropdown-menu.dropdown-menu.dropdown-menu-right.gl-show-field-errors{ class: ("create-confidential-merge-request-dropdown-menu" if can_create_confidential_merge_request?), data: { dropdown: true } }
           - if can_create_merge_request
-            %li.droplab-item-selected{ role: 'button', data: { value: 'create-mr', text: _('Create merge request') } }
+            %li.droplab-item-selected{ role: 'button', data: { value: 'create-mr', text: create_mr_text } }
               .menu-item
                 = icon('check', class: 'icon')
                 - if can_create_confidential_merge_request?
@@ -41,6 +42,8 @@
           %li.divider.droplab-item-ignore
 
           %li.droplab-item-ignore.prepend-left-8.append-right-8.prepend-top-16
+            - if can_create_confidential_merge_request?
+              #js-forked-project{ data: { namespace_path: @project.namespace.full_path, project_path: @project.full_path, new_fork_path: new_project_fork_path(@project), help_page_path: help_page_path('user/project/merge_requests') } }
             .form-group
               %label{ for: 'new-branch-name' }
                 = _('Branch name')
@@ -55,4 +58,8 @@
 
             .form-group
               %button.btn.btn-success.js-create-target{ type: 'button', data: { action: 'create-mr' } }
-                = _('Create merge request')
+                = create_mr_text
+
+            - if can_create_confidential_merge_request?
+              %p.text-warning.js-exposed-info-warning.hidden
+                = _('This may expose confidential information as the selected fork is in another namespace that can have other members.')
diff --git a/locale/gitlab.pot b/locale/gitlab.pot
index 8a4f57c5b13..05d291022dc 100644
--- a/locale/gitlab.pot
+++ b/locale/gitlab.pot
@@ -4169,6 +4169,9 @@ msgstr ""
 msgid "Error fetching diverging counts for branches. Please try again."
 msgstr ""
 
+msgid "Error fetching forked projects. Please try again."
+msgstr ""
+
 msgid "Error fetching labels."
 msgstr ""
 
@@ -6825,6 +6828,9 @@ msgstr ""
 msgid "No files found."
 msgstr ""
 
+msgid "No forks available to you."
+msgstr ""
+
 msgid "No job trace"
 msgstr ""
 
@@ -9192,6 +9198,9 @@ msgstr ""
 msgid "Select members to invite"
 msgstr ""
 
+msgid "Select private project"
+msgstr ""
+
 msgid "Select project"
 msgstr ""
 
@@ -10753,6 +10762,9 @@ msgstr ""
 msgid "This job will automatically run after its timer finishes. Often they are used for incremental roll-out deploys to production environments. When unscheduled it converts into a manual action."
 msgstr ""
 
+msgid "This may expose confidential information as the selected fork is in another namespace that can have other members."
+msgstr ""
+
 msgid "This means you can not push code until you create an empty repository or import existing one."
 msgstr ""
 
@@ -11084,6 +11096,12 @@ msgstr ""
 msgid "To preserve performance only <strong>%{display_size} of %{real_size}</strong> files are displayed."
 msgstr ""
 
+msgid "To protect this issues confidentiality, %{link_start}fork the project%{link_end} and set the forks visiblity to private."
+msgstr ""
+
+msgid "To protect this issues confidentiality, a private fork of this project was selected."
+msgstr ""
+
 msgid "To see all the user's personal access tokens you must impersonate them first."
 msgstr ""
 
diff --git a/spec/features/issues/user_creates_confidential_merge_request_spec.rb b/spec/features/issues/user_creates_confidential_merge_request_spec.rb
new file mode 100644
index 00000000000..7ae4af4667b
--- /dev/null
+++ b/spec/features/issues/user_creates_confidential_merge_request_spec.rb
@@ -0,0 +1,54 @@
+require 'rails_helper'
+
+describe 'User creates confidential merge request on issue page', :js do
+  include ProjectForksHelper
+
+  let(:user) { create(:user) }
+  let(:project) { create(:project, :repository, :public) }
+  let(:issue) { create(:issue, project: project, confidential: true) }
+
+  def visit_confidential_issue
+    sign_in(user)
+    visit project_issue_path(project, issue)
+    wait_for_requests
+  end
+
+  before do
+    project.add_developer(user)
+  end
+
+  context 'user has no private fork' do
+    before do
+      fork_project(project, user, repository: true)
+      visit_confidential_issue
+    end
+
+    it 'shows that user has no fork available' do
+      click_button 'Create confidential merge request'
+
+      page.within '.create-confidential-merge-request-dropdown-menu' do
+        expect(page).to have_content('No forks available to you')
+      end
+    end
+  end
+
+  describe 'user has private fork' do
+    let(:forked_project) { fork_project(project, user, repository: true) }
+
+    before do
+      forked_project.update(visibility: Gitlab::VisibilityLevel::PRIVATE)
+      visit_confidential_issue
+    end
+
+    it 'create merge request in fork' do
+      click_button 'Create confidential merge request'
+
+      page.within '.create-confidential-merge-request-dropdown-menu' do
+        expect(page).to have_button(forked_project.name_with_namespace)
+        click_button 'Create confidential merge request'
+      end
+
+      expect(page).to have_content(forked_project.namespace.name)
+    end
+  end
+end
diff --git a/spec/frontend/confidential_merge_request/components/__snapshots__/project_form_group_spec.js.snap b/spec/frontend/confidential_merge_request/components/__snapshots__/project_form_group_spec.js.snap
new file mode 100644
index 00000000000..a241c764df7
--- /dev/null
+++ b/spec/frontend/confidential_merge_request/components/__snapshots__/project_form_group_spec.js.snap
@@ -0,0 +1,101 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`Confidential merge request project form group component renders empty state when response is empty 1`] = `
+<div
+  class="form-group"
+>
+  <label>
+    Project
+  </label>
+   
+  <div>
+    <!---->
+     
+    <p
+      class="text-muted mt-1 mb-0"
+    >
+      
+        No forks available to you.
+      <br />
+       
+      <span>
+        To protect this issues confidentiality, 
+        <a
+          class="help-link"
+          href="https://test.com"
+        >
+          fork the project
+        </a>
+         and set the forks visiblity to private.
+      </span>
+       
+      <gllink-stub
+        class="help-link"
+        href="/help"
+        target="_blank"
+      >
+        <span
+          class="sr-only"
+        >
+          Read more
+        </span>
+         
+        <i
+          aria-hidden="true"
+          class="fa fa-question-circle"
+        />
+      </gllink-stub>
+    </p>
+  </div>
+</div>
+`;
+
+exports[`Confidential merge request project form group component renders fork dropdown 1`] = `
+<div
+  class="form-group"
+>
+  <label>
+    Project
+  </label>
+   
+  <div>
+    <!---->
+     
+    <p
+      class="text-muted mt-1 mb-0"
+    >
+      
+        No forks available to you.
+      <br />
+       
+      <span>
+        To protect this issues confidentiality, 
+        <a
+          class="help-link"
+          href="https://test.com"
+        >
+          fork the project
+        </a>
+         and set the forks visiblity to private.
+      </span>
+       
+      <gllink-stub
+        class="help-link"
+        href="/help"
+        target="_blank"
+      >
+        <span
+          class="sr-only"
+        >
+          Read more
+        </span>
+         
+        <i
+          aria-hidden="true"
+          class="fa fa-question-circle"
+        />
+      </gllink-stub>
+    </p>
+  </div>
+</div>
+`;
diff --git a/spec/frontend/confidential_merge_request/components/dropdown_spec.js b/spec/frontend/confidential_merge_request/components/dropdown_spec.js
new file mode 100644
index 00000000000..69495f3c161
--- /dev/null
+++ b/spec/frontend/confidential_merge_request/components/dropdown_spec.js
@@ -0,0 +1,56 @@
+import { mount } from '@vue/test-utils';
+import { GlDropdownItem } from '@gitlab/ui';
+import Dropdown from '~/confidential_merge_request/components/dropdown.vue';
+
+let vm;
+
+function factory(projects = []) {
+  vm = mount(Dropdown, {
+    propsData: {
+      projects,
+      selectedProject: projects[0],
+    },
+  });
+}
+
+describe('Confidential merge request project dropdown component', () => {
+  afterEach(() => {
+    vm.destroy();
+  });
+
+  it('renders dropdown items', () => {
+    factory([
+      {
+        id: 1,
+        name: 'test',
+      },
+      {
+        id: 2,
+        name: 'test',
+      },
+    ]);
+
+    expect(vm.findAll(GlDropdownItem).length).toBe(2);
+  });
+
+  it('renders selected project icon', () => {
+    factory([
+      {
+        id: 1,
+        name: 'test',
+      },
+      {
+        id: 2,
+        name: 'test 2',
+      },
+    ]);
+
+    expect(vm.find('.js-active-project-check').classes()).not.toContain('icon');
+    expect(
+      vm
+        .findAll('.js-active-project-check')
+        .at(1)
+        .classes(),
+    ).toContain('icon');
+  });
+});
diff --git a/spec/frontend/confidential_merge_request/components/project_form_group_spec.js b/spec/frontend/confidential_merge_request/components/project_form_group_spec.js
new file mode 100644
index 00000000000..3001363f7b9
--- /dev/null
+++ b/spec/frontend/confidential_merge_request/components/project_form_group_spec.js
@@ -0,0 +1,77 @@
+import { shallowMount, createLocalVue } from '@vue/test-utils';
+import MockAdapter from 'axios-mock-adapter';
+import axios from '~/lib/utils/axios_utils';
+import ProjectFormGroup from '~/confidential_merge_request/components/project_form_group.vue';
+
+const localVue = createLocalVue();
+const mockData = [
+  {
+    id: 1,
+    name_with_namespace: 'root / gitlab-ce',
+    path_with_namespace: 'root/gitlab-ce',
+    namespace: {
+      full_path: 'root',
+    },
+  },
+  {
+    id: 2,
+    name_with_namespace: 'test / gitlab-ce',
+    path_with_namespace: 'test/gitlab-ce',
+    namespace: {
+      full_path: 'test',
+    },
+  },
+];
+let vm;
+let mock;
+
+function factory(projects = mockData) {
+  mock = new MockAdapter(axios);
+  mock.onGet(/api\/(.*)\/projects\/gitlab-org%2Fgitlab-ce\/forks/).reply(200, projects);
+
+  vm = shallowMount(ProjectFormGroup, {
+    localVue,
+    propsData: {
+      namespacePath: 'gitlab-org',
+      projectPath: 'gitlab-org/gitlab-ce',
+      newForkPath: 'https://test.com',
+      helpPagePath: '/help',
+    },
+  });
+}
+
+describe('Confidential merge request project form group component', () => {
+  afterEach(() => {
+    mock.restore();
+    vm.destroy();
+  });
+
+  it('renders fork dropdown', () => {
+    factory();
+
+    return localVue.nextTick(() => {
+      expect(vm.element).toMatchSnapshot();
+    });
+  });
+
+  it('sets selected project as first fork', () => {
+    factory();
+
+    return localVue.nextTick(() => {
+      expect(vm.vm.selectedProject).toEqual({
+        id: 1,
+        name: 'root / gitlab-ce',
+        pathWithNamespace: 'root/gitlab-ce',
+        namespaceFullpath: 'root',
+      });
+    });
+  });
+
+  it('renders empty state when response is empty', () => {
+    factory([]);
+
+    return localVue.nextTick(() => {
+      expect(vm.element).toMatchSnapshot();
+    });
+  });
+});
diff --git a/spec/javascripts/create_merge_request_dropdown_spec.js b/spec/frontend/create_merge_request_dropdown_spec.js
similarity index 92%
rename from spec/javascripts/create_merge_request_dropdown_spec.js
rename to spec/frontend/create_merge_request_dropdown_spec.js
index 00fe3f451f5..6e41fdabdce 100644
--- a/spec/javascripts/create_merge_request_dropdown_spec.js
+++ b/spec/frontend/create_merge_request_dropdown_spec.js
@@ -1,7 +1,7 @@
 import axios from '~/lib/utils/axios_utils';
 import MockAdapter from 'axios-mock-adapter';
 import CreateMergeRequestDropdown from '~/create_merge_request_dropdown';
-import { TEST_HOST } from 'spec/test_constants';
+import { TEST_HOST } from './helpers/test_constants';
 
 describe('CreateMergeRequestDropdown', () => {
   let axiosMock;
@@ -10,7 +10,7 @@ describe('CreateMergeRequestDropdown', () => {
   beforeEach(() => {
     axiosMock = new MockAdapter(axios);
 
-    setFixtures(`
+    document.body.innerHTML = `
       <div id="dummy-wrapper-element">
         <div class="available"></div>
         <div class="unavailable">
@@ -18,11 +18,12 @@ describe('CreateMergeRequestDropdown', () => {
           <div class="text"></div>
         </div>
         <div class="js-ref"></div>
+        <div class="js-create-mr"></div>
         <div class="js-create-merge-request"></div>
         <div class="js-create-target"></div>
         <div class="js-dropdown-toggle"></div>
       </div>
-    `);
+    `;
 
     const dummyElement = document.getElementById('dummy-wrapper-element');
     dropdown = new CreateMergeRequestDropdown(dummyElement);
@@ -36,7 +37,7 @@ describe('CreateMergeRequestDropdown', () => {
   describe('getRef', () => {
     it('escapes branch names correctly', done => {
       const endpoint = `${dropdown.refsPath}contains%23hash`;
-      spyOn(axios, 'get').and.callThrough();
+      jest.spyOn(axios, 'get');
       axiosMock.onGet(endpoint).replyOnce({});
 
       dropdown

From 3b725491a311c762a86c9e5b35014374c13fbe98 Mon Sep 17 00:00:00 2001
From: Lukas Eipert <leipert@gitlab.com>
Date: Fri, 5 Jul 2019 11:35:37 +0000
Subject: [PATCH 100/195] Update dependency @gitlab/svgs to ^1.67.0

---
 package.json | 2 +-
 yarn.lock    | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/package.json b/package.json
index 47e7dd9c9c9..5b255f55e33 100644
--- a/package.json
+++ b/package.json
@@ -37,7 +37,7 @@
     "@babel/plugin-syntax-import-meta": "^7.2.0",
     "@babel/preset-env": "^7.4.4",
     "@gitlab/csslab": "^1.9.0",
-    "@gitlab/svgs": "^1.66.0",
+    "@gitlab/svgs": "^1.67.0",
     "@gitlab/ui": "^5.3.2",
     "apollo-cache-inmemory": "^1.5.1",
     "apollo-client": "^2.5.1",
diff --git a/yarn.lock b/yarn.lock
index b76eba830b1..825a1785c3e 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -700,10 +700,10 @@
   dependencies:
     requireindex "~1.1.0"
 
-"@gitlab/svgs@^1.66.0":
-  version "1.66.0"
-  resolved "https://registry.yarnpkg.com/@gitlab/svgs/-/svgs-1.66.0.tgz#3c02da455421ea241f32e915671842435df027ff"
-  integrity sha512-nxOoQPnofMs3BjRr3SVzQcclM0G6QFrLM8L4nnUCN+8Gxq2u8ukfSU5FCrkivXz+FP9Qo/FYilWV7CY8kDkt6A==
+"@gitlab/svgs@^1.67.0":
+  version "1.67.0"
+  resolved "https://registry.yarnpkg.com/@gitlab/svgs/-/svgs-1.67.0.tgz#c7b94eca13b99fd3aaa737fb6dcc0abc41d3c579"
+  integrity sha512-hJOmWEs6RkjzyKkb1vc9wwKGZIBIP0coHkxu/KgOoxhBVudpGk4CH7xJ6UuB2TKpb0SEh5CC1CzRZfBYaFhsaA==
 
 "@gitlab/ui@^5.3.2":
   version "5.3.2"

From 930982cebec7645e139e7f0cd75aa5fc7224fbd0 Mon Sep 17 00:00:00 2001
From: Filipa Lacerda <filipa@gitlab.com>
Date: Fri, 5 Jul 2019 12:41:14 +0100
Subject: [PATCH 101/195] Removes EE differences

---
 app/views/layouts/fullscreen.html.haml     | 2 ++
 changelogs/unreleased/12550-fullscrean.yml | 5 +++++
 2 files changed, 7 insertions(+)
 create mode 100644 changelogs/unreleased/12550-fullscrean.yml

diff --git a/app/views/layouts/fullscreen.html.haml b/app/views/layouts/fullscreen.html.haml
index fa04b5be9f2..91a7777514c 100644
--- a/app/views/layouts/fullscreen.html.haml
+++ b/app/views/layouts/fullscreen.html.haml
@@ -3,6 +3,7 @@
   = render "layouts/head"
   %body{ class: "#{user_application_theme} #{@body_class} fullscreen-layout", data: { page: body_data_page } }
     = render 'peek/bar'
+    = header_message
     = render partial: "layouts/header/default", locals: { project: @project, group: @group }
     = render 'shared/outdated_browser'
     .mobile-overlay
@@ -12,3 +13,4 @@
       = render "layouts/flash"
     .content-wrapper{ id: "content-body", class: "d-flex flex-column align-items-stretch mt-0" }
       = yield
+    = footer_message
diff --git a/changelogs/unreleased/12550-fullscrean.yml b/changelogs/unreleased/12550-fullscrean.yml
new file mode 100644
index 00000000000..f20b191f411
--- /dev/null
+++ b/changelogs/unreleased/12550-fullscrean.yml
@@ -0,0 +1,5 @@
+---
+title: Removes EE differences for app/views/layouts/fullscreen.html.haml
+merge_request:
+author:
+type: other

From 52a2b78b763edcd9046022e8f26794a3a4101211 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rub=C3=A9n=20D=C3=A1vila?= <ruben@gitlab.com>
Date: Mon, 24 Jun 2019 17:13:53 -0500
Subject: [PATCH 102/195] Backport of
 https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/14328

---
 ..._ci_minutes_usage_notification_level_to_namespaces.rb | 9 +++++++++
 db/schema.rb                                             | 1 +
 2 files changed, 10 insertions(+)
 create mode 100644 db/migrate/20190621022810_add_last_ci_minutes_usage_notification_level_to_namespaces.rb

diff --git a/db/migrate/20190621022810_add_last_ci_minutes_usage_notification_level_to_namespaces.rb b/db/migrate/20190621022810_add_last_ci_minutes_usage_notification_level_to_namespaces.rb
new file mode 100644
index 00000000000..1611340284c
--- /dev/null
+++ b/db/migrate/20190621022810_add_last_ci_minutes_usage_notification_level_to_namespaces.rb
@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+class AddLastCiMinutesUsageNotificationLevelToNamespaces < ActiveRecord::Migration[5.1]
+  DOWNTIME = false
+
+  def change
+    add_column :namespaces, :last_ci_minutes_usage_notification_level, :integer
+  end
+end
diff --git a/db/schema.rb b/db/schema.rb
index 9cc45bb1e47..56d49815166 100644
--- a/db/schema.rb
+++ b/db/schema.rb
@@ -2116,6 +2116,7 @@ ActiveRecord::Schema.define(version: 20190628185004) do
     t.integer "extra_shared_runners_minutes_limit"
     t.string "ldap_sync_status", default: "ready", null: false
     t.boolean "membership_lock", default: false
+    t.integer "last_ci_minutes_usage_notification_level"
     t.index ["created_at"], name: "index_namespaces_on_created_at", using: :btree
     t.index ["custom_project_templates_group_id", "type"], name: "index_namespaces_on_custom_project_templates_group_id_and_type", where: "(custom_project_templates_group_id IS NOT NULL)", using: :btree
     t.index ["file_template_project_id"], name: "index_namespaces_on_file_template_project_id", using: :btree

From 031e91beebfe6d9de469a3635ba898e434da9d31 Mon Sep 17 00:00:00 2001
From: Zeger-Jan van de Weg <git@zjvandeweg.nl>
Date: Thu, 27 Jun 2019 14:10:05 +0200
Subject: [PATCH 103/195] Remove high cardinality Prometheus metric

The metric was used to correlate Gitaly requests to the Rails controller
and action combination. However, Kibana provides better observability in
this specific metric, and can handle hig cardinality much better.

There's no dashboard in Grafana that currently depends on this metric
being exposed.
---
 lib/gitlab/gitaly_client.rb | 9 ---------
 1 file changed, 9 deletions(-)

diff --git a/lib/gitlab/gitaly_client.rb b/lib/gitlab/gitaly_client.rb
index 47976389af6..9e3de910e3c 100644
--- a/lib/gitlab/gitaly_client.rb
+++ b/lib/gitlab/gitaly_client.rb
@@ -33,11 +33,6 @@ module Gitlab
 
     MUTEX = Mutex.new
 
-    define_histogram :gitaly_controller_action_duration_seconds do
-      docstring "Gitaly endpoint histogram by controller and action combination"
-      base_labels Gitlab::Metrics::Transaction::BASE_LABELS.merge(gitaly_service: nil, rpc: nil)
-    end
-
     def self.stub(name, storage)
       MUTEX.synchronize do
         @stubs ||= {}
@@ -161,10 +156,6 @@ module Gitlab
 
       # Keep track, separately, for the performance bar
       self.query_time += duration
-      gitaly_controller_action_duration_seconds.observe(
-        current_transaction_labels.merge(gitaly_service: service.to_s, rpc: rpc.to_s),
-        duration)
-
       if peek_enabled?
         add_call_details(feature: "#{service}##{rpc}", duration: duration, request: request_hash, rpc: rpc,
                          backtrace: Gitlab::Profiler.clean_backtrace(caller))

From 88a7e93caa958ae1b42f46ca1eae312e4338564d Mon Sep 17 00:00:00 2001
From: Filipa Lacerda <filipa@gitlab.com>
Date: Fri, 5 Jul 2019 13:51:35 +0100
Subject: [PATCH 104/195] Removes EE differences

---
 app/views/admin/users/show.html.haml                   | 2 +-
 changelogs/unreleased/12533-shared-runners-warning.yml | 5 +++++
 2 files changed, 6 insertions(+), 1 deletion(-)
 create mode 100644 changelogs/unreleased/12533-shared-runners-warning.yml

diff --git a/app/views/admin/users/show.html.haml b/app/views/admin/users/show.html.haml
index 5c6131db37d..a988f746ced 100644
--- a/app/views/admin/users/show.html.haml
+++ b/app/views/admin/users/show.html.haml
@@ -139,7 +139,7 @@
             %strong
               = link_to @user.created_by.name, [:admin, @user.created_by]
 
-        = render_if_exists partial: "namespaces/shared_runner_status", locals: { namespace: @user.namespace }
+        = render_if_exists 'namespaces/shared_runner_status', namespace: @user.namespace
 
   .col-md-6
     - unless @user == current_user
diff --git a/changelogs/unreleased/12533-shared-runners-warning.yml b/changelogs/unreleased/12533-shared-runners-warning.yml
new file mode 100644
index 00000000000..b2b526cc2e4
--- /dev/null
+++ b/changelogs/unreleased/12533-shared-runners-warning.yml
@@ -0,0 +1,5 @@
+---
+title: Removes EE differences for app/views/admin/users/show.html.haml
+merge_request:
+author:
+type: other

From ff1a4a4241f1628491a1aec05b440ff650ba66ad Mon Sep 17 00:00:00 2001
From: Denys Mishunov <dmishunov@gitlab.com>
Date: Wed, 3 Jul 2019 14:14:44 +0200
Subject: [PATCH 105/195] Initiate editor for any file without content

Important to get file data for any file that has no content set yet: we
need this information in order to build a previe for changed/staged
files if they were not yet opened in the editor
---
 .../ide/components/repo_editor.vue            |  4 +-
 .../javascripts/ide/stores/mutations/file.js  | 26 ++++++------
 .../unreleased/60856-deleting-binary-file.yml |  5 +++
 .../ide/components/repo_editor_spec.js        | 40 +++++++++++++++++++
 .../ide/stores/mutations/file_spec.js         | 20 ++++++++++
 5 files changed, 81 insertions(+), 14 deletions(-)
 create mode 100644 changelogs/unreleased/60856-deleting-binary-file.yml

diff --git a/app/assets/javascripts/ide/components/repo_editor.vue b/app/assets/javascripts/ide/components/repo_editor.vue
index 5fcb11a232e..03756a634d5 100644
--- a/app/assets/javascripts/ide/components/repo_editor.vue
+++ b/app/assets/javascripts/ide/components/repo_editor.vue
@@ -144,7 +144,9 @@ export default {
       'triggerFilesChange',
     ]),
     initEditor() {
-      if (this.shouldHideEditor) return;
+      if (this.shouldHideEditor && (this.file.content || this.file.raw)) {
+        return;
+      }
 
       this.editor.clearEditor();
 
diff --git a/app/assets/javascripts/ide/stores/mutations/file.js b/app/assets/javascripts/ide/stores/mutations/file.js
index c88244492e0..a52f1e235ed 100644
--- a/app/assets/javascripts/ide/stores/mutations/file.js
+++ b/app/assets/javascripts/ide/stores/mutations/file.js
@@ -1,6 +1,7 @@
 import * as types from '../mutation_types';
 import { sortTree } from '../utils';
 import { diffModes } from '../../constants';
+import { convertObjectPropsToCamelCase } from '~/lib/utils/common_utils';
 
 export default {
   [types.SET_FILE_ACTIVE](state, { path, active }) {
@@ -35,19 +36,18 @@ export default {
     }
   },
   [types.SET_FILE_DATA](state, { data, file }) {
-    Object.assign(state.entries[file.path], {
-      id: data.id,
-      blamePath: data.blame_path,
-      commitsPath: data.commits_path,
-      permalink: data.permalink,
-      rawPath: data.raw_path,
-      binary: data.binary,
-      renderError: data.render_error,
-      raw: (state.entries[file.path] && state.entries[file.path].raw) || null,
-      baseRaw: null,
-      html: data.html,
-      size: data.size,
-      lastCommitSha: data.last_commit_sha,
+    const stateEntry = state.entries[file.path];
+    const stagedFile = state.stagedFiles.find(f => f.path === file.path);
+    const openFile = state.openFiles.find(f => f.path === file.path);
+    const changedFile = state.changedFiles.find(f => f.path === file.path);
+
+    [stateEntry, stagedFile, openFile, changedFile].forEach(f => {
+      if (f) {
+        Object.assign(f, convertObjectPropsToCamelCase(data, { dropKeys: ['raw', 'baseRaw'] }), {
+          raw: (stateEntry && stateEntry.raw) || null,
+          baseRaw: null,
+        });
+      }
     });
   },
   [types.SET_FILE_RAW_DATA](state, { file, raw }) {
diff --git a/changelogs/unreleased/60856-deleting-binary-file.yml b/changelogs/unreleased/60856-deleting-binary-file.yml
new file mode 100644
index 00000000000..9b587ed591b
--- /dev/null
+++ b/changelogs/unreleased/60856-deleting-binary-file.yml
@@ -0,0 +1,5 @@
+---
+title: Removing an image should not output binary data
+merge_request: 30314
+author:
+type: fixed
diff --git a/spec/javascripts/ide/components/repo_editor_spec.js b/spec/javascripts/ide/components/repo_editor_spec.js
index f832096701f..7dc5cb24981 100644
--- a/spec/javascripts/ide/components/repo_editor_spec.js
+++ b/spec/javascripts/ide/components/repo_editor_spec.js
@@ -30,6 +30,7 @@ describe('RepoEditor', () => {
     Vue.set(vm.$store.state.entries, f.path, f);
 
     spyOn(vm, 'getFileData').and.returnValue(Promise.resolve());
+    spyOn(vm, 'getRawFileData').and.returnValue(Promise.resolve());
 
     vm.$mount();
 
@@ -407,6 +408,44 @@ describe('RepoEditor', () => {
     });
   });
 
+  describe('initEditor', () => {
+    beforeEach(() => {
+      spyOn(vm.editor, 'createInstance');
+      spyOnProperty(vm, 'shouldHideEditor').and.returnValue(true);
+    });
+
+    it('is being initialised for files without content even if shouldHideEditor is `true`', done => {
+      vm.file.content = '';
+      vm.file.raw = '';
+
+      vm.initEditor();
+      vm.$nextTick()
+        .then(() => {
+          expect(vm.getFileData).toHaveBeenCalled();
+          expect(vm.getRawFileData).toHaveBeenCalled();
+        })
+        .then(done)
+        .catch(done.fail);
+    });
+
+    it('does not initialize editor for files already with content', done => {
+      expect(vm.getFileData.calls.count()).toEqual(1);
+      expect(vm.getRawFileData.calls.count()).toEqual(1);
+
+      vm.file.content = 'foo';
+
+      vm.initEditor();
+      vm.$nextTick()
+        .then(() => {
+          expect(vm.getFileData.calls.count()).toEqual(1);
+          expect(vm.getRawFileData.calls.count()).toEqual(1);
+          expect(vm.editor.createInstance).not.toHaveBeenCalled();
+        })
+        .then(done)
+        .catch(done.fail);
+    });
+  });
+
   it('calls removePendingTab when old file is pending', done => {
     spyOnProperty(vm, 'shouldHideEditor').and.returnValue(true);
     spyOn(vm, 'removePendingTab');
@@ -416,6 +455,7 @@ describe('RepoEditor', () => {
     vm.$nextTick()
       .then(() => {
         vm.file = file('testing');
+        vm.file.content = 'foo'; // need to prevent full cycle of initEditor
 
         return vm.$nextTick();
       })
diff --git a/spec/javascripts/ide/stores/mutations/file_spec.js b/spec/javascripts/ide/stores/mutations/file_spec.js
index 18ee4330f69..7714f66c9a4 100644
--- a/spec/javascripts/ide/stores/mutations/file_spec.js
+++ b/spec/javascripts/ide/stores/mutations/file_spec.js
@@ -83,6 +83,26 @@ describe('IDE store file mutations', () => {
       expect(localFile.raw).toBeNull();
       expect(localFile.baseRaw).toBeNull();
     });
+
+    it('sets extra file data to all arrays concerned', () => {
+      localState.stagedFiles = [localFile];
+      localState.changedFiles = [localFile];
+      localState.openFiles = [localFile];
+
+      const rawPath = 'foo/bar/blah.md';
+
+      mutations.SET_FILE_DATA(localState, {
+        data: {
+          raw_path: rawPath,
+        },
+        file: localFile,
+      });
+
+      expect(localState.stagedFiles[0].rawPath).toEqual(rawPath);
+      expect(localState.changedFiles[0].rawPath).toEqual(rawPath);
+      expect(localState.openFiles[0].rawPath).toEqual(rawPath);
+      expect(localFile.rawPath).toEqual(rawPath);
+    });
   });
 
   describe('SET_FILE_RAW_DATA', () => {

From 7ca77203c0622697123e2fdb6f377d87e3de901b Mon Sep 17 00:00:00 2001
From: Lukas Eipert <leipert@gitlab.com>
Date: Thu, 4 Jul 2019 13:36:49 +0200
Subject: [PATCH 106/195] Replace runtime isEE check with compile time one

This has the benefit that CE bundles will remove dead code in CE only
builds.

We have a follow-up issue to get rid of this completely:

https://gitlab.com/gitlab-org/gitlab-ce/issues/64173
---
 .eslintrc.yml                                         |  1 +
 .../javascripts/boards/filtered_search_boards.js      |  3 +--
 app/assets/javascripts/boards/models/issue.js         |  6 +++---
 app/assets/javascripts/boards/models/list.js          |  8 ++++----
 app/assets/javascripts/boards/models/milestone.js     |  4 +---
 app/assets/javascripts/event_tracking/notes.js        |  1 +
 app/assets/javascripts/labels_select.js               |  4 ++--
 app/assets/javascripts/lib/utils/common_utils.js      |  8 --------
 .../javascripts/monitoring/components/dashboard.vue   | 11 ++++++++---
 app/assets/javascripts/notes/index.js                 |  5 +----
 app/assets/javascripts/vue_shared/mixins/is_ee.js     | 10 ----------
 config/webpack.config.js                              |  3 +++
 spec/javascripts/test_bundle.js                       |  2 --
 13 files changed, 25 insertions(+), 41 deletions(-)
 delete mode 100644 app/assets/javascripts/vue_shared/mixins/is_ee.js

diff --git a/.eslintrc.yml b/.eslintrc.yml
index 2b881d5f201..2612fd3371d 100644
--- a/.eslintrc.yml
+++ b/.eslintrc.yml
@@ -5,6 +5,7 @@ globals:
   gl: false
   gon: false
   localStorage: false
+  IS_EE: false
 plugins:
   - import
   - html
diff --git a/app/assets/javascripts/boards/filtered_search_boards.js b/app/assets/javascripts/boards/filtered_search_boards.js
index 6b54e8baefb..b1b4b1c5508 100644
--- a/app/assets/javascripts/boards/filtered_search_boards.js
+++ b/app/assets/javascripts/boards/filtered_search_boards.js
@@ -2,7 +2,6 @@ import IssuableFilteredSearchTokenKeys from 'ee_else_ce/filtered_search/issuable
 import FilteredSearchContainer from '../filtered_search/container';
 import FilteredSearchManager from '../filtered_search/filtered_search_manager';
 import boardsStore from './stores/boards_store';
-import { isEE } from '~/lib/utils/common_utils';
 
 export default class FilteredSearchBoards extends FilteredSearchManager {
   constructor(store, updateUrl = false, cantEdit = []) {
@@ -10,7 +9,7 @@ export default class FilteredSearchBoards extends FilteredSearchManager {
       page: 'boards',
       isGroupDecendent: true,
       stateFiltersSelector: '.issues-state-filters',
-      isGroup: isEE(),
+      isGroup: IS_EE,
       filteredSearchTokenKeys: IssuableFilteredSearchTokenKeys,
     });
 
diff --git a/app/assets/javascripts/boards/models/issue.js b/app/assets/javascripts/boards/models/issue.js
index f858b162c6b..9069b35db9a 100644
--- a/app/assets/javascripts/boards/models/issue.js
+++ b/app/assets/javascripts/boards/models/issue.js
@@ -5,7 +5,7 @@
 
 import Vue from 'vue';
 import './label';
-import { isEE, convertObjectPropsToCamelCase } from '~/lib/utils/common_utils';
+import { convertObjectPropsToCamelCase } from '~/lib/utils/common_utils';
 import IssueProject from './project';
 import boardsStore from '../stores/boards_store';
 
@@ -91,13 +91,13 @@ class ListIssue {
 
   addMilestone(milestone) {
     const miletoneId = this.milestone ? this.milestone.id : null;
-    if (isEE && milestone.id !== miletoneId) {
+    if (IS_EE && milestone.id !== miletoneId) {
       this.milestone = new ListMilestone(milestone);
     }
   }
 
   removeMilestone(removeMilestone) {
-    if (isEE && removeMilestone && removeMilestone.id === this.milestone.id) {
+    if (IS_EE && removeMilestone && removeMilestone.id === this.milestone.id) {
       this.milestone = {};
     }
   }
diff --git a/app/assets/javascripts/boards/models/list.js b/app/assets/javascripts/boards/models/list.js
index cd553d0c4af..7e0ccb9bd2a 100644
--- a/app/assets/javascripts/boards/models/list.js
+++ b/app/assets/javascripts/boards/models/list.js
@@ -4,7 +4,7 @@
 import { __ } from '~/locale';
 import ListLabel from './label';
 import ListAssignee from './assignee';
-import { isEE, urlParamsToObject } from '~/lib/utils/common_utils';
+import { urlParamsToObject } from '~/lib/utils/common_utils';
 import boardsStore from '../stores/boards_store';
 import ListMilestone from './milestone';
 
@@ -58,7 +58,7 @@ class List {
     } else if (obj.user) {
       this.assignee = new ListAssignee(obj.user);
       this.title = this.assignee.name;
-    } else if (isEE && obj.milestone) {
+    } else if (IS_EE && obj.milestone) {
       this.milestone = new ListMilestone(obj.milestone);
       this.title = this.milestone.title;
     }
@@ -85,7 +85,7 @@ class List {
       entityType = 'label_id';
     } else if (this.assignee) {
       entityType = 'assignee_id';
-    } else if (isEE && this.milestone) {
+    } else if (IS_EE && this.milestone) {
       entityType = 'milestone_id';
     }
 
@@ -205,7 +205,7 @@ class List {
         issue.addAssignee(this.assignee);
       }
 
-      if (isEE && this.milestone) {
+      if (IS_EE && this.milestone) {
         if (listFrom && listFrom.type === 'milestone') {
           issue.removeMilestone(listFrom.milestone);
         }
diff --git a/app/assets/javascripts/boards/models/milestone.js b/app/assets/javascripts/boards/models/milestone.js
index 6f81d6bc6f8..7201b6e91f5 100644
--- a/app/assets/javascripts/boards/models/milestone.js
+++ b/app/assets/javascripts/boards/models/milestone.js
@@ -1,11 +1,9 @@
-import { isEE } from '~/lib/utils/common_utils';
-
 export default class ListMilestone {
   constructor(obj) {
     this.id = obj.id;
     this.title = obj.title;
 
-    if (isEE) {
+    if (IS_EE) {
       this.path = obj.path;
       this.state = obj.state;
       this.webUrl = obj.web_url || obj.webUrl;
diff --git a/app/assets/javascripts/event_tracking/notes.js b/app/assets/javascripts/event_tracking/notes.js
index 2d1ec238274..1f70290c397 100644
--- a/app/assets/javascripts/event_tracking/notes.js
+++ b/app/assets/javascripts/event_tracking/notes.js
@@ -1 +1,2 @@
+// Noop function which has a EE counter-part
 export default () => {};
diff --git a/app/assets/javascripts/labels_select.js b/app/assets/javascripts/labels_select.js
index 3f954b43ee3..bea43430edc 100644
--- a/app/assets/javascripts/labels_select.js
+++ b/app/assets/javascripts/labels_select.js
@@ -11,7 +11,7 @@ import CreateLabelDropdown from './create_label';
 import flash from './flash';
 import ModalStore from './boards/stores/modal_store';
 import boardsStore from './boards/stores/boards_store';
-import { isEE, isScopedLabel } from '~/lib/utils/common_utils';
+import { isScopedLabel } from '~/lib/utils/common_utils';
 
 export default class LabelsSelect {
   constructor(els, options = {}) {
@@ -140,7 +140,7 @@ export default class LabelsSelect {
               labelCount = data.labels.length;
 
               // EE Specific
-              if (isEE) {
+              if (IS_EE) {
                 /**
                  * For Scoped labels, the last label selected with the
                  * same key will be applied to the current issueable.
diff --git a/app/assets/javascripts/lib/utils/common_utils.js b/app/assets/javascripts/lib/utils/common_utils.js
index cc5e12aa467..5e90893b684 100644
--- a/app/assets/javascripts/lib/utils/common_utils.js
+++ b/app/assets/javascripts/lib/utils/common_utils.js
@@ -726,14 +726,6 @@ export const NavigationType = {
   TYPE_RESERVED: 255,
 };
 
-/**
- * Returns the value of `gon.ee`
- * Used to check if it's the EE codebase or the CE one.
- *
- * @returns Boolean
- */
-export const isEE = () => window.gon && window.gon.ee;
-
 /**
  * Checks if the given Label has a special syntax `::` in
  * it's title.
diff --git a/app/assets/javascripts/monitoring/components/dashboard.vue b/app/assets/javascripts/monitoring/components/dashboard.vue
index ed25a6e3684..ba79a697df2 100644
--- a/app/assets/javascripts/monitoring/components/dashboard.vue
+++ b/app/assets/javascripts/monitoring/components/dashboard.vue
@@ -4,7 +4,6 @@ import _ from 'underscore';
 import { mapActions, mapState } from 'vuex';
 import { s__ } from '~/locale';
 import Icon from '~/vue_shared/components/icon.vue';
-import '~/vue_shared/mixins/is_ee';
 import { getParameterValues } from '~/lib/utils/url_utility';
 import invalidUrl from '~/lib/utils/invalid_url';
 import MonitorAreaChart from './charts/area.vue';
@@ -160,6 +159,12 @@ export default {
     selectedDashboardText() {
       return this.currentDashboard || (this.allDashboards[0] && this.allDashboards[0].display_name);
     },
+    addingMetricsAvailable() {
+      return IS_EE && this.canAddMetrics && !this.showEmptyState;
+    },
+    alertWidgetAvailable() {
+      return IS_EE && this.prometheusAlertsAvailable && this.alertsEndpoint;
+    },
   },
   created() {
     this.setEndpoints({
@@ -313,7 +318,7 @@ export default {
         </div>
       </div>
       <div class="d-flex">
-        <div v-if="isEE && canAddMetrics && !showEmptyState">
+        <div v-if="addingMetricsAvailable">
           <gl-button
             v-gl-modal-directive="$options.addMetric.modalId"
             class="js-add-metric-button text-success border-success"
@@ -372,7 +377,7 @@ export default {
           group-id="monitor-area-chart"
         >
           <alert-widget
-            v-if="isEE && prometheusAlertsAvailable && alertsEndpoint && graphData"
+            v-if="alertWidgetAvailable && graphData"
             :alerts-endpoint="alertsEndpoint"
             :relevant-queries="graphData.queries"
             :alerts-to-manage="getGraphAlerts(graphData.queries)"
diff --git a/app/assets/javascripts/notes/index.js b/app/assets/javascripts/notes/index.js
index 57dd1c5cab2..c70c0e4095c 100644
--- a/app/assets/javascripts/notes/index.js
+++ b/app/assets/javascripts/notes/index.js
@@ -1,5 +1,4 @@
 import Vue from 'vue';
-import { isEE } from '~/lib/utils/common_utils';
 import initNoteStats from 'ee_else_ce/event_tracking/notes';
 import notesApp from './components/notes_app.vue';
 import initDiscussionFilters from './discussion_filters';
@@ -41,9 +40,7 @@ document.addEventListener('DOMContentLoaded', () => {
       };
     },
     mounted() {
-      if (isEE) {
-        initNoteStats();
-      }
+      initNoteStats();
     },
     render(createElement) {
       return createElement('notes-app', {
diff --git a/app/assets/javascripts/vue_shared/mixins/is_ee.js b/app/assets/javascripts/vue_shared/mixins/is_ee.js
deleted file mode 100644
index 8e00d93ef18..00000000000
--- a/app/assets/javascripts/vue_shared/mixins/is_ee.js
+++ /dev/null
@@ -1,10 +0,0 @@
-import Vue from 'vue';
-import { isEE } from '~/lib/utils/common_utils';
-
-Vue.mixin({
-  computed: {
-    isEE() {
-      return isEE();
-    },
-  },
-});
diff --git a/config/webpack.config.js b/config/webpack.config.js
index 19b48845305..a81590e8b8e 100644
--- a/config/webpack.config.js
+++ b/config/webpack.config.js
@@ -322,7 +322,10 @@ module.exports = {
       }),
 
     new webpack.DefinePlugin({
+      // This one is used to define window.gon.ee and other things properly in tests:
       'process.env.IS_GITLAB_EE': JSON.stringify(IS_EE),
+      // This one is used to check against "EE" properly in application code
+      IS_EE: IS_EE ? 'window.gon && window.gon.ee' : JSON.stringify(false),
     }),
   ].filter(Boolean),
 
diff --git a/spec/javascripts/test_bundle.js b/spec/javascripts/test_bundle.js
index 2cc476ed52a..50741e249ca 100644
--- a/spec/javascripts/test_bundle.js
+++ b/spec/javascripts/test_bundle.js
@@ -8,7 +8,6 @@ import '~/commons';
 import Vue from 'vue';
 import VueResource from 'vue-resource';
 import Translate from '~/vue_shared/translate';
-import CheckEE from '~/vue_shared/mixins/is_ee';
 import jasmineDiff from 'jasmine-diff';
 import { config as testUtilsConfig } from '@vue/test-utils';
 
@@ -48,7 +47,6 @@ Vue.config.errorHandler = function(err) {
 
 Vue.use(VueResource);
 Vue.use(Translate);
-Vue.use(CheckEE);
 
 // enable test fixtures
 jasmine.getFixtures().fixturesPath = FIXTURES_PATH;

From fa790f5512c6a700239b395e81ecc2a45edd24fd Mon Sep 17 00:00:00 2001
From: Phil Hughes <me@iamphill.com>
Date: Fri, 5 Jul 2019 15:54:37 +0100
Subject: [PATCH 107/195] Fixed apollo caching of the root repository file
 listing

---
 app/assets/javascripts/repository/components/table/index.vue | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app/assets/javascripts/repository/components/table/index.vue b/app/assets/javascripts/repository/components/table/index.vue
index 1e66ccbfa29..0d9e992e596 100644
--- a/app/assets/javascripts/repository/components/table/index.vue
+++ b/app/assets/javascripts/repository/components/table/index.vue
@@ -76,7 +76,7 @@ export default {
           variables: {
             projectPath: this.projectPath,
             ref: this.ref,
-            path: this.path,
+            path: this.path || '/',
             nextPageCursor: this.nextPageCursor,
             pageSize: PAGE_SIZE,
           },

From a5c0809f3bf35303af087a4c35000f664f55d172 Mon Sep 17 00:00:00 2001
From: Douglas Barbosa Alexandre <dbalexandre@gmail.com>
Date: Thu, 4 Jul 2019 18:25:54 -0300
Subject: [PATCH 108/195] Add note that internal URL works only with a LB with
 TLS termination

---
 doc/user/admin_area/geo_nodes.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/doc/user/admin_area/geo_nodes.md b/doc/user/admin_area/geo_nodes.md
index d99b87cbc5c..f535e7790bc 100644
--- a/doc/user/admin_area/geo_nodes.md
+++ b/doc/user/admin_area/geo_nodes.md
@@ -61,6 +61,12 @@ which is used by users. Internal URL does not need to be a private address.
 Internal URL defaults to External URL, but you can customize it under
 **Admin area > Geo Nodes**.
 
+CAUTION: **Warning:**
+We recommend using an HTTPS connection while configuring the Geo nodes. To avoid
+breaking communication between **primary** and **secondary** nodes when using
+HTTPS, customize your Internal URL to point to a Load Balancer with TLS
+termination.
+
 ## Multiple secondary nodes behind a load balancer
 
 In GitLab 11.11, **secondary** nodes can use identical external URLs as long as
@@ -83,4 +89,4 @@ questions that you know someone might ask.
 
 Each scenario can be a third-level heading, e.g. `### Getting error message X`.
 If you have none to add when creating a doc, leave this section in place
-but commented out to help encourage others to add to it in the future. -->
\ No newline at end of file
+but commented out to help encourage others to add to it in the future. -->

From 7c41a02e4a695d42344488819111b5387d605e7e Mon Sep 17 00:00:00 2001
From: Annabel Dunstone Gray <annabel.dunstone@gmail.com>
Date: Fri, 5 Jul 2019 10:33:04 -0500
Subject: [PATCH 109/195] Fix top position of sticky file header on discussion
 tab

---
 app/assets/stylesheets/pages/notes.scss | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/app/assets/stylesheets/pages/notes.scss b/app/assets/stylesheets/pages/notes.scss
index 7bd1a4138e4..00c6a3a5476 100644
--- a/app/assets/stylesheets/pages/notes.scss
+++ b/app/assets/stylesheets/pages/notes.scss
@@ -406,7 +406,7 @@ $note-form-margin-left: 72px;
     border-radius: 0;
 
     @media (min-width: map-get($grid-breakpoints, md)) {
-      top: 91px;
+      top: $mr-tabs-height + $header-height;
 
       .with-performance-bar & {
         top: 126px;

From 5f18598c0505adf78ed6078fbdee9846b7efddac Mon Sep 17 00:00:00 2001
From: mfluharty <mfluharty@gitlab.com>
Date: Fri, 5 Jul 2019 09:57:38 -0600
Subject: [PATCH 110/195] Pin modals at 64px from the top of the viewport

Was 30px
---
 app/assets/stylesheets/framework/modal.scss | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/app/assets/stylesheets/framework/modal.scss b/app/assets/stylesheets/framework/modal.scss
index f75e5b55506..f8b3a1966d7 100644
--- a/app/assets/stylesheets/framework/modal.scss
+++ b/app/assets/stylesheets/framework/modal.scss
@@ -85,9 +85,9 @@ body.modal-open {
 .modal {
   background-color: $black-transparent;
 
-  @include media-breakpoint-up(md) {
+  @include media-breakpoint-up(sm) {
     .modal-dialog {
-      margin: 30px auto;
+      margin: 64px auto;
     }
   }
 }

From 6feda1df3b53df3d2fb9f8ac076049fbf3ffc0f1 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Fri, 5 Jul 2019 16:25:58 +0000
Subject: [PATCH 111/195] Change absolute links to relative

Change assorted absolute links to ce and ee docs
to relative links
---
 doc/administration/gitaly/index.md            | 10 +++----
 doc/administration/logs.md                    |  2 +-
 doc/administration/raketasks/maintenance.md   |  2 +-
 .../github_integration.md                     |  2 +-
 doc/development/changelog.md                  |  2 +-
 doc/development/chatops_on_gitlabcom.md       |  2 +-
 doc/development/documentation/styleguide.md   |  2 +-
 doc/development/feature_flags/controls.md     |  4 +--
 doc/development/feature_flags/development.md  |  2 +-
 .../end_to_end/quick_start_guide.md           |  8 ++---
 doc/install/google_cloud_platform/index.md    |  6 ++--
 doc/raketasks/README.md                       |  2 +-
 .../application_development_platform/index.md | 30 +++++++++----------
 doc/university/README.md                      |  2 +-
 doc/user/project/integrations/webhooks.md     |  2 +-
 doc/user/project/issues/managing_issues.md    |  2 +-
 .../pages/getting_started_part_four.md        |  2 +-
 doc/workflow/repository_mirroring.md          |  4 +--
 18 files changed, 43 insertions(+), 43 deletions(-)

diff --git a/doc/administration/gitaly/index.md b/doc/administration/gitaly/index.md
index 7c7bb9045c7..b98383f30fc 100644
--- a/doc/administration/gitaly/index.md
+++ b/doc/administration/gitaly/index.md
@@ -441,12 +441,12 @@ and want to eliminate NFS from your environment altogether, there are
 a few things that you need to do:
 
  1. Make sure the [`git` user home directory](https://docs.gitlab.com/omnibus/settings/configuration.html#moving-the-home-directory-for-a-user) is on local disk.
- 1. Configure [database lookup of SSH keys](https://docs.gitlab.com/ce/administration/operations/fast_ssh_key_lookup.html)
+ 1. Configure [database lookup of SSH keys](../operations/fast_ssh_key_lookup.md)
  to eliminate the need for a shared authorized_keys file.
- 1. Configure [object storage for job artifacts](https://docs.gitlab.com/ce/administration/job_artifacts.html#using-object-storage)
- including [live tracing](https://docs.gitlab.com/ce/administration/job_traces.html#new-live-trace-architecture).
- 1. Configure [object storage for LFS objects](https://docs.gitlab.com/ce/workflow/lfs/lfs_administration.html#storing-lfs-objects-in-remote-object-storage).
- 1. Configure [object storage for uploads](https://docs.gitlab.com/ce/administration/uploads.html#using-object-storage-core-only).
+ 1. Configure [object storage for job artifacts](../job_artifacts.md#using-object-storage)
+ including [live tracing](../job_traces.md#new-live-trace-architecture).
+ 1. Configure [object storage for LFS objects](../../workflow/lfs/lfs_administration.md#storing-lfs-objects-in-remote-object-storage).
+ 1. Configure [object storage for uploads](../uploads.md#using-object-storage-core-only).
 
 NOTE: **Note:** One current feature of GitLab still requires a shared directory (NFS): [GitLab Pages](../../user/project/pages/index.md).
 There is [work in progress](https://gitlab.com/gitlab-org/gitlab-pages/issues/196)
diff --git a/doc/administration/logs.md b/doc/administration/logs.md
index b49d8c8a28f..5a2f389d298 100644
--- a/doc/administration/logs.md
+++ b/doc/administration/logs.md
@@ -4,7 +4,7 @@ GitLab has an advanced log system where everything is logged so that you
 can analyze your instance using various system log files. In addition to
 system log files, GitLab Enterprise Edition comes with Audit Events.
 Find more about them [in Audit Events
-documentation](https://docs.gitlab.com/ee/administration/audit_events.html)
+documentation](audit_events.md)
 
 System log files are typically plain text in a standard log file format.
 This guide talks about how to read and use these system log files.
diff --git a/doc/administration/raketasks/maintenance.md b/doc/administration/raketasks/maintenance.md
index becd480a08f..2b31233d429 100644
--- a/doc/administration/raketasks/maintenance.md
+++ b/doc/administration/raketasks/maintenance.md
@@ -61,7 +61,7 @@ It will check that each component was set up according to the installation guide
 
 You may also have a look at our Troubleshooting Guides:
 
-- [Troubleshooting Guide (GitLab)](http://docs.gitlab.com/ee/README.html#troubleshooting)
+- [Troubleshooting Guide (GitLab)](../index.md#troubleshooting)
 - [Troubleshooting Guide (Omnibus Gitlab)](https://docs.gitlab.com/omnibus/README.html#troubleshooting)
 
 **Omnibus Installation**
diff --git a/doc/ci/ci_cd_for_external_repos/github_integration.md b/doc/ci/ci_cd_for_external_repos/github_integration.md
index 53b36181062..36031c7929f 100644
--- a/doc/ci/ci_cd_for_external_repos/github_integration.md
+++ b/doc/ci/ci_cd_for_external_repos/github_integration.md
@@ -109,7 +109,7 @@ your repository:
    new commits.
 
     The web hook URL should be set to the GitLab API to
-    [trigger pull mirroring](https://docs.gitlab.com/ee/api/projects.html#start-the-pull-mirroring-process-for-a-project-starter),
+    [trigger pull mirroring](../../api/projects.md#start-the-pull-mirroring-process-for-a-project-starter),
     using the GitLab personal access token we just created.
 
     ```
diff --git a/doc/development/changelog.md b/doc/development/changelog.md
index 33c1c3bd9e4..f13c447fef2 100644
--- a/doc/development/changelog.md
+++ b/doc/development/changelog.md
@@ -35,7 +35,7 @@ the `author` field. GitLab team members **should not**.
 
 - Any user-facing change **should** have a changelog entry. Example: "GitLab now
   uses system fonts for all text."
-- Any change behind a feature flag **should not** have a changelog entry. The entry should be added [in the merge request removing the feature flags](https://docs.gitlab.com/ee/development/feature_flags.html#developing-with-feature-flags).
+- Any change behind a feature flag **should not** have a changelog entry. The entry should be added [in the merge request removing the feature flags](feature_flags/development.md).
 - A fix for a regression introduced and then fixed in the same release (i.e.,
   fixing a bug introduced during a monthly release candidate) **should not**
   have a changelog entry.
diff --git a/doc/development/chatops_on_gitlabcom.md b/doc/development/chatops_on_gitlabcom.md
index a7b402c3fb0..de942c0ae94 100644
--- a/doc/development/chatops_on_gitlabcom.md
+++ b/doc/development/chatops_on_gitlabcom.md
@@ -17,6 +17,6 @@ To request access to Chatops on GitLab.com:
 
 ## See also
 
- - [Chatops Usage](https://docs.gitlab.com/ee/ci/chatops/README.html)
+ - [Chatops Usage](../ci/chatops/README.md)
  - [Understanding EXPLAIN plans](understanding_explain_plans.md)
  - [Feature Groups](feature_flags/development.md#feature-groups)
diff --git a/doc/development/documentation/styleguide.md b/doc/development/documentation/styleguide.md
index 6bfedcb1047..d0a887b6175 100644
--- a/doc/development/documentation/styleguide.md
+++ b/doc/development/documentation/styleguide.md
@@ -393,7 +393,7 @@ Instead:
 Example:
 
 ```md
-For more information, see the [confidential issue](https://docs.gitlab.com/ee/user/project/issues/confidential_issues.html) `https://gitlab.com/gitlab-org/gitlab-ce/issues/<issue_number>`.
+For more information, see the [confidential issue](../../user/project/issues/confidential_issues.md) `https://gitlab.com/gitlab-org/gitlab-ce/issues/<issue_number>`.
 ```
 
 ### Unlinking emails
diff --git a/doc/development/feature_flags/controls.md b/doc/development/feature_flags/controls.md
index c67467b7c11..739f4207e27 100644
--- a/doc/development/feature_flags/controls.md
+++ b/doc/development/feature_flags/controls.md
@@ -5,7 +5,7 @@ GitLab Inc. provided environments such as staging and production, you need to
 have access to the chatops bot. Chatops bot is currently running on the ops instance,
 which is different from GitLab.com or dev.gitlab.org.
 
-Follow the Chatops document to [request access](https://docs.gitlab.com/ee/development/chatops_on_gitlabcom.html#requesting-access).
+Follow the Chatops document to [request access](../chatops_on_gitlabcom.md#requesting-access).
 
 Once you are added to the project test if your access propagated,
 run:
@@ -112,7 +112,7 @@ instances. Make sure to add the ~"feature flag" label to this merge request so
 release managers are aware the changes are hidden behind a feature flag. If the
 merge request has to be picked into a stable branch, make sure to also add the
 appropriate "Pick into X" label (e.g. "Pick into XX.X").
-See [the process document](https://docs.gitlab.com/ee/development/feature_flags/process.html#including-a-feature-behind-feature-flag-in-the-final-release) for further details.
+See [the process document](process.md#including-a-feature-behind-feature-flag-in-the-final-release) for further details.
 
 When a feature gate has been removed from the code base, the value still exists
 in the database.
diff --git a/doc/development/feature_flags/development.md b/doc/development/feature_flags/development.md
index 238052529d9..98773026122 100644
--- a/doc/development/feature_flags/development.md
+++ b/doc/development/feature_flags/development.md
@@ -57,7 +57,7 @@ the feature flag check will default to `true`.
 
 As an example, if you were to ship the backend half of a feature behind a flag,
 you'd want to explicitly disable that flag until the frontend half is also ready
-to be shipped. [You can do this via Chatops](https://docs.gitlab.com/ee/development/feature_flags/controls.html):
+to be shipped. [You can do this via Chatops](controls.md):
 
 ```
 /chatops run feature set some_feature 0
diff --git a/doc/development/testing_guide/end_to_end/quick_start_guide.md b/doc/development/testing_guide/end_to_end/quick_start_guide.md
index 041bdf716b3..064fb0e31dd 100644
--- a/doc/development/testing_guide/end_to_end/quick_start_guide.md
+++ b/doc/development/testing_guide/end_to_end/quick_start_guide.md
@@ -394,15 +394,15 @@ end
 
 By defining the `api_get_path` method, we allow the [`ApiFabricator`](https://gitlab.com/gitlab-org/gitlab-ee/blob/master/qa/qa/resource/api_fabricator.rb) module to know which path to use to get a single issue.
 
-> This `GET` path can be found in the [public API documentation](https://docs.gitlab.com/ee/api/issues.html#single-issue).
+> This `GET` path can be found in the [public API documentation](../../../api/issues.md#single-issue).
 
 By defining the `api_post_path` method, we allow the [`ApiFabricator`](https://gitlab.com/gitlab-org/gitlab-ee/blob/master/qa/qa/resource/api_fabricator.rb) module to know which path to use to create a new issue in a specific project.
 
-> This `POST` path can be found in the [public API documentation](https://docs.gitlab.com/ee/api/issues.html#new-issue).
+> This `POST` path can be found in the [public API documentation](../../../api/issues.md#new-issue).
 
 By defining the `api_post_body` method, we allow the [`ApiFabricator.api_post`](https://gitlab.com/gitlab-org/gitlab-ee/blob/a9177ca1812bac57e2b2fa4560e1d5dd8ffac38b/qa/qa/resource/api_fabricator.rb#L68) method to know which data to send when making the `POST` request.
 
-> Notice that we pass both `labels` and `title` attributes in the `api_post_body`, where `labels` receives an array of labels, and [`title` is required](https://docs.gitlab.com/ee/api/issues.html#new-issue). Also, notice that we keep them alphabetically organized.
+> Notice that we pass both `labels` and `title` attributes in the `api_post_body`, where `labels` receives an array of labels, and [`title` is required](../../../api/issues.md#new-issue). Also, notice that we keep them alphabetically organized.
 
 **Label resource**
 
@@ -441,7 +441,7 @@ By defining the `api_post_path` method, we allow for the [`ApiFabricator `](http
 
 By defining the `api_post_body` method, we we allow for the [`ApiFabricator.api_post`](https://gitlab.com/gitlab-org/gitlab-ee/blob/a9177ca1812bac57e2b2fa4560e1d5dd8ffac38b/qa/qa/resource/api_fabricator.rb#L68) method to know which data to send when making the `POST` request.
 
-> Notice that we pass both `color` and `name` attributes in the `api_post_body` since [those are required](https://docs.gitlab.com/ee/api/labels.html#create-a-new-label). Also, notice that we keep them alphabetically organized.
+> Notice that we pass both `color` and `name` attributes in the `api_post_body` since [those are required](../../../api/labels.md#create-a-new-label). Also, notice that we keep them alphabetically organized.
 
 ### 8. Page Objects
 
diff --git a/doc/install/google_cloud_platform/index.md b/doc/install/google_cloud_platform/index.md
index 77c61acbfd4..2070187255a 100644
--- a/doc/install/google_cloud_platform/index.md
+++ b/doc/install/google_cloud_platform/index.md
@@ -128,9 +128,9 @@ GitLab can be configured to authenticate with other OAuth providers, LDAP, SAML,
 Kerberos, etc. Here are some documents you might be interested in reading:
 
 - [Omnibus GitLab documentation](https://docs.gitlab.com/omnibus/)
-- [Integration documentation](https://docs.gitlab.com/ce/integration/)
-- [GitLab Pages configuration](https://docs.gitlab.com/ce/administration/pages/index.html)
-- [GitLab Container Registry configuration](https://docs.gitlab.com/ce/administration/container_registry.html)
+- [Integration documentation](../../integration/README.md)
+- [GitLab Pages configuration](../../administration/pages/index.md)
+- [GitLab Container Registry configuration](../../administration/container_registry.md)
 
 [freetrial]: https://console.cloud.google.com/freetrial "GCP free trial"
 [ip]: https://cloud.google.com/compute/docs/configure-instance-ip-addresses#promote_ephemeral_ip "Configuring an Instance's IP Addresses"
diff --git a/doc/raketasks/README.md b/doc/raketasks/README.md
index 0729875daf8..b28f21f83a9 100644
--- a/doc/raketasks/README.md
+++ b/doc/raketasks/README.md
@@ -13,6 +13,6 @@ comments: false
 - [User management](user_management.md)
 - [Webhooks](web_hooks.md)
 - [Import](import.md) of git repositories in bulk
-- [Rebuild authorized_keys file](http://docs.gitlab.com/ce/raketasks/maintenance.html#rebuild-authorized_keys-file) task for administrators
+- [Rebuild authorized_keys file](../administration/raketasks/maintenance.md#rebuild-authorized_keys-file) task for administrators
 - [Migrate Uploads](../administration/raketasks/uploads/migrate.md)
 - [Sanitize Uploads](../administration/raketasks/uploads/sanitize.md)
diff --git a/doc/topics/application_development_platform/index.md b/doc/topics/application_development_platform/index.md
index 8742606479d..2ea561eb943 100644
--- a/doc/topics/application_development_platform/index.md
+++ b/doc/topics/application_development_platform/index.md
@@ -9,10 +9,10 @@ The GitLab Application Development Platform aims to:
 
 - Reduce and even eliminate the time it takes for an Operations team
   to provide a full environment for software developers.
-- Get developers up and running fast so they can focus on writing 
+- Get developers up and running fast so they can focus on writing
   great applications with a robust development feature set.
-- Provide best-of-breed security features so that applications developed 
-  with GitLab are not affected by vulnerabilities that may lead to security 
+- Provide best-of-breed security features so that applications developed
+  with GitLab are not affected by vulnerabilities that may lead to security
   problems and unintended use.
 
 It is comprised of the following high-level elements:
@@ -35,28 +35,28 @@ with various cloud providers.
 ### Build, test, deploy
 
 In order to provide modern DevOps workflows, our Application Development Platform will rely on
-[Auto DevOps](https://docs.gitlab.com/ee/topics/autodevops/) to provide those workflows. Auto DevOps works with 
-any Kubernetes cluster; you're not limited to running on GitLab's infrastructure. Additionally, Auto DevOps offers 
-an incremental consumption path. Because it is [composable](https://docs.gitlab.com/ee/topics/autodevops/#using-components-of-auto-devops),
+[Auto DevOps](../autodevops/index.md) to provide those workflows. Auto DevOps works with
+any Kubernetes cluster; you're not limited to running on GitLab's infrastructure. Additionally, Auto DevOps offers
+an incremental consumption path. Because it is [composable](../autodevops/index.md#using-components-of-auto-devops),
 you can use as much or as little of the default pipeline as you'd like, and deeply customize without having to integrate a completely different platform.
 
 ### Security
 
-The Application Development Platform helps you ensure that the applications you create are not affected by vulnerabilities 
+The Application Development Platform helps you ensure that the applications you create are not affected by vulnerabilities
 that may lead to security problems and unintended use. This can be achieved by making use of the embedded security features of Auto DevOps,
-which inform security teams and developers if there is something to consider changing in their apps 
+which inform security teams and developers if there is something to consider changing in their apps
 before it is too late to create a preventative fix. The following features are included:
 
-- [Auto SAST (Static Application Security Testing)](https://docs.gitlab.com/ee/topics/autodevops/#auto-sast-ultimate)
-- [Auto Dependency Scanning](https://docs.gitlab.com/ee/topics/autodevops/#auto-dependency-scanning-ultimate)
-- [Auto Container Scanning](https://docs.gitlab.com/ee/topics/autodevops/#auto-container-scanning-ultimate)
-- [Auto DAST (Dynamic Application Security Testing)](https://docs.gitlab.com/ee/topics/autodevops/#auto-dast-ultimate)
+- [Auto SAST (Static Application Security Testing)](../autodevops/index.md#auto-sast-ultimate)
+- [Auto Dependency Scanning](../autodevops/index.md#auto-dependency-scanning-ultimate)
+- [Auto Container Scanning](../autodevops/index.md#auto-container-scanning-ultimate)
+- [Auto DAST (Dynamic Application Security Testing)](../autodevops/index.md#auto-dast-ultimate)
 
 ### Observability
 
 Performance is a critical aspect of the user experience, and ensuring your application is responsive and available is everyone's
-responsibility. The Application Development Platform integrates key performance analytics and feedback 
+responsibility. The Application Development Platform integrates key performance analytics and feedback
 into GitLab, automatically. The following features are included:
 
-- [Auto Monitoring](https://docs.gitlab.com/ee/topics/autodevops/#auto-monitoring)
-- [In-app Kubernetes Pod Logs](https://docs.gitlab.com/ee/user/project/clusters/kubernetes_pod_logs.html)
\ No newline at end of file
+- [Auto Monitoring](../autodevops/index.md#auto-monitoring)
+- [In-app Kubernetes Pod Logs](../../user/project/clusters/kubernetes_pod_logs.md)
diff --git a/doc/university/README.md b/doc/university/README.md
index 9d861460618..f696db2df20 100644
--- a/doc/university/README.md
+++ b/doc/university/README.md
@@ -73,7 +73,7 @@ The GitLab University curriculum is composed of GitLab videos, screencasts, pres
    - Being part of our Great Community and Contributing to GitLab
 1. [Getting Started with the GitLab Development Kit (GDK)](https://about.gitlab.com/2016/06/08/getting-started-with-gitlab-development-kit/)
 1. [Contributing Technical Articles to the GitLab Blog](https://about.gitlab.com/2016/01/26/call-for-writers/)
-1. [GitLab Training Workshops](https://docs.gitlab.com/ce/university/training/end-user/)
+1. [GitLab Training Workshops](training/end-user/README.md)
 1. [GitLab Professional Services](https://about.gitlab.com/services/)
 
 ### 1.8 GitLab Training Material
diff --git a/doc/user/project/integrations/webhooks.md b/doc/user/project/integrations/webhooks.md
index 04a9d9568ca..30940b65454 100644
--- a/doc/user/project/integrations/webhooks.md
+++ b/doc/user/project/integrations/webhooks.md
@@ -24,7 +24,7 @@ to the webhook URL.
 
 In most cases, you'll need to set up your own [webhook receiver](#example-webhook-receiver)
 to receive information from GitLab, and send it to another app, according to your needs.
-We already have a [built-in receiver](https://docs.gitlab.com/ce/project_services/slack.html)
+We already have a [built-in receiver](slack.md)
 for sending [Slack](https://api.slack.com/incoming-webhooks) notifications _per project_.
 
 ## Overview
diff --git a/doc/user/project/issues/managing_issues.md b/doc/user/project/issues/managing_issues.md
index 91dbf0d848e..1eb835d4606 100644
--- a/doc/user/project/issues/managing_issues.md
+++ b/doc/user/project/issues/managing_issues.md
@@ -115,7 +115,7 @@ The "Move issue" button is at the bottom of the right-sidebar when viewing the i
 
 If you have advanced technical skills you can also bulk move all the issues from one project to another in the rails console. The below script will move all the issues from one project to another that are not in status **closed**.
 
-To access rails console run `sudo gitlab-rails console` on the GitLab server and run the below script. Please be sure to change **project**, **admin_user** and **target_project** to your values. We do also recommend [creating a backup](https://docs.gitlab.com/ee/raketasks/backup_restore.html#creating-a-backup-of-the-gitlab-system) before attempting any changes in the console.
+To access rails console run `sudo gitlab-rails console` on the GitLab server and run the below script. Please be sure to change **project**, **admin_user** and **target_project** to your values. We do also recommend [creating a backup](../../../raketasks/backup_restore.md#creating-a-backup-of-the-gitlab-system) before attempting any changes in the console.
 
 ```ruby
 project = Project.find_by_full_path('full path of the project where issues are moved from')
diff --git a/doc/user/project/pages/getting_started_part_four.md b/doc/user/project/pages/getting_started_part_four.md
index 8baf41dba78..d844d4222b1 100644
--- a/doc/user/project/pages/getting_started_part_four.md
+++ b/doc/user/project/pages/getting_started_part_four.md
@@ -380,7 +380,7 @@ What you can do with GitLab CI is pretty much up to your
 creativity. Once you get used to it, you start creating
 awesome scripts that automate most of tasks you'd do
 manually in the past. Read through the
-[documentation of GitLab CI](https://docs.gitlab.com/ce/ci/yaml/README.html)
+[documentation of GitLab CI](../../../ci/yaml/README.md)
 to understand how to go even further on your scripts.
 
 - On this blog post, understand the concept of
diff --git a/doc/workflow/repository_mirroring.md b/doc/workflow/repository_mirroring.md
index 5a24c254ed1..92e88ea224a 100644
--- a/doc/workflow/repository_mirroring.md
+++ b/doc/workflow/repository_mirroring.md
@@ -286,10 +286,10 @@ project mirroring again by [Forcing an update](#forcing-an-update-core).
 [GitLab Starter](https://about.gitlab.com/pricing/) 10.3.
 
 Pull mirroring uses polling to detect new branches and commits added upstream, often minutes
-afterwards. If you notify GitLab by [API](https://docs.gitlab.com/ee/api/projects.html#start-the-pull-mirroring-process-for-a-project-starter),
+afterwards. If you notify GitLab by [API](../api/projects.md#start-the-pull-mirroring-process-for-a-project-starter),
 updates will be pulled immediately.
 
-For more information, see [Start the pull mirroring process for a Project](https://docs.gitlab.com/ee/api/projects.html#start-the-pull-mirroring-process-for-a-project-starter).
+For more information, see [Start the pull mirroring process for a Project](../api/projects.md#start-the-pull-mirroring-process-for-a-project-starter).
 
 ## Forcing an update **[CORE]**
 

From 1897ec48d3ea4bea0a501e88944eeffc7e16ca70 Mon Sep 17 00:00:00 2001
From: David Palubin <dpalubin@gmail.com>
Date: Fri, 5 Jul 2019 16:42:51 +0000
Subject: [PATCH 112/195] Remove unresolved class and fixed height in
 discussion header

---
 .../notes/components/noteable_discussion.vue      | 15 +++------------
 app/assets/stylesheets/pages/notes.scss           | 12 +++++-------
 ...move-unresolved-class-in-discussion-header.yml |  5 +++++
 3 files changed, 13 insertions(+), 19 deletions(-)
 create mode 100644 changelogs/unreleased/Remove-unresolved-class-in-discussion-header.yml

diff --git a/app/assets/javascripts/notes/components/noteable_discussion.vue b/app/assets/javascripts/notes/components/noteable_discussion.vue
index 3fbd0a9f715..ac743d9f4b8 100644
--- a/app/assets/javascripts/notes/components/noteable_discussion.vue
+++ b/app/assets/javascripts/notes/components/noteable_discussion.vue
@@ -144,15 +144,6 @@ export default {
 
       return {};
     },
-    componentClassName() {
-      if (this.shouldRenderDiffs) {
-        if (!this.lastUpdatedAt && !this.discussion.resolved) {
-          return 'unresolved';
-        }
-      }
-
-      return '';
-    },
     isExpanded() {
       return this.discussion.expanded || this.alwaysExpanded;
     },
@@ -313,11 +304,11 @@ export default {
 </script>
 
 <template>
-  <timeline-entry-item class="note note-discussion" :class="componentClassName">
+  <timeline-entry-item class="note note-discussion">
     <div class="timeline-content">
       <div :data-discussion-id="discussion.id" class="discussion js-discussion-container">
         <div v-if="shouldRenderDiffs" class="discussion-header note-wrapper">
-          <div v-once class="timeline-icon">
+          <div v-once class="timeline-icon align-self-start flex-shrink-0">
             <user-avatar-link
               v-if="author"
               :link-href="author.path"
@@ -326,7 +317,7 @@ export default {
               :img-size="40"
             />
           </div>
-          <div class="timeline-content">
+          <div class="timeline-content w-100">
             <note-header
               :author="author"
               :created-at="firstNote.created_at"
diff --git a/app/assets/stylesheets/pages/notes.scss b/app/assets/stylesheets/pages/notes.scss
index 7bd1a4138e4..0cf8e4a7314 100644
--- a/app/assets/stylesheets/pages/notes.scss
+++ b/app/assets/stylesheets/pages/notes.scss
@@ -598,7 +598,8 @@ $note-form-margin-left: 72px;
 }
 
 .discussion-header {
-  min-height: 74px;
+  min-height: $line-height-base * 2em;
+  box-sizing: content-box;
 
   .note-header-info {
     padding-bottom: 0;
@@ -608,13 +609,10 @@ $note-form-margin-left: 72px;
     overflow-x: auto;
     overflow-y: hidden;
   }
-}
 
-.unresolved {
-  .discussion-header {
-    .note-header-info {
-      margin-top: $gl-padding-8;
-    }
+  &.note-wrapper {
+    display: flex;
+    align-items: center;
   }
 }
 
diff --git a/changelogs/unreleased/Remove-unresolved-class-in-discussion-header.yml b/changelogs/unreleased/Remove-unresolved-class-in-discussion-header.yml
new file mode 100644
index 00000000000..3695f3063f3
--- /dev/null
+++ b/changelogs/unreleased/Remove-unresolved-class-in-discussion-header.yml
@@ -0,0 +1,5 @@
+---
+title: Remove unresolved class and fixed height in discussion header
+merge_request: 28440
+author: David Palubin
+type: other

From f6df1eaff5d59930332ac51bd48f1be783d0126f Mon Sep 17 00:00:00 2001
From: Kyohei Uemura <kyohei1.uemura@toshiba.co.jp>
Date: Fri, 5 Jul 2019 17:09:21 +0000
Subject: [PATCH 113/195] Update installation.md

Line 170(make install) causes permission error.
This command should execute with sudo.
---
 doc/install/installation.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/install/installation.md b/doc/install/installation.md
index 70e5ab28931..e9206469e5d 100644
--- a/doc/install/installation.md
+++ b/doc/install/installation.md
@@ -167,7 +167,7 @@ cd pcre2-10.33
 chmod +x configure
 ./configure --prefix=/usr --enable-jit
 make
-make install
+sudo make install
 
 # Download and compile from source
 cd /tmp
@@ -634,8 +634,8 @@ Gitaly must be running for the next section.
 gitlab_path=/home/git/gitlab
 gitaly_path=/home/git/gitaly
 
-sudo -u git -H $gitlab_path/bin/daemon_with_pidfile $gitlab_path/tmp/pids/gitaly.pid \
-  $gitaly_path/gitaly $gitaly_path/config.toml >> $gitlab_path/log/gitaly.log 2>&1 &
+sudo -u git -H sh -c "$gitlab_path/bin/daemon_with_pidfile $gitlab_path/tmp/pids/gitaly.pid \
+  $gitaly_path/gitaly $gitaly_path/config.toml >> $gitlab_path/log/gitaly.log 2>&1 &"
 ```
 
 ### Initialize Database and Activate Advanced Features

From 32f44cb1cdb5c6b128353a2614b5d6db5e343db6 Mon Sep 17 00:00:00 2001
From: Evan Read <eread@gitlab.com>
Date: Fri, 5 Jul 2019 17:14:04 +0000
Subject: [PATCH 114/195] Edit new text on visibility setting

---
 doc/user/gitlab_com/index.md | 16 +++++++---------
 1 file changed, 7 insertions(+), 9 deletions(-)

diff --git a/doc/user/gitlab_com/index.md b/doc/user/gitlab_com/index.md
index 886fb6e6f55..769a22315be 100644
--- a/doc/user/gitlab_com/index.md
+++ b/doc/user/gitlab_com/index.md
@@ -73,9 +73,9 @@ or over the size limit, you can [reduce your repository size with Git](../projec
 
 ## IP range
 
-GitLab.com, CI/CD, and related services are deployed into Google Cloud Platform (GCP). Any 
-IP based firewall can be configured by looking up all 
-[IP address ranges or CIDR blocks for GCP](https://cloud.google.com/compute/docs/faq#where_can_i_find_product_name_short_ip_ranges). 
+GitLab.com, CI/CD, and related services are deployed into Google Cloud Platform (GCP). Any
+IP based firewall can be configured by looking up all
+[IP address ranges or CIDR blocks for GCP](https://cloud.google.com/compute/docs/faq#where_can_i_find_product_name_short_ip_ranges).
 
 [Static endpoints](https://gitlab.com/gitlab-com/gl-infra/infrastructure/issues/5071) are being considered.
 
@@ -353,12 +353,10 @@ High Performance TCP/HTTP Load Balancer:
 [4010]: https://gitlab.com/gitlab-com/infrastructure/issues/4010 "Find a good value for maximum timeout for Shared Runners"
 [4070]: https://gitlab.com/gitlab-com/infrastructure/issues/4070 "Configure per-runner timeout for shared-runners-manager-X on GitLab.com"
 
-## Other admin area settings
+## Group and project settings
 
-This area highlights other noteworthy admin area settings on GitLab.com that differ from default settings. This list is not exhaustive.
+On GitLab.com, projects, groups, and snippets created
+after July 2019 have the `Internal` visibility setting disabled.
 
-NOTE: **Note:**
-From July 2019, the `Internal` visibility setting is disabled for new projects, groups, 
-and snippets on GitLab.com. Existing projects, groups, and snippets using the `Internal`
-visibility setting keep this setting. You can read more about the change in the
+You can read more about the change in the
 [relevant issue](https://gitlab.com/gitlab-org/gitlab-ee/issues/12388).

From 8152e1aa4a039056d3010180051e6935b20d3656 Mon Sep 17 00:00:00 2001
From: John Cai <jcai@gitlab.com>
Date: Fri, 14 Jun 2019 18:22:26 -0700
Subject: [PATCH 115/195] Use Rugged if we detect storage is NFS and we can
 access the disk

Add a module we use as a singleton to determine whether or not rails is
able to access the disk
---
 .../unreleased/jc-detect-nfs-for-rugged.yml   |  5 +
 lib/gitlab/git/rugged_impl/blob.rb            |  3 +-
 lib/gitlab/git/rugged_impl/commit.rb          |  8 +-
 lib/gitlab/git/rugged_impl/repository.rb      |  3 +-
 lib/gitlab/git/rugged_impl/tree.rb            |  3 +-
 lib/gitlab/git/rugged_impl/use_rugged.rb      | 16 +++
 lib/gitlab/gitaly_client.rb                   | 40 ++++++++
 .../cache/ci/project_pipeline_status_spec.rb  |  1 +
 spec/lib/gitlab/git/commit_spec.rb            |  2 +-
 .../gitlab/git/rugged_impl/use_rugged_spec.rb | 97 +++++++++++++++++++
 10 files changed, 171 insertions(+), 7 deletions(-)
 create mode 100644 changelogs/unreleased/jc-detect-nfs-for-rugged.yml
 create mode 100644 lib/gitlab/git/rugged_impl/use_rugged.rb
 create mode 100644 spec/lib/gitlab/git/rugged_impl/use_rugged_spec.rb

diff --git a/changelogs/unreleased/jc-detect-nfs-for-rugged.yml b/changelogs/unreleased/jc-detect-nfs-for-rugged.yml
new file mode 100644
index 00000000000..ca738181a55
--- /dev/null
+++ b/changelogs/unreleased/jc-detect-nfs-for-rugged.yml
@@ -0,0 +1,5 @@
+---
+title: Use Rugged if we detect storage is NFS and we can access the disk
+merge_request: 29725
+author:
+type: performance
diff --git a/lib/gitlab/git/rugged_impl/blob.rb b/lib/gitlab/git/rugged_impl/blob.rb
index 11ee4ebda4b..86c9f33d82a 100644
--- a/lib/gitlab/git/rugged_impl/blob.rb
+++ b/lib/gitlab/git/rugged_impl/blob.rb
@@ -11,10 +11,11 @@ module Gitlab
       module Blob
         module ClassMethods
           extend ::Gitlab::Utils::Override
+          include Gitlab::Git::RuggedImpl::UseRugged
 
           override :tree_entry
           def tree_entry(repository, sha, path, limit)
-            if Feature.enabled?(:rugged_tree_entry)
+            if use_rugged?(repository, :rugged_tree_entry)
               rugged_tree_entry(repository, sha, path, limit)
             else
               super
diff --git a/lib/gitlab/git/rugged_impl/commit.rb b/lib/gitlab/git/rugged_impl/commit.rb
index bce4fa14fb4..971a33b2e99 100644
--- a/lib/gitlab/git/rugged_impl/commit.rb
+++ b/lib/gitlab/git/rugged_impl/commit.rb
@@ -12,6 +12,7 @@ module Gitlab
       module Commit
         module ClassMethods
           extend ::Gitlab::Utils::Override
+          include Gitlab::Git::RuggedImpl::UseRugged
 
           def rugged_find(repo, commit_id)
             obj = repo.rev_parse_target(commit_id)
@@ -34,7 +35,7 @@ module Gitlab
 
           override :find_commit
           def find_commit(repo, commit_id)
-            if Feature.enabled?(:rugged_find_commit)
+            if use_rugged?(repo, :rugged_find_commit)
               rugged_find(repo, commit_id)
             else
               super
@@ -43,7 +44,7 @@ module Gitlab
 
           override :batch_by_oid
           def batch_by_oid(repo, oids)
-            if Feature.enabled?(:rugged_list_commits_by_oid)
+            if use_rugged?(repo, :rugged_list_commits_by_oid)
               rugged_batch_by_oid(repo, oids)
             else
               super
@@ -52,6 +53,7 @@ module Gitlab
         end
 
         extend ::Gitlab::Utils::Override
+        include Gitlab::Git::RuggedImpl::UseRugged
 
         override :init_commit
         def init_commit(raw_commit)
@@ -65,7 +67,7 @@ module Gitlab
 
         override :commit_tree_entry
         def commit_tree_entry(path)
-          if Feature.enabled?(:rugged_commit_tree_entry)
+          if use_rugged?(@repository, :rugged_commit_tree_entry)
             rugged_tree_entry(path)
           else
             super
diff --git a/lib/gitlab/git/rugged_impl/repository.rb b/lib/gitlab/git/rugged_impl/repository.rb
index e91b0ddcd31..9268abdfed9 100644
--- a/lib/gitlab/git/rugged_impl/repository.rb
+++ b/lib/gitlab/git/rugged_impl/repository.rb
@@ -11,6 +11,7 @@ module Gitlab
     module RuggedImpl
       module Repository
         extend ::Gitlab::Utils::Override
+        include Gitlab::Git::RuggedImpl::UseRugged
 
         FEATURE_FLAGS = %i(rugged_find_commit rugged_tree_entries rugged_tree_entry rugged_commit_is_ancestor rugged_commit_tree_entry rugged_list_commits_by_oid).freeze
 
@@ -46,7 +47,7 @@ module Gitlab
 
         override :ancestor?
         def ancestor?(from, to)
-          if Feature.enabled?(:rugged_commit_is_ancestor)
+          if use_rugged?(self, :rugged_commit_is_ancestor)
             rugged_is_ancestor?(from, to)
           else
             super
diff --git a/lib/gitlab/git/rugged_impl/tree.rb b/lib/gitlab/git/rugged_impl/tree.rb
index 9c37bb01961..f3721a3f1b7 100644
--- a/lib/gitlab/git/rugged_impl/tree.rb
+++ b/lib/gitlab/git/rugged_impl/tree.rb
@@ -11,10 +11,11 @@ module Gitlab
       module Tree
         module ClassMethods
           extend ::Gitlab::Utils::Override
+          include Gitlab::Git::RuggedImpl::UseRugged
 
           override :tree_entries
           def tree_entries(repository, sha, path, recursive)
-            if Feature.enabled?(:rugged_tree_entries)
+            if use_rugged?(repository, :rugged_tree_entries)
               tree_entries_with_flat_path_from_rugged(repository, sha, path, recursive)
             else
               super
diff --git a/lib/gitlab/git/rugged_impl/use_rugged.rb b/lib/gitlab/git/rugged_impl/use_rugged.rb
new file mode 100644
index 00000000000..99091b03cd1
--- /dev/null
+++ b/lib/gitlab/git/rugged_impl/use_rugged.rb
@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Gitlab
+  module Git
+    module RuggedImpl
+      module UseRugged
+        def use_rugged?(repo, feature_key)
+          feature = Feature.get(feature_key)
+          return feature.enabled? if Feature.persisted?(feature)
+
+          Gitlab::GitalyClient.can_use_disk?(repo.storage)
+        end
+      end
+    end
+  end
+end
diff --git a/lib/gitlab/gitaly_client.rb b/lib/gitlab/gitaly_client.rb
index 47976389af6..71ff1f74798 100644
--- a/lib/gitlab/gitaly_client.rb
+++ b/lib/gitlab/gitaly_client.rb
@@ -30,6 +30,7 @@ module Gitlab
     SERVER_VERSION_FILE = 'GITALY_SERVER_VERSION'
     MAXIMUM_GITALY_CALLS = 30
     CLIENT_NAME = (Sidekiq.server? ? 'gitlab-sidekiq' : 'gitlab-web').freeze
+    GITALY_METADATA_FILENAME = '.gitaly-metadata'
 
     MUTEX = Mutex.new
 
@@ -387,6 +388,45 @@ module Gitlab
       0
     end
 
+    def self.storage_metadata_file_path(storage)
+      Gitlab::GitalyClient::StorageSettings.allow_disk_access do
+        File.join(
+          Gitlab.config.repositories.storages[storage].legacy_disk_path, GITALY_METADATA_FILENAME
+        )
+      end
+    end
+
+    def self.can_use_disk?(storage)
+      cached_value = MUTEX.synchronize do
+        @can_use_disk ||= {}
+        @can_use_disk[storage]
+      end
+
+      return cached_value unless cached_value.nil?
+
+      gitaly_filesystem_id = filesystem_id(storage)
+      direct_filesystem_id = filesystem_id_from_disk(storage)
+
+      MUTEX.synchronize do
+        @can_use_disk[storage] = gitaly_filesystem_id.present? &&
+          gitaly_filesystem_id == direct_filesystem_id
+      end
+    end
+
+    def self.filesystem_id(storage)
+      response = Gitlab::GitalyClient::ServerService.new(storage).info
+      storage_status = response.storage_statuses.find { |status| status.storage_name == storage }
+      storage_status.filesystem_id
+    end
+
+    def self.filesystem_id_from_disk(storage)
+      metadata_file = File.read(storage_metadata_file_path(storage))
+      metadata_hash = JSON.parse(metadata_file)
+      metadata_hash['gitaly_filesystem_id']
+    rescue Errno::ENOENT, JSON::ParserError
+      nil
+    end
+
     def self.timeout(timeout_name)
       Gitlab::CurrentSettings.current_application_settings[timeout_name]
     end
diff --git a/spec/lib/gitlab/cache/ci/project_pipeline_status_spec.rb b/spec/lib/gitlab/cache/ci/project_pipeline_status_spec.rb
index 483c5ea9cff..972dd7e0d2b 100644
--- a/spec/lib/gitlab/cache/ci/project_pipeline_status_spec.rb
+++ b/spec/lib/gitlab/cache/ci/project_pipeline_status_spec.rb
@@ -26,6 +26,7 @@ describe Gitlab::Cache::Ci::ProjectPipelineStatus, :clean_gitlab_redis_cache do
       end
 
       it 'loads 10 projects without hitting Gitaly call limit', :request_store do
+        allow(Gitlab::GitalyClient).to receive(:can_access_disk?).and_return(false)
         projects = Gitlab::GitalyClient.allow_n_plus_1_calls do
           (1..10).map { create(:project, :repository) }
         end
diff --git a/spec/lib/gitlab/git/commit_spec.rb b/spec/lib/gitlab/git/commit_spec.rb
index 25052a79916..3f0e6b34291 100644
--- a/spec/lib/gitlab/git/commit_spec.rb
+++ b/spec/lib/gitlab/git/commit_spec.rb
@@ -408,7 +408,7 @@ describe Gitlab::Git::Commit, :seed_helper do
 
       context 'when oids is empty' do
         it 'makes no Gitaly request' do
-          expect(Gitlab::GitalyClient).not_to receive(:call)
+          expect(Gitlab::GitalyClient).not_to receive(:call).with(repository.storage, :commit_service, :list_commits_by_oid)
 
           described_class.batch_by_oid(repository, [])
         end
diff --git a/spec/lib/gitlab/git/rugged_impl/use_rugged_spec.rb b/spec/lib/gitlab/git/rugged_impl/use_rugged_spec.rb
new file mode 100644
index 00000000000..f957ed00945
--- /dev/null
+++ b/spec/lib/gitlab/git/rugged_impl/use_rugged_spec.rb
@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+require 'json'
+require 'tempfile'
+
+describe Gitlab::Git::RuggedImpl::UseRugged, :seed_helper do
+  let(:project) { create(:project, :repository) }
+  let(:repository) { project.repository }
+  let(:feature_flag_name) { 'feature-flag-name' }
+  let(:feature_flag) { Feature.get(feature_flag_name) }
+  let(:temp_gitaly_metadata_file) { create_temporary_gitaly_metadata_file }
+
+  before(:all) do
+    create_gitaly_metadata_file
+  end
+
+  subject(:wrapper) do
+    klazz = Class.new { include Gitlab::Git::RuggedImpl::UseRugged }
+    klazz.new
+  end
+
+  before do
+    Gitlab::GitalyClient.instance_variable_set(:@can_use_disk, {})
+  end
+
+  context 'when feature flag is not persisted' do
+    before do
+      allow(Feature).to receive(:persisted?).with(feature_flag).and_return(false)
+    end
+
+    it 'returns true when gitaly matches disk' do
+      expect(subject.use_rugged?(repository, feature_flag_name)).to be true
+    end
+
+    it 'returns false when disk access fails' do
+      allow(Gitlab::GitalyClient).to receive(:storage_metadata_file_path).and_return("/fake/path/doesnt/exist")
+
+      expect(subject.use_rugged?(repository, feature_flag_name)).to be false
+    end
+
+    it "returns false when gitaly doesn't match disk" do
+      allow(Gitlab::GitalyClient).to receive(:storage_metadata_file_path).and_return(temp_gitaly_metadata_file)
+
+      expect(subject.use_rugged?(repository, feature_flag_name)).to be_falsey
+
+      File.delete(temp_gitaly_metadata_file)
+    end
+
+    it "doesn't lead to a second rpc call because gitaly client should use the cached value" do
+      expect(subject.use_rugged?(repository, feature_flag_name)).to be true
+
+      expect(Gitlab::GitalyClient).not_to receive(:filesystem_id)
+
+      subject.use_rugged?(repository, feature_flag_name)
+    end
+  end
+
+  context 'when feature flag is persisted' do
+    before do
+      allow(Feature).to receive(:persisted?).with(feature_flag).and_return(true)
+    end
+
+    it 'returns false when the feature flag is off' do
+      allow(feature_flag).to receive(:enabled?).and_return(false)
+
+      expect(subject.use_rugged?(repository, feature_flag_name)).to be_falsey
+    end
+
+    it "returns true when feature flag is on" do
+      allow(feature_flag).to receive(:enabled?).and_return(true)
+      allow(Gitlab::GitalyClient).to receive(:can_use_disk?).and_return(false)
+
+      expect(subject.use_rugged?(repository, feature_flag_name)).to be true
+    end
+  end
+
+  def create_temporary_gitaly_metadata_file
+    tmp = Tempfile.new('.gitaly-metadata')
+    gitaly_metadata = {
+      "gitaly_filesystem_id" => "some-value"
+    }
+    tmp.write(gitaly_metadata.to_json)
+    tmp.flush
+    tmp.close
+    tmp.path
+  end
+
+  def create_gitaly_metadata_file
+    File.open(File.join(SEED_STORAGE_PATH, '.gitaly-metadata'), 'w+') do |f|
+      gitaly_metadata = {
+        "gitaly_filesystem_id" => SecureRandom.uuid
+      }
+      f.write(gitaly_metadata.to_json)
+    end
+  end
+end

From 840e6fdb8f4194f6ca52b245d67199f3d2a41b3c Mon Sep 17 00:00:00 2001
From: Douwe Maan <douwe@selenight.nl>
Date: Fri, 5 Jul 2019 19:18:15 +0200
Subject: [PATCH 116/195] Add queue_size method to ApplicationWorker

---
 app/workers/concerns/application_worker.rb | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/app/workers/concerns/application_worker.rb b/app/workers/concerns/application_worker.rb
index 25c3a945077..2b36ccb8304 100644
--- a/app/workers/concerns/application_worker.rb
+++ b/app/workers/concerns/application_worker.rb
@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'sidekiq/api'
+
 Sidekiq::Worker.extend ActiveSupport::Concern
 
 module ApplicationWorker
@@ -44,6 +46,10 @@ module ApplicationWorker
       get_sidekiq_options['queue'].to_s
     end
 
+    def queue_size
+      Sidekiq::Queue.new(queue).size
+    end
+
     def bulk_perform_async(args_list)
       Sidekiq::Client.push_bulk('class' => self, 'args' => args_list)
     end

From 7c8ce1fe1733761a444c9a203c04ce4853137847 Mon Sep 17 00:00:00 2001
From: Walmyr Lima <walmyr@gitlab.com>
Date: Fri, 5 Jul 2019 20:15:22 +0200
Subject: [PATCH 117/195] Refactor end-to-end test

- to be explicit when fabricating resources via API or browser UI
- and to improve test speed by fabricating some resources via API
instead of via the GUI.
---
 .../browser_ui/2_plan/issue/check_mentions_for_xss_spec.rb | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/qa/qa/specs/features/browser_ui/2_plan/issue/check_mentions_for_xss_spec.rb b/qa/qa/specs/features/browser_ui/2_plan/issue/check_mentions_for_xss_spec.rb
index 013cea0a40e..5eceeb9661c 100644
--- a/qa/qa/specs/features/browser_ui/2_plan/issue/check_mentions_for_xss_spec.rb
+++ b/qa/qa/specs/features/browser_ui/2_plan/issue/check_mentions_for_xss_spec.rb
@@ -9,12 +9,12 @@ module QA
         Runtime::Browser.visit(:gitlab, Page::Main::Login)
         Page::Main::Login.perform(&:sign_in_using_credentials)
 
-        user = Resource::User.fabricate! do |user|
+        user = Resource::User.fabricate_via_api! do |user|
           user.name = "eve <img src=x onerror=alert(2)&lt;img src=x onerror=alert(1)&gt;"
           user.password = "test1234"
         end
 
-        project = Resource::Project.fabricate! do |resource|
+        project = Resource::Project.fabricate_via_api! do |resource|
           resource.name = 'xss-test-for-mentions-project'
         end
         project.visit!
@@ -24,10 +24,11 @@ module QA
           page.add_member(user.username)
         end
 
-        Resource::Issue.fabricate_via_browser_ui! do |issue|
+        issue = Resource::Issue.fabricate_via_api! do |issue|
           issue.title = issue_title
           issue.project = project
         end
+        issue.visit!
 
         Page::Project::Issue::Show.perform do |show_page|
           show_page.select_all_activities_filter

From f7f94b6ce2e4a9e3650ffb7098a62f2d11edebad Mon Sep 17 00:00:00 2001
From: Zachary Knight <knightzac@gmail.com>
Date: Fri, 5 Jul 2019 18:27:55 +0000
Subject: [PATCH 118/195] Added experimental languages to license management
 docs.

---
 .../application_security/license_management/index.md  | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/doc/user/application_security/license_management/index.md b/doc/user/application_security/license_management/index.md
index 957c4ede981..de131ba1f23 100644
--- a/doc/user/application_security/license_management/index.md
+++ b/doc/user/application_security/license_management/index.md
@@ -46,12 +46,19 @@ The following languages and package managers are supported.
 
 | Language   | Package managers                                                  | Scan Tool                                                |
 |------------|-------------------------------------------------------------------|----------------------------------------------------------|
-| JavaScript | [Bower](https://bower.io/), [npm](https://www.npmjs.com/)         |[License Finder](https://github.com/pivotal/LicenseFinder)|
-| Go         | [Godep](https://github.com/tools/godep), go get                   |[License Finder](https://github.com/pivotal/LicenseFinder)|
+| JavaScript | [Bower](https://bower.io/), [npm](https://www.npmjs.com/), [yarn](https://yarnpkg.com/) ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types)) |[License Finder](https://github.com/pivotal/LicenseFinder)|
+| Go         | [Godep](https://github.com/tools/godep), go get ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types)), gvt ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types)), glide ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types)), dep ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types)), trash ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types))  and govendor ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types)), [go mod](https://github.com/golang/go/wiki/Modules) ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types))   |[License Finder](https://github.com/pivotal/LicenseFinder)|
 | Java       | [Gradle](https://gradle.org/), [Maven](https://maven.apache.org/) |[License Finder](https://github.com/pivotal/LicenseFinder)|
 | .NET       | [Nuget](https://www.nuget.org/)                                   |[License Finder](https://github.com/pivotal/LicenseFinder)|
 | Python     | [pip](https://pip.pypa.io/en/stable/)                             |[License Finder](https://github.com/pivotal/LicenseFinder)|
 | Ruby       | [gem](https://rubygems.org/)                                      |[License Finder](https://github.com/pivotal/LicenseFinder)|
+| Erlang     | [rebar](https://www.rebar3.org/) ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types))|[License Finder](https://github.com/pivotal/LicenseFinder)|
+| Objective-C, Swift | [Carthage](https://github.com/Carthage/Carthage) , [CocoaPods v0.39 and below](https://cocoapods.org/) ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types))  |[License Finder](https://github.com/pivotal/LicenseFinder)|
+| Elixir     | [mix](https://elixir-lang.org/getting-started/mix-otp/introduction-to-mix.html) ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types)) |[License Finder](https://github.com/pivotal/LicenseFinder)|
+| C++/C      | [conan](https://conan.io/) ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types))|[License Finder](https://github.com/pivotal/LicenseFinder)|
+| Scala      | [sbt](https://www.scala-sbt.org/) ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types))|[License Finder](https://github.com/pivotal/LicenseFinder)|
+| Rust       | [cargo](https://crates.io/) ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types))|[License Finder](https://github.com/pivotal/LicenseFinder)|
+| PHP        | [composer](https://getcomposer.org/) ([experimental support](https://github.com/pivotal/LicenseFinder#experimental-project-types))|[License Finder](https://github.com/pivotal/LicenseFinder)|
 
 ## Requirements
 

From 4545e98810ecc76421ee76b3bc1da807caae1ef9 Mon Sep 17 00:00:00 2001
From: Evan Read <eread@gitlab.com>
Date: Fri, 5 Jul 2019 18:28:29 +0000
Subject: [PATCH 119/195] Edit text, using correct terms

---
 doc/user/project/pipelines/job_artifacts.md | 11 +++++++----
 1 file changed, 7 insertions(+), 4 deletions(-)

diff --git a/doc/user/project/pipelines/job_artifacts.md b/doc/user/project/pipelines/job_artifacts.md
index f9feae36dbc..1966b136e9d 100644
--- a/doc/user/project/pipelines/job_artifacts.md
+++ b/doc/user/project/pipelines/job_artifacts.md
@@ -187,10 +187,13 @@ information in the UI.
 DANGER: **Warning:**
 This is a destructive action that leads to data loss. Use with caution.
 
-If you are either the owner of a given job or have Master
-[permissions](../../permissions.md#gitlab-cicd-permissions)
-on the project, you can erase a single job via the UI which will also remove the
-artifacts and the job's trace.
+You can erase a single job via the UI, which will also remove the job's
+artifacts and trace, if you are:
+
+- The owner of the job.
+- A [Maintainer](../../permissions.md#gitlab-cicd-permissions) of the project.
+
+To erase a job:
 
 1. Navigate to a job's page.
 1. Click the trash icon at the top right of the job's trace.

From 357f9898d586a0310a1111c0c5763c8707c4fb02 Mon Sep 17 00:00:00 2001
From: Douglas Barbosa Alexandre <dbalexandre@gmail.com>
Date: Fri, 5 Jul 2019 21:05:24 +0000
Subject: [PATCH 120/195] Add OpenSSL::OpenSSLError to HTTP_ERRORS

Some services can raise OpenSSL::X509::CertificateError due
to an invalid SSL certificates, with OpenSSL::OpenSSLError
we can handle these errors.
---
 app/models/project_services/drone_ci_service.rb       | 4 ++--
 changelogs/unreleased/64176-fix-error-handling.yml    | 5 +++++
 lib/gitlab/http.rb                                    | 6 +++---
 spec/models/project_services/drone_ci_service_spec.rb | 9 +++++++++
 4 files changed, 19 insertions(+), 5 deletions(-)
 create mode 100644 changelogs/unreleased/64176-fix-error-handling.yml

diff --git a/app/models/project_services/drone_ci_service.rb b/app/models/project_services/drone_ci_service.rb
index dbdc8345c93..d2660051343 100644
--- a/app/models/project_services/drone_ci_service.rb
+++ b/app/models/project_services/drone_ci_service.rb
@@ -46,7 +46,7 @@ class DroneCiService < CiService
   end
 
   def commit_status(sha, ref)
-    with_reactive_cache(sha, ref) {|cached| cached[:commit_status] }
+    with_reactive_cache(sha, ref) { |cached| cached[:commit_status] }
   end
 
   def calculate_reactive_cache(sha, ref)
@@ -68,7 +68,7 @@ class DroneCiService < CiService
       end
 
     { commit_status: status }
-  rescue Errno::ECONNREFUSED
+  rescue *Gitlab::HTTP::HTTP_ERRORS
     { commit_status: :error }
   end
 
diff --git a/changelogs/unreleased/64176-fix-error-handling.yml b/changelogs/unreleased/64176-fix-error-handling.yml
new file mode 100644
index 00000000000..e7a9a5897ae
--- /dev/null
+++ b/changelogs/unreleased/64176-fix-error-handling.yml
@@ -0,0 +1,5 @@
+---
+title: Fix invalid SSL certificate errors on Drone CI service
+merge_request: 30422
+author:
+type: fixed
diff --git a/lib/gitlab/http.rb b/lib/gitlab/http.rb
index db2b4dde244..58bce613a98 100644
--- a/lib/gitlab/http.rb
+++ b/lib/gitlab/http.rb
@@ -10,9 +10,9 @@ module Gitlab
     RedirectionTooDeep = Class.new(StandardError)
 
     HTTP_ERRORS = [
-      SocketError, OpenSSL::SSL::SSLError, Errno::ECONNRESET,
-      Errno::ECONNREFUSED, Errno::EHOSTUNREACH, Net::OpenTimeout,
-      Net::ReadTimeout, Gitlab::HTTP::BlockedUrlError,
+      SocketError, OpenSSL::SSL::SSLError, OpenSSL::OpenSSLError,
+      Errno::ECONNRESET, Errno::ECONNREFUSED, Errno::EHOSTUNREACH,
+      Net::OpenTimeout, Net::ReadTimeout, Gitlab::HTTP::BlockedUrlError,
       Gitlab::HTTP::RedirectionTooDeep
     ].freeze
 
diff --git a/spec/models/project_services/drone_ci_service_spec.rb b/spec/models/project_services/drone_ci_service_spec.rb
index 22df19d943f..a771d1bf27f 100644
--- a/spec/models/project_services/drone_ci_service_spec.rb
+++ b/spec/models/project_services/drone_ci_service_spec.rb
@@ -101,6 +101,15 @@ describe DroneCiService, :use_clean_rails_memory_store_caching do
         is_expected.to eq(:error)
       end
 
+      Gitlab::HTTP::HTTP_ERRORS.each do |http_error|
+        it "sets commit status to :error with a #{http_error.name} error" do
+          WebMock.stub_request(:get, commit_status_path)
+            .to_raise(http_error)
+
+          is_expected.to eq(:error)
+        end
+      end
+
       {
         "killed"  => :canceled,
         "failure" => :failed,

From a8060ee7494b26418d4ce9abf86da49195850977 Mon Sep 17 00:00:00 2001
From: Nick Thomas <nick@gitlab.com>
Date: Fri, 5 Jul 2019 21:52:16 +0000
Subject: [PATCH 121/195] Revert "Merge branch
 '63825-increase-rspec-parallelism' into 'master'"

This reverts merge request !30130
---
 .gitlab/ci/rails.gitlab-ci.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.gitlab/ci/rails.gitlab-ci.yml b/.gitlab/ci/rails.gitlab-ci.yml
index 01c96e06547..2d06a8acc58 100644
--- a/.gitlab/ci/rails.gitlab-ci.yml
+++ b/.gitlab/ci/rails.gitlab-ci.yml
@@ -139,7 +139,7 @@ setup-test-env:
 
 rspec unit pg:
   <<: *rspec-metadata-pg
-  parallel: 25
+  parallel: 20
 
 rspec integration pg:
   <<: *rspec-metadata-pg
@@ -152,7 +152,7 @@ rspec system pg:
 rspec unit pg-10:
   <<: *rspec-metadata-pg-10
   <<: *only-schedules-master
-  parallel: 25
+  parallel: 20
 
 rspec integration pg-10:
   <<: *rspec-metadata-pg-10

From 563bfca700214066fbdfd8286c75f45f3f9439f6 Mon Sep 17 00:00:00 2001
From: mfluharty <mfluharty@gitlab.com>
Date: Fri, 5 Jul 2019 13:20:49 -0600
Subject: [PATCH 122/195] Adjust modal body styles to match design spec

Set min-height to 80px via $modal-body-height
Set padding to 16px overall and 48px on right via $grid-size
---
 app/assets/stylesheets/framework/modal.scss     | 3 ++-
 app/assets/stylesheets/framework/variables.scss | 2 +-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/app/assets/stylesheets/framework/modal.scss b/app/assets/stylesheets/framework/modal.scss
index f75e5b55506..c08e1898cd8 100644
--- a/app/assets/stylesheets/framework/modal.scss
+++ b/app/assets/stylesheets/framework/modal.scss
@@ -35,7 +35,8 @@
   background-color: $modal-body-bg;
   line-height: $line-height-base;
   position: relative;
-  padding: #{3 * $grid-size} #{2 * $grid-size};
+  min-height: $modal-body-height;
+  padding: #{2 * $grid-size} #{6 * $grid-size} #{2 * $grid-size} #{2 * $grid-size};
   text-align: left;
   white-space: normal;
 
diff --git a/app/assets/stylesheets/framework/variables.scss b/app/assets/stylesheets/framework/variables.scss
index b6a24247d40..406bcda418e 100644
--- a/app/assets/stylesheets/framework/variables.scss
+++ b/app/assets/stylesheets/framework/variables.scss
@@ -805,7 +805,7 @@ $border-color-settings: #e1e1e1;
 /*
 Modals
 */
-$modal-body-height: 134px;
+$modal-body-height: 80px;
 $modal-border-color: #e9ecef;
 
 $priority-label-empty-state-width: 114px;

From 23bd46cf015aebcb34d125c705915f164d756762 Mon Sep 17 00:00:00 2001
From: Winnie Hellmann <winnie@gitlab.com>
Date: Fri, 5 Jul 2019 22:59:30 +0000
Subject: [PATCH 123/195] Remove applySuggestion from notes service

---
 app/assets/javascripts/notes/services/notes_service.js    | 4 ----
 app/assets/javascripts/notes/stores/actions.js            | 4 ++--
 .../unreleased/winh-notes-service-applySuggestion.yml     | 5 +++++
 spec/javascripts/notes/stores/actions_spec.js             | 8 ++++----
 4 files changed, 11 insertions(+), 10 deletions(-)
 create mode 100644 changelogs/unreleased/winh-notes-service-applySuggestion.yml

diff --git a/app/assets/javascripts/notes/services/notes_service.js b/app/assets/javascripts/notes/services/notes_service.js
index 237e70c0a4c..47a6f07cce2 100644
--- a/app/assets/javascripts/notes/services/notes_service.js
+++ b/app/assets/javascripts/notes/services/notes_service.js
@@ -1,5 +1,4 @@
 import Vue from 'vue';
-import Api from '~/api';
 import VueResource from 'vue-resource';
 import * as constants from '../constants';
 
@@ -45,7 +44,4 @@ export default {
   toggleIssueState(endpoint, data) {
     return Vue.http.put(endpoint, data);
   },
-  applySuggestion(id) {
-    return Api.applySuggestion(id);
-  },
 };
diff --git a/app/assets/javascripts/notes/stores/actions.js b/app/assets/javascripts/notes/stores/actions.js
index 9054b4779aa..fef962f008e 100644
--- a/app/assets/javascripts/notes/stores/actions.js
+++ b/app/assets/javascripts/notes/stores/actions.js
@@ -14,6 +14,7 @@ import sidebarTimeTrackingEventHub from '../../sidebar/event_hub';
 import { isInViewport, scrollToElement, isInMRPage } from '../../lib/utils/common_utils';
 import mrWidgetEventHub from '../../vue_merge_request_widget/event_hub';
 import { __ } from '~/locale';
+import Api from '~/api';
 
 let eTagPoll;
 
@@ -449,8 +450,7 @@ export const submitSuggestion = (
   { commit, dispatch },
   { discussionId, noteId, suggestionId, flashContainer },
 ) =>
-  service
-    .applySuggestion(suggestionId)
+  Api.applySuggestion(suggestionId)
     .then(() => commit(types.APPLY_SUGGESTION, { discussionId, noteId, suggestionId }))
     .then(() => dispatch('resolveDiscussion', { discussionId }).catch(() => {}))
     .catch(err => {
diff --git a/changelogs/unreleased/winh-notes-service-applySuggestion.yml b/changelogs/unreleased/winh-notes-service-applySuggestion.yml
new file mode 100644
index 00000000000..30e540237b6
--- /dev/null
+++ b/changelogs/unreleased/winh-notes-service-applySuggestion.yml
@@ -0,0 +1,5 @@
+---
+title: Remove applySuggestion from notes service
+merge_request: 30399
+author: Frank van Rest
+type: other
diff --git a/spec/javascripts/notes/stores/actions_spec.js b/spec/javascripts/notes/stores/actions_spec.js
index 65f72a135aa..c97ff5236ec 100644
--- a/spec/javascripts/notes/stores/actions_spec.js
+++ b/spec/javascripts/notes/stores/actions_spec.js
@@ -1,6 +1,7 @@
 import Vue from 'vue';
 import $ from 'jquery';
 import _ from 'underscore';
+import Api from '~/api';
 import { TEST_HOST } from 'spec/test_constants';
 import { headersInterceptor } from 'spec/helpers/vue_resource_helper';
 import actionsModule, * as actions from '~/notes/stores/actions';
@@ -8,7 +9,6 @@ import * as mutationTypes from '~/notes/stores/mutation_types';
 import * as notesConstants from '~/notes/constants';
 import createStore from '~/notes/stores';
 import mrWidgetEventHub from '~/vue_merge_request_widget/event_hub';
-import service from '~/notes/services/notes_service';
 import testAction from '../../helpers/vuex_action_helper';
 import { resetStore } from '../helpers';
 import {
@@ -846,9 +846,9 @@ describe('Actions Notes Store', () => {
     let flashContainer;
 
     beforeEach(() => {
-      spyOn(service, 'applySuggestion');
+      spyOn(Api, 'applySuggestion');
       dispatch.and.returnValue(Promise.resolve());
-      service.applySuggestion.and.returnValue(Promise.resolve());
+      Api.applySuggestion.and.returnValue(Promise.resolve());
       flashContainer = {};
     });
 
@@ -877,7 +877,7 @@ describe('Actions Notes Store', () => {
     it('when service fails, flashes error message', done => {
       const response = { response: { data: { message: TEST_ERROR_MESSAGE } } };
 
-      service.applySuggestion.and.returnValue(Promise.reject(response));
+      Api.applySuggestion.and.returnValue(Promise.reject(response));
 
       testSubmitSuggestion(done, () => {
         expect(commit).not.toHaveBeenCalled();

From 18a39e44b0a212d229e3bbc6125b02538fbba01e Mon Sep 17 00:00:00 2001
From: Stan Hu <stanhu@gmail.com>
Date: Fri, 5 Jul 2019 22:17:28 -0700
Subject: [PATCH 124/195] Upgrade prometheus-client-mmap to 0.9.7

This removes a warning message when prometheus_multiproc_dir is not set.
---
 Gemfile      | 2 +-
 Gemfile.lock | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Gemfile b/Gemfile
index b1750afec91..359eccb2171 100644
--- a/Gemfile
+++ b/Gemfile
@@ -309,7 +309,7 @@ group :metrics do
   gem 'influxdb', '~> 0.2', require: false
 
   # Prometheus
-  gem 'prometheus-client-mmap', '~> 0.9.6'
+  gem 'prometheus-client-mmap', '~> 0.9.7'
   gem 'raindrops', '~> 0.18'
 end
 
diff --git a/Gemfile.lock b/Gemfile.lock
index 5099167e03f..a3bad0be233 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -652,7 +652,7 @@ GEM
       parser
       unparser
     procto (0.0.3)
-    prometheus-client-mmap (0.9.6)
+    prometheus-client-mmap (0.9.7)
     pry (0.11.3)
       coderay (~> 1.1.0)
       method_source (~> 0.9.0)
@@ -1173,7 +1173,7 @@ DEPENDENCIES
   peek-redis (~> 1.2.0)
   pg (~> 1.1)
   premailer-rails (~> 1.9.7)
-  prometheus-client-mmap (~> 0.9.6)
+  prometheus-client-mmap (~> 0.9.7)
   pry-byebug (~> 3.5.1)
   pry-rails (~> 0.3.4)
   puma (~> 3.12)

From a28844ea5683d6ae7ae7e37065feee9baa59aeaf Mon Sep 17 00:00:00 2001
From: Stan Hu <stanhu@gmail.com>
Date: Sat, 6 Jul 2019 00:58:13 -0700
Subject: [PATCH 125/195] Prevent amplification of ReactiveCachingWorker jobs
 upon failures

When `ReactiveCachingWorker` hits an SSL or other exception that occurs
quickly and reliably, automatically rescheduling a new worker could lead
to excessive number of jobs being scheduled. This happens because not
only does the failed job get rescheduled in a minute, but each Sidekiq
retry will also add even more rescheduled jobs.

In busy instances, this can become an issue because large numbers of
`ReactiveCachingWorker` running can cause high rates of `ExclusiveLease`
reads to occur and possibly saturate the Redis server with queries.

We now disable this automatic retry and rely on Sidekiq to perform its 3
retries with a backoff period.

Closes https://gitlab.com/gitlab-org/gitlab-ce/issues/64176
---
 app/models/concerns/reactive_caching.rb                      | 2 +-
 .../sh-disable-reactive-caching-automatic-retries.yml        | 5 +++++
 spec/models/concerns/reactive_caching_spec.rb                | 5 +++--
 3 files changed, 9 insertions(+), 3 deletions(-)
 create mode 100644 changelogs/unreleased/sh-disable-reactive-caching-automatic-retries.yml

diff --git a/app/models/concerns/reactive_caching.rb b/app/models/concerns/reactive_caching.rb
index 6c3962b4c4f..5b3880f94ba 100644
--- a/app/models/concerns/reactive_caching.rb
+++ b/app/models/concerns/reactive_caching.rb
@@ -178,7 +178,7 @@ module ReactiveCaching
 
     def enqueuing_update(*args)
       yield
-    ensure
+
       ReactiveCachingWorker.perform_in(self.class.reactive_cache_refresh_interval, self.class, id, *args)
     end
   end
diff --git a/changelogs/unreleased/sh-disable-reactive-caching-automatic-retries.yml b/changelogs/unreleased/sh-disable-reactive-caching-automatic-retries.yml
new file mode 100644
index 00000000000..a0db68adb78
--- /dev/null
+++ b/changelogs/unreleased/sh-disable-reactive-caching-automatic-retries.yml
@@ -0,0 +1,5 @@
+---
+title: Prevent amplification of ReactiveCachingWorker jobs upon failures
+merge_request: 30432
+author:
+type: performance
diff --git a/spec/models/concerns/reactive_caching_spec.rb b/spec/models/concerns/reactive_caching_spec.rb
index 7faa196623f..e2ab9ddd4a5 100644
--- a/spec/models/concerns/reactive_caching_spec.rb
+++ b/spec/models/concerns/reactive_caching_spec.rb
@@ -206,8 +206,9 @@ describe ReactiveCaching, :use_clean_rails_memory_store_caching do
           expect(read_reactive_cache(instance)).to eq("preexisting")
         end
 
-        it 'enqueues a repeat worker' do
-          expect_reactive_cache_update_queued(instance)
+        it 'does not enqueue a repeat worker' do
+          expect(ReactiveCachingWorker)
+            .not_to receive(:perform_in)
 
           expect { go! }.to raise_error("foo")
         end

From cd4b88a22cfdf1929077c08fc857920faf85e04c Mon Sep 17 00:00:00 2001
From: Stan Hu <stanhu@gmail.com>
Date: Fri, 5 Jul 2019 22:20:19 -0700
Subject: [PATCH 126/195] Upgrade Rouge to 3.5.1

This release includes continued improvements to the library, fixes for a
number of lexers and support for three new languages:
https://github.com/rouge-ruby/rouge/releases
---
 Gemfile                                          | 2 +-
 Gemfile.lock                                     | 4 ++--
 changelogs/unreleased/sh-upgrade-rouge-3-5-1.yml | 5 +++++
 3 files changed, 8 insertions(+), 3 deletions(-)
 create mode 100644 changelogs/unreleased/sh-upgrade-rouge-3-5-1.yml

diff --git a/Gemfile b/Gemfile
index b1750afec91..d95e57cf168 100644
--- a/Gemfile
+++ b/Gemfile
@@ -132,7 +132,7 @@ gem 'wikicloth', '0.8.1'
 gem 'asciidoctor', '~> 2.0.10'
 gem 'asciidoctor-include-ext', '~> 0.3.1', require: false
 gem 'asciidoctor-plantuml', '0.0.9'
-gem 'rouge', '~> 3.1'
+gem 'rouge', '~> 3.5'
 gem 'truncato', '~> 0.7.11'
 gem 'bootstrap_form', '~> 4.2.0'
 gem 'nokogiri', '~> 1.10.3'
diff --git a/Gemfile.lock b/Gemfile.lock
index 5099167e03f..363baa5f9d5 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -770,7 +770,7 @@ GEM
     retriable (3.1.2)
     rinku (2.0.0)
     rotp (2.1.2)
-    rouge (3.4.1)
+    rouge (3.5.1)
     rqrcode (0.7.0)
       chunky_png
     rqrcode-rails3 (0.1.7)
@@ -1199,7 +1199,7 @@ DEPENDENCIES
   redis-rails (~> 5.0.2)
   request_store (~> 1.3)
   responders (~> 2.0)
-  rouge (~> 3.1)
+  rouge (~> 3.5)
   rqrcode-rails3 (~> 0.1.7)
   rspec-parameterized
   rspec-rails (~> 3.7.0)
diff --git a/changelogs/unreleased/sh-upgrade-rouge-3-5-1.yml b/changelogs/unreleased/sh-upgrade-rouge-3-5-1.yml
new file mode 100644
index 00000000000..b408019c736
--- /dev/null
+++ b/changelogs/unreleased/sh-upgrade-rouge-3-5-1.yml
@@ -0,0 +1,5 @@
+---
+title: Upgrade Rouge to 3.5.1
+merge_request: 30431
+author:
+type: changed

From 5bea7d102b22347188f4ba9d44f0151436b87c74 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Sat, 6 Jul 2019 13:32:50 +0000
Subject: [PATCH 127/195] Update dangerfile to exclude docs ci yaml

---
 danger/only_documentation/Dangerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/danger/only_documentation/Dangerfile b/danger/only_documentation/Dangerfile
index 8e4564f22b6..0e5f841c891 100644
--- a/danger/only_documentation/Dangerfile
+++ b/danger/only_documentation/Dangerfile
@@ -1,7 +1,7 @@
 # rubocop:disable Style/SignalException
 # frozen_string_literal: true
 
-has_only_docs_changes = helper.all_changed_files.all? { |file| file.start_with?('doc/') }
+has_only_docs_changes = helper.all_changed_files.all? { |file| file.start_with?('doc/', '.gitlab/ci/docs.gitlab-ci.yml') }
 is_docs_only_branch = gitlab.branch_for_head =~ /(^docs[\/-].*|.*-docs$)/
 
 if is_docs_only_branch && !has_only_docs_changes

From 72339077f7d79eeb9d0612c55236aa4aa6da4084 Mon Sep 17 00:00:00 2001
From: Thong Kuah <tkuah@gitlab.com>
Date: Thu, 20 Jun 2019 14:03:21 +1200
Subject: [PATCH 128/195] Add failing test showing N+1

We have an N+1 problem where N is environments.
---
 .../projects/merge_requests_controller_spec.rb       | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/spec/controllers/projects/merge_requests_controller_spec.rb b/spec/controllers/projects/merge_requests_controller_spec.rb
index 0eca663a683..1120bf6dcb0 100644
--- a/spec/controllers/projects/merge_requests_controller_spec.rb
+++ b/spec/controllers/projects/merge_requests_controller_spec.rb
@@ -878,6 +878,18 @@ describe Projects::MergeRequestsController do
         expect(control_count).to be <= 137
       end
 
+      it 'has no N+1 issues for environments', :request_store do
+        # First run to insert test data from lets, which does take up some 30 queries
+        get_ci_environments_status
+
+        control_count = ActiveRecord::QueryRecorder.new(skip_cached: false) { get_ci_environments_status }.count
+
+        environment2 = create(:environment, project: forked)
+        create(:deployment, :succeed, environment: environment2, sha: sha, ref: 'master', deployable: build)
+
+        expect { get_ci_environments_status }.not_to exceed_all_query_limit(control_count)
+      end
+
       def get_ci_environments_status(extra_params = {})
         params = {
           namespace_id: merge_request.project.namespace.to_param,

From 1668f40f430c656ed9c20898605db21a66cb5937 Mon Sep 17 00:00:00 2001
From: Thong Kuah <tkuah@gitlab.com>
Date: Mon, 1 Jul 2019 20:24:20 +1200
Subject: [PATCH 129/195] Remove fallback to project.deployment_platform

This improves query performance of
MergeRequestsController#ci_environments_status a lot.

However this means old deployments that deployed to kubernetes clusters
with prometheus installations will no longer show performance metrics as
we cannot backfill cluster_id from deployment_platform with certainty
(clusters may be edited/added/deleted, which changes the results of
deployment_platform).
---
 app/models/deployment.rb                |  7 +------
 changelogs/unreleased/63475-fix-n-1.yml |  5 +++++
 spec/models/deployment_spec.rb          | 12 ------------
 3 files changed, 6 insertions(+), 18 deletions(-)
 create mode 100644 changelogs/unreleased/63475-fix-n-1.yml

diff --git a/app/models/deployment.rb b/app/models/deployment.rb
index a8f5642f726..3b31e7b1333 100644
--- a/app/models/deployment.rb
+++ b/app/models/deployment.rb
@@ -206,13 +206,8 @@ class Deployment < ApplicationRecord
     end
   end
 
-  # TODO remove fallback case to deployment_platform_cluster.
-  # Otherwise we will continue to pay the performance penalty described in
-  # https://gitlab.com/gitlab-org/gitlab-ce/issues/63475
   def cluster_prometheus
-    cluster_with_fallback = cluster || deployment_platform_cluster
-
-    cluster_with_fallback.application_prometheus if cluster_with_fallback&.application_prometheus_available?
+    cluster.application_prometheus if cluster&.application_prometheus_available?
   end
 
   def ref_path
diff --git a/changelogs/unreleased/63475-fix-n-1.yml b/changelogs/unreleased/63475-fix-n-1.yml
new file mode 100644
index 00000000000..3ed825290fd
--- /dev/null
+++ b/changelogs/unreleased/63475-fix-n-1.yml
@@ -0,0 +1,5 @@
+---
+title: Improve performance of MergeRequestsController#ci_environment_status endpoint
+merge_request: 30224
+author:
+type: performance
diff --git a/spec/models/deployment_spec.rb b/spec/models/deployment_spec.rb
index 713fb647708..a926e1913a7 100644
--- a/spec/models/deployment_spec.rb
+++ b/spec/models/deployment_spec.rb
@@ -341,18 +341,6 @@ describe Deployment do
 
         it { is_expected.to be_truthy }
       end
-
-      context 'fallback deployment platform' do
-        let(:cluster) { create(:cluster, :provided_by_user, environment_scope: '*', projects: [deployment.project]) }
-        let!(:prometheus) { create(:clusters_applications_prometheus, :installed, cluster: cluster) }
-
-        before do
-          expect(deployment.project).to receive(:deployment_platform).and_return(cluster.platform)
-          expect(cluster.application_prometheus).to receive(:can_query?).and_return(true)
-        end
-
-        it { is_expected.to be_truthy }
-      end
     end
   end
 

From 1b5b0dea5228ae7fd520c8bca3f03c4799a4d31d Mon Sep 17 00:00:00 2001
From: Thong Kuah <tkuah@gitlab.com>
Date: Mon, 1 Jul 2019 20:27:58 +1200
Subject: [PATCH 130/195] Share project object in EnvironmentStatus

Otherwise, each EnvironmentStatus object instantiates its own project
when really they are the same. Improves query count performance
---
 app/models/environment_status.rb                   |  8 ++++----
 spec/models/environment_status_spec.rb             |  3 +--
 spec/serializers/environment_status_entity_spec.rb | 10 ++++++++--
 3 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/app/models/environment_status.rb b/app/models/environment_status.rb
index 2fb6cadc8cd..2c71520cec1 100644
--- a/app/models/environment_status.rb
+++ b/app/models/environment_status.rb
@@ -3,11 +3,10 @@
 class EnvironmentStatus
   include Gitlab::Utils::StrongMemoize
 
-  attr_reader :environment, :merge_request, :sha
+  attr_reader :project, :environment, :merge_request, :sha
 
   delegate :id, to: :environment
   delegate :name, to: :environment
-  delegate :project, to: :environment
   delegate :status, to: :deployment, allow_nil: true
   delegate :deployed_at, to: :deployment, allow_nil: true
 
@@ -21,7 +20,8 @@ class EnvironmentStatus
     build_environments_status(mr, user, mr.merge_pipeline)
   end
 
-  def initialize(environment, merge_request, sha)
+  def initialize(project, environment, merge_request, sha)
+    @project = project
     @environment = environment
     @merge_request = merge_request
     @sha = sha
@@ -67,7 +67,7 @@ class EnvironmentStatus
     pipeline.environments.available.map do |environment|
       next unless Ability.allowed?(user, :read_environment, environment)
 
-      EnvironmentStatus.new(environment, mr, pipeline.sha)
+      EnvironmentStatus.new(pipeline.project, environment, mr, pipeline.sha)
     end.compact
   end
   private_class_method :build_environments_status
diff --git a/spec/models/environment_status_spec.rb b/spec/models/environment_status_spec.rb
index c503c35305f..e2836420df9 100644
--- a/spec/models/environment_status_spec.rb
+++ b/spec/models/environment_status_spec.rb
@@ -11,11 +11,10 @@ describe EnvironmentStatus do
   let(:merge_request) { create(:merge_request, :deployed_review_app, deployment: deployment) }
   let(:sha)           { deployment.sha }
 
-  subject(:environment_status) { described_class.new(environment, merge_request, sha) }
+  subject(:environment_status) { described_class.new(project, environment, merge_request, sha) }
 
   it { is_expected.to delegate_method(:id).to(:environment) }
   it { is_expected.to delegate_method(:name).to(:environment) }
-  it { is_expected.to delegate_method(:project).to(:environment) }
   it { is_expected.to delegate_method(:deployed_at).to(:deployment) }
   it { is_expected.to delegate_method(:status).to(:deployment) }
 
diff --git a/spec/serializers/environment_status_entity_spec.rb b/spec/serializers/environment_status_entity_spec.rb
index 8a6a38fe5f8..f421432e8d6 100644
--- a/spec/serializers/environment_status_entity_spec.rb
+++ b/spec/serializers/environment_status_entity_spec.rb
@@ -9,7 +9,7 @@ describe EnvironmentStatusEntity do
   let(:project)       { deployment.project }
   let(:merge_request) { create(:merge_request, :deployed_review_app, deployment: deployment) }
 
-  let(:environment_status) { EnvironmentStatus.new(environment, merge_request, merge_request.diff_head_sha) }
+  let(:environment_status) { EnvironmentStatus.new(project, environment, merge_request, merge_request.diff_head_sha) }
   let(:entity)             { described_class.new(environment_status, request: request) }
 
   subject { entity.as_json }
@@ -55,8 +55,14 @@ describe EnvironmentStatusEntity do
     before do
       project.add_maintainer(user)
       allow(deployment).to receive(:prometheus_adapter).and_return(prometheus_adapter)
-      allow(prometheus_adapter).to receive(:query).with(:deployment, deployment).and_return(simple_metrics)
       allow(entity).to receive(:deployment).and_return(deployment)
+
+      expect_next_instance_of(DeploymentMetrics) do |deployment_metrics|
+        allow(deployment_metrics).to receive(:prometheus_adapter).and_return(prometheus_adapter)
+
+        allow(prometheus_adapter).to receive(:query)
+          .with(:deployment, deployment).and_return(simple_metrics)
+      end
     end
 
     context 'when deployment succeeded' do

From d2ba2951f737082edd568505f985ebf9a0808be7 Mon Sep 17 00:00:00 2001
From: Thong Kuah <tkuah@gitlab.com>
Date: Mon, 1 Jul 2019 21:40:59 +1200
Subject: [PATCH 131/195] Extract deployment_metrics into own object

We can now share project so that we don't have to load project twice.
Also, this extracts non-relevant logic out of Deployment.

Update DeploymentsController accordingly
---
 .../projects/deployments_controller.rb        |  14 ++-
 app/models/deployment.rb                      |  32 -----
 app/models/deployment_metrics.rb              |  50 ++++++++
 app/models/environment_status.rb              |   4 +
 app/serializers/environment_status_entity.rb  |   6 +-
 .../projects/deployments_controller_spec.rb   |  74 ++++--------
 spec/models/deployment_metrics_spec.rb        | 114 ++++++++++++++++++
 spec/models/deployment_spec.rb                | 107 ----------------
 8 files changed, 205 insertions(+), 196 deletions(-)
 create mode 100644 app/models/deployment_metrics.rb
 create mode 100644 spec/models/deployment_metrics_spec.rb

diff --git a/app/controllers/projects/deployments_controller.rb b/app/controllers/projects/deployments_controller.rb
index 0a009477d61..32111b07a0b 100644
--- a/app/controllers/projects/deployments_controller.rb
+++ b/app/controllers/projects/deployments_controller.rb
@@ -15,24 +15,22 @@ class Projects::DeploymentsController < Projects::ApplicationController
   # rubocop: enable CodeReuse/ActiveRecord
 
   def metrics
-    return render_404 unless deployment.has_metrics?
+    return render_404 unless deployment_metrics.has_metrics?
 
-    @metrics = deployment.metrics
+    @metrics = deployment_metrics.metrics
     if @metrics&.any?
       render json: @metrics, status: :ok
     else
       head :no_content
     end
-  rescue NotImplementedError
-    render_404
   end
 
   def additional_metrics
-    return render_404 unless deployment.has_metrics?
+    return render_404 unless deployment_metrics.has_metrics?
 
     respond_to do |format|
       format.json do
-        metrics = deployment.additional_metrics
+        metrics = deployment_metrics.additional_metrics
 
         if metrics.any?
           render json: metrics
@@ -45,6 +43,10 @@ class Projects::DeploymentsController < Projects::ApplicationController
 
   private
 
+  def deployment_metrics
+    @deployment_metrics ||= DeploymentMetrics.new(deployment.project, deployment)
+  end
+
   # rubocop: disable CodeReuse/ActiveRecord
   def deployment
     @deployment ||= environment.deployments.find_by(iid: params[:id])
diff --git a/app/models/deployment.rb b/app/models/deployment.rb
index 3b31e7b1333..ad32ec3f1d5 100644
--- a/app/models/deployment.rb
+++ b/app/models/deployment.rb
@@ -176,40 +176,8 @@ class Deployment < ApplicationRecord
     deployed_at&.to_time&.in_time_zone&.to_s(:medium)
   end
 
-  def has_metrics?
-    success? && prometheus_adapter&.can_query?
-  end
-
-  def metrics
-    return {} unless has_metrics?
-
-    metrics = prometheus_adapter.query(:deployment, self)
-    metrics&.merge(deployment_time: finished_at.to_i) || {}
-  end
-
-  def additional_metrics
-    return {} unless has_metrics?
-
-    metrics = prometheus_adapter.query(:additional_metrics_deployment, self)
-    metrics&.merge(deployment_time: finished_at.to_i) || {}
-  end
-
   private
 
-  def prometheus_adapter
-    service = project.find_or_initialize_service('prometheus')
-
-    if service.can_query?
-      service
-    else
-      cluster_prometheus
-    end
-  end
-
-  def cluster_prometheus
-    cluster.application_prometheus if cluster&.application_prometheus_available?
-  end
-
   def ref_path
     File.join(environment.ref_path, 'deployments', iid.to_s)
   end
diff --git a/app/models/deployment_metrics.rb b/app/models/deployment_metrics.rb
new file mode 100644
index 00000000000..2056c8bc59c
--- /dev/null
+++ b/app/models/deployment_metrics.rb
@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+class DeploymentMetrics
+  include Gitlab::Utils::StrongMemoize
+
+  attr_reader :project, :deployment
+
+  delegate :cluster, to: :deployment
+
+  def initialize(project, deployment)
+    @project = project
+    @deployment = deployment
+  end
+
+  def has_metrics?
+    deployment.success? && prometheus_adapter&.can_query?
+  end
+
+  def metrics
+    return {} unless has_metrics?
+
+    metrics = prometheus_adapter.query(:deployment, deployment)
+    metrics&.merge(deployment_time: deployment.finished_at.to_i) || {}
+  end
+
+  def additional_metrics
+    return {} unless has_metrics?
+
+    metrics = prometheus_adapter.query(:additional_metrics_deployment, deployment)
+    metrics&.merge(deployment_time: deployment.finished_at.to_i) || {}
+  end
+
+  private
+
+  def prometheus_adapter
+    strong_memoize(:prometheus_adapter) do
+      service = project.find_or_initialize_service('prometheus')
+
+      if service.can_query?
+        service
+      else
+        cluster_prometheus
+      end
+    end
+  end
+
+  def cluster_prometheus
+    cluster.application_prometheus if cluster&.application_prometheus_available?
+  end
+end
diff --git a/app/models/environment_status.rb b/app/models/environment_status.rb
index 2c71520cec1..1b3c094901b 100644
--- a/app/models/environment_status.rb
+++ b/app/models/environment_status.rb
@@ -33,6 +33,10 @@ class EnvironmentStatus
     end
   end
 
+  def has_metrics?
+    DeploymentMetrics.new(project, deployment).has_metrics?
+  end
+
   def changes
     return [] if project.route_map_for(sha).nil?
 
diff --git a/app/serializers/environment_status_entity.rb b/app/serializers/environment_status_entity.rb
index f6321b9e520..811cc2ad5af 100644
--- a/app/serializers/environment_status_entity.rb
+++ b/app/serializers/environment_status_entity.rb
@@ -11,7 +11,7 @@ class EnvironmentStatusEntity < Grape::Entity
     project_environment_path(es.project, es.environment)
   end
 
-  expose :metrics_url, if: ->(*) { can_read_environment? && deployment.has_metrics? } do |es|
+  expose :metrics_url, if: ->(*) { can_read_environment? && has_metrics? } do |es|
     metrics_project_environment_deployment_path(es.project, es.environment, es.deployment)
   end
 
@@ -45,8 +45,8 @@ class EnvironmentStatusEntity < Grape::Entity
     object.environment
   end
 
-  def deployment
-    object.deployment
+  def has_metrics?
+    object.has_metrics?
   end
 
   def project
diff --git a/spec/controllers/projects/deployments_controller_spec.rb b/spec/controllers/projects/deployments_controller_spec.rb
index 95417936df4..b9ee69a617b 100644
--- a/spec/controllers/projects/deployments_controller_spec.rb
+++ b/spec/controllers/projects/deployments_controller_spec.rb
@@ -41,34 +41,26 @@ describe Projects::DeploymentsController do
   describe 'GET #metrics' do
     let(:deployment) { create(:deployment, :success, project: project, environment: environment) }
 
-    before do
-      allow(controller).to receive(:deployment).and_return(deployment)
-    end
-
     context 'when metrics are disabled' do
-      before do
-        allow(deployment).to receive(:has_metrics?).and_return false
-      end
-
       it 'responds with not found' do
-        get :metrics, params: deployment_params(id: deployment.id)
+        get :metrics, params: deployment_params(id: deployment.to_param)
 
         expect(response).to be_not_found
       end
     end
 
     context 'when metrics are enabled' do
-      before do
-        allow(deployment).to receive(:has_metrics?).and_return true
-      end
-
       context 'when environment has no metrics' do
         before do
-          expect(deployment).to receive(:metrics).and_return(nil)
+          expect_next_instance_of(DeploymentMetrics) do |deployment_metrics|
+            allow(deployment_metrics).to receive(:has_metrics?).and_return(true)
+
+            expect(deployment_metrics).to receive(:metrics).and_return(nil)
+          end
         end
 
         it 'returns a empty response 204 resposne' do
-          get :metrics, params: deployment_params(id: deployment.id)
+          get :metrics, params: deployment_params(id: deployment.to_param)
           expect(response).to have_gitlab_http_status(204)
           expect(response.body).to eq('')
         end
@@ -84,11 +76,15 @@ describe Projects::DeploymentsController do
         end
 
         before do
-          expect(deployment).to receive(:metrics).and_return(empty_metrics)
+          expect_next_instance_of(DeploymentMetrics) do |deployment_metrics|
+            allow(deployment_metrics).to receive(:has_metrics?).and_return(true)
+
+            expect(deployment_metrics).to receive(:metrics).and_return(empty_metrics)
+          end
         end
 
         it 'returns a metrics JSON document' do
-          get :metrics, params: deployment_params(id: deployment.id)
+          get :metrics, params: deployment_params(id: deployment.to_param)
 
           expect(response).to be_ok
           expect(json_response['success']).to be(true)
@@ -96,54 +92,32 @@ describe Projects::DeploymentsController do
           expect(json_response['last_update']).to eq(42)
         end
       end
-
-      context 'when metrics service does not implement deployment metrics' do
-        before do
-          allow(deployment).to receive(:metrics).and_raise(NotImplementedError)
-        end
-
-        it 'responds with not found' do
-          get :metrics, params: deployment_params(id: deployment.id)
-
-          expect(response).to be_not_found
-        end
-      end
     end
   end
 
   describe 'GET #additional_metrics' do
     let(:deployment) { create(:deployment, :success, project: project, environment: environment) }
 
-    before do
-      allow(controller).to receive(:deployment).and_return(deployment)
-    end
-
     context 'when metrics are disabled' do
-      before do
-        allow(deployment).to receive(:has_metrics?).and_return false
-      end
-
       it 'responds with not found' do
-        get :metrics, params: deployment_params(id: deployment.id)
+        get :metrics, params: deployment_params(id: deployment.to_param)
 
         expect(response).to be_not_found
       end
     end
 
     context 'when metrics are enabled' do
-      let(:prometheus_adapter) { double('prometheus_adapter', can_query?: true) }
-
-      before do
-        allow(deployment).to receive(:prometheus_adapter).and_return(prometheus_adapter)
-      end
-
       context 'when environment has no metrics' do
         before do
-          expect(deployment).to receive(:additional_metrics).and_return({})
+          expect_next_instance_of(DeploymentMetrics) do |deployment_metrics|
+            allow(deployment_metrics).to receive(:has_metrics?).and_return(true)
+
+            expect(deployment_metrics).to receive(:additional_metrics).and_return({})
+          end
         end
 
         it 'returns a empty response 204 response' do
-          get :additional_metrics, params: deployment_params(id: deployment.id, format: :json)
+          get :additional_metrics, params: deployment_params(id: deployment.to_param, format: :json)
           expect(response).to have_gitlab_http_status(204)
           expect(response.body).to eq('')
         end
@@ -159,11 +133,15 @@ describe Projects::DeploymentsController do
         end
 
         before do
-          expect(deployment).to receive(:additional_metrics).and_return(empty_metrics)
+          expect_next_instance_of(DeploymentMetrics) do |deployment_metrics|
+            allow(deployment_metrics).to receive(:has_metrics?).and_return(true)
+
+            expect(deployment_metrics).to receive(:additional_metrics).and_return(empty_metrics)
+          end
         end
 
         it 'returns a metrics JSON document' do
-          get :additional_metrics, params: deployment_params(id: deployment.id, format: :json)
+          get :additional_metrics, params: deployment_params(id: deployment.to_param, format: :json)
 
           expect(response).to be_ok
           expect(json_response['success']).to be(true)
diff --git a/spec/models/deployment_metrics_spec.rb b/spec/models/deployment_metrics_spec.rb
new file mode 100644
index 00000000000..7c574a8b6c8
--- /dev/null
+++ b/spec/models/deployment_metrics_spec.rb
@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe DeploymentMetrics do
+  describe '#has_metrics?' do
+    subject { described_class.new(deployment.project, deployment).has_metrics? }
+
+    context 'when deployment is failed' do
+      let(:deployment) { create(:deployment, :failed) }
+
+      it { is_expected.to be_falsy }
+    end
+
+    context 'when deployment is success' do
+      let(:deployment) { create(:deployment, :success) }
+
+      context 'without a monitoring service' do
+        it { is_expected.to be_falsy }
+      end
+
+      context 'with a Prometheus Service' do
+        let(:prometheus_service) { instance_double(PrometheusService, can_query?: true) }
+
+        before do
+          allow(deployment.project).to receive(:find_or_initialize_service).with('prometheus').and_return prometheus_service
+        end
+
+        it { is_expected.to be_truthy }
+      end
+
+      context 'with a Prometheus Service that cannot query' do
+        let(:prometheus_service) { instance_double(PrometheusService, can_query?: false) }
+
+        before do
+          allow(deployment.project).to receive(:find_or_initialize_service).with('prometheus').and_return prometheus_service
+        end
+
+        it { is_expected.to be_falsy }
+      end
+
+      context 'with a cluster Prometheus' do
+        let(:deployment) { create(:deployment, :success, :on_cluster) }
+        let!(:prometheus) { create(:clusters_applications_prometheus, :installed, cluster: deployment.cluster) }
+
+        before do
+          expect(deployment.cluster.application_prometheus).to receive(:can_query?).and_return(true)
+        end
+
+        it { is_expected.to be_truthy }
+      end
+    end
+  end
+
+  describe '#metrics' do
+    let(:deployment) { create(:deployment, :success) }
+    let(:prometheus_adapter) { instance_double(PrometheusService, can_query?: true) }
+    let(:deployment_metrics) { described_class.new(deployment.project, deployment) }
+
+    subject { deployment_metrics.metrics }
+
+    context 'metrics are disabled' do
+      it { is_expected.to eq({}) }
+    end
+
+    context 'metrics are enabled' do
+      let(:simple_metrics) do
+        {
+          success: true,
+          metrics: {},
+          last_update: 42
+        }
+      end
+
+      before do
+        allow(deployment_metrics).to receive(:prometheus_adapter).and_return(prometheus_adapter)
+        expect(prometheus_adapter).to receive(:query).with(:deployment, deployment).and_return(simple_metrics)
+      end
+
+      it { is_expected.to eq(simple_metrics.merge({ deployment_time: deployment.created_at.to_i })) }
+    end
+  end
+
+  describe '#additional_metrics' do
+    let(:project) { create(:project, :repository) }
+    let(:deployment) { create(:deployment, :succeed, project: project) }
+    let(:deployment_metrics) { described_class.new(deployment.project, deployment) }
+
+    subject { deployment_metrics.additional_metrics }
+
+    context 'metrics are disabled' do
+      it { is_expected.to eq({}) }
+    end
+
+    context 'metrics are enabled' do
+      let(:simple_metrics) do
+        {
+          success: true,
+          metrics: {},
+          last_update: 42
+        }
+      end
+
+      let(:prometheus_adapter) { instance_double('prometheus_adapter', can_query?: true) }
+
+      before do
+        allow(deployment_metrics).to receive(:prometheus_adapter).and_return(prometheus_adapter)
+        expect(prometheus_adapter).to receive(:query).with(:additional_metrics_deployment, deployment).and_return(simple_metrics)
+      end
+
+      it { is_expected.to eq(simple_metrics.merge({ deployment_time: deployment.created_at.to_i })) }
+    end
+  end
+end
diff --git a/spec/models/deployment_spec.rb b/spec/models/deployment_spec.rb
index a926e1913a7..79647c5719c 100644
--- a/spec/models/deployment_spec.rb
+++ b/spec/models/deployment_spec.rb
@@ -295,113 +295,6 @@ describe Deployment do
     end
   end
 
-  describe '#has_metrics?' do
-    subject { deployment.has_metrics? }
-
-    context 'when deployment is failed' do
-      let(:deployment) { create(:deployment, :failed) }
-
-      it { is_expected.to be_falsy }
-    end
-
-    context 'when deployment is success' do
-      let(:deployment) { create(:deployment, :success) }
-
-      context 'without a monitoring service' do
-        it { is_expected.to be_falsy }
-      end
-
-      context 'with a Prometheus Service' do
-        let(:prometheus_service) { double(:prometheus_service, can_query?: true) }
-
-        before do
-          allow(deployment.project).to receive(:find_or_initialize_service).with('prometheus').and_return prometheus_service
-        end
-
-        it { is_expected.to be_truthy }
-      end
-
-      context 'with a Prometheus Service that cannot query' do
-        let(:prometheus_service) { double(:prometheus_service, can_query?: false) }
-
-        before do
-          allow(deployment.project).to receive(:find_or_initialize_service).with('prometheus').and_return prometheus_service
-        end
-
-        it { is_expected.to be_falsy }
-      end
-
-      context 'with a cluster Prometheus' do
-        let(:deployment) { create(:deployment, :success, :on_cluster) }
-        let!(:prometheus) { create(:clusters_applications_prometheus, :installed, cluster: deployment.cluster) }
-
-        before do
-          expect(deployment.cluster.application_prometheus).to receive(:can_query?).and_return(true)
-        end
-
-        it { is_expected.to be_truthy }
-      end
-    end
-  end
-
-  describe '#metrics' do
-    let(:deployment) { create(:deployment, :success) }
-    let(:prometheus_adapter) { double('prometheus_adapter', can_query?: true) }
-
-    subject { deployment.metrics }
-
-    context 'metrics are disabled' do
-      it { is_expected.to eq({}) }
-    end
-
-    context 'metrics are enabled' do
-      let(:simple_metrics) do
-        {
-          success: true,
-          metrics: {},
-          last_update: 42
-        }
-      end
-
-      before do
-        allow(deployment).to receive(:prometheus_adapter).and_return(prometheus_adapter)
-        allow(prometheus_adapter).to receive(:query).with(:deployment, deployment).and_return(simple_metrics)
-      end
-
-      it { is_expected.to eq(simple_metrics.merge({ deployment_time: deployment.created_at.to_i })) }
-    end
-  end
-
-  describe '#additional_metrics' do
-    let(:project) { create(:project, :repository) }
-    let(:deployment) { create(:deployment, :succeed, project: project) }
-
-    subject { deployment.additional_metrics }
-
-    context 'metrics are disabled' do
-      it { is_expected.to eq({}) }
-    end
-
-    context 'metrics are enabled' do
-      let(:simple_metrics) do
-        {
-          success: true,
-          metrics: {},
-          last_update: 42
-        }
-      end
-
-      let(:prometheus_adapter) { double('prometheus_adapter', can_query?: true) }
-
-      before do
-        allow(deployment).to receive(:prometheus_adapter).and_return(prometheus_adapter)
-        allow(prometheus_adapter).to receive(:query).with(:additional_metrics_deployment, deployment).and_return(simple_metrics)
-      end
-
-      it { is_expected.to eq(simple_metrics.merge({ deployment_time: deployment.created_at.to_i })) }
-    end
-  end
-
   describe '#stop_action' do
     let(:build) { create(:ci_build) }
 

From a2cd33d1baa3de0774ebfcff2e6bbffffcb5d025 Mon Sep 17 00:00:00 2001
From: Thong Kuah <tkuah@gitlab.com>
Date: Mon, 1 Jul 2019 21:45:17 +1200
Subject: [PATCH 132/195] Could not address last 5 queries

Split into followup issue
---
 spec/controllers/projects/merge_requests_controller_spec.rb | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/spec/controllers/projects/merge_requests_controller_spec.rb b/spec/controllers/projects/merge_requests_controller_spec.rb
index 1120bf6dcb0..ea160a21955 100644
--- a/spec/controllers/projects/merge_requests_controller_spec.rb
+++ b/spec/controllers/projects/merge_requests_controller_spec.rb
@@ -887,7 +887,10 @@ describe Projects::MergeRequestsController do
         environment2 = create(:environment, project: forked)
         create(:deployment, :succeed, environment: environment2, sha: sha, ref: 'master', deployable: build)
 
-        expect { get_ci_environments_status }.not_to exceed_all_query_limit(control_count)
+        # TODO address the last 5 queries
+        # See https://gitlab.com/gitlab-org/gitlab-ce/issues/63952
+        leeway = 5
+        expect { get_ci_environments_status }.not_to exceed_all_query_limit(control_count + leeway)
       end
 
       def get_ci_environments_status(extra_params = {})

From 25ba11a2aad9571e4759cdc711199634e3392c5b Mon Sep 17 00:00:00 2001
From: Thong Kuah <tkuah@gitlab.com>
Date: Mon, 1 Jul 2019 22:10:15 +1200
Subject: [PATCH 133/195] Remove un-used method

We stopped calling the fallback so we can remove this now
---
 app/models/deployment.rb       |  5 -----
 spec/models/deployment_spec.rb | 28 ----------------------------
 2 files changed, 33 deletions(-)

diff --git a/app/models/deployment.rb b/app/models/deployment.rb
index ad32ec3f1d5..b69cda4f2f9 100644
--- a/app/models/deployment.rb
+++ b/app/models/deployment.rb
@@ -85,11 +85,6 @@ class Deployment < ApplicationRecord
     Commit.truncate_sha(sha)
   end
 
-  # Deprecated - will be replaced by a persisted cluster_id
-  def deployment_platform_cluster
-    environment.deployment_platform&.cluster
-  end
-
   def execute_hooks
     deployment_data = Gitlab::DataBuilder::Deployment.build(self)
     project.execute_services(deployment_data, :deployment_hooks)
diff --git a/spec/models/deployment_spec.rb b/spec/models/deployment_spec.rb
index 79647c5719c..d4e631f109b 100644
--- a/spec/models/deployment_spec.rb
+++ b/spec/models/deployment_spec.rb
@@ -322,32 +322,4 @@ describe Deployment do
       end
     end
   end
-
-  describe '#deployment_platform_cluster' do
-    let(:deployment) { create(:deployment) }
-    let(:project) { deployment.project }
-    let(:environment) { deployment.environment }
-
-    subject { deployment.deployment_platform_cluster }
-
-    before do
-      expect(project).to receive(:deployment_platform)
-        .with(environment: environment.name).and_call_original
-    end
-
-    context 'project has no deployment platform' do
-      before do
-        expect(project.clusters).to be_empty
-      end
-
-      it { is_expected.to be_nil }
-    end
-
-    context 'project has a deployment platform' do
-      let!(:cluster) { create(:cluster, projects: [project]) }
-      let!(:platform) { create(:cluster_platform_kubernetes, cluster: cluster) }
-
-      it { is_expected.to eq cluster }
-    end
-  end
 end

From c85d6b0c744e9a971fafdf58328f907dfa0de127 Mon Sep 17 00:00:00 2001
From: Thong Kuah <tkuah@gitlab.com>
Date: Thu, 4 Jul 2019 17:26:37 +1200
Subject: [PATCH 134/195] Restore fallback to deployment_platform_cluster

In 12.2 we will remove this fallback.
---
 app/models/deployment_metrics.rb                    | 13 ++++++++++++-
 .../projects/merge_requests_controller_spec.rb      |  7 ++++---
 spec/models/deployment_metrics_spec.rb              | 12 ++++++++++++
 3 files changed, 28 insertions(+), 4 deletions(-)

diff --git a/app/models/deployment_metrics.rb b/app/models/deployment_metrics.rb
index 2056c8bc59c..cfe762ca25e 100644
--- a/app/models/deployment_metrics.rb
+++ b/app/models/deployment_metrics.rb
@@ -44,7 +44,18 @@ class DeploymentMetrics
     end
   end
 
+  # TODO remove fallback case to deployment_platform_cluster.
+  # Otherwise we will continue to pay the performance penalty described in
+  # https://gitlab.com/gitlab-org/gitlab-ce/issues/63475
+  #
+  # Removal issue: https://gitlab.com/gitlab-org/gitlab-ce/issues/64105
   def cluster_prometheus
-    cluster.application_prometheus if cluster&.application_prometheus_available?
+    cluster_with_fallback = cluster || deployment_platform_cluster
+
+    cluster_with_fallback.application_prometheus if cluster_with_fallback&.application_prometheus_available?
+  end
+
+  def deployment_platform_cluster
+    deployment.environment.deployment_platform&.cluster
   end
 end
diff --git a/spec/controllers/projects/merge_requests_controller_spec.rb b/spec/controllers/projects/merge_requests_controller_spec.rb
index ea160a21955..2a6736018ea 100644
--- a/spec/controllers/projects/merge_requests_controller_spec.rb
+++ b/spec/controllers/projects/merge_requests_controller_spec.rb
@@ -887,9 +887,10 @@ describe Projects::MergeRequestsController do
         environment2 = create(:environment, project: forked)
         create(:deployment, :succeed, environment: environment2, sha: sha, ref: 'master', deployable: build)
 
-        # TODO address the last 5 queries
-        # See https://gitlab.com/gitlab-org/gitlab-ce/issues/63952
-        leeway = 5
+        # TODO address the last 11 queries
+        # See https://gitlab.com/gitlab-org/gitlab-ce/issues/63952 (5 queries)
+        # And https://gitlab.com/gitlab-org/gitlab-ce/issues/64105 (6 queries)
+        leeway = 11
         expect { get_ci_environments_status }.not_to exceed_all_query_limit(control_count + leeway)
       end
 
diff --git a/spec/models/deployment_metrics_spec.rb b/spec/models/deployment_metrics_spec.rb
index 7c574a8b6c8..0aadb1f3a5e 100644
--- a/spec/models/deployment_metrics_spec.rb
+++ b/spec/models/deployment_metrics_spec.rb
@@ -49,6 +49,18 @@ describe DeploymentMetrics do
 
         it { is_expected.to be_truthy }
       end
+
+      context 'fallback deployment platform' do
+        let(:cluster) { create(:cluster, :provided_by_user, environment_scope: '*', projects: [deployment.project]) }
+        let!(:prometheus) { create(:clusters_applications_prometheus, :installed, cluster: cluster) }
+
+        before do
+          expect(deployment.project).to receive(:deployment_platform).and_return(cluster.platform)
+          expect(cluster.application_prometheus).to receive(:can_query?).and_return(true)
+        end
+
+        it { is_expected.to be_truthy }
+      end
     end
   end
 

From 792455450a1934181369412bc5ba4082c832ed86 Mon Sep 17 00:00:00 2001
From: Thong Kuah <tkuah@gitlab.com>
Date: Mon, 8 Jul 2019 09:19:21 +1200
Subject: [PATCH 135/195] BE feedback: memoize deployment_metrics

Also memoize has_metrics? as well, that might be expensive, and it
should not change for the lifetime of EnvironmentStatus
---
 app/models/environment_status.rb | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/app/models/environment_status.rb b/app/models/environment_status.rb
index 1b3c094901b..465a42759df 100644
--- a/app/models/environment_status.rb
+++ b/app/models/environment_status.rb
@@ -34,7 +34,9 @@ class EnvironmentStatus
   end
 
   def has_metrics?
-    DeploymentMetrics.new(project, deployment).has_metrics?
+    strong_memoize(:has_metrics) do
+      deployment_metrics.has_metrics?
+    end
   end
 
   def changes
@@ -52,6 +54,10 @@ class EnvironmentStatus
 
   PAGE_EXTENSIONS = /\A\.(s?html?|php|asp|cgi|pl)\z/i.freeze
 
+  def deployment_metrics
+    @deployment_metrics ||= DeploymentMetrics.new(project, deployment)
+  end
+
   def build_change(file)
     public_path = project.public_path_for_source_path(file.new_path, sha)
     return if public_path.nil?

From 518e2b81e38b96d6afa508b39e30dc40f1b4b6c0 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Mon, 8 Jul 2019 00:41:33 +0000
Subject: [PATCH 136/195] Update redirected links in CE part 1

First MR in a series updating all redirected links
in CE documentation to the destination URLs
---
 doc/administration/auth/google_secure_ldap.md          |  3 +--
 doc/administration/database_load_balancing.md          |  2 +-
 doc/administration/dependency_proxy.md                 |  2 +-
 doc/administration/geo/replication/object_storage.md   |  4 ++--
 doc/administration/high_availability/consul.md         |  2 +-
 .../high_availability/monitoring_node.md               |  2 +-
 doc/administration/integration/plantuml.md             |  2 +-
 .../monitoring/performance/grafana_configuration.md    |  4 ++--
 .../monitoring/performance/influxdb_configuration.md   |  2 +-
 doc/administration/operations/fast_ssh_key_lookup.md   |  2 +-
 doc/administration/operations/unicorn.md               |  2 +-
 doc/administration/restart_gitlab.md                   |  4 ++--
 doc/api/pages_domains.md                               |  2 +-
 doc/ci/examples/README.md                              |  2 +-
 doc/ci/examples/artifactory_and_gitlab/index.md        |  2 +-
 doc/ci/examples/php.md                                 |  6 +++---
 doc/ci/examples/test-clojure-application.md            |  2 +-
 doc/ci/examples/test-scala-application.md              |  2 +-
 .../test_phoenix_app_with_gitlab_ci_cd/index.md        | 10 +++++-----
 doc/ci/metrics_reports.md                              |  2 +-
 doc/ci/quick_start/README.md                           |  2 +-
 doc/ci/services/postgres.md                            |  2 +-
 22 files changed, 31 insertions(+), 32 deletions(-)

diff --git a/doc/administration/auth/google_secure_ldap.md b/doc/administration/auth/google_secure_ldap.md
index c668f19ca7d..dd9e6ffc14d 100644
--- a/doc/administration/auth/google_secure_ldap.md
+++ b/doc/administration/auth/google_secure_ldap.md
@@ -13,7 +13,7 @@ The steps below cover:
 
 ## Configuring Google LDAP client
 
-1. Navigate to <https://admin.google.com> and sign in as a GSuite domain administrator.
+1. Navigate to <https://admin.google.com/Dashboard> and sign in as a GSuite domain administrator.
 
 1. Go to **Apps > LDAP > Add Client**.
 
@@ -202,6 +202,5 @@ values obtained during the LDAP client configuration earlier:
 
 1. Save the file and [restart] GitLab for the changes to take effect.
 
-
 [reconfigure]: ../restart_gitlab.md#omnibus-gitlab-reconfigure
 [restart]: ../restart_gitlab.md#installations-from-source
diff --git a/doc/administration/database_load_balancing.md b/doc/administration/database_load_balancing.md
index 98404ff2a10..2768fa8c027 100644
--- a/doc/administration/database_load_balancing.md
+++ b/doc/administration/database_load_balancing.md
@@ -265,7 +265,7 @@ production:
     replica_check_interval: 30
 ```
 
-[hot-standby]: https://www.postgresql.org/docs/9.6/static/hot-standby.html
+[hot-standby]: https://www.postgresql.org/docs/9.6/hot-standby.html
 [ee-1283]: https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/1283
 [eep]: https://about.gitlab.com/pricing/
 [reconfigure gitlab]: restart_gitlab.md#omnibus-gitlab-reconfigure "How to reconfigure Omnibus GitLab"
diff --git a/doc/administration/dependency_proxy.md b/doc/administration/dependency_proxy.md
index 4dc1f4dcba4..559cb29a487 100644
--- a/doc/administration/dependency_proxy.md
+++ b/doc/administration/dependency_proxy.md
@@ -1,6 +1,6 @@
 # GitLab Dependency Proxy administration **[PREMIUM ONLY]**
 
-> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/7934) in [GitLab Premium](https://about.gitlab.com/pricing) 11.11.
+> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/7934) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.11.
 
 GitLab can be utilized as a dependency proxy for a variety of common package managers.
 
diff --git a/doc/administration/geo/replication/object_storage.md b/doc/administration/geo/replication/object_storage.md
index c3c11dbaf1e..17446c24904 100644
--- a/doc/administration/geo/replication/object_storage.md
+++ b/doc/administration/geo/replication/object_storage.md
@@ -34,10 +34,10 @@ the bucket used by **secondary** nodes.
 
 If you are using Google Cloud Storage, consider using
 [Multi-Regional Storage](https://cloud.google.com/storage/docs/storage-classes#multi-regional).
-Or you can use the [Storage Transfer Service](https://cloud.google.com/storage/transfer/),
+Or you can use the [Storage Transfer Service](https://cloud.google.com/storage-transfer/docs/),
 although this only supports daily synchronization.
 
 For manual synchronization, or scheduled by `cron`, please have a look at:
 
-- [`s3cmd sync`](http://s3tools.org/s3cmd-sync)
+- [`s3cmd sync`](https://s3tools.org/s3cmd-sync)
 - [`gsutil rsync`](https://cloud.google.com/storage/docs/gsutil/commands/rsync)
diff --git a/doc/administration/high_availability/consul.md b/doc/administration/high_availability/consul.md
index 056b7fc15d9..c59ee3d2a58 100644
--- a/doc/administration/high_availability/consul.md
+++ b/doc/administration/high_availability/consul.md
@@ -2,7 +2,7 @@
 
 ## Overview
 
-As part of its High Availability stack, GitLab Premium includes a bundled version of [Consul](http://consul.io) that can be managed through `/etc/gitlab/gitlab.rb`.
+As part of its High Availability stack, GitLab Premium includes a bundled version of [Consul](https://www.consul.io/) that can be managed through `/etc/gitlab/gitlab.rb`.
 
 A Consul cluster consists of multiple server agents, as well as client agents that run on other nodes which need to talk to the consul cluster.
 
diff --git a/doc/administration/high_availability/monitoring_node.md b/doc/administration/high_availability/monitoring_node.md
index ef415dde10a..385e7441ac9 100644
--- a/doc/administration/high_availability/monitoring_node.md
+++ b/doc/administration/high_availability/monitoring_node.md
@@ -12,7 +12,7 @@ The steps below are the minimum necessary to configure a Monitoring node running
 Omnibus:
 
 1. SSH into the Monitoring node.
-1. [Download/install](https://about.gitlab.com/installation) the Omnibus GitLab
+1. [Download/install](https://about.gitlab.com/install) the Omnibus GitLab
    package you want using **steps 1 and 2** from the GitLab downloads page.
    - Do not complete any other steps on the download page.
 
diff --git a/doc/administration/integration/plantuml.md b/doc/administration/integration/plantuml.md
index 82e0c14ffc2..8de7b0bc57e 100644
--- a/doc/administration/integration/plantuml.md
+++ b/doc/administration/integration/plantuml.md
@@ -94,7 +94,7 @@ our AsciiDoc snippets, wikis and repos using delimited blocks:
        Alice -> Bob: Go Away
     ```
 
-    You can also use the `uml::` directive for compatibility with [sphinxcontrib-plantuml](https://pypi.python.org/pypi/sphinxcontrib-plantuml), but please note that we currently only support the `caption` option.
+    You can also use the `uml::` directive for compatibility with [sphinxcontrib-plantuml](https://pypi.org/project/sphinxcontrib-plantuml/), but please note that we currently only support the `caption` option.
 
 The above blocks will be converted to an HTML img tag with source pointing to the
 PlantUML instance. If the PlantUML server is correctly configured, this should
diff --git a/doc/administration/monitoring/performance/grafana_configuration.md b/doc/administration/monitoring/performance/grafana_configuration.md
index 51b0d78681d..4dd0bbbe937 100644
--- a/doc/administration/monitoring/performance/grafana_configuration.md
+++ b/doc/administration/monitoring/performance/grafana_configuration.md
@@ -1,6 +1,6 @@
 # Grafana Configuration
 
-[Grafana](http://grafana.org/) is a tool that allows you to visualize time
+[Grafana](https://grafana.org/) is a tool that allows you to visualize time
 series metrics through graphs and dashboards. It supports several backend
 data stores, including InfluxDB. GitLab writes performance data to InfluxDB
 and Grafana will allow you to query to display useful graphs.
@@ -13,7 +13,7 @@ services.
 
 [GitLab Omnibus can help you install Grafana (recommended)](https://docs.gitlab.com/omnibus/settings/grafana.html)
 or Grafana supplies package repositories (Yum/Apt) for easy installation.
-See [Grafana installation documentation](http://docs.grafana.org/installation/)
+See [Grafana installation documentation](https://grafana.com/docs/installation/)
 for detailed steps.
 
 NOTE: **Note:**
diff --git a/doc/administration/monitoring/performance/influxdb_configuration.md b/doc/administration/monitoring/performance/influxdb_configuration.md
index fa281f47ed8..cf6728510fe 100644
--- a/doc/administration/monitoring/performance/influxdb_configuration.md
+++ b/doc/administration/monitoring/performance/influxdb_configuration.md
@@ -187,7 +187,7 @@ Read more on:
 [influxdb documentation]: https://docs.influxdata.com/influxdb/v0.9/
 [influxdb cli]: https://docs.influxdata.com/influxdb/v0.9/tools/shell/
 [udp]: https://docs.influxdata.com/influxdb/v0.9/write_protocols/udp/
-[influxdb]: https://influxdata.com/time-series-platform/influxdb/
+[influxdb]: https://www.influxdata.com/products/influxdb-overview/
 [tsm tree]: https://influxdata.com/blog/new-storage-engine-time-structured-merge-tree/
 [tsm1-commit]: https://github.com/influxdata/influxdb/commit/15d723dc77651bac83e09e2b1c94be480966cb0d
 [influx-admin]: https://docs.influxdata.com/influxdb/v0.9/administration/authentication_and_authorization/#create-a-new-admin-user
diff --git a/doc/administration/operations/fast_ssh_key_lookup.md b/doc/administration/operations/fast_ssh_key_lookup.md
index 3631ea0822f..5a3a0c34038 100644
--- a/doc/administration/operations/fast_ssh_key_lookup.md
+++ b/doc/administration/operations/fast_ssh_key_lookup.md
@@ -6,7 +6,7 @@ using [ssh certificates](ssh_certificates.md), they are even faster,
 but are not a drop-in replacement.
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/1631) in
-> [GitLab Starter](https://about.gitlab.com/gitlab-ee) 9.3.
+> [GitLab Starter](https://about.gitlab.com/pricing/) 9.3.
 >
 > [Available in](https://gitlab.com/gitlab-org/gitlab-ee/issues/3953) GitLab
 > Community Edition 10.4.
diff --git a/doc/administration/operations/unicorn.md b/doc/administration/operations/unicorn.md
index 0e2079cb093..ae67d7f08d6 100644
--- a/doc/administration/operations/unicorn.md
+++ b/doc/administration/operations/unicorn.md
@@ -2,7 +2,7 @@
 
 ## Unicorn
 
-GitLab uses [Unicorn](http://unicorn.bogomips.org/), a pre-forking Ruby web
+GitLab uses [Unicorn](https://bogomips.org/unicorn/), a pre-forking Ruby web
 server, to handle web requests (web browsers and Git HTTP clients). Unicorn is
 a daemon written in Ruby and C that can load and run a Ruby on Rails
 application; in our case the Rails application is GitLab Community Edition or
diff --git a/doc/administration/restart_gitlab.md b/doc/administration/restart_gitlab.md
index cbc3fbd9473..e23f2052d04 100644
--- a/doc/administration/restart_gitlab.md
+++ b/doc/administration/restart_gitlab.md
@@ -137,9 +137,9 @@ If you are using other init systems, like systemd, you can check the
 [GitLab Recipes][gl-recipes] repository for some unofficial services. These are
 **not** officially supported so use them at your own risk.
 
-[omnibus-dl]: https://about.gitlab.com/downloads/ "Download the Omnibus packages"
+[omnibus-dl]: https://about.gitlab.com/install/ "Download the Omnibus packages"
 [install]: ../install/installation.md "Documentation to install GitLab from source"
 [mailroom]: reply_by_email.md "Used for replying by email in GitLab issues and merge requests"
-[chef]: https://www.chef.io/chef/ "Chef official website"
+[chef]: https://www.chef.io/products/chef-infra/ "Chef official website"
 [src-service]: https://gitlab.com/gitlab-org/gitlab-ce/blob/master/lib/support/init.d/gitlab "GitLab init service file"
 [gl-recipes]: https://gitlab.com/gitlab-org/gitlab-recipes/tree/master/init "GitLab Recipes repository"
diff --git a/doc/api/pages_domains.md b/doc/api/pages_domains.md
index 70fbe24099f..9678203eb40 100644
--- a/doc/api/pages_domains.md
+++ b/doc/api/pages_domains.md
@@ -1,6 +1,6 @@
 # Pages domains API
 
-Endpoints for connecting custom domain(s) and TLS certificates in [GitLab Pages](https://about.gitlab.com/features/pages/).
+Endpoints for connecting custom domain(s) and TLS certificates in [GitLab Pages](https://about.gitlab.com/product/pages/).
 
 The GitLab Pages feature must be enabled to use these endpoints. Find out more about [administering](../administration/pages/index.md) and [using](../user/project/pages/index.md) the feature.
 
diff --git a/doc/ci/examples/README.md b/doc/ci/examples/README.md
index 2b4fe321cb3..52433c72646 100644
--- a/doc/ci/examples/README.md
+++ b/doc/ci/examples/README.md
@@ -42,7 +42,7 @@ The following table lists examples with step-by-step tutorials that are containe
 
 Contributions are welcome! You can help your favorite programming
 language users and GitLab by sending a merge request with a guide for that language.
-You may want to apply for the [GitLab Community Writers Program](https://about.gitlab.com/community-writers/)
+You may want to apply for the [GitLab Community Writers Program](https://about.gitlab.com/community/writers/)
 to get paid for writing complete articles for GitLab.
 
 ## Adding templates to your GitLab installation **[PREMIUM ONLY]**
diff --git a/doc/ci/examples/artifactory_and_gitlab/index.md b/doc/ci/examples/artifactory_and_gitlab/index.md
index 2117b342903..c9f700ed190 100644
--- a/doc/ci/examples/artifactory_and_gitlab/index.md
+++ b/doc/ci/examples/artifactory_and_gitlab/index.md
@@ -13,7 +13,7 @@ date: 2017-08-15
 ## Introduction
 
 In this article, we will show how you can leverage the power of [GitLab CI/CD](https://about.gitlab.com/product/continuous-integration/)
-to build a [Maven](https://maven.apache.org/) project, deploy it to [Artifactory](https://www.jfrog.com/artifactory/), and then use it from another Maven application as a dependency.
+to build a [Maven](https://maven.apache.org/) project, deploy it to [Artifactory](https://jfrog.com/artifactory/), and then use it from another Maven application as a dependency.
 
 You'll create two different projects:
 
diff --git a/doc/ci/examples/php.md b/doc/ci/examples/php.md
index c459bb7001f..0b9e9e93e55 100644
--- a/doc/ci/examples/php.md
+++ b/doc/ci/examples/php.md
@@ -64,7 +64,7 @@ docker-php-ext-install pdo_mysql
 You might wonder what `docker-php-ext-install` is. In short, it is a script
 provided by the official php docker image that you can use to easily install
 extensions. For more information read the documentation at
-<https://hub.docker.com/r/_/php/>.
+<https://hub.docker.com/_/php>.
 
 Now that we created the script that contains all prerequisites for our build
 environment, let's add it in `.gitlab-ci.yml`:
@@ -96,7 +96,7 @@ Finally, commit your files and push them to GitLab to see your build succeeding
 The final `.gitlab-ci.yml` should look similar to this:
 
 ```yaml
-# Select image from https://hub.docker.com/r/_/php/
+# Select image from https://hub.docker.com/_/php
 image: php:5.6
 
 before_script:
@@ -286,7 +286,7 @@ that runs on [GitLab.com](https://gitlab.com) using our publicly available
 Want to hack on it? Simply fork it, commit, and push your changes. Within a few
 moments the changes will be picked by a public runner and the job will begin.
 
-[php-hub]: https://hub.docker.com/r/_/php/
+[php-hub]: https://hub.docker.com/_/php
 [phpenv]: https://github.com/phpenv/phpenv
 [phpenv-installation]: https://github.com/phpenv/phpenv#installation
 [php-example-repo]: https://gitlab.com/gitlab-examples/php
diff --git a/doc/ci/examples/test-clojure-application.md b/doc/ci/examples/test-clojure-application.md
index 5cda8702b56..6ea38f22bca 100644
--- a/doc/ci/examples/test-clojure-application.md
+++ b/doc/ci/examples/test-clojure-application.md
@@ -35,7 +35,7 @@ test:
     - lein test
 ```
 
-In `before_script`, we install JRE and [Leiningen](http://leiningen.org/).
+In `before_script`, we install JRE and [Leiningen](https://leiningen.org/).
 
 The sample project uses the [migratus](https://github.com/yogthos/migratus) library to manage database migrations, and
 we have added a database migration as the last step of `before_script`.
diff --git a/doc/ci/examples/test-scala-application.md b/doc/ci/examples/test-scala-application.md
index bd899240307..7d039ab1aeb 100644
--- a/doc/ci/examples/test-scala-application.md
+++ b/doc/ci/examples/test-scala-application.md
@@ -46,7 +46,7 @@ deploy:
 
 In the above configuration:
 
-- The `before_script` installs [SBT](http://www.scala-sbt.org/) and
+- The `before_script` installs [SBT](https://www.scala-sbt.org/) and
   displays the version that is being used.
 - The `test` stage executes SBT to compile and test the project.
   - [sbt-scoverage](https://github.com/scoverage/sbt-scoverage) is used as an SBT
diff --git a/doc/ci/examples/test_phoenix_app_with_gitlab_ci_cd/index.md b/doc/ci/examples/test_phoenix_app_with_gitlab_ci_cd/index.md
index ec25ca1bfc3..a5fed00972f 100644
--- a/doc/ci/examples/test_phoenix_app_with_gitlab_ci_cd/index.md
+++ b/doc/ci/examples/test_phoenix_app_with_gitlab_ci_cd/index.md
@@ -404,14 +404,14 @@ other reasons][ci-reasons] to keep using GitLab CI/CD. The benefits to our teams
 [phoenix-learning-guide]: https://hexdocs.pm/phoenix/learning.html "Phoenix Learning Guide"
 [phoenix-install]: https://hexdocs.pm/phoenix/installation.html "Phoenix Installation"
 [phoenix-mysql]: https://hexdocs.pm/phoenix/ecto.html#using-mysql "Phoenix with MySQL"
-[elixir-site]: http://elixir-lang.org/ "Elixir"
-[elixir-mix]: http://elixir-lang.org/getting-started/mix-otp/introduction-to-mix.html "Introduction to mix"
-[elixir-docs]: http://elixir-lang.org/getting-started/introduction.html "Elixir Documentation"
+[elixir-site]: https://elixir-lang.org/ "Elixir"
+[elixir-mix]: https://elixir-lang.org/getting-started/mix-otp/introduction-to-mix.html "Introduction to mix"
+[elixir-docs]: https://elixir-lang.org/getting-started/introduction.html "Elixir Documentation"
 [elixir-install]: https://elixir-lang.org/install.html "Elixir Installation"
-[ecto]: http://hexdocs.pm/ecto "Ecto"
+[ecto]: https://hexdocs.pm/ecto/Ecto.html "Ecto"
 [ecto-repo]: https://hexdocs.pm/ecto/Ecto.html#module-repositories "Ecto Repositories"
 [mix-ecto]: https://hexdocs.pm/ecto/Mix.Tasks.Ecto.Create.html "mix and Ecto"
-[iex]: http://elixir-lang.org/getting-started/introduction.html#interactive-mode "Interactive Mode"
+[iex]: https://elixir-lang.org/getting-started/introduction.html#interactive-mode "Interactive Mode"
 [ci-lint]: https://gitlab.com/ci/lint "CI Lint Tool"
 [ci-reasons]: https://about.gitlab.com/2015/02/03/7-reasons-why-you-should-be-using-ci/ "7 Reasons Why You Should Be Using CI"
 [ci-guide]: https://about.gitlab.com/2015/12/14/getting-started-with-gitlab-and-gitlab-ci/ "Getting Started With GitLab And GitLab CI/CD"
diff --git a/doc/ci/metrics_reports.md b/doc/ci/metrics_reports.md
index f9cfc0892a7..1b2dda29eb5 100644
--- a/doc/ci/metrics_reports.md
+++ b/doc/ci/metrics_reports.md
@@ -4,7 +4,7 @@ type: reference
 
 # Metrics Reports **[PREMIUM]**
 
-> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/9788) in [GitLab Premium](https://about.gitlab.com/pricing) 11.10.
+> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/9788) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.10.
 Requires GitLab Runner 11.10 and above.
 
 ## Overview
diff --git a/doc/ci/quick_start/README.md b/doc/ci/quick_start/README.md
index 11bcfd5dc2c..0480b83d183 100644
--- a/doc/ci/quick_start/README.md
+++ b/doc/ci/quick_start/README.md
@@ -233,7 +233,7 @@ CI with various languages.
 [runner-install]: https://docs.gitlab.com/runner/install/
 [blog-ci]: https://about.gitlab.com/2015/05/06/why-were-replacing-gitlab-ci-jobs-with-gitlab-ci-dot-yml/
 [examples]: ../examples/README.md
-[ci]: https://about.gitlab.com/gitlab-ci/
+[ci]: https://about.gitlab.com/product/continuous-integration/
 [yaml]: ../yaml/README.md
 [runner]: ../runners/README.md
 [enabled]: ../enable_or_disable_ci.md
diff --git a/doc/ci/services/postgres.md b/doc/ci/services/postgres.md
index 211eea26eb0..960346ac11a 100644
--- a/doc/ci/services/postgres.md
+++ b/doc/ci/services/postgres.md
@@ -114,5 +114,5 @@ available [shared runners](../runners/README.md).
 Want to hack on it? Simply fork it, commit and push  your changes. Within a few
 moments the changes will be picked by a public runner and the job will begin.
 
-[hub-pg]: https://hub.docker.com/r/_/postgres/
+[hub-pg]: https://hub.docker.com/_/postgres
 [postgres-example-repo]: https://gitlab.com/gitlab-examples/postgres

From e704cd09f7bae52657078fe177507d36322cb65b Mon Sep 17 00:00:00 2001
From: glass-ships <glass.ships@outlook.com>
Date: Mon, 8 Jul 2019 02:14:49 +0000
Subject: [PATCH 137/195] ADD '.git' ending to git clone with CI_JOB_TOKEN for
 clarity

---
 doc/user/project/new_ci_build_permissions_model.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/user/project/new_ci_build_permissions_model.md b/doc/user/project/new_ci_build_permissions_model.md
index c07c4099f22..d35a8568394 100644
--- a/doc/user/project/new_ci_build_permissions_model.md
+++ b/doc/user/project/new_ci_build_permissions_model.md
@@ -185,7 +185,7 @@ The [Job environment variable][jobenv] `CI_JOB_TOKEN` can be used to
 authenticate any clones of dependent repositories. For example:
 
 ```
-git clone https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.com/myuser/mydependentrepo
+git clone https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.com/<user>/<mydependentrepo>.git
 ```
 
 It can also be used for system-wide authentication

From 2f1e4740a0be21d1e024ba4ced83b818ccc3ed67 Mon Sep 17 00:00:00 2001
From: Tristan Williams <2390023-tristan@users.noreply.gitlab.com>
Date: Mon, 8 Jul 2019 05:47:37 +0000
Subject: [PATCH 138/195] Refresh screenshots

Current screenshots are from an older version of Jira and GitLab.
---
 .../integrations/img/jira_api_token.png       | Bin 61394 -> 21318 bytes
 .../integrations/img/jira_api_token_menu.png  | Bin 25056 -> 41876 bytes
 .../integrations/img/jira_issue_reference.png | Bin 18399 -> 64064 bytes
 .../img/jira_merge_request_close.png          | Bin 21172 -> 64305 bytes
 .../img/jira_service_close_comment.png        | Bin 11890 -> 0 bytes
 .../img/jira_service_close_issue.png          | Bin 30570 -> 29632 bytes
 .../integrations/img/jira_service_page.png    | Bin 30395 -> 70807 bytes
 doc/user/project/integrations/jira.md         |  26 +++++++++---------
 .../integrations/jira_cloud_configuration.md  |  16 ++++++-----
 9 files changed, 22 insertions(+), 20 deletions(-)
 delete mode 100644 doc/user/project/integrations/img/jira_service_close_comment.png

diff --git a/doc/user/project/integrations/img/jira_api_token.png b/doc/user/project/integrations/img/jira_api_token.png
index 4fa7a46854e669a3fe8eaab3ade9225c758ba745..29689271bf70c4fb7a0bc6b1ea47275b5f07f56e 100644
GIT binary patch
literal 21318
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
MU~{8)hWEn%2eMrq1ONa4

literal 61394
zcmcF}V{~TGvTdx6?WDtwtuMB1cWm2c$F^<T=-77BvGv7zea=1ao^#(D@8{cNtg&lV
z%~`c;u0MOMQ4tDq;s|iKa3CNc2$B*aN+2L$Cx4d$4ESHqIe|gP-xq|LpsXMWNPX<L
zcLT`3dr&7OaUqbJY5dc_cD99zhO>sO48X|FhTg!~&d`M3-Nybe3Iv459q`w*F>y8^
zcDJ#%bpp8alKc|^_-p^e%|Jr@Pl&S>FNub%0<o~2qX{t^Ju5vU2_GCWF)@#$u_-`F
zMC@PmzdK$Mb7yCJ00V=Yn;X3w3%#AA83Pj+7Z(E~GXpa--CqQqlZUOdfjgb86X|~?
z`QLd&Oq`4yE$p2w>}-kuk=MY`&c&IRgybKE{`>i_?=*3@_;)2+r+>Bew?T$~L>QRp
z85#aN_g^Z{KfC}13wIN14G{|)6I-XhHTXDKS$Y16|Gy&tuJ|8J&3`l5xS0Qw`5%#g
zF?ksN(ZGK+^j~WI)B9I0J~$qR|CXK)4h`w4^6zQD+Dm9Ufq-C=|6_qlDv{lQfPjN2
z$f$_=2L=Fv!1wp}x3@PhA8%3jwvUgGhlhu+udmO~&&kP2W)_yIsVOFA=Euj!*SFVu
z;Qiv_qJKcZ_RbC?6VuYt(*FK_U47lw*4E4G>(leo-TfUaE9>*iGXn#|&Fu~F@h&$%
z5BLCNV`mq2YabaMWn*Le{QA1Qx)gSAyS=;h3-IUW=6-m1V&~ux^k`#YV+92T4G0SK
z^!7SFIo8q9c>+GDsHl{cmveA(^78VAmCQu`ikzRHKR7&4S6AQL+Y@nX5f%~NKDzYr
z^|`*jHZ?PS1U?7~3El%AD=RDY_4T8pqxt#yHMKNF#YF8L>|cS8_s@5nTwKq$FI)hC
zwYBxd<%Nf*$LH6lqLSj#(b2%*poN8nq?Dw*g8cdUIV(F`enCM~Q`70$siC1^P;l_?
zk>7D~agWbWwsy8j$;q>`v#F`6zW#nSH8sP-!{OoKtE;Qh($a-RMI|LA#wNz=>+1~-
z4c$H6v~+ai<Ktp3T_>j}Z=dgd{r%|~=}yj0on2j<o0~bgxo+-mF0QWGIoSg4%?XK#
zvU0MSSy{cky&<6?IJo$&t*s7@jth$mLLQw0E^QKCZDQi$;-20AIIOSt&yOc@2?+_;
zW&xK5QIE#IE&-RG+sB8B-u35)+qSm0ilJTY@V@=a`;Lx|zyNO<zb;}NOdtOMG&I!b
z&rjgf>&N?-Me@ku?aSx;n|EN~>*uR?-V7NTnV*m2`{(ECA<#F-$3A@`BrNRV?Oo2R
z;q30=^Yc~Nzq4WDP|&O2AbPNK_Rsah%LDN3@&3jyAcTd5S;noyEn~QQ@m$oU`uh2O
z<KpS_{Vu6~Mk}br!#5zRdinG9^X=nFDQFOzfI72v-7h#~eB<0EzHk1|oe1ZT_Rfxp
zo%_{;^MJz9;gy5@o*j25v%81uoQ@^$z;Fkj!1<lix99hS#x*l%Z$~RtIRQ2TI;Fw&
z8#*>Y9&u$89ogr{Q?r<M31xG3N=y@RW>RW4H3N&$$ysGn7iYhy@+q=G5D;PzNfAL6
z_w|cxeff=1%)ayu3DWBGxmmfq$)Wm4RrGd6W430PG6WPU4H17eq5QddO!EMf7i9^p
zJO$lmXKD4#KscnghFYIhhI*nS-z2Z!6rgb3Q$B4-%Q?9ueSY>lk9O1exx^)Op~QaR
z>o=&xKLCMwCoq8pq%e^&|6}uSuObF-X0)nNeYe%bj2Hlg3{Z8*7iH;Vw1z1%Gm!Js
z)AeQMbqh5g1{DQ+zqmYk<*8!LvUycVWaf9|(#5anHsdTsR)PqaV5d}NEiFyR0DjC~
z8c!xQI<+VEqaRM~WIq6?7)8OWRWQ8UVFJ1zzGq6oZM~j@N}Fc|e?#fvH3E)88WA5i
z>h&S`-CC2T8@Bxd0^xs9Yl%?P@p<7V5>mu$uUqaIaVKgpe;B~;bD<W86RwZLy6r5k
zKlU&H(zdx)5Kste2~c@gU`?uw{AyRnp~aT?ZJO{S$}VoCs@1g1I*c3FY+|tBBWxS4
zdMbZwq3}LpE;x~OFlFD$r~0sa-WssF`WKMKhbYfSo~VYOZa|2N7etb5U2DB)ry4T-
zLLrE#J4x!9Xi*avpNl^!ISH;;BkB0O9|i~FM=<{txuEdm|5W&2a!1A#kp2Kf#{66G
z|2&htlm9pQok$ePY!=2BkR7h_1+J%YLJ^FD8vP<UxKOPBQ8;$>6SB+Qh;obF@s-7j
zz1M+BE@jNGTW3$T9~t%g92YsJS(Nf=gYsN?!q%2&16euDuf9uTm3sZQoO`J0_a+=q
zTmwY?2$Kl~W!Q<N#=e_x%C*c}1OqR#*e@lgnE3I1UZ?G!3WF!%w(YdNDHDe|Q$Low
zGIj8r_*3yb9@5HxY|3#?yh3wsVbs;m!HcclO4yRE7+>z3-{J`Ms}#t7;IQ+p$l9<f
zFjeyzNC_eJzBe!xkY#%HGBp?^E}Vym5R13s?0BZhnKAz|BSD97e|uFV&%Pqsqs4Xj
z)oV|k91+r)vT;&9E3A(oukt!S8^h=RQ2KR3cYOqh&w53zsCr(jGS2euJUTClpv(y8
z?eQ_SC@Lja%YRX6e1|Cpl!!na^sqb#kN`&UQoK(RsMpTtFg|{c6~q+^V>58d%`@uh
zsZK=%k*nuY;4h#E87DM`riBohM)wzT)PZ)`Sr`Zb;U^WwR9JL6BehuhUL5DtQsp(N
z9$@T!s4P_Oq8QP6h01>&xUR@pyRvKEUf-cDxY+hEn_@@obrdCu_c@&&QHW4{AEJqS
zHZGQ~MncPbk^2plG4LE)gZ<9Kq}U^sUL-|loOSRFzx4fG#93O2d4bEu6w}5+_f^hb
zX5br=7raxXa@IA2P=T~BWWszUxTHZ$HM?CqnKd)1=Ol_Ai6XLYgUWRb>Fa#NHdQ6c
zJh=;hF~VGLD<`0%tF4W*gCpBD0cQp$TbbVIjIlBC_WI1ad+xNIM19q<H=VG#-OEE{
z1*uUxaqK`NpN8b2tT*Iji8lN*`zH*C*1VZfXew~$2ddh1_(nQw*HAXtK~W97RcvW;
z^Nn`hS<$p>13T>+8<xDZ<3W+3WCk>GspwSQwm2@v^pRlZ^(v>W(^d!tRWqNt=b$`-
zaMxjUBk|Bj9A@KwuaG<iPZ@&?`a;PKh3#oYWcTbbHaJVKf=9`qfMIXeV-{|5gF{MD
z{3IKF;JeG%iNl?}$nvJQlKnwa7T3O0wZ)Za9qpPU$U?0f-K13MF%GZ!X~pyfpkxo@
zo8UV|WHtQ2-7{Um5AODCkr~QD>~B)|QK!Q<^k?HmJemc9bn>Tl;+ccOb+PnkRG1e6
zgC@G43to^j&PprqKU$p+8JaXh!;U%_i%w$s&s=CPQn5r&LxZ`~+Z$JnBExFvnH}eg
z-QMXg)4?Aa<K0;IJ^tuQJspNb8AQ!wPweN_d$ZYaJ^>k|$@{%I`6Yu&vDSY4-qB#5
z>?z-^u%9rMQO9#hglVoOc2MuH>8SSvc+tDO`}YhFHWZ1>Y0F8L=OkYx;J9qWOgDNt
zH_2+3BQ@-UN*IOduhE-Jo9q=bcI}8;!@5x^Of3PZAz`V%oh|I5@(e;^n3a?w76$aP
zGHTAToC-Y0l~%5GfJ?4U)9DVI_QPrHYJt}EBXA?Egc;Tq8g3>?o$f4Cg8E2X*!7V;
z4JZ?r-hwXRy}cjm^GceDx}pDq3|bJKt4&2Pn4Hn22XqBYq|lIbpP&-5iU@M=L4?x}
z=VE)RIqTXaMM6ylRTfw^Q?GK<{-IIGg3uLn^IZMytlvyd{mwrG{3whS$1=wQ%p~UL
z&(OsrWtWgn-V*7w(KG=qWYRvuJfyYhRej$UgsRy)Fpu}Z(`XLWc=Y^?QBaRyJuMJ(
zwpGsBc=-n5+O;l^q)t_wPY7Pzd2<RZt!#jGEnnW!g0tW@`KkVVu5V(Ob*^n4d?SJJ
z0W15L5AAux)5YCOdc8aOBQT7y$LfD>(Vy>@oWOgz%mGNY)^rar$8qQD;VEa#bINa_
zW{<wY&c#yN50<~3AJ_M6%x5t)N8Ua%Y<&bnVrk4oRt6PDJ|3T$tiea}_0a)V&4Yu(
zPcJw7Fxc>ff<`52nfw~v>e{2avJRo;KIb`3>ppf)CnPpYP8a=FnKx=A0ICl*s|-05
zokXBREep->SXh_uyVEv2FXj9OFvq9w=7RIY*!NaFy+Eix*~LL?o5DMOcZ8k+E-sBc
zeqC%|edvR}m(C!8Kf3l(DUsmb?itX;3htbp_=}I@;9F*2dHooT!bSY94?Go?I=N5Z
zGOYq?vKD_GI(lf1NSc<%`0V7?2Js*BSAKudW#IBM-k7lX?pf=^yIwaz3TUU|*)N?C
zRZr<|I6(4>VbXb=prNu?Kl1Zpz7!B+z5Us!2DANGbrPks1Dxpjf}GY?<YEJSg)v5n
z>;PxiNiVtZ_ihue?b@t_7tliYcyE5$1q#Aj+%BLDs6AC+S$H|*Y<zPgOjP6R+n2)p
zy~kC37t-PS8L}VIKeHIPqoUn8IDjlUBMmdR(^(@uoAkafIpF>36gL$VT`ahO?TsK_
zk2EiK*p38dBI0=6M2)2Xh<0>6WBWvjV59~!azP{^XiFpMrhe8}3ll%-&K-)pP?^=f
zNpR-yTC)ZScY1v<ZZwM7kU2B%>0V*Xb=7(47~T44S#fY};nKWj^PI<1`jQRm(g7~|
zt#Y*Hv?SBTtdvTmq)nQ4u;`pc*sv`N#^Z?=5-M2!k}W8!QTUEb6)AX_Ak*F?VE(-u
zA{^NU4qs8A^DUp@tr_V9)jRD&aT-_Ibz-~ea8JUg9|B@@dib-N?dwZxf`M^p;4vgG
zDBRMdf5vcic#KDl0mtjwD3(c-fqo~~btb3>eF&Otz~|hd_@Zh0kfiDdJWJ&Ooc#W)
z?CdpAdFf7%pPHB|9<pL=Lg<L87N%ztO4{wNcjb!rW5o6Hy~X`)eSyFeN76hH%q|th
zG^G3-Xfiioo@7N8z3t8Y%K=KAmZDw+rg#H?zFc+?!k3RA?mREmg^%f??l#B&eZp5~
z({aASIXb=70SaJlGmbQ_R027{_#J;&qKJ~~2c!*EbBT_9C{rvI`n#k8_!W55;p7nM
z)U-M^sz(TY@h$=Y+Tu19-Td*s---xkD3lT=7bzPe^E7Nf3AqOu=%vJI^nn#<tG}}R
z2~tTCB9qrc5J$aW1S1XO7*PKcmG>h5SfF$ZJcT^_;Zi^|WjXxkbjrHAt)zALSZ7^R
zTp@J>HDBLModB5Tv+8DDEpktmV}Pii#nW`R75};|_{+ipGcJLWaYIXvAgr_X3RW8W
zj7`N3nHC*%`J~sjGHG*jI`inptp$RDn>74X4UQ`-zK{|THtuym@2E4%U2{_7T3E=f
z`yE3ijH}I3KrqGpH>a(a(+@Z@yWV^$4p%+6;E#_Q|406DQ)GH-qE!(Xv)BUM;n||P
z-Cn0iPn$o){jWJxjc@8Je2zy`$V@L<T;ZLAoJ?=9a>y{jwE`;zTw)JPcaV)xm%rFL
zs!MSn5=iYeVwaR#*5C!r^TY5qybZ;>xw6g|<pj;P<L*$wHNt@oy-;v+UoN15-+38%
zYgg7);rF-!kSQ8pjTIfLdalJx&PLAIB)kqHwVNj<EC8~mK`Z|4tG=h{;$h@iI%4~x
zOYo>!clam@$$9O%IQ2)b!i@3R4u-hRb9M0V6EIV9xl66e`}P8{6)ZAXIL1A7<&f3#
z<+b}X?O@bd7;49YFbgk&xqEkX$+tlXKc8b$*_2h?3|SC`z?pWrS4QT;D&%`rh(LR2
zzeG&L>5#Y@aevWXsORC?cKX|QsE>u2V$QzF$1V1x&DBFy`2~wj48E^}L0Fjt>A`!V
zv(aFv;DqQ;`R@d>#KVTEOeK~8ylHQLNZ8GH(rVzm-(G(&GQVzv3eBLG?FvmE^J4}@
z?lk3_{K?c=a#nsxO>1c0o8Q&i!<F;%<S`kq+uK7?{%ZTvFOYER$2!s{h~n)P_&~Do
zlo|{1$9~_XOi-sHY^N(Nr0=R6ZdNE(V2vzzzj+>JHGqN_36PT9Z&LtfS<VC&>|8dl
z4gW~AUG1Q1MCtj#g*m(=P|AQNLvI^IE%nJo3yO}3SiZKZk+C;sTX6*6Tj67M4-Hd@
z>Vlxa>n30k<vc(i-~k7yY{Apjjjq|jo0`sfAh{Sb{lgEkg{J}@Q^XBzNH+<dA8Na9
zj4~wMoTz|`ls*Yh-YK=~pFQk>Dhtao5{FJ{8H&{qxJD4Dq*;zb<%CxBYjRi>@;93m
z4fZrrFW5(EfUgz@zLreTkTF>In6fI4e2s?^`qe;)lPceQhJf=6vHt|_pKpTt_w{i^
z-*Zt3=+AcqM%I*#WMHpv(psUz?gVGa4HC;t;dz?ChlYG}R=Z95_1N0-<uBlv_-Gtz
z<QB7Vo<p|&UOq_Y=D@*}{l*^M*;$k&$*Y(UdhWck;Nl-YIjy%p`n;3D4kfiHL3e&I
zT5Nx%IH@o=s6h3DA8_za46-VLdl$nfxWgGO*fyaZ7k=RYBlX)-qriFpofV9<>K{Ud
z8*m_w5!&GKT&*h_xb;EXx*5wS#^uOHcE2E?jtYXgvWndXFhHn+3>LuD2S6CSR!G`G
zb>x>FjS#Z}I@)c$NejVG%-L%r*+9y@2%QyrK615%-ifD}y#mCPz*F{Xp|a-7Kr3Ag
zzQs0$o5pgs)q&S$<chTIixdn5kuf$Ai#$jy^a3$eK@-mL2xk|ZW#!-jxlU>BJ32~A
zC#;1mP?|brL_djI(nhy0WBor7PjDasbJqig4PVO#6}kf9OiXYy4QV8=8;5*ZSL<jn
zn1xh{jvCyPi$64``n4AIl&kmk;&k-jS*J`f=KXYDP?p|&vP6Gi=>&Y<GXoS1OPY!i
zb`mcJrPa576`l%0J9cqPsiw7@;o{O!WT)e8?y~&Bn;-69gH<@D$UoX)>!4kN;ZXS&
zkB=F$xgYxIno@t)?Ag6tF``vH{fdI>=!%HQ3jzL=&{<@KSqLqz&FRBzaFY*jWak-x
z<Cub0n9_k4c(0wW1@fNx%EH(hf?#W9W{Q4S(}#&4S#O`F?pY<WhEz0RPNwS{khh~M
zFQUTfP@V073Vsh2n@XGF0qqbpz$u9X6$X>3C6<;w1Teax(yFdmK7wh;lD{FltPnZ$
zPEa1qYgry=O4?U91s+>CM>{>0$Zf^YQ9PCOWp;#`LKytM%M~%<TTmT43ni@z=`da0
z8_ui6pi`^RUE##9O}x*uOO9<fr6H9(JvX3w)ZH?VQOB+<%8pcj{BZ72T1%+PJ4>L;
zjo7$P`h=P{YV0)Jdm=XX?0c;)T3mN>?Zgj<nu_v(Zw#TVtfZm2`5`H>eXcz84%UJC
zVj0?+*7;NqOFa~0THBL3*PcL1&Uq7pU{HF-MKR|FhiziD7{efKVG?Z2$%0kvWZ2p7
z1H+hJ1OIl|bnVe|-T%$5k7~_3Y%T1(!=R#7%Frloj_oOOFE?dwNdq%%1XiaeF)4$y
zJ^-d|@zka5xnzpeKBMln_Z8#djrk3}12Z6Irh=Z&RZMwqbDoQ#LLl{Y?!=aSH<Rx!
zJ*x<?LkmZ{6xSApgUz3GQzf&9qrk=nCbKmgh(QL0J7x(L`;m!fM+>w?Y^WUTwY)V4
zx)2E?ro?lC3YP)+kc>R-)m+B5B}x)ntTrsE5!9#>%QpCWp#f@nL7zXqXL;m9mhNjN
zRmg`qZ2-~~Z&J0f%hk+kVSW8^O$h@9h)=D_cMn<Mw_&@o&4MX5uH&%xEEA6XE_7_9
z@is7fGPSW!T#?>()iykeao`Pb2WA(LNi9%?!~=1aVdf00GT3Fwmn!Fer=kV2^`JK=
z<RJOpTJasoKO0TUw_C}^wnQHfH0!Smp@-a(C#HKWug^3tH>Se37U$#{QqNAD@WY?1
z_;&>#t0KN<A5F=pjLKJxR&wFCA9xKIWKJMsEyS?!myS|sdHbvgK*z|PYVPLhVU<bq
zxvG9XW}E&{z!GwuM^-<*c=33=AMrjT=~M(qK;|@UYCET~W<IX^o*j5rd3z8-@q4**
z3fcG;jCe$V$A5Z=Au^0j{dJ!4Zd09ub?ghOV|17}Y~qMu_k<0Yyf>rj=tqA!D<Rk_
z7=<fJ$&v~BcsHxYTWi9M0GfGAPnMj`FRyPr(^!twGAS4}Uw(e+<AxSD=LP#g3EsiL
zD4V^DnmQL6mZhu95Xkv~;P}u)%6_DxEe>&_|7-3G?*tJ<w*s7JnsTFBZR5>-$+}r<
zicBPVYntWQ=jRr+76bTMgR(P)wCn^NpJOLB*4#$iKu}}ET7(2id^p(v%4qfQ)MqWO
zSS!S9*{JFqO`%F!_%cszQH=W73bW9!B<uEGAwfd^aCIm9Gu(9sn{ADsixn*`8&m3+
zkFLiUIuhU96J$IEzFq?8*Sv_uCfJQxV(E}y=o#Vj=(AKHGWGAX_WfTIR&csq#KNlD
zeGP(5-HdlqsVT+K?SCA$G8ShB<dbCXeBYc@a&6K_jJTjal{+yV{?UNthk&%BTZuGi
zwj&4sL&jPC<0>l0tQ~vZ`an1u08NjHHD`Y6L1tb+7XJaq*oK>WW^iV15$?6?!eZ2<
zq4N-swP!Ca&?{WF%L-Z!4a_Av$&!accr`@MNsk^^QjJr<e;7=xRq$*$zl>8LXG?do
zMRGomt5h=hPR3mN4tF9_{gs||%X1#2DsH^&hh^v~pg5*XJW?H;OVQE+LPPVwYSgc+
zt}4?swN8w<LhnCz;c)mCK$y|=-S+__y5Wn=gr3H{mofljq#jWkaP0>L2e_g>l1PF3
zx^JtJ+Vp|TaHAs5&x99&pal2PUWGmf{ZJo0xzkU9$^ID+-(4(Xk)<6d*U@L9mv<gg
zD5TuB?P!}jmmY$%1qC<sSfk4{kC#Wd(5XXN0YEh#UO@Y$%T7Fl1lqv9AO@U$U!H<w
zK$(CwGl-UmELy!GK;H5bM;Eo1{;<tkI7w*zvO%~S9?pETM@?Q0MxqF2v_!u9Siq&3
z7Ql@qf<#F1u%oso-45VMdvG<+KT?HeCsjtX1MAoXe`V;K^I#SwIDdk&hsCJ0W+)^{
z#igt$kY_O^pgp7DQEK4C=-{0d1;WItg`kc1c2Uo^p+OmG^dwEa4Jym=(TUuENYnTf
z#^@Ibr+=ScvQkVyd4<jn{n<w!#UU)MCVn>%-t%F5mQdJE9q>#Zbbs=P_8qUj^2B?n
zA+n!MJLN5xi$ujAQciDL>pMzKC3|}>CWOW7{ICLPi7X=aeb}<e@FnO6R#}Hc54K4`
z+rgh6#>^%`=Z1PZl8teK-TrvcnvI*Ev2+ezX9IU(qXp6y8n<T0pEX!Lz_8$lGKh)Z
z87x2Qs)F#GzU#I{81AIk=tbYwR=urhfSi5Eeh)XRSAJ^flk99<e9nt66E&aU!K#RE
zB-}{F9y0R4Qb%5tk7XNNuet#()(A#WY%q4Q8{uF#_4_w%WddtD6wzL*XB=)Yr9z<p
zr!v@94|<G~tM2-)q(DvH62IA`(w&bQ=P;1d9((KKq%`K%lXDHb%M0E3`}YQ6=K1}o
z*>RSwpF>l_b|1gZml^|h=T6H|cn3%!4=9S~g53Lc@HKFU<ApfIVOayZ6WoaX^>)A|
z&WbD4f}d^+yiy`(c)^<Jd0rlaqgkTs-;uM<g>xc@I>>hHQ-AXI;x84TSbOUwAM)FQ
z^N)s^TNd-Zr;R>9_O)Pc=))(y%GX<_TYwqtjhV?5k~euu2Gkvu&Sk)%=BF2k=AE7w
zrz?F?qv1|D|D@WTLX#q0Y5CIwQP|i`AjXe>!dFh+^XCL4IUBM9HpSOdM^?bGb*T6k
zclz~{{7=83^wn?TINZIn=B^l-5l)537^YYi&Nbun4lz(h72=Pe>ZKOQh3phkPqd>y
z7UZTWkU&vFQ+x&ZQuVu143l^{RCQaH93<ivHM^M(TNw7Rhozoy8@l(ftgRJ8qNdFu
z7OSei27}>2I$*HuDIZc<k#e1|{C>_v#Mm3wOj~8-7w0f!+w^&eoDIUqh_BbekYYbk
z)4VQ2zM_PgC?nz<BTOKdb4w!~e<#IG55j?8&DI><J981s4df_#Bz`Xpps$P#-tiOV
zt5dFF*VkS|&A0)_x2RaZ$x<2e#sJ;KLo}B}iR#9nWrH{n13Md-eOy!p4^9OjTFhaO
z{DCCQHf41U7f;x1%X;eIDS)Y34(~!jwv&MP{!z;&#d2L&K6<!?a2CF)_EccUH)<~C
zyRqUj@L|#4bWafBJ<3u<e-}+9<8R)GZ@8`^sn+vKP=!s#XR46|xZotNWU1W4XU2q^
zvyHfT6SR9A_6=#6HOdMDY4?Em+N}d=t-1L*I0pgagmA|-(Ifk(3VEJqZgsJ_=_F_)
zg_u`)B^C-m$@GPlLRVP_sGLYdkp-Ej+Tz618ZsEW5ni()EUurBZH`zNb{IcuoqKHJ
z9&fUI5@Q0^-z8^Z>pIS@g^5F3pm?7BA@ovbsJb#C4gkv-8e0=zS%7-xu;r474gvH@
zwjMsfRnZu6gf@>54N$WXUCXUpNok?Av#9#UVbRtP+r=z_(;MZ8LL%%#`k2^?V;$e<
zNihDVX0H-4{cs<g-Tec(QD)2kiQn=z!<xac8$&IrNJu0ER+oWK_G<X{9Rd)t6bzY*
zgwa+I$Q&AFE7LZvDu$$tf(U$!`n-vnPR*<Z$k!~ZiSB8rman9Y$5xE&+a)wmp4q!G
za6DyRSJa=4pE(M2tXy5d4<sJl##S%;m%H`qhWr4ZlJn}DNaI8|_bFY|>cNF9+<xQa
z!|9}Dh^`7iOt!~OI5xmJY0`EAowjk;4(NH*uRg>pXRO<_Xm;zw=6t{Zl&jo2Rla;M
zEp5gm?pW_eCtmWMw{SV?A;=nbV2QV@Wc#dPXU6Ii`fk^SlS`XwM6>^8a_w!HDRss9
z$-{u_^{07-jN<0~ZW-=Jj0tIzBPxp8FQe~f&5@1yN~(}IU>0`?{vecOOd(=d^Kmv!
z*1|2&^!RND0!>_1i}>Mcyuk79RE)5k*3^oyWY3Fhju|TSWmkdWAM;P(pkE%3nH=}&
zJDDEo94x7_r-FwDeqAm;*>-s(@l-)a9LpT+N2H#v8Jow0>ULGt(MhQr%CFm$luB9J
z`Z+Jxb%w2(x!((Vt>!MV-7wus37S62>lpAGKO8tRT}GadK)DOT&J%tt4oc5ej;V~-
z9$(&-lJGcgL<DE23VBA2INjS}dO(p8@|wQ6tANh%?Cxt;k)Z6vY13kkgn6@fA6;aO
zaM;b7*4GURQ~9XJ=;Tu$c%8zF9B19ou>CRvoyGdBMwfTFBD(8Npx~ApIlUpkHh2q3
z`Svv*F+(9d#)(8FH@Ek;pKQ%^erGOsW;Ep8QXTd=>k%5mZhJaD&f=_SNJaX`$j8Sv
zrIhn#Lv1z2iG3}8D?UqwOQ}4Z2(7aBzLK8DYW;r0&5(z!r<!uv__|$nd<u^61ts<-
z)caUt67Qz?xZ&G^mG$x$MJgp&qz8-W^8>O_ZjaMUX>!z>=Pm395wutCWwDUF-0@1{
zjwlcq7f%X&PNs2EX(U;mK+z4mNMgV=YkXEKO#6`P4X`37XMY?hGOXgsu6l;yOn$HQ
zlS;Ii7i0R|s+&5uIN|Ww_Sr+9&o+*-Q$wPBsZpumYSD8I8Zkd}VZtX|e>Pky1$ShG
z?d!xM00~C~5rGCN00)@^^*;eA5OxNc`wsYP2{?lg13-}f4G2e^0~HDT3;7rHKLEr4
z5olzB0`UKt>z@Gs6J!Db=WxXTnd@K0R`UM-!}Hpofq=Xv1VPJZcj%3?0=?;sn&5S;
zbS)u&5;Zg}zHSFpzMTFB-5Qmdk$~*u6NR%P=?yEHa9&SSW+b@Ko=eVHmB!=M9iNma
z2Lrhf)_BOSaW1bvDQ;pSB?hdP7D!|AHir4<Oeb}KBNJS#gwr3k*L1V$M#*$!4)8a?
zU#yf!%cs_JbnJ1hj{N=P|KHv3UjE9Fzn>RNpIlC973i2-rdw(U><ljXtIxtnkUs#T
zUo94p#Fu6BfogyDS)qVvpTTf2*R!2W*Z+GKz(lVwBKOp2P1j0^0eE0TX7ZpcW!FDK
zd0ra2G7a11N`G?wz_(<N^=dOlrJQ8zDRNpB&!jg1zMaoeE8<?O#@30Ols*4K-etY7
z<RM*PhqHsXp`G56ke|v%eRyA7-P>$3Un~R2wzaBzFHjPKrE6b25ud`^Qd!b^bdvj_
zSRI_iy7y70JNJMmq{<Pmbk$R$yC5z~q@cFsYjXA^@*!3F1YB>=qs_;chE?41(2Yo9
z^<WrCN&<LF@bmYU4{D#%!a!tT2XKPpJ24b^Y04D~N){C|6<ec=Z>s=H)4d}^Ihe`y
z!l%=6a`ZCklbOXjs%<9H6nB=S%S4Cw58F3&`&H5lP7Bltsuf{Hnn^s%7dGHD5%Q?5
zEnT>1;kM^1JVo$k#SneUZ}_lhnZ_%zTo#1bMp+NfwaF*902JrfLX@G(7YfbD<CPt3
zBFD9NmLAG0b4A^ffE?be-EO1!ZKCqRiLXYX9%4YV+WbtElD70j;~90w3j<Y>GLIiX
zm$_qx*HeWf1xiKS!-c(gVl*M(x$n$ae}R|Z-ORP@NHb?@5}|hbyiLsGx%9kocy%Av
zu-?kVp}wm_i_fL=-DTy^(9rmh2-e5O*`}^emPXOYVYC%Wd6gx&EZH@@n|bOvRHJ_e
z!;Vz9patxNbIR4`BL{pBAT91dCHH6?9C77Hs}$fXTy}6~UsEnSe%5XmtKEuJMHW(Q
zB-`g_ZZhVLS728XouEj4_|?#DlXYoxdO4N4y!xq>VfgX1CB$2yPxNug5tMDhZy~og
z^A5-`cgWlp=}kVdOJ&O_-%N?q&*JB^cD&dXZ43%xNtQ3@SNMSo|H(dwBZJSN&xsQy
zCOoHbVjlR}X)Q0tpGP?-LW0Y~Yp_snF*o%%8-cTycPg~Og(gna(p#f8-CVvQC3@xj
z7&8GSiv>`z#LfbEttF8VbfeD+cK$9Ij^8dqz0VKf`krA1$Q5iL4dKla0Y*6a?5W>_
zn(TDUR%9J4&Ye$dpGMi**zvvGjm$es|K=3t(ct8Nm};yBYJHa1zZ}H+)o9ak1x+2Y
z<m(d_&6g%FDY35mRlnE(A5MPCg==Zb)nEUTCYsC;+NgjMIzCR|fD4%`M-vzRru=ud
zEMyGtqcCJ(SDeU~UF+mJms*@qTz>n!R8|Z+mK+s)Z!2_dYx<rAVI3oj-0)HF`%_1I
z9V_m-!hA0-5BIWwq;1}}cy7-N8q1!jEP4@<sc}l>?zu*cd_+IMdPT;Dn7keg=1`6Z
zmZir{f0r{<VCr@vi3f}GLv?u0HaokY=gl>p5sTgC)AL@VT~2a|^vqr6SJub5octC~
zDGwp;%MS;ZVG?v`v{Ln~qhEYD1XD}lgx<}fX-<>?J59Y>aRg|2=LrXnQ#A^rPtO9*
zqnOT5WAZD^&TswRBO1fiMF;!4r6z7X=a1PP4iu|?8oA-8*IOqMTo`5g-ris@Q~3`o
zwjGnYk@V0qm_A)|T*3;yOC5Ls*K|+t>Onjv)yCw!_ulZ&?c@q(MopEes1u>~++aAN
zt9&Vi>7!*N@~ImEa|1~wNUqnV4dm|2(*<B+@6OjsBQP=W_U6yPz_8KI_SfDXe+$bg
z5l8NO(`)B7u81>r@=N*jG`9*<Z4^Ftj(q%^Tya`+@tI<SxYj^t&R#fS?Lt2_#E?RL
z+9CnBCyUbQIo=(;ze1yO+Zx}Olg+89c$O3O8dFaoW6D$saF|~?T{yYQ>Rj)Sv3*l^
z?|MD0-q(jtQQ-+dNnb_T(=S(FD(>X9A{QS~QDd2{$%WBVT4GOE0)^L&!TY(s(DONa
zq#t?$U%ePNHzud6r1os~JghK?rM`aCz3MDEvVF}^N#*SiQw0uRt@wG`wkS(yn#<vR
zC?q8nbIzso*|g=%+x8N^B~Vc+^%|1WP39|Gq}IyR$#(UeGdHovQ2aJrg}W=8d{{%A
ziN4K@mx$-Fp8Qa5^=_J@M=JLm<~mSdwc2<e(d{C%M99zH!j3O&{Q;=AdO7+EeE2D-
zPm$1WsPh=^@5Yt<S!}zk;Trx;lA@7de@UjuRJ3?7dA^~7e5_WnUP15?sGxYHGhxL?
zg>p^vn`%og&z*%6cfW)DqQ`LFLk~mt>_(aEqRZ}#5aK~v=2XL!xB<Is)n@GWTef<&
z3VSB{I87%<O%CuSI~xP;P%PsasZ{ML@pr~=m)}ux`oGJ%e50n}EhuE76JP}+LNv%A
zGz*ByAdKfg`LWMPo<Sp3=GCf;6)Rh?w%r|UyUOM|_f2EDz67tQDDW88D=Cgkcr&-U
zPsClHa2A~&r)ANEhzBRTu337IpLlwAf({+09pBH-_!(%4wpH1tmfE(?mlL~di5Oxl
zeP1j-bRWm`Pd7wZMCFKxdt-=8kZxLnioWbs=;5*EGwZx6oY;9)zFEfj5oIy!co4-M
zSr;-WDe!L1u)f5f&+*YvQA);to2#x@5mY6e(Cy_mz7DG1KhH5J{?hbO!=V?6Y}O*G
zvWhGlv|KNR-fN7lmP^Q6Ch4a&A33OEuEH!xr#UWijK0NYnYvd;{Lc6~SXsP-BT)S%
z>@<VkG^*}=-2HTN6CJ9bVj4E^2gS?gtT}(EL7uMcFs#co9{Wm+2U1m%pJb1#Q8<}F
zJ2u}xD%EXd*ZR2X56<JFvF|-DRg0VSn<|+`;GkQ@GK&`8-D;|@3a?$W!TGD{$T#3S
zRq%|muZlbx*;YG#y(b)R>?ef4btJuM$!?%jZ{lGiWFr?5?J~W%5<wk$DMLYplpEBe
z1ZQKUINc8?Bu%Z<M;6dwGjrGyM~ME0H<Zg!Z*Im&-}+6q!+=Cn_&5{{mHI_@4-38m
z&k}g&2}40Tcco|^P!TpJ3>DQGEvhAcDHr3QdxSdN&mTT+ffb~QZW!UC_hDTrv*`_B
z{Isd&4d~9Yq4S++B2I8IG>0FdnF8{nN^$Q%k=Lav*BJWlbK3R^&rc7cgzEle#n?r^
zFICX1Y*K20FWXiW=Yf~R@`Z(VYU$QuJOGgEDQr~yX$Ay%wRpOAs5zC|UAr?Kv-5ek
zP&%{5|0S`*jtv5J>)@C#ottuqDjWNXm=;G2`^YS?k{{V)sbTd&aqk^SUaLda!$l-S
z{3>%MoS_vSL2|+u6Y&7XMigq4^@F&-^FA|3^8*YTQAEse;IxSVND9~WU9ur9wcdEY
zZVOCyg0G35wfz)zpFBlFQC1=`IifI<uLr7wQC1JBIaJN)_eOwk9VoB_Bf=w7qu|*p
z&&f44Vh_2odlJk;^8?0#<mivE{oa;;9}_;}6Ap3efRAU!6fhk*tXRSN^EdkUY;X$2
zg?1(H0Fp?Dd!cM7XVrC_%|q<q5Q)KW&hB~ThDjR48|8Yxwxa4ZVJ@(z&++w?w`~XU
zv97KT!%V^xnwI8bjR?rLPC&P!;+;9=6lyWhAb#x^4WV!$W#Flu&$2{7M%t?Xxxp~H
zz9E)1shadh2v~oFKBvi{(H6fIX0QDfuc+Lqct{4?zrF_>FPV#lNtcc&ON!XA5agqa
zEd3dx;<~6zC&-_`#FC!&hpK{$UeaEYN{>v-CY-6Tt4Fb(1&lPJCja%Ekzv1!J=+7v
zunMtER+f{gB_27~<poC$wZ49Vw4)1Ik|JqZRZMs1Qf+5p-tF?w-QDDTQpS1D>SYW5
z(>tZf3$SLK*UeK?x$*7r;Jo$MR%`i5YGN}b|MpqX066PVNZ*}S+8C<yn-a{%(E|gi
zsmg-fx$34JNVZm|Q4U@;_F~+yH=#6dyP2Y36%!c-;+x|%2UAo7`Wo(WUFAc-a4+sv
zSG(ZHHxz@XbHkkY^jY6>B8Oi=K#`n?>!xOmkHA)m#D!V$#tG2hIiwMD17s`-7MYH)
zf5xw)wkcnj+mB4$*{1EkkY>T(L`)P8G?2#JMy>qnWntc`#pyH^>&`SRp|H*S)2Vjj
zC?!n|S3CA-sS?_R6Q4d_Fgkp6O_y1waVCrHlBjC)6c|}d@dcxV6zWI|)#ejPE2WDX
z|4u$})UsMT7SNSVh;V&h5>U63gFBnpMo6``Brl%^`E#)bElhIPlF&|0>nTO|PSU6=
ziy+47p}o?Ajj8)S1aG)W9;S$Lkbc(hP|NAPIC_5D5>M=DE#$k?9`A1t_7Wo@^i$c5
zBX+8`Rt)au=ha*M6dnTl2D+Ti%CYzN-%Fwm_Z0aIiTGfj;pF*Gzkg-VsxDpaI)9UW
z3dR{eN#ocbB$1>P+AdE{ri;g6biP6&)}~@vXZW^;`LX4{S=x)}lnL@Dut+&>B2E+m
zbc4o`l%8YZ+g6%3OG~U6qtU%dj7~u{$x~16+)O^#+xPkmzD}NMsdnYmtBR9azZWl{
zKBbpxDpu*%$OsYNwa>@X+Kk=SdG6D4&Za4Y9v2>fEF8WxX1Sh*@L(R)36MK+2fhya
zqK}|e<2!;cYuSulHzKzo!@?t9&(@&&#2Ras&zS&7#V0E-_%@R7a_n~LczT4XYX!d@
zh<X2`>&(*h^niXJr%=D(CPB^Cg@j{xVPPQL=o2J;J<s@p=nwPP$o+k)hlOtDn+{8d
zST{CkIvCm`-6o>*%Ir@wM?>Ht%<n_kGpG}MdRFlF(!o1S{SB;0*}mmfP=h|ni_SO{
z^ZF^vb&9dKd{EvGfnB9Sh^bo1m+14%rr|ceYBo8F0~>Hv9v$7;$@>FFJqimWqWdJ?
zT3z9W7ESS3Y`jYC+rozX_beMiM)8q#?yj;wwz%<}6ARs|5ZAy0E+&cA-wq;~iH{RX
za=FK}k{ai$0N;nS6NNPMgr6I2gOD8#+Kz&Iq}qm@ars2>jGy?6Ro~wZO4L$4Y<{*_
z?<Z+xROo(NYd{yQ7lw9EpBKlj%qc#PegAQk2l$rQ6X8UNO(2>LgbO~t<?>+IKU6}?
z2E`AS3xip2bpn<dKHfObPXV#>RA@a0YwiAYO(o-%g~qG)XPTTQ@ajPLfE5kxq#Dj5
zN0ld75V9{{9C{NZf7yAvor57@;%scZxjL*HJCtS=sM;bIvf<879NtwT<!)zReC!t<
zK3{H@CidF!arF|MDCn(!Nmo1!6(wKpdDd{b^Xf?*YIQj>93=x&6bz%J6odniSw+w#
zV0MKeF`9bdK0z_?|Ab?*8CG{NraLob(py_6w%!!8mHb+B-I*%-mA<4sc_ynz>EUya
zdF@u?2gsJqOlq5zxavN3>%ITzxpw3G$@Pa`idO52P+K9$d^pyTjFgjNlpZL#`n5@%
zjYN7DK?1cSOigl@wKN>mFcZL3$j*h3>A%|MEh7JZb^Hv(C`^suM(_vJMdG+bFE;g&
z<F0jl;?OmPRfv_=)9&)}DN4m<eY3Z%Iqp<XI}g<ACG+A=dWL}X6lyx4{@Lu*E|SLC
zD^S>q%O&K_Owl@Y43dc@a7@RYbfU^PSTe!G2a^yIpE2T5iRn*&btEhMOl$*nqv06M
zX;f4vBC|g<O1k%sSkp_p1<fg0a%N|UTY}87U4qANf`O&MqqCP9vY>53pBHjDMjI*+
zjq%)<W3P*9o2=b!@mQjs1x-p-{C?LGj3*=z1tS|XT#<1h_Ul{CFIy3@P;RLl7k7jN
zBPsY2jU{m3h2R@mYOLQ|J7me>{T&W@`V!hNRA-;M?1Ll|3TQJ@O1Z_AEs_H<2wY4M
z(|X}C_FSs#bg7F~!OAvWbi*QETwX|Qz1(CcKQFUvG+s0PGg=XPg6243Y7klW+kBJ}
z1dg*|N=>68T*NV0RE|56=r3X}y87AMMi4tUmSjTVtMVSQn7(lwJ2mf~kqkA0AuTpa
zA5C4X80+U{7hbdL6MpgCUD;}H+>f<bIiE4FeQtzV3An#c7~K?nd1-%LY-Q%^z3V;G
z7Uotuv!Cq`Xyan)u0#+2iX7CB2xmDdL3$)l5b%pTQxt_8z}>vdz;#EUIbMkRovgQ|
zed9bP7-fbu80`$EV3v4JANy@dyGh(|ua99`%D+MLB(M(3spoM{&x4dKHNZf$VmyDr
zU{Qw-_ZuL)CawvWPSbn%q@i0wopu@X*RTiuBe?)l``-T4OOQNyu@|*KYPJQS1f}IU
zo_025e|vL*&r7DI-F}%WNM8fr6;w{3kg{o>m?)o=m+XB{Ark{1deH0FeOPEPA$E4J
zd_Zc0qY38J+UVVBxu^7|Ouw&a_V*3sZ)Mjjr>16R&>s7wix&^{vnl3Ur~wnrL-R<h
z7soUiIhJ!~O3ZZQ$kK=A*m93kl+RP>?6ISGie$V8Mo&0iKavW9;H!{YFABWmR!tRh
zR06g8q~@XK2ykcS9d>&9xwtDcmmau=?VVL!8I))9LKFu2GxDSq%RtS6Y|wgWPU%7h
zEsWd}V3lWiG99Ga;+hD^0?rZlOjQ81lra%1j~Ox@LbpFbHNpf}_%Oz8dZ}w8u`thN
zhLa7lzsR5ow-%*K78N#3xjAY_^aoFNgmJzUUoW3Wo+xKFD0o@i%=A8-->p7i)8<A-
z7(kA`eEIJlx6+TN`1e-!?7lufj-4$1WvSLOw2NPU$uTjCFOZKmQD}walTUBM$09^+
z^LbW4#Mc3k*D*B2xOR;k2EEA)n2_yb1)(O(<`f5+*<6?$VS%_0h--P_?R$2bCfF%!
zjVeuP<y)806FR8@c2v@w7OXcU^&LMqI0Kn?r08gn*z5NGv?WQUf^~!we|nrbs*XA3
z(d6c~U$t}#<;UqvWiW&;9xG$zrcl7f#hgzyl*r8T_XS<=ziVlHp<b{#5YO-Q=gCP6
zP1K;o>fxkQ_oE+D__^3X8*L4l?{-k*w%i0y&XMVa#o|GW#omg$nIBiiC>317Zzx@m
zRS5@I269|#iBh$?#rJq9*Ya!y-y534rLf9VtNxv45_T&@eKxo&&ZC<gQ;2I;)WJaE
z5YuGe$;dQ16LwU=5v|A#M^dpcvm#hJqRKSbBN-kW(9PCrJL!hiI}rFapBYvNnC_I*
z$Cv5|m;()WMKffSNR<sc*zb1~svmK`wZ}PzhR%bHT;5WhjCsWUm|f9T-la9+I^t5&
z?U^OCS~)+8R(p%C8Q19$ieY?hH}no)%0@o{OPhnIJ(6q8US&J68mPOVdVLJ5R`>s-
zf0fhZaW-SB_i_Hbf(CH8-2h{VCF=b;)coj7G<*08sU?%=hXzid?U<nY{k>#NTHeDq
zfkxk=^u5T4d&|t1;9clD83(~9rJ7}ib(ULDgHQA!#-;5}<j!_zh^?pJW)|5H(T$SU
z2PL2eK%95)rG`<NKMvIYUV!2sArjL|#WaEl=NX$od(g8*qrYA~&W$pYDxQ}!rEGM>
z!H3FImY^XhyC<Es$%<*OAoGHCex3n{m(pJlDbpR#n~aGf#VSyO=<-q})H&IA&Ik(>
zHp;ZvS(1?58HykX#9FM$)@(&33*c<ojO$4vw8Vr|FD>|VI|@P0hjhwrWGqXf=Owy8
zWFx@@Tp@zIB7c)};#1Dp9y4~8(kdC@W<-PpnMMOW(dzMnqvw-HRazWGs=zty68g!#
zPM2l<Aj41<ziS?CS>)n`o_#bz?UW#nC^}PUY0Fe5^(Og>=u?8-Y9B9K)9;h7k&`fk
z%2BU7KFgfK{95|EkGY$@5U<XK7|!`sOm$&%UAAA`@q_z@_Zi1-=wepSV`{=7t2ZV?
zjV38ek}j3Qu@AJqU0Td;o#O4O%D8QiNRQTwjw*P?iB5C&#JdaTeYFxFyPnr|y5^-~
z^e|gl>?dJx88SaNS7sG|r&z#e7PIHux!_LNKGE0x<HdpOM<o&iAwT`c4S7BXbx&$L
zWn~}oyxyu$COcpmV~?^w%F&g#ilbwqHFjIEi+8#6g$)CIhw(b9w6tT)RuQjzNs;M-
zR43ex>n1lq?-Rxu%0CC5lJHOZa=>R3jn*L`X@p!S4$UbBnpwRss$9$Y(Hv;nSYo*t
z6?a25drFj@%Ls5XIa_;&c|th}D1BbQ-{LBKTgYR>Hqh1^UxpeQck~^mZN?FlYgDBY
ztL@g0aWYI{_RNWnlYo}x%XniJJ@u~HIJRxxo(_uCO`xI9n!I(M4n?$n=M3r>qh--J
z_4em)3!YMBnSMC~Qp+}q?HKjM6o7AigPRq9mO-;kivEZiI62C(eEBNMyp-0~Bpf;K
zcI+~ftF@XMTg9_Wnl4^J7Di?pf{+!G5S|qY`Po!2X(?m5T*f3;sb*by3z|EE<*~of
zQ<fxT(Aks^BuaZ4U<M8YmjWl48|%1hO*J0fP;<3Hixu=U4*0TXUUIIV+<aG*20fV(
zZl_Ku!JWMw_!JXI$MJ&NsD)P0%1$i9V;r<W<6W>My5_2`Bz4sV_`S+O1ULjg1+%QO
zmMPAxsHvl(qaWUR6F>4GJjEG#;Fm*O*$0d)t&<HjekX_B?<}pTFRidH3nxk5h>Z*h
z1;alpk`z4NT^M&%><tDbgEF~XiO#M1lXnx~v$`gHujLw&2J`n#T$m~c>4>|@SYWh#
zmV2}k9QpEofYW?>(pLiMzI%oTu3Le4RvsTbtIq<zdTO#?_foMKe7zg*TS-0(cz^gN
z<1?KPRA(HxvvHz1D<E^XiKuOXi;sXmRB1-|DE}dGoZ-=?tA+NFR}Y^G_!awW9ZYkt
zEu`#~?p*E#9*6<`E@!29RsVOk3U241x@ly%zu1M!84W*n^<1dc$g~woy=gu#ly3I5
zrOf5CE7toJ-&svOl|j%>vu(5ZQ)TWg$8Q-^4@?(A7V^z_Q!Olo8?4`Uxp4AnRxdRP
z?wAbryRN6e9P{k`tLCUh6_E~Jvt5edG2!Ycwmz-l;3KIOZ;t)EXo~@m2bvxyRuiue
z_I#PRX@@Q-r*CU9Nf3496i~3oG`)*B*`PZvC?FW7Ye<ZM)~*b{Ggm5-h<S@FmhI{X
z9YNSveMXQU8V#{r9ey5Eg-7Sw`Kp%pefo4ytV8q((arpYR1|t<_||>3@RfK?7+Grv
z5s%{4xHmrJh?lF2c5^KdCB%;5sgj01%ko4!E^?S(eI%BUUN*QInT1gLUgUBy=<Z2n
zFa0_;N3!qDK;)w9L|}!}hHpLyh%;<P0&RZ~OD=kiX(SDUAU3HDaKCeF09pw`Up-qh
zr^9FC_xfIQf%`;irn;3@kJ$NnwtsERH0QYSU-rIiv3#U{ZJaxnpMrSq!7kqhT8XBV
z#^+?hDlUawUGPR)3LYOzNFV-Ge!)OB=%+A4$TK+~dg)SXS=#LOdh(r-7(@mWH6tV_
z=_5a}W`mv$NhoOSK2-$Kja0JBu@maZn!;Z>M>0nmTH+OrxbfBvIQmIETM#Sq0QRfP
zBvucKVEQ#eT)%C;B-<=f?=x5vYi|M97RPzmkw9sUOmVr$Hqj^1Wr8mmqg48)^6tlm
zqWe!@R&b(Woq<WxVjB&Cc?t)!Hs+ITa5~-Bl9AVBQ01EVVL?g_ys%V6o?&l35lrNY
zb>qCjRX6DBOQBDRCK><Ot4OL89B+P*yhg^eWCMqlhqYZxa{j5)S<A_+Mc6<-E47rP
zApt1#dg^M3FnFP<n6~<;%sVm;inamE8>m@sKe7?TkQ)9b`Vt!jXTkOOWETRm#kR~E
z=}_9_k)P4q&A+BybrLZOr8P<?;zC`ZYxBvH?EYj@Tv$phV4%~nDc#D4#RmHJbZAC=
z_ul_5O98>_XC6<a!!!PhZetEQ@*+!ATw>Dg&-Xh}D?l6gAZzq@WEhT+K;X;sd|t&n
zWW{nNOinJQR8D(FpjQnxPrf@h!_dUpbivQ#e&6nY0e?V%zyJ7f`^!=<B$Y*4*k!{Y
z)fGl)>Pg&60)8FVb(`qX<ZOt_v^0RFwoEQb#r}iQUTXJOOxkI<ZfVXbiY>`%@aRDY
z`dra>%GTwOd2}pr3j^W&WB&*ZEl$s}J<xOwuCrM+7#pqB-k~?Hs5BSf^#{zRT_lxX
zYeScyW1)jyR9&p}O4SAD%hu%_^v_zQ${wA{&ben1abQEkP2^}{XZm@+nJU(AxCtjw
zD;HNcg0i!U>o$kys{uRe%`A@7U~QrtiBYDnA(&ZONXnE(hjC(Dk*)EqZIu9OXg(y%
zE3*|l=N>&6ZWpTK0pgo{GHa)%*=lqj6rIgWgO{cyzQRXL-qET(5;kI^hbZ>ZgU|>`
z>c;{k+_5y;Pehs=#`+yfEuD8*7{z?rM+=j?lWtYsLg+%#t)GAn;R12UwQiP=GOLv)
z(U(WubXYNOEv7^&TODjagY>25zNd=J7TT;yjNMvHw}^o`y)FcEKC_!Pjch-`l1C<%
zy?olP#_I0H!z6I;qDP(|HII<n5|~?+d|!=u{48hINZ<v;SpSS6B5z4>DUDwZdQo~@
zM4Nwqv;XgnW6$ZiqL->Jr*E%)sBQiA#fvw;H*Z5KeSJDsL|+K{D&3xjg_uJXvzDMJ
zj@Y)drGAfQAEfeNkJnZSptH&V{8Q8Krts%}@8Db>RT1gPQN%*rGiWp#9A-dHSjkn;
z*V_eVUCj4*2D-`WDr$O6EbPZZPBN~+3xv633}Xz!=NKvgNW|=X%AdW*iqV+$!nz0@
zqI0QC?)6^rYI*TyNG_EZOQ0VumXhmdpesI0fGVQ0p#}Hp&#_H1dve@nzs2Kji>y$Q
zx|13#&Dq(+b2S%W9-0GfH_ncP8=L!Ds7QQXuNr_e?<R>#X<umD7U!h<S(8Go^=rh#
zi~(P=F1#Tf6IEF>hqvHaHrm~DtX^t}FzZsYVHV{Fi9K5wBJXl@fx?mdA{sQ9DyR*t
zy&`G1Eg}8KC{awBJh%dktGAq@OehHtft|ikbSt^y(Fd%WQa_>A6Cf~EOuZR!GWyXT
zGgZ~Tm>O<J$l(cygs44UWqs6Yj4S{EAOJ~3K~$IrZ<-rv84+8oX#;rsWPp{tTAa6l
zgf+KJx3A}0LAD98h1ZOim5VMX&A9|@Op9WM)g)GPOwkW5YJ*Z|h?LrNaigDny>&r+
zr~Bppe@<)Pot}I2lMiqIb?t}dcdt*tyg*R($}jeR{_tV!ujtE;iDo+2TmUk}MQI{c
z+cxFjWo?ESeH-6vn@VYKq@Ptal~DtUZSQFHc;06kLEhU_wUxDdnMQ4A`X<soP1Un|
zb8Pw@7tJnX{!t@<vOJg4Fzce-iW{1cYp1!bIeSoly>rchXZ*8l4+G!wrzbF~K6v2q
zc>c%U)%>)PWO2LNDt8g^7{?^jI30^cgq9u6!3hdM4Y81WWF;LkQk3O0J0lxxXR#Zb
zu|rtIfLJn!WE{kG4|CxVB=&~1gChQc+;iiyS1z-=+Up*+s;j^J1%}|+WaSD{Y<G8c
zef;XxtE%^VZ?hF3pmBpyxJ%rI8qm{n><Vr0p}f3psov<EyvWci3u0!W3edk3`{!dG
zhcY`&Rso&yVk8oJ9p*Fg4qg@x%0Y)GQNU6Trc-$$mW8YMhG1bC>a3(*slVt@iv2^=
za%u`ohgR7W@f2>qkO%SI;Z?D?>hF=aNIT&yVs_k6?nPO78NzMZi-3JLlUAuN_hmfd
z(ekEPoC{3l*2!6`^J+*@Y=ucY5d3qVNF=u&zPu`TKxmKWit=}(;zpRPik8Gk#3Lth
zC!yuMe1!nry)L)tXMYI4RiGsB(E@J7;A%UgvQ9fvilcac^~s%SEUAX_xbt%9`PsOS
z99+N6-HIr3k|&(Q<w8PnBt&vDj(mk&Zgv5V-p@HAk<^sk+_?bK3vtfQBBoVNg|Q?>
z3$Hh)S;Qx0F_(4ErEvLJ^z0{jk^e}b{|wQCzrOkRugAf6A8dQ?g1`Lp&A%K)40M_j
z|G56<%}p%vkN1Pgb1)6@O2{`F;PeN9Q}9>Vr~|v;?}Vy7JMfLFAJLiWfEb_PW~!Br
z7|cq7@8alK)};tUTtM&{%LhSnnNtGemI9r6iB#JW;FSC>vQc8(1Mwp~G)~*pN*J>u
z&zDo;$Z@4K8sMw90kH-)#-cMIIe~g22ka7UP-^_g@tj#EJ|MY4UG0lYD!4hMoeA=O
zsS~doCYDu_hf9*oB0=6S_&EJJe96vev{s&Bh_1=|{ci45#|C8L<v4~~TU?A$JeKI-
z&flW{Ieu?blu&R#LV#|I?Dpw4>c2dldGPgvnWx8l!Q?sKN(uGI+T-P>ITkK8Vs%dN
z*-VW!Ml@TcT{QO=4WWps)iWnyOU?8ul~h}+qxqw?rmB@YDk*jqVoObj0;Tuso;oy-
z2U=On?y9$;k>SULA`sH!q`P;Pq46HG4Xodg#viBSgO)}=KtH`lFO&s^h>wKC^ReS2
zM^GU|qP^Xx4}Lw0*luY!5ABBb-n|QX-rH=!<T+k#)KA9-tRTg!2S<Q*GomgfPT?F^
z>13qi993Rw7;g+&2%Xv(H9-kr38taudZ1R(%sSKrx;CO~uz0M4+ys?s+Nz<nWY9xY
zRW6)l++ld`VX!WJ|K^=Z)pDJ>3^6+!T7XWknWxFLj;Fi-(9NbUuH)2quRHdYP{^j(
zJiCc~W!H1Oe-w!r9x#sf-q{j+iV}?U0CX;~SL<7?k<6ZL!eS6>h0AY75d(FX(%P{G
ziLJ7?OR_s#MXJ{un$v2<(5ZixLsejh_<Z*(tV%O=cQ1v%kyV}0yg)u5{);7ubBjnQ
z;n=<P{>V1w`S2l8)PcVLJ``~T4}(D^(gV+>y0E3wHLF<>mWwuMOmSzepeiM*J9(h<
zHUrs4iFBhbnwd}KBx7iB)UT7JX@J#{5M+S)t-6~tHN#r!ZArWFQ2zk{%?jU4R-q42
zeX>gT7egl|@@)9+lp7#jkuf*iEUF9C^%W~{0UdSq3&)G<DO|J-hZ1x|us{!m5;h0c
zR*r)BKb<e_*$o{Am5{Q(-*W)Zqq?Aq4y@WmTHk7#<C#^L8gys~8>YFS5^b|waVq-^
zO$T>Y#oemZu{HJgQh`vr2}<-J)oYq=P-^f%p+$A6Uq?r}w1SkCK|P2unl5J5w_w?{
zWKqg33e>4UKl{9Xs*X-J;%p%d@%>OFv=>xtSW6-6QUmC=T@PW}DMz6sL_eQH=G6i8
z()mrt%~{`a_G=%jp<DJ);0cNoL{$boM5S|GnR0<p^~G;pLQqr1^%9o6$t)A9*AbSM
z4>F$8_6#^wDxPa@rdZws*)jvU6CSuopp&U6W>Y+SdwZc^Xg{=z<+>+mqrMlL-gKMk
z|0p%xMmJLv=uMzEQxoXT)J#pFH&Zh;f!<8b)CBseN!y&&f|a0C?kputz(xgo&~vWC
zmgCb)l?T|?Eq|Ke2{l8SF^&F33n7E_U^<qwYqn~aHOwOEa|b$MMX~^%7Ci>iI1t*#
zEmB=7H>MVl9?wFA8h1q1=oU3M_0=ds)E>*I3!pz#eVj(b(IY#l$5K!wBtR`-j&TG_
zJU&z$$dbcV02__;&k*RW)(=oUo;&egpqV#OoCCH|5?ze|LkHgfBy`h9Pe&G@L*k1E
zsLg8zuOaBH1xDiSPj%x#fevWIHr;qq{b(2<GoVs<BO3Rr3G@p2<7|0x8K7`H>p$84
zX7cTpL~%!E()P71i%??>Ul@j%m7t|~lK%`PIv)R%@s&~ii|S;DW0u!m2&T?4zmu&Q
z1&s;x>}<Ihs<=5<w&H6$IQ`TisHT&nEAb)S9EQeHEANBkR+0m#3G@n}-}Xf3c$goU
z**@7UDf?=;1L;6##DPAZg^h_H2CvA(QSPmWKRRoLh5MvMI-4DS-f9|r?abH_T)H=$
zHl#0~8GgV+P{Y(F**83}Lk%3@l}FL&!)SCMI{fJSn2U$Z(#XTBhD1mH%xhm+E-*6u
zjT<()j-TVM%g{@2KhMUl^|haTU-qVVo+29qotFphu%JPD#k@C~$BNO|^{;vOTSf@F
zpv19D-jNm^jIO8GzxA=~(jUBohR(ssHzsOAh|fInK7RFs3Um;TUc2VKj{h#T-SuYh
zZ%f~H$93@n!{4-}rpts4GuAfaf}knU%k^&L-%7RcFy<ZEK3R3iK5A<RNL!C`#k=>)
zOl2=FrN4TZ#|wtB?&ksK^V3{#iIZ(3ExJVK@7<WdN=wgQyxWGB0g{<QXD!ub;rDF=
z!+%QCZI*D<n+V?y4-KVrH?MW$8MSr7dsU~~p`oYVqEJ4ozPvQ!{ET#TvUbro9#s2k
ztS-1E!A=brfkrnu_<~f4;SlE!FmwfjAm}CJPKl>`79^;PQwWe~C%hoI)o`{X@`qcH
z>}o7O$Z$B5Slh^;VW5itx%>hlYSQm~K(K>s)Z3x1hg_1>$>knnpmR8LCgA7U-UGz@
z1*uarDFmH_?ns}7xY)!4m0=@K-p|<u$<1h%seHii<Dp4MgRPey#(0Rvu040+BKxTw
zelI+5NrIn2y}dfAPi+`246fQ9ybr%hy?Y!TFn&pJj*k=OI9{|dKGGog1I{tP>xQzO
z0ZDRcmi-)yn~hWfGAdb<?z@73AUWaqI6|g<EObgzz(w?6KxkzMzo=8ExZ$R99%OIy
z=|G2_BW)9SZPWApjcs73#8yPT>;gjj)Y}Q_3_`Fqd{Z3mwoz}D;pk)48w-T)+!JpB
zftCrcA<<E|uT30P1IR!(&WY{-|9InTf)dE77Qo~1cevLXEzT+~uY|Dxar=B4Kqo6_
z-&)s{oj4EWrt$?0<;!!aTyFE~G;uc2pI;<pKWOh-vqNq!mX6DEY?1_&#D8D#ORHio
zx1J_cx}id0dTX{QZ!EwsH*&?zI1g}dJF^?9oS5oL<NMt!>m3{$yVSR>1@Oh0O!m*p
zIXN@uC%anQ;A=Uzxf37mZpT-Jos1}El99*v8022bx6a98;m?rkSQih))ubK2A4qTU
z`(?HC2yCyX#N6uKw8l0dp!BWax93t_?PP=nRyIUYUR@JtcpCgf{IKn-KW?=1W0#(%
z3pk^~JQ)QC&!#fDLpk>4!GY>N2@m#XQ(ar?5E{%EoEVZT8@SM~7bTp>56nWpEFNb5
z?(fC<F6OiUW$o&I(pcJfm^oP(hvC?lX*ml!Ydjmb#<L-$N`MUl*;qsPP!r=vsfsLU
zsbCQiswLKMjM~Qbf*WtWIR63{{bSCb^3I~Z$$4*EZZ|CR%>15bo_U7n_gg7PkI#08
zzqrHoden4U_ykME<4iPK3BTYLyHc029d6l88<fJCujTVnze<wW%lxQU4t%|*7G3V7
ziP|<F)poHYAUN8*e{r9w*SAl{tVMHKGhaD6CBdg0eYa_l+3owKkp^k6T-EEx_f|i%
z)AaDyKhD#UuV3~859W_WX>fA2kUQ%a!+7dq@oQO;?Wlq42n|?FI*%xEmuE@(xCk9E
z;VDPImTNJKVRqR9IvA{-@4e%zS4x$CM6ZhLy&eLSW_$g-&TXrTZ+`NS|LcGbVCe&i
zyR8b|;g&QldfzST3MFdt>vJfuq%_A@R(Lr~wn~CG<WH{=$^Y!3m$C<k<G4UcA(-+y
zcpO$PW{FDi>iw#O3Awvs04?3*6+$qP_<D%3W!$ts0v+`QlY#RjB3Vi+3twLYAbQf4
zBuZmLqx=`vD+a|9iRU9T48@j}bQY8R!JqprKYw2!Zu$f?df6bVtork*F$BJB5Gr9w
z-+cRc{Q<zz<+VyIKI)CO;IK8X6<Jbo{$~AA>DU{j7L}}NUzWP91wL}x`OXa+Er$Y_
zV!U_&9sC%_Ao@Hsh0|Wk=;5Sl1GezBpQ?mjUycF*cNVn(E#Ph?#-Dfec!&^s6jt(E
zS)TANq<8ps`NxMWe;-xV4+#KbUFjqwVOg5-{G}60{Np|zP*ytF`dnuYpR|7wYj0(#
zB&)=@Dk0!D?!K)_GRA97A2+QQvL>f79hi9n`d*UoL8T|#U1>2yC?<^?9y%(K8Hkpi
z=BYVo35Z$N^B8m%!qHI=)o(0cgoz}suzuTz(9V<p1A2{EiZUT6j?5)7QHlP+N_aYW
z+U~I5=;WFkS)GayS|G;wgvApUNzbV&l?v&}-cQzTe;v>{np2wpz;g7{Yq<z^L)72#
zcv@H+Pe9k5{LRjtyvKoli0pYx=i_UwQa>2;aBl>zE1rs0SlbuSQ4&kD<>8PjH~cMg
z(~$KE#8PXY;^zHc%P+4o!2-JL5$Jv4bF?%~wck?v8G|PO7Ev{h=cBc91FQ78;7uiQ
zvgx_tt3LyU#Dyd)!CX3VpC^T@;(3}H_l&I=cr|sqZIHMVO~h$qd%qb{^>gspo&&;N
zoHL8zX+K>Q#euxKv3GwNqIWBgyhw0=D&TLOSK&DK>)`p`8eOO}!0Hj2Gd&qY&VTQ-
zXF~+nr*PbACKOEFKL)Bfxn<s(Gqk$`Q6g8+$33Z;Kz7?FfX+Ns^11BWCdX&+xH(PL
z%_WFVh&GqnzcGluEuzD&jFYdLTM=R?xtmIt;vFD5(+ZyQG}Bb8_itt_EXFRd^4EUx
z${@xO5YD*Y==CrkT)c{e-8Fg__0;EO8hjEKd2S}DUb$UrHzce_!&91HcOzI?2r(Xm
zaLbw}92!94L#>?q(QP1EgrmB$TI%m8NyUmxA_A@}y<q+u=pW0P6x{XzcaW%ap4uv2
zIQb}`i^#Nn@OYLccNlcfDW6VKsnv+G>O$hVCeiNY@U&Ez6NR5U{roDR_Z2LjrSU5}
zLaws3mJp)SLS<BBu{v2uF<;WZ<${94Wd;^Y0t?B;_C&1okkg}5gXRa`gZGnJnLj)-
zaI)(14mAAg<~s9jYxoN)U10qWCa~C?q`d|l=qdIDbSqheMP1n(64~Ib7KuVvMx*<7
zU@LYd`8#rN(fk>MhkRv25WQU{l36MxUR(t9fkDwVxk&EpUXyM-w~4L;#b1L?b;09;
zVk|37vxoa75WAq+690Ag#yqyc+er4E2)w6B^~NqdFph~%%5!vpma*EIVBW;6+=>a+
z*+9r`heM|kt-~JD`QF$R4)!}RO+#CP`*?PQiEPJEO&_ZVX7^qL7@MN`BLt=}?j%aP
zAf=MIgxBKf+}K6WvUGJ+1g>2i>3HG9otmu;im|k;1>MYbpetqQt4p-#`~AJUL+8&>
zKP7jtodsGR6@{@|gN7M;o5b-IpXj^9{uD!ea&B$F{*T4){B-Udi%a<-2HFi-AF;Es
zazx!{tQ?6W+qtyi?9Y>ug3OYju#i2prEIxBf3DC*(aIwEVYF=Xdf}kEt`jBkZ=j23
zL8<<hp(s@|B@wP?aO9Gq3(^|A$<o;bkCs;&t-OY;^h3j^keLg3al*?I-)M3W{#+g5
zR{_0W9kNZy$qDYaizH*Sb?L>SW%;uidJ;o-@`;!4-!J#*RteeTpK?QvhYAQk9h%B~
zt=D_=vbQ&%`y#Znkz)oO;)b-40MK!8_bG)+X6}-2{XjGg$;R^!8n!(Fy?-X!nIbPN
zI$L->pK-icmA9;lIqFDC6`dN&J&$XSkJHkO0Au6oYK$Rv(8ZVH%N_v5HL~J8=g}De
z$KX-*wcw;`)W%1;(k{WrEA7Mc_+J0d9>bb8<W0>-EJ<FUb7Wn3AOjHKcWgAdc^8q;
zB!tKt_P0uKJWv?vz5LvJ^GeQr<X>l?_xsXsa@=m+$(Xw06ZbWLjXAt_XM0o__2cnB
z-+cbP_g&XaJG`J4Ewvz|KIIR1d|-d$jqk$l=In@I-MTE&IhPPK)VQUEory>XmdstA
zo*-vX{m)<z_IlOpK&4+x6&M&e`Bt@deeUE<=Ge_jS2l+zJkKdLII7_jE6;e}3H(pz
zTM##7OKiQ}RWcU!;Y63D9RFqR+IkY%vT&#}8>+XPM%k!^Rgj)amjp@0v=A=Qf{=z(
z<eHcQS_N;=?GYSp5tK2E;-!r`Mt$(bhk5Z~{(?W}{FK?dXzl6qFfZpkG#C?+x~=`~
zwbr+4*ZSD4a8wlc@Z(e8PByXsTq@bd4)NA+6TjIdJWMI2`aqLB=u#j_r!Fl&1D*3H
zT{CXR+7#|o8jS5(sXPKoxV)yw(FB=0r{$^O#Pc(lSP3d^i}P5KcByP|D5Ed_$;$9w
zR(0V-z=F97Ug!AHNMwoc`h3@fs`Hldy0jUy=A=7HQ9hlae3i2<&)<oL)U2`iVMED<
z?uTXv_xEt7#q9WmB?4KoELUvgpZjqsBr*(RP5A9^S}8^M5TMJg7mv;v44>ur@s*L?
zqjW?c291<-La7pa5(zt;2lGwZ(H@8&geXVnNSfr~?CAW|*-&G);n-`U3;s4Dqju=N
zY9(_|%_wl8{zY}O>}%&80IVuGdMF@B<76TVFu2xOq|M%0zW?O&J&e2~e|-~Zos8k;
zh({OmQ>#1ojmG`%&D6q9zvS{MF%1LsmO0nb!XB`s2{3vw*fsHhiTy)4Z#0G+j+310
zYl17`l!v8_7o~umZu=hBhNz&Ctr$C9+KMZL@N{#&I?abJeZDbbOLNebcOESZpLchM
z8jjzCsL(HB7>&H#E9!1%<^hMCU_^U-qAAx{N@|Ix@L`=IcH#(S4_|<8$_ha@U=N$<
z4W&@A3fvZ%x)S8f9sRqV7(;Kq-;}407Y>TWqCY64X33ni`=Fxex=)H^9_l9c4?wrq
zgmi+bhV>0Ylf!h4$}0CwLQs+p>6#cviUil$`^N0y6~6L<HD5GAVRDdzUcmhlsf*EI
z1;pAo$$B?X+s=)l$exkMnJ>`Qt~oB}sT26L2g_YfT$Uz5e*pz0>K}AM<{+l3ESWua
zN0S{?BswXiSPHzRE5rfYo8y9p1VT3zFIX%I2GFzj{l;tLt*#GeeT3+^!Z)CEg_aCp
zEopexdLb;^jVjt_CCW4Y5?&+I$GoizB%h{K5u;<y|5+mxPgve+m^sjDQbo?p&5`G|
zjhL;mRnVY<G0u26&!r{_5H~m8(>fbVA6W(sm{}tZxFjd(+yryD*7X*k<bs65LKnR1
z7)2NEIq`QnXcS1-A`!Bujkq8PQf}jm7tG3p8OttuM)Hh@9YAFh33glyCsn|G0*5fw
zumI1=O(5c$l3b`~1>Fa{O<ndSe(=yP@L4$z{zJ}P#&`-L0hbN+92zs#gW;%5Rbe18
zTTFYrB_V=4P04fY3CyiimNc;hU&*M&n!?K@DcfnnL3%O%2e=KyOFc@`o}0d%jt5P2
z;ZQ#t%MothPSuhS2^UVr5{tv=*Yr$!<GQ1=+`oSYI-}Nv84oumQ>im5Y(0mY_uM(e
zgb~+mw78Qc#;1Zj2(B)8`3pTdPDkM&9(Mo9=iL7~k8Z@t^t@t^MdfQ77nAg3V*#A`
z0xvkMaWXb^gs*ApA}+|&KbCchJ*b!O^7&2j{`SQ0Xoyz7#iU%I+p8560@i~j#E*e;
zDWxl3)?cC{wuUIs`-Se2a{>E;wY!ope8WFg;H^QFo;2a!bPXSO87d<)iLyM&(czhy
zW1VXXOyxH>^YpdOfNJYJMM5r&c1Ske`B+|7rm(N>CODzG(5BI*fGXtZfmJ;LnCjfe
zWD}83w#_dlX+VttoheNv&4xG<ZmY$%AkZtKKf{A0+EEAS{)nQ6mhiDYKMuGRvZu-_
zf{)wIjw}VqxfFWj>vJ|{8n&&p6d!`^5zg{F@gAjS8E+aveL1x`U0J;|bN*boMf0Xh
zDK|c0v4{bf=SQ`vz@2ejcbjQS^9`5W69i(Me6O<Fa#~`U+%4rErzvTUe?nTwXz;Rx
zU(1UYXFyn>sY?YJ_bJpzv`unnJqUQN+A0}#TIh%ztqTK&d4gy@qx*DU1`;|!j;6_V
z@qZdR5TK*iB><L@8l3Tfm>k}qLMN;k!pjbD4#R<<946k0J6b?Na{h+lK3Lha`JkI7
zkL&Spf&<(y19T32so=ex`Ku+C^DD&3Q9Ik}IJIxCpq_~m)@iw50Da&`qZ^WCYK>~Q
zTCH{$t2UAN;avmhu>2k9EpE1rD(Tz7nD^MHxGjt4Lda=&bYmSj0Q{wn3Tr#3E7hES
z!!HHpbt6+a%3z1MCs*uL1Av`b4N#z?3lkOL@yWNIYIUVr^>@bsYjuu0MmGv!I9%me
zw=>qc9?)=bu-`!q+}BX^a=j6=rF|rxux8PA`c&`5F~wm2HH5WyfMrXtO@VF+5ul5k
zlB5=^E8S{QU9keAXaEu)aez8^esW&1ag0^8j{RQ$78h#jK8jpY3y>39^fK(Z^hcoA
z9PB|DrY<_W{<p+=n=OkE(jEo+h8+J6^q#o1j6+ppH~wysrLsB<5L>cDjI&?eFVmG1
zF)eq?ya4?@&K(%RW(NfZUq*!N>561veV|(`Y6XsRY<)h;v%u=K8FmsTtDKR!uy4ya
zS8wg@t+m#YIMd<Tm?r!mpsOkL)x#|6zAY-F!J5us_7t4s;Nd|N1ysNcrBHgMyV4~u
zf01R+lwg9E8xAPYxnJhaDEZ}0;$RP-6Q<$S<Vh-h#*fv6fiBaQHf>b?Bq;yv(J4&N
z!jTXyG>Y#F13S!@xNC^|`Ld9F@#x~ZhOYni{QOVvv=mN|)P;OxIYZgm{sRx3JE=%9
zs>$OB>z~0`Ti#@8F)!`I4*n#rtkbftn#WnL4|Fp8w;A}(xN~zj**h`4E3|B6MxLGv
zJ@s~T+W!pLl{44Xzi9cJob*A2M39MzXIoEF66W>7b&&;P>;uV(UdGcQYc2NGqZ6Rl
z7TIqK$#H482^GE$eP6TcOox|=D`Up<a@cFS-8?IT310mmT-irtWni4jmW`C|woQbe
zC0~H9S}4#V@#sAq*&$oMbt_YO6D5fu8a{q_^gHG-i>7Ibn~e?U|I6If^t7#|VRDR4
ze8xDXiJ9WWc64jijffQ?h-DlBj-r52LQ<qCfl2sCN|I6tPyz`Ml%bSTL_5{JEV{Xi
zyJ2w`UCg43iK@GppE5sX&T&ehw6K_~k&1*An{YlKzkc5He!V0|J$Up3-K=&1TF+Yt
z*}{m3!jTWlmlB-{%7OQGBKX&ZjzouIoXvXB70`cWHW9z3>b&h;rslEMi6uKs&e7p{
zqEPR(SOvA5X5M3I{jEg5#?f<DZBqA?a8e}C*Z3rhKfDnp?Y6TJ_l6St>yk+kSN4fN
zGNU$tCHertNSnI+7!tj0U4b=&!J-^1hrq8ycHFevwq`Id?bH!DqefsS)UYJF-2G+l
z<b?4!&Bo6$sEbRo{)l>!VEQbeE0;jufqMxiMz!wUd+>o%?K~#h80bG?W%Nsus@W35
zVr2#TGJ({4%H~&OqGFxv9NPzXGZH50P<%R-(jlFjlTIBN_tiSLSiu4*Kcq;NffG)v
zVr4oXWlqBHl+fPaTcEWwxc!fI>;ZTXVU~&W!e)d`4-CBIK8*3CRvM>=FZVMTQBUzV
z=NJp<ASRS@Xj#RA8Ue8TtE7biMOY95D~2*g+yfW6P`-Dai5xs{wY;O8>2fS^A4c3r
zbiZSa*CIvO{?|Y+or^O<Vyx9_J&&@3zqny=k&CsdOQb_xf+uofnTEV=I>FQcPqJ$9
z-XpetPPIV3OgK6s61@X-_oT2*XkInVB@a4ox@9iwB@&(KP#3In227A2X0@^QIvtH8
zt5z%=4HRltnOGX^F0fC=XxE)UFP7OYEdI9Gsh@fg?S85#XLiidCv7mSaq0-PIc0`;
z5KvDO#+(RF4V@Id#6S=HDAWbE6aIm}PRWK=!4JFRAi${8)!i9`srLcuwJaxNhck*I
ztQKh^(W%aRfWKGfSaY*~e^C)mZ17Qpu_XE=a|!es*v}T!<%h171k1`rh&lR*2rx&#
zZ+VFT;C?Re>WKgVAOJ~3K~xh^>c`%Bjcuf(6ztIh>e=z0X)tURxKC9hvcJ2QY6NsZ
zIQly~sm*hm7SvPMUsh#dK@=Y_g8s9w=Z(Ux^@b&GYQ+_v4sl5rY`ae%zGV{oHrLry
zfl<f7s}L93309++=j1P!#G8<|{V(_vuKti<Z-lMqkUP%F$&2vbTSl3-!VU1#&yPe{
zV`qLV!8X)h@O!E-6>C<v4551#^aX^}bYJzvkV<_B9x)~NO^J?H1g_LmtW07pcXa}d
zZ*w&=x)ovS66h4zTWo}e!sl}`tNMuV0^*T<jZ>mw?|exva8KP9bs@7NK*zA><R>p(
zv6Lcrd|eP2ZKO)ICIPxtB!O^r{w$S+VvG@%$T|t!+C=+2DyTDRkZPOF>}Oo6Mvo_$
zGx1t(E@B_;0G-AUbzr83&ZjtLt9pEdCscuO7{9(C+)oR7KYySr@@l18#ya;o5(!5q
zd$1RgedxzHb?FqF9c~DI4=J!CZiX01=A?l6$_?<g5Yu>iN)<9i+OZ@@FR2RvsP*t9
z&9aKzNSOT;I#h*<#nFWhN2fgRQ>=koON9#ZCdv&Hpw~F9kB9AifX}e5%1Kf>k&sH`
z6s$er1Wrk(SoS`JCT5I=%CJUgP=j!MIDk1iemJ~asvxB#AuzRzby<H};22p6933OD
z8Bz+|pxjv6Z-<9LG=O_oB)MRO3XKco-Ac=(z6q1;>A0TfwiSV0vA3xULL*YW$-{A7
zU>QM@RNY1*8LZZtnN$GdR1GP{1mzhuB%?9N$$EuG?i&7!pm0KV6HuVrn6%#j`hBc^
zs+>G11rn)1vIpicrz0S^lITYOv)XM&ZZHg^?pp`1M3?T_7Ptn-q*QfK3!-r1!v%4I
z>yHOwZba8qL13hi%9$Ny6s(1WhWV%s^bSW)Cq+>769)%bF*3(iPCA5^BkUYyxk=#B
z9xh3`{d*F9?+WPag+fXdd8}Ouf+VE$J={*Wu;AbUIuQa<54u>C8!3S^615gWrvcML
z*y-|<{~t&9``f=={w}}MX#xH2KxEK%(AyV6o5bgV24HMBtLxfmzh$Tocbj_FtW=Yu
z6SO!Je|Z(pg6_2(o0^{0wRIa7hn0*O#yyE;ZHqKn%$W07i+inQb#rDuH*Bt;;+lEE
z)33B{7iGmr<7cH>(sez#mY>%$eVAAu)O9_(H9wgQ;}JPVw54qFv{o+zI)9dY;I_<}
z;$d8WtDDpK9ZVzNYt3BJwX+=Y(0j3v#UnjAZ#(D_eboCjiEphw3;vQ^0kmf%jt6VL
zcad3snMF@sH_vSA+IwOwK!-^`5kQU|Gn>`pF&<ejJV?wt#SJ~1jmOSc>mE{g6c0PA
zm0egY&{WSGd|^hbq`@_Fi<C!ve35h(3DC!q&VB@fQGH1_|H$o{3;WQwV3KmKbS%DL
zCqN%guH!ELR#{jwv%2#be988UD84dBdN~{aS*wr3U_JB5I{%1j|G~qz&u8$;tsIo1
zyPcinN6qBqi~E_Rbt|7qVr8YKMQO55aciBz?O<t$cH+r{7PQhbQgn0L)NHwhc#NX2
zjF^x6j*{~opu^m#uE)KIx*x@BsF!yMyI<4F#F*&Q%;+vet|Po^=F!1pEF2z`<}5GE
z`AppNCxXL%`;Ay|hBo|8jA-X)Kf$%ri9b5KK7Rg;;qBZgZ*=*GqRt_w^I7Xo*LbYm
zx1IUQj6QyO;K_TNMaN|xSl)v#=v(YtNSw|2#9IqGV6@qqMGtlR>x=gmeU7UmOKKuG
z+i4Cu@=Y)G%^OIZ4HoU4ulRy__oYc-qL{Z`%j=K%XK%51<(&%MzGmKby=XV?P;~R?
zruz@F6`Qj+I)?UU)7IgvBJQ?xB~ApJx0hQXD@P3keQj&a9X~!iRzP1brXfx=XC3hS
zc~J2Xn#3q`t$GK(=N7*|4m|a%b^2dInMm0h%P*N9XcleYyPG`_{ARoUq{IC`;lI)A
z^2g84PoF<I|Al4u5CM1BCsOGJf8OZo8rtak*!3|wG~|B-?yNIP4)E}9i_a42@>R&P
z6=eHW?(^FMZ12ot+|K3=?kGpnNgUg0?dy^<@a}3DU;o36Ix3gu(Q9R7zGMu)o;Lbh
zUFo}XBGv|YBTsqf3PN<7%5|0h*&5B={&ipFW^OMGxMhLcl_~zq-qpl3vF-6;raAOD
zwvSiliiHluN2m?c5K|;bBhZjuLn<H%0YL?nkG4@P-*AQS5P_Pjm+`tVY2Jbj3nwiJ
z$!!8=;(~4W<lQtZ*pZZlV88@F;(asI&w;jp@M65o**LY#oave0`JMmy&pE%J*svpb
zi-{f+IL4$9M8)I7`qOdx^NC9!!v*e=7aYt)X9MeXtO~J;O2u#(M+_dHN5!%n)De$&
z)!=YYd029w^8gsGny%4Q_lY19750dQVw`@Aq9CF0a>Nw`CZ-A?*0~p>3CQCCJ+j|u
zuNjL_8Hj~__z6e7fnqh2<0<!tH<j$ubQawx1hKzL{Aq9UR_JR7zX=cS){h!qfKVoI
zfAfdBj@YjuIOrz03sF0L6QhTXZXk%%y#Ia732!imf4CMF+L(3i=UthB2{=3+4}v%h
zTu_d%9-ozBtyaoGQC_cuLS#J$$LQp6Cr)HfVJHbiGt>wYBAN&ZDLvVD$@5FGXM;UM
zN1RLVktC1f2O)Bdfnvjg@F$QQ=y59sdz8@kdi5rLOA+b5$r&An%!{ITAGKT95A+zz
z5%C#EeoTkkwHLGTDegTbZ-#HIb=ma>K4muD{#}G&0$hATu?WjW<Q%up_{@wW;Gp<p
zgU{nYYzH`j@UJ+_X3B@!Q$&VrFhT)A(oRSf!ou%l&L#3B?Jo~+rU`Qzl*c$zi8T9T
znKe?On8cvCqXgHaqmhs%tU)5`3-bL=4nhR5kI{oaRCH^R<^ubzZ(`dZ)Px67D!OOv
z<8K)a4XOKvwP<UIDIjq(A4?i1crJ+Bh|wYF#0_3t@Z!SL-c8!SE0Zy-nVWcWvH7Zp
zJ18`$7-l8lp%62}EUol<3_a-V>;cPk`D_NCaf>i|s9BPGIUM|z(DW#JvOPVHnNsvC
zxyZ648dXFd&K^e@v4@ce7Kh+C(X#%7eIpLh1~J`K9b*#*<Hr(0OT_X5O!}1IaoZh4
zl+)r4@KAmfH?hOjiGrrV^$)bawJ@M!8D_envw3>st<Qio`l$7_`E9SmfE4z-{Tn{Y
z1{RW69u&{wr=+N8Ru>f|6tv2cJ;(&vgpjRBv>6U!^!+3BKG4PCt(auSUhd<mG#nJ|
zeI^Of2jcyA*lQ(G8z!+x37vdcN0yk`OLz>3=c@zbwax)u^P3ZWd;9|vyUv^_pYxTt
z{(L;*o~LPgH?Xu`EgWrs33!m5zu2WU`n|`iqL@z{&{eE$_TojkRHX6)7M{2MoHBl-
z>Ba3Y-p!Bn;^zX5+r9X81@Z5$N<f#&-=_QlmfM^kXnM!Fvb5&*S2W0Kx7_shJA~fe
z;DN4^fG(B40i#0~Tz)>oPewiLrkj56R59$*7N3NnKfhZK0o^PCT`E6%=;B&fp0aMv
z`*+RkCz}51bub=k{Ug1D%zysMQ9KWHgT&}k`SBTj0Uc=M868>rG{5-HYf!Dc<wBMn
zgbUP{*5==<RwSTH<;Ms5^75=}K*a;y%Lt6_>0K>kK8ArVFghjUVwnw!wLy6C*d6QS
zUwR$mW+YFhQv-C@G6c`90?=8W(S1G{!U&8`kGxybyWg_`55vz=HxR~l?BpgC<bF_i
zgk<plHEx4Y0{iJGv;TFuTy0A{&?)u<?f(++IS}8v+rPtSU6?J}|IVvoHb-dxhL>mb
zV?zsIaxA!(2mRg<3ob4~C7_=QpwGHoO>N9NpLL-&`Lv>!WeT_E`K-&X$Gk<;JI%Ep
z)@a)Qmlw%9{`)F4yiz2!>&)HnAGyHcu5=)w;4}ao27$gvZx=bah-I;|d3wD<$fNgf
zc#+LTH$5`4NYh;C;-zfI2D<Pn`ixx%q3L@0+;@f;uRK0eT&0vya5{kA!~uQU?WPxZ
zW$SD6izD|&xZ^KgWMg%OF<<A9&awI}_h+Zo&;yPeZSb3Vp7z(6P*7&9vwZg$9fP%s
ziA)Ivr(rS*<xNc&5c3BP&pR8``WE*u$L9?J2eM*bWvq;O;##xQqgrylHJkI`zmJPe
zpaz9FuO(Qfud{sT->$|W{Jo$yMMA-8C@#7D;uJ!er>7@2ysJx;^L}%KD&X~45v!S1
z`K*mAEW<E9)<-dhJaABYF=UK_Vi*V~5&>^k5n0lTLUMwrF#(uft+#No0|p|C@VO5t
zY=TYU3x)hoFc4l~C;SBnXKaK&53hhjF%(315Jc9l!|)33nDYd$kl@u&6m#OW5~H6M
zpf^oXUawEZvNCI6)k85eGLIKgMYI46Aw7UY$Xy7lewFEYa~a)_Ugq#?x0UHV?UvVP
zZ<8Rna}-T0Eh1XyhSRvvrTg4?x8=?-ztb0D>dEo$?zw;dE9Bq7I}w|@I>u}n-Q(vo
z)!ZZ&&FQmsXSDa6=Up>E>hPV6jJeVdeoHTEI{PA{ebj`3l*z6RHFsu5>B}qtNRqn(
zCMU~A+bu6fI|TK`(k|WEjMpzSLFW12y4y!}PW*RL0>LRMC#LHnq*E>r^p}iiv_$<(
z83yw$w|HGzZRc-FK{x_K?^NOn0`DI+=}VkLxJH3j4v-un-yLY>rC#;Fn%;!6+c3Wo
zr>-d!8iioJg7sM|xMPjBbub4de}3GG6F8x7u#u>GZipbX3cUDAYF{VuAPoaq4;1&F
zr~w#m&<v!JmQL=<1b%;<gz~bMY_k#1Zk<ef{ESfG8d;IPR+@}TKtHls7YZ}mDm2Ac
z?NqA*zW}iDe!QsH-dK%y{uC6527SFoqH@AMS!T?wH{PF_sL$^2LeZ25_`TL%`;h+9
z^v&>I%zPPvD?07Hw{YVeirzMBa~tfx)*2PB&Or4OeaZE!_C^iSU;>jZnii|waRb+k
z-ZUth%hb@+fGZxV0ea_#zDGGwg14BfrVH@?*BsDqC^U7gmFBT2ji$A?w>&$y{&xxJ
z63~wZbit&>)T}77Ws$mHiivAv+6BD)NeX%Hp+=v91x>X`-O#1t(j2m^PTTU}e3q$-
zFg{1&qyG@sY&pult0i?;_<cP5>(d-Fflri@Ij_s{ave5ap)mKQktVxdaRtq+!mry>
zNmCVm;|a{r=UQ~iyO!$gMsiSJT}q-|6$IX_M3rsY>*q~I{8`4B^4wExZtWO$xh30Z
zx6QpY^%KR9^0Us?5ZVc8GAaT6sFHMC7(8jH<YlQ~szZAn<6?;NQ9uIIlqDU_4DMh@
z8*_`&0aj+rF4A$4_vK3MLp04?SJL$l6nj(lOwpMy2sHqZZ`K-1p&Fz;G~#Em@y?+$
zYHljqH<UYwDb1SBpLluP#}*ShSYOw!1~8><FptbDFZe}GcHb+|S9Xv$8;RbVgW2^{
zBv-4_O0>KNw_g#(I&R>3VJsO`bG7#rXlkVxT>|>iwHGl`cRLlTm8Q8OqJ|66alF#n
zlSO8dyhI`<C;>W&nsf-#Z{ThGUS0APZbv(YF4f)4|9MQOE5BEKj$a_a0bN%}6bc$&
zXIeFFyfRiMfV$zQ&xk7+`B+oeay3thDKjy6M^97?y||6#lO!DbAA9Hb)Wnj-@ui#U
zOy6d*Tr;8*X2L^iV+yBImYNDlxx-WnEQ(*DiVApxBwzwkD+mNZS&C9op@g-N2VQ*G
z7a#l=`15Xe&m<&zaT(y@*4=X+6eIH^lTV*Hr!)Qij%km=?W?oBrPvC&K4A5r58B$c
zI5Yhn%Py0Sk~%C_v@U6dZ6O?vlg3y82msK1Hlu>{ptJrtXE0{4B%;;nw8kQ_p~DJ7
z-XdJ`Xtvj(w;ap5AzfdN#~0`fZ#r2-o7H9`v-|JlvSflf`-~f=co=0e$=(QWm5&>S
zp=kzN$K+)x7GW&*a5K)6{6?Dhnnr3}xW+BzM<(r5aqzAB4DT32i|wOEp&JP!>UdWD
zXxdqIned)?BT?uQekSCey6ZYe0|o%PpNvkzgI^4FWNkl{WxbrF&}yn^@uqU<7fd`&
zpj~y;p}#p9Ygu?JhdJov*QAzD6$+(PsZg2@xhhVSH={km2#Z#d>TPuYT7o6A#Z+NL
zUB?K&yp}4C$24Q;B_{ft-u+BWWr?y*H%qf^i|L`G;b^jdUh9kN8>}d7t0{>O#5m|*
zv>su^J(n&{O5K(u8w-o)8ZbP>2%w)EbWxhL^~Q=5J&&DupOMrFGWE%=j}xi1wi=iA
za|lzJ(NDxYI+dU&hSByzb<}n`>`=(DZIigp+ws=u3mp?vxjCA6udm10=-uVTj_VIq
zj=yf2mCXm!DW)#*rZX5gI(R#jj+ADI{qWAgU}QI5E~;B8>p(X*SfO3iLgscR`bM{l
zs(A1qJYkgjMM5WI>R3=pa8Lvw0O;qPUR1C-7&UrKiqO;qOPVeJd9z{?+PN~M?M_Mg
zB~Di#<DmcjzLj2<-r~pU1v2?Cmg^GS;a7V%;-2_Rck7+$cA=Q~DtD*ceJ_@JjQQ42
zOInW^Tt0Zr?+~4vC3Q8v^L~#f{=oGOBX^UStK*{^`33!EuQeU*-J*1!9k*d&D6<*K
z4iZ~fMDQAGVSJ#CU_`qL(a*wgQ6Z4g0dyZ<7@_bBBhkh)d*H^Jku<m8s&5@mS*2AN
zfgov3fey4}NI{O3Ulw193ea)*fyJH)H;<!SBpG)FJW+R_W^Gb(V(%uR+x=t4L`X+u
za@aD~^{zGcVVfuZ?ICSA{+SK@DsBSLBVR%Uea+2A*1nSV>5QgMOd?t~qOCKWbbFMg
z+HQ%`MM&a3wbHE>-U+WKgo`2Fo|?h{I)Hv&4<in)`D&bvUGMKW*w@sQ-m+w5K5R{f
z7ILu%aVkwODY>DIv>wiI&<6$4fm~u3qobla@TqE-H=^nHa{Upar0bqGl6o<<*q4bt
zKrNrN+)_vT;(U&=_h$GS%dJ-9)lZ4oLHl4nI{mHU?5(M#enLA+vv*SO2wIA<%z{Zs
zXNp<3+bTO7vGjcVi3d7q88b3>7o9i7i19g0%};Zm9RM9bKX)^#AQYNb^V$7eo@t4Q
zjjPi}H2Y;Bug?9`mBPlD?nKo@@o7gUu`D(T<akC$`004W${uGJ+wJ#cyh;3do<%ZW
zatSuEP0?XSwbqK+Sj5mKf~Z<BjO<!25uFQ>;Do9T6mu5)_fzql%Oj0Vv{15TX~iw!
zW7$z)>4D;an(npHiC3dj{eD&*&t-+H*jRuBQ(EpFZ~&m6+m%k(QQVx?Vw#csWvdij
zM#!GeL=r4>*O4<HB3YA@2eXE8c+<+11?b^o<{42C?);a^43;ZnZxWI!oqdtpdrY0p
zEOjaWRq*Q+i)s0JXD@HrRJT8jYpP+bR>YWiVyS9Ooes%HVaFPO!tWiES!1+a%-)!R
zk1>^LR*$YIzfG;pF3T^rl=wW;qUrKN^n*#sTr^h&4gho?_KTu`=?^*G_2!PWOoi^Z
zGzb#&v~LE(s8MB8KHH*qha71FQ!Dtp`n2J2r!&<~TpNJk{g55TwPn?)+YW8FxFVh;
zP;u=3GqsjUr|ry`O<J_VAg<f)=)$l#8bH4&=%V9ngvvFIYh;?BW|xDSqJGUFNWO-;
zZ>y`OSH?)WbK#FfJ;Mj7w~Fgpu;P$sVJ;e59nl}8%w2C0STPEqUl?@S<oiVHitip|
z-~FI8STZzlN4r|ts)?v4NnRfWHI0he)4Z-T2|d#irf%V)H253U>`X4@#sl&H4Z5o=
z-fWZA)Up17gB7i3>eKD|@2LXx`dT5+#j2*|-QWxI6JAf(712g>hq}`Vh!_Fr7Y1GV
z-t6tvTEa5~_`$VDsksI<43NO9)v``q+bPAZYe>WP1l7Ds5LJGXnMspfPJQr+|3L^u
zT>$h;fZpsbNWaUae>5)Y!=rBYK&jr+-$I(!fHs>XxCKbvAMR|kK+o@?X>5`Do)J{(
z0Q$vi^g2Jy&Z2cUmG4~HeynKZDh;t4dTMRyl^^wbrIzJ?;*(ZuI%%U>&gm-(%(?*R
zm&oW45CA#^1b_|!0iZ)b0O$}906GK&fDQqm1LzO{Is^oO4gmq6LqGuN5D)-51O$K%
z0Rf;x0O$ZZ1b_~pLjdRy5CA#^1b_|!0iZ)b{Fy<Q0xZ%8+FNjcF&7EG3x#;A{&ja(
z*vIC+^%RBLU88~+qL)#?pj7d7cyuaFApazUC_c|$h?!k66GF?L0O)6Y#7O9@xIz*b
zQ-sMyv<)fdLq(UnLAonzp%dx{97>QsRD^IwUEW2iBwbwC=m!az|2;4WLGICO>NObq
zId@F1Ty6{z`d8GYyfQ;wDSIoFvk0llY5Biap4g(R<bwEcX;2<LXMQ6M+K=ZU4e5;%
zOGHPP5M*>U#C#l{A5LkIX+r2sF{ZPQCrvG{772dwMZN*h&r0dSWysULMHG{Z6ahlH
zNT;#{a_<jv^!NfDQ$M6iurQ*h30=5~T{xr50gC;QDxIB3T~A4jZsOx|$;5EQOd?Zh
zmdpgun?5p8PzyUD_v5-)O80~ng@Kmb74etQ73tgSC!>oo)hMAysL#shd(wR!TygUP
zsi~(D>6qYWoJfO(tF1EJu@0dBq&nvHv~Xq?R|#PSU8qKPKW)AzepetuX4GF(OA(<y
zOLRFr8%mGMfUdiDB0r>}dbJ}q)qQS`c$I#|=8^K8D3mT|T^@eFt9(0L>5>^$<YWGi
z8ULV%zO9%z`1)%|r`7Uimz)&wlOa35zV7gYO8oU<rA`WUzHJ7~OVsGZtRA+7eN;}u
zC;q5h4SS6!A;Fy;=iHl{TZdJhUU7}i%T9B1GX$WYRWvB%-Q38)4svS&{Ayt2o=p{A
z&>;SKy5`J;Dz#=+n$)@4&-^c)zbLDEJeW&WNT@inZlX__WJpX!h&@nQlL#PnS#0p%
z54tC$Q+=hc>RM^=TY*#DUlyeR_M}BoO-d9sh*!H)ph%SSM|0UWs=KGA=udLTFWpH8
z-E$idHg^0M5e@7ugl{3Y`4g}5?pwj`j<7r-asQ#g7n$diZl#UnOrh8q%M-89N?~y_
z;@zWv{O$UQ(!G>jh|BlRF9EI;k6(!QEX#cbxx(;R%=p=lerN95dfG^`@VY80yQXN5
zvot~7cEv)iaaxXLwFWFMGQmO^S&og75I8sPCUF9eG1y$z%0dzcL;$h#ke7MQ!~BIj
z@MGqu>^W5?<Ol3Z5mErBsXCYMob#PiQr972-IuOH-6UXIccFMJ)dWC)b!SGZ>%hC9
z;29pU^caOIlLr{NeH$@W5dCW5ZeydZ#VmUng#dxnbt3`E=?@8wOTC_@nLMt^^ki4r
zn02pa;5eP2`UT1QeiBWGa305$Y>fN6F4T>N#G%{&jWYf3no-D2^`e-3gdGxP`=&8`
z#1-C{vNXPsyi4XS4RX|+c5kD&nIFiJV(K}+SB$M${H<8Vyuvjh;5Pb2YW5G`Y@DrO
z;ST4M&vq1}$9*!1$vVbbpxfCgcT#TC+c)*1qkt_C{MYJB{i{b&0PrBSI`gADOf?CL
ze-TR+ClHH~FWz7XWu^cIJ^8dK{%|{E!VP`L$tM*RnEZzsX@FU3W*X2h1qN(_0@TWz
z%R5iGzlt|&2W+(@D}O0Li~~sUVjHPuv?@*Tc1o-VyGl|meV{z;)THcQk`Pj*RN~Sg
zrHx9U<!xL-5~<7qBIE8iZ4?L->>hm(O<0s`c)XZvsl?KK2npTyra(u93O3jPFNnpk
zlgb2ACozUhmg)dx7S*#jwGm3E${3C-(1m(JiUDS6wEXnc1%tOd6^T5w(JbzsnJCx_
zh-h!Xw#9z9pn|H20AoO$zq!1bJL60FyU^I$Y=vYd7aNf5pOG%mS+`@<`H<USRWy*E
zJ#yI+pYNizRcg!RN_pipKqNR8?MRsQ!w^mv6BT>d`EAXJaRqAlz#^Sd0J_d&x@=fo
zx7yh+-ksN&0CnQDbti%x85g1$y%uJ>cKWMd<w*-;5&nnjnTqzieyO`^L@0lq7rT8=
zWvD9B*&Fq(?B@9|xTuANM9+{^O(ZX#Me15({E$dIsBrhhrmf-tv!#T%q8h-As9<CY
zUb?uc6&0MoBvv<2Q7H6LK!+q%VGAGB&U;u_RCLz&I};GndR~A9QAHBb^-Q0D5X>OT
zTec2Ka1}hNq8uDTwNSW^N+IfZ)XvgZvN2UBe{$-g4Af5DPu4+sxt1_z%OJOmued>m
zDT+f<Bg(E)B^%{zs(uU*izpLWP-Y?42>`t#*~6QRj(>znEVSbKl-F>4>AG$hzjJ@f
zTpqV9uBUXFVli(;D`C8d4rlws^10<OBe!p9N88J&8x1QAj87QjEbC?|)^zK1bZ(z0
zuAR-g!JAM*-vo<d%CB$u3b}4JpjvOKg`v7Waa0FXp?Cm5{H`09>e@+3(EEsd#SHxL
z3^EMjUo)1+Ng#9vK$qo}uvEyfRIwp4>}G8X^Mg)-<Z#)jgXzGKGF(~lscP>ou5L=H
zVp<cw?27AG@rzfK(U4n?<ItC?c2~s%^}E@)?DouDx|KM(04NSTWoNVTkcvx74fHAO
z4O)b(+k;ZHBk_arFw9_2__AOV$@C7~iVj5~y{R)lE3~o_M$QS8Oz~Ne9zBO;fFf_S
zz=d&j5u2scK11z)dg_8Mpt3V*?(TEe{wzv&A*GGC3h8w1C<?CdeLZd401dj;c@YAI
zk-Z*t4glJLOmpoQH1~_Ox^Jgd_t8u)(y{n=po2v#{Vn(6?6Oh2@+%Vbu~ltcpIy0e
zuBylY03ZNKL_t*GtmYdr)>wO|tAo6kn><}FT&LH1Y!yqDtFuO<+Is%$?W~+cua2vi
z>9c0$={K^K65D?j8ij!^a0o%_LIMxu)>`_yaJ=nP4F!^`R~=_Hb-W$qthbIk=gT@<
zf+CrGXCLuQLnEC-YimILRrteZ<Fe4)r#w_Yy+9Ohtu;Sl61y7cSHNShTeG5gy;ccV
zz3X<f07C8qZtPa;E-c;Gse-ckA?#08u=Lz1irMB@sQq_ag+{t|2x)|sr!k|GXlnr0
zmaMm#Zd}(sfQ6Xvpfl7{Yc$SATpVC^*`w@h)vg=W<D)n@g!x{agW`Yn_1Cehc(i_;
zZlurZ8GtDr0U_ws+D`9r<FeX(^gT<!QrW8-{1wOwIlQm=YN&PDD4e&00NiiB_CU3f
zK5YjPw9gN!VEDRAy61=_`t|fcg)BWhZ2<}E%~u<jX9q+40rektehXqQ*c!M9{p{35
z`I@bq81qy9cTYy0HK2O=J;yLT@%gMm$-TWuBMLwdo{PbXD*B8rIJ-ljUo+u+f_7By
ziBx<fF;T&cK41mD10BFNKI2R+8=he<RgvKyF3vfo;Vn(|vUkOZFpXGSUyEU7CMPFK
zp5Y}^>+&06j~*^XOd(dM+T_7a>AClC2|n^n=l%Y_+4xLsdMRQUVgo=#Pv??5oJS8f
zMm^K>o{eNR^X7aoX}~UnW&UcRXb8_syxh^#B}RKv;w6#^(w-EX!BYVoomXnRhA?8z
z>=DhTj1<sk>(ZIqgtWP`Y&_A_>UmD!Gd-cIH@uMm2@)rLgq3r-CL`?)BNj2tvG*BO
zPDmhrW{QYuE|PHnbkbNgjom81&z(+gN?yL4i%jou^5Tu>f!Iq00N1<6#>oaqY$o1@
zu%M`vD*N~53^d~MfDgiBWI5uQ_m`&soXBvp^QmO6-gm^<KQi2sxnhe37oF(^!-xs-
zpA7qc>X2!aBEm4{7B3*i^YarYju{ambp+WuJ2Ek6IA(GpALqR9{p5Yve(dGGZWf>f
zzmJq$>@UI_v6(pCen0QrH@woP9l}-?jC2$fwa<-{p`ZT1NS$5KkAE7IS0j^VBS@|O
zlJII5&6EJT&L3@<Y3SxC0DY>`rRw=uaT}`itQmPc#95{|TBG^Ia7ATwd7IJU;XfuK
zB9X2aN=9Oz@a<v8xIR2s6k;J7%+H$1LVkto1~QWyn=hShSIyPo?WZg_9g9pKTwEH?
z!p*#lTffJW3kMe?!{+GAU%&k^V<zTn9|}2hw~v!fVss~9e<+#7+EIQulFR$Mdi9*g
zjG5+dcJHn?f9LD^V{i22QMbcz2V<ou1g=$ZoE^~a$qKg%31d2cQ8PrUP1CVrFC*nW
zBeDqG=T%W$=&sM7e<PCVyz8q9A>P#MGoI54@$zJ`$=sAvtR1c|I<YBze<hXUcSenq
z{Dt**$#bd~`3)n{2thOIZQ9XU2XJojtzDzo_`Cnvs&gsXyP23s4EEQSMC?j;AkZ*u
zO&H1A#fRUEMlJ&hyCjO8qiRxk&w9E0R)~}J7p*T|B5(6xX{<@?|5A5uJ&9yn93QGo
z$?olDVBEG{P-VxiSQ464$mu3XMJ^#q2*@QNs4XI>*wTulf|uqHn}+t1K|AV0zw|2)
z^A&uU4>KR-tX+b0l5^&LI$j=-%dWM5d+qiAuWhP8u|K-M(Z%Y*Q@6JKOOE*Ve?Ls(
zdX*DqauWS^K7OatLK%s-X&TvUP3pM5ih?2R&-{5?@M!I~M)3t}{3wQdY=hda(_`*g
zNX0)jHZvF(mbj%T0ht1#?FzSp|9H?JJu9(CwPaHBL6QjXP=9auXW6!h_0#F#7M^v0
zxEa2}Z%U6Am^n<e-#!UJ-vn9NM#4vTZj768ubiR(1wD|W%7ICCTu11UFn@^s`wm_X
z-+7b{nm@)X0U7memeC~szG)S#<C;=2nL7$@=S9wOtYjyD?hkZyMe;diPOj-{!U9_b
zl^Q15daf&Pc<w5zo|>I^xY&5b!MMrRi@uWMT`_6S!J{oHx#tpP=Q2)i7+Dg^+x>59
z14LjxDiuVyx}h?vxyj`VnX`7>(r4>|mb(?uvlU7JC~m>+pGS}4+Hr)t0a+NXVClEF
zvRL)f<+ldtTrGxohdDkNf+aN2;EgWXw}`<@H9Kw<<ywa7RkJgS_vSCP^=MFd5DO$3
zcZlNiMNe@=$iq_HpBG;N&C8EQ701hyZnbBzbFNC39-y~Fq`PVn9C4i#U%-f^U!RM-
zeJZlPYeklbek90IP5SDTE!7B4nEG@7upjg6<Ym#ZktQhwpp)nqyZC&Fx@%lHLy9*R
z&eGG#o~44_6(`j16`YPgmQ4cpB}BY3$fiTT|ID>Zwc~kS4!-v&x2RNj1l@iP)AdiU
z(fen+5H|<AFkOX}d!sAo7TGNDy)^kO=TGn~)L#HPSuRZ*el{m3vUe}}R$B4sdjfy?
z?-jcNx*0&9d;;C*joVV{zZe{&DRLwP64IOtROP!Sgw86*J#`xzG&^1-wON=JRDP{&
zh2@Z%I%OrcB}#|N{UO#4BR!ctcTNg9&{&ExpU7-YP`%7ey0bR9npLlvYbJd3`+I!9
zJugSdkj#g5&Ff+#x4Y>@2?{Zg8bUBN5rtj-woV&p_?%pn%!jx;#YC3rP&zqvrJ-06
zu9F)5cEi2ABNzRHT+{X$TpU9T^hC{Ue&^W5m%+!3Ui+q9I$!|X&G5j&Myo|KE}~{^
zVt3dM^>NFG7r4@id*L<C0zMpHP2)x5=*%c}S3c#vw8&(=oWSizPaPuPD70A+glfv)
zLe&_(vV$yK`oq%=^P`uG2QVsm{*dlj&2|R5B}&rFE0)`8%F&OVbr$Es5G~%mh_xy=
zqvIA+vhj3w%v{y8pIw3lBCl6Q*QnRY1g$AT-wgNfz-e06NSNcpTVzN0aw1(Wfv9^o
z7R8}qXOtW|nU{6_!+?%tZfVV<>^hKH{-{N^nY)DY1+wrE+>&PDQDi#rgU%F6oTSEt
zioa0MhD`Z{vWNZ#baWr0El3LwWiOo+n`_DqGj6A?JL@6dvcc@df&CRsN5+}$AkWbH
zJs%^XrY&%PKax?Sr+@X$txLhv=0;NTTFliHts&-a?WxI{c;$u~{Xo(xf$CW8{wPUj
z44ax=SK2>hLDii9*r<`X1<ze@U`Bt<xkq{Xf<G+_ude8FNxV~hJ==Zte&oGWZ*p_0
zw``qL-W0R5{77hGyKloY(7X2r=<iFM@ae;3AM_2b+?6IGhpW$B;?pS#w7P;p#Wu8b
z$MER#89Ivq5YRxLVG;3s>)XUdtr`dfrq;7>UY#YB&+J1?1>81T2r^=Jko>Y7u5Df<
z$$`+*(k)nw(?UGA@&*2Ecb4+CW~HnA)(2gVlBi*eFHo<gAK&sEOAAb4Z6=i})aWon
zFcF<PRD2yA*)$eD&vU0bPT2z0s?GKt@0<;8!r4gruaL00CXH~mx(1<zAXvVxhlCR7
zHz&kWz9v5m=m=Rp((f(ETBbOzHw{C{*~SSuoWQd#$c2`xC(z9(ucYJ7#r2suj*d3!
zYC!nEpaW`9VN5YebC!VmuAyf;GJBN&RngAmng0SEg_EhKVUXP<yJMvo>@M&H%8s7Y
z27+q7b-0yODWzE-pqrA)hFjg!b2aW<%Z~9KEJ+~zFg!y#wj-{e(dnF>Yq=Td%=+D+
zTeinDAp&Yfa@RubgzPc}LWh>P6RKc|V3nw(KE<t06sJa`c>Alm=sb>rAQOz1f&n@V
z96+B1kv47G^9(XN+7D3}fxi5)Y#9XhU_~A0xlQuD#rjIZ{A(p7E=8fdr?3DJdbrJj
zJO^D4zww-<l%PlKbL<832)f~2pB`WMD28WA2i!PbgLgvj9$Lkf8WPIASua%FpwauF
zb9@13EX?v+nD7qw*IPKV{*&Ff>eU!I=Hl+q7gmLJ)*wIpNxW0W{{x6fsOgx{bx`~e
z%EhyO0|7aF#OrXqSG#s$DybZcM)zq~Q(bT!3oN6{KTbwxLvPWwRn|L+E6J8&0?%jY
z)`uW~4m%)c-F*TbHr#|VJK|lp-D|~8#qV>N{|0m+;8hP;tETK-pA=RjxWjx~L42*`
zUVfM%pd+77t3-SUh6mixyZ2@PL^`vR$-qy$GB`r=axaIq?$*v+mn2MFz?&@_g0tra
z(64l*W{y*TV&{&%ZfEDlj^sY*(ws%u)|EZhC6Ub=WUDIldnI-+OyGD-uYv-(1_fgG
z;aCA)y_jk5EZ2mWG5z}YZY0>FiIK1Bve>_8Y9Dko{Mayp3@|8NfQx5yiy=3~_!sA2
z8C@FZ`AsR-Gg_6dA)4T!Mo&f~o>&z?-+&|v17_cujSuAnnPkqWTp)J_=&b8p^%AP5
zqL+&?+T_Pcoz<7<Q>)tzqw;%9+$)Jp+edc?8NEQF#@4f-rmTI?^B1&jGCIdF2XTJJ
zT?{j|-05mHp+OQ=ql3l_C{60JsQ-t$>+4CQ*~5pWS(uJPX&tnyyO^Ghdp35nAu6G}
zu}F-Pjr=nqNM9?6bS*7l`Hw~8YeB84mDFDJrng@B6}ae!IUnWBtk9mD_X8L&-MF(e
z&-~_jp5HUE*ezb~%Xg~X$ueI^>GOnf$qvR=q?XlXc(ku2-DViqX2>#6?cW=q(=KKQ
zX0Pb-PpUr()|V4~bpH257}n;<f~EU^I67dPXya3(kv8K>Kckjd=RZ-G@-kngEhW?M
z%i9ZC^@O&P+37A!2#%KTcSU!Cr$(Shdmv<+U3we|6b_}+={3_d*SH~#@2x<8vsyo%
zitvPQm*Y~%5=)<wiibH<h!{QL6YJ@8j{F>(4(@kFhYzOMhpE&H&T43vaAw@<_)*-i
z<IAfWzbS)(+j3osXs@12%ekCs%7pryi`Pr3?pjD`MBC!c=%4uxfzDbLoovnbXJ}N>
z3B?f1qxEPOrh0#Xjz~rCXo;Tn(#6jN!De{3`!uhK*CxYm$9D5_PCllio*NwdeN7r1
zA^hVG=#1Sd*Pz;eQx45_cHlO1tHpX&9)X~B+<D7O?N;G*?)3)xLtS9T3exl?zhgLx
z*RRmOTo%xK3c9kW3soGq4e^xeplpZE4EMb<>xuE7WikU~?ib0#vv*B5`$STSt{eIo
z;9fTP7Du0U)O;&b<|g6j1n6_W?hnw(9CR=_6p3ECQnaR(&gksm)*$x*_GifY2D^7a
zcUq=JIb}4&dAGX;6AA4*_=k#4p7W!s)&GgWJX4ON=rrZpFXJdfP7bu?`9oa{jVMX-
z;1j$Ta_!)Foi^&G_BZy22CaQb<9oCLJ@XUB9d^ReTNLQiZD^$JXPS1vjX~|gMyt)y
zd9gaYaYTSFF1WyWj4zVo+|Igp@T>GFqQfpK$>l8HBy`Gg0f|U`j&`av?<7=;{R03x
z$jI{fDLEr1Vn%2bgt5eEeF$`5AN>1wMdu2iGm8w%$SqB)jDTJUppOig)zz;yT0N>;
z;=Vl{-YvafD<Zwb4aN*qv@#cFaijG<=SNLC@;?<FfCIusg49!Q8MwfX8L;FA?0<4^
zeOphRH5}*=Nee>DXjIWT3+UwQmhf-tGWQELf;2ebT2=9>eLZzKPV)@COR)})QmM1|
zM1RQd66fDzIAU6vmIuYJGj{<Q+OXP?wldPSX=hIT(yC1Dw1W(4+ueOjjIw4I-JgmM
zm|H%3MK|z4n9q(8G>@OFyB=n(#>eY`5!PeqfdvsOsb=m$9#%M^f)F2ABQR{GEFWFE
z5SS--KxZtD?#ET?k(m+xjGVLBxEc)pl7ES49dI2bQ3l-bdQd2a;$uV)ebmvrIkxFl
z=1nkQXBFRkdgze##njPYFc99Un%~Vnj*CWpFkqX6gEQP&QuMIYv8a-bntKklZ96jz
z&}R5m8#~oTvDV)M=Ft*N?pxjRyAb<4Q35+htdn(J;0Gqy7Wvg60ebz?TO{Yjq5)xY
zo3VW&y!~8eM;g|Ct7OZRx?n<G1nRqXUvtw&EN}l9<39=HFHeff2<U7*gDL`;D8lSE
zQTV|pl5|9ExqTNquEVV=nDgV63XOVwz_F&CP?tP)F@+57-lc5ppdRL5$>hr)w|!_<
zFc;v;qyTKsV$@#j6V*NdoDkh5KxbVEqKIilx5Q`-``x3?=nDfc&>IIIvoPx-9DOG=
z0=jde4gF<~wU1rmntYA*FK#dxR3!De0IdB&^8*E#)b$sHv&c)5{_WA=FTx{<n6O3R
za+!76-{|=B{o&|b4<<VF)D-e5ud*JhMw0l|9I)l_Vf;<uNfLW$?{FB@bwn}LJPark
z*;o?@K-ZN(5KP2Seu}LfUXELL63C0oepsLYF(ZdW4SvfW>ZQ<FSA%|;WqL_15*;7j
zM+(LuANZCo={Ru0g6SVf-FO(fNQo<xgW-{r*S&#<>6cy2hnLO4_hm0^{P#4vf)IJx
zg`%G_!ZQ&W`O~AYD4oBy@~jjnMWhtJ*<K<s)vuTLd|Kq-|E_qHiFSOFBha>8@T+Og
zwwctz)!;XcPc@0;vTY)~Og8xmg7BFDhG`wZb`%)yPuQX&6{EmKsLN|$8hVQfT^=g)
zp7D!>q>UsrsmDmGRfKhkSMtF^nD;KM338h+aYVrL{6dg<BYI;?^>SEL<4*@>95$&t
zGu4Jg>wPQ-f(uyP&&eMHNd$X<yNU5i@m)CO6-hn0z-n<!uJ5G~T9P?OBH0A4O^H@?
zz(x7^+-MYwo2qtsG+v7F-h$;E9MIXhZKOO-M@tlqo6w{oC2rVy%9}j*jDJw@C8-%!
z<jzWHWL0B}=Ea2VEYjbFUY@7m@-aF2FdwKKz2!x;5xgHjr>CkVMy;M<-@vrXt+r2r
z;PgZ!9`R`9hx8$5CBW#z%uNdK1<8@QiNqc?uUpFUF?+hgp9%K2Dv>&X=C&9@QfNhI
znB$0)C$g&f6C>59?k37a&{hqE;SIGF$gZgCVp5V0A>XJ_9F`LrH6oz?YUGfSy|U}W
zXje6Kn4M+E{7~1h4@vq75SXt#U#DbN!Mmals{SLgj5Zq50yC=;k2jBn8wLAzAyyKz
zR&sIVF9)EqPQ3-oQvz(LO`8cwORk#q*lzJ?J|}>KEY`QdD2eIdsxf>BZyjIwr5UpJ
z?laU4+H<6$v*3*)dLi^mdS&D<f>2lGVS}@kQdlIvRN5ZG62e-^WoI2>o+s75WgJ40
ze67Ac7~~?jMZ^RnWcVU$zYFp*lPeJUu$WXd?={&4lRq^qswu_W2r-M7WT8Z_8dH$}
z0JsyW7US9zGuGwZc`@!9jY4=FP!CfWOWF$p+g5TbL_vJJBh{Tij%o;z1yAlzv!G{?
zN%rodl~3F#Fi)w>7liuqT^_rEu?98YN`VaR>7E3=L@ED-=Zp8mUSt@i(Ed=rOLI@1
zTu1!=%@>w|#~#!o{z#^9^gs5lt|zJ_4TrZ#Q6+Ge8ASFp)^M@WbTIK^q|<DI&@s~4
z*vOhpY&!}rtKC2lqx1~D7(x(@OeVNdZ})aC<}d8e*`KoYe$+YL>c~I<Y2`$L?mm6$
z>#eW1p67X&cc(<s!ViHjuNT*bt?9ebc-5~!>Dltah`zH^{MG5TTBV9chM>~^g+?8b
z>>~@s*EkQZ?Dz-Qb~g!eePgasdlM6S6{_2-8`D0WS3Qido`2+T%#|-BbU6+4OC^7;
z_7@s&2UX$Q^1bO?u5^6>7a}i~%bUJA;@O>CZf5TBIl`(E*G=CUuhlAk-Wc$u$Q741
z8R#p;&b(=?*8L&}G7lR+4f&L_yNz6_RQ|OKzaI~ji*LHDoqAqex(9-X^dCfnb91GK
z(UZp5kk4MUUVNUlBe!mC`4{!=TCP;9oYAQx{oR#XX}eFU#aE@tTKT~}KWC0C71#af
z;NHy@ceBc@RB|)9+W05}OBRaH2$eftd=3oO_1nbPw|q&<gW27=<u09ZFQ?~f-}a2%
zob0!m0#;gS>D-xexd+^>w_6Y|6(1AP?@4hXlVY6bA2)m=m##X$DcvexA~Z)&=Ul<J
zQ}o-muh{Ly4Eo9Xr+o=>l>w{(#gGqQWzR0(Tql;S()Eh3$kI}QT#|*=QYly7y0E;P
zZIh)7BQcR#gs@w`Ppf9T2-mFq*gI0KMrfLdu_w5r(ZamLe+c^5L@6K=5&=)O2nzV|
zKgLG`F>~-$wpw+F%0u)-CKEA64jew)&HHpjF+=-ANBv$e9et6jF@fJDvH_)$ozKR^
z#>Yt&v!<eIwK{~TX-%kkM3q96i3#YPt!6t6(l=5~2<8K!W5GY4;J>=VKLIo+KnVCy
zQbRN!AaZTSMM~ZT0UCRIRLaI`Xmm5H5M-M&Io(i(6gm8pBSG+!mz9=6$Om%S(a|nW
zQ8C=!YNBM(wg8lh?q%;pJef{CT&tr~W$5u=a|NW&`3mh2qKYQ|kJ3&Nx;ABe6P;pe
zzB;TFlc=b*h)#f&VWWxa9YjnM;c9APewg$-s8I>nWuEsI>&Paf_ojRk(%arTRNv-i
z2Qfw3#p^<22f0)f5_Etmzl?z9BSBhr6Rm;RMO0nH$s$4zAcKGh0I>}NLj59<0b;Rf
zCO`l)g|N1bj1y!(*p~>x&e&|ihUyejP1^&_j|1kt2~$BxVBG7ZtMG!FSZzw6xyX8J
zQD`DGEldBf<OSCPW78?)S|}03eL%x@aS)+lkai%Y05PXD|0E)!phK~q6lFf<Trsmj
zs)Fl-Iu?;DV!DHRfv~Jlkc6ojWP2}5=NCr(>)E{DT?oTS2Oj}~sD<Xvb!eLqO~BaU
z(8UC>&vXwZ)GSMYNmO0qagRo!$gTY2@^l9cV<Bh2yg<dh2HM8ZSucX@0eh;VmIW2;
zO$Q|m`6cUBs!0*J&`iqYfrVS&Sep<o1vbm|sfCQkq7OQ(2}E*3%es(mffQ2B&Tr(%
z=)}OR7AmXc(kkZq$)8NF;|>ziGELGJmb#3Xiew#o7h{J(mT4x;SLn$>>JekL`DT8!
zc$~pV2Tnv=taJf_h)R7x$T0T`Lc>bG2hAS`J4IrKHz%SY@eDA(aQ@oz*!uWP@3l7>
z%ghbnic%~DMURoL)MV(=Jwr~lPKbn9JerrNBue--RP%U8VY;()@$LrAUy3;#L`aef
z(!54AZDQzwM9CU!>@pE#qo}S)eTh(^4N`1!n@K-PG^`SEWb&-!TeSEw^3pUtU*0p~
zLvAJ`hPzEj#H2~4c}z1N3e=i*C`A)?v!z(3smPKw6YgNzbV#SQNG9CM1kE(lEE8#x
ztTg>J33Jt^pD-&ZJWJc=I>i;)N~62?+K-pJ|F%1vmXfQ~v{ttHSV5&+x+%xWlxUK_
zn%Wi$GrfPg{V39*29hQ;tuNYR>2i9t!-byh_}t)5K407&=s1Rk#o29Yd?xp1<Z~&;
zoErMqcq!BZ0M;Wo7EvxuYcE{&D;4WgLqENa=hEpu@OX4{SycvA70_LLYUroe@m#dK
z*5o48`ZyXEH4_X8pXkrDb~!cluX2q}qD1K9063PV3n^OSQ7wEf>Ge}X|2hpl=o1}}
zof~mF^4Z8q8qt?quJUrZ{A@o{9K~lj_yST=V(l$<Uvcc1PtA?=O=CV3QRc`3HhAX_
zt?BkD5q&~TT#N5dPT9;68J;vlBHx;Nip_~K^hWDdEY7{yUnmCBGCM#dfZ&7$63ZmL
zK8}E~hlG<2M^hi(N7OSpTs^c%4vfZwwzG4Q^%L}ou}3we)A$shppoEr4E=iR)mf>`
zntkLN&*1C<8zLEq9fY7lq;~dcMZBh=+`eb)EMKTVo_A<Xsp2+V%vo^Bgv1L8fFnu>
z$2on{4gE^Xb-lCm`qTY(Xgp0m;F^Gr%H^+cK);8DYLVkr>Vx<@Iz3}OJh@iuVq>B0
zB3fZJDiU{9A>`E2tR(o@RKrO(^v;&6QmJ%4-B+|Vfo&XQ!b^0djlg11M$_ySWKcFb
z+L#ZQ&NgUQo5P!?gQje|4d@2A-xG+(iNN*IY<Kq?m*)f+I*sUdUtth+tPfxZ2~0v1
z@CotAiqM}9@j`<A$Wi=Q!)cqu%R4mJmL`O3`x!dxJ4-A96tvOiXx8YWm)u^4e#QTv
zHT&9(YCW;|uH!&0Vbs*($`GRnQFFJxQQtF$6`OK)W3dl`eD?j%z(xa$6Z#N^=0U5%
z#yiz+hHmN`|04NrTtiRvEHdKxC=5Nju`;Yq&_M8q3>~khdl*S<7-UP)3(@Mv@~`SV
zOB&%o2yBl#0wJDB^g^?nl?IoQ^})!-EBWm@YmTF%WPEbGOJH(@cNZ|62@yo-INRXp
z)H9c_vm=q9rXWC8wC~M-=hq$GXhN)I%8zCg2BD{0oRzWcYn22d5v~!(1H%#BJ(yhX
z(}F{%>{B3{CbNMMuR>z5Ci$hiczH~v1kE!N&pXCWeBW<F6c>W7rtvy-`a<z{1Uj#|
z-bE`&OZ*fYg0|8s!oRtizZ5a5-okn<pYa7f^L*1X?AQ=MmjYlgT#^G`a8)xlo&sbV
zSxMr9-N*B!FXU?%fcWDoY<WMc59SXV`jsnB_sFF-E^PUjg7E0O+Ep!xd=jCj_&TV*
zZ4@`V!oWowIhWmv>dy4d=^?OB&(5q^qAH;CYwqG(=i7h~)8dTPDX?9lOJiHB3;*f<
z1_>X5(h~<6e+Lt9&#yVl)ETCF7(us!O+oU>tm3UJgPtR;!gkmu<OV+5v+kE4?hX@l
z148g$Dy{?DZ0E$6kZ5@}1SaBzGAIWLUL6?zO;KFRm#@Y;L~#KQS`lU^ByOR<l%gtx
zROKm(86Wg6<I=V0-v#tKZ2z;^#d&dV?b;7n=o<TRrXZUb(2+tarstyo03ZNKL_t)Q
zvzS73NEDJJ8i{cX@CS~AWTbIFo+tIc?)zIVl#U_u_De8y8X4oju)y~Ixx021>oX(r
z4iIxJQX9A>7)OE{H^$1PadDz{es$Qw#>L!<3c*U_pKd+qASVH{8v;N&wxUNI)7!pM
zb^ZJ8La=`(D_LPD*@^Pmv5W-YvVrJCPot>_7pyJ~a|FTqDDIEE3~^En`*-4{+mju!
zO@d+&4p3|$tlzlryQXk5SThvXhH0~o%!fi8DM?Yo;Qfmm@?5Mlr_w_m<OFhDqOea#
zBARTq6$X`HyFwCNOmIQ^p=5A||Gw&Nbn*MvZguVq*{-GDyMHDc2&E=e6N<6~C`o1<
z#SIY}Kbb2NK-jSoOXQ39^Q5=VUfa?bcnZUcg$?kRFrquQZ$ALJ7`cx2=ibsg8lgZ%
zjtvA23K@}oIz;D+xPrA|pKhUcerX8Q#&?t7Sa8Y-7l{@Y5P@@I{U)4Z6Zq4GpkQe9
z$fnbfQO+qkTgC8HF{sU*vty1F2qEKQ4%s6r{~$wOde+1rD7t`S)FG=<L14*I_k46a
zpVcTrDi&h2zeOXNG;vvDlPl`SVz?&6V#2SXc_Xz=ktrGpVP@^%{j)txdCI6Lqj;bQ
zlTA$XfVV#5Yf>Slm2!?HrhrOldHze7D(kRQ<d+ySR>cnfw9{Se;x$T4)~ZK->CG2{
z?={AlMED?}5J&i3UnK6XNcwdS#MbE$4#}R*el$<+MepBVGf$Ap6oa+uOE7d^bZghY
z^<?eFi+*3!$9_advhmB`{?Faj^`x<N;g=aRIBYjB97b_qfSfa7YABhIBH<%C5F&=~
zAx(%t6;Tj{A{G!vOD4vOl?KGrUU1{Zd*g+Fp%?uz{VDI>h^<%W`s7@hkho{f+H2N+
zo;9<c<&!%X(tp`^G!?1uH{?cMLh+8m;B3^9<<YifI-HKA&(RiVy7Pox2sZ1!j<0*B
zMJvoV=aKhyb7&o7e!((*t3)q%>t?LKuT;*o=x;VZw-iyDh>Tw4rShoLX;hXbv!t@h
z$4)F?zY}CUJ!DBS`buBF*<MkWO7jdq9EN;z52Kqo<s0#vYN8*OD@IxVI+w*?`Jv12
z`$|TQjeVZ$NRk6_BQ%obeNE*1q!~EW?R4bs!mokr<SVMIpd~(5%4nBu_U7K?n9(#1
z6m6TUWP7qvucj?$4|2(uFHZqIdJa!+1K>u32smqKA}2g9YJb=1beg$^O2?;|X*Sf8
zOLA|4#PjSZ+v=mQ)6h6@W@gVWVx7)N!bl>b*q0yW#;WDJT94e&-OlmrDq`ABDk)7;
zchQH@SX1|$Qf&1{S#DgQyTHB+^?apRPa=r#1WTD$A7gT(uA^9U{X&|^Je=eW1fhOm
zQ}@{>qQ{K$mP)?PT5w_rRqAT$Uy;$DM*69~W<*A0iaQ9Nec}%46s<PK0dTpPe$Vus
zUOEb3Emv@<M{wEv^VG>O#m&BAnsnQu6=VPaWHx3iVCZfO4CLc@>`|Y4tED1;23!mT
zu9|+@PDV9A(2jS@$+)+X3m<@|uC(C^Yi@CChk$`_v$c%2D>O*CAdFrHfvhFj`P;FG
zmKooK=xkE#W37ljm-L|pZ3U3~jX6*tT;+<;<%0er2?b2(C<R=ANhS<ajRO?NgTU}Z
zk#RAp0TypDk9GuDWW<cZzI$5c9aTO|q5A>ip`M_cDdFQ}(ounLk(5#pfA|^j)}S_e
z@a!4kb)A}^H<Fgz0B}}+i`4zBA^$L7eP8>lDthI)zYDwIaQ?6E4$lM5pQ&JI7&^Mg
zs==wF5Xq_=2MoGs@$Cp@*-CqJ%@08B-0^t}SqI!3fpyii(VLXRqD>!w927u(+Pfb4
zG6W3Z{TU58%TgCLh<D^JkI$cl>X@-IFm=34)jfi2L9iyW25(KQ^ui|pvrR<TH6GbK
zTzeZcQsPp`NV6pMuOOrNbRTU2K3BaCgAK#%ClE(uRCdC`Otmk<c8?%CNwD6kW&&VG
zO~2nC!oYt9{V+y2>{E}g{W8t%&K#3=Ac}2w>lAW1iDGj&&|^_<eWhB9GCL;fDbVZA
zKm(lwJpep&D5GC<xjlP<U!8Td04xR%KMVoiKq>9W4^I<6ye<HI+F5A_3I~bA29sPl
zH)S~QIYBRZ89s*s-kx^uQ@>w#(Nqqk`qf072^_QJ(hMVbTM19vdMQm5H!yQPN+x09
z$BNhG8j$Fy_A-GF19u9<_0wfuktHUXNhEf7|E+^+M$--a^|z|Pt+0f>&A2wb(Q2f`
zgZnqtODBjgK6OVEON|Wy?A(4Nf3|rzQ(Y^-_Wmy(w|Kxq-W%T7>unVSuLm=!i40t1
zkmfd45(ixRSjWmvP*|(>)7ay*y#R{%I=WI37H(U?BA-USpAsowSd2)2pe?&Q+@30q
zbOYk)O7+?W`sne#7=l!;>h`<5d5X}r7_ik!1OZqfziogRhAfUX*fLQIFKlu?+eCI<
zsS$M~1SV5oC8x8hCI0zjbS*bC)BH~V@9(QF1f5+I#M1J6=_m?f^e0S4Lt|!W+%riX
zDAcx9J3{zGWxA^Q`4f6E<JyYtS)|eyd}DfI^|L0um-}NuMJNz>jOV)fJH~4#=xgxS
zr0#R*U$u)lQ7}B!>8NrXCT#TV2goG%2}&0Zd|{P)Fi$&L5YA|9W#bl?u@LoLuBLf!
z?!^I&S*VWS&*`-)d(Ac8w-~Ld3PEd95XQ?CwZetVzgvJQI_u=!A+2sT4A##{*~#r_
z9O~8UqJO|XDL7E%VAHvK5pm?>cqCBh5)5Nm_T1+MZ?x07$wa((d7{=XW`IXO+e|u*
z_}J2p)3-R&GU?CC!`aD@DLiCNp&MRYF-`mFb)_gA*;JuR&fi(q?lpF;TiI!h&{uIF
zR_)zx=#m-6mhk1^p_bGXn3|$8)idyPK2!khM%lDo0(@qhRthj#Qof!@ZEL%mbtnfA
zVf1H)6ifMS#6k<S=a!~5AypN|H7bj=0`4EFr41(4*tVSe(&BZ5$lt?L#b#E#)_Y06
zVU<y!6OkFvGSLe!Y?6^p^2DYt7>}q$r*MgNW;?K8pHxo&=^5SacIT<T4|L3{>%nwO
zhk{^n$Jt_!nYf;o`M_tKL9~ZlYCm$oN3p`y+-G@@Y$Umk8PPu5tr!kXT|i3*FrlMo
zD^R@AB8rv|3@-@c8r<p38Gz!DAnTo2c`EUsJr-&P$}w~b%#Dti6TD5jQeY;5?z}>&
z-f_rzC~ZS1<kg4|7@aVtV}s242_{JPUGSkCN(TlsRodjNy9#BC!?%`~WOT_duBi||
z-2XGLGuNQ=8?IFt?qTqJTEd`?dF~MxTa05+BD+!k3zo>&RmG@bstLpHGJTXPsrqp@
zOE;rVtN}`EQ=7LWjX>753W0?|z}mnh*PP)!hUe<$$1$u^RBvoO)>=qfbrglMDR!Y3
z<DiDe#yv*)8xuNu%vFDQfi1b(UCax6>7mj|i=R!1mTC`~lo1aHnQ<Uq`LLP(f}g);
zkvTO@Us=<!aN73nuL1BHCLdp6<6c`2t`PWM_+$)GUpM&#0!^gl*cwz!hnsK?-?c0j
z6uk$^ctCZ;4O<pkdSR0eOSdQdVTtGgL`F?_LU5HNbU_f0{GYn3`$=5Q!=arNdTLoX
zzTmX9l1Vci;vvL{1lvGqh!6wvkr2QG0?MFpRAvytk7HQ;7&YP=^}=N1Ef@1A3>SN`
zf5iL^d%ZV%zwcYX^Rbhiz1umaSAO+v`@Bz|-v`f+`~xuh$`32<uQ57Gr}mxG4J}Dh
zQA1>1jP77_slB|0iya|&#he1Jw|hK;vpiwCqMQv!wv%;ir$Kd0SZH*ejWoOlxnne>
ztSKkD1m>nrS={ZKe)1igaQ$c^II`Z6mR1Ri_*CHB^W-KdtQp2YzemrMzZN{iOpU&*
zXr6ZaT#I$c&TW))A7uYVUntoAbS9*~6fPd+D{SHkd?bGjbo&xWMX$~=-o_JZ7;Iu%
z5~9YHn!`R<LVumk*%<?d=i}=cwhdBKp_zPW?L?*~wEPLwV;R~Rs5kYvPS4=0OELmF
z!6HT{k00Ub2m_xK=?8}+n+;uqz1QOq;qVFm3nn5x`L)g~bBX@&%;+Af3<WU108)q9
zP{m>YAcJFFhDvr|&`0Xkj_rGDsiT$3n$l8>T<w7)6mcw5i3+NSGW$Y7H}bf7272z?
zFr42_nr=Af<L-os&>4C1T9EHTj*z|5rIr>P$!QO|^`uc%j1O@DfsT>(7swe_`O=#B
zv)N#mB&$F!<AgsZoe<>zw=?K}13J_$)vpw`km=6bbg(&2Q?obphTjwhIin_d?Fnwz
zxKm2~EC6w<n<dy20D#B=7bgO#@eK5R+J_jOiasED@DM9@Ndih28?zG-T^!&tXSQcE
zmxCx+;OnmV+gQ(U3Z{Gn4Dp6Q-$dzT{#pv~_Ir8`&Auh`r(l6S|2epzv2my+?!ng$
z6>Y+;<-ZVK*iK^3&@UMz<Wc|LDN-~|*DNfy6QIkumap$q!6VIrisZ?<bc?QS@Ka_z
zX=+n2rbIJjVD#1<o6jA~901d_dqR(6h|y7zg)O=^2?JzwKioO`B*$@R_RKT|dPn0B
z;jk!9kn9!ks;Cx*bv9f9{#m-D79f`zTOvq-X*8dP7P`g^y*M+nY%&(aghPv$vP<-)
z{`iqb15x>c5VXHRc~Cci8lC(d&|ezHMm6U>jsnxE{UbX;`qF4pC_Fe2YghKUTM{KL
zQN~^aI*cu6-a(BH8T|`u!p>$BUDCjprjsFN4#ZTg(DKdqx~!~x>i+e=?no_7{#NcC
zjP1z`Cm?FU3aLG0Ly7TgL9okXmaTZgNdwn@B{auLdnNeQD|t)5Wpsm~3Os%UrDhP#
z&bSbh5K!m$xu6q5eM1@549V=WIG2y7e3pQC^qni#Ah0pe7tvcC-<CYQBT8RX(4LtL
zb8SAK60Z?4|ERyAa!qDlNG$YAF<k@{ET`hubFvzB`(ikM7cK=wN^~we4x+;S(4gxM
zO6pN2oT*7Gni~J<e!bxEQDU#x3-n5*ocDM<y#=pcdJ_@{#CsKM#M1B4{+tO4n*@?B
zW&;d7JrwZvayhTJ<lU%}zXrPTgBY}E)v2{O2xHGc7b0+V_GKVE^*kkS4jxr~W__6@
zhc!@a3u!#`3_>w(nSZ?}no*5vgI>~1>6tLS&yv`G0A0(NqRO$lnJYShG+j7=+ea+r
zO1T_7M?6v~&~?qj4_%wtv)(pBx#K{L4mJ80)`TB{$1cS7E1`5e@8vSX;@!6n^v^4w
z{&D#C0r{2oLHsbCe$dL%isb;WbI~2+7S}To=&hfZr5ca1M82_H=y70IcLMgRR;y}N
zRCSUiegXO}0y-5pBQ#s&$1Vw_OHxnZELK5(ngX?<s~Sc!@1=NEmR2hl)J;uzazM#5
zW^^6OgI~MicqqdyYSXc-_jH?`6oX~dCpIwEXX8yw7v*k!(kbQ_y=4!$duANX%#`GL
z-NDpiVTs!7n?2K4TC*5GMI}~86;AwGUeu!kfIUoYnOa=2pSP;;YE;!UHYCJ&o%Q3p
zLWxS3nJNrM5gjN_7m_YT8r6jKNiltZZh>l@oVShlnI>J>7FT+y?I^_qk~}e%F0=2U
zg3z@<?`%?0Un<Jvq|ufEZZwJ<Gd9gik_(!&{EZ^JmRY#<AJAI2sDxvH66>e57L5KL
z=wrV#hUYs+yBRMK>N;OqXjs)rbXY@`uy~0KUom!~Suw}y2$~|MCQ&e|YHKq5c1`>d
zNc;t2!V;5Ohe2_5*h29K0Q$dPeHG{!b`<3Lh*ylY_?G^Jj{32hl$g-8%$*QxI}Yn+
zc(pTkPjo?7rj{D0Aqbl&x0Er$@?mYF7X<naPT*J*Nf&H|y4O42)^{Lf+4?;(%xK*M
zPz6kQ<%}zqXRn>{9QOk1*)gNf8PQ|kmI8#X#znRMFms$+FtSczcLu2q_=HvzhJVF*
zz2X9<c;!GaraZU2BZxA}hqeM&*Qs-{RwpcMpjIe?O>()(QF{TlE%fG5*>T4UPZ*(N
zXQ*odH@C}*_IU#Wv$x7-`19;xTHH2Tib4e4h$fJ35u;OnRH?t@QWmWtq;WN+j2ZoH
zk=`-jQ%-qRQ%Pq<;cE0TAQ+4a5e6sOh#2c@_Kf~k+seA>!X#>AYlb~XyPT{Ajbxu%
zYGJR7lm&J6)Fin&fZw*ka9l?cUkpa!b+eHh7-SK)?jGe^gL?f=OE4Y0iZnw>YA=N9
z&=&9h)OiL#Mkh(j2IbRfj6PlyK3bEC9nomKBN>8EZ!1+Y4I3!FJ)mEH{tWesd!$@G
ze>(kV{m);~=uin;qM)F_8}JYX8N5zK{bXNAFRl#+KUzJs_xK>7jejE4l2BkiKCLG^
zh<H}SRCAnl$-1fC5M*XL?nkwGi~Q6j2sfS7pKnlM=1*^6;6oRNCYSJ*R_<v|+~D!4
zq9_6==AlNXEdvPj@6p?t*_PrMf0s^OL2R2&B&gB(Q!3Zzi2=J1<F@TkS;!Ra+%ed0
zDGtgbs5zAm^Jdgp(4b>wR7RhGc+veJ2q<xk_tWBrNps>s>BSUv0~y`nlV^|d#v{Ge
zc|#2H@77Z<wRbeUG%j7!L2M|paLucGU=gZg{p}FwMaqvve_MuR49}-}=)l3)@3-ou
zzk|OL;4<@Y@64~POB2|0)@3%r!1FhX^j02Xr}NI0YBE#*X76l%+DOtczOF(=cZ#;i
zx^UdkZIo%@u}G_h1`yaHrey_WVH-!X3=AJm!kWPHp#+nJ1(b-8K!ig`a<H_+HHVQh
zbJ|0a!~6q#M?0F+-g3xccMda$Xy>r?)eXB^W%kHnxPguP_1jg|_3=FKPs@)qs!HoE
zC%^Fr+v={+_`+FjaEoQ+B|D7UvYovOeNx@RUBiu@j&dYJ8@hQhQHyvL8{2Ez1Otav
zdhtNKqh!puH2k)!_}T$nv8}tTBQF%4uT#5tZ-_oX?xc;?W_qQQm|PaqB^nc?4gG*-
zr}ep$wqq;wdvvCH%(K_fas9>dm4<KRi2m2Nb04=K{N>lqMqw~#lk9xYtGT2#4WHud
zGHAZ1CHFc~8@)LB-DjO+hO@YQfBr==u??mgh?DK8bnGQ*1Mu9J?E|>Hu!E+x(PgIG
zJD({WsQN_gYU9w0qH(ol>RflpdLjzhGHSxU9o6p8fhB9iICy-14ZnQXzKXwKgBG1b
z4+0e4#pzsVJy+Lozp2jKMs3!0bM>y#COV-C&k<v?N7XOT71ynR+V*sGrYb}?5XJLO
zVI?%RGZ>qkhUYR}>1UD1LXFs816erM+%Mt$s@rliPwoZO_$slo9aBxa8S=YE(a_b_
zIa0_~$IoS*d_U?OB=)ndjfsTetg-_maTpozD;kSiQwL)XS@oG5%cI)h-L1Bq=JZZi
z=66fcD?u+ok*v|rj%wnxzw~xg&OOW<6G60|#Yfw2YNbpbx{brp%-;Oe^I^?dZ9`2*
zq{_Zf<L+j1Z!3~35bIu$P5qdDWu%a}j?DgI?8<Ch)D{X382R6yue8uKKW#PlV#eY|
zrD?{-i*aRrGMZkEtPf=HWarR;X76n^Ez}LV7}dk4VjA^g0&I@X*7VgmJ64RSC~&bi
z8#;Rp{o6Or*zq^JvZ3$2{rUBZi9Wp;WrCH|nB`;&83V7x)fHpzGEhU4#7Q5eH8R@s
z4mD+r*ipIQ#3tKV1_(};(?lC>@i(yB7BnqU22IB3c?Ph!oGc#z*lk=5f|qO7jY9dz
zBBK={6;kN4VPg`LbsfcbF}cJPRO~^`M)YUROpCH)_0i6Ed$7wX968#J*d0@8+>YT=
zIc?*k3v8y^yhO+|+9{SZB=ZuPL%FWW79k&|ZR6IaVW-#foA$tG5A^5wMj~A<X=GNE
z#b?ujeZwGjy<p?Mb=vIL$4D%*mhZxYRgdAN&L_2Gp`3K^ZXCe7*s|&wlGYM8**-eC
z%;ZseOWLq9YZ-#;uD`ii?X_@z7p8^@DXirkYcAq1;~r&WY==XIp+(Y_uB8)39}~q)
z*9^OUWETfJpc?Aij1|gx!|F}Z2x`VlZuP0uqNVgvky!b$AmD|}A)UG;<2o3zv6kEt
zsz<##X%*A;0>)!5Ks_@gk;&9!n>G4G0SCl#jtZqHeS+vaWl}2Stzt=AjjO5u6%*XJ
zkvU)k#`wNP7wrhPt&&*v>^1c0>%*V^as1XB(cl05@agxTo?@9?L1Er8ND;4HXh+H{
zxmTr6=lFh+7{s{+nSwR-kVG+|%TiTW^v=gg!sH`U(&fOqi@RtTrOGtUvYeonbnUjH
zOc)cill6>YBf6Q$nNkPL#DbMMl4q2L6`L^H5S<XjsxUsFt(x=$;X-0KKnMTOOw`uO
zBYWgRD^T?LQA>+yFRH@$v6Hdx>U5=gReM-b)XstEHGY22X2bw=48}C#WL~l52MlF3
zgG9$(G9fINvO|3-xpaFou}K<w_`IU|qGMP_@{9XkGY1M-9;O#7TC<HTbt6SWwBhla
z#cev3s5|GGp#mwL3p68Gn{7TZwxCxftj%=l`o$#POr)3MQ1OO>P}cbq;0n6H6PrXy
z@@9&QaM$M?&A`JECZufLw(zD=9AUWf+cYCA5IS?n5n>r5E5=Na>n-UW>#r9B3L4KP
zEp{Tsa3KJtb`v-jOXkM87V)uVIas^Y&NaY8Sp#F^#Slx*MvX+RYaJ{0l8I70CWXh8
z@nSNko!S=9#Eu<(1r;Tb!}b{*(ck}g_`@$ByoP@K&)0|B-+yvM7s^(XE)>I$de~t$
zG&v%K4in8`_depd2(?v-r`(=aA*<ERK*S9-Gm8%N<y3leo0yp(qzkyTd^19EH!R37
z0#u?3W(hAl!S}Av2~-1$LnV{zbWvw0GQ?>ZtV+F^icB?1Gmp+h;PSof<-m7zIEH*j
z+GLx?m9X0bWf^dA-A%=zbP?#1Gyt02aJyjG(Caims=94JRHR|<5c=c>ao3$<WEl3b
zuqSdqz?HO!+Y{)&u_B)VH&QYAXPyWUf^oi3HzRJUQTV>S*SOV_=O^ff!fimv-RaEu
zk=t%EZEa9B+fpuVsGJ7Eb@qU3)&r@?5YSa$A}zEv45eqb^Z0me02EK9!a-@aP#Qyz
z+@LDz^{b!~3J(Dxl{T-3-5^a7KT{BD{{M`L=j6fXs@d=Kt#hy$vm>0jhEC@yKm7Dz
z!aFef@$gMQ{PU+8I=vH&rXmOnwCy2j5z|FBxjYdH%7ip$u%|y~FLMHr;%{O5917_1
z9E3^36beTOyz2Z&8VWc<#B&Bnle@GKC=yzMxF{RRQbwW+a?iCu6fvU!oAsaTZMbhL
z5@*8Q7)Y|Aq3B)WZZe~kDOn~ub4)SiIS2C~j{Nb}Ke~sBk#z{5fSxc%l>CxBK}fKa
zPI^0QB)YU-Nos_@Ap{iPKGG^&fIJ%C@+_qE5@pKM3521GQ!$t^06_62c%n_=qeZH;
zC8;N<4rHpH;$OVPXk;grCf@q_wh#gmY;Y<jmBZ8C>3VfBw%;zCCptKL4Sg*`=PrBR
z_Tu}Gum9Emx37NXWR#^8`OqLXja4M1M{r(vhIElTU9dxh(|{4T{QC&JIxavuSp-;x
zvl=;INBZuNEI0vWW9BWx+YXj|9mGaeD6S+ud&onhz!N-{col-??Y^Bqs+^$5`VKoa
z;<p?K^8h!B@e<#v1ba#N39n(uyATwdF{wuf@}m{*2o%sGDDYj1dIF~d63+roQCt*0
z9<w#0Os2oL1!MvMvovw$58}omDDW_z<4GpUGkgIN1VDbrM<+BQm3K+ef1t;Lk%Swc
zR-_=scLVZNK){UziZHGK<-cO$SM7ZI_@TD81>^<K;E4Y1Yu3=ayN|mkj=Q^mroV0L
zUw!#$U%d1_OCOCQi>&zg7VqXtE(#J5krU90w?`>q%>F-$0)dL`GDzlBl2HUQN%5&7
z66OLt2R6GWLc1U>aI&<cm3?JU96`7(!Civ8L+~I$77y<3EEXJsF76QA-EDCX?ht|p
zT{O6}xJ&TMy-(`hdR4FL&9APSZ)U!pK3&yy`s;IUo-6;@{6edCK-ln$+%=T?<F@Cs
zCv$<}5=VR0TOFb0^iiu<z1V6uZSY%nYsFO^g+Q3X59LHVymKxgbsYZqt(!{Y9<3PK
z)$(zVA+0y6Hy+=?b5BFf&@LCMtEp|i_`Pj`Cj2R<0~`zGZaH^VFN0?en)9v049(kX
z=MG;F#BC!ap%DG_p5`9AUSDeyjPA~@)8YPpJ{6efnw&F7(YN!d-X+0}eBLDPxMA*v
zpYc2TJ^Tp<Pj@sRng&IX`e!Y<RBRTmgI(HT*)ll75quoVV$0Z&ke$Fm1UN(-D8V(2
zx|`$6b|s6Jv8GF9&k-fgZHmrmRnI|mle$4g>Ld7iyq4MtJBe9M5wJmM{?jS|K45>z
zYN&H+F%PkcPNr6ISeARPT<8R?$fY7DMmo7yQA9cKqXwjRL(l(}uSj10NnH>9`8&&Z
z9K;FLgG21;fJ^7K4rBN99msGz#mj{ERozC6-#rUL$IO@{$f~D?d%{|O`i(iAa7-?-
zFuJ1rcGt!$#_s|5_JOJU^Fhl?D{Gc`HXr!yX@&94Q~wnxM6AT{#>AE0+gA2^kqZkv
z9F(()O#;kNwdsks<{2In&Q1^0sJvZM_BOv>^8@aV-zD`@jcDBZIOa~E-E!B`H+6MF
zu?%ZwyhrY$B<+4aY$W7Qr&IU`@*J2Qh5?{7&TPUPmyh`o{+TX>^70ea{bU@g&hP22
zV0n`X=oGMYzu>%Bu(&ZXk;_aMsr}cD4j;-xR8UDPE~xcAp*L7iY7q<5bZQFTfxJ8_
zh@KvyBPj_MD0kQ#LJ`{$58G{u@-mbktYynCV3|23@@2iLVA!;<AoqXO0<0lF;@m<!
zqE$alr;@nXJCUIs?!)<6*Ud;sU~NV$M`vlcf0`p_!P8DjQH2ft3(gnt<e@xx@p0?!
z4S0Bf+AKDIV8eU&*;p(prrX2k+88Zl%U+0yBh2;L&C8730Q~;5=6@o%s&9YlMhwtW
z|4Q6}bM&1p%Wpad$ImhzAjrrlm=}=Ma7TldZNP*mFMna*_qltoVQF~Xp1epxY@<pJ
zXR9nvbT}naL4lnx?Tf&?z2+!Np!=cHoAxBa#DQs(Xrh2Kcn5i!7-HQj5aq`5rTGNh
z#8@^@Wzhn8*#qXxWC_lP2lY9;jPSt%jw0p|re<_T+UJm}K-i~jH3*cxl%N$4C3!}{
zk`+1JklGKSBif2O`4uzb&Z=1UQkXDnO!+Zjchm2%SsLVRa^i$mo(n5AE(9eZ9RHXc
zJp;T5r>6^w>ks~31i(C{TOyEi2vVPe--pITC`@?g>9Colwh{OS2j|Ckpp0?9A9Jv+
zD6yXMD4UA;VNI~>4UHBw;5GF2D^NP=74UnHCHkNsF+nD%7UXmUj`it5>OkJwGF@~y
z`bdFEnwS#ZcdXm$6I#%iV5R0)ERPf!2;&!U1nX_`Z6^qe%r$q@n}L+ywbAk~-;gzi
z73KHEGQ?L8jUb(@j`E0FkS-b7ecU-?1jM7r*94F3{%4J?+n0nb{HD?YKv$d%iA7vC
zi4A{m(0lT_L6eWmvwLhS(dx9Rpa*f=FUxR>GH)=Jos!Ef#*!qrU!Fg`!+0141ZSP7
zgDbMq#J;CI#ZIyolmY{^<Cg=I7N2Gvw!v_h(sayl!U3_#ItO-44;iM?9`y6Re*Qtw
z`vd-)(Ug3`k(i;s&DPNsskM!KY(k-!4nVtL2mS_;1DIyiU|yg(VN-!_EK`N9l7m&E
zz-{z--R)Z7rZaE<k_mQs=|(?Z9+(n`e~^)qae0#jI+$>~tV1?1+{TY38QZh<vMkNn
z&+hB7ZQiyrZxhl4NFeXZ+hyC%?_G#;yDt26_e=dAZaZwWT;H<b9uPXT5<6`A<teXY
z?cT)dgW}4iox4M)-OaT7YIgowOTEi<n_k`4$%(Fts1JCu{ruIow{8jAvJ!A_v&P_O
za=#hD&XBcpJg<(-m>a3?9TOaJfNzq%=F1?s+A1(QR+CUMxlhEckfZYqld7(x8062t
z@4_pw3rPJZM@${YQ@%K@_NV2m6%DnyHU3Be=c41kAl!EPTKBD&`5$st;x;+#>D?E~
zbnSP8fy=`mycj9m(gt?FX0BnqQR5jeOs8WvsyUm`Y|PY0cTJ260M;K*$jFt}FG@vx
z>audu3RMK_ja%YJ?Cq*|-~kEx?fSS@xyzep$O)$K!gKw}-@>GCx6!9arSc5JIIeT9
zgNR(+u52WN{QpuCGa(0XCw><XmMgG2%Tr*Vi_(VBUx{9LL9aeY5LVyMYd7vB{kiN+
z-D^ZnJkaL+KJAK&%dkmPw*bkD9TiVpHq6DsVFt9&GuZk|CgL&d>tm4NiF4<3j7Wt{
zyZE?kn&tjc9uIdGA}SI-mLg0d;bB~G1&EhMAET^_g^WB))~Ezi$Tq2{2~fbgx>DqR
z%q7l?loTsat_ZND*@&LD^NXA(HFcIBMh20!u_Vv4bGnyp3sH+iIDhC!%i4o$Z=?<=
z|EYF_8k*cST&8k`TT&dJX=j)HJ_J7#R0;A7e;(z>z(HJfjusBHMa1=wW!#R7GY)^6
zyyjQ{zo1Z86n1D)9^wB)JfEux9d*Ewi@rZzKteGAEcsgNL3Q3apq!Q?9Ys!ivl0Y5
z(~)0lvmCq;((qQ~P`2acQcV4ev%wCxby`gP!-0N6_?qYt@Cs{^(LYJD9$*YCZNNl>
zNQV^9pM7Qh+eDw>f3k-5PUJF$OdYv-gQg~!`nS=?;+FxkIgLm8(1C>L%}8G(Y#&nm
zH39%(_V2DcDIMVFtt&QX3K-+y>x{OM&`Y$Ubq%e1kfk@EaZ6doAO<zxAzDhoLq*e0
zx<@}Q2=-+<!r|w`BSIlXp9{!<$A6W&_Ql!vko)o;BgW+T8%{yv-wA!fdJAIXhP2G}
z#n772&p)>)O^>%eiH-kWm>{VCaCREZWOj?#LNFwDKicgFQE0kg{M$iZe6o%u`OW8-
z$!E5EZF3V=)2ci(?1ZQ8Z8$D(5(Bv)Nu2wZ7coOrOAEd}t|wT7dshG`Ah1Tx8UNC#
zpMcQW7nZNwib+7bAesoo(at+;1~(r|B|FWH{ptE9K~_s%YjTX;C3-5OneH4|x32+L
zQU?NyiRz}H^w@qJ5e%-Qw%79#kAxq#MOg6G`i%z}&7o_v4-CL1B~0_3Ze=h48+c-q
zo~wM&OXOHPL=dJnAV%$LlXMlMgCs4uGFbPw?%@oO9o3RqiK4?s|H1eOAM;^p8LThv
z?!zIL`+=tcob2_mPZzim8+!_`y3->xW)YaOx<VDWeo5U@D~+6;7T#+EBPdcZCZPIW
zuX^dTI3tx)P|P(SMG$=*GkoJ+7FB9PGTk!t)-<pqnhk}!SJrAQP)~;{O2>A7EY!nU
zty9pq8@JJ8fk8ld4EG;eu3vFa|KKE@#A`ME6XOxJXa}qQ(k4z!tOrk+1-8O|t)Rd-
z39ekGfa#uBcY5jHBA0Jx;F|8Q7b8M(J86n0%Ro-Mb3$w7;8(q<8QrxWBA9mijd6{L
zk>fbGXif>lS34<rX^U2W&g2Yll{j?Hq`j@y#oHYO!0UmW%y5G*Z|H1+CIhf=t?_W)
zv@1kM<rb5hWHN<U`GR$#CKc(AujbmETls}FbX5hXeQaAj(~mOo82{nR@7`SW$edz3
z(h#9_-5=u^QPo*P*b~?1s-L}ou0)J59@5)i5|nC~*ZNB+Ds&S{9h>L#e?8TZWWO`M
zn`Cc_J&D>8^r$3`#R*a8n~WPUkx}exz=3sSB{<ThkhNV!+`^zHl}*d?-O*}@T-yAh
zD7(5Zu>y*wCGM7`X-Q+pBakqbFHHDpKZ>e8Gt-mW;yB3RchoO(pW`z;dPhr&+h8|#
z{bp*fKoTomv?1&YUFFsRy?O=`JUuKm?JXmDc0&*P*3~etbjq*&V(4CW!{;D#b*@E^
zOt(p4ZG5+*B1Zv#8(D817V8<>RIYNJO%EIRZi}dw+d7}GT9s$aqPy1PWs`br9?uuk
z5BuPU@3xhTswC5U85}rbfH^%mySs@(#N^K=TO-87GqLUUgE)d`MtV7Uz<-gP{)rvj
zP~$sr%qK}uIJd8rr9zPvzhavx5qZg)v{mM0iP>Slm-5*ykTul-5Qf87o5!5{n7NtN
zj#je0g%(FWFr5q8ZbcLzZ40n(;$Iye?G;8F)No`t6ykH+%bmH$HH_QJ<Ja=F;waM?
zCoO?A$_P}nLw{Kx=8UF~ryTC76qmalQl`qcj&)(43O_mqbH~ZZ$Pd=jQFd54;LDuf
zxmH4twzezIU4Y5%ISVVpHh<=F%??*^bH;=oP3v!ZM)9k!9aH2TU4ruYwOPq~m^+w{
zKQf?ACJoEDJC&w1vh!_EW*S6)v%0&VI?Xd$-P7M*C!N#rxGhwevl6{*SWK1%AAc;1
zH*Wo|G#`RGtK@vAcR*t!$hF64C|GiJC_VGVVj_oDJ&U%{JM0XT*jYUyD=c#%v@1^s
zy}g#1PoADU)0r@?rlhR~yX6!)GtL8Ous6geXyH<t2V48S)O_D)aiX|t%)G1MdlBL0
zxUxEKLz0|Fa;?)Y{$)im`!MW}Y~^;YWSjQVies0-n-+9E7PHLK8kZL!!=vLzyo&R@
z6sh(QsHLN-%FDmgL)!H9-Zp+8lVD}Q&_-^qe>!H34uK^h11p^04OE<2AdLi7J^9@o
zN~nXD8&3$9b~xlmk+j`hU@U8LQTV?rVBvG~+)wn}H5c)uGa{Gr2*$&$!3PreccVaL
z4lF0n3@bmXNYZRY*M|8t&82$tFO`iVdGwTcnDOw=O3ckLT8+af5@{<5J8EgG_R-<(
z3o_}u*K@wjzYo4bFg!dT@9@LJJqE|y2eX@IYk})B>M9%W0GlCII@8bSRzAO9?>Xee
z0H)W;7LRdR3XD|j<8c2b@ptP_*qan8C)P=QRi}@;!4qIhzu7V^<-Z-DPkJ_AQ!gq9
zv9J$o=1;^`*Z$Zg+`A=es8BUXaLpVA*s;_`)!1|k4Tn?$R6`1F`wu);>pfv{mTb$}
zh?%{|AfNVH*pV#vo?KWT%5k+}4%Qet@bfbQx{Zg(w&JGFw-O3&jb1M6(Og5mVlrb*
zPL+^{pXD4U3zCCHtr%B!gQ^;x)s1zcX#cTm`O-{$`HLSiV7ap^;X*^cXJVZ=_ExbC
zBf}ephh!q)%Ul;;f0N?dL6#1!w0)oobtox7Kk52;)KQ++hpT(&0@r3Ul9z&~3+;&^
z+ku7zveUK|a^Zg^x0sU;^%mE=pvj;44t8w_qzx*GYjiNgm*#J3+^I$Oh`~YpXj&Nm
z`kbg1H$I~~jM2aCZ7MowgTnyQU^Z%CZzz`BZ#7IaaF=h3X6+>I$g&A{KqD5luqLQf
zR5Y%OS4+n1c#ec@H}DRk(zaA96>@89h12sXmb)Suji@bLZG{;9QIjEl{53!0`@E%1
zOQuatF?nB9<u+Dob-1?ZRyb7oTgtkL)QF6E&dU7f<IR4~&u|7_Ezmj*fgcMZ9xW^W
zE)egI^RK*@WjU|WNY?M^7pp<TXUTM{JMF|Dg5rkeBU4&inm-7utMa0B>!?#G2fh2~
z4mr|sI+#^=uTpO-Wz+OTMp2%$kCfSgg%;!z-6XBUZGh^L<B<XH(Qj?tmlyC#Es1UQ
zUqU7nr^c_j@@)wR=3hC#PPx76{#ZV>eG8Q;$X=C!8nLRFH2H%NHbt*K7*jv;{jSRP
zffPjepW0=i;)4ViM)O+P>;xkmE);=_zaRK7`hwq%mhu$QNmjmsaQKphggfe&HX4yy
zzz0KlSN`9!B|(J~6J^^3l1OhX9kZR^tPLXAx!rJmkT5`ozuq840Wx)+6$TfmQmxf}
zF8OR4hA=;j$|brESf=b9oPSpd5tk$wow>3FWnktZh>0v5J2HBce_JsJ{;;?^%gN^?
z_l2YN<gJTv$jg!Ka&X0;Zoye=7#`beUq^w-n-SDukGC_pVVN;D`z7nA(7`>&*UCrT
zOH3LlIW<49-rnO6#CLZ<gY=s@7MAhAd{vxKZ0}%R#ap56wk|&+_3O6AgK^u#*RdSx
zO>^8_hKKZ{z+wn6VI*NtNxr!dtrAE9VeBoa0D%YC<YFKgDgX>NIZOm5j3g2a7!C&V
zK{EUR1}p)3Zv`H}{PzHCaxh#3=6lHh4E;X>#6S_4Q~*h&|NgH35dfk7e}C+o<A(@L
zvBhW+UvJOdn81Sqg?jWcevyXr_Y>5mQtJvgbT9|f-XHh!u9jx&zKh)?ZUOJzVW(41
z+FD)D<FI(KAyXRXd*1ro9}eX0mBvmeyqqOBJRYAfIB~%t4)hf^d|~0npB|A1Z@%fv
z!xaeDYh-5ALXC6WyuO?N>##Hn2s#^3%*tGYhV!M!^g4jgVLNcS*2Y&?1EI9?|Mwqi
z<<SsmoIV60VoFDkx|eB;D2d;UB+P`lIIw$sGTU{jY6mTc9V8YePgd88=qqDNM&Dc&
z%^Q}&L5gTQY%ohs@5~3nwpS`D!pGc6!7|~BLlg%fhBB~J+3e)BPxwKisaxf&gUSoF
zP6R<bg-vc;3p%7I*{xnMca>77hmiC2W>F?IF1A_$M5OCucls{l)|48H_ZqVCviA+Z
z7<vFHe4DO&C5V2gw}w={d0Bjk74c5#VApu_oI&r3h@|jT@qhEc1*RiM_H^7ud#^|5
z9Mm6`vFt;!g}JOXkOK6o{;3^z%#l2p(0}`SbC455@d(zwC0&Y$%yZoBPK8yLF6v({
z<aoBnu98%|`Lk2m>SB!nmI;elxMa>FY>qHOX;?~?GY5j_JeXAZ<8uy{eofW+UMI`_
zCq~|}@V^1}U$79~2J2k2ZCp3r>UTrR7lUnC2v{wu#5XNiyab|-pp6gqyerjO1`0;8
zXYmi59Q#k=-TPikx26lyCG)6fI{G)ds#wfF-gpu->v(Oxh^!G-A&I+IWEx*py{dm%
zx#%Jxq?^uv(t2I7_mdWV&`&e^TNS2qPiiE#at#t&bWG^-dYH*ek7sLsmQUp?SFh3b
zUA{R=#)!yM=uI`s`$K-h0YXGXJyq^}aq?<Nwo}1Wv`My1a<JRdU_eXOS7*VStN9vq
zR<=j&-5R-G4S!n_1#Qhrl`n!^*%cePR?M5nj_^HZPYg3FZPX$4=+q5ovAIMAkTii$
z8r4Uhnsrsn_JpP!c|!_bOVTUm{q#kSA?MmvT6K#QqBihL@)LGV`XG+FY{~EHcF4g~
z6r$x2%K^_XHL98pymJe`4IXT3v};@psBCZb7YweBmMj~W^rO}So(pdO`TN0vRS1@e
zU75Sn9-&aIw~5-NE{57rXCfB;RozzYKeEow8VM&I&iL&8n+^TH_Rh{)-XxrI-CU3{
z<c6?#Hoq!;g^en|Yz)>aQm2(dkO?QS=L5#9JXt!NuDKgn^PS4Mtmpi8_4hJTf_nem
z>dDPP3~;MWt%F!oZ90L-x6)bQg8Fy9om2P_d0}mxARU}zfN%z>ovMy!N}m3x&vX)p
z9AL*&j~FEt>k+iu%LhGUFYTZN(O?hJkm^ZNMSZoVY@D!k(>bq4hhd~iGDjwC-hhAG
z<G$^r`u#(EKyy4Cu&z2j!}bxouR}7(YAXz#7kjp}J@!{V>{t(s0<R6~F!5Ch$yZkU
zPl;kqlnYWntO0l*t#z50&>8$@4bRq-4vdU92cWk`Snm?V)%=}baC_Oo#-zt1@xy=i
z_C_x+Z*Rw*;<kRCvu=*`I#J$HKKaJ^zQWzyBLYS@QxyDb6{BY>hW$)xt6(SYe#s*z
z;6!+&VXKZX;EP|;MA7e{N1)UFL^Fghx*Hrgno!phQ(cim<3`$k<A|pg4-710O8iX~
zrI#|PSMM&p8rP-<U<v%t*MdV7W{zTrts_18gf}dS&Ai`xNIk<oe|$<GNw>3mjw5dR
zbK}z=e;BnEEer0_65&4w7zIdh!}*g%&9CtNUgi9o!%4Ka!}`?@>|ixxD(s6>ZlRNx
zB>7yKA|Kz*wUiy!#}AL4aJl#cQgV$=IfHvVlR)C4(qAiaAAScKQWJcJpDG|GsSf+S
z1!Hc7?EiUz;9oaG!QDkM19!qbKcZL6Yyoo}>WA@QGmYMfHT?Lp*smYNj4SKw4p~#_
zO+7aG<2;?QX(XI@-hONX#C^S(!m&{n)=@cVVLxnM1e)qD7$Jl}ex46}*a{|LbJh1u
z*#NWmO{E)m$-8WWts0Eh>y@Z!1SUa%PC0?!roDWg8yK(g?ybk3YzeR@y}l1HFWo`P
zCIbVzZNb_;{<Ss;4#g+-7A;Srf(KvSOT&Lv%Zcyegaz?L&^V59+W5TKc}|8Al#NW!
zo0+_Co;YQ#SphyMv9e(L>ojGr@Ic*L4MO~t)Xy5w`>xr886u71&Gn3QW6g36#(Pqh
z4BEfnn|$(dFh#&qPQI8%xr9ggI{$6k`H4@VrT9EFn6(SxMkBv<b{(f{{ok?3&+b!5
zra4q~xbbwZkdG{OA2%|cDX#zGC$68AVAea80HvHbc!Coi*wB);br5v0pvhhh%JLza
z=24p4la+M5#NJ_5bF?_>?&w+I-dwI#EKL>1EB-{5b}zzeY#VASAQ6~zk<6ty5n=sS
zk3xjTFKtI2`3s>bTA5V9L$E*nd`N}OoNx-87#QCqNn-Y1*>$DjR2RY8RS>HW7?<QI
zs;*u^Ys_a5Vl~$`mb_sWkH+QivX(pht0r)RI6Xz)vzc!v)T14|e&F}hRUzpy{~jP}
z7mh3LD6{O4-kjdj%<vs5DsnCm&TVjb^*#~q1pwSkdvTcZ0I<y^B3bKf9cnp+4M#~<
zlf0!T&J@r7^-Vvb{>TJBX*%DvSFhA%?da6Q{sXUM0^Tg?)Qj@G=thc^j%62<oYUdj
z4-^Rer_a)n{5=Y_#aZgMGDkwW+E}&A#Lo_mHZs`3+p(SQa!LDG$=GbQX3|X?fv79y
zXtdT~?_?vnqz3zAJQ}ad(t1t2(Huq#9GTdOu0%s-OM|nTr&7A_vtN`1lOFg2*WKVl
zUeJa0=>1ES$%5=$)q##GZl(+8?&kq9w}ac#j_@5@)@J^8STr_FP9)DX^o!9_dMffk
zXEw}PDt>{l{vUI@)yyhIzuy;_-Bx_4CvsFy`eN0$bFUjYkAY(>TX3cpUqT`cg;LF4
zlBP25ejJOcB%s}7!duU_J4&=D*O#=u70i12Gg{FPje)_LxZscdvA}!|GLSC(E2o@g
zGY=Q3ochX(dT6iB91|vS9Kl`MKlB4fN8rrbQ{YO7B(?nnTv4xA-=?e9Eav)IoHtiF
zE?R5#wMX&2)Om|*Q^<499ZP<4vpR9(yhZtsqm8s5p|NO*&w%IOLwBt1xU)-l2Y-=S
zNOgXPJ?jAjo0+1YUz*Cq9&6vPH(m0@4r7I5`{XbNA<_ru69p+j%7R|Xcgwn#Z@%X-
zKq@A7Ixv5<E;W~?fJ%wyFTE^v$1}Qq8|ToRLL;EoLgQUzXPab<=dmc@-w$L$rp@kD
z#G65(!4<uoWr1xM0j0gBcd7a^udD*bDf|%b=PdnC3l2ZRhEIJFa<x`z$82oyr*5b?
zr9;}Yxub09byVZcV)cBvcu-%9z+bqUB#ZTc_-x988Opi(RzhN>S~1Q?vcOYYf?+L}
zEY9H0lzP5E|Hq7fR*KlC@|%B;1-t(FIy=9f0xF|#-8~H~f5<&PRIFDsq>55x1g&qx
zHG;Y~l&VkBb-z@8y%oQ7BY*EK?KJ1fVNy0TPCAR^XC8?tIO-maQo<t1H!G$xmsM_B
zg?3n|LF`Iu#h0u`yEk#p-d|RJwEGUjr{~<xS2iUCuJ8187ilGegiW#1_xCLqJj{&7
zPyQNevB~rN!XSb+e_`ObUjPERoK&1E`|t~DS%*$TTL)K+u8kib*}H;SCi??NZtA?}
z*-cx!MU@*57XahM)DxUX*SM6#=_jPFxL3jHx63>gJv6PlHp%r$Fx?;7J4CnaD{{Zz
zzjjuUdoqmTr|RfIQQ1w(<fitdM}J(}R7yBD><B^9bj)Fz_e7g3ZOKyYggP<*ZGVG#
zF?OGTesKd~?c_u-IUKFskrnSzDYB)Ubl|YV3#70cp!T0wI`h7uSte&UAJdJXa3<^X
zBuFV<eWa#&C}F^l>4ijS_O*Zu)<9~leB_p!)$G9aujxS-wIUl(zdYzm59Rc%$|8?F
z<|sUVJT3}vkjqv$n!@o-?0y0MC$F*#RDh6UW5|&#_|{uE)b0j0aSglH$B;-0mw1S%
ztuW!R`LvQU*|YAuy%jagAH2RKlqRJn*i?2xe%rmQ3MrTlf(POo<AJ57B_jmy4JHe#
zCVVCpxxQIbxs$~boLT@vp#Y@F(<z%Z2bv?4Hz`Gi#UA1UKiwF$)!ca@>&re68_FI@
z{lFIG@8;|GclgI`*;M}OPO{&cP*3}V3lMA{u2LHNF!`{Tx^1cl6_G=JcnY9Qt%_@J
zv{irU_w#rVR#AUwoZY*8U))p}`MR);l6^$^SfWZm&-uGNxSXHTNfyvvCl4kJq`>JW
z85YhU71gYF1zV<8&;?#JE4|)+q@0Y4hRNU}j9^9IL%_rd10;ZGBf#+T)UE(Jc6)R-
zp;UWXU}!)CdkXQ#Tdf>q#i$?0^zPC-eIJl*KK-Px)t(uGCYyIyg6O|ARVKP|WOi}~
zogbqGF)L8Dd`*C#zZAEUEv^U#M?#n`5vSAB2RELax6b|<cUoEH$9XuC@RbeLeK?4>
z6KK?eCB1Iu93^UhF)SsgV04YI=ubCm2upE^_GM2uj~q;IOdpHJn%=-V*fNz#T@}d^
z`;=0tm~`8wija`iibHo+vY9B7;)M@iz^%JSaW${rX1?uI?Glber4FAZ2Js9g<?xeD
z<fJZ<`u2jJ#y~m#s|GK@J;x-&X=!7HluMK3n=U;46--zF>{|FYG*%^^v9u1p;xpFo
zj$bY8#>v88o`Z+xGsi!Z&BOkhA}vXC*^}UB4^mC|rjewbQy^*BHps>oSzO-%JCLE{
zqY&?}|IBL>R+U?no!i)$JEU|J=g1>}Sl^hISTobs#xF3cmbt6P%;bc^>!9PZk%}6^
z`RO;;mme4$cWdvR#67rdD;t2dw~reu2u-UMs?A~}Dc2Gt9qO8kSP0jk&~b~m=1$$5
zr9=$a%F^myhw}~fYG&_i!VZPQ=d<|pNy6Vg!xX#Ld`7!k`6p4I$!RU67UP6uhc=&X
z$e6(|Tl@r=8&!4~Ke$>3_-xBR;tA+tWm`&dG(YcHcaaJVJgpgq1%7*K2jy464?jV+
z{bb-~j0+S7@y7;2zeTt!!1v?#%r0x~vE6Q8-8HG<Pn(xP+T5^|*(VuX4mn}g+=E#G
zS|nq~v&mgJ@V7(V*F4Q?u=P4o!>H@CPJbyyZlB`!^>$qD;ch(O06`d*g%G1ZWA9c7
zt`a@BidrAKGBIqCxx0S($TW;gw5>C8vfBK<NhK>~sI_kIfzN@xo^pL^i+C!{A?V1)
z&?Fzm`Bnl4X&%*??mt<>8u75F8F4#a04ESSKWagmN2*wT;K_$!U{H<ZB*itaX$zp)
zx|Y))vdx%8?!QbBQ#H4I#Fuy(Wq|!>o=k<raQ5_)x)8D!*_AsCdsHzl{2iYWISnUH
z(wf_JHlpi%=P29zCS+w|;v2Pa2D#BXdwMM4AOq5*-SJGv{ok6aQ`gI}^vDDw-!B@y
z*^M&8XyL*o`4rH9=Wko7nyq#etR8h!B4Poerg%1Wzc6akDRu7(qt9>ex|Tye1;0~@
z^XH&7LX6B-lL8|1KFDpJ0V5L!{Z}09rQ^oTUL6~zLb$D{9C6p4BV$HR`^p$PzxCa6
zCo+qAW{SuxF6v!xsF_#7tmJ4#^4^Fg-Y38t6pL-od8v#4BYu45_rN_7^OY9^UBJ2H
zysWI>IwG~sj{@b<daCF8Nn&6IrclT9yq2qO|ICt$iRGW$EMO=V|09FchJXl=S%SBF
z-q?sFozFzp+32WxAU1an&T183g+#%h*~ue76E)efQ|D=lOP{GO!hXXo`YHV3lInb&
z;0>z(h;;B~B@Fo3l4|70vut?Y+Y;%yNOiP_a{yd>SLKq2ve=Fpw7C^&T0P1h)yM^N
zlD!a8Nj;zrzBIyq{)c$*>72ckTnp=Vp(ak{{yCg=xPiD>c-`nJKt8wA2RL6`sdjpM
zpxxcA?Z;2}3GhlQc|F-J3VZV{w>vt9Hyb?r@sL7xbhm>qDk|!mEe@KHLsb!FrQnSv
zNM(5!N!p1xLoVq{gwzzFmPl)hwc5S#4n_eXmd8!*YC&3NS{+B4ZxY%{RZ+V7g#W5u
zOncDP@!n|^&FPC<5c#;Hqfzi><;5C<sZRW)@q)YWrmp~3G}3=AT;eI>zNI>#Ps5~{
zWQC=CTp&n7TKKf-08az)DdOETB@ZZkF(EOrAZ1i-I=9t^#~Md|;L}W5tEVAZt%|#b
ziotfv^1$B^NLjwy5+Fyqvn;Iqx)F!h4#=hPlGDijTFSER9Y<2;-|xJfG}$-8m)v|}
zh(N7|>wM~JqQGU?cSHXL@!l5$sxYK_-lwJ&D$^UO+MJO2MwBU0y0(vM0V58gBhtW$
z(pvv09iN`x`z6ZnLoC|WbfW;O(pi9TfC)y~<;LA4W0Ug<`lfb_%!$;zyUkK0idrmY
z5fSx8AKo}S{uPy>x7<jLaLSn(iM)~?QCjebAu2wrg7`;7TC}%5f?bokZ)QY0k>qbm
zV)cT_o6es{Rda}tat!xBy8^x383YwuJ1rY$iHpvm*kCGQru}r44Ilq=+*S^*J<}SK
zxy=1qe~P&8WIW+odIG(|=PM?~4%aiPM3m`<)(~unl`N>Q?{lns7vZS+xc~Y$V?DLq
zA_a%Oo@R#)+h(l(ugblNqX%}0?d@!}W0m$9wodm~eER8?bUli=N6r5XUoA`Zl*?{T
z$3xddS~Dx<qo{1?=uzrHoej6vcESODZdIDwEZlB#$vfeRPz{*%F^;AN*W-Kd#}YLT
z%6l4TVY`5~<O;f(6jf1S2PvBKn)?Mr5oT{qw41BM^*gHBXmt6ZknlUDd<oTlMTeLP
zi~SRP;rw2`C?#s|Kq_mF`lYGw5oY7lM^lf0u$_16EE#fea`UOw8hmAcFrdFP8|z(0
zrh)0Vdc@_CpbZAoXsS%<`((HhOXe4DNhQsIw{9$4Rasq5Un8lxIK%bX(5Iq8oNIhW
zkfj~CdmH@{ybZ~+O_j0dGZbSN9jmciNa(xqa(&bIDbSbGb05v8+xhuxA1W~`Xy4B?
zv6RQ8obe)sY&(OC%eVcRQ?Il#Lo}JyknJ9I9#Y-6+jQ;S`FQkBF*W>*-$nxkk4uTQ
z5&-S~u7+eew+dl&4MScl&jM~-ip62EE~1HmDNfG$gl6fZzg=Api}nCvrMStu80_Ut
zve+rV(BH3z;y&rf7m}w1qC_})?9Tf9x8ym44`u9x>7VaEfi%2LZkhCL9+f9z;nN44
zf{C`M9>*ijGOAH%EDk^EFsIJoDR3oK+mQ5^GQJmDn$G8l5H7J3GnOPXD<omk60qAZ
zw>m6TqPsQ!iZ$aKN1Wl*P}2UM5w6YXHmarmQ7%nWN?Mii^b6U?L9P_rbpl;!&PG42
zztfaUi<9}3tlU|2Dhpp#^#AhRr)pl`V7j^3#EuGi$Q9u=W`>#Z9#Rnxb&+V{GNl&J
z{VfiyWUfzPP~ui1>{E06)toMwgCDnZL!ZTnomW1-BbhY(Pt4-iAsg8xgY&Y2%3XOI
zGKrr&?E$#mIUDPOhg__8$`$(si2D+?$ncU#_b@SI#aw2k2ni*8QMTw^*rk~KuH_pw
z-Y`?e!fzz-uUF-2&233;uTP3WFokT_4(dOleHWYB`8l<ucV{u<{*Uf@bT^lY$SG~P
z_>G6w&6}KZZ)@@dFqV#@n)TV<s@=-++(k37P7g$1ZNEP9-1){}Hz5Wj#P(wzNfy0Z
z;HKXiL~V95y;s}chS=89CLT3Q5&n5pcJx6;hzV?^gv?gBcWUDs`6FlfRErX|jzNAh
z3HSgZOtkY33#e3pi#ys5)(A+$r*7R84momaecq$1Vsr$bHO7F*2HMhcavVvdb#F;V
zIfha$u;+Y03elh{Q<|^Q;C2=`d@qCH^T!CxXY&g?Wi8Ni1W~oE>8)0YTsSLBa+cdk
zvy>Hv(n;6W@3P_$`2yq!2jVWCnZg0e>l{d?zZq@C=Qv3r6tF=!y?(0Hf(zDMi8(LM
zeegk=DTi`Zz2g|YzBEY9g-$=ALpNM4EiQ}^;VT;hpz3ENYlH*&1-~(UQSqMSB3POR
z6Kqh<O|rpKzJLqV2FG$UVu209faW*F_OjYzkj$T3vobsp4w<GmK>rdK{}K7(=7hPI
z9ejU$$=1p8F|J-sn=_V}W_}^cfy+H%>@`3U`{>%dK{UXMGb+_!68OsWo;g7-;RheC
zLtx7SOJ+{~Mu}t4K^pZ6Ni2aEJPH*79A#{d9`+j7^yI@}HqTdVc!xs5Eh%<YST7G5
zpgnIZls$@y>OcjdJ{$u2HE3`$HRP04n)vos%np)=OaR3|CZ(C$pnKpnS%w-zF5FFi
z;U)-NWCHly3H~-4;o#c&Js|KNEyHvcQlU=hF>-fLKLQC_ialuUy=W^Va&=x2X-9A*
z`dkGr8aaOhgdV&W2!f#B7O&xY9^POA^)?M4qEC&`aE<hYmDATX8FqUV2`6+(BuhEa
zbtjsKz?)k@6q)dW$I7aQ$RISAsNqLn4R%JM@~5!EHnf*P<7eZr(ox77#Z<s&vVJHh
zV^_ehn83`SC7XRVJIXgEqANve@6UKQNaq1Aq(H;3oNd&wja;GjDA_U-by)u7=viCd
zsE`+m*5UJ>YlZYN6ddx5%!r;qfb;I`)aw?XPiCJ@7@<URg2VO3+v&#o+XNEKXIkHX
zThQ~37p-Z^h6iDaH&8NAh&p}){WUM)2@3NWHv_1U?Q_MHFuZ?>B*6>w|97qH^&q;s
W1(a*{%JTi^lX6nZlC@t=g8u_HIS*d|

diff --git a/doc/user/project/integrations/img/jira_api_token_menu.png b/doc/user/project/integrations/img/jira_api_token_menu.png
index 14037bd0b47722b9357f41ac36d5a78b66fc059f..1aca1d78f3647f53c99d07d8975b7755fa2acfd0 100644
GIT binary patch
literal 41876
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
QIR}1Jlr$6zZ<_i2A1(6FTmS$7

literal 25056
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

diff --git a/doc/user/project/integrations/img/jira_issue_reference.png b/doc/user/project/integrations/img/jira_issue_reference.png
index 72c81460df7017ddbfcf80982a5c8d3cead9a589..a3e80c1b054a0b7b48f090e762d7cd73c795f3ab 100644
GIT binary patch
literal 64064
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

literal 18399
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

diff --git a/doc/user/project/integrations/img/jira_merge_request_close.png b/doc/user/project/integrations/img/jira_merge_request_close.png
index 0f82ceba557f8b6821c6a1d0612a7ecb170ced3c..1c089c94207016b534f05691f5ea5e117b0e5a7e 100644
GIT binary patch
literal 64305
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

literal 21172
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

diff --git a/doc/user/project/integrations/img/jira_service_close_comment.png b/doc/user/project/integrations/img/jira_service_close_comment.png
deleted file mode 100644
index 9af0d38f098b569cc0baf9c9d975b5069ebf848e..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 11890
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

diff --git a/doc/user/project/integrations/img/jira_service_close_issue.png b/doc/user/project/integrations/img/jira_service_close_issue.png
index c85b1d1dd97c984e82110a48b4e605e5703bb1ab..73d6498192ce2e4d2edb09952005b0058d2e8979 100644
GIT binary patch
literal 29632
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
MWL0JAq|CqlZxW(<asU7T

literal 30570
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
W#j<taM)?ooBqb&<S|P0e>wg1J5Y=M<

diff --git a/doc/user/project/integrations/img/jira_service_page.png b/doc/user/project/integrations/img/jira_service_page.png
index 377b69d9d06b5984897c4c41c2d2663ade4dedd1..80dd65ea24ed9ec4cdb23d437a6f1a1e02d954fb 100644
GIT binary patch
literal 70807
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
S_uRn)K7Z&L>gJxa3;Z8QO6v>&

literal 30395
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
bOY#XjWNCt-4PT=bU|~s#%Zn9@=zsb@e0DkO

diff --git a/doc/user/project/integrations/jira.md b/doc/user/project/integrations/jira.md
index 8f2e5a55b5f..ca990ee6c32 100644
--- a/doc/user/project/integrations/jira.md
+++ b/doc/user/project/integrations/jira.md
@@ -39,21 +39,17 @@ a GitLab project with any single Jira project.
 If you have one Jira instance, you can pre-fill the settings page with a default
 template. See the [Services Templates][services-templates] docs.
 
-Configuration happens via user name and password. Connecting to a Jira Server
-via CAS is not possible.
-
-In order to enable the Jira service in GitLab, you need to first configure the
-project in Jira and then enter the correct values in GitLab.
+In order to enable the Jira service in GitLab, you need to first configure the project in Jira and then enter the correct values in GitLab.
 
 ### Configuring Jira
 
-When connecting to **Jira Server**, which supports basic authentication, a **username and password** are required. Check the link below and proceed to the next step:
+#### Jira Server
 
-- [Setting up a user in Jira Server](jira_server_configuration.md)
+When connecting to **Jira Server**, which supports basic authentication, a **username and password** are required. Note that connecting to a Jira server via CAS is not possible. [Set up a user in Jira Server](jira_server_configuration.md) first and then proceed to [Configuring GitLab](#configuring-gitlab).
 
-When connecting to **Jira Cloud**, which supports authentication via API token, an **email and API token**, are required. Check the link below and proceed to the next step:
+#### Jira Cloud
 
-- [Setting up a user in Jira Cloud](jira_cloud_configuration.md)
+When connecting to **Jira Cloud**, which supports authentication via API token, an **email and API token**, are required. [Set up a user in Jira Cloud](jira_cloud_configuration.md) first and then proceed to [Configuring GitLab](#configuring-gitlab).
 
 ### Configuring GitLab
 
@@ -68,7 +64,7 @@ When connecting to **Jira Cloud**, which supports authentication via API token,
 >   to enable Basic Auth. The cookie being added to each request is `OBBasicAuth` with
 >   a value of `fromDialog`.
 
-To enable Jira integration in a project, navigate to the
+To enable the Jira integration in a project, navigate to the
 [Integrations page](project_services.md#accessing-the-project-services), click
 the **Jira** service, and fill in the required details on the page as described
 in the table below.
@@ -127,6 +123,12 @@ ENTITY_TITLE
 
 ![example of mentioning or closing the Jira issue](img/jira_issue_reference.png)
 
+For example, the following commit will reference the Jira issue with `PROJECT-1` as its ID:
+
+```bash
+git commit -m "PROJECT-1 Fix spelling and grammar"
+```
+
 ### Closing Jira Issues
 
 Jira issues can be closed directly from GitLab by using trigger words in
@@ -142,7 +144,7 @@ the same goal:
 - `Closes PROJECT-1`
 - `Fixes PROJECT-1`
 
-where `PROJECT-1` is the issue ID of the Jira project.
+where `PROJECT-1` is the ID of the Jira issue.
 
 > **Notes:**
 >
@@ -174,8 +176,6 @@ with a link to the commit that resolved the issue.
 
 ![The GitLab integration closes Jira issue](img/jira_service_close_issue.png)
 
-![The GitLab integration creates a comment and a link on Jira issue.](img/jira_service_close_comment.png)
-
 ## Troubleshooting
 
 If these features do not work as expected, it is likely due to a problem with the way the integration settings were configured.
diff --git a/doc/user/project/integrations/jira_cloud_configuration.md b/doc/user/project/integrations/jira_cloud_configuration.md
index 614f05d5b7e..5a5ba2dd168 100644
--- a/doc/user/project/integrations/jira_cloud_configuration.md
+++ b/doc/user/project/integrations/jira_cloud_configuration.md
@@ -3,16 +3,18 @@
 An API token is needed when integrating with Jira Cloud, follow the steps
 below to create one:
 
-1. Log in to <https://id.atlassian.com> with your email.
-1. **Click API tokens**, then **Create API token**.
+1. Log in to <https://id.atlassian.com/manage/api-tokens> with your email address.
+
+   NOTE: **Note**
+   It is important that the user associated with this email address has *write* access
+   to projects in Jira.
+
+2. Click **Create API token**.
 
 ![Jira API token](img/jira_api_token_menu.png)
 
 ![Jira API token](img/jira_api_token.png)
 
-1. Make sure to write down your new API token as you will need it in the next [steps](jira.md#configuring-gitlab).
+1. Click **Copy to clipboard**, or click **View** and write down the new API token. It is required when [configuring GitLab](jira.md#configuring-gitlab).
 
-NOTE: **Note**
-It is important that the user associated with this email has 'write' access to projects in Jira.
-
-The Jira configuration is complete. You are going to need this newly created token and the email you used to log in, when [configuring GitLab in the next section](jira.md#configuring-gitlab).
+The Jira configuration is complete. You need the newly created token, and the associated email address, when [configuring GitLab](jira.md#configuring-gitlab) in the next section.

From 8fe119f4ec422c03fbf03acca0912cebcf5cc9b5 Mon Sep 17 00:00:00 2001
From: Black-Hole <158blackhole@gmail.com>
Date: Mon, 8 Jul 2019 05:50:31 +0000
Subject: [PATCH 139/195] Description of the optimized path wildcard

---
 doc/ci/yaml/README.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/doc/ci/yaml/README.md b/doc/ci/yaml/README.md
index 3e564e4244c..de04a816e8b 100644
--- a/doc/ci/yaml/README.md
+++ b/doc/ci/yaml/README.md
@@ -1057,7 +1057,7 @@ globally and all jobs will use that definition.
 #### `cache:paths`
 
 Use the `paths` directive to choose which files or directories will be cached.
-Wildcards can be used as well.
+Wildcards can be used that follow the [glob](https://en.wikipedia.org/wiki/Glob_(programming)) patterns and [filepath.Match](https://golang.org/pkg/path/filepath/#Match).
 
 Cache all files in `binaries` that end in `.apk` and the `.config` file:
 
@@ -1219,8 +1219,10 @@ be available for download in the GitLab UI.
 
 #### `artifacts:paths`
 
-You can only use paths that are within the project workspace. To pass artifacts
-between different jobs, see [dependencies](#dependencies).
+You can only use paths that are within the project workspace.
+Wildcards can be used that follow the [glob](https://en.wikipedia.org/wiki/Glob_(programming)) patterns and [filepath.Match](https://golang.org/pkg/path/filepath/#Match).
+
+To pass artifacts between different jobs, see [dependencies](#dependencies).
 
 Send all files in `binaries` and `.config`:
 

From 3bc76511a066626c06d3d3b76d78e928770c46e0 Mon Sep 17 00:00:00 2001
From: Thong Kuah <tkuah@gitlab.com>
Date: Mon, 8 Jul 2019 06:03:09 +0000
Subject: [PATCH 140/195] Create CTE query for clusters hierarchy

- This enables us to use a scope to query all clusters in group
hierarchy order in one query, and also enables us to union to instance
clusters later.

- Handle case where clusters not present at level. In which case the
query should go ahead and return the next level's clusters.

- Swap with new CTE query behind Feature flag. This FF is default
disabled.
---
 app/models/clusters/clusters_hierarchy.rb     | 104 ++++++++++++++++++
 app/models/concerns/deployment_platform.rb    |  19 +++-
 changelogs/unreleased/clusters-group-cte.yml  |   5 +
 .../clusters/clusters_hierarchy_spec.rb       |  73 ++++++++++++
 .../concerns/deployment_platform_spec.rb      |  18 ++-
 5 files changed, 216 insertions(+), 3 deletions(-)
 create mode 100644 app/models/clusters/clusters_hierarchy.rb
 create mode 100644 changelogs/unreleased/clusters-group-cte.yml
 create mode 100644 spec/models/clusters/clusters_hierarchy_spec.rb

diff --git a/app/models/clusters/clusters_hierarchy.rb b/app/models/clusters/clusters_hierarchy.rb
new file mode 100644
index 00000000000..dab034b7234
--- /dev/null
+++ b/app/models/clusters/clusters_hierarchy.rb
@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Clusters
+  class ClustersHierarchy
+    DEPTH_COLUMN = :depth
+
+    def initialize(clusterable)
+      @clusterable = clusterable
+    end
+
+    # Returns clusters in order from deepest to highest group
+    def base_and_ancestors
+      cte = recursive_cte
+      cte_alias = cte.table.alias(model.table_name)
+
+      model
+        .unscoped
+        .where('clusters.id IS NOT NULL')
+        .with
+        .recursive(cte.to_arel)
+        .from(cte_alias)
+        .order(DEPTH_COLUMN => :asc)
+    end
+
+    private
+
+    attr_reader :clusterable
+
+    def recursive_cte
+      cte = Gitlab::SQL::RecursiveCTE.new(:clusters_cte)
+
+      base_query = case clusterable
+                   when ::Group
+                     group_clusters_base_query
+                   when ::Project
+                     project_clusters_base_query
+                   else
+                     raise ArgumentError, "unknown type for #{clusterable}"
+                   end
+
+      cte << base_query
+      cte << parent_query(cte)
+
+      cte
+    end
+
+    def group_clusters_base_query
+      group_parent_id_alias = alias_as_column(groups[:parent_id], 'group_parent_id')
+      join_sources = ::Group.left_joins(:clusters).join_sources
+
+      model
+        .unscoped
+        .select([clusters_star, group_parent_id_alias, "1 AS #{DEPTH_COLUMN}"])
+        .where(groups[:id].eq(clusterable.id))
+        .from(groups)
+        .joins(join_sources)
+    end
+
+    def project_clusters_base_query
+      projects = ::Project.arel_table
+      project_parent_id_alias = alias_as_column(projects[:namespace_id], 'group_parent_id')
+      join_sources = ::Project.left_joins(:clusters).join_sources
+
+      model
+        .unscoped
+        .select([clusters_star, project_parent_id_alias, "1 AS #{DEPTH_COLUMN}"])
+        .where(projects[:id].eq(clusterable.id))
+        .from(projects)
+        .joins(join_sources)
+    end
+
+    def parent_query(cte)
+      group_parent_id_alias = alias_as_column(groups[:parent_id], 'group_parent_id')
+
+      model
+        .unscoped
+        .select([clusters_star, group_parent_id_alias, cte.table[DEPTH_COLUMN] + 1])
+        .from([cte.table, groups])
+        .joins('LEFT OUTER JOIN cluster_groups ON cluster_groups.group_id = namespaces.id')
+        .joins('LEFT OUTER JOIN clusters ON cluster_groups.cluster_id = clusters.id')
+        .where(groups[:id].eq(cte.table[:group_parent_id]))
+    end
+
+    def model
+      Clusters::Cluster
+    end
+
+    def clusters
+      @clusters ||= model.arel_table
+    end
+
+    def groups
+      @groups ||= ::Group.arel_table
+    end
+
+    def clusters_star
+      @clusters_star ||= clusters[Arel.star]
+    end
+
+    def alias_as_column(value, alias_to)
+      Arel::Nodes::As.new(value, Arel::Nodes::SqlLiteral.new(alias_to))
+    end
+  end
+end
diff --git a/app/models/concerns/deployment_platform.rb b/app/models/concerns/deployment_platform.rb
index 5a358ae2ef6..8f28c897eb6 100644
--- a/app/models/concerns/deployment_platform.rb
+++ b/app/models/concerns/deployment_platform.rb
@@ -12,11 +12,26 @@ module DeploymentPlatform
   private
 
   def find_deployment_platform(environment)
-    find_cluster_platform_kubernetes(environment: environment) ||
-      find_group_cluster_platform_kubernetes(environment: environment) ||
+    find_platform_kubernetes(environment) ||
       find_instance_cluster_platform_kubernetes(environment: environment)
   end
 
+  def find_platform_kubernetes(environment)
+    if Feature.enabled?(:clusters_cte)
+      find_platform_kubernetes_with_cte(environment)
+    else
+      find_cluster_platform_kubernetes(environment: environment) ||
+        find_group_cluster_platform_kubernetes(environment: environment)
+    end
+  end
+
+  # EE would override this and utilize environment argument
+  def find_platform_kubernetes_with_cte(_environment)
+    Clusters::ClustersHierarchy.new(self).base_and_ancestors
+      .enabled.default_environment
+      .first&.platform_kubernetes
+  end
+
   # EE would override this and utilize environment argument
   def find_cluster_platform_kubernetes(environment: nil)
     clusters.enabled.default_environment
diff --git a/changelogs/unreleased/clusters-group-cte.yml b/changelogs/unreleased/clusters-group-cte.yml
new file mode 100644
index 00000000000..4b51249062d
--- /dev/null
+++ b/changelogs/unreleased/clusters-group-cte.yml
@@ -0,0 +1,5 @@
+---
+title: Use CTE to fetch clusters hierarchy in single query
+merge_request: 30063
+author:
+type: performance
diff --git a/spec/models/clusters/clusters_hierarchy_spec.rb b/spec/models/clusters/clusters_hierarchy_spec.rb
new file mode 100644
index 00000000000..0470ebe17ea
--- /dev/null
+++ b/spec/models/clusters/clusters_hierarchy_spec.rb
@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Clusters::ClustersHierarchy do
+  describe '#base_and_ancestors' do
+    def base_and_ancestors(clusterable)
+      described_class.new(clusterable).base_and_ancestors
+    end
+
+    context 'project in nested group with clusters at every level' do
+      let!(:cluster) { create(:cluster, :project, projects: [project]) }
+      let!(:child) { create(:cluster, :group, groups: [child_group]) }
+      let!(:parent) { create(:cluster, :group, groups: [parent_group]) }
+      let!(:ancestor) { create(:cluster, :group, groups: [ancestor_group]) }
+
+      let(:ancestor_group) { create(:group) }
+      let(:parent_group) { create(:group, parent: ancestor_group) }
+      let(:child_group) { create(:group, parent: parent_group) }
+      let(:project) { create(:project, group: child_group) }
+
+      it 'returns clusters for project' do
+        expect(base_and_ancestors(project)).to eq([cluster, child, parent, ancestor])
+      end
+
+      it 'returns clusters for child_group' do
+        expect(base_and_ancestors(child_group)).to eq([child, parent, ancestor])
+      end
+
+      it 'returns clusters for parent_group' do
+        expect(base_and_ancestors(parent_group)).to eq([parent, ancestor])
+      end
+
+      it 'returns clusters for ancestor_group' do
+        expect(base_and_ancestors(ancestor_group)).to eq([ancestor])
+      end
+    end
+
+    context 'project in a namespace' do
+      let!(:cluster) { create(:cluster, :project) }
+
+      it 'returns clusters for project' do
+        expect(base_and_ancestors(cluster.project)).to eq([cluster])
+      end
+    end
+
+    context 'project in nested group with clusters at some levels' do
+      let!(:child) { create(:cluster, :group, groups: [child_group]) }
+      let!(:ancestor) { create(:cluster, :group, groups: [ancestor_group]) }
+
+      let(:ancestor_group) { create(:group) }
+      let(:parent_group) { create(:group, parent: ancestor_group) }
+      let(:child_group) { create(:group, parent: parent_group) }
+      let(:project) { create(:project, group: child_group) }
+
+      it 'returns clusters for project' do
+        expect(base_and_ancestors(project)).to eq([child, ancestor])
+      end
+
+      it 'returns clusters for child_group' do
+        expect(base_and_ancestors(child_group)).to eq([child, ancestor])
+      end
+
+      it 'returns clusters for parent_group' do
+        expect(base_and_ancestors(parent_group)).to eq([ancestor])
+      end
+
+      it 'returns clusters for ancestor_group' do
+        expect(base_and_ancestors(ancestor_group)).to eq([ancestor])
+      end
+    end
+  end
+end
diff --git a/spec/models/concerns/deployment_platform_spec.rb b/spec/models/concerns/deployment_platform_spec.rb
index 2378f400540..e2fc8a5d127 100644
--- a/spec/models/concerns/deployment_platform_spec.rb
+++ b/spec/models/concerns/deployment_platform_spec.rb
@@ -5,7 +5,7 @@ require 'rails_helper'
 describe DeploymentPlatform do
   let(:project) { create(:project) }
 
-  describe '#deployment_platform' do
+  shared_examples '#deployment_platform' do
     subject { project.deployment_platform }
 
     context 'with no Kubernetes configuration on CI/CD, no Kubernetes Service' do
@@ -84,4 +84,20 @@ describe DeploymentPlatform do
       end
     end
   end
+
+  context 'legacy implementation' do
+    before do
+      stub_feature_flags(clusters_cte: false)
+    end
+
+    include_examples '#deployment_platform'
+  end
+
+  context 'CTE implementation' do
+    before do
+      stub_feature_flags(clusters_cte: true)
+    end
+
+    include_examples '#deployment_platform'
+  end
 end

From f8d6f7322ea43ff7844d006885db9f0c36ad7cc9 Mon Sep 17 00:00:00 2001
From: Shinya Maeda <shinya@gitlab.com>
Date: Tue, 2 Jul 2019 09:01:36 +0700
Subject: [PATCH 141/195] Fix race condition on merge train ref generation

Today, Pipelines for merge train run on `refs/merge`,
however, this causes a race condition that it can be
overwritten by CheckMergeabilityService.

This patch fixes the problem by generating `refs/train`
for those pipelines.
---
 app/models/merge_request.rb                   | 13 ++++++++
 app/models/repository.rb                      |  4 +++
 spec/models/merge_request_spec.rb             | 30 +++++++++++++++++++
 .../merge_to_ref_service_spec.rb              |  9 ++++++
 4 files changed, 56 insertions(+)

diff --git a/app/models/merge_request.rb b/app/models/merge_request.rb
index e96e26cc773..53977748c30 100644
--- a/app/models/merge_request.rb
+++ b/app/models/merge_request.rb
@@ -1127,6 +1127,19 @@ class MergeRequest < ApplicationRecord
     "refs/#{Repository::REF_MERGE_REQUEST}/#{iid}/merge"
   end
 
+  def train_ref_path
+    "refs/#{Repository::REF_MERGE_REQUEST}/#{iid}/train"
+  end
+
+  def cleanup_refs(only: :all)
+    target_refs = []
+    target_refs << ref_path       if %i[all head].include?(only)
+    target_refs << merge_ref_path if %i[all merge].include?(only)
+    target_refs << train_ref_path if %i[all train].include?(only)
+
+    project.repository.delete_refs(*target_refs)
+  end
+
   def self.merge_request_ref?(ref)
     ref.start_with?("refs/#{Repository::REF_MERGE_REQUEST}/")
   end
diff --git a/app/models/repository.rb b/app/models/repository.rb
index a408db7ebbe..a25d5abfa64 100644
--- a/app/models/repository.rb
+++ b/app/models/repository.rb
@@ -845,6 +845,10 @@ class Repository
     raw.merge_to_ref(user, source_sha, branch, target_ref, message, first_parent_ref)
   end
 
+  def delete_refs(*ref_names)
+    raw.delete_refs(*ref_names)
+  end
+
   def ff_merge(user, source, target_branch, merge_request: nil)
     their_commit_id = commit(source)&.id
     raise 'Invalid merge source' if their_commit_id.nil?
diff --git a/spec/models/merge_request_spec.rb b/spec/models/merge_request_spec.rb
index fe6d68aff3f..9b0c232f370 100644
--- a/spec/models/merge_request_spec.rb
+++ b/spec/models/merge_request_spec.rb
@@ -3220,4 +3220,34 @@ describe MergeRequest do
       it { is_expected.to be_truthy }
     end
   end
+
+  describe '#cleanup_refs' do
+    subject { merge_request.cleanup_refs(only: only) }
+
+    let(:merge_request) { build(:merge_request) }
+
+    context 'when removing all refs' do
+      let(:only) { :all }
+
+      it 'deletes all refs from the target project' do
+        expect(merge_request.target_project.repository)
+          .to receive(:delete_refs)
+          .with(merge_request.ref_path, merge_request.merge_ref_path, merge_request.train_ref_path)
+
+        subject
+      end
+    end
+
+    context 'when removing only train ref' do
+      let(:only) { :train }
+
+      it 'deletes train ref from the target project' do
+        expect(merge_request.target_project.repository)
+          .to receive(:delete_refs)
+          .with(merge_request.train_ref_path)
+
+        subject
+      end
+    end
+  end
 end
diff --git a/spec/services/merge_requests/merge_to_ref_service_spec.rb b/spec/services/merge_requests/merge_to_ref_service_spec.rb
index e2f201677fa..14012b4ea2d 100644
--- a/spec/services/merge_requests/merge_to_ref_service_spec.rb
+++ b/spec/services/merge_requests/merge_to_ref_service_spec.rb
@@ -191,6 +191,15 @@ describe MergeRequests::MergeToRefService do
       it { expect(todo).not_to be_done }
     end
 
+    context 'when target ref is passed as a parameter' do
+      let(:params) { { commit_message: 'merge train', target_ref: target_ref } }
+
+      it_behaves_like 'successfully merges to ref with merge method' do
+        let(:first_parent_ref) { 'refs/heads/master' }
+        let(:target_ref) { 'refs/merge-requests/1/train' }
+      end
+    end
+
     describe 'cascading merge refs' do
       set(:project) { create(:project, :repository) }
       let(:params) { { commit_message: 'Cascading merge', first_parent_ref: first_parent_ref, target_ref: target_ref } }

From d14cc985b5f608b7cf6b060595abf0d647707055 Mon Sep 17 00:00:00 2001
From: Ezekiel Kigbo <ekigbo@gitlab.com>
Date: Mon, 8 Jul 2019 08:20:45 +0000
Subject: [PATCH 142/195] Vue-i18n:
 app/assets/javascripts/vue_merge_request_widget directory

i18n linting for .vue files under the
app/assets/javascripts/vue_merge_request_widget directory
---
 .../components/deployment.vue                 |  4 +-
 .../components/mr_widget_header.vue           |  2 +-
 .../states/mr_widget_auto_merge_enabled.vue   | 13 +++---
 .../components/states/mr_widget_rebase.vue    | 43 +++++++++++--------
 .../components/states/nothing_to_merge.vue    | 30 ++++++++-----
 .../components/states/ready_to_merge.vue      |  2 +-
 .../components/states/work_in_progress.vue    | 20 ++++++---
 .../mr_widget_options.vue                     |  7 ++-
 locale/gitlab.pot                             | 42 ++++++++++++++++++
 9 files changed, 117 insertions(+), 46 deletions(-)

diff --git a/app/assets/javascripts/vue_merge_request_widget/components/deployment.vue b/app/assets/javascripts/vue_merge_request_widget/components/deployment.vue
index 34cdb70ce14..5c7859828d8 100644
--- a/app/assets/javascripts/vue_merge_request_widget/components/deployment.vue
+++ b/app/assets/javascripts/vue_merge_request_widget/components/deployment.vue
@@ -125,7 +125,9 @@ export default {
             this.isStopping = false;
           })
           .catch(() => {
-            createFlash('Something went wrong while stopping this environment. Please try again.');
+            createFlash(
+              __('Something went wrong while stopping this environment. Please try again.'),
+            );
             this.isStopping = false;
           });
       }
diff --git a/app/assets/javascripts/vue_merge_request_widget/components/mr_widget_header.vue b/app/assets/javascripts/vue_merge_request_widget/components/mr_widget_header.vue
index e20a16900d4..fb826be19f5 100644
--- a/app/assets/javascripts/vue_merge_request_widget/components/mr_widget_header.vue
+++ b/app/assets/javascripts/vue_merge_request_widget/components/mr_widget_header.vue
@@ -139,7 +139,7 @@ export default {
             type="button"
             class="btn dropdown-toggle qa-dropdown-toggle"
             data-toggle="dropdown"
-            aria-label="Download as"
+            :aria-label="__('Download as')"
             aria-haspopup="true"
             aria-expanded="false"
           >
diff --git a/app/assets/javascripts/vue_merge_request_widget/components/states/mr_widget_auto_merge_enabled.vue b/app/assets/javascripts/vue_merge_request_widget/components/states/mr_widget_auto_merge_enabled.vue
index 5958c2cf87e..8e8e67228ed 100644
--- a/app/assets/javascripts/vue_merge_request_widget/components/states/mr_widget_auto_merge_enabled.vue
+++ b/app/assets/javascripts/vue_merge_request_widget/components/states/mr_widget_auto_merge_enabled.vue
@@ -6,6 +6,7 @@ import statusIcon from '../mr_widget_status_icon.vue';
 import MrWidgetAuthor from '../../components/mr_widget_author.vue';
 import eventHub from '../../event_hub';
 import { AUTO_MERGE_STRATEGIES } from '../../constants';
+import { __ } from '~/locale';
 
 export default {
   name: 'MRWidgetAutoMergeEnabled',
@@ -55,7 +56,7 @@ export default {
         })
         .catch(() => {
           this.isCancellingAutoMerge = false;
-          Flash('Something went wrong. Please try again.');
+          Flash(__('Something went wrong. Please try again.'));
         });
     },
     removeSourceBranch() {
@@ -76,7 +77,7 @@ export default {
         })
         .catch(() => {
           this.isRemovingSourceBranch = false;
-          Flash('Something went wrong. Please try again.');
+          Flash(__('Something went wrong. Please try again.'));
         });
     },
   },
@@ -107,15 +108,15 @@ export default {
       <section class="mr-info-list">
         <p>
           {{ s__('mrWidget|The changes will be merged into') }}
-          <a :href="mr.targetBranchPath" class="label-branch"> {{ mr.targetBranch }} </a>
+          <a :href="mr.targetBranchPath" class="label-branch">{{ mr.targetBranch }}</a>
         </p>
         <p v-if="mr.shouldRemoveSourceBranch">
           {{ s__('mrWidget|The source branch will be deleted') }}
         </p>
         <p v-else class="d-flex align-items-start">
-          <span class="append-right-10">
-            {{ s__('mrWidget|The source branch will not be deleted') }}
-          </span>
+          <span class="append-right-10">{{
+            s__('mrWidget|The source branch will not be deleted')
+          }}</span>
           <a
             v-if="canRemoveSourceBranch"
             :disabled="isRemovingSourceBranch"
diff --git a/app/assets/javascripts/vue_merge_request_widget/components/states/mr_widget_rebase.vue b/app/assets/javascripts/vue_merge_request_widget/components/states/mr_widget_rebase.vue
index 0bcccc50eb2..c7b064b8506 100644
--- a/app/assets/javascripts/vue_merge_request_widget/components/states/mr_widget_rebase.vue
+++ b/app/assets/javascripts/vue_merge_request_widget/components/states/mr_widget_rebase.vue
@@ -4,6 +4,7 @@ import simplePoll from '../../../lib/utils/simple_poll';
 import eventHub from '../../event_hub';
 import statusIcon from '../mr_widget_status_icon.vue';
 import Flash from '../../../flash';
+import { __, sprintf } from '~/locale';
 
 export default {
   name: 'MRWidgetRebase',
@@ -40,6 +41,17 @@ export default {
     showDisabledButton() {
       return ['failed', 'loading'].includes(this.status);
     },
+    fastForwardMergeText() {
+      return sprintf(
+        __(
+          `Fast-forward merge is not possible. Rebase the source branch onto %{startTag}${this.mr.targetBranch}%{endTag} to allow this merge request to be merged.`,
+        ),
+        {
+          startTag: '<span class="label-branch">',
+          endTag: '</span>',
+        },
+      );
+    },
   },
   methods: {
     rebase() {
@@ -54,7 +66,7 @@ export default {
         .catch(error => {
           this.rebasingError = error.merge_error;
           this.isMakingRequest = false;
-          Flash('Something went wrong. Please try again.');
+          Flash(__('Something went wrong. Please try again.'));
         });
     },
     checkRebaseStatus(continuePolling, stopPolling) {
@@ -69,7 +81,7 @@ export default {
 
             if (res.merge_error && res.merge_error.length) {
               this.rebasingError = res.merge_error;
-              Flash('Something went wrong. Please try again.');
+              Flash(__('Something went wrong. Please try again.'));
             }
 
             eventHub.$emit('MRWidgetRebaseSuccess');
@@ -78,7 +90,7 @@ export default {
         })
         .catch(() => {
           this.isMakingRequest = false;
-          Flash('Something went wrong. Please try again.');
+          Flash(__('Something went wrong. Please try again.'));
           stopPolling();
         });
     },
@@ -91,19 +103,14 @@ export default {
 
     <div class="rebase-state-find-class-convention media media-body space-children">
       <template v-if="mr.rebaseInProgress || isMakingRequest">
-        <span class="bold"> Rebase in progress </span>
+        <span class="bold">{{ __('Rebase in progress') }}</span>
       </template>
       <template v-if="!mr.rebaseInProgress && !mr.canPushToSourceBranch">
-        <span class="bold">
-          Fast-forward merge is not possible. Rebase the source branch onto
-          <span class="label-branch">{{ mr.targetBranch }}</span> to allow this merge request to be
-          merged.
-        </span>
+        <span class="bold" v-html="fastForwardMergeText"></span>
       </template>
       <template v-if="!mr.rebaseInProgress && mr.canPushToSourceBranch && !isMakingRequest">
         <div
-          class="accept-merge-holder clearfix
-js-toggle-container accept-action media space-children"
+          class="accept-merge-holder clearfix js-toggle-container accept-action media space-children"
         >
           <button
             :disabled="isMakingRequest"
@@ -111,14 +118,14 @@ js-toggle-container accept-action media space-children"
             class="btn btn-sm btn-reopen btn-success qa-mr-rebase-button"
             @click="rebase"
           >
-            <gl-loading-icon v-if="isMakingRequest" />
-            Rebase
+            <gl-loading-icon v-if="isMakingRequest" />{{ __('Rebase') }}
           </button>
-          <span v-if="!rebasingError" class="bold">
-            Fast-forward merge is not possible. Rebase the source branch onto the target branch or
-            merge target branch into source branch to allow this merge request to be merged.
-          </span>
-          <span v-else class="bold danger"> {{ rebasingError }} </span>
+          <span v-if="!rebasingError" class="bold">{{
+            __(
+              'Fast-forward merge is not possible. Rebase the source branch onto the target branch or merge target branch into source branch to allow this merge request to be merged.',
+            )
+          }}</span>
+          <span v-else class="bold danger">{{ rebasingError }}</span>
         </div>
       </template>
     </div>
diff --git a/app/assets/javascripts/vue_merge_request_widget/components/states/nothing_to_merge.vue b/app/assets/javascripts/vue_merge_request_widget/components/states/nothing_to_merge.vue
index a38495bb4cc..7312b31c01c 100644
--- a/app/assets/javascripts/vue_merge_request_widget/components/states/nothing_to_merge.vue
+++ b/app/assets/javascripts/vue_merge_request_widget/components/states/nothing_to_merge.vue
@@ -22,19 +22,29 @@ export default {
         <span v-html="emptyStateSVG"></span>
       </div>
       <div class="text col-md-7 order-md-first col-12">
-        <span>
-          Merge requests are a place to propose changes you have made to a project and discuss those
-          changes with others.
-        </span>
-        <p>Interested parties can even contribute by pushing commits if they want to.</p>
+        <span>{{
+          s__(
+            'mrWidgetNothingToMerge|Merge requests are a place to propose changes you have made to a project and discuss those changes with others.',
+          )
+        }}</span>
         <p>
-          Currently there are no changes in this merge request's source branch. Please push new
-          commits or use a different branch.
+          {{
+            s__(
+              'mrWidgetNothingToMerge|Interested parties can even contribute by pushing commits if they want to.',
+            )
+          }}
+        </p>
+        <p>
+          {{
+            s__(
+              "mrWidgetNothingToMerge|Currently there are no changes in this merge request's source branch. Please push new commits or use a different branch.",
+            )
+          }}
         </p>
         <div>
-          <a v-if="mr.newBlobPath" :href="mr.newBlobPath" class="btn btn-inverted btn-success">
-            Create file
-          </a>
+          <a v-if="mr.newBlobPath" :href="mr.newBlobPath" class="btn btn-inverted btn-success">{{
+            __('Create file')
+          }}</a>
         </div>
       </div>
     </div>
diff --git a/app/assets/javascripts/vue_merge_request_widget/components/states/ready_to_merge.vue b/app/assets/javascripts/vue_merge_request_widget/components/states/ready_to_merge.vue
index ca1b4a57717..d1f75593d14 100644
--- a/app/assets/javascripts/vue_merge_request_widget/components/states/ready_to_merge.vue
+++ b/app/assets/javascripts/vue_merge_request_widget/components/states/ready_to_merge.vue
@@ -248,7 +248,7 @@ export default {
               type="button"
               class="btn btn-sm btn-info dropdown-toggle js-merge-moment"
               data-toggle="dropdown"
-              aria-label="Select merge moment"
+              :aria-label="__('Select merge moment')"
             >
               <i class="fa fa-chevron-down qa-merge-moment-dropdown" aria-hidden="true"></i>
             </button>
diff --git a/app/assets/javascripts/vue_merge_request_widget/components/states/work_in_progress.vue b/app/assets/javascripts/vue_merge_request_widget/components/states/work_in_progress.vue
index 7c322388d30..91c0b40a0b5 100644
--- a/app/assets/javascripts/vue_merge_request_widget/components/states/work_in_progress.vue
+++ b/app/assets/javascripts/vue_merge_request_widget/components/states/work_in_progress.vue
@@ -46,14 +46,20 @@ export default {
     <status-icon :show-disabled-button="Boolean(mr.removeWIPPath)" status="warning" />
     <div class="media-body space-children">
       <span class="bold">
-        This is a Work in Progress
+        {{ __('This is a Work in Progress') }}
         <i
           v-tooltip
           class="fa fa-question-circle"
-          title="When this merge request is ready,
-          remove the WIP: prefix from the title to allow it to be merged"
-          aria-label="When this merge request is ready,
-          remove the WIP: prefix from the title to allow it to be merged"
+          :title="
+            s__(
+              'mrWidget|When this merge request is ready, remove the WIP: prefix from the title to allow it to be merged',
+            )
+          "
+          :aria-label="
+            s__(
+              'mrWidget|When this merge request is ready, remove the WIP: prefix from the title to allow it to be merged',
+            )
+          "
         >
         </i>
       </span>
@@ -64,8 +70,8 @@ export default {
         class="btn btn-default btn-sm js-remove-wip"
         @click="removeWIP"
       >
-        <i v-if="isMakingRequest" class="fa fa-spinner fa-spin" aria-hidden="true"> </i> Resolve WIP
-        status
+        <i v-if="isMakingRequest" class="fa fa-spinner fa-spin" aria-hidden="true"> </i>
+        {{ s__('mrWidget|Resolve WIP status') }}
       </button>
     </div>
   </div>
diff --git a/app/assets/javascripts/vue_merge_request_widget/mr_widget_options.vue b/app/assets/javascripts/vue_merge_request_widget/mr_widget_options.vue
index a79da476890..8d415c1bbea 100644
--- a/app/assets/javascripts/vue_merge_request_widget/mr_widget_options.vue
+++ b/app/assets/javascripts/vue_merge_request_widget/mr_widget_options.vue
@@ -263,8 +263,11 @@ export default {
       if (!data.pipeline) return;
 
       const { label } = data.pipeline.details.status;
-      const title = `Pipeline ${label}`;
-      const message = `Pipeline ${label} for "${data.title}"`;
+      const title = sprintf(__('Pipeline %{label}'), { label });
+      const message = sprintf(__('Pipeline %{label} for "%{dataTitle}"'), {
+        dataTitle: data.title,
+        label,
+      });
 
       notify.notifyMe(title, message, this.mr.gitlabLogo);
     },
diff --git a/locale/gitlab.pot b/locale/gitlab.pot
index 78bf48d66fc..1635faf312c 100644
--- a/locale/gitlab.pot
+++ b/locale/gitlab.pot
@@ -3796,6 +3796,9 @@ msgstr ""
 msgid "Download artifacts"
 msgstr ""
 
+msgid "Download as"
+msgstr ""
+
 msgid "Download asset"
 msgstr ""
 
@@ -4615,6 +4618,9 @@ msgstr ""
 msgid "Failure"
 msgstr ""
 
+msgid "Fast-forward merge is not possible. Rebase the source branch onto the target branch or merge target branch into source branch to allow this merge request to be merged."
+msgstr ""
+
 msgid "Fast-forward merge without a merge commit"
 msgstr ""
 
@@ -7360,6 +7366,12 @@ msgstr ""
 msgid "Pipeline"
 msgstr ""
 
+msgid "Pipeline %{label}"
+msgstr ""
+
+msgid "Pipeline %{label} for \"%{dataTitle}\""
+msgstr ""
+
 msgid "Pipeline Schedule"
 msgstr ""
 
@@ -8584,6 +8596,12 @@ msgstr ""
 msgid "Real-time features"
 msgstr ""
 
+msgid "Rebase"
+msgstr ""
+
+msgid "Rebase in progress"
+msgstr ""
+
 msgid "Receive notifications about your own activity"
 msgstr ""
 
@@ -9248,6 +9266,9 @@ msgstr ""
 msgid "Select members to invite"
 msgstr ""
 
+msgid "Select merge moment"
+msgstr ""
+
 msgid "Select private project"
 msgstr ""
 
@@ -9697,6 +9718,9 @@ msgstr ""
 msgid "Something went wrong while resolving this discussion. Please try again."
 msgstr ""
 
+msgid "Something went wrong while stopping this environment. Please try again."
+msgstr ""
+
 msgid "Something went wrong, unable to search projects"
 msgstr ""
 
@@ -10740,6 +10764,9 @@ msgstr ""
 msgid "This is a \"Ghost User\", created to hold all issues authored by users that have since been deleted. This user cannot be removed."
 msgstr ""
 
+msgid "This is a Work in Progress"
+msgstr ""
+
 msgid "This is a confidential issue."
 msgstr ""
 
@@ -12751,6 +12778,15 @@ msgstr ""
 msgid "mrWidgetCommitsAdded|1 merge commit"
 msgstr ""
 
+msgid "mrWidgetNothingToMerge|Currently there are no changes in this merge request's source branch. Please push new commits or use a different branch."
+msgstr ""
+
+msgid "mrWidgetNothingToMerge|Interested parties can even contribute by pushing commits if they want to."
+msgstr ""
+
+msgid "mrWidgetNothingToMerge|Merge requests are a place to propose changes you have made to a project and discuss those changes with others."
+msgstr ""
+
 msgid "mrWidget| Please restore it or use a different %{missingBranchName} branch"
 msgstr ""
 
@@ -12868,6 +12904,9 @@ msgstr ""
 msgid "mrWidget|Request to merge"
 msgstr ""
 
+msgid "mrWidget|Resolve WIP status"
+msgstr ""
+
 msgid "mrWidget|Resolve conflicts"
 msgstr ""
 
@@ -12931,6 +12970,9 @@ msgstr ""
 msgid "mrWidget|This project is archived, write access has been disabled"
 msgstr ""
 
+msgid "mrWidget|When this merge request is ready, remove the WIP: prefix from the title to allow it to be merged"
+msgstr ""
+
 msgid "mrWidget|You are not allowed to edit this project directly. Please fork to make changes."
 msgstr ""
 

From 66094e5f071f2b13cd1bdea72937d42ba5998c15 Mon Sep 17 00:00:00 2001
From: Ezekiel Kigbo <ekigbo@gitlab.com>
Date: Mon, 8 Jul 2019 08:26:37 +0000
Subject: [PATCH 143/195] Vue-i18n: app/assets/javascripts/vue_shared directory

i18n linting for .vue files under the
app/assets/javascripts/vue_shared directory
---
 .../components/changed_file_icon.vue          |  3 +-
 .../vue_shared/components/commit.vue          |  7 ++-
 .../content_viewer/viewers/image_viewer.vue   |  4 +-
 .../viewers/markdown_viewer.vue               |  2 +-
 .../components/deprecated_modal.vue           |  6 +-
 .../components/droplab_dropdown_button.vue    |  2 +-
 .../components/filtered_search_dropdown.vue   |  4 +-
 .../components/header_ci_component.vue        | 13 ++---
 .../components/issue/issue_warning.vue        |  8 ++-
 .../issue/related_issuable_item.vue           |  4 +-
 .../vue_shared/components/markdown/field.vue  | 30 ++++++----
 .../components/markdown/suggestions.vue       |  3 +-
 .../components/markdown/toolbar.vue           | 25 +++++---
 .../vue_shared/components/memory_graph.vue    |  3 +-
 .../components/notes/system_note.vue          |  2 +-
 .../components/project_avatar/image.vue       |  4 +-
 .../sidebar/collapsed_grouped_date_picker.vue |  4 +-
 .../components/sidebar/date_picker.vue        |  8 +--
 .../components/sidebar/toggle_sidebar.vue     |  2 +-
 .../user_avatar/user_avatar_image.vue         |  3 +-
 locale/gitlab.pot                             | 57 +++++++++++++++++++
 21 files changed, 138 insertions(+), 56 deletions(-)

diff --git a/app/assets/javascripts/vue_shared/components/changed_file_icon.vue b/app/assets/javascripts/vue_shared/components/changed_file_icon.vue
index e9ab6f5ba7a..15cb0bd9792 100644
--- a/app/assets/javascripts/vue_shared/components/changed_file_icon.vue
+++ b/app/assets/javascripts/vue_shared/components/changed_file_icon.vue
@@ -1,7 +1,6 @@
 <script>
 import { GlTooltipDirective } from '@gitlab/ui';
 import Icon from '~/vue_shared/components/icon.vue';
-import { pluralize } from '~/lib/utils/text_utility';
 import { __, sprintf } from '~/locale';
 import { getCommitIconMap } from '~/ide/utils';
 
@@ -69,7 +68,7 @@ export default {
         });
       } else if (this.file.changed && this.file.staged) {
         return sprintf(__('Unstaged and staged %{type}'), {
-          type: pluralize(type),
+          type,
         });
       }
 
diff --git a/app/assets/javascripts/vue_shared/components/commit.vue b/app/assets/javascripts/vue_shared/components/commit.vue
index a1168fa0f1e..ae9b013d980 100644
--- a/app/assets/javascripts/vue_shared/components/commit.vue
+++ b/app/assets/javascripts/vue_shared/components/commit.vue
@@ -1,6 +1,7 @@
 <script>
 import _ from 'underscore';
 import { GlTooltipDirective, GlLink } from '@gitlab/ui';
+import { __, sprintf } from '~/locale';
 import TooltipOnTruncate from '~/vue_shared/components/tooltip_on_truncate.vue';
 import UserAvatarLink from './user_avatar/user_avatar_link.vue';
 import Icon from '../../vue_shared/components/icon.vue';
@@ -129,7 +130,9 @@ export default {
      * @returns {String}
      */
     userImageAltDescription() {
-      return this.author && this.author.username ? `${this.author.username}'s avatar` : null;
+      return this.author && this.author.username
+        ? sprintf(__("%{username}'s avatar"), { username: this.author.username })
+        : null;
     },
   },
 };
@@ -180,7 +183,7 @@ export default {
           {{ title }}
         </gl-link>
       </tooltip-on-truncate>
-      <span v-else> Can't find HEAD commit for this branch </span>
+      <span v-else>{{ __("Can't find HEAD commit for this branch") }}</span>
     </div>
   </div>
 </template>
diff --git a/app/assets/javascripts/vue_shared/components/content_viewer/viewers/image_viewer.vue b/app/assets/javascripts/vue_shared/components/content_viewer/viewers/image_viewer.vue
index 2ca933a37d2..fc6a45b957e 100644
--- a/app/assets/javascripts/vue_shared/components/content_viewer/viewers/image_viewer.vue
+++ b/app/assets/javascripts/vue_shared/components/content_viewer/viewers/image_viewer.vue
@@ -91,7 +91,9 @@ export default {
         |
       </template>
       <template v-if="hasDimensions">
-        <strong>W</strong>: {{ width }} | <strong>H</strong>: {{ height }}
+        <strong>{{ s__('ImageViewerDimensions|W') }}</strong
+        >: {{ width }} | <strong>{{ s__('ImageViewerDimensions|H') }}</strong
+        >: {{ height }}
       </template>
     </p>
   </div>
diff --git a/app/assets/javascripts/vue_shared/components/content_viewer/viewers/markdown_viewer.vue b/app/assets/javascripts/vue_shared/components/content_viewer/viewers/markdown_viewer.vue
index 5fdc915fffb..655f0054887 100644
--- a/app/assets/javascripts/vue_shared/components/content_viewer/viewers/markdown_viewer.vue
+++ b/app/assets/javascripts/vue_shared/components/content_viewer/viewers/markdown_viewer.vue
@@ -40,7 +40,7 @@ export default {
     this.fetchMarkdownPreview();
   },
   destroyed() {
-    if (this.isLoading) axiosSource.cancel('Cancelling Preview');
+    if (this.isLoading) axiosSource.cancel(__('Cancelling Preview'));
   },
   methods: {
     fetchMarkdownPreview() {
diff --git a/app/assets/javascripts/vue_shared/components/deprecated_modal.vue b/app/assets/javascripts/vue_shared/components/deprecated_modal.vue
index 36b3ee05456..d5558d93219 100644
--- a/app/assets/javascripts/vue_shared/components/deprecated_modal.vue
+++ b/app/assets/javascripts/vue_shared/components/deprecated_modal.vue
@@ -1,5 +1,7 @@
 <script>
 /* eslint-disable vue/require-default-prop */
+import { __ } from '~/locale';
+
 export default {
   name: 'DeprecatedModal', // use GlModal instead
 
@@ -39,7 +41,7 @@ export default {
     closeButtonLabel: {
       type: String,
       required: false,
-      default: 'Cancel',
+      default: __('Cancel'),
     },
     primaryButtonLabel: {
       type: String,
@@ -94,7 +96,7 @@ export default {
                 type="button"
                 class="close float-right"
                 data-dismiss="modal"
-                aria-label="Close"
+                :aria-label="__('Close')"
                 @click="emitCancel($event)"
               >
                 <span aria-hidden="true">&times;</span>
diff --git a/app/assets/javascripts/vue_shared/components/droplab_dropdown_button.vue b/app/assets/javascripts/vue_shared/components/droplab_dropdown_button.vue
index 7d49c87271d..c35fee84771 100644
--- a/app/assets/javascripts/vue_shared/components/droplab_dropdown_button.vue
+++ b/app/assets/javascripts/vue_shared/components/droplab_dropdown_button.vue
@@ -69,7 +69,7 @@ export default {
       data-display="static"
       data-toggle="dropdown"
     >
-      <icon name="arrow-down" aria-label="toggle dropdown" />
+      <icon name="arrow-down" :aria-label="__('toggle dropdown')" />
     </button>
     <ul :class="dropdownClass" class="dropdown-menu dropdown-open-top">
       <template v-for="(action, index) in actions">
diff --git a/app/assets/javascripts/vue_shared/components/filtered_search_dropdown.vue b/app/assets/javascripts/vue_shared/components/filtered_search_dropdown.vue
index 4e5dfbf3bf8..20bcceeb477 100644
--- a/app/assets/javascripts/vue_shared/components/filtered_search_dropdown.vue
+++ b/app/assets/javascripts/vue_shared/components/filtered_search_dropdown.vue
@@ -115,7 +115,7 @@ export default {
         data-toggle="dropdown"
         aria-haspopup="true"
         aria-expanded="false"
-        aria-label="Expand dropdown"
+        :aria-label="__('Expand dropdown')"
       >
         <icon name="angle-down" :size="12" />
       </button>
@@ -125,7 +125,7 @@ export default {
             ref="searchInput"
             v-model="filter"
             type="search"
-            placeholder="Filter"
+            :placeholder="__('Filter')"
             class="js-filtered-dropdown-input dropdown-input-field"
           />
           <icon class="dropdown-input-search" name="search" />
diff --git a/app/assets/javascripts/vue_shared/components/header_ci_component.vue b/app/assets/javascripts/vue_shared/components/header_ci_component.vue
index 3f45dc7853b..c652a684d7c 100644
--- a/app/assets/javascripts/vue_shared/components/header_ci_component.vue
+++ b/app/assets/javascripts/vue_shared/components/header_ci_component.vue
@@ -1,5 +1,6 @@
 <script>
 import { GlTooltipDirective, GlLink, GlButton } from '@gitlab/ui';
+import { __, sprintf } from '~/locale';
 import CiIconBadge from './ci_badge_link.vue';
 import TimeagoTooltip from './time_ago_tooltip.vue';
 import UserAvatarImage from './user_avatar/user_avatar_image.vue';
@@ -65,7 +66,7 @@ export default {
 
   computed: {
     userAvatarAltText() {
-      return `${this.user.name}'s avatar`;
+      return sprintf(__(`%{username}'s avatar`), { username: this.user.name });
     },
   },
 
@@ -87,16 +88,12 @@ export default {
 
       <strong> {{ itemName }} #{{ itemId }} </strong>
 
-      <template v-if="shouldRenderTriggeredLabel">
-        triggered
-      </template>
-      <template v-else>
-        created
-      </template>
+      <template v-if="shouldRenderTriggeredLabel">{{ __('triggered') }}</template>
+      <template v-else>{{ __('created') }}</template>
 
       <timeago-tooltip :time="time" />
 
-      by
+      {{ __('by') }}
 
       <template v-if="user">
         <gl-link
diff --git a/app/assets/javascripts/vue_shared/components/issue/issue_warning.vue b/app/assets/javascripts/vue_shared/components/issue/issue_warning.vue
index e438ff16a41..47f0851f650 100644
--- a/app/assets/javascripts/vue_shared/components/issue/issue_warning.vue
+++ b/app/assets/javascripts/vue_shared/components/issue/issue_warning.vue
@@ -1,7 +1,7 @@
 <script>
 import { GlLink } from '@gitlab/ui';
 import _ from 'underscore';
-import { sprintf } from '~/locale';
+import { __, sprintf } from '~/locale';
 import icon from '../../../vue_shared/components/icon.vue';
 
 function buildDocsLinkStart(path) {
@@ -47,7 +47,9 @@ export default {
     },
     confidentialAndLockedDiscussionText() {
       return sprintf(
-        'This issue is %{confidentialLinkStart}confidential%{linkEnd} and %{lockedLinkStart}locked%{linkEnd}.',
+        __(
+          'This issue is %{confidentialLinkStart}confidential%{linkEnd} and %{lockedLinkStart}locked%{linkEnd}.',
+        ),
         {
           confidentialLinkStart: buildDocsLinkStart(this.confidentialIssueDocsPath),
           lockedLinkStart: buildDocsLinkStart(this.lockedIssueDocsPath),
@@ -66,7 +68,7 @@ export default {
     <span v-if="isLockedAndConfidential">
       <span v-html="confidentialAndLockedDiscussionText"></span>
       {{
-        __(`People without permission will never get a notification and won't be able to comment.`)
+        __("People without permission will never get a notification and won't be able to comment.")
       }}
     </span>
 
diff --git a/app/assets/javascripts/vue_shared/components/issue/related_issuable_item.vue b/app/assets/javascripts/vue_shared/components/issue/related_issuable_item.vue
index eb0f666422f..b76679960ca 100644
--- a/app/assets/javascripts/vue_shared/components/issue/related_issuable_item.vue
+++ b/app/assets/javascripts/vue_shared/components/issue/related_issuable_item.vue
@@ -160,8 +160,8 @@ export default {
       :disabled="removeDisabled"
       type="button"
       class="btn btn-default btn-svg btn-item-remove js-issue-item-remove-button qa-remove-issue-button mr-xl-0 align-self-xl-center"
-      title="Remove"
-      aria-label="Remove"
+      :title="__('Remove')"
+      :aria-label="__('Remove')"
       @click="onRemoveRequest"
     >
       <icon :size="16" class="btn-item-remove-icon" name="close" />
diff --git a/app/assets/javascripts/vue_shared/components/markdown/field.vue b/app/assets/javascripts/vue_shared/components/markdown/field.vue
index 3bdc0bb8ebd..b520d302407 100644
--- a/app/assets/javascripts/vue_shared/components/markdown/field.vue
+++ b/app/assets/javascripts/vue_shared/components/markdown/field.vue
@@ -1,7 +1,7 @@
 <script>
 import $ from 'jquery';
 import _ from 'underscore';
-import { __ } from '~/locale';
+import { __, sprintf } from '~/locale';
 import { stripHtml } from '~/lib/utils/text_utility';
 import Flash from '../../../flash';
 import GLForm from '../../../gl_form';
@@ -118,6 +118,18 @@ export default {
     lineType() {
       return this.line ? this.line.type : '';
     },
+    addMultipleToDiscussionWarning() {
+      return sprintf(
+        __(
+          '%{icon}You are about to add %{usersTag} people to the discussion. Proceed with caution.',
+        ),
+        {
+          icon: '<i class="fa fa-exclamation-triangle" aria-hidden="true"></i>',
+          usersTag: `<strong><span class="js-referenced-users-count">${this.referencedUsers.length}</span></strong>`,
+        },
+        false,
+      );
+    },
   },
   mounted() {
     /*
@@ -172,7 +184,7 @@ export default {
 
     renderMarkdown(data = {}) {
       this.markdownPreviewLoading = false;
-      this.markdownPreview = data.body || 'Nothing to preview.';
+      this.markdownPreview = data.body || __('Nothing to preview.');
 
       if (data.references) {
         this.referencedCommands = data.references.commands;
@@ -207,7 +219,11 @@ export default {
     <div v-show="!previewMarkdown" class="md-write-holder">
       <div class="zen-backdrop">
         <slot name="textarea"></slot>
-        <a class="zen-control zen-control-leave js-zen-leave" href="#" aria-label="Enter zen mode">
+        <a
+          class="zen-control zen-control-leave js-zen-leave"
+          href="#"
+          :aria-label="__('Enter zen mode')"
+        >
           <icon :size="32" name="screen-normal" />
         </a>
         <markdown-toolbar
@@ -246,13 +262,7 @@ export default {
     <template v-if="previewMarkdown && !markdownPreviewLoading">
       <div v-if="referencedCommands" class="referenced-commands" v-html="referencedCommands"></div>
       <div v-if="shouldShowReferencedUsers" class="referenced-users">
-        <span>
-          <i class="fa fa-exclamation-triangle" aria-hidden="true"></i> You are about to add
-          <strong>
-            <span class="js-referenced-users-count">{{ referencedUsers.length }}</span>
-          </strong>
-          people to the discussion. Proceed with caution.
-        </span>
+        <span v-html="addMultipleToDiscussionWarning"></span>
       </div>
     </template>
   </div>
diff --git a/app/assets/javascripts/vue_shared/components/markdown/suggestions.vue b/app/assets/javascripts/vue_shared/components/markdown/suggestions.vue
index 8d3705e1e4a..7f0fcfac071 100644
--- a/app/assets/javascripts/vue_shared/components/markdown/suggestions.vue
+++ b/app/assets/javascripts/vue_shared/components/markdown/suggestions.vue
@@ -1,5 +1,6 @@
 <script>
 import Vue from 'vue';
+import { __ } from '~/locale';
 import SuggestionDiff from './suggestion_diff.vue';
 import Flash from '~/flash';
 
@@ -56,7 +57,7 @@ export default {
       const suggestionElements = container.querySelectorAll('.js-render-suggestion');
 
       if (this.lineType === 'old') {
-        Flash('Unable to apply suggestions to a deleted line.', 'alert', this.$el);
+        Flash(__('Unable to apply suggestions to a deleted line.'), 'alert', this.$el);
       }
 
       suggestionElements.forEach((suggestionEl, i) => {
diff --git a/app/assets/javascripts/vue_shared/components/markdown/toolbar.vue b/app/assets/javascripts/vue_shared/components/markdown/toolbar.vue
index d6c398c8946..8ce5b615795 100644
--- a/app/assets/javascripts/vue_shared/components/markdown/toolbar.vue
+++ b/app/assets/javascripts/vue_shared/components/markdown/toolbar.vue
@@ -33,13 +33,18 @@ export default {
   <div class="comment-toolbar clearfix">
     <div class="toolbar-text">
       <template v-if="!hasQuickActionsDocsPath && markdownDocsPath">
-        <gl-link :href="markdownDocsPath" target="_blank" tabindex="-1"
-          >Markdown is supported</gl-link
-        >
+        <gl-link :href="markdownDocsPath" target="_blank" tabindex="-1">{{
+          __('Markdown is supported')
+        }}</gl-link>
       </template>
       <template v-if="hasQuickActionsDocsPath && markdownDocsPath">
-        <gl-link :href="markdownDocsPath" target="_blank" tabindex="-1">Markdown</gl-link> and
-        <gl-link :href="quickActionsDocsPath" target="_blank" tabindex="-1">quick actions</gl-link>
+        <gl-link :href="markdownDocsPath" target="_blank" tabindex="-1">{{
+          __('Markdown')
+        }}</gl-link>
+        and
+        <gl-link :href="quickActionsDocsPath" target="_blank" tabindex="-1">{{
+          __('quick actions')
+        }}</gl-link>
         are supported
       </template>
     </div>
@@ -57,15 +62,17 @@ export default {
           <i class="fa fa-file-image-o toolbar-button-icon" aria-hidden="true"></i>
         </span>
         <span class="uploading-error-message"></span>
-        <button class="retry-uploading-link" type="button">Try again</button> or
-        <button class="attach-new-file markdown-selector" type="button">attach a new file</button>
+        <button class="retry-uploading-link" type="button">{{ __('Try again') }}</button> or
+        <button class="attach-new-file markdown-selector" type="button">
+          {{ __('attach a new file') }}
+        </button>
       </span>
       <button class="markdown-selector button-attach-file btn-link" tabindex="-1" type="button">
         <i class="fa fa-file-image-o toolbar-button-icon" aria-hidden="true"></i
-        ><span class="text-attach-file">Attach a file</span>
+        ><span class="text-attach-file">{{ __('Attach a file') }}</span>
       </button>
       <button class="btn btn-default btn-sm hide button-cancel-uploading-files" type="button">
-        Cancel
+        {{ __('Cancel') }}
       </button>
     </span>
   </div>
diff --git a/app/assets/javascripts/vue_shared/components/memory_graph.vue b/app/assets/javascripts/vue_shared/components/memory_graph.vue
index 16f4ff068f6..26d7d8e8866 100644
--- a/app/assets/javascripts/vue_shared/components/memory_graph.vue
+++ b/app/assets/javascripts/vue_shared/components/memory_graph.vue
@@ -1,4 +1,5 @@
 <script>
+import { __, sprintf } from '~/locale';
 import { getTimeago } from '../../lib/utils/datetime_utility';
 
 export default {
@@ -20,7 +21,7 @@ export default {
   computed: {
     getFormattedMedian() {
       const deployedSince = getTimeago().format(this.deploymentTime * 1000);
-      return `Deployed ${deployedSince}`;
+      return sprintf(__('Deployed %{deployedSince}'), { deployedSince });
     },
   },
   mounted() {
diff --git a/app/assets/javascripts/vue_shared/components/notes/system_note.vue b/app/assets/javascripts/vue_shared/components/notes/system_note.vue
index 3c86b7e4c61..d6dfe9eded8 100644
--- a/app/assets/javascripts/vue_shared/components/notes/system_note.vue
+++ b/app/assets/javascripts/vue_shared/components/notes/system_note.vue
@@ -103,7 +103,7 @@ export default {
         <div v-if="hasMoreCommits" class="flex-list">
           <div class="system-note-commit-list-toggler flex-row" @click="expanded = !expanded">
             <icon :name="toggleIcon" :size="8" class="append-right-5" />
-            <span>Toggle commit list</span>
+            <span>{{ __('Toggle commit list') }}</span>
           </div>
         </div>
       </div>
diff --git a/app/assets/javascripts/vue_shared/components/project_avatar/image.vue b/app/assets/javascripts/vue_shared/components/project_avatar/image.vue
index b9311d65360..43bbb756805 100644
--- a/app/assets/javascripts/vue_shared/components/project_avatar/image.vue
+++ b/app/assets/javascripts/vue_shared/components/project_avatar/image.vue
@@ -14,7 +14,7 @@
     />
 
   */
-
+import { __ } from '~/locale';
 import defaultAvatarUrl from 'images/no_avatar.png';
 import { placeholderImage } from '../../../lazy_loader';
 
@@ -39,7 +39,7 @@ export default {
     imgAlt: {
       type: String,
       required: false,
-      default: 'project avatar',
+      default: __('project avatar'),
     },
     size: {
       type: Number,
diff --git a/app/assets/javascripts/vue_shared/components/sidebar/collapsed_grouped_date_picker.vue b/app/assets/javascripts/vue_shared/components/sidebar/collapsed_grouped_date_picker.vue
index b5e43da401e..4dcc121496c 100644
--- a/app/assets/javascripts/vue_shared/components/sidebar/collapsed_grouped_date_picker.vue
+++ b/app/assets/javascripts/vue_shared/components/sidebar/collapsed_grouped_date_picker.vue
@@ -85,7 +85,7 @@ export default {
       @click="toggleSidebar"
     >
       <span class="sidebar-collapsed-value">
-        <span v-if="showFromText">From</span> <span>{{ dateText('min') }}</span>
+        <span v-if="showFromText">{{ __('From') }}</span> <span>{{ dateText('min') }}</span>
       </span>
     </collapsed-calendar-icon>
     <div v-if="hasMinAndMaxDates" class="text-center sidebar-collapsed-divider">-</div>
@@ -96,7 +96,7 @@ export default {
       @click="toggleSidebar"
     >
       <span class="sidebar-collapsed-value">
-        <span v-if="!minDate">Until</span> <span>{{ dateText('max') }}</span>
+        <span v-if="!minDate">{{ __('Until') }}</span> <span>{{ dateText('max') }}</span>
       </span>
     </collapsed-calendar-icon>
   </div>
diff --git a/app/assets/javascripts/vue_shared/components/sidebar/date_picker.vue b/app/assets/javascripts/vue_shared/components/sidebar/date_picker.vue
index 45f01a6fced..6caf8bc92c2 100644
--- a/app/assets/javascripts/vue_shared/components/sidebar/date_picker.vue
+++ b/app/assets/javascripts/vue_shared/components/sidebar/date_picker.vue
@@ -74,7 +74,7 @@ export default {
       return dateInWords(this.selectedDate, true);
     },
     collapsedText() {
-      return this.selectedDateWords ? this.selectedDateWords : 'None';
+      return this.selectedDateWords ? this.selectedDateWords : __('None');
     },
   },
   methods: {
@@ -112,7 +112,7 @@ export default {
           class="btn-blank btn-link btn-primary-hover-link btn-sidebar-action"
           @click="toggleDatePicker"
         >
-          Edit
+          {{ __('Edit') }}
         </button>
         <toggle-sidebar v-if="showToggleSidebar" :collapsed="collapsed" @toggle="toggleSidebar" />
       </div>
@@ -137,11 +137,11 @@ export default {
               class="btn-blank btn-link btn-secondary-hover-link"
               @click="newDateSelected(null)"
             >
-              remove
+              {{ __('remove') }}
             </button>
           </span>
         </template>
-        <span v-else class="no-value"> None </span>
+        <span v-else class="no-value">{{ __('None') }}</span>
       </span>
     </div>
   </div>
diff --git a/app/assets/javascripts/vue_shared/components/sidebar/toggle_sidebar.vue b/app/assets/javascripts/vue_shared/components/sidebar/toggle_sidebar.vue
index 3b5ce0e9910..913c971a512 100644
--- a/app/assets/javascripts/vue_shared/components/sidebar/toggle_sidebar.vue
+++ b/app/assets/javascripts/vue_shared/components/sidebar/toggle_sidebar.vue
@@ -48,7 +48,7 @@ export default {
         'fa-angle-double-right': !collapsed,
         'fa-angle-double-left': collapsed,
       }"
-      aria-label="toggle collapse"
+      :aria-label="__('toggle collapse')"
       class="fa"
     >
     </i>
diff --git a/app/assets/javascripts/vue_shared/components/user_avatar/user_avatar_image.vue b/app/assets/javascripts/vue_shared/components/user_avatar/user_avatar_image.vue
index a6c1737dcab..ea483416c46 100644
--- a/app/assets/javascripts/vue_shared/components/user_avatar/user_avatar_image.vue
+++ b/app/assets/javascripts/vue_shared/components/user_avatar/user_avatar_image.vue
@@ -17,6 +17,7 @@
 
 import { GlTooltip } from '@gitlab/ui';
 import defaultAvatarUrl from 'images/no_avatar.png';
+import { __ } from '~/locale';
 import { placeholderImage } from '../../../lazy_loader';
 
 export default {
@@ -43,7 +44,7 @@ export default {
     imgAlt: {
       type: String,
       required: false,
-      default: 'user avatar',
+      default: __('user avatar'),
     },
     size: {
       type: Number,
diff --git a/locale/gitlab.pot b/locale/gitlab.pot
index 1635faf312c..07534e9c941 100644
--- a/locale/gitlab.pot
+++ b/locale/gitlab.pot
@@ -156,6 +156,9 @@ msgstr ""
 msgid "%{group_docs_link_start}Groups%{group_docs_link_end} allow you to manage and collaborate across multiple projects. Members of a group have access to all of its projects."
 msgstr ""
 
+msgid "%{icon}You are about to add %{usersTag} people to the discussion. Proceed with caution."
+msgstr ""
+
 msgid "%{issuableType} will be removed! Are you sure?"
 msgstr ""
 
@@ -1905,6 +1908,9 @@ msgstr ""
 msgid "Cancel this job"
 msgstr ""
 
+msgid "Cancelling Preview"
+msgstr ""
+
 msgid "Cannot be merged automatically"
 msgstr ""
 
@@ -3646,6 +3652,9 @@ msgstr ""
 msgid "Deployed"
 msgstr ""
 
+msgid "Deployed %{deployedSince}"
+msgstr ""
+
 msgid "Deployed to"
 msgstr ""
 
@@ -4054,6 +4063,9 @@ msgstr ""
 msgid "Enter the merge request title"
 msgstr ""
 
+msgid "Enter zen mode"
+msgstr ""
+
 msgid "Environment variables are applied to environments via the runner. They can be protected by only exposing them to protected branches or tags. Additionally, they can be masked so they are hidden in job logs, though they must match certain regexp requirements to do so. You can use environment variables for passwords, secret keys, or whatever you want."
 msgstr ""
 
@@ -4423,6 +4435,9 @@ msgstr ""
 msgid "Expand all"
 msgstr ""
 
+msgid "Expand dropdown"
+msgstr ""
+
 msgid "Expand sidebar"
 msgstr ""
 
@@ -4803,6 +4818,9 @@ msgstr ""
 msgid "Friday"
 msgstr ""
 
+msgid "From"
+msgstr ""
+
 msgid "From %{providerTitle}"
 msgstr ""
 
@@ -5375,6 +5393,12 @@ msgstr ""
 msgid "ImageDiffViewer|Swipe"
 msgstr ""
 
+msgid "ImageViewerDimensions|H"
+msgstr ""
+
+msgid "ImageViewerDimensions|W"
+msgstr ""
+
 msgid "Impersonation has been disabled"
 msgstr ""
 
@@ -6282,6 +6306,9 @@ msgstr ""
 msgid "Markdown enabled"
 msgstr ""
 
+msgid "Markdown is supported"
+msgstr ""
+
 msgid "Marks this issue as a duplicate of %{duplicate_reference}."
 msgstr ""
 
@@ -10785,6 +10812,9 @@ msgstr ""
 msgid "This is your current session"
 msgstr ""
 
+msgid "This issue is %{confidentialLinkStart}confidential%{linkEnd} and %{lockedLinkStart}locked%{linkEnd}."
+msgstr ""
+
 msgid "This issue is confidential"
 msgstr ""
 
@@ -11404,6 +11434,9 @@ msgstr ""
 msgid "U2F only works with HTTPS-enabled websites. Contact your administrator for more details."
 msgstr ""
 
+msgid "Unable to apply suggestions to a deleted line."
+msgstr ""
+
 msgid "Unable to connect to Prometheus server"
 msgstr ""
 
@@ -11512,6 +11545,9 @@ msgstr ""
 msgid "Unsubscribe from %{type}"
 msgstr ""
 
+msgid "Until"
+msgstr ""
+
 msgid "Unverified"
 msgstr ""
 
@@ -12588,6 +12624,9 @@ msgstr ""
 msgid "branch name"
 msgstr ""
 
+msgid "by"
+msgstr ""
+
 msgid "cannot be changed if a personal project has container registry tags."
 msgstr ""
 
@@ -12618,6 +12657,9 @@ msgstr ""
 msgid "could not read private key, is the passphrase correct?"
 msgstr ""
 
+msgid "created"
+msgstr ""
+
 msgid "customize"
 msgstr ""
 
@@ -13058,6 +13100,9 @@ msgstr ""
 msgid "project"
 msgstr ""
 
+msgid "project avatar"
+msgstr ""
+
 msgid "quick actions"
 msgstr ""
 
@@ -13070,6 +13115,9 @@ msgstr ""
 msgid "remaining"
 msgstr ""
 
+msgid "remove"
+msgstr ""
+
 msgid "remove due date"
 msgstr ""
 
@@ -13140,12 +13188,21 @@ msgstr[1] ""
 msgid "to list"
 msgstr ""
 
+msgid "toggle collapse"
+msgstr ""
+
+msgid "toggle dropdown"
+msgstr ""
+
 msgid "triggered"
 msgstr ""
 
 msgid "updated"
 msgstr ""
 
+msgid "user avatar"
+msgstr ""
+
 msgid "username"
 msgstr ""
 

From 73c6477b7e07dbdeb86f0c9033e84d7fda2ac0e2 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Mon, 8 Jul 2019 08:50:38 +0000
Subject: [PATCH 144/195] Changing badges to use parentheses not brackets

Previously, we used brackets to denote the tier badges,
but this made Kramdown, the docs site Markdown renderer,
show many warnings when building the site. This is now
fixed by using parentheses instead of square brackets.

This was caused by [PREMIUM] looking like a link to
Kramdown, which couldn't find a URL there.

See:
- https://gitlab.com/gitlab-com/gitlab-docs/merge_requests/484
- https://gitlab.com/gitlab-org/gitlab-ce/issues/63800
---
 doc/README.md                                 | 60 +++++++--------
 doc/administration/audit_events.md            |  8 +-
 doc/administration/auditor_users.md           |  2 +-
 doc/administration/auth/README.md             |  4 +-
 doc/administration/auth/google_secure_ldap.md |  2 +-
 .../how_to_configure_ldap_gitlab_ce/index.md  |  4 +-
 .../how_to_configure_ldap_gitlab_ee/index.md  |  2 +-
 doc/administration/auth/ldap-ee.md            |  2 +-
 doc/administration/auth/ldap.md               |  8 +-
 doc/administration/auth/smartcard.md          |  2 +-
 doc/administration/database_load_balancing.md |  2 +-
 doc/administration/dependency_proxy.md        |  2 +-
 .../background_verification.md                |  2 +-
 .../disaster_recovery/bring_primary_back.md   |  2 +-
 .../geo/disaster_recovery/index.md            |  2 +-
 .../geo/disaster_recovery/planned_failover.md |  2 +-
 .../geo/replication/configuration.md          |  2 +-
 .../geo/replication/database.md               |  2 +-
 .../geo/replication/docker_registry.md        |  2 +-
 .../geo/replication/external_database.md      |  2 +-
 doc/administration/geo/replication/faq.md     |  2 +-
 .../geo/replication/high_availability.md      |  2 +-
 doc/administration/geo/replication/index.md   |  2 +-
 .../geo/replication/object_storage.md         |  2 +-
 .../geo/replication/remove_geo_node.md        |  2 +-
 .../geo/replication/security_review.md        |  2 +-
 .../geo/replication/troubleshooting.md        |  2 +-
 doc/administration/geo/replication/tuning.md  |  2 +-
 .../geo/replication/updating_the_geo_nodes.md |  2 +-
 .../geo/replication/using_a_geo_server.md     |  2 +-
 .../high_availability/consul.md               |  2 +-
 .../high_availability/database.md             | 10 +--
 doc/administration/high_availability/redis.md | 10 +--
 doc/administration/incoming_email.md          |  2 +-
 doc/administration/index.md                   | 44 +++++------
 doc/administration/instance_review.md         |  2 +-
 doc/administration/issue_closing_pattern.md   |  2 +-
 doc/administration/merge_request_diffs.md     |  2 +-
 .../monitoring/prometheus/gitlab_metrics.md   |  2 +-
 .../operations/extra_sidekiq_processes.md     |  2 +-
 .../operations/fast_ssh_key_lookup.md         |  2 +-
 doc/administration/operations/index.md        |  2 +-
 doc/administration/packages.md                |  2 +-
 doc/administration/pseudonymizer.md           |  2 +-
 doc/administration/raketasks/geo.md           |  2 +-
 .../raketasks/project_import_export.md        |  2 +-
 doc/administration/uploads.md                 |  2 +-
 doc/api/README.md                             | 24 +++---
 doc/api/boards.md                             | 10 +--
 doc/api/discussions.md                        |  4 +-
 doc/api/epic_issues.md                        |  2 +-
 doc/api/epic_links.md                         |  2 +-
 doc/api/epics.md                              |  2 +-
 doc/api/geo_nodes.md                          |  2 +-
 doc/api/graphql/index.md                      |  2 +-
 doc/api/group_boards.md                       |  6 +-
 doc/api/group_milestones.md                   |  2 +-
 doc/api/groups.md                             | 18 ++---
 doc/api/issue_links.md                        |  2 +-
 doc/api/issues.md                             | 10 +--
 doc/api/jobs.md                               |  8 +-
 doc/api/license.md                            |  2 +-
 doc/api/managed_licenses.md                   |  2 +-
 doc/api/merge_request_approvals.md            |  4 +-
 doc/api/merge_requests.md                     | 10 +--
 doc/api/milestones.md                         |  2 +-
 doc/api/namespaces.md                         |  2 +-
 doc/api/notes.md                              |  4 +-
 doc/api/notification_settings.md              |  6 +-
 doc/api/packages.md                           |  2 +-
 doc/api/project_aliases.md                    |  2 +-
 doc/api/project_clusters.md                   |  4 +-
 doc/api/project_level_variables.md            |  4 +-
 doc/api/project_templates.md                  |  2 +-
 doc/api/projects.md                           | 74 +++++++++----------
 doc/api/protected_branches.md                 |  8 +-
 doc/api/resource_label_events.md              |  2 +-
 doc/api/scim.md                               |  2 +-
 doc/api/search.md                             | 16 ++--
 doc/api/services.md                           |  2 +-
 doc/api/settings.md                           | 72 +++++++++---------
 doc/api/users.md                              |  8 +-
 doc/api/vulnerabilities.md                    |  2 +-
 doc/ci/README.md                              | 22 +++---
 .../bitbucket_integration.md                  |  2 +-
 .../github_integration.md                     |  2 +-
 doc/ci/ci_cd_for_external_repos/index.md      |  2 +-
 doc/ci/environments.md                        |  6 +-
 doc/ci/environments/protected_environments.md |  2 +-
 doc/ci/examples/README.md                     |  2 +-
 doc/ci/interactive_web_terminal/index.md      |  2 +-
 doc/ci/introduction/index.md                  | 18 ++---
 doc/ci/merge_request_pipelines/index.md       |  4 +-
 .../pipelines_for_merged_results/index.md     |  4 +-
 .../merge_trains/index.md                     |  2 +-
 doc/ci/metrics_reports.md                     |  2 +-
 doc/ci/multi_project_pipelines.md             |  2 +-
 doc/ci/pipelines.md                           |  2 +-
 doc/ci/review_apps/index.md                   |  2 +-
 doc/ci/triggers/README.md                     |  4 +-
 doc/ci/variables/README.md                    |  2 +-
 doc/ci/yaml/README.md                         | 18 ++---
 doc/customization/index.md                    |  2 +-
 doc/development/documentation/styleguide.md   | 30 ++++----
 doc/development/elasticsearch.md              |  2 +-
 doc/development/geo.md                        |  2 +-
 doc/development/go_guide/index.md             |  6 +-
 .../licensed_feature_availability.md          |  2 +-
 doc/development/packages.md                   |  2 +-
 doc/development/rake_tasks.md                 |  2 +-
 doc/gitlab-basics/create-project.md           |  4 +-
 doc/install/README.md                         |  2 +-
 doc/install/pivotal/index.md                  |  2 +-
 doc/integration/elasticsearch.md              |  2 +-
 doc/integration/jenkins.md                    |  2 +-
 doc/integration/jira_development_panel.md     |  2 +-
 doc/integration/kerberos.md                   |  2 +-
 doc/push_rules/push_rules.md                  |  2 +-
 doc/raketasks/web_hooks.md                    |  2 +-
 doc/tools/email.md                            |  2 +-
 doc/topics/authentication/index.md            | 10 +--
 doc/topics/autodevops/index.md                | 38 +++++-----
 doc/topics/autodevops/quick_start_guide.md    | 14 ++--
 doc/update/patch_versions.md                  |  2 +-
 doc/update/upgrading_from_ce_to_ee.md         |  2 +-
 .../admin_area/custom_project_templates.md    |  2 +-
 doc/user/admin_area/geo_nodes.md              |  2 +-
 doc/user/admin_area/index.md                  | 10 +--
 doc/user/admin_area/labels.md                 |  2 +-
 doc/user/admin_area/license.md                |  2 +-
 .../settings/account_and_limit_settings.md    |  2 +-
 .../settings/continuous_integration.md        | 12 +--
 doc/user/admin_area/settings/email.md         |  2 +-
 .../settings/external_authorization.md        |  2 +-
 doc/user/admin_area/settings/index.md         |  6 +-
 .../settings/instance_template_repository.md  |  2 +-
 .../admin_area/settings/usage_statistics.md   |  6 +-
 .../visibility_and_access_controls.md         |  2 +-
 .../container_scanning/index.md               |  2 +-
 doc/user/application_security/dast/index.md   |  2 +-
 .../dependency_scanning/analyzers.md          |  2 +-
 .../dependency_scanning/index.md              |  2 +-
 doc/user/application_security/index.md        | 14 ++--
 .../license_management/index.md               |  2 +-
 doc/user/application_security/sast/index.md   |  2 +-
 .../security_dashboard/index.md               |  2 +-
 doc/user/discussions/index.md                 |  4 +-
 doc/user/group/clusters/index.md              |  4 +-
 .../group/contribution_analytics/index.md     |  2 +-
 doc/user/group/custom_project_templates.md    |  2 +-
 doc/user/group/dependency_proxy/index.md      |  2 +-
 doc/user/group/epics/index.md                 |  2 +-
 doc/user/group/index.md                       | 24 +++---
 doc/user/group/insights/index.md              |  2 +-
 doc/user/group/issues_analytics/index.md      |  2 +-
 doc/user/group/roadmap/index.md               |  2 +-
 doc/user/group/saml_sso/index.md              |  2 +-
 doc/user/group/saml_sso/scim_setup.md         |  2 +-
 doc/user/index.md                             |  2 +-
 doc/user/markdown.md                          |  4 +-
 doc/user/operations_dashboard/index.md        |  2 +-
 doc/user/permissions.md                       | 38 +++++-----
 doc/user/profile/preferences.md               |  2 +-
 doc/user/project/canary_deployments.md        |  2 +-
 doc/user/project/clusters/index.md            | 12 +--
 .../project/clusters/kubernetes_pod_logs.md   |  2 +-
 doc/user/project/code_owners.md               |  2 +-
 doc/user/project/deploy_boards.md             |  2 +-
 doc/user/project/description_templates.md     |  2 +-
 doc/user/project/file_lock.md                 |  2 +-
 doc/user/project/import/gemnasium.md          |  2 +-
 doc/user/project/import/github.md             |  4 +-
 doc/user/project/import/index.md              |  2 +-
 doc/user/project/index.md                     | 24 +++---
 doc/user/project/insights/index.md            |  2 +-
 doc/user/project/integrations/github.md       |  2 +-
 .../project/integrations/project_services.md  |  6 +-
 doc/user/project/integrations/prometheus.md   |  6 +-
 .../prometheus_library/kubernetes.md          |  2 +-
 .../integrations/slack_slash_commands.md      |  2 +-
 doc/user/project/issue_board.md               | 18 ++---
 doc/user/project/issues/csv_export.md         |  2 +-
 doc/user/project/issues/index.md              | 10 +--
 .../project/issues/issue_data_and_actions.md  |  8 +-
 doc/user/project/issues/managing_issues.md    |  4 +-
 .../issues/multiple_assignees_for_issues.md   |  2 +-
 doc/user/project/issues/related_issues.md     |  2 +-
 doc/user/project/labels.md                    | 10 +--
 .../browser_performance_testing.md            |  2 +-
 .../project/merge_requests/code_quality.md    |  2 +-
 doc/user/project/merge_requests/index.md      | 38 +++++-----
 .../merge_requests/merge_request_approvals.md | 12 +--
 .../project/milestones/burndown_charts.md     |  2 +-
 doc/user/project/milestones/index.md          | 10 +--
 doc/user/project/operations/feature_flags.md  |  2 +-
 doc/user/project/operations/index.md          |  4 +-
 doc/user/project/operations/tracing.md        |  2 +-
 doc/user/project/packages/maven_repository.md |  4 +-
 doc/user/project/packages/npm_registry.md     |  4 +-
 doc/user/project/pages/introduction.md        |  2 +-
 doc/user/project/protected_branches.md        |  2 +-
 doc/user/project/quick_actions.md             | 20 ++---
 .../repository/gpg_signed_commits/index.md    |  2 +-
 doc/user/project/repository/index.md          |  2 +-
 doc/user/project/service_desk.md              |  2 +-
 doc/user/project/settings/index.md            |  6 +-
 doc/user/project/web_ide/index.md             |  4 +-
 doc/user/search/advanced_global_search.md     |  2 +-
 doc/user/search/advanced_search_syntax.md     |  2 +-
 doc/user/search/index.md                      |  4 +-
 doc/workflow/README.md                        | 12 +--
 doc/workflow/issue_weight.md                  |  2 +-
 doc/workflow/notifications.md                 | 12 +--
 doc/workflow/repository_mirroring.md          | 26 +++----
 doc/workflow/shortcuts.md                     |  2 +-
 doc/workflow/todos.md                         | 12 +--
 216 files changed, 647 insertions(+), 647 deletions(-)

diff --git a/doc/README.md b/doc/README.md
index 5eaa998a7b8..25db0efb960 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -86,7 +86,7 @@ The following documentation relates to the DevOps **Manage** stage:
 
 | Manage Topics                                                                         | Description                                                                                                                                                                                                                  |
 |:--------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| [Authentication and<br/>Authorization](administration/auth/README.md) **[CORE ONLY]** | Supported authentication and authorization providers.                                                                                                                                                                        |
+| [Authentication and<br/>Authorization](administration/auth/README.md) **(CORE ONLY)** | Supported authentication and authorization providers.                                                                                                                                                                        |
 | [GitLab Cycle Analytics](user/project/cycle_analytics.md)                             | Measure the time it takes to go from an [idea to production](https://about.gitlab.com/2016/08/05/continuous-integration-delivery-and-deployment-with-gitlab/#from-idea-to-production-with-gitlab) for each project you have. |
 | [Instance Statistics](user/instance_statistics/index.md)                              | Discover statistics on how many GitLab features you use and user activity.                                                                                                                                                   |
 
@@ -107,18 +107,18 @@ The following documentation relates to the DevOps **Plan** stage:
 
 | Plan Topics                                                                                                                                                                                                                                                        | Description                                                                                                                                      |
 |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------|
-| [Burndown Charts](user/project/milestones/burndown_charts.md) **[STARTER]**                                                                                                                                                                                        | Watch your project's progress throughout a specific milestone.                                                                                   |
+| [Burndown Charts](user/project/milestones/burndown_charts.md) **(STARTER)**                                                                                                                                                                                        | Watch your project's progress throughout a specific milestone.                                                                                   |
 | [Discussions](user/discussions/index.md)                                                                                                                                                                                                                           | Threads, comments, and resolvable discussions in issues, commits, and  merge requests.                                                           |
 | [Due Dates](user/project/issues/due_dates.md)                                                                                                                                                                                                                      | Keep track of issue deadlines.                                                                                                                   |
-| [Epics](user/group/epics/index.md) **[ULTIMATE]**                                                                                                                                                                                                                  | Tracking groups of issues that share a theme.                                                                                                    |
+| [Epics](user/group/epics/index.md) **(ULTIMATE)**                                                                                                                                                                                                                  | Tracking groups of issues that share a theme.                                                                                                    |
 | [Issues](user/project/issues/index.md), including [confidential issues](user/project/issues/confidential_issues.md),<br/>[issue and merge request templates](user/project/description_templates.md),<br/>and [moving issues](user/project/issues/managing_issues.md#moving-issues) | Project issues, restricting access to issues, create templates for submitting new issues and merge requests, and moving issues between projects. |
 | [Labels](user/project/labels.md)                                                                                                                                                                                                                                   | Categorize issues or merge requests with descriptive labels.                                                                                     |
 | [Milestones](user/project/milestones/index.md)                                                                                                                                                                                                                     | Set milestones for delivery of issues and merge requests, with optional due date.                                                                |
 | [Project Issue Board](user/project/issue_board.md)                                                                                                                                                                                                                 | Display issues on a Scrum or Kanban board.                                                                                                       |
 | [Quick Actions](user/project/quick_actions.md)                                                                                                                                                                                                                     | Shortcuts for common actions on issues or merge requests, replacing the need to click buttons or use dropdowns in GitLab's UI.                   |
-| [Related Issues](user/project/issues/related_issues.md) **[STARTER]**                                                                                                                                                                                              | Create a relationship between issues.                                                                                                            |
-| [Roadmap](user/group/roadmap/index.md) **[ULTIMATE]**                                                                                                                                                                                                              | Visualize epic timelines.                                                                                                                        |
-| [Service Desk](user/project/service_desk.md) **[PREMIUM]**                                                                                                                                                                                                         | A simple way to allow people to create issues in your GitLab instance without needing their own user account.                                    |
+| [Related Issues](user/project/issues/related_issues.md) **(STARTER)**                                                                                                                                                                                              | Create a relationship between issues.                                                                                                            |
+| [Roadmap](user/group/roadmap/index.md) **(ULTIMATE)**                                                                                                                                                                                                              | Visualize epic timelines.                                                                                                                        |
+| [Service Desk](user/project/service_desk.md) **(PREMIUM)**                                                                                                                                                                                                         | A simple way to allow people to create issues in your GitLab instance without needing their own user account.                                    |
 | [Time Tracking](workflow/time_tracking.md)                                                                                                                                                                                                                         | Track time spent on issues and merge requests.                                                                                                   |
 | [Todos](workflow/todos.md)                                                                                                                                                                                                                                         | Keep track of work requiring attention with a chronological list displayed on a simple dashboard.                                                |
 
@@ -143,14 +143,14 @@ The following documentation relates to the DevOps **Create** stage:
 
 | Create Topics - Projects and Groups                                                                                                                                                              | Description                                                                                      |
 |:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------------------------|
-| [Advanced global search](user/search/advanced_global_search.md) **[STARTER]**                                                                                                                    | Leverage Elasticsearch for faster, more advanced code search across your entire GitLab instance. |
-| [Advanced syntax search](user/search/advanced_search_syntax.md) **[STARTER]**                                                                                                                    | Use advanced queries for more targeted search results.                                           |
-| [Contribution analytics](user/group/contribution_analytics/index.md) **[STARTER]**                                                                                                               | See detailed statistics of group contributors.                                                   |
+| [Advanced global search](user/search/advanced_global_search.md) **(STARTER)**                                                                                                                    | Leverage Elasticsearch for faster, more advanced code search across your entire GitLab instance. |
+| [Advanced syntax search](user/search/advanced_search_syntax.md) **(STARTER)**                                                                                                                    | Use advanced queries for more targeted search results.                                           |
+| [Contribution analytics](user/group/contribution_analytics/index.md) **(STARTER)**                                                                                                               | See detailed statistics of group contributors.                                                   |
 | [Create](gitlab-basics/create-project.md) and [fork](gitlab-basics/fork-project.md) projects, and<br/>[import and export projects<br/>between instances](user/project/settings/import_export.md) | Create, duplicate, and move projects.                                                            |
-| [File locking](user/project/file_lock.md) **[PREMIUM]**                                                                                                                                          | Lock files to avoid merge conflicts.                                                             |
+| [File locking](user/project/file_lock.md) **(PREMIUM)**                                                                                                                                          | Lock files to avoid merge conflicts.                                                             |
 | [GitLab Pages](user/project/pages/index.md)                                                                                                                                                      | Build, test, and deploy your static website with GitLab Pages.                                   |
 | [Groups](user/group/index.md) and [Subgroups](user/group/subgroups/index.md)                                                                                                                     | Organize your projects in groups.                                                                |
-| [Issues Analytics](user/group/issues_analytics/index.md) **[PREMIUM]**                                                                                                                           | Check how many issues were created per month.                                                    |
+| [Issues Analytics](user/group/issues_analytics/index.md) **(PREMIUM)**                                                                                                                           | Check how many issues were created per month.                                                    |
 | [Projects](user/project/index.md), including [project access](public_access/public_access.md)<br/>and [settings](user/project/settings/index.md)                                                 | Host source code, and control your project's visibility and set configuration.                   |
 | [Search through GitLab](user/search/index.md)                                                                                                                                                    | Search for issues, merge requests, projects, groups, and todos.                                  |
 | [Snippets](user/snippets.md)                                                                                                                                                                     | Snippets allow you to create little bits of code.                                                |
@@ -175,9 +175,9 @@ The following documentation relates to the DevOps **Create** stage:
 | [Files](user/project/repository/index.md#files)                                                                                                                                                                                                                                                             | Files management.                                                               |
 | [Jupyter Notebook files](user/project/repository/index.md#jupyter-notebook-files)                                                                                                                                                                                                                           | GitLab's support for `.ipynb` files.                                            |
 | [Protected branches](user/project/protected_branches.md)                                                                                                                                                                                                                                                    | Use protected branches.                                                         |
-| [Push rules](push_rules/push_rules.md) **[STARTER]**                                                                                                                                                                                                                                                        | Additional control over pushes to your projects.                                |
+| [Push rules](push_rules/push_rules.md) **(STARTER)**                                                                                                                                                                                                                                                        | Additional control over pushes to your projects.                                |
 | [Repositories](user/project/repository/index.md)                                                                                                                                                                                                                                                            | Manage source code repositories in GitLab's user interface.                     |
-| [Repository mirroring](workflow/repository_mirroring.md) **[STARTER]**                                                                                                                                                                                                                                      | Push to or pull from repositories outside of GitLab                             |
+| [Repository mirroring](workflow/repository_mirroring.md) **(STARTER)**                                                                                                                                                                                                                                      | Push to or pull from repositories outside of GitLab                             |
 | [Start a merge request](user/project/repository/web_editor.md#tips)                                                                                                                                                                                                                                         | Start merge request when committing via GitLab's user interface.                |
 
 <div align="right">
@@ -209,7 +209,7 @@ The following documentation relates to the DevOps **Create** stage:
 | [GitLab API](api/README.md)                                                   | Integrate GitLab via a simple and powerful API.                                                                        |
 | [GitLab Integration](integration/README.md)                                   | Integrate with multiple third-party services with GitLab to allow external issue trackers and external authentication. |
 | [GitLab Webhooks](user/project/integrations/webhooks.md)                      | Let GitLab notify you when new code has been pushed to your project.                                                   |
-| [Jira Development Panel](integration/jira_development_panel.md) **[PREMIUM]** | See GitLab information in the Jira Development Panel.                                                                  |
+| [Jira Development Panel](integration/jira_development_panel.md) **(PREMIUM)** | See GitLab information in the Jira Development Panel.                                                                  |
 | [Project Services](user/project/integrations/project_services.md)             | Integrate a project with external services, such as CI and chat.                                                       |
 | [Trello Power-Up](integration/trello_power_up.md)                             | Integrate with GitLab's Trello Power-Up.                                                                               |
 
@@ -233,10 +233,10 @@ The following documentation relates to the DevOps **Verify** stage:
 
 | Verify Topics                                                                     | Description                                                                                             |
 |:----------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------|
-| [Code Quality reports](user/project/merge_requests/code_quality.md) **[STARTER]** | Analyze source code quality.                                                                            |
+| [Code Quality reports](user/project/merge_requests/code_quality.md) **(STARTER)** | Analyze source code quality.                                                                            |
 | [GitLab CI/CD](ci/README.md)                                                      | Explore the features and capabilities of Continuous Integration with GitLab.                            |
 | [JUnit test reports](ci/junit_test_reports.md)                                    | Display JUnit test reports on merge requests.                                                           |
-| [Multi-project pipelines](ci/multi_project_pipelines.md) **[PREMIUM]**            | Visualize entire pipelines that span multiple projects, including all cross-project inter-dependencies. |
+| [Multi-project pipelines](ci/multi_project_pipelines.md) **(PREMIUM)**            | Visualize entire pipelines that span multiple projects, including all cross-project inter-dependencies. |
 | [Pipeline Graphs](ci/pipelines.md#visualizing-pipelines)                          | Visualize builds.                                                                                       |
 | [Review Apps](ci/review_apps/index.md)                                            | Preview changes to your application right from a merge request.                                         |
 
@@ -257,7 +257,7 @@ The following documentation relates to the DevOps **Package** stage:
 | Package Topics                                                  | Description                                            |
 |:----------------------------------------------------------------|:-------------------------------------------------------|
 | [GitLab Container Registry](user/project/container_registry.md) | Learn how to use GitLab's built-in Container Registry. |
-| [GitLab Packages](administration/packages.md) **[PREMIUM]**     | Use GitLab as an NPM registry or Maven repository.     |
+| [GitLab Packages](administration/packages.md) **(PREMIUM)**     | Use GitLab as an NPM registry or Maven repository.     |
 
 <div align="right">
   <a type="button" class="btn btn-default" href="#overview">
@@ -276,10 +276,10 @@ The following documentation relates to the DevOps **Release** stage:
 | Release Topics                                                                                                                      | Description                                                                                                                           |
 |:------------------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------|
 | [Auto Deploy](topics/autodevops/index.md#auto-deploy)                                                                               | Configure GitLab for the deployment of your application.                                                                              |
-| [Canary Deployments](user/project/canary_deployments.md) **[PREMIUM]**                                                              | Employ a popular CI strategy where a small portion of the fleet is updated to the new version first.                                  |
-| [Deploy Boards](user/project/deploy_boards.md) **[PREMIUM]**                                                                        | View the current health and status of each CI environment running on Kubernetes, displaying the status of the pods in the deployment. |
+| [Canary Deployments](user/project/canary_deployments.md) **(PREMIUM)**                                                              | Employ a popular CI strategy where a small portion of the fleet is updated to the new version first.                                  |
+| [Deploy Boards](user/project/deploy_boards.md) **(PREMIUM)**                                                                        | View the current health and status of each CI environment running on Kubernetes, displaying the status of the pods in the deployment. |
 | [Environments and deployments](ci/environments.md)                                                                                  | With environments, you can control the continuous deployment of your software within GitLab.                                          |
-| [Environment-specific variables](ci/variables/README.md#limiting-environment-scopes-of-environment-variables-premium) **[PREMIUM]** | Limit scope of variables to specific environments.                                                                                    |
+| [Environment-specific variables](ci/variables/README.md#limiting-environment-scopes-of-environment-variables-premium) **(PREMIUM)** | Limit scope of variables to specific environments.                                                                                    |
 | [GitLab CI/CD](ci/README.md)                                                                                                        | Explore the features and capabilities of Continuous Deployment and Delivery with GitLab.                                              |
 | [GitLab Pages](user/project/pages/index.md)                                                                                         | Build, test, and deploy a static site directly from GitLab.                                                                           |
 | [Protected Runners](ci/runners/README.md#protected-runners)                                                                         | Select Runners to only pick jobs for protected branches and tags.                                                                     |
@@ -307,7 +307,7 @@ The following documentation relates to the DevOps **Configure** stage:
 | [GitLab ChatOps](ci/chatops/README.md)                                                                                             | Interact with CI/CD jobs through chat services.                           |
 | [Installing Applications](user/project/clusters/index.md#installing-applications)                                                  | Deploy Helm, Ingress, and Prometheus on Kubernetes.                       |
 | [Mattermost slash commands](user/project/integrations/mattermost_slash_commands.md)                                                | Enable and use slash commands from within Mattermost.                     |
-| [Multiple Kubernetes Clusters](user/project/clusters/index.md#multiple-kubernetes-clusters-premium) **[PREMIUM]**                  | Associate more than one Kubernetes clusters to your project.              |
+| [Multiple Kubernetes Clusters](user/project/clusters/index.md#multiple-kubernetes-clusters-premium) **(PREMIUM)**                  | Associate more than one Kubernetes clusters to your project.              |
 | [Protected variables](ci/variables/README.md#protected-environment-variables)                                                      | Restrict variables to protected branches and tags.                        |
 | [Serverless](user/project/clusters/serverless/index.md)                                                                            | Run serverless workloads on Kubernetes.                                   |
 | [Slack slash commands](user/project/integrations/slack_slash_commands.md)                                                          | Enable and use slash commands from within Slack.                          |
@@ -329,8 +329,8 @@ The following documentation relates to the DevOps **Monitor** stage:
 
 | Monitor Topics                                                                                  | Description                                                                                                                              |
 |:------------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------------------------------------|
-| [GitLab Performance Monitoring](administration/monitoring/performance/index.md) **[CORE ONLY]** | Use InfluxDB and Grafana to monitor the performance of your GitLab instance (will be eventually replaced by Prometheus).                 |
-| [GitLab Prometheus](administration/monitoring/prometheus/index.md) **[CORE ONLY]**              | Configure the bundled Prometheus to collect various metrics from your GitLab instance.                                                   |
+| [GitLab Performance Monitoring](administration/monitoring/performance/index.md) **(CORE ONLY)** | Use InfluxDB and Grafana to monitor the performance of your GitLab instance (will be eventually replaced by Prometheus).                 |
+| [GitLab Prometheus](administration/monitoring/prometheus/index.md) **(CORE ONLY)**              | Configure the bundled Prometheus to collect various metrics from your GitLab instance.                                                   |
 | [Health check](user/admin_area/monitoring/health_check.md)                                      | GitLab provides liveness and readiness probes to indicate service health and reachability to required services.                          |
 | [Prometheus project integration](user/project/integrations/prometheus.md)                       | Configure the Prometheus integration per project and monitor your CI/CD environments.                                                    |
 | [Prometheus metrics](user/project/integrations/prometheus_library/index.md)                     | Let Prometheus collect metrics from various services, like Kubernetes, NGINX, NGINX ingress controller, HAProxy, and Amazon Cloud Watch. |
@@ -353,13 +353,13 @@ The following documentation relates to the DevOps **Secure** stage:
 
 | Secure Topics                                                                                         | Description                                                            |
 |:------------------------------------------------------------------------------------------------------|:-----------------------------------------------------------------------|
-| [Container Scanning](user/application_security/container_scanning/index.md) **[ULTIMATE]**            | Use Clair to scan docker images for known vulnerabilities.             |
-| [Dependency Scanning](user/application_security/dependency_scanning/index.md) **[ULTIMATE]**          | Analyze your dependencies for known vulnerabilities.                   |
-| [Dynamic Application Security Testing (DAST)](user/application_security/dast/index.md) **[ULTIMATE]** | Analyze running web applications for known vulnerabilities.            |
-| [Group Security Dashboard](user/application_security/security_dashboard/index.md) **[ULTIMATE]**      | View vulnerabilities in all the projects in a group and its subgroups. |
-| [License Management](user/application_security/license_management/index.md) **[ULTIMATE]**            | Search your project's dependencies for their licenses.                 |
-| [Project Security Dashboard](user/application_security/security_dashboard/index.md) **[ULTIMATE]**    | View the latest security reports for your project.                     |
-| [Static Application Security Testing (SAST)](user/application_security/sast/index.md) **[ULTIMATE]**  | Analyze source code for known vulnerabilities.                         |
+| [Container Scanning](user/application_security/container_scanning/index.md) **(ULTIMATE)**            | Use Clair to scan docker images for known vulnerabilities.             |
+| [Dependency Scanning](user/application_security/dependency_scanning/index.md) **(ULTIMATE)**          | Analyze your dependencies for known vulnerabilities.                   |
+| [Dynamic Application Security Testing (DAST)](user/application_security/dast/index.md) **(ULTIMATE)** | Analyze running web applications for known vulnerabilities.            |
+| [Group Security Dashboard](user/application_security/security_dashboard/index.md) **(ULTIMATE)**      | View vulnerabilities in all the projects in a group and its subgroups. |
+| [License Management](user/application_security/license_management/index.md) **(ULTIMATE)**            | Search your project's dependencies for their licenses.                 |
+| [Project Security Dashboard](user/application_security/security_dashboard/index.md) **(ULTIMATE)**    | View the latest security reports for your project.                     |
+| [Static Application Security Testing (SAST)](user/application_security/sast/index.md) **(ULTIMATE)**  | Analyze source code for known vulnerabilities.                         |
 
 ## Subscribe to GitLab
 
diff --git a/doc/administration/audit_events.md b/doc/administration/audit_events.md
index d7a2e13b53e..ae1f6e00ea5 100644
--- a/doc/administration/audit_events.md
+++ b/doc/administration/audit_events.md
@@ -2,7 +2,7 @@
 last_updated: 2019-02-04
 ---
 
-# Audit Events **[STARTER]**
+# Audit Events **(STARTER)**
 
 GitLab offers a way to view the changes made within the GitLab server for owners and administrators on a [paid plan][ee].
 
@@ -32,7 +32,7 @@ There are two kinds of events logged:
 - Instance events scoped to the whole GitLab instance, used by your Compliance team to
   perform formal audits.
 
-### Group events **[STARTER]**
+### Group events **(STARTER)**
 
 NOTE: **Note:**
 You need Owner [permissions] to view the group Audit Events page.
@@ -59,7 +59,7 @@ From there, you can see the following actions:
 - 2FA enforcement/grace period changed
 - Roles allowed to create project changed
 
-### Project events **[STARTER]**
+### Project events **(STARTER)**
 
 NOTE: **Note:**
 You need Maintainer [permissions] or higher to view the project Audit Events page.
@@ -74,7 +74,7 @@ From there, you can see the following actions:
 - Permission changes of a user assigned to a project
 - User was removed from project
 
-### Instance events **[PREMIUM ONLY]**
+### Instance events **(PREMIUM ONLY)**
 
 > [Introduced][ee-2336] in [GitLab Premium][ee] 9.3.
 
diff --git a/doc/administration/auditor_users.md b/doc/administration/auditor_users.md
index ef8c8197d6d..daba5b4ca82 100644
--- a/doc/administration/auditor_users.md
+++ b/doc/administration/auditor_users.md
@@ -1,4 +1,4 @@
-# Auditor users **[PREMIUM ONLY]**
+# Auditor users **(PREMIUM ONLY)**
 
 >[Introduced][ee-998] in [GitLab Premium][eep] 8.17.
 
diff --git a/doc/administration/auth/README.md b/doc/administration/auth/README.md
index e215a0df6ec..d8094587d14 100644
--- a/doc/administration/auth/README.md
+++ b/doc/administration/auth/README.md
@@ -9,11 +9,11 @@ providers.
 
 - [LDAP](ldap.md) Includes Active Directory, Apple Open Directory, Open LDAP,
   and 389 Server
-  - [LDAP for GitLab EE](ldap-ee.md): LDAP additions to GitLab Enterprise Editions **[STARTER ONLY]**
+  - [LDAP for GitLab EE](ldap-ee.md): LDAP additions to GitLab Enterprise Editions **(STARTER ONLY)**
 - [OmniAuth](../../integration/omniauth.md) Sign in via Twitter, GitHub, GitLab.com, Google,
   Bitbucket, Facebook, Shibboleth, Crowd, Azure, Authentiq ID, and JWT
 - [CAS](../../integration/cas.md) Configure GitLab to sign in using CAS
 - [SAML](../../integration/saml.md) Configure GitLab as a SAML 2.0 Service Provider
 - [Okta](okta.md) Configure GitLab to sign in using Okta
 - [Authentiq](authentiq.md): Enable the Authentiq OmniAuth provider for passwordless authentication
-- [Smartcard](smartcard.md) Smartcard authentication **[PREMIUM ONLY]**
+- [Smartcard](smartcard.md) Smartcard authentication **(PREMIUM ONLY)**
diff --git a/doc/administration/auth/google_secure_ldap.md b/doc/administration/auth/google_secure_ldap.md
index dd9e6ffc14d..1db5bb4bc3f 100644
--- a/doc/administration/auth/google_secure_ldap.md
+++ b/doc/administration/auth/google_secure_ldap.md
@@ -1,4 +1,4 @@
-# Google Secure LDAP **[CORE ONLY]**
+# Google Secure LDAP **(CORE ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/46391) in GitLab 11.9.
 
diff --git a/doc/administration/auth/how_to_configure_ldap_gitlab_ce/index.md b/doc/administration/auth/how_to_configure_ldap_gitlab_ce/index.md
index 1f67e8f5744..320a65b665d 100644
--- a/doc/administration/auth/how_to_configure_ldap_gitlab_ce/index.md
+++ b/doc/administration/auth/how_to_configure_ldap_gitlab_ce/index.md
@@ -111,7 +111,7 @@ The initial configuration of LDAP in GitLab requires changes to the `gitlab.rb`
 
 The two Active Directory specific values are `active_directory: true` and `uid: 'sAMAccountName'`. `sAMAccountName` is an attribute returned by Active Directory used for GitLab usernames. See the example output from `ldapsearch` for a full list of attributes a "person" object (user) has in **AD** - [`ldapsearch` example](#using-ldapsearch-unix)
 
-> Both group_base and admin_group configuration options are only available in GitLab Enterprise Edition. See [GitLab EE - LDAP Features](../how_to_configure_ldap_gitlab_ee/index.html#gitlab-enterprise-edition---ldap-features) **[STARTER ONLY]**
+> Both group_base and admin_group configuration options are only available in GitLab Enterprise Edition. See [GitLab EE - LDAP Features](../how_to_configure_ldap_gitlab_ee/index.html#gitlab-enterprise-edition---ldap-features) **(STARTER ONLY)**
 
 ### Example `gitlab.rb` LDAP
 
@@ -267,4 +267,4 @@ have extended functionalities with LDAP, such as:
 - Updating user permissions
 - Multiple LDAP servers
 
-Read through the article on [LDAP for GitLab EE](../how_to_configure_ldap_gitlab_ee/index.md) **[STARTER ONLY]** for an overview.
+Read through the article on [LDAP for GitLab EE](../how_to_configure_ldap_gitlab_ee/index.md) **(STARTER ONLY)** for an overview.
diff --git a/doc/administration/auth/how_to_configure_ldap_gitlab_ee/index.md b/doc/administration/auth/how_to_configure_ldap_gitlab_ee/index.md
index 4d82a7370bb..2683950f143 100644
--- a/doc/administration/auth/how_to_configure_ldap_gitlab_ee/index.md
+++ b/doc/administration/auth/how_to_configure_ldap_gitlab_ee/index.md
@@ -6,7 +6,7 @@ article_type: admin guide
 date: 2017-05-03
 ---
 
-# How to configure LDAP with GitLab EE **[STARTER ONLY]**
+# How to configure LDAP with GitLab EE **(STARTER ONLY)**
 
 ## Introduction
 
diff --git a/doc/administration/auth/ldap-ee.md b/doc/administration/auth/ldap-ee.md
index b45966fa920..1a8af0827ee 100644
--- a/doc/administration/auth/ldap-ee.md
+++ b/doc/administration/auth/ldap-ee.md
@@ -1,4 +1,4 @@
-# LDAP Additions in GitLab EE **[STARTER ONLY]**
+# LDAP Additions in GitLab EE **(STARTER ONLY)**
 
 This is a continuation of the main [LDAP documentation](ldap.md), detailing LDAP
 features specific to GitLab Enterprise Edition Starter, Premium and Ultimate.
diff --git a/doc/administration/auth/ldap.md b/doc/administration/auth/ldap.md
index 79ac7fe0352..2144f5753a8 100644
--- a/doc/administration/auth/ldap.md
+++ b/doc/administration/auth/ldap.md
@@ -12,7 +12,7 @@ including group membership syncing as well as multiple LDAP servers support.
 
 The information on this page is relevant for both GitLab CE and EE. For more
 details about EE-specific LDAP features, see the
-[LDAP Enterprise Edition documentation](ldap-ee.md). **[STARTER ONLY]**
+[LDAP Enterprise Edition documentation](ldap-ee.md). **(STARTER ONLY)**
 
 ## Security
 
@@ -46,7 +46,7 @@ LDAP-enabled users can always authenticate with Git using their GitLab username
 or email and LDAP password, even if password authentication for Git is disabled
 in the application settings.
 
-## Google Secure LDAP **[CORE ONLY]**
+## Google Secure LDAP **(CORE ONLY)**
 
 > Introduced in GitLab 11.9.
 
@@ -62,7 +62,7 @@ to connect to one GitLab server.
 
 For a complete guide on configuring LDAP with GitLab Community Edition, please check
 the admin guide [How to configure LDAP with GitLab CE](how_to_configure_ldap_gitlab_ce/index.md).
-For GitLab Enterprise Editions, see also [How to configure LDAP with GitLab EE](how_to_configure_ldap_gitlab_ee/index.md). **[STARTER ONLY]**
+For GitLab Enterprise Editions, see also [How to configure LDAP with GitLab EE](how_to_configure_ldap_gitlab_ee/index.md). **(STARTER ONLY)**
 
 To enable LDAP integration you need to add your LDAP server settings in
 `/etc/gitlab/gitlab.rb` or `/home/git/gitlab/config/gitlab.yml` for Omnibus
@@ -387,7 +387,7 @@ group, you can use the following syntax:
 Find more information about this "LDAP_MATCHING_RULE_IN_CHAIN" filter at
 <https://docs.microsoft.com/en-us/windows/desktop/ADSI/search-filter-syntax>. Support for
 nested members in the user filter should not be confused with
-[group sync nested groups support](ldap-ee.md#supported-ldap-group-typesattributes). **[STARTER ONLY]**
+[group sync nested groups support](ldap-ee.md#supported-ldap-group-typesattributes). **(STARTER ONLY)**
 
 Please note that GitLab does not support the custom filter syntax used by
 omniauth-ldap.
diff --git a/doc/administration/auth/smartcard.md b/doc/administration/auth/smartcard.md
index b33c5359b44..2f3289d6102 100644
--- a/doc/administration/auth/smartcard.md
+++ b/doc/administration/auth/smartcard.md
@@ -1,4 +1,4 @@
-# Smartcard authentication **[PREMIUM ONLY]**
+# Smartcard authentication **(PREMIUM ONLY)**
 
 GitLab supports authentication using smartcards.
 
diff --git a/doc/administration/database_load_balancing.md b/doc/administration/database_load_balancing.md
index 2768fa8c027..e76d3b14a40 100644
--- a/doc/administration/database_load_balancing.md
+++ b/doc/administration/database_load_balancing.md
@@ -1,4 +1,4 @@
-# Database Load Balancing **[PREMIUM ONLY]**
+# Database Load Balancing **(PREMIUM ONLY)**
 
 > [Introduced][ee-1283] in [GitLab Premium][eep] 9.0.
 
diff --git a/doc/administration/dependency_proxy.md b/doc/administration/dependency_proxy.md
index 559cb29a487..776c60703fc 100644
--- a/doc/administration/dependency_proxy.md
+++ b/doc/administration/dependency_proxy.md
@@ -1,4 +1,4 @@
-# GitLab Dependency Proxy administration **[PREMIUM ONLY]**
+# GitLab Dependency Proxy administration **(PREMIUM ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/7934) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.11.
 
diff --git a/doc/administration/geo/disaster_recovery/background_verification.md b/doc/administration/geo/disaster_recovery/background_verification.md
index e19cd9bbfec..8eee9427b56 100644
--- a/doc/administration/geo/disaster_recovery/background_verification.md
+++ b/doc/administration/geo/disaster_recovery/background_verification.md
@@ -1,4 +1,4 @@
-# Automatic background verification **[PREMIUM ONLY]**
+# Automatic background verification **(PREMIUM ONLY)**
 
 NOTE: **Note:**
 Automatic background verification of repositories and wikis was added in
diff --git a/doc/administration/geo/disaster_recovery/bring_primary_back.md b/doc/administration/geo/disaster_recovery/bring_primary_back.md
index 9a981b49349..30d35df25c7 100644
--- a/doc/administration/geo/disaster_recovery/bring_primary_back.md
+++ b/doc/administration/geo/disaster_recovery/bring_primary_back.md
@@ -1,4 +1,4 @@
-# Bring a demoted primary node back online **[PREMIUM ONLY]**
+# Bring a demoted primary node back online **(PREMIUM ONLY)**
 
 After a failover, it is possible to fail back to the demoted **primary** node to
 restore your original configuration. This process consists of two steps:
diff --git a/doc/administration/geo/disaster_recovery/index.md b/doc/administration/geo/disaster_recovery/index.md
index 86182b84062..d44e141b66b 100644
--- a/doc/administration/geo/disaster_recovery/index.md
+++ b/doc/administration/geo/disaster_recovery/index.md
@@ -1,4 +1,4 @@
-# Disaster Recovery **[PREMIUM ONLY]**
+# Disaster Recovery **(PREMIUM ONLY)**
 
 Geo replicates your database, your Git repositories, and few other assets.
 We will support and replicate more data in the future, that will enable you to
diff --git a/doc/administration/geo/disaster_recovery/planned_failover.md b/doc/administration/geo/disaster_recovery/planned_failover.md
index c1a95157f8d..393326c3347 100644
--- a/doc/administration/geo/disaster_recovery/planned_failover.md
+++ b/doc/administration/geo/disaster_recovery/planned_failover.md
@@ -1,4 +1,4 @@
-# Disaster recovery for planned failover **[PREMIUM ONLY]**
+# Disaster recovery for planned failover **(PREMIUM ONLY)**
 
 The primary use-case of Disaster Recovery is to ensure business continuity in
 the event of unplanned outage, but it can be used in conjunction with a planned
diff --git a/doc/administration/geo/replication/configuration.md b/doc/administration/geo/replication/configuration.md
index dd5e09c0dd7..0e11dffa0d6 100644
--- a/doc/administration/geo/replication/configuration.md
+++ b/doc/administration/geo/replication/configuration.md
@@ -1,4 +1,4 @@
-# Geo configuration **[PREMIUM ONLY]**
+# Geo configuration **(PREMIUM ONLY)**
 
 ## Configuring a new **secondary** node
 
diff --git a/doc/administration/geo/replication/database.md b/doc/administration/geo/replication/database.md
index 021ed2d9f3c..71a1ce87833 100644
--- a/doc/administration/geo/replication/database.md
+++ b/doc/administration/geo/replication/database.md
@@ -1,4 +1,4 @@
-# Geo database replication **[PREMIUM ONLY]**
+# Geo database replication **(PREMIUM ONLY)**
 
 NOTE: **Note:**
 The following steps are for Omnibus installs only. Using Geo with source-based installs was **deprecated** in GitLab 11.5.
diff --git a/doc/administration/geo/replication/docker_registry.md b/doc/administration/geo/replication/docker_registry.md
index 5b02b861c61..d5c2d2362b1 100644
--- a/doc/administration/geo/replication/docker_registry.md
+++ b/doc/administration/geo/replication/docker_registry.md
@@ -1,4 +1,4 @@
-# Docker Registry for a secondary node **[PREMIUM ONLY]**
+# Docker Registry for a secondary node **(PREMIUM ONLY)**
 
 You can set up a [Docker Registry] on your
 **secondary** Geo node that mirrors the one on the **primary** Geo node.
diff --git a/doc/administration/geo/replication/external_database.md b/doc/administration/geo/replication/external_database.md
index 452e4f490a6..85687d4a648 100644
--- a/doc/administration/geo/replication/external_database.md
+++ b/doc/administration/geo/replication/external_database.md
@@ -1,4 +1,4 @@
-# Geo with external PostgreSQL instances **[PREMIUM ONLY]**
+# Geo with external PostgreSQL instances **(PREMIUM ONLY)**
 
 This document is relevant if you are using a PostgreSQL instance that is *not
 managed by Omnibus*. This includes cloud-managed instances like AWS RDS, or
diff --git a/doc/administration/geo/replication/faq.md b/doc/administration/geo/replication/faq.md
index c527248bc72..b3580a706c3 100644
--- a/doc/administration/geo/replication/faq.md
+++ b/doc/administration/geo/replication/faq.md
@@ -1,4 +1,4 @@
-# Geo Frequently Asked Questions **[PREMIUM ONLY]**
+# Geo Frequently Asked Questions **(PREMIUM ONLY)**
 
 ## What are the minimum requirements to run Geo?
 
diff --git a/doc/administration/geo/replication/high_availability.md b/doc/administration/geo/replication/high_availability.md
index 61e18df2480..c737fa37077 100644
--- a/doc/administration/geo/replication/high_availability.md
+++ b/doc/administration/geo/replication/high_availability.md
@@ -1,4 +1,4 @@
-# Geo High Availability **[PREMIUM ONLY]**
+# Geo High Availability **(PREMIUM ONLY)**
 
 This document describes a minimal reference architecture for running Geo
 in a high availability configuration. If your HA setup differs from the one
diff --git a/doc/administration/geo/replication/index.md b/doc/administration/geo/replication/index.md
index 8e1d1cb46ba..5cfa6bcae56 100644
--- a/doc/administration/geo/replication/index.md
+++ b/doc/administration/geo/replication/index.md
@@ -1,4 +1,4 @@
-# Geo Replication **[PREMIUM ONLY]**
+# Geo Replication **(PREMIUM ONLY)**
 
 Geo is the solution for widely distributed development teams.
 
diff --git a/doc/administration/geo/replication/object_storage.md b/doc/administration/geo/replication/object_storage.md
index 17446c24904..878b67a8f8e 100644
--- a/doc/administration/geo/replication/object_storage.md
+++ b/doc/administration/geo/replication/object_storage.md
@@ -1,4 +1,4 @@
-# Geo with Object storage **[PREMIUM ONLY]**
+# Geo with Object storage **(PREMIUM ONLY)**
 
 Geo can be used in combination with Object Storage (AWS S3, or
 other compatible object storage).
diff --git a/doc/administration/geo/replication/remove_geo_node.md b/doc/administration/geo/replication/remove_geo_node.md
index 6bdaad8f783..4f64e21f8ef 100644
--- a/doc/administration/geo/replication/remove_geo_node.md
+++ b/doc/administration/geo/replication/remove_geo_node.md
@@ -1,4 +1,4 @@
-# Removing secondary Geo nodes **[PREMIUM ONLY]**
+# Removing secondary Geo nodes **(PREMIUM ONLY)**
 
 **Secondary** nodes can be removed from the Geo cluster using the Geo admin page of the **primary** node. To remove a **secondary** node:
 
diff --git a/doc/administration/geo/replication/security_review.md b/doc/administration/geo/replication/security_review.md
index cd54e2dc8c4..7c21a348e23 100644
--- a/doc/administration/geo/replication/security_review.md
+++ b/doc/administration/geo/replication/security_review.md
@@ -1,4 +1,4 @@
-# Geo security review (Q&A) **[PREMIUM ONLY]**
+# Geo security review (Q&A) **(PREMIUM ONLY)**
 
 The following security review of the Geo feature set focuses on security
 aspects of the feature as they apply to customers running their own GitLab
diff --git a/doc/administration/geo/replication/troubleshooting.md b/doc/administration/geo/replication/troubleshooting.md
index c7c78407084..28abfff973d 100644
--- a/doc/administration/geo/replication/troubleshooting.md
+++ b/doc/administration/geo/replication/troubleshooting.md
@@ -1,4 +1,4 @@
-# Geo Troubleshooting **[PREMIUM ONLY]**
+# Geo Troubleshooting **(PREMIUM ONLY)**
 
 Setting up Geo requires careful attention to details and sometimes it's easy to
 miss a step.
diff --git a/doc/administration/geo/replication/tuning.md b/doc/administration/geo/replication/tuning.md
index 1943f2230df..3ee9937774a 100644
--- a/doc/administration/geo/replication/tuning.md
+++ b/doc/administration/geo/replication/tuning.md
@@ -1,4 +1,4 @@
-# Tuning Geo **[PREMIUM ONLY]**
+# Tuning Geo **(PREMIUM ONLY)**
 
 ## Changing the sync capacity values
 
diff --git a/doc/administration/geo/replication/updating_the_geo_nodes.md b/doc/administration/geo/replication/updating_the_geo_nodes.md
index d56a59f4967..c27f6c78455 100644
--- a/doc/administration/geo/replication/updating_the_geo_nodes.md
+++ b/doc/administration/geo/replication/updating_the_geo_nodes.md
@@ -1,4 +1,4 @@
-# Updating the Geo nodes **[PREMIUM ONLY]**
+# Updating the Geo nodes **(PREMIUM ONLY)**
 
 Depending on which version of Geo you are updating to/from, there may be
 different steps.
diff --git a/doc/administration/geo/replication/using_a_geo_server.md b/doc/administration/geo/replication/using_a_geo_server.md
index f1f1fe48748..55b5d486676 100644
--- a/doc/administration/geo/replication/using_a_geo_server.md
+++ b/doc/administration/geo/replication/using_a_geo_server.md
@@ -1,6 +1,6 @@
 [//]: # (Please update EE::GitLab::GeoGitAccess::GEO_SERVER_DOCS_URL if this file is moved)
 
-# Using a Geo Server **[PREMIUM ONLY]**
+# Using a Geo Server **(PREMIUM ONLY)**
 
 After you set up the [database replication and configure the Geo nodes][req], use your closest GitLab node as you would a normal standalone GitLab instance.
 
diff --git a/doc/administration/high_availability/consul.md b/doc/administration/high_availability/consul.md
index c59ee3d2a58..3bdce7bce5e 100644
--- a/doc/administration/high_availability/consul.md
+++ b/doc/administration/high_availability/consul.md
@@ -1,4 +1,4 @@
-# Working with the bundled Consul service **[PREMIUM ONLY]**
+# Working with the bundled Consul service **(PREMIUM ONLY)**
 
 ## Overview
 
diff --git a/doc/administration/high_availability/database.md b/doc/administration/high_availability/database.md
index 20bbfdb2603..88b5aa883e8 100644
--- a/doc/administration/high_availability/database.md
+++ b/doc/administration/high_availability/database.md
@@ -1,6 +1,6 @@
 # Configuring PostgreSQL for Scaling and High Availability
 
-## Provide your own PostgreSQL instance **[CORE ONLY]**
+## Provide your own PostgreSQL instance **(CORE ONLY)**
 
 If you're hosting GitLab on a cloud provider, you can optionally use a
 managed service for PostgreSQL. For example, AWS offers a managed Relational
@@ -21,14 +21,14 @@ This section is relevant for [Scaled Architecture](README.md#scalable-architectu
 environments including [Basic Scaling](README.md#basic-scaling) and
 [Full Scaling](README.md#full-scaling).
 
-### Provide your own PostgreSQL instance **[CORE ONLY]**
+### Provide your own PostgreSQL instance **(CORE ONLY)**
 
 If you want to use your own deployed PostgreSQL instance(s),
 see [Provide your own PostgreSQL instance](#provide-your-own-postgresql-instance-core-only)
 for more details. However, you can use the GitLab Omnibus package to easily
 deploy the bundled PostgreSQL.
 
-### Standalone PostgreSQL using GitLab Omnibus **[CORE ONLY]**
+### Standalone PostgreSQL using GitLab Omnibus **(CORE ONLY)**
 
 1. SSH into the PostgreSQL server.
 1. [Download/install](https://about.gitlab.com/installation) the Omnibus GitLab
@@ -97,14 +97,14 @@ environments including [Horizontal](README.md#horizontal),
 [Hybrid](README.md#hybrid), and
 [Fully Distributed](README.md#fully-distributed).
 
-### Provide your own PostgreSQL instance **[CORE ONLY]**
+### Provide your own PostgreSQL instance **(CORE ONLY)**
 
 If you want to use your own deployed PostgreSQL instance(s),
 see [Provide your own PostgreSQL instance](#provide-your-own-postgresql-instance-core-only)
 for more details. However, you can use the GitLab Omnibus package to easily
 deploy the bundled PostgreSQL.
 
-### High Availability with GitLab Omnibus **[PREMIUM ONLY]**
+### High Availability with GitLab Omnibus **(PREMIUM ONLY)**
 
 > Important notes:
 >
diff --git a/doc/administration/high_availability/redis.md b/doc/administration/high_availability/redis.md
index 874525dd836..984c9688cdf 100644
--- a/doc/administration/high_availability/redis.md
+++ b/doc/administration/high_availability/redis.md
@@ -1,6 +1,6 @@
 # Configuring Redis for Scaling and High Availability
 
-## Provide your own Redis instance **[CORE ONLY]**
+## Provide your own Redis instance **(CORE ONLY)**
 
 The following are the requirements for providing your own Redis instance:
 
@@ -20,14 +20,14 @@ This section is relevant for [Scaled Architecture](README.md#scalable-architectu
 environments including [Basic Scaling](README.md#basic-scaling) and
 [Full Scaling](README.md#full-scaling).
 
-### Provide your own Redis instance **[CORE ONLY]**
+### Provide your own Redis instance **(CORE ONLY)**
 
 If you want to use your own deployed Redis instance(s),
 see [Provide your own Redis instance](#provide-your-own-redis-instance-core-only)
 for more details. However, you can use the GitLab Omnibus package to easily
 deploy the bundled Redis.
 
-### Standalone Redis using GitLab Omnibus **[CORE ONLY]**
+### Standalone Redis using GitLab Omnibus **(CORE ONLY)**
 
 The GitLab Omnibus package can be used to configure a standalone Redis server.
 In this configuration Redis is not highly available, and represents a single
@@ -89,14 +89,14 @@ environments including [Horizontal](README.md#horizontal),
 [Hybrid](README.md#hybrid), and
 [Fully Distributed](README.md#fully-distributed).
 
-### Provide your own Redis instance **[CORE ONLY]**
+### Provide your own Redis instance **(CORE ONLY)**
 
 If you want to use your own deployed Redis instance(s),
 see [Provide your own Redis instance](#provide-your-own-redis-instance-core-only)
 for more details. However, you can use the GitLab Omnibus package to easily
 deploy the bundled Redis.
 
-### High Availability with GitLab Omnibus **[PREMIUM ONLY]**
+### High Availability with GitLab Omnibus **(PREMIUM ONLY)**
 
 > Experimental Redis Sentinel support was [introduced in GitLab 8.11][ce-1877].
 Starting with 8.14, Redis Sentinel is no longer experimental.
diff --git a/doc/administration/incoming_email.md b/doc/administration/incoming_email.md
index 84a34ae7d6e..53a61358670 100644
--- a/doc/administration/incoming_email.md
+++ b/doc/administration/incoming_email.md
@@ -11,7 +11,7 @@ GitLab has several features based on receiving incoming emails:
   allow GitLab users to create a new merge request by sending an email to a
   user-specific email address.
 - [Service Desk](../user/project/service_desk.md): provide e-mail support to
-  your customers through GitLab. **[PREMIUM]**
+  your customers through GitLab. **(PREMIUM)**
 
 ## Requirements
 
diff --git a/doc/administration/index.md b/doc/administration/index.md
index f480d18ea00..c5909e700c5 100644
--- a/doc/administration/index.md
+++ b/doc/administration/index.md
@@ -2,7 +2,7 @@
 description: 'Learn how to install, configure, update, and maintain your GitLab instance.'
 ---
 
-# Administrator documentation **[CORE ONLY]**
+# Administrator documentation **(CORE ONLY)**
 
 Learn how to administer your self-managed GitLab instance.
 
@@ -32,14 +32,14 @@ Learn how to install, configure, update, and maintain your GitLab instance.
 ### Installing GitLab
 
 - [Install](../install/README.md): Requirements, directory structures, and installation methods.
-  - [Database load balancing](database_load_balancing.md): Distribute database queries among multiple database servers. **[STARTER ONLY]**
-  - [Omnibus support for log forwarding](https://docs.gitlab.com/omnibus/settings/logs.html#udp-log-shipping-gitlab-enterprise-edition-only) **[STARTER ONLY]**
+  - [Database load balancing](database_load_balancing.md): Distribute database queries among multiple database servers. **(STARTER ONLY)**
+  - [Omnibus support for log forwarding](https://docs.gitlab.com/omnibus/settings/logs.html#udp-log-shipping-gitlab-enterprise-edition-only) **(STARTER ONLY)**
 - [High Availability](high_availability/README.md): Configure multiple servers for scaling or high availability.
   - [Installing GitLab HA on Amazon Web Services (AWS)](../install/aws/index.md): Set up GitLab High Availability on Amazon AWS.
-- [Geo](geo/replication/index.md): Replicate your GitLab instance to other geographic locations as a read-only fully operational version. **[PREMIUM ONLY]**
-- [Disaster Recovery](geo/disaster_recovery/index.md): Quickly fail-over to a different site with minimal effort in a disaster situation. **[PREMIUM ONLY]**
-- [Pivotal Tile](../install/pivotal/index.md): Deploy GitLab as a pre-configured appliance using Ops Manager (BOSH) for Pivotal Cloud Foundry. **[PREMIUM ONLY]**
-- [Add License](../user/admin_area/license.md): Upload a license at install time to unlock features that are in paid tiers of GitLab. **[STARTER ONLY]**
+- [Geo](geo/replication/index.md): Replicate your GitLab instance to other geographic locations as a read-only fully operational version. **(PREMIUM ONLY)**
+- [Disaster Recovery](geo/disaster_recovery/index.md): Quickly fail-over to a different site with minimal effort in a disaster situation. **(PREMIUM ONLY)**
+- [Pivotal Tile](../install/pivotal/index.md): Deploy GitLab as a pre-configured appliance using Ops Manager (BOSH) for Pivotal Cloud Foundry. **(PREMIUM ONLY)**
+- [Add License](../user/admin_area/license.md): Upload a license at install time to unlock features that are in paid tiers of GitLab. **(STARTER ONLY)**
 
 ### Configuring GitLab
 
@@ -60,9 +60,9 @@ Learn how to install, configure, update, and maintain your GitLab instance.
 - [Diff limits](../user/admin_area/diff_limits.md): Configure the diff rendering size limits of branch comparison pages.
 - [Merge request diffs storage](merge_request_diffs.md): Configure merge requests diffs external storage.
 - [Broadcast Messages](../user/admin_area/broadcast_messages.md): Send messages to GitLab users through the UI.
-- [Elasticsearch](../integration/elasticsearch.md): Enable Elasticsearch to empower GitLab's Advanced Global Search. Useful when you deal with a huge amount of data. **[STARTER ONLY]**
-- [External Classification Policy Authorization](../user/admin_area/settings/external_authorization.md) **[PREMIUM ONLY]**
-- [Upload a license](../user/admin_area/license.md): Upload a license to unlock features that are in paid tiers of GitLab. **[STARTER ONLY]**
+- [Elasticsearch](../integration/elasticsearch.md): Enable Elasticsearch to empower GitLab's Advanced Global Search. Useful when you deal with a huge amount of data. **(STARTER ONLY)**
+- [External Classification Policy Authorization](../user/admin_area/settings/external_authorization.md) **(PREMIUM ONLY)**
+- [Upload a license](../user/admin_area/license.md): Upload a license to unlock features that are in paid tiers of GitLab. **(STARTER ONLY)**
 - [Admin Area](../user/admin_area/index.md): for self-managed instance-wide configuration and maintenance.
 
 #### Customizing GitLab's appearance
@@ -72,7 +72,7 @@ Learn how to install, configure, update, and maintain your GitLab instance.
 - [Branded login page](../customization/branded_login_page.md): Customize the login page with your own logo, title, and description.
 - [Welcome message](../customization/welcome_message.md): Add a custom welcome message to the sign-in page.
 - ["New Project" page](../customization/new_project_page.md): Customize the text to be displayed on the page that opens whenever your users create a new project.
-- [Additional custom email text](../user/admin_area/settings/email.md#custom-additional-text-premium-only): Add additional custom text to emails sent from GitLab. **[PREMIUM ONLY]**
+- [Additional custom email text](../user/admin_area/settings/email.md#custom-additional-text-premium-only): Add additional custom text to emails sent from GitLab. **(PREMIUM ONLY)**
 
 ### Maintaining GitLab
 
@@ -107,15 +107,15 @@ Learn how to install, configure, update, and maintain your GitLab instance.
 - [Sign-up restrictions](../user/admin_area/settings/sign_up_restrictions.md): block email addresses of specific domains, or whitelist only specific domains.
 - [Access restrictions](../user/admin_area/settings/visibility_and_access_controls.md#enabled-git-access-protocols): Define which Git access protocols can be used to talk to GitLab (SSH, HTTP, HTTPS).
 - [Authentication and Authorization](auth/README.md): Configure external authentication with LDAP, SAML, CAS and additional providers.
-  - [Sync LDAP](auth/ldap-ee.md) **[STARTER ONLY]**
-  - [Kerberos authentication](../integration/kerberos.md) **[STARTER ONLY]**
+  - [Sync LDAP](auth/ldap-ee.md) **(STARTER ONLY)**
+  - [Kerberos authentication](../integration/kerberos.md) **(STARTER ONLY)**
   - See also other [authentication](../topics/authentication/index.md#gitlab-administrators) topics (for example, enforcing 2FA).
-- [Email users](../tools/email.md): Email GitLab users from within GitLab. **[STARTER ONLY]**
+- [Email users](../tools/email.md): Email GitLab users from within GitLab. **(STARTER ONLY)**
 - [User Cohorts](../user/admin_area/user_cohorts.md): Display the monthly cohorts of new users and their activities over time.
 - [Audit logs and events](audit_events.md): View the changes made within the GitLab server for:
-  - Groups and projects. **[STARTER]**
-  - Instances. **[PREMIUM ONLY]**
-- [Auditor users](auditor_users.md): Users with read-only access to all projects, groups, and other resources on the GitLab instance. **[PREMIUM ONLY]**
+  - Groups and projects. **(STARTER)**
+  - Instances. **(PREMIUM ONLY)**
+- [Auditor users](auditor_users.md): Users with read-only access to all projects, groups, and other resources on the GitLab instance. **(PREMIUM ONLY)**
 - [Incoming email](incoming_email.md): Configure incoming emails to allow
   users to [reply by email](reply_by_email.md), create [issues by email](../user/project/issues/managing_issues.md#new-issue-via-email) and
   [merge requests by email](../user/project/merge_requests/index.md#create-new-merge-requests-by-email), and to enable [Service Desk](../user/project/service_desk.md).
@@ -131,15 +131,15 @@ Learn how to install, configure, update, and maintain your GitLab instance.
 - [Gitaly](gitaly/index.md): Configuring Gitaly, GitLab's Git repository storage service.
 - [Default labels](../user/admin_area/labels.md): Create labels that will be automatically added to every new project.
 - [Restrict the use of public or internal projects](../public_access/public_access.md#restricting-the-use-of-public-or-internal-projects): Restrict the use of visibility levels for users when they create a project or a snippet.
-- [Custom project templates](../user/admin_area/custom_project_templates.md): Configure a set of projects to be used as custom templates when creating a new project. **[PREMIUM ONLY]**
-- [Packages](packages.md): Enable GitLab to act as a Maven repository or NPM registry. **[PREMIUM ONLY]**
+- [Custom project templates](../user/admin_area/custom_project_templates.md): Configure a set of projects to be used as custom templates when creating a new project. **(PREMIUM ONLY)**
+- [Packages](packages.md): Enable GitLab to act as a Maven repository or NPM registry. **(PREMIUM ONLY)**
 
 ### Repository settings
 
 - [Repository checks](repository_checks.md): Periodic Git repository checks.
 - [Repository storage paths](repository_storage_paths.md): Manage the paths used to store repositories.
 - [Repository storage rake tasks](raketasks/storage.md): A collection of rake tasks to list and migrate existing projects and attachments associated with it from Legacy storage to Hashed storage.
-- [Limit repository size](../user/admin_area/settings/account_and_limit_settings.md): Set a hard limit for your repositories' size. **[STARTER ONLY]**
+- [Limit repository size](../user/admin_area/settings/account_and_limit_settings.md): Set a hard limit for your repositories' size. **(STARTER ONLY)**
 
 ## Continuous Integration settings
 
@@ -148,7 +148,7 @@ Learn how to install, configure, update, and maintain your GitLab instance.
 - [Job artifacts](job_artifacts.md): Enable, disable, and configure job artifacts (a set of files and directories which are outputted by a job when it completes successfully).
 - [Job traces](job_traces.md): Information about the job traces (logs).
 - [Register Shared and specific Runners](../ci/runners/README.md#registering-a-shared-runner): Learn how to register and configure Shared and specific Runners to your own instance.
-- [Shared Runners pipelines quota](../user/admin_area/settings/continuous_integration.md#shared-runners-pipeline-minutes-quota-starter-only): Limit the usage of pipeline minutes for Shared Runners. **[STARTER ONLY]**
+- [Shared Runners pipelines quota](../user/admin_area/settings/continuous_integration.md#shared-runners-pipeline-minutes-quota-starter-only): Limit the usage of pipeline minutes for Shared Runners. **(STARTER ONLY)**
 - [Enable/disable Auto DevOps](../topics/autodevops/index.md#enablingdisabling-auto-devops): Enable or disable Auto DevOps for your instance.
 
 ## Git configuration options
@@ -178,7 +178,7 @@ Learn how to install, configure, update, and maintain your GitLab instance.
 
 ## Analytics
 
-- [Pseudonymizer](pseudonymizer.md): Export data from GitLab's database to CSV files in a secure way. **[ULTIMATE]**
+- [Pseudonymizer](pseudonymizer.md): Export data from GitLab's database to CSV files in a secure way. **(ULTIMATE)**
 
 ## Troubleshooting
 
diff --git a/doc/administration/instance_review.md b/doc/administration/instance_review.md
index b1244f44e95..ab6a4646a71 100644
--- a/doc/administration/instance_review.md
+++ b/doc/administration/instance_review.md
@@ -1,4 +1,4 @@
-# Instance Review **[CORE ONLY]**
+# Instance Review **(CORE ONLY)**
 
 > [Introduced][6995] in [GitLab Core][ee] 11.3.
 
diff --git a/doc/administration/issue_closing_pattern.md b/doc/administration/issue_closing_pattern.md
index 9c352096ecc..f2877c49d05 100644
--- a/doc/administration/issue_closing_pattern.md
+++ b/doc/administration/issue_closing_pattern.md
@@ -1,4 +1,4 @@
-# Issue closing pattern **[CORE ONLY]**
+# Issue closing pattern **(CORE ONLY)**
 
 >**Note:**
 This is the administration documentation.
diff --git a/doc/administration/merge_request_diffs.md b/doc/administration/merge_request_diffs.md
index 5e9ba4f640f..65b8c0000ce 100644
--- a/doc/administration/merge_request_diffs.md
+++ b/doc/administration/merge_request_diffs.md
@@ -1,4 +1,4 @@
-# Merge request diffs storage **[CORE ONLY]**
+# Merge request diffs storage **(CORE ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/52568) in GitLab 11.8.
 
diff --git a/doc/administration/monitoring/prometheus/gitlab_metrics.md b/doc/administration/monitoring/prometheus/gitlab_metrics.md
index f09548aa024..89501f20d99 100644
--- a/doc/administration/monitoring/prometheus/gitlab_metrics.md
+++ b/doc/administration/monitoring/prometheus/gitlab_metrics.md
@@ -49,7 +49,7 @@ The following metrics are available:
 | unicorn_queued_connections        | Gauge     | 11.0  | The number of queued Unicorn connections |
 | unicorn_workers                   | Gauge     | 12.0  | The number of Unicorn workers |
 
-## Sidekiq Metrics available for Geo **[PREMIUM]**
+## Sidekiq Metrics available for Geo **(PREMIUM)**
 
 Sidekiq jobs may also gather metrics, and these metrics can be accessed if the Sidekiq exporter is enabled (e.g. via
 the `monitoring.sidekiq_exporter` configuration option in `gitlab.yml`.
diff --git a/doc/administration/operations/extra_sidekiq_processes.md b/doc/administration/operations/extra_sidekiq_processes.md
index 7297507f599..a16cd5166b7 100644
--- a/doc/administration/operations/extra_sidekiq_processes.md
+++ b/doc/administration/operations/extra_sidekiq_processes.md
@@ -1,4 +1,4 @@
-# Extra Sidekiq processes **[STARTER ONLY]**
+# Extra Sidekiq processes **(STARTER ONLY)**
 
 NOTE: **Note:**
 The information in this page applies only to Omnibus GitLab.
diff --git a/doc/administration/operations/fast_ssh_key_lookup.md b/doc/administration/operations/fast_ssh_key_lookup.md
index 5a3a0c34038..b329abdca08 100644
--- a/doc/administration/operations/fast_ssh_key_lookup.md
+++ b/doc/administration/operations/fast_ssh_key_lookup.md
@@ -30,7 +30,7 @@ instructions will break installations using older versions of OpenSSH, such as
 those included with CentOS 6 as of September 2017. If you want to use this
 feature for CentOS 6, follow [the instructions on how to build and install a custom OpenSSH package](#compiling-a-custom-version-of-openssh-for-centos-6) before continuing.
 
-## Fast lookup is required for Geo **[PREMIUM]**
+## Fast lookup is required for Geo **(PREMIUM)**
 
 By default, GitLab manages an `authorized_keys` file, which contains all the
 public SSH keys for users allowed to access GitLab. However, to maintain a
diff --git a/doc/administration/operations/index.md b/doc/administration/operations/index.md
index df795a48169..df208b3f427 100644
--- a/doc/administration/operations/index.md
+++ b/doc/administration/operations/index.md
@@ -11,7 +11,7 @@ Keep your GitLab instance up and running smoothly.
   by GitLab to another file system or another server.
 - [Sidekiq MemoryKiller](sidekiq_memory_killer.md): Configure Sidekiq MemoryKiller
   to restart Sidekiq.
-- [Extra Sidekiq operations](extra_sidekiq_processes.md): Configure an extra set of Sidekiq processes to ensure certain queues always have dedicated workers, no matter the amount of jobs that need to be processed. **[STARTER ONLY]**
+- [Extra Sidekiq operations](extra_sidekiq_processes.md): Configure an extra set of Sidekiq processes to ensure certain queues always have dedicated workers, no matter the amount of jobs that need to be processed. **(STARTER ONLY)**
 - [Unicorn](unicorn.md): Understand Unicorn and unicorn-worker-killer.
 - Speed up SSH operations by [Authorizing SSH users via a fast,
   indexed lookup to the GitLab database](fast_ssh_key_lookup.md), and/or
diff --git a/doc/administration/packages.md b/doc/administration/packages.md
index 0d5f784b71e..cc7d76d61f6 100644
--- a/doc/administration/packages.md
+++ b/doc/administration/packages.md
@@ -1,4 +1,4 @@
-# GitLab Packages administration **[PREMIUM ONLY]**
+# GitLab Packages administration **(PREMIUM ONLY)**
 
 GitLab Packages allows organizations to utilize GitLab as a private repository
 for a variety of common package managers. Users are able to build and publish
diff --git a/doc/administration/pseudonymizer.md b/doc/administration/pseudonymizer.md
index 036e1d3fe61..faa565118ce 100644
--- a/doc/administration/pseudonymizer.md
+++ b/doc/administration/pseudonymizer.md
@@ -1,4 +1,4 @@
-# Pseudonymizer **[ULTIMATE]**
+# Pseudonymizer **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/5532) in [GitLab Ultimate][ee] 11.1.
 
diff --git a/doc/administration/raketasks/geo.md b/doc/administration/raketasks/geo.md
index 9f3b31442f3..435aed8c413 100644
--- a/doc/administration/raketasks/geo.md
+++ b/doc/administration/raketasks/geo.md
@@ -1,4 +1,4 @@
-# Geo Rake Tasks **[PREMIUM ONLY]**
+# Geo Rake Tasks **(PREMIUM ONLY)**
 
 ## Git housekeeping
 
diff --git a/doc/administration/raketasks/project_import_export.md b/doc/administration/raketasks/project_import_export.md
index 6ca23aabdec..0599e12b913 100644
--- a/doc/administration/raketasks/project_import_export.md
+++ b/doc/administration/raketasks/project_import_export.md
@@ -1,4 +1,4 @@
-# Project import/export administration **[CORE ONLY]**
+# Project import/export administration **(CORE ONLY)**
 
 >**Note:**
 >
diff --git a/doc/administration/uploads.md b/doc/administration/uploads.md
index 708b59a273b..acfc0684f6d 100644
--- a/doc/administration/uploads.md
+++ b/doc/administration/uploads.md
@@ -48,7 +48,7 @@ _The uploads are stored by default in
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 
-### Using object storage **[CORE ONLY]**
+### Using object storage **(CORE ONLY)**
 
 > **Notes:**
 >
diff --git a/doc/api/README.md b/doc/api/README.md
index 23c69deef23..6284bc82e27 100644
--- a/doc/api/README.md
+++ b/doc/api/README.md
@@ -37,16 +37,16 @@ The following API resources are available in the project context:
 | [Issues](issues.md)                                                 | `/projects/:id/issues` (also available for groups and standalone)                                                                                                                                     |
 | [Issues Statistics](issues_statistics.md)                           | `/projects/:id/issues_statistics` (also available for groups and standalone)                                                                                                                          |
 | [Issue boards](boards.md)                                           | `/projects/:id/boards`                                                                                                                                                                                |
-| [Issue links](issue_links.md) **[STARTER]**                         | `/projects/:id/issues/.../links`                                                                                                                                                                      |
+| [Issue links](issue_links.md) **(STARTER)**                         | `/projects/:id/issues/.../links`                                                                                                                                                                      |
 | [Jobs](jobs.md)                                                     | `/projects/:id/jobs`, `/projects/:id/pipelines/.../jobs`                                                                                                                                              |
 | [Labels](labels.md)                                                 | `/projects/:id/labels`                                                                                                                                                                                |
-| [Managed licenses](managed_licenses.md) **[ULTIMATE]**              | `/projects/:id/managed_licenses`                                                                                                                                                                      |
+| [Managed licenses](managed_licenses.md) **(ULTIMATE)**              | `/projects/:id/managed_licenses`                                                                                                                                                                      |
 | [Members](members.md)                                               | `/projects/:id/members` (also available for groups)                                                                                                                                                   |
-| [Merge request approvals](merge_request_approvals.md) **[STARTER]** | `/projects/:id/approvals`, `/projects/:id/merge_requests/.../approvals`                                                                                                                               |
+| [Merge request approvals](merge_request_approvals.md) **(STARTER)** | `/projects/:id/approvals`, `/projects/:id/merge_requests/.../approvals`                                                                                                                               |
 | [Merge requests](merge_requests.md)                                 | `/projects/:id/merge_requests` (also available for groups and standalone)                                                                                                                             |
 | [Notes](notes.md) (comments)                                        | `/projects/:id/issues/.../notes`, `/projects/:id/snippets/.../notes`, `/projects/:id/merge_requests/.../notes` (also available for groups)                                                            |
 | [Notification settings](notification_settings.md)                   | `/projects/:id/notification_settings` (also available for groups and standalone)                                                                                                                      |
-| [Packages](packages.md) **[PREMIUM]**                               | `/projects/:id/packages`                                                                                                                                                                              |
+| [Packages](packages.md) **(PREMIUM)**                               | `/projects/:id/packages`                                                                                                                                                                              |
 | [Pages domains](pages_domains.md)                                   | `/projects/:id/pages` (also available standalone)                                                                                                                                                     |
 | [Pipelines](pipelines.md)                                           | `/projects/:id/pipelines`                                                                                                                                                                             |
 | [Pipeline schedules](pipeline_schedules.md)                         | `/projects/:id/pipeline_schedules`                                                                                                                                                                    |
@@ -71,7 +71,7 @@ The following API resources are available in the project context:
 | [Search](search.md)                                                 | `/projects/:id/search` (also available for groups and standalone)                                                                                                                                     |
 | [Services](services.md)                                             | `/projects/:id/services`                                                                                                                                                                              |
 | [Tags](tags.md)                                                     | `/projects/:id/repository/tags`                                                                                                                                                                       |
-| [Vulnerabilities](vulnerabilities.md) **[ULTIMATE]**                | `/projects/:id/vulnerabilities` (also available for groups)                                                                                                                                           |
+| [Vulnerabilities](vulnerabilities.md) **(ULTIMATE)**                | `/projects/:id/vulnerabilities` (also available for groups)                                                                                                                                           |
 | [Wikis](wikis.md)                                                   | `/projects/:id/wikis`                                                                                                                                                                                 |
 
 ### Group resources
@@ -82,10 +82,10 @@ The following API resources are available in the group context:
 |:-----------------------------------------------------------------|:---------------------------------------------------------------------------------|
 | [Access requests](access_requests.md)                            | `/groups/:id/access_requests/` (also available for projects)                     |
 | [Custom attributes](custom_attributes.md)                        | `/groups/:id/custom_attributes` (also available for projects and users)          |
-| [Discussions](discussions.md) (threaded comments) **[ULTIMATE]** | `/groups/:id/epics/.../discussions` (also available for projects)                |
-| [Epic issues](epic_issues.md) **[ULTIMATE]**                     | `/groups/:id/epics/.../issues`                                                   |
-| [Epic links](epic_links.md) **[ULTIMATE]**                       | `/groups/:id/epics/.../epics`                                                    |
-| [Epics](epics.md) **[ULTIMATE]**                                 | `/groups/:id/epics`                                                              |
+| [Discussions](discussions.md) (threaded comments) **(ULTIMATE)** | `/groups/:id/epics/.../discussions` (also available for projects)                |
+| [Epic issues](epic_issues.md) **(ULTIMATE)**                     | `/groups/:id/epics/.../issues`                                                   |
+| [Epic links](epic_links.md) **(ULTIMATE)**                       | `/groups/:id/epics/.../epics`                                                    |
+| [Epics](epics.md) **(ULTIMATE)**                                 | `/groups/:id/epics`                                                              |
 | [Groups](groups.md)                                              | `/groups`, `/groups/.../subgroups`                                               |
 | [Group badges](group_badges.md)                                  | `/groups/:id/badges`                                                             |
 | [Group issue boards](group_boards.md)                            | `/groups/:id/boards`                                                             |
@@ -115,12 +115,12 @@ The following API resources are available outside of project and group contexts
 | [Deploy keys](deploy_keys.md)                     | `/deploy_keys` (also available for projects)                            |
 | [Events](events.md)                               | `/events`, `/users/:id/events` (also available for projects)            |
 | [Feature flags](features.md)                      | `/features`                                                             |
-| [Geo Nodes](geo_nodes.md) **[PREMIUM ONLY]**      | `/geo_nodes`                                                            |
+| [Geo Nodes](geo_nodes.md) **(PREMIUM ONLY)**      | `/geo_nodes`                                                            |
 | [Import repository from GitHub](import.md)        | `/import/github`                                                        |
 | [Issues](issues.md)                               | `/issues` (also available for groups and projects)                      |
 | [Issues Statistics](issues_statistics.md)         | `/issues_statistics` (also available for groups and projects)           |
 | [Keys](keys.md)                                   | `/keys`                                                                 |
-| [License](license.md) **[CORE ONLY]**             | `/license`                                                              |
+| [License](license.md) **(CORE ONLY)**             | `/license`                                                              |
 | [Markdown](markdown.md)                           | `/markdown`                                                             |
 | [Merge requests](merge_requests.md)               | `/merge_requests` (also available for groups and projects)              |
 | [Namespaces](namespaces.md)                       | `/namespaces`                                                           |
@@ -147,7 +147,7 @@ Endpoints are available for:
 - [GitLab CI YAML templates](templates/gitlab_ci_ymls.md).
 - [Open source license templates](templates/licenses.md).
 
-## SCIM **[SILVER ONLY]**
+## SCIM **(SILVER ONLY)**
 
 [GitLab.com Silver and above](https://about.gitlab.com/pricing/) provides an [SCIM API](scim.md) that implements [the RFC7644 protocol](https://tools.ietf.org/html/rfc7644) and provides
 the `/Users` endpoint. The base URL is: `/api/scim/v2/groups/:group_path/Users/`.
diff --git a/doc/api/boards.md b/doc/api/boards.md
index a96206f5df3..926a0be1d8b 100644
--- a/doc/api/boards.md
+++ b/doc/api/boards.md
@@ -141,7 +141,7 @@ Example response:
   }
 ```
 
-## Create a board **[STARTER]**
+## Create a board **(STARTER)**
 
 Creates a board.
 
@@ -209,7 +209,7 @@ Example response:
   }
 ```
 
-## Update a board **[STARTER]**
+## Update a board **(STARTER)**
 
 > [Introduced][ee-5954] in [GitLab Starter](https://about.gitlab.com/pricing/) 11.1.
 
@@ -291,7 +291,7 @@ Example response:
   }
 ```
 
-## Delete a board **[STARTER]**
+## Delete a board **(STARTER)**
 
 Deletes a board.
 
@@ -405,8 +405,8 @@ POST /projects/:id/boards/:board_id/lists
 | `id` | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
 | `board_id` | integer | yes | The ID of a board |
 | `label_id` | integer | no | The ID of a label |
-| `assignee_id` **[PREMIUM]** | integer | no | The ID of a user |
-| `milestone_id` **[PREMIUM]** | integer | no | The ID of a milestone |
+| `assignee_id` **(PREMIUM)** | integer | no | The ID of a user |
+| `milestone_id` **(PREMIUM)** | integer | no | The ID of a milestone |
 
 NOTE: **Note**:
 Label, assignee and milestone arguments are mutually exclusive,
diff --git a/doc/api/discussions.md b/doc/api/discussions.md
index 9defef4fd53..208b8dca2e2 100644
--- a/doc/api/discussions.md
+++ b/doc/api/discussions.md
@@ -4,7 +4,7 @@ Discussions are a set of related notes on:
 
 - Snippets
 - Issues
-- Epics **[ULTIMATE]**
+- Epics **(ULTIMATE)**
 - Merge requests
 - Commits
 
@@ -430,7 +430,7 @@ Parameters:
 curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/projects/5/snippets/11/discussions/636
 ```
 
-## Epics **[ULTIMATE]**
+## Epics **(ULTIMATE)**
 
 ### List group epic discussions
 
diff --git a/doc/api/epic_issues.md b/doc/api/epic_issues.md
index ec59ea7068e..02317cc6c09 100644
--- a/doc/api/epic_issues.md
+++ b/doc/api/epic_issues.md
@@ -1,4 +1,4 @@
-# Epic Issues API **[ULTIMATE]**
+# Epic Issues API **(ULTIMATE)**
 
 Every API call to epic_issues must be authenticated.
 
diff --git a/doc/api/epic_links.md b/doc/api/epic_links.md
index 9ad90a6d0f1..6089198e46a 100644
--- a/doc/api/epic_links.md
+++ b/doc/api/epic_links.md
@@ -1,4 +1,4 @@
-# Epic Links API **[ULTIMATE]**
+# Epic Links API **(ULTIMATE)**
 
 >**Note:**
 > This endpoint was [introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/9188) in GitLab 11.8.
diff --git a/doc/api/epics.md b/doc/api/epics.md
index 0541cfaa715..563f6feb546 100644
--- a/doc/api/epics.md
+++ b/doc/api/epics.md
@@ -1,4 +1,4 @@
-# Epics API **[ULTIMATE]**
+# Epics API **(ULTIMATE)**
 
 Every API call to epic must be authenticated.
 
diff --git a/doc/api/geo_nodes.md b/doc/api/geo_nodes.md
index ea31abdd87e..ac64cbedf7d 100644
--- a/doc/api/geo_nodes.md
+++ b/doc/api/geo_nodes.md
@@ -1,4 +1,4 @@
-# Geo Nodes API **[PREMIUM ONLY]**
+# Geo Nodes API **(PREMIUM ONLY)**
 
 In order to interact with Geo node endpoints, you need to authenticate yourself
 as an admin.
diff --git a/doc/api/graphql/index.md b/doc/api/graphql/index.md
index 6c1cce620ca..3bf96e279b7 100644
--- a/doc/api/graphql/index.md
+++ b/doc/api/graphql/index.md
@@ -46,7 +46,7 @@ curl --data "value=100" --header "PRIVATE-TOKEN: <your_access_token>" https://gi
 A first iteration of a GraphQL API includes the following queries
 
 1. `project` : Within a project it is also possible to fetch a `mergeRequest` by IID.
-1. `group` : Basic group information and epics **[ULTIMATE]** are currently supported.
+1. `group` : Basic group information and epics **(ULTIMATE)** are currently supported.
 1. `namespace` : Within a namespace it is also possible to fetch `projects`.
 
 ### Multiplex queries
diff --git a/doc/api/group_boards.md b/doc/api/group_boards.md
index 4157b25477f..4d10f83720b 100644
--- a/doc/api/group_boards.md
+++ b/doc/api/group_boards.md
@@ -236,7 +236,7 @@ Example response:
   }
 ```
 
-## Create a group issue board **[PREMIUM]**
+## Create a group issue board **(PREMIUM)**
 
 Creates a Group Issue Board.
 
@@ -300,7 +300,7 @@ Example response:
   }
 ```
 
-## Update a group issue board **[PREMIUM]**
+## Update a group issue board **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/5954) in GitLab 11.1.
 
@@ -368,7 +368,7 @@ Example response:
   }
 ```
 
-## Delete a group issue board **[PREMIUM]**
+## Delete a group issue board **(PREMIUM)**
 
 Deletes a Group Issue Board.
 
diff --git a/doc/api/group_milestones.md b/doc/api/group_milestones.md
index 98e81217875..a819e06bcd9 100644
--- a/doc/api/group_milestones.md
+++ b/doc/api/group_milestones.md
@@ -137,7 +137,7 @@ Parameters:
 
 [ce-12819]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/12819
 
-## Get all burndown chart events for a single milestone **[STARTER]**
+## Get all burndown chart events for a single milestone **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/4737) in GitLab 12.1
 
diff --git a/doc/api/groups.md b/doc/api/groups.md
index e1bf296bc41..d05e4b29fef 100644
--- a/doc/api/groups.md
+++ b/doc/api/groups.md
@@ -434,8 +434,8 @@ Parameters:
 | `lfs_enabled`                        | boolean | no       | Enable/disable Large File Storage (LFS) for the projects in this group. |
 | `request_access_enabled`             | boolean | no       | Allow users to request member access. |
 | `parent_id`                          | integer | no       | The parent group ID for creating nested group. |
-| `shared_runners_minutes_limit`       | integer | no       | **[STARTER ONLY]** Pipeline minutes quota for this group. |
-| `extra_shared_runners_minutes_limit` | integer | no       | **[STARTER ONLY]** Extra pipeline minutes quota for this group. |
+| `shared_runners_minutes_limit`       | integer | no       | **(STARTER ONLY)** Pipeline minutes quota for this group. |
+| `extra_shared_runners_minutes_limit` | integer | no       | **(STARTER ONLY)** Extra pipeline minutes quota for this group. |
 
 ## Transfer project to group
 
@@ -466,14 +466,14 @@ PUT /groups/:id
 | `name`                               | string  | no       | The name of the group. |
 | `path`                               | string  | no       | The path of the group. |
 | `description`                        | string  | no       | The description of the group. |
-| `membership_lock`                    | boolean | no       | **[STARTER]** Prevent adding new members to project membership within this group. |
+| `membership_lock`                    | boolean | no       | **(STARTER)** Prevent adding new members to project membership within this group. |
 | `share_with_group_lock`              | boolean | no       | Prevent sharing a project with another group within this group. |
 | `visibility`                         | string  | no       | The visibility level of the group. Can be `private`, `internal`, or `public`. |
 | `lfs_enabled` (optional)             | boolean | no       | Enable/disable Large File Storage (LFS) for the projects in this group. |
 | `request_access_enabled`             | boolean | no       | Allow users to request member access. |
-| `file_template_project_id`           | integer | no       | **[PREMIUM]** The ID of a project to load custom file templates from. |
-| `shared_runners_minutes_limit`       | integer | no       | **[STARTER ONLY]** Pipeline minutes quota for this group. |
-| `extra_shared_runners_minutes_limit` | integer | no       | **[STARTER ONLY]** Extra pipeline minutes quota for this group. |
+| `file_template_project_id`           | integer | no       | **(PREMIUM)** The ID of a project to load custom file templates from. |
+| `shared_runners_minutes_limit`       | integer | no       | **(STARTER ONLY)** Pipeline minutes quota for this group. |
+| `extra_shared_runners_minutes_limit` | integer | no       | **(STARTER ONLY)** Extra pipeline minutes quota for this group. |
 
 ```bash
 curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/5?name=Experimental"
@@ -573,7 +573,7 @@ GET /groups?search=foobar
 ]
 ```
 
-## Sync group with LDAP **[CORE ONLY]**
+## Sync group with LDAP **(CORE ONLY)**
 
 Syncs the group with its linked LDAP group. Only available to group owners and administrators.
 
@@ -589,7 +589,7 @@ Parameters:
 
 Please consult the [Group Members](members.md) documentation.
 
-### Add LDAP group link **[CORE ONLY]**
+### Add LDAP group link **(CORE ONLY)**
 
 Adds an LDAP group link.
 
@@ -604,7 +604,7 @@ Parameters:
 - `group_access` (required) - Minimum access level for members of the LDAP group
 - `provider` (required) - LDAP provider for the LDAP group
 
-### Delete LDAP group link **[CORE ONLY]**
+### Delete LDAP group link **(CORE ONLY)**
 
 Deletes an LDAP group link.
 
diff --git a/doc/api/issue_links.md b/doc/api/issue_links.md
index 1c7db6a8e4c..31776568b8e 100644
--- a/doc/api/issue_links.md
+++ b/doc/api/issue_links.md
@@ -1,4 +1,4 @@
-# Issue links API **[STARTER]**
+# Issue links API **(STARTER)**
 
 ## List issue relations
 
diff --git a/doc/api/issues.md b/doc/api/issues.md
index 544da1e262c..6952426c322 100644
--- a/doc/api/issues.md
+++ b/doc/api/issues.md
@@ -47,7 +47,7 @@ GET /issues?confidential=true
 | `assignee_id`       | integer          | no         | Return issues assigned to the given user `id`. Mutually exclusive with `assignee_username`. `None` returns unassigned issues. `Any` returns issues with an assignee. _([Introduced][ce-13004] in GitLab 9.5)_ |
 | `assignee_username` | string array     | no         | Return issues assigned to the given `username`. Similar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
 | `my_reaction_emoji` | string           | no         | Return issues reacted by the authenticated user by the given `emoji`. `None` returns issues not given a reaction. `Any` returns issues given at least one reaction. _([Introduced][ce-14016] in GitLab 10.0)_ |
-| `weight` **[STARTER]** | integer       | no         | Return issues with the specified `weight`. `None` returns issues with no weight assigned. `Any` returns issues with a weight assigned.              |
+| `weight` **(STARTER)** | integer       | no         | Return issues with the specified `weight`. `None` returns issues with no weight assigned. `Any` returns issues with a weight assigned.              |
 | `iids[]`            | integer array    | no         | Return only the issues having the given `iid`                                                                                                       |
 | `order_by`          | string           | no         | Return issues ordered by `created_at` or `updated_at` fields. Default is `created_at`                                                               |
 | `sort`              | string           | no         | Return issues sorted in `asc` or `desc` order. Default is `desc`                                                                                    |
@@ -198,7 +198,7 @@ GET /groups/:id/issues?confidential=true
 | `assignee_id`       | integer          | no         | Return issues assigned to the given user `id`. Mutually exclusive with `assignee_username`. `None` returns unassigned issues. `Any` returns issues with an assignee. _([Introduced][ce-13004] in GitLab 9.5)_ |
 | `assignee_username` | string array     | no         | Return issues assigned to the given `username`. Similar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
 | `my_reaction_emoji` | string           | no         | Return issues reacted by the authenticated user by the given `emoji`. `None` returns issues not given a reaction. `Any` returns issues given at least one reaction. _([Introduced][ce-14016] in GitLab 10.0)_ |
-| `weight` **[STARTER]** | integer       | no         | Return issues with the specified `weight`. `None` returns issues with no weight assigned. `Any` returns issues with a weight assigned. |
+| `weight` **(STARTER)** | integer       | no         | Return issues with the specified `weight`. `None` returns issues with no weight assigned. `Any` returns issues with a weight assigned. |
 | `order_by`          | string           | no         | Return issues ordered by `created_at` or `updated_at` fields. Default is `created_at`                                         |
 | `sort`              | string           | no         | Return issues sorted in `asc` or `desc` order. Default is `desc`                                                              |
 | `search`            | string           | no         | Search group issues against their `title` and `description`                                                                   |
@@ -347,7 +347,7 @@ GET /projects/:id/issues?confidential=true
 | `assignee_id`       | integer          | no         | Return issues assigned to the given user `id`. Mutually exclusive with `assignee_username`. `None` returns unassigned issues. `Any` returns issues with an assignee. _([Introduced][ce-13004] in GitLab 9.5)_ |
 | `assignee_username` | string array     | no         | Return issues assigned to the given `username`. Similar to `assignee_id` and mutually exclusive with `assignee_id`. In CE version `assignee_username` array should only contain a single value or an invalid param error will be returned otherwise. |
 | `my_reaction_emoji` | string           | no         | Return issues reacted by the authenticated user by the given `emoji`. `None` returns issues not given a reaction. `Any` returns issues given at least one reaction. _([Introduced][ce-14016] in GitLab 10.0)_ |
-| `weight` **[STARTER]** | integer       | no         | Return issues with the specified `weight`. `None` returns issues with no weight assigned. `Any` returns issues with a weight assigned. |
+| `weight` **(STARTER)** | integer       | no         | Return issues with the specified `weight`. `None` returns issues with no weight assigned. `Any` returns issues with a weight assigned. |
 | `order_by`          | string           | no         | Return issues ordered by `created_at` or `updated_at` fields. Default is `created_at`                                         |
 | `sort`              | string           | no         | Return issues sorted in `asc` or `desc` order. Default is `desc`                                                              |
 | `search`            | string           | no         | Search project issues against their `title` and `description`                                                                 |
@@ -603,7 +603,7 @@ POST /projects/:id/issues
 | `due_date`                                | string         | no       | Date time string in the format YEAR-MONTH-DAY, e.g. `2016-03-11` |
 | `merge_request_to_resolve_discussions_of` | integer        | no       | The IID of a merge request in which to resolve all issues. This will fill the issue with a default description and mark all discussions as resolved. When passing a description or title, these values will take precedence over the default values.|
 | `discussion_to_resolve`                   | string         | no       | The ID of a discussion to resolve. This will fill in the issue with a default description and mark the discussion as resolved. Use in combination with `merge_request_to_resolve_discussions_of`. |
-| `weight` **[STARTER]**                    | integer        | no       | The weight of the issue. Valid values are greater than or equal to 0. |
+| `weight` **(STARTER)**                    | integer        | no       | The weight of the issue. Valid values are greater than or equal to 0. |
 
 ```bash
 curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/projects/4/issues?title=Issues%20with%20auth&labels=bug
@@ -703,7 +703,7 @@ PUT /projects/:id/issues/:issue_iid
 | `state_event`  | string  | no       | The state event of an issue. Set `close` to close the issue and `reopen` to reopen it                      |
 | `updated_at`   | string  | no       | Date time string, ISO 8601 formatted, e.g. `2016-03-11T03:45:40Z` (requires admin or project owner rights) |
 | `due_date`     | string  | no       | Date time string in the format YEAR-MONTH-DAY, e.g. `2016-03-11`                                           |
-| `weight` **[STARTER]** | integer | no | The weight of the issue. Valid values are greater than or equal to 0. 0                                                                    |
+| `weight` **(STARTER)** | integer | no | The weight of the issue. Valid values are greater than or equal to 0. 0                                                                    |
 | `discussion_locked` | boolean | no  | Flag indicating if the issue's discussion is locked. If the discussion is locked only project members can add or edit comments. |
 
 ```bash
diff --git a/doc/api/jobs.md b/doc/api/jobs.md
index 223bfed91a9..bb8df6187a9 100644
--- a/doc/api/jobs.md
+++ b/doc/api/jobs.md
@@ -359,7 +359,7 @@ GET /projects/:id/jobs/:job_id/artifacts
 |-------------|----------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------|
 | `id`        | integer/string | yes      | ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user.                                |
 | `job_id`    | integer        | yes      | ID of a job.                                                                                                                                |
-| `job_token` **[PREMIUM]** | string         | no       | To be used with [triggers] for multi-project pipelines. It should be invoked only inside `.gitlab-ci.yml`. Its value is always `$CI_JOB_TOKEN`. |
+| `job_token` **(PREMIUM)** | string         | no       | To be used with [triggers] for multi-project pipelines. It should be invoked only inside `.gitlab-ci.yml`. Its value is always `$CI_JOB_TOKEN`. |
 
 Example request using the `PRIVATE-TOKEN` header:
 
@@ -368,7 +368,7 @@ curl --output artifacts.zip --header "PRIVATE-TOKEN: <your_access_token>" "https
 ```
 
 To use this in a [`script` definition](../ci/yaml/README.md#script) inside
-`.gitlab-ci.yml` **[PREMIUM]**, you can use either:
+`.gitlab-ci.yml` **(PREMIUM)**, you can use either:
 
 - The `JOB-TOKEN` header with the GitLab-provided `CI_JOB_TOKEN` variable.
   For example, the following job will download the artifacts of the job with ID
@@ -425,7 +425,7 @@ Parameters
 | `id`        | integer/string | yes      | ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user.                                |
 | `ref_name`  | string         | yes      | Branch or tag name in repository. HEAD or SHA references are not supported.                                                                     |
 | `job`       | string         | yes      | The name of the job.                                                                                                                            |
-| `job_token` **[PREMIUM]** | string         | no       | To be used with [triggers] for multi-project pipelines. It should be invoked only inside `.gitlab-ci.yml`. Its value is always `$CI_JOB_TOKEN`. |
+| `job_token` **(PREMIUM)** | string         | no       | To be used with [triggers] for multi-project pipelines. It should be invoked only inside `.gitlab-ci.yml`. Its value is always `$CI_JOB_TOKEN`. |
 
 Example request using the `PRIVATE-TOKEN` header:
 
@@ -434,7 +434,7 @@ curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/a
 ```
 
 To use this in a [`script` definition](../ci/yaml/README.md#script) inside
-`.gitlab-ci.yml` **[PREMIUM]**, you can use either:
+`.gitlab-ci.yml` **(PREMIUM)**, you can use either:
 
 - The `JOB-TOKEN` header with the GitLab-provided `CI_JOB_TOKEN` variable.
   For example, the following job will download the artifacts of the `test` job
diff --git a/doc/api/license.md b/doc/api/license.md
index 2a8de64bdbf..02754d63bd4 100644
--- a/doc/api/license.md
+++ b/doc/api/license.md
@@ -1,4 +1,4 @@
-# License **[CORE ONLY]**
+# License **(CORE ONLY)**
 
 In order to interact with license endpoints, you need to authenticate yourself
 as an admin.
diff --git a/doc/api/managed_licenses.md b/doc/api/managed_licenses.md
index 47b193111b6..9521be5abac 100644
--- a/doc/api/managed_licenses.md
+++ b/doc/api/managed_licenses.md
@@ -1,4 +1,4 @@
-# Managed Licenses API **[ULTIMATE]**
+# Managed Licenses API **(ULTIMATE)**
 
 ## List managed licenses
 
diff --git a/doc/api/merge_request_approvals.md b/doc/api/merge_request_approvals.md
index 49aaac06b46..504ce56f569 100644
--- a/doc/api/merge_request_approvals.md
+++ b/doc/api/merge_request_approvals.md
@@ -1,4 +1,4 @@
-# Merge request approvals API **[STARTER]**
+# Merge request approvals API **(STARTER)**
 
 Configuration for approvals on all Merge Requests (MR) in the project. Must be authenticated for all endpoints.
 
@@ -359,7 +359,7 @@ POST /projects/:id/merge_requests/:merge_request_iid/approve
 | `id`                | integer | yes      | The ID of a project     |
 | `merge_request_iid` | integer | yes      | The IID of MR           |
 | `sha`               | string  | no       | The HEAD of the MR      |
-| `approval_password` **[STARTER]** | string  | no      | Current user's password. Required if [**Require user password to approve**](../user/project/merge_requests/merge_request_approvals.md#require-authentication-when-approving-a-merge-request-starter) is enabled in the project settings. |
+| `approval_password` **(STARTER)** | string  | no      | Current user's password. Required if [**Require user password to approve**](../user/project/merge_requests/merge_request_approvals.md#require-authentication-when-approving-a-merge-request-starter) is enabled in the project settings. |
 
 The `sha` parameter works in the same way as
 when [accepting a merge request](merge_requests.md#accept-mr): if it is passed, then it must
diff --git a/doc/api/merge_requests.md b/doc/api/merge_requests.md
index 850e3be42d5..de87e4a0aee 100644
--- a/doc/api/merge_requests.md
+++ b/doc/api/merge_requests.md
@@ -44,7 +44,7 @@ Parameters:
 | `scope`             | string         | no       | Return merge requests for the given scope: `created_by_me`, `assigned_to_me` or `all`. Defaults to `created_by_me`<br> For versions before 11.0, use the now deprecated `created-by-me` or `assigned-to-me` scopes instead. |
 | `author_id`         | integer        | no       | Returns merge requests created by the given user `id`. Combine with `scope=all` or `scope=assigned_to_me`              |
 | `assignee_id`       | integer        | no       | Returns merge requests assigned to the given user `id`. `None` returns unassigned merge requests. `Any` returns merge requests with an assignee. |
-| `approver_ids` **[STARTER]** | Array[integer] | no | Returns merge requests which have specified all the users with the given `id`s as individual approvers. `None` returns merge requests without approvers. `Any` returns merge requests with an approver. |
+| `approver_ids` **(STARTER)** | Array[integer] | no | Returns merge requests which have specified all the users with the given `id`s as individual approvers. `None` returns merge requests without approvers. `Any` returns merge requests with an approver. |
 | `my_reaction_emoji` | string         | no       | Return merge requests reacted by the authenticated user by the given `emoji`. `None` returns issues not given a reaction. `Any` returns issues given at least one reaction. _([Introduced][ce-14016] in GitLab 10.0)_ |
 | `source_branch`     | string         | no       | Return merge requests with the given source branch                                                                     |
 | `target_branch`     | string         | no       | Return merge requests with the given target branch                                                                     |
@@ -206,7 +206,7 @@ Parameters:
 | `scope`             | string         | no       | Return merge requests for the given scope: `created_by_me`, `assigned_to_me` or `all`.<br> For versions before 11.0, use the now deprecated `created-by-me` or `assigned-to-me` scopes instead.<br> _([Introduced][ce-13060] in GitLab 9.5. [Changed to snake_case][ce-18935] in GitLab 11.0)_ |
 | `author_id`         | integer        | no       | Returns merge requests created by the given user `id` _([Introduced][ce-13060] in GitLab 9.5)_                                 |
 | `assignee_id`       | integer        | no       | Returns merge requests assigned to the given user `id`. `None` returns unassigned merge requests. `Any` returns merge requests with an assignee. _([Introduced][ce-13060] in GitLab 9.5)_ |
-| `approver_ids` **[STARTER]** | Array[integer] | no | Returns merge requests which have specified all the users with the given `id`s as individual approvers. `None` returns merge requests without approvers. `Any` returns merge requests with an approver. |
+| `approver_ids` **(STARTER)** | Array[integer] | no | Returns merge requests which have specified all the users with the given `id`s as individual approvers. `None` returns merge requests without approvers. `Any` returns merge requests with an approver. |
 | `my_reaction_emoji` | string         | no       | Return merge requests reacted by the authenticated user by the given `emoji`. `None` returns issues not given a reaction. `Any` returns issues given at least one reaction. _([Introduced][ce-14016] in GitLab 10.0)_ |
 | `source_branch`     | string         | no       | Return merge requests with the given source branch                                                                             |
 | `target_branch`     | string         | no       | Return merge requests with the given target branch                                                                             |
@@ -358,7 +358,7 @@ Parameters:
 | `scope`             | string         | no       | Return merge requests for the given scope: `created_by_me`, `assigned_to_me` or `all`.<br>                                     |
 | `author_id`         | integer        | no       | Returns merge requests created by the given user `id` _([Introduced][ce-13060] in GitLab 9.5)_                                 |
 | `assignee_id`       | integer        | no       | Returns merge requests assigned to the given user `id`. `None` returns unassigned merge requests. `Any` returns merge requests with an assignee. _([Introduced][ce-13060] in GitLab 9.5)_ |
-| `approver_ids` **[STARTER]** | Array[integer] | no | Returns merge requests which have specified all the users with the given `id`s as individual approvers. `None` returns merge requests without approvers. `Any` returns merge requests with an approver. |
+| `approver_ids` **(STARTER)** | Array[integer] | no | Returns merge requests which have specified all the users with the given `id`s as individual approvers. `None` returns merge requests without approvers. `Any` returns merge requests with an approver. |
 | `my_reaction_emoji` | string         | no       | Return merge requests reacted by the authenticated user by the given `emoji`. `None` returns issues not given a reaction. `Any` returns issues given at least one reaction. _([Introduced][ce-14016] in GitLab 10.0)_ |
 | `source_branch`     | string         | no       | Return merge requests with the given source branch                                                                             |
 | `target_branch`     | string         | no       | Return merge requests with the given target branch                                                                             |
@@ -846,7 +846,7 @@ POST /projects/:id/merge_requests
 | `allow_maintainer_to_push` | boolean | no       | Deprecated, see allow_collaboration                                             |
 | `squash`                   | boolean | no       | Squash commits into a single commit when merging                                |
 
-If `approvals_before_merge` **[STARTER]** is not provided, it inherits the value from the
+If `approvals_before_merge` **(STARTER)** is not provided, it inherits the value from the
 target project. If it is provided, then the following conditions must hold in
 order for it to take effect:
 
@@ -2261,6 +2261,6 @@ Example response:
 [ce-15454]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/15454
 [ce-18935]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/18935
 
-## Approvals **[STARTER]**
+## Approvals **(STARTER)**
 
 For approvals, please see [Merge Request Approvals](merge_request_approvals.md)
diff --git a/doc/api/milestones.md b/doc/api/milestones.md
index 8f69378dac3..a6ded7d3bd2 100644
--- a/doc/api/milestones.md
+++ b/doc/api/milestones.md
@@ -148,7 +148,7 @@ Parameters:
 - `id` (required) - The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user
 - `milestone_id` (required) - The ID of a project milestone
 
-## Get all burndown chart events for a single milestone **[STARTER]**
+## Get all burndown chart events for a single milestone **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/4737) in GitLab 12.1
 
diff --git a/doc/api/namespaces.md b/doc/api/namespaces.md
index 5db7035fd90..2b6eddf78a1 100644
--- a/doc/api/namespaces.md
+++ b/doc/api/namespaces.md
@@ -68,7 +68,7 @@ the `plan` parameter associated with a namespace:
 ]
 ```
 
-NOTE: **Note:** Only group maintainers/owners are presented with `members_count_with_descendants`, as well as `plan` **[BRONZE ONLY]**.
+NOTE: **Note:** Only group maintainers/owners are presented with `members_count_with_descendants`, as well as `plan` **(BRONZE ONLY)**.
 
 ## Search for namespace
 
diff --git a/doc/api/notes.md b/doc/api/notes.md
index c09129c22d4..acbf0334563 100644
--- a/doc/api/notes.md
+++ b/doc/api/notes.md
@@ -5,7 +5,7 @@ Notes are comments on:
 - Snippets
 - Issues
 - Merge requests
-- Epics **[ULTIMATE]**
+- Epics **(ULTIMATE)**
 
 This includes system notes, which are notes about changes to the object (for example, when a milestone changes, there will be a corresponding system note). Label notes are not part of this API, but recorded as separate events in [resource label events](resource_label_events.md).
 
@@ -396,7 +396,7 @@ Parameters:
 curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/projects/5/merge_requests/7/notes/1602
 ```
 
-## Epics **[ULTIMATE]**
+## Epics **(ULTIMATE)**
 
 ### List all epic notes
 
diff --git a/doc/api/notification_settings.md b/doc/api/notification_settings.md
index ccc1cccf7a4..c6667784617 100644
--- a/doc/api/notification_settings.md
+++ b/doc/api/notification_settings.md
@@ -31,7 +31,7 @@ If the `custom` level is used, specific email events can be controlled. Availabl
 - `merge_merge_request`
 - `failed_pipeline`
 - `success_pipeline`
-- `new_epic` **[ULTIMATE]**
+- `new_epic` **(ULTIMATE)**
 
 ## Global notification settings
 
@@ -84,7 +84,7 @@ curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.
 | `merge_merge_request` | boolean | no | Enable/disable this notification |
 | `failed_pipeline` | boolean | no | Enable/disable this notification |
 | `success_pipeline` | boolean | no | Enable/disable this notification |
-| `new_epic` | boolean | no | Enable/disable this notification ([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6626) in 11.3) **[ULTIMATE]** |
+| `new_epic` | boolean | no | Enable/disable this notification ([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6626) in 11.3) **(ULTIMATE)** |
 
 Example response:
 
@@ -153,7 +153,7 @@ curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.
 | `merge_merge_request` | boolean | no | Enable/disable this notification |
 | `failed_pipeline` | boolean | no | Enable/disable this notification |
 | `success_pipeline` | boolean | no | Enable/disable this notification |
-| `new_epic` | boolean | no | Enable/disable this notification ([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6626) in 11.3) **[ULTIMATE]** |
+| `new_epic` | boolean | no | Enable/disable this notification ([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6626) in 11.3) **(ULTIMATE)** |
 
 Example responses:
 
diff --git a/doc/api/packages.md b/doc/api/packages.md
index 618e5c3056a..1a795c0cfa7 100644
--- a/doc/api/packages.md
+++ b/doc/api/packages.md
@@ -1,4 +1,4 @@
-# Packages API **[PREMIUM]**
+# Packages API **(PREMIUM)**
 
 This is the API docs of [GitLab Packages](../administration/packages.md).
 
diff --git a/doc/api/project_aliases.md b/doc/api/project_aliases.md
index 76343b4cd82..271632b61c3 100644
--- a/doc/api/project_aliases.md
+++ b/doc/api/project_aliases.md
@@ -1,4 +1,4 @@
-# Project Aliases API **[PREMIUM ONLY]**
+# Project Aliases API **(PREMIUM ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/3264) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.1.
 
diff --git a/doc/api/project_clusters.md b/doc/api/project_clusters.md
index 327781f6c93..614ea41d572 100644
--- a/doc/api/project_clusters.md
+++ b/doc/api/project_clusters.md
@@ -167,7 +167,7 @@ Parameters:
 | `platform_kubernetes_attributes[ca_cert]` | String | no | TLS certificate (needed if API is using a self-signed TLS certificate |
 | `platform_kubernetes_attributes[namespace]` | String | no | The unique namespace related to the project |
 | `platform_kubernetes_attributes[authorization_type]` | String | no | The cluster authorization type: `rbac`, `abac` or `unknown_authorization`. Defaults to `rbac`. |
-| `environment_scope` | String | no | The associated environment to the cluster. Defaults to `*` **[PREMIUM]** |
+| `environment_scope` | String | no | The associated environment to the cluster. Defaults to `*` **(PREMIUM)** |
 
 Example request:
 
@@ -257,7 +257,7 @@ Parameters:
 | `platform_kubernetes_attributes[token]` | String | no | The token to authenticate against Kubernetes |
 | `platform_kubernetes_attributes[ca_cert]` | String | no | TLS certificate (needed if API is using a self-signed TLS certificate |
 | `platform_kubernetes_attributes[namespace]` | String | no | The unique namespace related to the project |
-| `environment_scope` | String | no | The associated environment to the cluster **[PREMIUM]** |
+| `environment_scope` | String | no | The associated environment to the cluster **(PREMIUM)** |
 
 NOTE: **Note:**
 `name`, `api_url`, `ca_cert` and `token` can only be updated if the cluster was added
diff --git a/doc/api/project_level_variables.md b/doc/api/project_level_variables.md
index 66a749e4811..eab905bbc5f 100644
--- a/doc/api/project_level_variables.md
+++ b/doc/api/project_level_variables.md
@@ -74,7 +74,7 @@ POST /projects/:id/variables
 | `variable_type`     | string  | no       | The type of a variable. Available types are: `env_var` (default) and `file` |
 | `protected`         | boolean | no       | Whether the variable is protected |
 | `masked`            | boolean | no       | Whether the variable is masked |
-| `environment_scope` | string  | no       | The `environment_scope` of the variable **[PREMIUM]** |
+| `environment_scope` | string  | no       | The `environment_scope` of the variable **(PREMIUM)** |
 
 ```
 curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/variables" --form "key=NEW_VARIABLE" --form "value=new value"
@@ -108,7 +108,7 @@ PUT /projects/:id/variables/:key
 | `variable_type`     | string  | no       | The type of a variable. Available types are: `env_var` (default) and `file` |
 | `protected`         | boolean | no       | Whether the variable is protected |
 | `masked`            | boolean | no       | Whether the variable is masked |
-| `environment_scope` | string  | no       | The `environment_scope` of the variable **[PREMIUM]** |
+| `environment_scope` | string  | no       | The `environment_scope` of the variable **(PREMIUM)** |
 
 ```
 curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/variables/NEW_VARIABLE" --form "value=updated value"
diff --git a/doc/api/project_templates.md b/doc/api/project_templates.md
index 0a94a8d47ae..69d61b3974b 100644
--- a/doc/api/project_templates.md
+++ b/doc/api/project_templates.md
@@ -16,7 +16,7 @@ Support will be added for [Issue and Merge Request templates](../user/project/de
 in a future release.
 
 Support for [Group-level file templates](../user/group/index.md#group-file-templates-premium)
-**[PREMIUM]** was [added](https://gitlab.com/gitlab-org/gitlab-ee/issues/5987)
+**(PREMIUM)** was [added](https://gitlab.com/gitlab-org/gitlab-ee/issues/5987)
 in GitLab 11.5
 
 ## Get all templates of a particular type
diff --git a/doc/api/projects.md b/doc/api/projects.md
index e07d6ce9a42..da05b090699 100644
--- a/doc/api/projects.md
+++ b/doc/api/projects.md
@@ -55,8 +55,8 @@ GET /projects
 | `with_issues_enabled`         | boolean | no | Limit by enabled issues feature |
 | `with_merge_requests_enabled` | boolean | no | Limit by enabled merge requests feature |
 | `with_programming_language`   | string  | no | Limit by projects which use the given programming language |
-| `wiki_checksum_failed`        | boolean | no | **[PREMIUM]** Limit projects where the wiki checksum calculation has failed ([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6137) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2) |
-| `repository_checksum_failed`  | boolean | no | **[PREMIUM]** Limit projects where the repository checksum calculation has failed ([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6137) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2) |
+| `wiki_checksum_failed`        | boolean | no | **(PREMIUM)** Limit projects where the wiki checksum calculation has failed ([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6137) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2) |
+| `repository_checksum_failed`  | boolean | no | **(PREMIUM)** Limit projects where the repository checksum calculation has failed ([Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6137) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2) |
 | `min_access_level`            | integer | no | Limit by current user minimal [access level](members.md) |
 
 When `simple=true` or the user is unauthenticated this returns something like:
@@ -729,9 +729,9 @@ POST /projects
 | `printing_merge_request_link_enabled` | boolean | no | Show link to create/view merge request when pushing from the command line |
 | `ci_config_path` | string | no | The path to CI config file |
 | `repository_storage` | string | no | Which storage shard the repository is on. Available only to admins |
-| `approvals_before_merge` | integer | no | **[STARTER]** How many approvers should approve merge requests by default |
-| `mirror` | boolean | no | **[STARTER]** Enables pull mirroring in a project |
-| `mirror_trigger_builds` | boolean | no | **[STARTER]** Pull mirroring triggers builds |
+| `approvals_before_merge` | integer | no | **(STARTER)** How many approvers should approve merge requests by default |
+| `mirror` | boolean | no | **(STARTER)** Enables pull mirroring in a project |
+| `mirror_trigger_builds` | boolean | no | **(STARTER)** Pull mirroring triggers builds |
 | `initialize_with_readme` | boolean | no | `false` by default |
 
 NOTE: **Note:** If your HTTP repository is not publicly accessible,
@@ -774,10 +774,10 @@ POST /projects/user/:user_id
 | `printing_merge_request_link_enabled` | boolean | no | Show link to create/view merge request when pushing from the command line |
 | `ci_config_path` | string | no | The path to CI config file |
 | `repository_storage` | string | no | Which storage shard the repository is on. Available only to admins |
-| `approvals_before_merge` | integer | no | **[STARTER]** How many approvers should approve merge requests by default |
-| `external_authorization_classification_label` | string | no | **[CORE ONLY]** The classification label for the project |
-| `mirror` | boolean | no | **[STARTER]** Enables pull mirroring in a project |
-| `mirror_trigger_builds` | boolean | no | **[STARTER]** Pull mirroring triggers builds |
+| `approvals_before_merge` | integer | no | **(STARTER)** How many approvers should approve merge requests by default |
+| `external_authorization_classification_label` | string | no | **(CORE ONLY)** The classification label for the project |
+| `mirror` | boolean | no | **(STARTER)** Enables pull mirroring in a project |
+| `mirror_trigger_builds` | boolean | no | **(STARTER)** Pull mirroring triggers builds |
 
 NOTE: **Note:** If your HTTP repository is not publicly accessible,
 add authentication information to the URL: `https://username:password@gitlab.company.com/group/project.git`
@@ -819,14 +819,14 @@ PUT /projects/:id
 | `ci_config_path` | string | no | The path to CI config file |
 | `ci_default_git_depth` | integer | no | Default number of revisions for [shallow cloning](../user/project/pipelines/settings.md#git-shallow-clone) |
 | `repository_storage` | string | no | Which storage shard the repository is on. Available only to admins |
-| `approvals_before_merge` | integer | no | **[STARTER]** How many approvers should approve merge request by default |
-| `external_authorization_classification_label` | string | no | **[CORE ONLY]** The classification label for the project |
-| `mirror` | boolean | no | **[STARTER]** Enables pull mirroring in a project |
-| `mirror_user_id` | integer | no | **[STARTER]** User responsible for all the activity surrounding a pull mirror event |
-| `mirror_trigger_builds` | boolean | no | **[STARTER]** Pull mirroring triggers builds |
-| `only_mirror_protected_branches` | boolean | no | **[STARTER]** Only mirror protected branches |
-| `mirror_overwrites_diverged_branches` | boolean | no | **[STARTER]** Pull mirror overwrites diverged branches |
-| `packages_enabled` | boolean | no | **[PREMIUM ONLY]** Enable or disable packages repository feature |
+| `approvals_before_merge` | integer | no | **(STARTER)** How many approvers should approve merge request by default |
+| `external_authorization_classification_label` | string | no | **(CORE ONLY)** The classification label for the project |
+| `mirror` | boolean | no | **(STARTER)** Enables pull mirroring in a project |
+| `mirror_user_id` | integer | no | **(STARTER)** User responsible for all the activity surrounding a pull mirror event |
+| `mirror_trigger_builds` | boolean | no | **(STARTER)** Pull mirroring triggers builds |
+| `only_mirror_protected_branches` | boolean | no | **(STARTER)** Only mirror protected branches |
+| `mirror_overwrites_diverged_branches` | boolean | no | **(STARTER)** Pull mirror overwrites diverged branches |
+| `packages_enabled` | boolean | no | **(PREMIUM ONLY)** Enable or disable packages repository feature |
 
 NOTE: **Note:** If your HTTP repository is not publicly accessible,
 add authentication information to the URL: `https://username:password@gitlab.company.com/group/project.git`
@@ -1612,7 +1612,7 @@ POST /projects/:id/housekeeping
 | --------- | ---- | -------- | ----------- |
 | `id` | integer/string | yes | The ID of the project or NAMESPACE/PROJECT_NAME |
 
-## Push Rules **[STARTER]**
+## Push Rules **(STARTER)**
 
 ### Get project push rules
 
@@ -1666,15 +1666,15 @@ POST /projects/:id/push_rule
 | Attribute                              | Type           | Required | Description |
 | -------------------------------------- | -------------- | -------- | ----------- |
 | `id`                                   | integer/string | yes      | The ID of the project or NAMESPACE/PROJECT_NAME |
-| `deny_delete_tag` **[STARTER]**        | boolean        | no       | Deny deleting a tag |
-| `member_check` **[STARTER]**           | boolean        | no       | Restrict commits by author (email) to existing GitLab users |
-| `prevent_secrets` **[STARTER]**        | boolean        | no       | GitLab will reject any files that are likely to contain secrets |
-| `commit_message_regex` **[STARTER]**   | string         | no       | All commit messages must match this, e.g. `Fixed \d+\..*` |
-| `branch_name_regex` **[STARTER]**      | string         | no       | All branch names must match this, e.g. `(feature|hotfix)\/*` |
-| `author_email_regex` **[STARTER]**     | string         | no       | All commit author emails must match this, e.g. `@my-company.com$` |
-| `file_name_regex` **[STARTER]**        | string         | no       | All commited filenames must **not** match this, e.g. `(jar|exe)$` |
-| `max_file_size` **[STARTER]**          | integer        | no       | Maximum file size (MB) |
-| `commit_committer_check` **[PREMIUM]** | boolean        | no       | Users can only push commits to this repository that were committed with one of their own verified emails. |
+| `deny_delete_tag` **(STARTER)**        | boolean        | no       | Deny deleting a tag |
+| `member_check` **(STARTER)**           | boolean        | no       | Restrict commits by author (email) to existing GitLab users |
+| `prevent_secrets` **(STARTER)**        | boolean        | no       | GitLab will reject any files that are likely to contain secrets |
+| `commit_message_regex` **(STARTER)**   | string         | no       | All commit messages must match this, e.g. `Fixed \d+\..*` |
+| `branch_name_regex` **(STARTER)**      | string         | no       | All branch names must match this, e.g. `(feature|hotfix)\/*` |
+| `author_email_regex` **(STARTER)**     | string         | no       | All commit author emails must match this, e.g. `@my-company.com$` |
+| `file_name_regex` **(STARTER)**        | string         | no       | All commited filenames must **not** match this, e.g. `(jar|exe)$` |
+| `max_file_size` **(STARTER)**          | integer        | no       | Maximum file size (MB) |
+| `commit_committer_check` **(PREMIUM)** | boolean        | no       | Users can only push commits to this repository that were committed with one of their own verified emails. |
 
 ### Edit project push rule
 
@@ -1687,15 +1687,15 @@ PUT /projects/:id/push_rule
 | Attribute                              | Type           | Required | Description |
 | -------------------------------------- | -------------- | -------- | ----------- |
 | `id`                                   | integer/string | yes      | The ID of the project or NAMESPACE/PROJECT_NAME |
-| `deny_delete_tag` **[STARTER]**        | boolean        | no       | Deny deleting a tag |
-| `member_check` **[STARTER]**           | boolean        | no       | Restrict commits by author (email) to existing GitLab users |
-| `prevent_secrets` **[STARTER]**        | boolean        | no       | GitLab will reject any files that are likely to contain secrets |
-| `commit_message_regex` **[STARTER]**   | string         | no       | All commit messages must match this, e.g. `Fixed \d+\..*` |
-| `branch_name_regex` **[STARTER]**      | string         | no       | All branch names must match this, e.g. `(feature|hotfix)\/*` |
-| `author_email_regex` **[STARTER]**     | string         | no       | All commit author emails must match this, e.g. `@my-company.com$` |
-| `file_name_regex` **[STARTER]**        | string         | no       | All commited filenames must **not** match this, e.g. `(jar|exe)$` |
-| `max_file_size` **[STARTER]**          | integer        | no       | Maximum file size (MB) |
-| `commit_committer_check` **[PREMIUM]** | boolean        | no       | Users can only push commits to this repository that were committed with one of their own verified emails. |
+| `deny_delete_tag` **(STARTER)**        | boolean        | no       | Deny deleting a tag |
+| `member_check` **(STARTER)**           | boolean        | no       | Restrict commits by author (email) to existing GitLab users |
+| `prevent_secrets` **(STARTER)**        | boolean        | no       | GitLab will reject any files that are likely to contain secrets |
+| `commit_message_regex` **(STARTER)**   | string         | no       | All commit messages must match this, e.g. `Fixed \d+\..*` |
+| `branch_name_regex` **(STARTER)**      | string         | no       | All branch names must match this, e.g. `(feature|hotfix)\/*` |
+| `author_email_regex` **(STARTER)**     | string         | no       | All commit author emails must match this, e.g. `@my-company.com$` |
+| `file_name_regex` **(STARTER)**        | string         | no       | All commited filenames must **not** match this, e.g. `(jar|exe)$` |
+| `max_file_size` **(STARTER)**          | integer        | no       | Maximum file size (MB) |
+| `commit_committer_check` **(PREMIUM)** | boolean        | no       | Users can only push commits to this repository that were committed with one of their own verified emails. |
 
 ### Delete project push rule
 
@@ -1736,7 +1736,7 @@ Read more in the [Project import/export](project_import_export.md) documentation
 
 Read more in the [Project members](members.md) documentation.
 
-## Start the pull mirroring process for a Project **[STARTER]**
+## Start the pull mirroring process for a Project **(STARTER)**
 
 > Introduced in [GitLab Starter](https://about.gitlab.com/pricing) 10.3.
 
diff --git a/doc/api/protected_branches.md b/doc/api/protected_branches.md
index 6e41584afef..9309306ba05 100644
--- a/doc/api/protected_branches.md
+++ b/doc/api/protected_branches.md
@@ -166,9 +166,9 @@ curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" 'https://gitla
 | `push_access_level`      | string         | no  | Access levels allowed to push (defaults: `40`, maintainer access level) |
 | `merge_access_level`     | string         | no  | Access levels allowed to merge (defaults: `40`, maintainer access level) |
 | `unprotect_access_level` | string         | no  | Access levels allowed to unprotect (defaults: `40`, maintainer access level) |
-| `allowed_to_push`        | array          | no  | **[STARTER]** Array of access levels allowed to push, with each described by a hash |
-| `allowed_to_merge`       | array          | no  | **[STARTER]** Array of access levels allowed to merge, with each described by a hash |
-| `allowed_to_unprotect`   | array          | no  | **[STARTER]**Array of access levels allowed to unprotect, with each described by a hash |
+| `allowed_to_push`        | array          | no  | **(STARTER)** Array of access levels allowed to push, with each described by a hash |
+| `allowed_to_merge`       | array          | no  | **(STARTER)** Array of access levels allowed to merge, with each described by a hash |
+| `allowed_to_unprotect`   | array          | no  | **(STARTER)**Array of access levels allowed to unprotect, with each described by a hash |
 
 Example response:
 
@@ -229,7 +229,7 @@ Example response:
 }
 ```
 
-### Example with user / group level access **[STARTER]**
+### Example with user / group level access **(STARTER)**
 
 Elements in the `allowed_to_push` / `allowed_to_merge` / `allowed_to_unprotect` array should take the
 form `{user_id: integer}`, `{group_id: integer}` or `{access_level: integer}`. Each user must have access to the project and each group must [have this project shared](../user/project/members/share_project_with_groups.md). These access levels allow [more granular control over protected branch access](../user/project/protected_branches.md#restricting-push-and-merge-access-to-certain-users-starter) and were [added to the API in ][ee-3516] in GitLab 10.3 EE.
diff --git a/doc/api/resource_label_events.md b/doc/api/resource_label_events.md
index f0a7ac4e41d..7ad4d78014c 100644
--- a/doc/api/resource_label_events.md
+++ b/doc/api/resource_label_events.md
@@ -88,7 +88,7 @@ Parameters:
 curl --request GET --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/projects/5/issues/11/resource_label_events/1
 ```
 
-## Epics **[ULTIMATE]**
+## Epics **(ULTIMATE)**
 
 ### List group epic label events
 
diff --git a/doc/api/scim.md b/doc/api/scim.md
index 3870ea788e7..46498465261 100644
--- a/doc/api/scim.md
+++ b/doc/api/scim.md
@@ -1,4 +1,4 @@
-# SCIM API **[SILVER ONLY]**
+# SCIM API **(SILVER ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/9388) in [GitLab Silver](https://about.gitlab.com/pricing/) 11.10.
 
diff --git a/doc/api/search.md b/doc/api/search.md
index abb77ae05dc..60acf600ac7 100644
--- a/doc/api/search.md
+++ b/doc/api/search.md
@@ -19,7 +19,7 @@ GET /search
 
 Search the expression within the specified scope. Currently these scopes are supported: projects, issues, merge_requests, milestones, snippet_titles, snippet_blobs, users.
 
-If Elasticsearch is enabled additional scopes available are blobs, wiki_blobs and commits. Find more about [the feature](../integration/elasticsearch.md). **[STARTER]**
+If Elasticsearch is enabled additional scopes available are blobs, wiki_blobs and commits. Find more about [the feature](../integration/elasticsearch.md). **(STARTER)**
 
 The response depends on the requested scope.
 
@@ -283,7 +283,7 @@ Example response:
 ]
 ```
 
-### Scope: wiki_blobs **[STARTER]**
+### Scope: wiki_blobs **(STARTER)**
 
 This scope is available only if [Elasticsearch](../integration/elasticsearch.md) is enabled.
 
@@ -308,7 +308,7 @@ Example response:
 ]
 ```
 
-### Scope: commits **[STARTER]**
+### Scope: commits **(STARTER)**
 
 This scope is available only if [Elasticsearch](../integration/elasticsearch.md) is enabled.
 
@@ -341,7 +341,7 @@ Example response:
 ]
 ```
 
-### Scope: blobs **[STARTER]**
+### Scope: blobs **(STARTER)**
 
 This scope is available only if [Elasticsearch](../integration/elasticsearch.md) is enabled.
 
@@ -415,7 +415,7 @@ GET /groups/:id/search
 
 Search the expression within the specified scope. Currently these scopes are supported: projects, issues, merge_requests, milestones, users.
 
-If Elasticsearch is enabled additional scopes available are blobs, wiki_blobs and commits. Find more about [the feature](../integration/elasticsearch.md). **[STARTER]**
+If Elasticsearch is enabled additional scopes available are blobs, wiki_blobs and commits. Find more about [the feature](../integration/elasticsearch.md). **(STARTER)**
 
 The response depends on the requested scope.
 
@@ -617,7 +617,7 @@ Example response:
 ]
 ```
 
-### Scope: wiki_blobs **[STARTER]**
+### Scope: wiki_blobs **(STARTER)**
 
 This scope is available only if [Elasticsearch](../integration/elasticsearch.md) is enabled.
 
@@ -642,7 +642,7 @@ Example response:
 ]
 ```
 
-### Scope: commits **[STARTER]**
+### Scope: commits **(STARTER)**
 
 This scope is available only if [Elasticsearch](../integration/elasticsearch.md) is enabled.
 
@@ -675,7 +675,7 @@ Example response:
 ]
 ```
 
-### Scope: blobs **[STARTER]**
+### Scope: blobs **(STARTER)**
 
 This scope is available only if [Elasticsearch](../integration/elasticsearch.md) is enabled.
 
diff --git a/doc/api/services.md b/doc/api/services.md
index 4f35c17e927..df15e6892b0 100644
--- a/doc/api/services.md
+++ b/doc/api/services.md
@@ -1146,7 +1146,7 @@ Get JetBrains TeamCity CI service settings for a project.
 GET /projects/:id/services/teamcity
 ```
 
-## Jenkins CI **[STARTER]**
+## Jenkins CI **(STARTER)**
 
 A continuous integration and build server
 
diff --git a/doc/api/settings.md b/doc/api/settings.md
index 0f46662a8ae..ff48cac1f47 100644
--- a/doc/api/settings.md
+++ b/doc/api/settings.md
@@ -150,7 +150,7 @@ these parameters:
 - `file_template_project_id`
 - `geo_node_allowed_ips`
 
-Example responses: **[PREMIUM ONLY]**
+Example responses: **(PREMIUM ONLY)**
 
 ```json
   "external_authorization_service_enabled": true,
@@ -174,12 +174,12 @@ are listed in the descriptions of the relevant settings.
 | `after_sign_up_text`                     | string           | no                                   | Text shown to the user after signing up |
 | `akismet_api_key`                        | string           | required by: `akismet_enabled`       | API key for akismet spam protection. |
 | `akismet_enabled`                        | boolean          | no                                   | (**If enabled, requires:** `akismet_api_key`) Enable or disable akismet spam protection. |
-| `allow_group_owners_to_manage_ldap`      | boolean          | no                                   | **[PREMIUM]** Set to `true` to allow group owners to manage LDAP |
+| `allow_group_owners_to_manage_ldap`      | boolean          | no                                   | **(PREMIUM)** Set to `true` to allow group owners to manage LDAP |
 | `allow_local_requests_from_hooks_and_services` | boolean    | no                                   | Allow requests to the local network from hooks and services. |
 | `authorized_keys_enabled`                | boolean          | no                                   | By default, we write to the `authorized_keys` file to support Git over SSH without additional configuration. GitLab can be optimized to authenticate SSH keys via the database file. Only disable this if you have configured your OpenSSH server to use the AuthorizedKeysCommand. |
 | `auto_devops_domain`                     | string           | no                                   | Specify a domain to use by default for every project's Auto Review Apps and Auto Deploy stages. |
 | `auto_devops_enabled`                    | boolean          | no                                   | Enable Auto DevOps for projects by default. It will automatically build, test, and deploy applications based on a predefined CI/CD configuration. |
-| `check_namespace_plan`                   | boolean          | no                                   | **[PREMIUM]** Enabling this will make only licensed EE features available to projects if the project namespace's plan includes the feature or if the project is public. |
+| `check_namespace_plan`                   | boolean          | no                                   | **(PREMIUM)** Enabling this will make only licensed EE features available to projects if the project namespace's plan includes the feature or if the project is public. |
 | `clientside_sentry_dsn`                  | string           | required by: `clientside_sentry_enabled` | Clientside Sentry Data Source Name. |
 | `clientside_sentry_enabled`              | boolean          | no                                   | (**If enabled, requires:** `clientside_sentry_dsn`) Enable Sentry error reporting for the client side. |
 | `container_registry_token_expire_delay`  | integer          | no                                   | Container Registry token duration in minutes. |
@@ -196,31 +196,31 @@ are listed in the descriptions of the relevant settings.
 | `dsa_key_restriction`                    | integer          | no                                   | The minimum allowed bit length of an uploaded DSA key. Default is `0` (no restriction). `-1` disables DSA keys. |
 | `ecdsa_key_restriction`                  | integer          | no                                   | The minimum allowed curve size (in bits) of an uploaded ECDSA key. Default is `0` (no restriction). `-1` disables ECDSA keys. |
 | `ed25519_key_restriction`                | integer          | no                                   | The minimum allowed curve size (in bits) of an uploaded ED25519 key. Default is `0` (no restriction). `-1` disables ED25519 keys. |
-| `elasticsearch_aws`                      | boolean          | no                                   | **[PREMIUM]** Enable the use of AWS hosted Elasticsearch |
-| `elasticsearch_aws_access_key`           | string           | no                                   | **[PREMIUM]** AWS IAM access key |
-| `elasticsearch_aws_region`               | string           | no                                   | **[PREMIUM]** The AWS region the elasticsearch domain is configured |
-| `elasticsearch_aws_secret_access_key`    | string           | no                                   | **[PREMIUM]** AWS IAM secret access key |
-| `elasticsearch_experimental_indexer`     | boolean          | no                                   | **[PREMIUM]** Use the experimental elasticsearch indexer. More info: <https://gitlab.com/gitlab-org/gitlab-elasticsearch-indexer> |
-| `elasticsearch_indexing`                 | boolean          | no                                   | **[PREMIUM]** Enable Elasticsearch indexing |
-| `elasticsearch_search`                   | boolean          | no                                   | **[PREMIUM]** Enable Elasticsearch search |
-| `elasticsearch_url`                      | string           | no                                   | **[PREMIUM]** The url to use for connecting to Elasticsearch. Use a comma-separated list to support cluster (e.g., `http://localhost:9200, http://localhost:9201"`). If your Elasticsearch instance is password protected, pass the `username:password` in the URL (e.g., `http://<username>:<password>@<elastic_host>:9200/`). |
-| `elasticsearch_limit_indexing`           | boolean          | no                                   | **[PREMIUM]** Limit Elasticsearch to index certain namespaces and projects |
-| `elasticsearch_project_ids`              | array of integers | no                                  | **[PREMIUM]** The projects to index via Elasticsearch if `elasticsearch_limit_indexing` is enabled. |
-| `elasticsearch_namespace_ids`            | array of integers | no                                  | **[PREMIUM]** The namespaces to index via Elasticsearch if `elasticsearch_limit_indexing` is enabled. |
-| `email_additional_text`                  | string           | no                                   | **[PREMIUM]** Additional text added to the bottom of every email for legal/auditing/compliance reasons |
+| `elasticsearch_aws`                      | boolean          | no                                   | **(PREMIUM)** Enable the use of AWS hosted Elasticsearch |
+| `elasticsearch_aws_access_key`           | string           | no                                   | **(PREMIUM)** AWS IAM access key |
+| `elasticsearch_aws_region`               | string           | no                                   | **(PREMIUM)** The AWS region the elasticsearch domain is configured |
+| `elasticsearch_aws_secret_access_key`    | string           | no                                   | **(PREMIUM)** AWS IAM secret access key |
+| `elasticsearch_experimental_indexer`     | boolean          | no                                   | **(PREMIUM)** Use the experimental elasticsearch indexer. More info: <https://gitlab.com/gitlab-org/gitlab-elasticsearch-indexer> |
+| `elasticsearch_indexing`                 | boolean          | no                                   | **(PREMIUM)** Enable Elasticsearch indexing |
+| `elasticsearch_search`                   | boolean          | no                                   | **(PREMIUM)** Enable Elasticsearch search |
+| `elasticsearch_url`                      | string           | no                                   | **(PREMIUM)** The url to use for connecting to Elasticsearch. Use a comma-separated list to support cluster (e.g., `http://localhost:9200, http://localhost:9201"`). If your Elasticsearch instance is password protected, pass the `username:password` in the URL (e.g., `http://<username>:<password>@<elastic_host>:9200/`). |
+| `elasticsearch_limit_indexing`           | boolean          | no                                   | **(PREMIUM)** Limit Elasticsearch to index certain namespaces and projects |
+| `elasticsearch_project_ids`              | array of integers | no                                  | **(PREMIUM)** The projects to index via Elasticsearch if `elasticsearch_limit_indexing` is enabled. |
+| `elasticsearch_namespace_ids`            | array of integers | no                                  | **(PREMIUM)** The namespaces to index via Elasticsearch if `elasticsearch_limit_indexing` is enabled. |
+| `email_additional_text`                  | string           | no                                   | **(PREMIUM)** Additional text added to the bottom of every email for legal/auditing/compliance reasons |
 | `email_author_in_body`                   | boolean          | no                                   | Some email servers do not support overriding the email sender name. Enable this option to include the name of the author of the issue, merge request or comment in the email body instead. |
 | `enabled_git_access_protocol`            | string           | no                                   | Enabled protocols for Git access. Allowed values are: `ssh`, `http`, and `nil` to allow both protocols. |
 | `enforce_terms`                          | boolean          | no                                   | (**If enabled, requires:** `terms`) Enforce application ToS to all users. |
-| `external_auth_client_cert`              | string           | no                                   | **[PREMIUM]** (**If enabled, requires:** `external_auth_client_key`) The certificate to use to authenticate with the external authorization service |
-| `external_auth_client_key`               | string           | required by: `external_auth_client_cert` | **[PREMIUM]** Private key for the certificate when authentication is required for the external authorization service, this is encrypted when stored |
-| `external_auth_client_key_pass`          | string           | no                                   | **[PREMIUM]** Passphrase to use for the private key when authenticating with the external service this is encrypted when stored |
-| `external_authorization_service_enabled` | boolean          | no                                   | **[PREMIUM]** (**If enabled, requires:** `external_authorization_service_default_label`, `external_authorization_service_timeout` and `external_authorization_service_url` )  Enable using an external authorization service for accessing projects |
-| `external_authorization_service_default_label` | string     | required by: `external_authorization_service_enabled` | **[PREMIUM]** The default classification label to use when requesting authorization and no classification label has been specified on the project |
-| `external_authorization_service_timeout` | float            | required by: `external_authorization_service_enabled` | **[PREMIUM]** The timeout after which an authorization request is aborted, in seconds. When a request times out, access is denied to the user. (min: 0.001, max: 10, step: 0.001) |
-| `external_authorization_service_url`     | string           | required by: `external_authorization_service_enabled` | **[PREMIUM]** URL to which authorization requests will be directed |
-| `file_template_project_id`               | integer          | no                                   | **[PREMIUM]** The ID of a project to load custom file templates from |
+| `external_auth_client_cert`              | string           | no                                   | **(PREMIUM)** (**If enabled, requires:** `external_auth_client_key`) The certificate to use to authenticate with the external authorization service |
+| `external_auth_client_key`               | string           | required by: `external_auth_client_cert` | **(PREMIUM)** Private key for the certificate when authentication is required for the external authorization service, this is encrypted when stored |
+| `external_auth_client_key_pass`          | string           | no                                   | **(PREMIUM)** Passphrase to use for the private key when authenticating with the external service this is encrypted when stored |
+| `external_authorization_service_enabled` | boolean          | no                                   | **(PREMIUM)** (**If enabled, requires:** `external_authorization_service_default_label`, `external_authorization_service_timeout` and `external_authorization_service_url` )  Enable using an external authorization service for accessing projects |
+| `external_authorization_service_default_label` | string     | required by: `external_authorization_service_enabled` | **(PREMIUM)** The default classification label to use when requesting authorization and no classification label has been specified on the project |
+| `external_authorization_service_timeout` | float            | required by: `external_authorization_service_enabled` | **(PREMIUM)** The timeout after which an authorization request is aborted, in seconds. When a request times out, access is denied to the user. (min: 0.001, max: 10, step: 0.001) |
+| `external_authorization_service_url`     | string           | required by: `external_authorization_service_enabled` | **(PREMIUM)** URL to which authorization requests will be directed |
+| `file_template_project_id`               | integer          | no                                   | **(PREMIUM)** The ID of a project to load custom file templates from |
 | `first_day_of_week`                      | integer          | no                                   | Start day of the week for calendar views and date pickers. Valid values are `0` (default) for Sunday, `1` for Monday, and `6` for Saturday. |
-| `geo_status_timeout`                     | integer          | no                                   | **[PREMIUM]** The amount of seconds after which a request to get a secondary node status will time out. |
+| `geo_status_timeout`                     | integer          | no                                   | **(PREMIUM)** The amount of seconds after which a request to get a secondary node status will time out. |
 | `gitaly_timeout_default`                 | integer          | no                                   | Default Gitaly timeout, in seconds. This timeout is not enforced for git fetch/push operations or Sidekiq jobs. Set to `0` to disable timeouts. |
 | `gitaly_timeout_fast`                    | integer          | no                                   | Gitaly fast operation timeout, in seconds. Some Gitaly operations are expected to be fast. If they exceed this threshold, there may be a problem with a storage shard and 'failing fast' can help maintain the stability of the GitLab instance. Set to `0` to disable timeouts. |
 | `gitaly_timeout_medium`                  | integer          | no                                   | Medium Gitaly timeout, in seconds. This should be a value between the Fast and the Default timeout. Set to `0` to disable timeouts. |
@@ -229,7 +229,7 @@ are listed in the descriptions of the relevant settings.
 | `help_page_hide_commercial_content`      | boolean          | no                                   | Hide marketing-related entries from help. |
 | `help_page_support_url`                  | string           | no                                   | Alternate support URL for help page. |
 | `help_page_text`                         | string           | no                                   | Custom text displayed on the help page. |
-| `help_text`                              | string           | no                                   | **[PREMIUM]** GitLab server administrator information |
+| `help_text`                              | string           | no                                   | **(PREMIUM)** GitLab server administrator information |
 | `hide_third_party_offers`                | boolean          | no                                   | Do not display offers from third parties within GitLab. |
 | `home_page_url`                          | string           | no                                   | Redirect to this URL when not logged in. |
 | `housekeeping_bitmaps_enabled`           | boolean          | required by: `housekeeping_enabled`  | Enable Git pack file bitmap creation. |
@@ -252,9 +252,9 @@ are listed in the descriptions of the relevant settings.
 | `metrics_sample_interval`                | integer          | required by: `metrics_enabled`       | The sampling interval in seconds. |
 | `metrics_timeout`                        | integer          | required by: `metrics_enabled`       | The amount of seconds after which InfluxDB will time out. |
 | `mirror_available`                       | boolean          | no                                   | Allow mirrors to be set up for projects. If disabled, only admins will be able to set up mirrors in projects. |
-| `mirror_capacity_threshold`              | integer          | no                                   | **[PREMIUM]** Minimum capacity to be available before scheduling more mirrors preemptively |
-| `mirror_max_capacity`                    | integer          | no                                   | **[PREMIUM]** Maximum number of mirrors that can be synchronizing at the same time. |
-| `mirror_max_delay`                       | integer          | no                                   | **[PREMIUM]** Maximum time (in minutes) between updates that a mirror can have when scheduled to synchronize. |
+| `mirror_capacity_threshold`              | integer          | no                                   | **(PREMIUM)** Minimum capacity to be available before scheduling more mirrors preemptively |
+| `mirror_max_capacity`                    | integer          | no                                   | **(PREMIUM)** Maximum number of mirrors that can be synchronizing at the same time. |
+| `mirror_max_delay`                       | integer          | no                                   | **(PREMIUM)** Maximum time (in minutes) between updates that a mirror can have when scheduled to synchronize. |
 | `pages_domain_verification_enabled`      | boolean          | no                                   | Require users to prove ownership of custom domains. Domain verification is an essential security measure for public GitLab sites. Users are required to demonstrate they control a domain before it is enabled. |
 | `password_authentication_enabled_for_git` | boolean         | no                                   | Enable authentication for Git over HTTP(S) via a GitLab account password. Default is `true`. |
 | `password_authentication_enabled_for_web` | boolean         | no                                   | Enable authentication for the web interface via a GitLab account password. Default is `true`. |
@@ -266,12 +266,12 @@ are listed in the descriptions of the relevant settings.
 | `polling_interval_multiplier`            | decimal          | no                                   | Interval multiplier used by endpoints that perform polling. Set to `0` to disable polling. |
 | `project_export_enabled`                 | boolean          | no                                   | Enable project export. |
 | `prometheus_metrics_enabled`             | boolean          | no                                   | Enable prometheus metrics. |
-| `pseudonymizer_enabled`                  | boolean          | no                                   | **[PREMIUM]** When enabled, GitLab will run a background job that will produce pseudonymized CSVs of the GitLab database that will be uploaded to your configured object storage directory.
+| `pseudonymizer_enabled`                  | boolean          | no                                   | **(PREMIUM)** When enabled, GitLab will run a background job that will produce pseudonymized CSVs of the GitLab database that will be uploaded to your configured object storage directory.
 | `recaptcha_enabled`                      | boolean          | no                                   | (**If enabled, requires:** `recaptcha_private_key` and `recaptcha_site_key`) Enable recaptcha. |
 | `recaptcha_private_key`                  | string           | required by: `recaptcha_enabled`     | Private key for recaptcha. |
 | `recaptcha_site_key`                     | string           | required by: `recaptcha_enabled`     | Site key for recaptcha. |
 | `repository_checks_enabled`              | boolean          | no                                   | GitLab will periodically run `git fsck` in all project and wiki repositories to look for silent disk corruption issues. |
-| `repository_size_limit`                  | integer          | no                                   | **[PREMIUM]** Size limit per repository (MB) |
+| `repository_size_limit`                  | integer          | no                                   | **(PREMIUM)** Size limit per repository (MB) |
 | `repository_storages`                    | array of strings | no                                   | A list of names of enabled storage paths, taken from `gitlab.yml`. New projects will be created in one of these stores, chosen at random. |
 | `require_two_factor_authentication`      | boolean          | no                                   | (**If enabled, requires:** `two_factor_grace_period`) Require all users to set up Two-factor authentication. |
 | `restricted_visibility_levels`           | array of strings | no                                   | Selected levels cannot be used by non-admin users for groups, projects or snippets. Can take `private`, `internal` and `public` as a parameter. Default is `null` which means there is no restriction. |
@@ -279,15 +279,15 @@ are listed in the descriptions of the relevant settings.
 | `send_user_confirmation_email`           | boolean          | no                                   | Send confirmation email on sign-up. |
 | `session_expire_delay`                   | integer          | no                                   | Session duration in minutes. GitLab restart is required to apply changes |
 | `shared_runners_enabled`                 | boolean          | no                                   | (**If enabled, requires:** `shared_runners_text` and `shared_runners_minutes`) Enable shared runners for new projects. |
-| `shared_runners_minutes`                 | integer          | required by: `shared_runners_enabled` | **[PREMIUM]** Set the maximum number of pipeline minutes that a group can use on shared Runners per month. |
+| `shared_runners_minutes`                 | integer          | required by: `shared_runners_enabled` | **(PREMIUM)** Set the maximum number of pipeline minutes that a group can use on shared Runners per month. |
 | `shared_runners_text`                    | string           | required by: `shared_runners_enabled` | Shared runners text. |
 | `sign_in_text`                           | string           | no                                   | Text on the login page. |
 | `signin_enabled`                         | string           | no                                   | (Deprecated: Use `password_authentication_enabled_for_web` instead) Flag indicating if password authentication is enabled for the web interface. |
 | `signup_enabled`                         | boolean          | no                                   | Enable registration. Default is `true`. |
-| `slack_app_enabled`                      | boolean          | no                                   | **[PREMIUM]** (**If enabled, requires:** `slack_app_id`, `slack_app_secret` and `slack_app_secret`) Enable Slack app. |
-| `slack_app_id`                           | string           | required by: `slack_app_enabled`      | **[PREMIUM]** The app id of the Slack-app. |
-| `slack_app_secret`                       | string           | required by: `slack_app_enabled`      | **[PREMIUM]** The app secret of the Slack-app. |
-| `slack_app_verification_token`           | string           | required by: `slack_app_enabled`      | **[PREMIUM]** The verification token of the Slack-app. |
+| `slack_app_enabled`                      | boolean          | no                                   | **(PREMIUM)** (**If enabled, requires:** `slack_app_id`, `slack_app_secret` and `slack_app_secret`) Enable Slack app. |
+| `slack_app_id`                           | string           | required by: `slack_app_enabled`      | **(PREMIUM)** The app id of the Slack-app. |
+| `slack_app_secret`                       | string           | required by: `slack_app_enabled`      | **(PREMIUM)** The app secret of the Slack-app. |
+| `slack_app_verification_token`           | string           | required by: `slack_app_enabled`      | **(PREMIUM)** The verification token of the Slack-app. |
 | `terminal_max_session_time`              | integer          | no                                   | Maximum time for web terminal websocket connection (in seconds). Set to `0` for unlimited time. |
 | `terms`                                  | text             | required by: `enforce_terms`         | (**Required by:** `enforce_terms`) Markdown content for the ToS. |
 | `throttle_authenticated_api_enabled`     | boolean          | no                                   | (**If enabled, requires:** `throttle_authenticated_api_period_in_seconds` and `throttle_authenticated_api_requests_per_period`) Enable authenticated API request rate limit. Helps reduce request volume (e.g. from crawlers or abusive bots). |
@@ -310,4 +310,4 @@ are listed in the descriptions of the relevant settings.
 | `user_show_add_ssh_key_message`          | boolean          | no                                   | When set to `false` disable the "You won't be able to pull or push project code via SSH" warning shown to users with no uploaded SSH key. |
 | `version_check_enabled`                  | boolean          | no                                   | Let GitLab inform you when an update is available. |
 | `local_markdown_version`                 | integer          | no                                   | Increase this value when any cached markdown should be invalidated. |
-| `geo_node_allowed_ips`                   | string           | yes                                  | **[PREMIUM]** Comma-separated list of IPs and CIDRs of allowed secondary nodes. For example, `1.1.1.1, 2.2.2.0/24`. |
+| `geo_node_allowed_ips`                   | string           | yes                                  | **(PREMIUM)** Comma-separated list of IPs and CIDRs of allowed secondary nodes. For example, `1.1.1.1, 2.2.2.0/24`. |
diff --git a/doc/api/users.md b/doc/api/users.md
index e1fccc14df3..4e427766750 100644
--- a/doc/api/users.md
+++ b/doc/api/users.md
@@ -359,8 +359,8 @@ Parameters:
 - `external` (optional)          - Flags the user as external - true or false(default)
 - `avatar` (optional)            - Image file for user's avatar
 - `private_profile` (optional)   - User's profile is private - true or false
-- `shared_runners_minutes_limit` (optional)       - Pipeline minutes quota for this user **[STARTER]**
-- `extra_shared_runners_minutes_limit` (optional) - Extra pipeline minutes quota for this user **[STARTER]**
+- `shared_runners_minutes_limit` (optional)       - Pipeline minutes quota for this user **(STARTER)**
+- `extra_shared_runners_minutes_limit` (optional) - Extra pipeline minutes quota for this user **(STARTER)**
 
 ## User modification
 
@@ -396,8 +396,8 @@ Parameters:
 - `extra_shared_runners_minutes_limit` (optional) - Extra pipeline minutes quota for this user
 - `avatar` (optional)              - Image file for user's avatar
 - `private_profile` (optional)     - User's profile is private - true or false
-- `shared_runners_minutes_limit` (optional)       - Pipeline minutes quota for this user **[STARTER]**
-- `extra_shared_runners_minutes_limit` (optional) - Extra pipeline minutes quota for this user **[STARTER]**
+- `shared_runners_minutes_limit` (optional)       - Pipeline minutes quota for this user **(STARTER)**
+- `extra_shared_runners_minutes_limit` (optional) - Extra pipeline minutes quota for this user **(STARTER)**
 
 On password update, user will be forced to change it upon next login.
 Note, at the moment this method does only return a `404` error,
diff --git a/doc/api/vulnerabilities.md b/doc/api/vulnerabilities.md
index f1b11c7bceb..cc6e5d3960b 100644
--- a/doc/api/vulnerabilities.md
+++ b/doc/api/vulnerabilities.md
@@ -1,4 +1,4 @@
-# Vulnerabilities API **[ULTIMATE]**
+# Vulnerabilities API **(ULTIMATE)**
 
 Every API call to vulnerabilities must be authenticated.
 
diff --git a/doc/ci/README.md b/doc/ci/README.md
index d851a56ee0e..7048ceaac41 100644
--- a/doc/ci/README.md
+++ b/doc/ci/README.md
@@ -104,27 +104,27 @@ Its feature set is listed on the table below according to DevOps stages.
 | **Verify** ||
 | [Browser Performance Testing](../user/project/merge_requests/browser_performance_testing.md) | Quickly determine the performance impact of pending code changes. |
 | [CI services](services/README.md) | Link Docker containers with your base image.|
-| [Code Quality](../user/project/merge_requests/code_quality.md) **[STARTER]** | Analyze your source code quality. |
-| [GitLab CI/CD for external repositories](ci_cd_for_external_repos/index.md) **[PREMIUM]** | Get the benefits of GitLab CI/CD combined with repositories in GitHub and BitBucket Cloud. |
-| [Interactive Web Terminals](interactive_web_terminal/index.md) **[CORE ONLY]** | Open an interactive web terminal to debug the running jobs. |
+| [Code Quality](../user/project/merge_requests/code_quality.md) **(STARTER)** | Analyze your source code quality. |
+| [GitLab CI/CD for external repositories](ci_cd_for_external_repos/index.md) **(PREMIUM)** | Get the benefits of GitLab CI/CD combined with repositories in GitHub and BitBucket Cloud. |
+| [Interactive Web Terminals](interactive_web_terminal/index.md) **(CORE ONLY)** | Open an interactive web terminal to debug the running jobs. |
 | [JUnit tests](junit_test_reports.md) | Identify script failures directly on merge requests. |
 | [Using Docker images](docker/using_docker_images.md) | Use GitLab and GitLab Runner with Docker to build and test applications. |
 |---+---|
 | **Release** ||
 | [Auto Deploy](../topics/autodevops/index.md#auto-deploy) | Deploy your application to a production environment in a Kubernetes cluster. |
 | [Building Docker images](docker/using_docker_build.md) | Maintain Docker-based projects using GitLab CI/CD. |
-| [Canary Deployments](../user/project/canary_deployments.md) **[PREMIUM]** | Ship features to only a portion of your pods and let a percentage of your user base to visit the temporarily deployed feature. |
-| [Deploy Boards](../user/project/deploy_boards.md) **[PREMIUM]** | Check the current health and status of each CI/CD environment running on Kubernetes. |
-| [Feature Flags](../user/project/operations/feature_flags.md) **[PREMIUM]** | Deploy your features behind Feature Flags. |
+| [Canary Deployments](../user/project/canary_deployments.md) **(PREMIUM)** | Ship features to only a portion of your pods and let a percentage of your user base to visit the temporarily deployed feature. |
+| [Deploy Boards](../user/project/deploy_boards.md) **(PREMIUM)** | Check the current health and status of each CI/CD environment running on Kubernetes. |
+| [Feature Flags](../user/project/operations/feature_flags.md) **(PREMIUM)** | Deploy your features behind Feature Flags. |
 | [GitLab Pages](../user/project/pages/index.md) | Deploy static websites. |
 | [GitLab Releases](../user/project/releases/index.md) | Add release notes to Git tags. |
 | [Review Apps](review_apps/index.md) | Configure GitLab CI/CD to preview code changes. |
 |---+---|
 | **Secure** ||
-| [Container Scanning](../user/application_security/container_scanning/index.md) **[ULTIMATE]** | Check your Docker containers for known vulnerabilities.|
-| [Dependency Scanning](../user/application_security/dependency_scanning/index.md) **[ULTIMATE]** | Analyze your dependencies for known vulnerabilities. |
-| [License Management](../user/application_security/license_management/index.md) **[ULTIMATE]** | Search your project dependencies for their licenses. |
-| [Security Test reports](../user/project/merge_requests/index.md#security-reports-ultimate) **[ULTIMATE]** | Check for app vulnerabilities. |
+| [Container Scanning](../user/application_security/container_scanning/index.md) **(ULTIMATE)** | Check your Docker containers for known vulnerabilities.|
+| [Dependency Scanning](../user/application_security/dependency_scanning/index.md) **(ULTIMATE)** | Analyze your dependencies for known vulnerabilities. |
+| [License Management](../user/application_security/license_management/index.md) **(ULTIMATE)** | Search your project dependencies for their licenses. |
+| [Security Test reports](../user/project/merge_requests/index.md#security-reports-ultimate) **(ULTIMATE)** | Check for app vulnerabilities. |
 
 ## Examples
 
@@ -133,7 +133,7 @@ on the [CI Examples](examples/README.md) page.
 
 GitLab also provides [example projects](https://gitlab.com/gitlab-examples) pre-configured to use GitLab CI/CD.
 
-## Administration **[CORE ONLY]**
+## Administration **(CORE ONLY)**
 
 As a GitLab administrator, you can change the default behavior
 of GitLab CI/CD for:
diff --git a/doc/ci/ci_cd_for_external_repos/bitbucket_integration.md b/doc/ci/ci_cd_for_external_repos/bitbucket_integration.md
index bbb25c78ec5..b3110b435db 100644
--- a/doc/ci/ci_cd_for_external_repos/bitbucket_integration.md
+++ b/doc/ci/ci_cd_for_external_repos/bitbucket_integration.md
@@ -2,7 +2,7 @@
 type: howto
 ---
 
-# Using GitLab CI/CD with a Bitbucket Cloud repository **[PREMIUM]**
+# Using GitLab CI/CD with a Bitbucket Cloud repository **(PREMIUM)**
 
 GitLab CI/CD can be used with Bitbucket Cloud by:
 
diff --git a/doc/ci/ci_cd_for_external_repos/github_integration.md b/doc/ci/ci_cd_for_external_repos/github_integration.md
index 36031c7929f..0bb3aa35ed0 100644
--- a/doc/ci/ci_cd_for_external_repos/github_integration.md
+++ b/doc/ci/ci_cd_for_external_repos/github_integration.md
@@ -2,7 +2,7 @@
 type: howto
 ---
 
-# Using GitLab CI/CD with a GitHub repository **[PREMIUM]**
+# Using GitLab CI/CD with a GitHub repository **(PREMIUM)**
 
 GitLab CI/CD can be used with **GitHub.com** and **GitHub Enterprise** by
 creating a [CI/CD project](index.md) to connect your GitHub repository to
diff --git a/doc/ci/ci_cd_for_external_repos/index.md b/doc/ci/ci_cd_for_external_repos/index.md
index d46e451c609..02b8eb7daa7 100644
--- a/doc/ci/ci_cd_for_external_repos/index.md
+++ b/doc/ci/ci_cd_for_external_repos/index.md
@@ -2,7 +2,7 @@
 type: index, howto
 ---
 
-# GitLab CI/CD for external repositories **[PREMIUM]**
+# GitLab CI/CD for external repositories **(PREMIUM)**
 
 >[Introduced][ee-4642] in [GitLab Premium][eep] 10.6.
 
diff --git a/doc/ci/environments.md b/doc/ci/environments.md
index a32dbc11a33..f86ca8f74f2 100644
--- a/doc/ci/environments.md
+++ b/doc/ci/environments.md
@@ -673,7 +673,7 @@ fetch line:
 fetch = +refs/environments/*:refs/remotes/origin/environments/*
 ```
 
-### Scoping environments with specs **[PREMIUM]**
+### Scoping environments with specs **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/2112) in [GitLab Premium](https://about.gitlab.com/pricing/) 9.4.
 
@@ -692,7 +692,7 @@ with `review/` would have that particular variable.
 
 Some GitLab features can behave differently for each environment.
 For example, you can
-[create a secret variable to be injected only into a production environment](variables/README.md#limiting-environment-scopes-of-environment-variables-premium). **[PREMIUM]**
+[create a secret variable to be injected only into a production environment](variables/README.md#limiting-environment-scopes-of-environment-variables-premium). **(PREMIUM)**
 
 In most cases, these features use the _environment specs_ mechanism, which offers
 an efficient way to implement scoping within each environment group.
@@ -734,7 +734,7 @@ Below are some links you may find interesting:
 - [The `.gitlab-ci.yml` definition of environments](yaml/README.md#environment)
 - [A blog post on Deployments & Environments](https://about.gitlab.com/2016/08/26/ci-deployment-and-environments/)
 - [Review Apps - Use dynamic environments to deploy your code for every branch](review_apps/index.md)
-- [Deploy Boards for your applications running on Kubernetes](../user/project/deploy_boards.md) **[PREMIUM]**
+- [Deploy Boards for your applications running on Kubernetes](../user/project/deploy_boards.md) **(PREMIUM)**
 
 <!-- ## Troubleshooting
 
diff --git a/doc/ci/environments/protected_environments.md b/doc/ci/environments/protected_environments.md
index b72ebe838b8..e5213881862 100644
--- a/doc/ci/environments/protected_environments.md
+++ b/doc/ci/environments/protected_environments.md
@@ -2,7 +2,7 @@
 type: concepts, howto
 ---
 
-# Protected Environments **[PREMIUM]**
+# Protected Environments **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6303) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.3.
 
diff --git a/doc/ci/examples/README.md b/doc/ci/examples/README.md
index 52433c72646..5a302392c54 100644
--- a/doc/ci/examples/README.md
+++ b/doc/ci/examples/README.md
@@ -45,7 +45,7 @@ language users and GitLab by sending a merge request with a guide for that langu
 You may want to apply for the [GitLab Community Writers Program](https://about.gitlab.com/community/writers/)
 to get paid for writing complete articles for GitLab.
 
-## Adding templates to your GitLab installation **[PREMIUM ONLY]**
+## Adding templates to your GitLab installation **(PREMIUM ONLY)**
 
 If you want to have customized examples and templates for your own self-managed GitLab instance available to your team, your GitLab administrator can [designate an instance template repository](../../user/admin_area/settings/instance_template_repository.md) that contains examples and templates specific to your enterprise.
 
diff --git a/doc/ci/interactive_web_terminal/index.md b/doc/ci/interactive_web_terminal/index.md
index 1387d4df500..6c73cbbf8d7 100644
--- a/doc/ci/interactive_web_terminal/index.md
+++ b/doc/ci/interactive_web_terminal/index.md
@@ -59,7 +59,7 @@ close the terminal window.
 
 ![finished job with terminal open](img/finished_job_with_terminal_open.png)
 
-## Interactive Web Terminals for the Web IDE **[ULTIMATE ONLY]**
+## Interactive Web Terminals for the Web IDE **(ULTIMATE ONLY)**
 
 Read the Web IDE docs to learn how to run [Interactive Terminals through the Web IDE](../../user/project/web_ide/index.md).
 
diff --git a/doc/ci/introduction/index.md b/doc/ci/introduction/index.md
index ef9f9a9973c..fc89f0fc94f 100644
--- a/doc/ci/introduction/index.md
+++ b/doc/ci/introduction/index.md
@@ -177,22 +177,22 @@ according to each stage (Verify, Package, Release).
 
 1. **Verify**:
     - Automatically build and test your application with Continuous Integration.
-    - Analyze your source code quality with [GitLab Code Quality](../../user/project/merge_requests/code_quality.md). **[STARTER]**
-    - Determine the performance impact of code changes with [Browser Performance Testing](../../user/project/merge_requests/browser_performance_testing.md). **[PREMIUM]**
-    - Perform a series of tests, such as [Container Scanning](../../user/application_security/container_scanning/index.md) **[ULTIMATE]**, [Dependency Scanning](../../user/application_security/dependency_scanning/index.md) **[ULTIMATE]**, and [JUnit tests](../junit_test_reports.md).
+    - Analyze your source code quality with [GitLab Code Quality](../../user/project/merge_requests/code_quality.md). **(STARTER)**
+    - Determine the performance impact of code changes with [Browser Performance Testing](../../user/project/merge_requests/browser_performance_testing.md). **(PREMIUM)**
+    - Perform a series of tests, such as [Container Scanning](../../user/application_security/container_scanning/index.md) **(ULTIMATE)**, [Dependency Scanning](../../user/application_security/dependency_scanning/index.md) **(ULTIMATE)**, and [JUnit tests](../junit_test_reports.md).
     - Deploy your changes with [Review Apps](../review_apps/index.md) to preview the app changes on every branch.
 1. **Package**:
     - Store Docker images with [Container Registry](../../user/project/container_registry.md).
-    - Store NPM packages with [NPM Registry](../../user/project/packages/npm_registry.md). **[PREMIUM]**
-    - Store Maven artifacts with [Maven Repository](../../user/project/packages/maven_repository.md). **[PREMIUM]**
+    - Store NPM packages with [NPM Registry](../../user/project/packages/npm_registry.md). **(PREMIUM)**
+    - Store Maven artifacts with [Maven Repository](../../user/project/packages/maven_repository.md). **(PREMIUM)**
 1. **Release**:
     - Continuous Deployment, automatically deploying your app to production.
     - Continuous Delivery, manually click to deploy your app to production.
     - Deploy static websites with [GitLab Pages](../../user/project/pages/index.md).
-    - Ship features to only a portion of your pods and let a percentage of your user base to visit the temporarily deployed feature with [Canary Deployments](../../user/project/canary_deployments.md). **[PREMIUM]**
-    - Deploy your features behind [Feature Flags](../../user/project/operations/feature_flags.md). **[PREMIUM]**
+    - Ship features to only a portion of your pods and let a percentage of your user base to visit the temporarily deployed feature with [Canary Deployments](../../user/project/canary_deployments.md). **(PREMIUM)**
+    - Deploy your features behind [Feature Flags](../../user/project/operations/feature_flags.md). **(PREMIUM)**
     - Add release notes to any Git tag with [GitLab Releases](../../user/project/releases/index.md).
-    - View of the current health and status of each CI environment running on Kubernetes with [Deploy Boards](../../user/project/deploy_boards.md). **[PREMIUM]**
+    - View of the current health and status of each CI environment running on Kubernetes with [Deploy Boards](../../user/project/deploy_boards.md). **(PREMIUM)**
     -  Deploy your application to a production environment in a Kubernetes cluster with [Auto Deploy](../../topics/autodevops/index.md#auto-deploy).
 
 With GitLab CI/CD you can also:
@@ -201,7 +201,7 @@ With GitLab CI/CD you can also:
 - Deploy your app to different [environments](../environments.md).
 - Install your own [GitLab Runner](https://docs.gitlab.com/runner/).
 - [Schedule pipelines](../../user/project/pipelines/schedules.md).
-- Check for app vulnerabilities with [Security Test reports](../../user/project/merge_requests/index.md#security-reports-ultimate). **[ULTIMATE]**
+- Check for app vulnerabilities with [Security Test reports](../../user/project/merge_requests/index.md#security-reports-ultimate). **(ULTIMATE)**
 
 To see all CI/CD features, navigate back to the [CI/CD index](../README.md).
 
diff --git a/doc/ci/merge_request_pipelines/index.md b/doc/ci/merge_request_pipelines/index.md
index e70ae0bd154..72a9a876037 100644
--- a/doc/ci/merge_request_pipelines/index.md
+++ b/doc/ci/merge_request_pipelines/index.md
@@ -76,11 +76,11 @@ when a merge request was created or updated. For example:
 
 ![Merge request page](img/merge_request.png)
 
-## Pipelines for Merged Results **[PREMIUM]**
+## Pipelines for Merged Results **(PREMIUM)**
 
 Read the [documentation on Pipelines for Merged Results](pipelines_for_merged_results/index.md).
 
-### Merge Trains **[PREMIUM]**
+### Merge Trains **(PREMIUM)**
 
 Read the [documentation on Merge Trains](pipelines_for_merged_results/merge_trains/index.md).
 
diff --git a/doc/ci/merge_request_pipelines/pipelines_for_merged_results/index.md b/doc/ci/merge_request_pipelines/pipelines_for_merged_results/index.md
index 3c5088089fa..a13857bee25 100644
--- a/doc/ci/merge_request_pipelines/pipelines_for_merged_results/index.md
+++ b/doc/ci/merge_request_pipelines/pipelines_for_merged_results/index.md
@@ -3,7 +3,7 @@ type: reference
 last_update: 2019-07-03
 ---
 
-# Pipelines for Merged Results **[PREMIUM]**
+# Pipelines for Merged Results **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/7380) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.10.
 > This feature is disabled by default until we resolve issues with [contention handling](https://gitlab.com/gitlab-org/gitlab-ee/issues/11222), but [can be enabled manually](#enabling-pipelines-for-merged-results).
@@ -61,7 +61,7 @@ CAUTION: **Warning:**
 Make sure your `gitlab-ci.yml` file is [configured properly for pipelines for merge requests](../index.md#configuring-pipelines-for-merge-requests),
 otherwise pipelines for merged results won't run and your merge requests will be stuck in an unresolved state.
 
-## Merge Trains **[PREMIUM]**
+## Merge Trains **(PREMIUM)**
 
 Read the [documentation on Merge Trains](merge_trains/index.md).
 
diff --git a/doc/ci/merge_request_pipelines/pipelines_for_merged_results/merge_trains/index.md b/doc/ci/merge_request_pipelines/pipelines_for_merged_results/merge_trains/index.md
index c5ff6f9ebed..57358434c02 100644
--- a/doc/ci/merge_request_pipelines/pipelines_for_merged_results/merge_trains/index.md
+++ b/doc/ci/merge_request_pipelines/pipelines_for_merged_results/merge_trains/index.md
@@ -3,7 +3,7 @@ type: reference
 last_update: 2019-07-03
 ---
 
-# Merge Trains **[PREMIUM]**
+# Merge Trains **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/9186) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.0.
 > This feature is disabled by default, but [can be enabled manually](#enabling-merge-trains).
diff --git a/doc/ci/metrics_reports.md b/doc/ci/metrics_reports.md
index 1b2dda29eb5..4d3f5a143f7 100644
--- a/doc/ci/metrics_reports.md
+++ b/doc/ci/metrics_reports.md
@@ -2,7 +2,7 @@
 type: reference
 ---
 
-# Metrics Reports **[PREMIUM]**
+# Metrics Reports **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/9788) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.10.
 Requires GitLab Runner 11.10 and above.
diff --git a/doc/ci/multi_project_pipelines.md b/doc/ci/multi_project_pipelines.md
index 50c8d82602b..463b9194c58 100644
--- a/doc/ci/multi_project_pipelines.md
+++ b/doc/ci/multi_project_pipelines.md
@@ -2,7 +2,7 @@
 type: reference
 ---
 
-# Multi-project pipelines **[PREMIUM]**
+# Multi-project pipelines **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/2121) in
 [GitLab Premium 9.3](https://about.gitlab.com/2017/06/22/gitlab-9-3-released/#multi-project-pipeline-graphs).
diff --git a/doc/ci/pipelines.md b/doc/ci/pipelines.md
index 4a07aa31f8a..06a81c3d0c7 100644
--- a/doc/ci/pipelines.md
+++ b/doc/ci/pipelines.md
@@ -234,7 +234,7 @@ Pipeline status and test coverage report badges are available and configurable f
 
 For information on adding pipeline badges to projects, see [Pipeline badges](../user/project/pipelines/settings.md#pipeline-badges).
 
-## Multi-project pipelines **[PREMIUM]**
+## Multi-project pipelines **(PREMIUM)**
 
 Pipelines for different projects can be combined and visualized together.
 
diff --git a/doc/ci/review_apps/index.md b/doc/ci/review_apps/index.md
index 70934e074a0..c7f8792a830 100644
--- a/doc/ci/review_apps/index.md
+++ b/doc/ci/review_apps/index.md
@@ -154,7 +154,7 @@ After adding Review Apps to your workflow, you follow the branched Git flow. Tha
 1. Wait for the Runner to build and deploy your web application.
 1. Click on the link that provided in the merge request related to the branch to see the changes live.
 
-### Visual Reviews **[STARTER]**
+### Visual Reviews **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/10761) in GitLab Starter 12.0.
 
diff --git a/doc/ci/triggers/README.md b/doc/ci/triggers/README.md
index 04c541fefe7..d1f9aa03b6b 100644
--- a/doc/ci/triggers/README.md
+++ b/doc/ci/triggers/README.md
@@ -32,7 +32,7 @@ to protect trigger tokens.
 You can use the `CI_JOB_TOKEN` [variable][predef] (used to authenticate
 with the [GitLab Container Registry][registry]) in the following cases.
 
-#### When used with multi-project pipelines **[PREMIUM]**
+#### When used with multi-project pipelines **(PREMIUM)**
 
 > **Note**:
 The use of `CI_JOB_TOKEN` for multi-project pipelines was [introduced][ee-2017]
@@ -56,7 +56,7 @@ Pipelines triggered that way also expose a special variable:
 
 Read more about the [pipelines trigger API][trigapi].
 
-#### When a pipeline depends on the artifacts of another pipeline **[PREMIUM]**
+#### When a pipeline depends on the artifacts of another pipeline **(PREMIUM)**
 
 > The use of `CI_JOB_TOKEN` in the artifacts download API was [introduced][ee-2346]
   in [GitLab Premium][ee] 9.5.
diff --git a/doc/ci/variables/README.md b/doc/ci/variables/README.md
index 1b50273eca2..42dd4f08ed8 100644
--- a/doc/ci/variables/README.md
+++ b/doc/ci/variables/README.md
@@ -389,7 +389,7 @@ Protected variables can be added by going to your project's
 
 Once you set them, they will be available for all subsequent pipelines.
 
-### Limiting environment scopes of environment variables **[PREMIUM]**
+### Limiting environment scopes of environment variables **(PREMIUM)**
 
 You can limit the environment scope of a variable by
 [defining which environments][envs] it can be available for.
diff --git a/doc/ci/yaml/README.md b/doc/ci/yaml/README.md
index de04a816e8b..474db05de06 100644
--- a/doc/ci/yaml/README.md
+++ b/doc/ci/yaml/README.md
@@ -1477,7 +1477,7 @@ concatenated into a single file. Use a filename pattern (`junit: rspec-*.xml`),
 an array of filenames (`junit: [rspec-1.xml, rspec-2.xml, rspec-3.xml]`), or a
 combination thereof (`junit: [rspec.xml, test-results/TEST-*.xml]`).
 
-##### `artifacts:reports:codequality` **[STARTER]**
+##### `artifacts:reports:codequality` **(STARTER)**
 
 > Introduced in GitLab 11.5. Requires GitLab Runner 11.5 and above.
 
@@ -1487,7 +1487,7 @@ as artifacts.
 The collected Code Quality report will be uploaded to GitLab as an artifact and will
 be automatically shown in merge requests.
 
-##### `artifacts:reports:sast` **[ULTIMATE]**
+##### `artifacts:reports:sast` **(ULTIMATE)**
 
 > Introduced in GitLab 11.5. Requires GitLab Runner 11.5 and above.
 
@@ -1498,7 +1498,7 @@ The collected SAST report will be uploaded to GitLab as an artifact and will
 be automatically shown in merge requests, pipeline view and provide data for security
 dashboards.
 
-##### `artifacts:reports:dependency_scanning` **[ULTIMATE]**
+##### `artifacts:reports:dependency_scanning` **(ULTIMATE)**
 
 > Introduced in GitLab 11.5. Requires GitLab Runner 11.5 and above.
 
@@ -1509,7 +1509,7 @@ The collected Dependency Scanning report will be uploaded to GitLab as an artifa
 be automatically shown in merge requests, pipeline view and provide data for security
 dashboards.
 
-##### `artifacts:reports:container_scanning` **[ULTIMATE]**
+##### `artifacts:reports:container_scanning` **(ULTIMATE)**
 
 > Introduced in GitLab 11.5. Requires GitLab Runner 11.5 and above.
 
@@ -1520,7 +1520,7 @@ The collected Container Scanning report will be uploaded to GitLab as an artifac
 be automatically shown in merge requests, pipeline view and provide data for security
 dashboards.
 
-##### `artifacts:reports:dast` **[ULTIMATE]**
+##### `artifacts:reports:dast` **(ULTIMATE)**
 
 > Introduced in GitLab 11.5. Requires GitLab Runner 11.5 and above.
 
@@ -1531,7 +1531,7 @@ The collected DAST report will be uploaded to GitLab as an artifact and will
 be automatically shown in merge requests, pipeline view and provide data for security
 dashboards.
 
-##### `artifacts:reports:license_management` **[ULTIMATE]**
+##### `artifacts:reports:license_management` **(ULTIMATE)**
 
 > Introduced in GitLab 11.5. Requires GitLab Runner 11.5 and above.
 
@@ -1542,7 +1542,7 @@ The collected License Management report will be uploaded to GitLab as an artifac
 be automatically shown in merge requests, pipeline view and provide data for security
 dashboards.
 
-##### `artifacts:reports:performance` **[PREMIUM]**
+##### `artifacts:reports:performance` **(PREMIUM)**
 
 > Introduced in GitLab 11.5. Requires GitLab Runner 11.5 and above.
 
@@ -1552,7 +1552,7 @@ as artifacts.
 The collected Performance report will be uploaded to GitLab as an artifact and will
 be automatically shown in merge requests.
 
-##### `artifacts:reports:metrics` **[PREMIUM]**
+##### `artifacts:reports:metrics` **(PREMIUM)**
 
 > Introduced in GitLab 11.10.
 
@@ -1749,7 +1749,7 @@ test:
   parallel: 5
 ```
 
-### `trigger` **[PREMIUM]**
+### `trigger` **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/8997) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.8.
 
diff --git a/doc/customization/index.md b/doc/customization/index.md
index 71e87b3f111..0198059297f 100644
--- a/doc/customization/index.md
+++ b/doc/customization/index.md
@@ -2,7 +2,7 @@
 description: Learn how to customize GitLab's appearance for self-managed installations.
 ---
 
-# Customizing GitLab's appearance **[CORE ONLY]**
+# Customizing GitLab's appearance **(CORE ONLY)**
 
 For GitLab self-managed instances, it's possible to customize
 a few pages.
diff --git a/doc/development/documentation/styleguide.md b/doc/development/documentation/styleguide.md
index d0a887b6175..7127efb7405 100644
--- a/doc/development/documentation/styleguide.md
+++ b/doc/development/documentation/styleguide.md
@@ -767,24 +767,24 @@ Other text includes deprecation notices and version-specific how-to information.
 When a feature is available in EE-only tiers, add the corresponding tier according to the
 feature availability:
 
-- For GitLab Starter and GitLab.com Bronze: `**[STARTER]**`.
-- For GitLab Premium and GitLab.com Silver: `**[PREMIUM]**`.
-- For GitLab Ultimate and GitLab.com Gold: `**[ULTIMATE]**`.
-- For GitLab Core and GitLab.com Free: `**[CORE]**`.
+- For GitLab Starter and GitLab.com Bronze: `**(STARTER)**`.
+- For GitLab Premium and GitLab.com Silver: `**(PREMIUM)**`.
+- For GitLab Ultimate and GitLab.com Gold: `**(ULTIMATE)**`.
+- For GitLab Core and GitLab.com Free: `**(CORE)**`.
 
 To exclude GitLab.com tiers (when the feature is not available in GitLab.com), add the
 keyword "only":
 
-- For GitLab Core: `**[CORE ONLY]**`.
-- For GitLab Starter: `**[STARTER ONLY]**`.
-- For GitLab Premium: `**[PREMIUM ONLY]**`.
-- For GitLab Ultimate: `**[ULTIMATE ONLY]**`.
+- For GitLab Core: `**(CORE ONLY)**`.
+- For GitLab Starter: `**(STARTER ONLY)**`.
+- For GitLab Premium: `**(PREMIUM ONLY)**`.
+- For GitLab Ultimate: `**(ULTIMATE ONLY)**`.
 
 For GitLab.com only tiers (when the feature is not available for self-hosted instances):
 
-- For GitLab Bronze and higher tiers: `**[BRONZE ONLY]**`.
-- For GitLab Silver and higher tiers: `**[SILVER ONLY]**`.
-- For GitLab Gold: `**[GOLD ONLY]**`.
+- For GitLab Bronze and higher tiers: `**(BRONZE ONLY)**`.
+- For GitLab Silver and higher tiers: `**(SILVER ONLY)**`.
+- For GitLab Gold: `**(GOLD ONLY)**`.
 
 The tier should be ideally added to headers, so that the full badge will be displayed.
 However, it can be also mentioned from paragraphs, list items, and table cells. For these cases,
@@ -792,9 +792,9 @@ the tier mention will be represented by an orange question mark that will show t
 
 For example:
 
-- `**[STARTER]**` renders as **[STARTER]**
-- `**[STARTER ONLY]**` renders as **[STARTER ONLY]**
-- `**[SILVER ONLY]**` renders as **[SILVER ONLY]**
+- `**(STARTER)**` renders as **(STARTER)**
+- `**(STARTER ONLY)**` renders as **(STARTER ONLY)**
+- `**(SILVER ONLY)**` renders as **(SILVER ONLY)**
 
 The absence of tiers' mentions mean that the feature is available in GitLab Core,
 GitLab.com Free, and all higher tiers.
@@ -802,7 +802,7 @@ GitLab.com Free, and all higher tiers.
 ### How it works
 
 Introduced by [!244](https://gitlab.com/gitlab-com/gitlab-docs/merge_requests/244),
-the special markup `**[STARTER]**` will generate a `span` element to trigger the
+the special markup `**(STARTER)**` will generate a `span` element to trigger the
 badges and tooltips (`<span class="badge-trigger starter">`). When the keyword
 "only" is added, the corresponding GitLab.com badge will not be displayed.
 
diff --git a/doc/development/elasticsearch.md b/doc/development/elasticsearch.md
index e5da47ba16e..0965db29557 100644
--- a/doc/development/elasticsearch.md
+++ b/doc/development/elasticsearch.md
@@ -1,4 +1,4 @@
-# Elasticsearch knowledge **[STARTER ONLY]**
+# Elasticsearch knowledge **(STARTER ONLY)**
 
 This area is to maintain a compendium of useful information when working with elasticsearch.
 
diff --git a/doc/development/geo.md b/doc/development/geo.md
index a10f13b069f..685d4e44ad3 100644
--- a/doc/development/geo.md
+++ b/doc/development/geo.md
@@ -1,4 +1,4 @@
-# Geo (development) **[PREMIUM ONLY]**
+# Geo (development) **(PREMIUM ONLY)**
 
 Geo connects GitLab instances together. One GitLab instance is
 designated as a **primary** node and can be run with multiple
diff --git a/doc/development/go_guide/index.md b/doc/development/go_guide/index.md
index f961a2fc837..f09339eb3a4 100644
--- a/doc/development/go_guide/index.md
+++ b/doc/development/go_guide/index.md
@@ -41,7 +41,7 @@ of possible security breaches in our code:
 
 Remember to run
 [SAST](../../user/application_security/sast/index.md)
-**[ULTIMATE]** on your project (or at least the [gosec
+**(ULTIMATE)** on your project (or at least the [gosec
 analyzer](https://gitlab.com/gitlab-org/security-products/analyzers/gosec)),
 and to follow our [Security
 requirements](../code_review.md#security-requirements).
@@ -95,9 +95,9 @@ Dependencies should be kept to the minimum. The introduction of a new
 dependency should be argued in the merge request, as per our [Approval
 Guidelines](../code_review.md#approval-guidelines). Both [License
 Management](../../user/project/merge_requests/license_management.md)
-**[ULTIMATE]** and [Dependency
+**(ULTIMATE)** and [Dependency
 Scanning](../../user/application_security/dependency_scanning/index.md)
-**[ULTIMATE]** should be activated on all projects to ensure new dependencies
+**(ULTIMATE)** should be activated on all projects to ensure new dependencies
 security status and license compatibility.
 
 ### Modules
diff --git a/doc/development/licensed_feature_availability.md b/doc/development/licensed_feature_availability.md
index 6f3dd59b2c3..7d0a6f6acda 100644
--- a/doc/development/licensed_feature_availability.md
+++ b/doc/development/licensed_feature_availability.md
@@ -1,4 +1,4 @@
-# Licensed feature availability **[STARTER]**
+# Licensed feature availability **(STARTER)**
 
 As of GitLab 9.4, we've been supporting a simplified version of licensed 
 feature availability checks via `ee/app/models/license.rb`, both for 
diff --git a/doc/development/packages.md b/doc/development/packages.md
index ab0c5f9904d..418efd9eef9 100644
--- a/doc/development/packages.md
+++ b/doc/development/packages.md
@@ -1,4 +1,4 @@
-# Packages **[PREMIUM]**
+# Packages **(PREMIUM)**
 
 This document will guide you through adding another [package management system](../administration/packages.md) support to GitLab.
 
diff --git a/doc/development/rake_tasks.md b/doc/development/rake_tasks.md
index 4fc10b6af5c..c97e179910b 100644
--- a/doc/development/rake_tasks.md
+++ b/doc/development/rake_tasks.md
@@ -28,7 +28,7 @@ bin/rake "gitlab:seed:issues[group-path/project-path]"
 By default, this seeds an average of 2 issues per week for the last 5 weeks per
 project.
 
-#### Seeding issues for Insights charts **[ULTIMATE]**
+#### Seeding issues for Insights charts **(ULTIMATE)**
 
 You can seed issues specifically for working with the
 [Insights charts](../user/group/insights/index.md) with the
diff --git a/doc/gitlab-basics/create-project.md b/doc/gitlab-basics/create-project.md
index a9ae4fb23f9..ccba72f0ef8 100644
--- a/doc/gitlab-basics/create-project.md
+++ b/doc/gitlab-basics/create-project.md
@@ -16,7 +16,7 @@ To create a project in GitLab:
    - [Import a project](../user/project/import/index.md) from a different repository,
      if enabled on your GitLab instance. Contact your GitLab admin if this
      is unavailable.
-   - Run [CI/CD pipelines for external repositories](../ci/ci_cd_for_external_repos/index.md). **[PREMIUM]**
+   - Run [CI/CD pipelines for external repositories](../ci/ci_cd_for_external_repos/index.md). **(PREMIUM)**
 
 ## Blank projects
 
@@ -69,7 +69,7 @@ TIP: **Tip:**
 You can improve the existing built-in templates or contribute new ones on the
 [`project-templates`](https://gitlab.com/gitlab-org/project-templates) and [`pages`](https://gitlab.com/pages) groups.
 
-### Custom project templates **[PREMIUM ONLY]**
+### Custom project templates **(PREMIUM ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/6860) in
 [GitLab Premium](https://about.gitlab.com/pricing) 11.2.
diff --git a/doc/install/README.md b/doc/install/README.md
index 9cc21412898..af98791c8e9 100644
--- a/doc/install/README.md
+++ b/doc/install/README.md
@@ -4,7 +4,7 @@ description: Read through the GitLab installation methods.
 type: index
 ---
 
-# Installation **[CORE ONLY]**
+# Installation **(CORE ONLY)**
 
 GitLab can be installed in most GNU/Linux distributions and in a number
 of cloud providers. To get the best experience from GitLab you need to balance
diff --git a/doc/install/pivotal/index.md b/doc/install/pivotal/index.md
index f068572f1e9..6a4b361c842 100644
--- a/doc/install/pivotal/index.md
+++ b/doc/install/pivotal/index.md
@@ -1,4 +1,4 @@
-# GitLab Pivotal Tile **[PREMIUM ONLY]**
+# GitLab Pivotal Tile **(PREMIUM ONLY)**
 
 CAUTION: **Discontinued:**
 As of September 13, 2017, the GitLab Enterprise Plus for Pivotal Cloud Foundry
diff --git a/doc/integration/elasticsearch.md b/doc/integration/elasticsearch.md
index 877330b8c44..da1df07a75d 100644
--- a/doc/integration/elasticsearch.md
+++ b/doc/integration/elasticsearch.md
@@ -1,4 +1,4 @@
-# Elasticsearch integration **[STARTER ONLY]**
+# Elasticsearch integration **(STARTER ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/109 "Elasticsearch Merge Request") in GitLab [Starter](https://about.gitlab.com/pricing/) 8.4. Support
 > for [Amazon Elasticsearch](http://docs.aws.amazon.com/elasticsearch-service/latest/developerguide/es-gsg.html) was [introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/1305) in GitLab
diff --git a/doc/integration/jenkins.md b/doc/integration/jenkins.md
index e6496ae3a2e..50cb3d50009 100644
--- a/doc/integration/jenkins.md
+++ b/doc/integration/jenkins.md
@@ -1,4 +1,4 @@
-# Jenkins CI service **[STARTER]**
+# Jenkins CI service **(STARTER)**
 
 >**Note:**
 In GitLab 8.3, Jenkins integration using the
diff --git a/doc/integration/jira_development_panel.md b/doc/integration/jira_development_panel.md
index 703736eeb3c..60c7bdabf93 100644
--- a/doc/integration/jira_development_panel.md
+++ b/doc/integration/jira_development_panel.md
@@ -1,4 +1,4 @@
-# GitLab Jira development panel integration **[PREMIUM]**
+# GitLab Jira development panel integration **(PREMIUM)**
 
 > [Introduced][ee-2381] in [GitLab Premium][eep] 10.0.
 
diff --git a/doc/integration/kerberos.md b/doc/integration/kerberos.md
index 44117755b83..cf2ef511264 100644
--- a/doc/integration/kerberos.md
+++ b/doc/integration/kerberos.md
@@ -1,4 +1,4 @@
-# Kerberos integration **[STARTER ONLY]**
+# Kerberos integration **(STARTER ONLY)**
 
 GitLab can integrate with [Kerberos][kerb] as an authentication mechanism.
 
diff --git a/doc/push_rules/push_rules.md b/doc/push_rules/push_rules.md
index 2142f5a5f69..b1754131e76 100644
--- a/doc/push_rules/push_rules.md
+++ b/doc/push_rules/push_rules.md
@@ -2,7 +2,7 @@
 type: reference, howto
 ---
 
-# Push Rules **[STARTER]**
+# Push Rules **(STARTER)**
 
 Gain additional control over what can and can't be pushed to your repository by using
 regular expressions to reject pushes based on commit contents, branch names or file details.
diff --git a/doc/raketasks/web_hooks.md b/doc/raketasks/web_hooks.md
index 2c6ae0749dd..a498e9793c1 100644
--- a/doc/raketasks/web_hooks.md
+++ b/doc/raketasks/web_hooks.md
@@ -1,4 +1,4 @@
-# Webhooks administration **[CORE ONLY]**
+# Webhooks administration **(CORE ONLY)**
 
 ## Add a webhook for **ALL** projects:
 
diff --git a/doc/tools/email.md b/doc/tools/email.md
index a2d677484f0..72a5d094bc9 100644
--- a/doc/tools/email.md
+++ b/doc/tools/email.md
@@ -2,7 +2,7 @@
 type: howto, reference
 ---
 
-# Email from GitLab **[STARTER ONLY]**
+# Email from GitLab **(STARTER ONLY)**
 
 GitLab provides a simple tool to administrators for emailing all users, or users of
 a chosen group or project, right from the admin area. Users will receive the email
diff --git a/doc/topics/authentication/index.md b/doc/topics/authentication/index.md
index 228da2d1f57..8b4a2f1630b 100644
--- a/doc/topics/authentication/index.md
+++ b/doc/topics/authentication/index.md
@@ -17,11 +17,11 @@ This page gathers all the resources for the topic **Authentication** within GitL
 ## GitLab administrators
 
 - [LDAP (Community Edition)](../../administration/auth/ldap.md)
-- [LDAP (Enterprise Edition)](../../administration/auth/ldap-ee.md) **[STARTER]**
+- [LDAP (Enterprise Edition)](../../administration/auth/ldap-ee.md) **(STARTER)**
 - [Enforce Two-factor Authentication (2FA)](../../security/two_factor_authentication.md#enforce-two-factor-authentication-2fa)
 - **Articles:**
   - [How to Configure LDAP with GitLab CE](../../administration/auth/how_to_configure_ldap_gitlab_ce/index.md)
-  - [How to Configure LDAP with GitLab EE](../../administration/auth/how_to_configure_ldap_gitlab_ee/index.md) **[STARTER]**
+  - [How to Configure LDAP with GitLab EE](../../administration/auth/how_to_configure_ldap_gitlab_ee/index.md) **(STARTER)**
   - [Feature Highlight: LDAP Integration](https://about.gitlab.com/2014/07/10/feature-highlight-ldap-sync/)
   - [Debugging LDAP](https://about.gitlab.com/handbook/support/workflows/support-engineering/ldap/debugging_ldap.html)
 - **Integrations:**
@@ -30,10 +30,10 @@ This page gathers all the resources for the topic **Authentication** within GitL
   - [Atlassian Crowd OmniAuth Provider](../../administration/auth/crowd.md)
   - [CAS OmniAuth Provider](../../integration/cas.md)
   - [SAML OmniAuth Provider](../../integration/saml.md)
-  - [SAML for GitLab.com Groups](../../user/group/saml_sso/index.md) **[SILVER ONLY]**
-  - [SCIM user provisioning for GitLab.com Groups](../../user/group/saml_sso/scim_setup.md) **[SILVER ONLY]**
+  - [SAML for GitLab.com Groups](../../user/group/saml_sso/index.md) **(SILVER ONLY)**
+  - [SCIM user provisioning for GitLab.com Groups](../../user/group/saml_sso/scim_setup.md) **(SILVER ONLY)**
   - [Okta SSO provider](../../administration/auth/okta.md)
-  - [Kerberos integration (GitLab EE)](../../integration/kerberos.md) **[STARTER]**
+  - [Kerberos integration (GitLab EE)](../../integration/kerberos.md) **(STARTER)**
 
 ## API
 
diff --git a/doc/topics/autodevops/index.md b/doc/topics/autodevops/index.md
index bd788cb138c..e2d51f673b5 100644
--- a/doc/topics/autodevops/index.md
+++ b/doc/topics/autodevops/index.md
@@ -61,15 +61,15 @@ project in a simple and automatic way:
 
 1. [Auto Build](#auto-build)
 1. [Auto Test](#auto-test)
-1. [Auto Code Quality](#auto-code-quality-starter) **[STARTER]**
-1. [Auto SAST (Static Application Security Testing)](#auto-sast-ultimate) **[ULTIMATE]**
-1. [Auto Dependency Scanning](#auto-dependency-scanning-ultimate) **[ULTIMATE]**
-1. [Auto License Management](#auto-license-management-ultimate) **[ULTIMATE]**
-1. [Auto Container Scanning](#auto-container-scanning-ultimate) **[ULTIMATE]**
+1. [Auto Code Quality](#auto-code-quality-starter) **(STARTER)**
+1. [Auto SAST (Static Application Security Testing)](#auto-sast-ultimate) **(ULTIMATE)**
+1. [Auto Dependency Scanning](#auto-dependency-scanning-ultimate) **(ULTIMATE)**
+1. [Auto License Management](#auto-license-management-ultimate) **(ULTIMATE)**
+1. [Auto Container Scanning](#auto-container-scanning-ultimate) **(ULTIMATE)**
 1. [Auto Review Apps](#auto-review-apps)
-1. [Auto DAST (Dynamic Application Security Testing)](#auto-dast-ultimate) **[ULTIMATE]**
+1. [Auto DAST (Dynamic Application Security Testing)](#auto-dast-ultimate) **(ULTIMATE)**
 1. [Auto Deploy](#auto-deploy)
-1. [Auto Browser Performance Testing](#auto-browser-performance-testing-premium) **[PREMIUM]**
+1. [Auto Browser Performance Testing](#auto-browser-performance-testing-premium) **(PREMIUM)**
 1. [Auto Monitoring](#auto-monitoring)
 
 As Auto DevOps relies on many different components, it's good to have a basic
@@ -169,7 +169,7 @@ Support for `AUTO_DEVOPS_DOMAIN` was [removed in GitLab
 12.0](https://gitlab.com/gitlab-org/gitlab-ce/issues/56959).
 
 
-## Using multiple Kubernetes clusters **[PREMIUM]**
+## Using multiple Kubernetes clusters **(PREMIUM)**
 
 When using Auto DevOps, you may want to deploy different environments to
 different Kubernetes clusters. This is possible due to the 1:1 connection that
@@ -354,7 +354,7 @@ you may succeed with a [custom buildpack](#custom-buildpacks). Check the
 Auto Test uses tests you already have in your application. If there are no
 tests, it's up to you to add them.
 
-### Auto Code Quality **[STARTER]**
+### Auto Code Quality **(STARTER)**
 
 Auto Code Quality uses the
 [Code Quality image](https://gitlab.com/gitlab-org/security-products/codequality) to run
@@ -365,7 +365,7 @@ out.
 Any differences between the source and target branches are also
 [shown in the merge request widget](../../user/project/merge_requests/code_quality.md).
 
-### Auto SAST **[ULTIMATE]**
+### Auto SAST **(ULTIMATE)**
 
 > Introduced in [GitLab Ultimate][ee] 10.3.
 
@@ -380,7 +380,7 @@ check out.
 Any security warnings are also shown in the merge request widget. Read more how
 [SAST works](../../user/application_security/sast/index.md).
 
-### Auto Dependency Scanning **[ULTIMATE]**
+### Auto Dependency Scanning **(ULTIMATE)**
 
 > Introduced in [GitLab Ultimate][ee] 10.7.
 
@@ -397,7 +397,7 @@ check out.
 Any security warnings are also shown in the merge request widget. Read more about
 [Dependency Scanning](../../user/application_security/dependency_scanning/index.md).
 
-### Auto License Management **[ULTIMATE]**
+### Auto License Management **(ULTIMATE)**
 
 > Introduced in [GitLab Ultimate][ee] 11.0.
 
@@ -413,7 +413,7 @@ check out.
 Any licenses are also shown in the merge request widget. Read more how
 [License Management works](../../user/application_security/license_management/index.md).
 
-### Auto Container Scanning **[ULTIMATE]**
+### Auto Container Scanning **(ULTIMATE)**
 
 > Introduced in GitLab 10.4.
 
@@ -468,7 +468,7 @@ deploys with Auto DevOps can undo your changes. Also, if you change something
 and want to undo it by deploying again, Helm may not detect that anything changed
 in the first place, and thus not realize that it needs to re-apply the old config.
 
-### Auto DAST **[ULTIMATE]**
+### Auto DAST **(ULTIMATE)**
 
 > Introduced in [GitLab Ultimate][ee] 10.4.
 
@@ -483,7 +483,7 @@ later download and check out.
 Any security warnings are also shown in the merge request widget. Read how
 [DAST works](../../user/application_security/dast/index.md).
 
-### Auto Browser Performance Testing **[PREMIUM]**
+### Auto Browser Performance Testing **(PREMIUM)**
 
 > Introduced in [GitLab Premium][ee] 10.4.
 
@@ -655,7 +655,7 @@ repo or by specifying a project variable:
 - **Project variable** - Create a [project variable](../../ci/variables/README.md#gitlab-cicd-environment-variables)
   `AUTO_DEVOPS_CHART` with the URL of a custom chart to use or create two project variables `AUTO_DEVOPS_CHART_REPOSITORY` with the URL of a custom chart repository and `AUTO_DEVOPS_CHART` with the path to the chart.
 
-### Custom Helm chart per environment **[PREMIUM]**
+### Custom Helm chart per environment **(PREMIUM)**
 
 You can specify the use of a custom Helm chart per environment by scoping the environment variable
 to the desired environment. See [Limiting environment scopes of variables](../../ci/variables/README.md#limiting-environment-scopes-of-environment-variables-premium).
@@ -903,7 +903,7 @@ If `STAGING_ENABLED` is defined in your project (e.g., set `STAGING_ENABLED` to
 to a `staging` environment, and a  `production_manual` job will be created for
 you when you're ready to manually deploy to production.
 
-#### Deploy policy for canary environments **[PREMIUM]**
+#### Deploy policy for canary environments **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ci-yml/merge_requests/171)
 in GitLab 11.0.
@@ -918,7 +918,7 @@ If `CANARY_ENABLED` is defined in your project (e.g., set `CANARY_ENABLED` to
 - `production_manual` which is to be used by you when you're ready to manually
   deploy to production.
 
-#### Incremental rollout to production **[PREMIUM]**
+#### Incremental rollout to production **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/5415) in GitLab 10.8.
 
@@ -976,7 +976,7 @@ Before GitLab 11.4 this feature was enabled by the presence of the
 `INCREMENTAL_ROLLOUT_ENABLED` environment variable.
 This configuration is deprecated and will be removed in the future.
 
-#### Timed incremental rollout to production **[PREMIUM]**
+#### Timed incremental rollout to production **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/7545) in GitLab 11.4.
 
diff --git a/doc/topics/autodevops/quick_start_guide.md b/doc/topics/autodevops/quick_start_guide.md
index 6717e95266e..c1771a57da0 100644
--- a/doc/topics/autodevops/quick_start_guide.md
+++ b/doc/topics/autodevops/quick_start_guide.md
@@ -159,15 +159,15 @@ In the **test** stage, GitLab runs various checks on the application:
 - The `test` job runs unit and integration tests by detecting the language and
   framework ([Auto Test](index.md#auto-test))
 - The `code_quality` job checks the code quality and is allowed to fail
-  ([Auto Code Quality](index.md#auto-code-quality-starter)) **[STARTER]**
+  ([Auto Code Quality](index.md#auto-code-quality-starter)) **(STARTER)**
 - The `container_scanning` job checks the Docker container if it has any
   vulnerabilities and is allowed to fail ([Auto Container Scanning](index.md#auto-container-scanning-ultimate))
 - The `dependency_scanning` job checks if the application has any dependencies
-  susceptible to vulnerabilities and is allowed to fail ([Auto Dependency Scanning](index.md#auto-dependency-scanning-ultimate)) **[ULTIMATE]**
+  susceptible to vulnerabilities and is allowed to fail ([Auto Dependency Scanning](index.md#auto-dependency-scanning-ultimate)) **(ULTIMATE)**
 - The `sast` job runs static analysis on the current code to check for potential
-  security issues and is allowed to fail([Auto SAST](index.md#auto-sast-ultimate)) **[ULTIMATE]**
+  security issues and is allowed to fail([Auto SAST](index.md#auto-sast-ultimate)) **(ULTIMATE)**
 - The `license_management` job searches the application's dependencies to determine each of their
-  licenses and is allowed to fail ([Auto License Management](index.md#auto-license-management-ultimate)) **[ULTIMATE]**
+  licenses and is allowed to fail ([Auto License Management](index.md#auto-license-management-ultimate)) **(ULTIMATE)**
 
 NOTE: **Note:**
 As you might have noticed, all jobs except `test` are allowed to fail in the
@@ -178,7 +178,7 @@ deploys the application in Kubernetes ([Auto Deploy](index.md#auto-deploy)).
 
 Lastly, in the **performance** stage, some performance tests will run
 on the deployed application
-([Auto Browser Performance Testing](index.md#auto-browser-performance-testing-premium)). **[PREMIUM]**
+([Auto Browser Performance Testing](index.md#auto-browser-performance-testing-premium)). **(PREMIUM)**
 
 ---
 
@@ -285,8 +285,8 @@ all within GitLab. Despite its automatic nature, Auto DevOps can also be configu
 and customized to fit your workflow. Here are some helpful resources for further reading:
 
 1. [Auto DevOps](index.md)
-1. [Multiple Kubernetes clusters](index.md#using-multiple-kubernetes-clusters-premium) **[PREMIUM]**
-1. [Incremental rollout to production](index.md#incremental-rollout-to-production-premium) **[PREMIUM]**
+1. [Multiple Kubernetes clusters](index.md#using-multiple-kubernetes-clusters-premium) **(PREMIUM)**
+1. [Incremental rollout to production](index.md#incremental-rollout-to-production-premium) **(PREMIUM)**
 1. [Disable jobs you don't need with environment variables](index.md#environment-variables)
 1. [Use a static IP for your cluster](../../user/project/clusters/index.md#using-a-static-ip)
 1. [Use your own buildpacks to build your application](index.md#custom-buildpacks)
diff --git a/doc/update/patch_versions.md b/doc/update/patch_versions.md
index 4300d6d56c7..0506d992d4b 100644
--- a/doc/update/patch_versions.md
+++ b/doc/update/patch_versions.md
@@ -100,7 +100,7 @@ sudo -u git -H git checkout v$(</home/git/gitlab/GITLAB_PAGES_VERSION)
 sudo -u git -H make
 ```
 
-### 8. Install/Update `gitlab-elasticsearch-indexer` (optional) **[STARTER ONLY]**
+### 8. Install/Update `gitlab-elasticsearch-indexer` (optional) **(STARTER ONLY)**
 
 If you're interested in using GitLab's new [elasticsearch repository indexer](../integration/elasticsearch.md#elasticsearch-repository-indexer-beta) (currently in beta)
 please follow the instructions on the document linked above and enable the
diff --git a/doc/update/upgrading_from_ce_to_ee.md b/doc/update/upgrading_from_ce_to_ee.md
index 7ae716d2cb3..bea5bcd9dd7 100644
--- a/doc/update/upgrading_from_ce_to_ee.md
+++ b/doc/update/upgrading_from_ce_to_ee.md
@@ -72,7 +72,7 @@ sudo -u git -H bundle exec rake db:migrate RAILS_ENV=production
 sudo -u git -H bundle exec rake assets:clean assets:precompile cache:clear RAILS_ENV=production
 ```
 
-### 4. Install `gitlab-elasticsearch-indexer` (optional) **[STARTER ONLY]**
+### 4. Install `gitlab-elasticsearch-indexer` (optional) **(STARTER ONLY)**
 
 If you're interested in using GitLab's new [elasticsearch repository
 indexer](../integration/elasticsearch.md) (currently in beta) please follow the instructions on the
diff --git a/doc/user/admin_area/custom_project_templates.md b/doc/user/admin_area/custom_project_templates.md
index e34ba045c54..db853a58b91 100644
--- a/doc/user/admin_area/custom_project_templates.md
+++ b/doc/user/admin_area/custom_project_templates.md
@@ -1,4 +1,4 @@
-# Custom instance-level project templates **[PREMIUM ONLY]**
+# Custom instance-level project templates **(PREMIUM ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/6860) in [GitLab Premium](https://about.gitlab.com/pricing) 11.2.
 
diff --git a/doc/user/admin_area/geo_nodes.md b/doc/user/admin_area/geo_nodes.md
index f535e7790bc..9e7057f93d4 100644
--- a/doc/user/admin_area/geo_nodes.md
+++ b/doc/user/admin_area/geo_nodes.md
@@ -2,7 +2,7 @@
 type: howto
 ---
 
-# Geo nodes admin area **[PREMIUM ONLY]**
+# Geo nodes admin area **(PREMIUM ONLY)**
 
 You can configure various settings for GitLab Geo nodes. For more information, see
 [Geo documentation](../../administration/geo/replication/index.md).
diff --git a/doc/user/admin_area/index.md b/doc/user/admin_area/index.md
index d2947ae3371..f5e6bff67c5 100644
--- a/doc/user/admin_area/index.md
+++ b/doc/user/admin_area/index.md
@@ -2,7 +2,7 @@
 type: reference
 ---
 
-# GitLab Admin Area **[CORE ONLY]**
+# GitLab Admin Area **(CORE ONLY)**
 
 The Admin Area provides a web UI for administering some features of GitLab self-managed instances.
 
@@ -26,9 +26,9 @@ The Admin Area is made up of the following sections:
 | System Hooks                  | Configure [system hooks](../../system_hooks/system_hooks.md) for many events.                                                                                                                                                                                                            |
 | Applications                  | Create system [OAuth applications](../../integration/oauth_provider.md) for integrations with other services.                                                                                                                                                                            |
 | Abuse Reports                 | Manage [abuse reports](abuse_reports.md) submitted by your users.                                                                                                                                                                                                                        |
-| License **[STARTER ONLY]**    | Upload, display, and remove [licenses](license.md).                                                                                                                                                                                                                                      |
-| Push Rules **[STARTER]**      | Configure pre-defined git [push rules](../../push_rules/push_rules.md) for projects.                                                                                                                                                                                                     |
-| Geo **[PREMIUM ONLY]**        | Configure and maintain [Geo nodes](geo_nodes.md).                                                                                                                                                                                                                                        |
+| License **(STARTER ONLY)**    | Upload, display, and remove [licenses](license.md).                                                                                                                                                                                                                                      |
+| Push Rules **(STARTER)**      | Configure pre-defined git [push rules](../../push_rules/push_rules.md) for projects.                                                                                                                                                                                                     |
+| Geo **(PREMIUM ONLY)**        | Configure and maintain [Geo nodes](geo_nodes.md).                                                                                                                                                                                                                                        |
 | Deploy Keys                   | Create instance-wide [SSH deploy keys](../../ssh/README.md#deploy-keys).                                                                                                                                                                                                                 |
 | Service Templates             | Create [service templates](../project/integrations/services_templates.md) for projects.                                                                                                                                                                                                  |
 | Labels                        | Create and maintain [labels](labels.md) for your GitLab instance.                                                                                                                                                                                                                        |
@@ -289,6 +289,6 @@ The content of each log file is listed in chronological order. To minimize perfo
 
 The **Requests Profiles** page contains the token required for profiling. For more details, see [Request Profiling](../../administration/monitoring/performance/request_profiling.md).
 
-### Audit Log **[PREMIUM ONLY]**
+### Audit Log **(PREMIUM ONLY)**
 
 The **Audit Log** page lists changes made within the GitLab server. With this information you can control, analyze, and track every change.
diff --git a/doc/user/admin_area/labels.md b/doc/user/admin_area/labels.md
index eba27548f86..1d15be89bd5 100644
--- a/doc/user/admin_area/labels.md
+++ b/doc/user/admin_area/labels.md
@@ -2,7 +2,7 @@
 type: reference
 ---
 
-# Labels administration **[CORE ONLY]**
+# Labels administration **(CORE ONLY)**
 
 In the Admin Area, you can manage labels for the GitLab instance. For more details, see [Labels](../project/labels.md).
 
diff --git a/doc/user/admin_area/license.md b/doc/user/admin_area/license.md
index 8ddb9c3d707..bbd04146eb2 100644
--- a/doc/user/admin_area/license.md
+++ b/doc/user/admin_area/license.md
@@ -2,7 +2,7 @@
 type: howto
 ---
 
-# Activate all GitLab Enterprise Edition functionality with a license **[STARTER ONLY]**
+# Activate all GitLab Enterprise Edition functionality with a license **(STARTER ONLY)**
 
 To activate all GitLab Enterprise Edition (EE) functionality, you need to upload
 a license. Once you've received your license from GitLab Inc., you can upload it
diff --git a/doc/user/admin_area/settings/account_and_limit_settings.md b/doc/user/admin_area/settings/account_and_limit_settings.md
index 756a07e0b80..9968b7349dc 100644
--- a/doc/user/admin_area/settings/account_and_limit_settings.md
+++ b/doc/user/admin_area/settings/account_and_limit_settings.md
@@ -4,7 +4,7 @@ type: reference
 
 # Account and limit settings
 
-## Repository size limit **[STARTER]**
+## Repository size limit **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/740) in [GitLab Enterprise Edition 8.12](https://about.gitlab.com/2016/09/22/gitlab-8-12-released/#limit-project-size-ee).
 > Available in [GitLab Starter](https://about.gitlab.com/pricing/).
diff --git a/doc/user/admin_area/settings/continuous_integration.md b/doc/user/admin_area/settings/continuous_integration.md
index 84596ff6a2c..ebbb2472752 100644
--- a/doc/user/admin_area/settings/continuous_integration.md
+++ b/doc/user/admin_area/settings/continuous_integration.md
@@ -2,14 +2,14 @@
 type: reference
 ---
 
-# Continuous Integration and Deployment Admin settings **[CORE ONLY]**
+# Continuous Integration and Deployment Admin settings **(CORE ONLY)**
 
 In this area, you will find settings for Auto DevOps, Runners and job artifacts.
 You can find it in the admin area, under **Settings > Continuous Integration and Deployment**.
 
 ![Admin area settings button](../img/admin_area_settings_button.png)
 
-## Auto DevOps **[CORE ONLY]**
+## Auto DevOps **(CORE ONLY)**
 
 To enable (or disable) [Auto DevOps](../../../topics/autodevops/index.md)
 for all projects:
@@ -26,7 +26,7 @@ From now on, every existing project and newly created ones that don't have a
 If you want to disable it for a specific project, you can do so in
 [its settings](../../../topics/autodevops/index.md#enablingdisabling-auto-devops).
 
-## Maximum artifacts size **[CORE ONLY]**
+## Maximum artifacts size **(CORE ONLY)**
 
 The maximum size of the [job artifacts](../../../administration/job_artifacts.md)
 can be set in the Admin area of your GitLab instance. The value is in *MB* and
@@ -38,7 +38,7 @@ To change it:
 1. Change the value of maximum artifacts size (in MB).
 1. Hit **Save changes** for the changes to take effect.
 
-## Default artifacts expiration **[CORE ONLY]**
+## Default artifacts expiration **(CORE ONLY)**
 
 The default expiration time of the [job artifacts](../../../administration/job_artifacts.md)
 can be set in the Admin area of your GitLab instance. The syntax of duration is
@@ -54,7 +54,7 @@ This setting is set per job and can be overridden in
 [`.gitlab-ci.yml`](../../../ci/yaml/README.md#artifactsexpire_in).
 To disable the expiration, set it to `0`. The default unit is in seconds.
 
-## Shared Runners pipeline minutes quota **[STARTER ONLY]**
+## Shared Runners pipeline minutes quota **(STARTER ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/1078)
 in GitLab Starter 8.16.
@@ -137,7 +137,7 @@ includes a link to [purchase more minutes](https://customers.gitlab.com/plans).
 If you are not the owner of the group, you will need to contact them to let them know they need to
 [purchase more minutes](https://customers.gitlab.com/plans).
 
-## Archive jobs **[CORE ONLY]**
+## Archive jobs **(CORE ONLY)**
 
 Archiving jobs is useful for reducing the CI/CD footprint on the system by
 removing some of the capabilities of the jobs (metadata needed to run the job),
diff --git a/doc/user/admin_area/settings/email.md b/doc/user/admin_area/settings/email.md
index 9555a695b13..1f07a4dfdc6 100644
--- a/doc/user/admin_area/settings/email.md
+++ b/doc/user/admin_area/settings/email.md
@@ -10,7 +10,7 @@ You can customize some of the content in emails sent from your GitLab instance.
 
 The logo in the header of some emails can be customized, see the [logo customization section](../../../customization/branded_page_and_email_header.md).
 
-## Custom additional text **[PREMIUM ONLY]**
+## Custom additional text **(PREMIUM ONLY)**
 
 > [Introduced][ee-5031] in [GitLab Premium][eep] 10.7.
 
diff --git a/doc/user/admin_area/settings/external_authorization.md b/doc/user/admin_area/settings/external_authorization.md
index c1aa04f7bc2..e920628d2c0 100644
--- a/doc/user/admin_area/settings/external_authorization.md
+++ b/doc/user/admin_area/settings/external_authorization.md
@@ -2,7 +2,7 @@
 type: reference
 ---
 
-# External authorization control **[CORE ONLY]**
+# External authorization control **(CORE ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/4216) in
 > [GitLab Premium](https://about.gitlab.com/pricing) 10.6.
diff --git a/doc/user/admin_area/settings/index.md b/doc/user/admin_area/settings/index.md
index eed087ae52b..5427d04cd7d 100644
--- a/doc/user/admin_area/settings/index.md
+++ b/doc/user/admin_area/settings/index.md
@@ -2,7 +2,7 @@
 type: index
 ---
 
-# Admin Area settings **[CORE ONLY]**
+# Admin Area settings **(CORE ONLY)**
 
 In the Admin Area **Settings** page, you can find various options for your GitLab
 instance like sign-up restrictions, account limits and quota, metrics, etc.
@@ -10,7 +10,7 @@ instance like sign-up restrictions, account limits and quota, metrics, etc.
 Navigate to it by going to **Admin Area > Settings**. Some of the settings
 include:
 
-- [Account and limit settings](account_and_limit_settings.md) **[STARTER]**
+- [Account and limit settings](account_and_limit_settings.md) **(STARTER)**
 - [Continuous Integration and Deployment](continuous_integration.md)
 - [Email](email.md)
 - [Sign up restrictions](sign_up_restrictions.md)
@@ -18,7 +18,7 @@ include:
 - [Third party offers](third_party_offers.md)
 - [Usage statistics](usage_statistics.md)
 - [Visibility and access controls](visibility_and_access_controls.md)
-- [Custom templates repository](instance_template_repository.md) **[PREMIUM]**
+- [Custom templates repository](instance_template_repository.md) **(PREMIUM)**
 
 NOTE: **Note:**
 You can change the [first day of the week](../../profile/preferences.md) for the entire GitLab instance
diff --git a/doc/user/admin_area/settings/instance_template_repository.md b/doc/user/admin_area/settings/instance_template_repository.md
index 91286a67c31..2d861a0e15b 100644
--- a/doc/user/admin_area/settings/instance_template_repository.md
+++ b/doc/user/admin_area/settings/instance_template_repository.md
@@ -2,7 +2,7 @@
 type: reference
 ---
 
-# Instance template repository **[PREMIUM ONLY]**
+# Instance template repository **(PREMIUM ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/5986) in
 > [GitLab Premium](https://about.gitlab.com/pricing) 11.3.
diff --git a/doc/user/admin_area/settings/usage_statistics.md b/doc/user/admin_area/settings/usage_statistics.md
index 652d6ad2cdd..f698e0a1608 100644
--- a/doc/user/admin_area/settings/usage_statistics.md
+++ b/doc/user/admin_area/settings/usage_statistics.md
@@ -10,7 +10,7 @@ to perform various actions.
 All statistics are opt-out, you can enable/disable them from the admin panel
 under **Admin area > Settings > Metrics and profiling > Usage statistics**.
 
-## Version check **[CORE ONLY]**
+## Version check **(CORE ONLY)**
 
 If enabled, version check will inform you if a new version is available and the
 importance of it through a status. This is shown on the help page (i.e. `/help`)
@@ -33,7 +33,7 @@ secure.
 If you disable version check, this information will not be collected.  Enable or
 disable the version check at **Admin area > Settings > Usage statistics**.
 
-## Usage ping **[CORE ONLY]**
+## Usage ping **(CORE ONLY)**
 
 > [Introduced][ee-557] in GitLab Enterprise Edition 8.10. More statistics
 [were added][ee-735] in GitLab Enterprise Edition
@@ -78,7 +78,7 @@ production: &base
     usage_ping_enabled: false
 ```
 
-## Instance statistics visibility **[CORE ONLY]**
+## Instance statistics visibility **(CORE ONLY)**
 
 Once usage ping is enabled, GitLab will gather data from other instances and
 will be able to show [usage statistics](../../instance_statistics/index.md)
diff --git a/doc/user/admin_area/settings/visibility_and_access_controls.md b/doc/user/admin_area/settings/visibility_and_access_controls.md
index 63879935fd8..bf59f49b993 100644
--- a/doc/user/admin_area/settings/visibility_and_access_controls.md
+++ b/doc/user/admin_area/settings/visibility_and_access_controls.md
@@ -12,7 +12,7 @@ GitLab allows administrators to:
 - Enable or disable repository mirroring.
 - Prevent non-administrators from deleting projects
   ([introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/5615) in GitLab 12.0).
-  **[PREMIUM ONLY]**
+  **(PREMIUM ONLY)**
 
 To access the visibility and access control options:
 
diff --git a/doc/user/application_security/container_scanning/index.md b/doc/user/application_security/container_scanning/index.md
index 9dfbe326f1d..696446599c8 100644
--- a/doc/user/application_security/container_scanning/index.md
+++ b/doc/user/application_security/container_scanning/index.md
@@ -1,4 +1,4 @@
-# Container Scanning **[ULTIMATE]**
+# Container Scanning **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/3672)
 in [GitLab Ultimate](https://about.gitlab.com/pricing/) 10.4.
diff --git a/doc/user/application_security/dast/index.md b/doc/user/application_security/dast/index.md
index 2283efe3a44..936703cce32 100644
--- a/doc/user/application_security/dast/index.md
+++ b/doc/user/application_security/dast/index.md
@@ -1,4 +1,4 @@
-# Dynamic Application Security Testing (DAST) **[ULTIMATE]**
+# Dynamic Application Security Testing (DAST) **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/4348)
 in [GitLab Ultimate](https://about.gitlab.com/pricing/) 10.4.
diff --git a/doc/user/application_security/dependency_scanning/analyzers.md b/doc/user/application_security/dependency_scanning/analyzers.md
index 937ded287e5..3b4b341739b 100644
--- a/doc/user/application_security/dependency_scanning/analyzers.md
+++ b/doc/user/application_security/dependency_scanning/analyzers.md
@@ -1,4 +1,4 @@
-# Dependency Scanning Analyzers **[ULTIMATE]**
+# Dependency Scanning Analyzers **(ULTIMATE)**
 
 Dependency Scanning relies on underlying third party tools that are wrapped into
 what we call "Analyzers". An analyzer is a
diff --git a/doc/user/application_security/dependency_scanning/index.md b/doc/user/application_security/dependency_scanning/index.md
index 9145e034dcb..2fe8a6f9029 100644
--- a/doc/user/application_security/dependency_scanning/index.md
+++ b/doc/user/application_security/dependency_scanning/index.md
@@ -1,4 +1,4 @@
-# Dependency Scanning **[ULTIMATE]**
+# Dependency Scanning **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/5105)
 in [GitLab Ultimate](https://about.gitlab.com/pricing/) 10.7.
diff --git a/doc/user/application_security/index.md b/doc/user/application_security/index.md
index 69fa1ec5da6..91e79f6c23b 100644
--- a/doc/user/application_security/index.md
+++ b/doc/user/application_security/index.md
@@ -1,4 +1,4 @@
-# GitLab Secure **[ULTIMATE]**
+# GitLab Secure **(ULTIMATE)**
 
 Check your application for security vulnerabilities that may lead to unauthorized access,
 data leaks, and denial of services. GitLab will perform static and dynamic tests on the
@@ -12,12 +12,12 @@ GitLab can scan and report any vulnerabilities found in your project.
 
 | Secure scanning tool                                                         | Description                                                            |
 |:-----------------------------------------------------------------------------|:-----------------------------------------------------------------------|
-| [Container Scanning](container_scanning/index.md) **[ULTIMATE]**             | Scan Docker containers for known vulnerabilities.                      |
-| [Dependency Scanning](dependency_scanning/index.md) **[ULTIMATE]**           | Analyze your dependencies for known vulnerabilities.                   |
-| [Dynamic Application Security Testing (DAST)](dast/index.md) **[ULTIMATE]**  | Analyze running web applications for known vulnerabilities.            |
-| [License Management](license_management/index.md) **[ULTIMATE]**             | Search your project's dependencies for their licenses.                 |
-| [Security Dashboard](security_dashboard/index.md) **[ULTIMATE]**             | View vulnerabilities in all your projects and groups.                  |
-| [Static Application Security Testing (SAST)](sast/index.md) **[ULTIMATE]**   | Analyze source code for known vulnerabilities.                         |
+| [Container Scanning](container_scanning/index.md) **(ULTIMATE)**             | Scan Docker containers for known vulnerabilities.                      |
+| [Dependency Scanning](dependency_scanning/index.md) **(ULTIMATE)**           | Analyze your dependencies for known vulnerabilities.                   |
+| [Dynamic Application Security Testing (DAST)](dast/index.md) **(ULTIMATE)**  | Analyze running web applications for known vulnerabilities.            |
+| [License Management](license_management/index.md) **(ULTIMATE)**             | Search your project's dependencies for their licenses.                 |
+| [Security Dashboard](security_dashboard/index.md) **(ULTIMATE)**             | View vulnerabilities in all your projects and groups.                  |
+| [Static Application Security Testing (SAST)](sast/index.md) **(ULTIMATE)**   | Analyze source code for known vulnerabilities.                         |
 
 ## Maintenance and update of the vulnerabilities database
 
diff --git a/doc/user/application_security/license_management/index.md b/doc/user/application_security/license_management/index.md
index de131ba1f23..8eb231f8359 100644
--- a/doc/user/application_security/license_management/index.md
+++ b/doc/user/application_security/license_management/index.md
@@ -1,4 +1,4 @@
-# License Management **[ULTIMATE]**
+# License Management **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/5483)
 in [GitLab Ultimate](https://about.gitlab.com/pricing/) 11.0.
diff --git a/doc/user/application_security/sast/index.md b/doc/user/application_security/sast/index.md
index 9074ac3f4a1..84b45cbe6e6 100644
--- a/doc/user/application_security/sast/index.md
+++ b/doc/user/application_security/sast/index.md
@@ -1,4 +1,4 @@
-# Static Application Security Testing (SAST) **[ULTIMATE]**
+# Static Application Security Testing (SAST) **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/3775)
 in [GitLab Ultimate](https://about.gitlab.com/pricing/) 10.3.
diff --git a/doc/user/application_security/security_dashboard/index.md b/doc/user/application_security/security_dashboard/index.md
index 19eeb06a259..3b01fe66e03 100644
--- a/doc/user/application_security/security_dashboard/index.md
+++ b/doc/user/application_security/security_dashboard/index.md
@@ -1,4 +1,4 @@
-# GitLab Security Dashboard **[ULTIMATE]**
+# GitLab Security Dashboard **(ULTIMATE)**
 
 The Security Dashboard is a good place to get an overview of all the security
 vulnerabilities in your groups and projects.
diff --git a/doc/user/discussions/index.md b/doc/user/discussions/index.md
index 20eabdada79..f2156720af7 100644
--- a/doc/user/discussions/index.md
+++ b/doc/user/discussions/index.md
@@ -5,7 +5,7 @@ The ability to contribute conversationally is offered throughout GitLab.
 You can leave a comment in the following places:
 
 - issues
-- epics **[ULTIMATE]**
+- epics **(ULTIMATE)**
 - merge requests
 - snippets
 - commits
@@ -282,7 +282,7 @@ edit existing comments. Non-team members are restricted from adding or editing c
 
 Additionally, locked issues and merge requests can not be reopened.
 
-## Merge Request Reviews **[PREMIUM]**
+## Merge Request Reviews **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/4213) in GitLab 11.4.
 
diff --git a/doc/user/group/clusters/index.md b/doc/user/group/clusters/index.md
index 8d4ffd93f59..0dffc216f8e 100644
--- a/doc/user/group/clusters/index.md
+++ b/doc/user/group/clusters/index.md
@@ -42,7 +42,7 @@ to the group containing the project if the project's cluster is available and no
 In the case of sub-groups, GitLab will use the cluster of the closest ancestor group
 to the project, provided the cluster is not disabled.
 
-## Multiple Kubernetes clusters **[PREMIUM]**
+## Multiple Kubernetes clusters **(PREMIUM)**
 
 With GitLab Premium, you can associate more than one Kubernetes clusters to your
 group. That way you can have different clusters for different environments,
@@ -82,7 +82,7 @@ the [Auto DevOps](../../../topics/autodevops/index.md) stages.
 
 The domain should have a wildcard DNS configured to the Ingress IP address.
 
-## Environment scopes **[PREMIUM]**
+## Environment scopes **(PREMIUM)**
 
 When adding more than one Kubernetes cluster to your project, you need to differentiate
 them with an environment scope. The environment scope associates clusters with
diff --git a/doc/user/group/contribution_analytics/index.md b/doc/user/group/contribution_analytics/index.md
index a555b7723df..2d37fc375db 100644
--- a/doc/user/group/contribution_analytics/index.md
+++ b/doc/user/group/contribution_analytics/index.md
@@ -2,7 +2,7 @@
 type: reference
 ---
 
-# Contribution Analytics **[STARTER]**
+# Contribution Analytics **(STARTER)**
 
 > Introduced in [GitLab Starter](https://about.gitlab.com/pricing/) 8.3.
 
diff --git a/doc/user/group/custom_project_templates.md b/doc/user/group/custom_project_templates.md
index aa088d2fcdb..e74644710a5 100644
--- a/doc/user/group/custom_project_templates.md
+++ b/doc/user/group/custom_project_templates.md
@@ -2,7 +2,7 @@
 type: reference
 ---
 
-# Custom group-level project templates **[PREMIUM]**
+# Custom group-level project templates **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/6861) in [GitLab Premium](https://about.gitlab.com/pricing) 11.6.
 
diff --git a/doc/user/group/dependency_proxy/index.md b/doc/user/group/dependency_proxy/index.md
index 4fc2d8e9509..771468fbba8 100644
--- a/doc/user/group/dependency_proxy/index.md
+++ b/doc/user/group/dependency_proxy/index.md
@@ -1,4 +1,4 @@
-# Dependency Proxy **[PREMIUM]**
+# Dependency Proxy **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/7934) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.11.
 
diff --git a/doc/user/group/epics/index.md b/doc/user/group/epics/index.md
index f53c1dd95d7..601ffd4947b 100644
--- a/doc/user/group/epics/index.md
+++ b/doc/user/group/epics/index.md
@@ -2,7 +2,7 @@
 type: reference, howto
 ---
 
-# Epics **[ULTIMATE]**
+# Epics **(ULTIMATE)**
 
 > Introduced in [GitLab Ultimate][ee] 10.2.
 
diff --git a/doc/user/group/index.md b/doc/user/group/index.md
index 7240b8e118b..db348c678eb 100644
--- a/doc/user/group/index.md
+++ b/doc/user/group/index.md
@@ -200,7 +200,7 @@ Alternatively, you can [lock the sharing with group feature](#share-with-group-l
 In GitLab Enterprise Edition, it is possible to manage GitLab group memberships using LDAP groups.
 See [the GitLab Enterprise Edition documentation](../../integration/ldap.md) for more information.
 
-## Epics **[ULTIMATE]**
+## Epics **(ULTIMATE)**
 
 > Introduced in [GitLab Ultimate][ee] 10.2.
 
@@ -210,13 +210,13 @@ milestones.
 
 [Learn more about Epics.](epics/index.md)
 
-## Group Security Dashboard **[ULTIMATE]**
+## Group Security Dashboard **(ULTIMATE)**
 
 Get an overview of the vulnerabilities of all the projects in a group and its subgroups.
 
 [Learn more about the Group Security Dashboard.](security_dashboard/index.md)
 
-## Insights **[ULTIMATE]**
+## Insights **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/725) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 12.0.
 
@@ -307,7 +307,7 @@ To enable this feature, navigate to the group settings page. Select
 
 ![Checkbox for share with group lock](img/share_with_group_lock.png)
 
-#### Member Lock **[STARTER]**
+#### Member Lock **(STARTER)**
 
 Member lock lets a group owner prevent any new project membership to all of the
 projects within a group, allowing tighter control over project membership.
@@ -327,7 +327,7 @@ This will disable the option for all users who previously had permissions to
 operate project memberships, so no new users can be added. Furthermore, any
 request to add a new user to a project through API will not be possible.
 
-#### IP access restriction **[ULTIMATE]**
+#### IP access restriction **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/1985) in
 [GitLab Ultimate](https://about.gitlab.com/pricing/) 12.0.
@@ -346,7 +346,7 @@ Restriction currently applies to UI, API access is not restricted.
 To avoid accidental lock-out, admins and group owners are are able to access
 the group regardless of the IP restriction.
 
-#### Group file templates **[PREMIUM]**
+#### Group file templates **(PREMIUM)**
 
 Group file templates allow you to share a set of templates for common file
 types with every project in a group. It is analogous to the
@@ -370,7 +370,7 @@ To enable this feature, navigate to the group settings page, expand the
 
 ![Group file template settings](img/group_file_template_settings.png)
 
-#### Group-level project templates **[PREMIUM]**
+#### Group-level project templates **(PREMIUM)**
 
 Define project templates at a group level by setting a group as the template source.
 [Learn more about group-level project templates](custom_project_templates.md).
@@ -382,10 +382,10 @@ Define project templates at a group level by setting a group as the template sou
 - **Webhooks**: Configure [webhooks](../project/integrations/webhooks.md) for your group.
 - **Kubernetes cluster integration**: Connect your GitLab group with [Kubernetes clusters](clusters/index.md).
 - **Audit Events**: View [Audit Events](../../administration/audit_events.md)
-  for the group. **[STARTER ONLY]**
+  for the group. **(STARTER ONLY)**
 - **Pipelines quota**: Keep track of the [pipeline quota](../admin_area/settings/continuous_integration.md) for the group.
 
-#### Storage usage quota **[STARTER]**
+#### Storage usage quota **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/13294) in [GitLab Starter](https://about.gitlab.com/pricing/) 12.0.
 
@@ -393,17 +393,17 @@ A group owner can check the aggregated storage usage for all the project in a gr
 
 ![Group storage usage quota](img/group_storage_usage_quota.png)
 
-## User contribution analysis **[STARTER]**
+## User contribution analysis **(STARTER)**
 
 With [GitLab Contribution Analytics](contribution_analytics/index.md),
 you have an overview of the contributions (pushes, merge requests,
 and issues) performed by your group members.
 
-## Issues analytics **[PREMIUM]**
+## Issues analytics **(PREMIUM)**
 
 With [GitLab Issues Analytics](issues_analytics/index.md), you can see a bar chart of the number of issues created each month in your groups.
 
-## Dependency Proxy **[PREMIUM]**
+## Dependency Proxy **(PREMIUM)**
 
 Use GitLab as a [dependency proxy](dependency_proxy/index.md) for upstream Docker images.
 
diff --git a/doc/user/group/insights/index.md b/doc/user/group/insights/index.md
index e6ba47939b3..f0e7f7239c1 100644
--- a/doc/user/group/insights/index.md
+++ b/doc/user/group/insights/index.md
@@ -2,7 +2,7 @@
 type: reference, howto
 ---
 
-# Insights **[ULTIMATE]**
+# Insights **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/725) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 12.0.
 
diff --git a/doc/user/group/issues_analytics/index.md b/doc/user/group/issues_analytics/index.md
index 46d5c1e2e09..dc4b057789f 100644
--- a/doc/user/group/issues_analytics/index.md
+++ b/doc/user/group/issues_analytics/index.md
@@ -2,7 +2,7 @@
 type: reference
 ---
 
-# Issues Analytics **[PREMIUM]**
+# Issues Analytics **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/7478) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.5.
 
diff --git a/doc/user/group/roadmap/index.md b/doc/user/group/roadmap/index.md
index 683c715c8d5..672149f8217 100644
--- a/doc/user/group/roadmap/index.md
+++ b/doc/user/group/roadmap/index.md
@@ -2,7 +2,7 @@
 type: reference
 ---
 
-# Roadmap **[ULTIMATE]**
+# Roadmap **(ULTIMATE)**
 
 > Introduced in [GitLab Ultimate](https://about.gitlab.com/pricing) 10.5.
 
diff --git a/doc/user/group/saml_sso/index.md b/doc/user/group/saml_sso/index.md
index 26893f7e31e..54923ab69ff 100644
--- a/doc/user/group/saml_sso/index.md
+++ b/doc/user/group/saml_sso/index.md
@@ -2,7 +2,7 @@
 type: reference, howto
 ---
 
-# SAML SSO for GitLab.com Groups **[SILVER ONLY]**
+# SAML SSO for GitLab.com Groups **(SILVER ONLY)**
 
 > Introduced in [GitLab.com Silver](https://about.gitlab.com/pricing/) 11.0.
 
diff --git a/doc/user/group/saml_sso/scim_setup.md b/doc/user/group/saml_sso/scim_setup.md
index 5aef463d782..2d408766db8 100644
--- a/doc/user/group/saml_sso/scim_setup.md
+++ b/doc/user/group/saml_sso/scim_setup.md
@@ -2,7 +2,7 @@
 type: howto, reference
 ---
 
-# SCIM provisioning using SAML SSO for Groups **[SILVER ONLY]**
+# SCIM provisioning using SAML SSO for Groups **(SILVER ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/9388) in [GitLab.com Silver](https://about.gitlab.com/pricing/) 11.10.
 
diff --git a/doc/user/index.md b/doc/user/index.md
index 899026a801f..501d74c76d1 100644
--- a/doc/user/index.md
+++ b/doc/user/index.md
@@ -173,7 +173,7 @@ Learn what is [Git](../topics/git/index.md) and its best practices.
 
 See [various statistics](instance_statistics/index.md) of your GitLab instance.
 
-## Operations Dashboard **[PREMIUM]**
+## Operations Dashboard **(PREMIUM)**
 
 See [Operations Dashboard](operations_dashboard/index.md) for a summary of each
 project's operational health.
diff --git a/doc/user/markdown.md b/doc/user/markdown.md
index eaae9964367..83629fc2e4b 100644
--- a/doc/user/markdown.md
+++ b/doc/user/markdown.md
@@ -25,7 +25,7 @@ You can use GFM in the following areas:
 - Snippets (the snippet must be named with a `.md` extension)
 - Wiki pages
 - Markdown documents inside repositories
-- Epics **[ULTIMATE]**
+- Epics **(ULTIMATE)**
 
 You can also use other rich text files in GitLab. You might have to install a dependency
 to do so. Please see the [`gitlab-markup` gem project](https://gitlab.com/gitlab-org/gitlab-markup)
@@ -368,7 +368,7 @@ GFM will recognize the following:
 | issue                           | ``#123``                   | `namespace/project#123`                 | `project#123`                  |
 | merge request                   | `!123`                     | `namespace/project!123`                 | `project!123`                  |
 | snippet                         | `$123`                     | `namespace/project$123`                 | `project$123`                  |
-| epic **[ULTIMATE]**             | `&123`                     | `group1/subgroup&123`                   |                                |
+| epic **(ULTIMATE)**             | `&123`                     | `group1/subgroup&123`                   |                                |
 | label by ID                     | `~123`                     | `namespace/project~123`                 | `project~123`                  |
 | one-word label by name          | `~bug`                     | `namespace/project~bug`                 | `project~bug`                  |
 | multi-word label by name        | `~"feature request"`       | `namespace/project~"feature request"`   | `project~"feature request"`    |
diff --git a/doc/user/operations_dashboard/index.md b/doc/user/operations_dashboard/index.md
index 54bf3ff8a40..8c4d387190a 100644
--- a/doc/user/operations_dashboard/index.md
+++ b/doc/user/operations_dashboard/index.md
@@ -1,4 +1,4 @@
-# Operations Dashboard **[PREMIUM]**
+# Operations Dashboard **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/5781) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 11.5. [Moved](https://gitlab.com/gitlab-org/gitlab-ee/issues/9218) to [GitLab Premium](https://about.gitlab.com/pricing/) in 11.10.
 
diff --git a/doc/user/permissions.md b/doc/user/permissions.md
index 33fff0fed74..1b279173d1c 100644
--- a/doc/user/permissions.md
+++ b/doc/user/permissions.md
@@ -43,10 +43,10 @@ The following table depicts the various user permission levels in a project.
 |---------------------------------------------------|---------|------------|-------------|----------|--------|
 | Download project                                  | ✓ (*1*) | ✓          | ✓           | ✓        | ✓      |
 | Leave comments                                    | ✓ (*1*) | ✓          | ✓           | ✓        | ✓      |
-| View Insights charts **[ULTIMATE]**               | ✓       | ✓          | ✓           | ✓        | ✓      |
-| View approved/blacklisted licenses **[ULTIMATE]** | ✓       | ✓          | ✓           | ✓        | ✓      |
-| View license management reports **[ULTIMATE]**    | ✓ (*1*) | ✓          | ✓           | ✓        | ✓      |
-| View Security reports **[ULTIMATE]**              | ✓ (*1*) | ✓          | ✓           | ✓        | ✓      |
+| View Insights charts **(ULTIMATE)**               | ✓       | ✓          | ✓           | ✓        | ✓      |
+| View approved/blacklisted licenses **(ULTIMATE)** | ✓       | ✓          | ✓           | ✓        | ✓      |
+| View license management reports **(ULTIMATE)**    | ✓ (*1*) | ✓          | ✓           | ✓        | ✓      |
+| View Security reports **(ULTIMATE)**              | ✓ (*1*) | ✓          | ✓           | ✓        | ✓      |
 | View project code                                 | ✓ (*1*) | ✓          | ✓           | ✓        | ✓      |
 | Pull project code                                 | ✓ (*1*) | ✓          | ✓           | ✓        | ✓      |
 | View GitLab Pages protected by [access control](project/pages/introduction.md#gitlab-pages-access-control-core-only) | ✓       | ✓          | ✓           | ✓        | ✓      |
@@ -62,8 +62,8 @@ The following table depicts the various user permission levels in a project.
 | Label issues                                      |         | ✓          | ✓           | ✓        | ✓      |
 | Lock issue discussions                            |         | ✓          | ✓           | ✓        | ✓      |
 | Manage issue tracker                              |         | ✓          | ✓           | ✓        | ✓      |
-| Manage related issues **[STARTER]**               |         | ✓          | ✓           | ✓        | ✓      |
-| Create issue from vulnerability **[ULTIMATE]**    |         | ✓          | ✓           | ✓        | ✓      |
+| Manage related issues **(STARTER)**               |         | ✓          | ✓           | ✓        | ✓      |
+| Create issue from vulnerability **(ULTIMATE)**    |         | ✓          | ✓           | ✓        | ✓      |
 | Manage labels                                     |         | ✓          | ✓           | ✓        | ✓      |
 | Create code snippets                              |         | ✓          | ✓           | ✓        | ✓      |
 | See a commit status                               |         | ✓          | ✓           | ✓        | ✓      |
@@ -72,8 +72,8 @@ The following table depicts the various user permission levels in a project.
 | See a list of merge requests                      |         | ✓          | ✓           | ✓        | ✓      |
 | View project statistics                           |         | ✓          | ✓           | ✓        | ✓      |
 | View Error Tracking list                          |         | ✓          | ✓           | ✓        | ✓      |
-| Pull from [Maven repository](project/packages/maven_repository.md) or [NPM registry](project/packages/npm_registry.md) **[PREMIUM]** |         | ✓          | ✓           | ✓        | ✓      |
-| Publish to [Maven repository](project/packages/maven_repository.md) or [NPM registry](project/packages/npm_registry.md) **[PREMIUM]** |         |            | ✓           | ✓        | ✓      ||
+| Pull from [Maven repository](project/packages/maven_repository.md) or [NPM registry](project/packages/npm_registry.md) **(PREMIUM)** |         | ✓          | ✓           | ✓        | ✓      |
+| Publish to [Maven repository](project/packages/maven_repository.md) or [NPM registry](project/packages/npm_registry.md) **(PREMIUM)** |         |            | ✓           | ✓        | ✓      ||
 | Create new branches                               |         |            | ✓           | ✓        | ✓      |
 | Push to non-protected branches                    |         |            | ✓           | ✓        | ✓      |
 | Force push to non-protected branches              |         |            | ✓           | ✓        | ✓      |
@@ -91,13 +91,13 @@ The following table depicts the various user permission levels in a project.
 | Update a container registry                       |         |            | ✓           | ✓        | ✓      |
 | Remove a container registry image                 |         |            | ✓           | ✓        | ✓      |
 | Create/edit/delete project milestones             |         |            | ✓           | ✓        | ✓      |
-| Use security dashboard **[ULTIMATE]**             |         |            | ✓           | ✓        | ✓      |
-| Dismiss vulnerability **[ULTIMATE]**              |         |            | ✓           | ✓        | ✓      |
+| Use security dashboard **(ULTIMATE)**             |         |            | ✓           | ✓        | ✓      |
+| Dismiss vulnerability **(ULTIMATE)**              |         |            | ✓           | ✓        | ✓      |
 | Apply code change suggestions                     |         |            | ✓           | ✓        | ✓      |
 | Create and edit wiki pages                        |         |            | ✓           | ✓        | ✓      |
 | Rewrite/remove Git tags                           |         |            | ✓           | ✓        | ✓      |
 | Use environment terminals                         |         |            |             | ✓        | ✓      |
-| Run Web IDE's Interactive Web Terminals **[ULTIMATE ONLY]** |     |      |             | ✓        | ✓      |
+| Run Web IDE's Interactive Web Terminals **(ULTIMATE ONLY)** |     |      |             | ✓        | ✓      |
 | Add new team members                              |         |            |             | ✓        | ✓      |
 | Enable/disable branch protection                  |         |            |             | ✓        | ✓      |
 | Push to protected branches                        |         |            |             | ✓        | ✓      |
@@ -113,7 +113,7 @@ The following table depicts the various user permission levels in a project.
 | Manage GitLab Pages domains and certificates      |         |            |             | ✓        | ✓      |
 | Remove GitLab Pages                               |         |            |             | ✓        | ✓      |
 | Manage clusters                                   |         |            |             | ✓        | ✓      |
-| Manage license policy **[ULTIMATE]**              |         |            |             | ✓        | ✓      |
+| Manage license policy **(ULTIMATE)**              |         |            |             | ✓        | ✓      |
 | Edit comments (posted by any user)                |         |            |             | ✓        | ✓      |
 | Manage Error Tracking                             |         |            |             | ✓        | ✓      |
 | Delete wiki pages                                 |         |            |             | ✓        | ✓      |
@@ -167,7 +167,7 @@ and drag issues around. Read though the
 [documentation on Issue Boards permissions](project/issue_board.md#permissions)
 to learn more.
 
-### File Locking permissions **[PREMIUM]**
+### File Locking permissions **(PREMIUM)**
 
 The user that locks a file or directory is the only one that can edit and push their changes back to the repository where the locked objects are located.
 
@@ -202,18 +202,18 @@ group.
 | Action                                          | Guest | Reporter | Developer | Maintainer | Owner |
 |-------------------------------------------------|-------|----------|-----------|------------|-------|
 | Browse group                                    | ✓     | ✓        | ✓         | ✓          | ✓     |
-| View Insights charts **[ULTIMATE]**             | ✓     | ✓        | ✓         | ✓          | ✓     |
-| View group epic **[ULTIMATE]**                  | ✓     | ✓        | ✓         | ✓          | ✓     |
-| Create/edit group epic **[ULTIMATE]**           |       | ✓        | ✓         | ✓          | ✓     |
+| View Insights charts **(ULTIMATE)**             | ✓     | ✓        | ✓         | ✓          | ✓     |
+| View group epic **(ULTIMATE)**                  | ✓     | ✓        | ✓         | ✓          | ✓     |
+| Create/edit group epic **(ULTIMATE)**           |       | ✓        | ✓         | ✓          | ✓     |
 | Manage group labels                             |       | ✓        | ✓         | ✓          | ✓     |
 | Create project in group                         |       |          | ✓         | ✓          | ✓     |
 | Create/edit/delete group milestones             |       |          | ✓         | ✓          | ✓     |
-| Enable/disable a dependency proxy **[PREMIUM]** |       |          | ✓         | ✓          | ✓     |
+| Enable/disable a dependency proxy **(PREMIUM)** |       |          | ✓         | ✓          | ✓     |
 | Edit group                                      |       |          |           |            | ✓     |
 | Create subgroup                                 |       |          |           |            | ✓     |
 | Manage group members                            |       |          |           |            | ✓     |
 | Remove group                                    |       |          |           |            | ✓     |
-| Delete group epic **[ULTIMATE]**                |       |          |           |            | ✓     |
+| Delete group epic **(ULTIMATE)**                |       |          |           |            | ✓     |
 | View group Audit Events                         |       |          |           |            | ✓     |
 
 ### Subgroup permissions
@@ -264,7 +264,7 @@ Here are some examples:
 
 Please be aware that this regex could lead to a DOS attack, [see](https://en.wikipedia.org/wiki/ReDoS?) ReDos on Wikipedia.
 
-## Auditor users **[PREMIUM ONLY]**
+## Auditor users **(PREMIUM ONLY)**
 
 >[Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/998) in [GitLab Premium](https://about.gitlab.com/pricing/) 8.17.
 
diff --git a/doc/user/profile/preferences.md b/doc/user/profile/preferences.md
index b61216b7b67..b1fde3b577b 100644
--- a/doc/user/profile/preferences.md
+++ b/doc/user/profile/preferences.md
@@ -79,7 +79,7 @@ You have 8 options here that you can use for your default dashboard view:
 - Your [Todos](../../workflow/todos.md)
 - Assigned Issues
 - Assigned Merge Requests
-- Operations Dashboard **[PREMIUM]**
+- Operations Dashboard **(PREMIUM)**
 
 ### Project overview content
 
diff --git a/doc/user/project/canary_deployments.md b/doc/user/project/canary_deployments.md
index 9bb282f1b78..5068d2757be 100644
--- a/doc/user/project/canary_deployments.md
+++ b/doc/user/project/canary_deployments.md
@@ -1,4 +1,4 @@
-# Canary Deployments **[PREMIUM]**
+# Canary Deployments **(PREMIUM)**
 
 > [Introduced][ee-1659] in [GitLab Premium][eep] 9.1.
 
diff --git a/doc/user/project/clusters/index.md b/doc/user/project/clusters/index.md
index d21455fb5ca..43f9ee7b621 100644
--- a/doc/user/project/clusters/index.md
+++ b/doc/user/project/clusters/index.md
@@ -432,7 +432,7 @@ record](https://en.wikipedia.org/wiki/Wildcard_DNS_record) such as `*.example.co
 in order to be able to reach your apps. If your external endpoint is an IP address,
 use an A record. If your external endpoint is a hostname, use a CNAME record.
 
-## Multiple Kubernetes clusters **[PREMIUM]**
+## Multiple Kubernetes clusters **(PREMIUM)**
 
 > Introduced in [GitLab Premium][ee] 10.3.
 
@@ -444,7 +444,7 @@ Simply add another cluster, like you did the first time, and make sure to
 [set an environment scope](#setting-the-environment-scope-premium) that will
 differentiate the new cluster with the rest.
 
-## Setting the environment scope **[PREMIUM]**
+## Setting the environment scope **(PREMIUM)**
 
 When adding more than one Kubernetes cluster to your project, you need to differentiate
 them with an environment scope. The environment scope associates clusters with [environments](../../../ci/environments.md) similar to how the
@@ -547,7 +547,7 @@ in a way that causes this error. Ensure you deselect the
 [GitLab-managed cluster](#gitlab-managed-clusters) option if you want to manage
 namespaces and service accounts yourself.
 
-## Monitoring your Kubernetes cluster **[ULTIMATE]**
+## Monitoring your Kubernetes cluster **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/4701) in [GitLab Ultimate][ee] 10.6.
 
@@ -585,7 +585,7 @@ and add a Kubernetes cluster again.
 
 Here's what you can do with GitLab if you enable the Kubernetes integration.
 
-### Deploy Boards **[PREMIUM]**
+### Deploy Boards **(PREMIUM)**
 
 GitLab's Deploy Boards offer a consolidated view of the current health and
 status of each CI [environment](../../../ci/environments.md) running on Kubernetes,
@@ -595,7 +595,7 @@ workflow they already use without any need to access Kubernetes.
 
 [Read more about Deploy Boards](../deploy_boards.md)
 
-### Canary Deployments **[PREMIUM]**
+### Canary Deployments **(PREMIUM)**
 
 Leverage [Kubernetes' Canary deployments](https://kubernetes.io/docs/concepts/cluster-administration/manage-deployment/#canary-deployments)
 and visualize your canary deployments right inside the Deploy Board, without
@@ -603,7 +603,7 @@ the need to leave GitLab.
 
 [Read more about Canary Deployments](../canary_deployments.md)
 
-### Pod logs **[ULTIMATE]**
+### Pod logs **(ULTIMATE)**
 
 GitLab makes it easy to view the logs of running pods in connected Kubernetes clusters. By displaying the logs directly in GitLab, developers can avoid having to manage console tools or jump to a different interface.
 
diff --git a/doc/user/project/clusters/kubernetes_pod_logs.md b/doc/user/project/clusters/kubernetes_pod_logs.md
index 25d8abebf07..864cd75823c 100644
--- a/doc/user/project/clusters/kubernetes_pod_logs.md
+++ b/doc/user/project/clusters/kubernetes_pod_logs.md
@@ -1,4 +1,4 @@
-# Kubernetes Pod Logs **[ULTIMATE]**
+# Kubernetes Pod Logs **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/4752) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 11.0.
 
diff --git a/doc/user/project/code_owners.md b/doc/user/project/code_owners.md
index c76847616b3..78ffa11d59b 100644
--- a/doc/user/project/code_owners.md
+++ b/doc/user/project/code_owners.md
@@ -1,4 +1,4 @@
-# Code Owners **[STARTER]**
+# Code Owners **(STARTER)**
 
 > - [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6916)
 in [GitLab Starter](https://about.gitlab.com/pricing/) 11.3.
diff --git a/doc/user/project/deploy_boards.md b/doc/user/project/deploy_boards.md
index 0d51e8ae19a..cb1faa771bc 100644
--- a/doc/user/project/deploy_boards.md
+++ b/doc/user/project/deploy_boards.md
@@ -1,4 +1,4 @@
-# Deploy Boards **[PREMIUM]**
+# Deploy Boards **(PREMIUM)**
 
 > [Introduced][ee-1589] in [GitLab Premium][ee] 9.0.
 
diff --git a/doc/user/project/description_templates.md b/doc/user/project/description_templates.md
index 7520237251a..196874fdc86 100644
--- a/doc/user/project/description_templates.md
+++ b/doc/user/project/description_templates.md
@@ -55,7 +55,7 @@ changes you made after picking the template and return it to its initial status.
 
 ![Description templates](img/description_templates.png)
 
-## Setting a default template for issues and merge requests  **[STARTER]**
+## Setting a default template for issues and merge requests  **(STARTER)**
 
 > **Notes:**
 >
diff --git a/doc/user/project/file_lock.md b/doc/user/project/file_lock.md
index 40603790c12..dec679fc975 100644
--- a/doc/user/project/file_lock.md
+++ b/doc/user/project/file_lock.md
@@ -1,4 +1,4 @@
-# File Locking **[PREMIUM]**
+# File Locking **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/440) in [GitLab Premium](https://about.gitlab.com/pricing/) 8.9.
 
diff --git a/doc/user/project/import/gemnasium.md b/doc/user/project/import/gemnasium.md
index 3b071ff590f..0afa32e4133 100644
--- a/doc/user/project/import/gemnasium.md
+++ b/doc/user/project/import/gemnasium.md
@@ -1,4 +1,4 @@
-# Gemnasium **[ULTIMATE]**
+# Gemnasium **(ULTIMATE)**
 
 This guide describes how to migrate from Gemnasium.com to your own GitLab
 instance or GitLab.com.
diff --git a/doc/user/project/import/github.md b/doc/user/project/import/github.md
index e194d57e2e0..cdb7f837158 100644
--- a/doc/user/project/import/github.md
+++ b/doc/user/project/import/github.md
@@ -121,10 +121,10 @@ Depending your GitLab tier, [project mirroring](../../../workflow/repository_mir
 your imported project in sync with its GitHub copy.
 
 Additionally, you can configure GitLab to send pipeline status updates back GitHub with the
-[GitHub Project Integration](../integrations/github.md). **[PREMIUM]**
+[GitHub Project Integration](../integrations/github.md). **(PREMIUM)**
 
 If you import your project using [CI/CD for external repo](../../../ci/ci_cd_for_external_repos/index.md), then both
-of the above are automatically configured. **[PREMIUM]**
+of the above are automatically configured. **(PREMIUM)**
 
 ## Improving the speed of imports on self-hosted instances
 
diff --git a/doc/user/project/import/index.md b/doc/user/project/import/index.md
index 2b6927bd780..334be713aa5 100644
--- a/doc/user/project/import/index.md
+++ b/doc/user/project/import/index.md
@@ -20,7 +20,7 @@ In addition to the specific migration documentation above, you can import any
 Git repository via HTTP from the New Project page. Be aware that if the
 repository is too large the import can timeout.
 
-There is also the option of [connecting your external repository to get CI/CD benefits](../../../ci/ci_cd_for_external_repos/index.md). **[PREMIUM]**
+There is also the option of [connecting your external repository to get CI/CD benefits](../../../ci/ci_cd_for_external_repos/index.md). **(PREMIUM)**
 
 ## Migrating from self-hosted GitLab to GitLab.com
 
diff --git a/doc/user/project/index.md b/doc/user/project/index.md
index 06286951e20..f332281fa82 100644
--- a/doc/user/project/index.md
+++ b/doc/user/project/index.md
@@ -17,7 +17,7 @@ When you create a project in GitLab, you'll have access to a large number of
 
 - [Issue tracker](issues/index.md): Discuss implementations with your team within issues
   - [Issue Boards](issue_board.md): Organize and prioritize your workflow
-  - [Multiple Issue Boards](issue_board.md#multiple-issue-boards-starter): Allow your teams to create their own workflows (Issue Boards) for the same project **[STARTER]**
+  - [Multiple Issue Boards](issue_board.md#multiple-issue-boards-starter): Allow your teams to create their own workflows (Issue Boards) for the same project **(STARTER)**
 - [Repositories](repository/index.md): Host your code in a fully
   integrated platform
   - [Branches](repository/branches/index.md): use Git branching strategies to
@@ -34,11 +34,11 @@ When you create a project in GitLab, you'll have access to a large number of
 
 - [Issue tracker](issues/index.md): Discuss implementations with your team within issues
   - [Issue Boards](issue_board.md): Organize and prioritize your workflow
-  - [Multiple Issue Boards](issue_board.md#multiple-issue-boards-starter): Allow your teams to create their own workflows (Issue Boards) for the same project **[STARTER]**
+  - [Multiple Issue Boards](issue_board.md#multiple-issue-boards-starter): Allow your teams to create their own workflows (Issue Boards) for the same project **(STARTER)**
 - [Merge Requests](merge_requests/index.md): Apply your branching
   strategy and get reviewed by your team
   - [Merge Request Approvals](merge_requests/merge_request_approvals.md): Ask for approval before
-  implementing a change **[STARTER]**
+  implementing a change **(STARTER)**
   - [Fix merge conflicts from the UI](merge_requests/resolve_conflicts.md):
   Your Git diff tool right from GitLab's UI
   - [Review Apps](../../ci/review_apps/index.md): Live preview the results
@@ -75,7 +75,7 @@ When you create a project in GitLab, you'll have access to a large number of
   - [Kubernetes cluster integration](clusters/index.md): Connecting your GitLab project
     with a Kubernetes cluster
   - [Feature Flags](operations/feature_flags.md): Feature flags allow you to ship a project in
-    different flavors by dynamically toggling certain functionality **[PREMIUM]**
+    different flavors by dynamically toggling certain functionality **(PREMIUM)**
 - [GitLab Pages](pages/index.md): Build, test, and deploy your static
   website with GitLab Pages
 
@@ -84,18 +84,18 @@ When you create a project in GitLab, you'll have access to a large number of
 - [Wiki](wiki/index.md): document your GitLab project in an integrated Wiki.
 - [Snippets](../snippets.md): store, share and collaborate on code snippets.
 - [Cycle Analytics](cycle_analytics.md): review your development lifecycle.
-- [Insights](insights/index.md): configure the Insights that matter for your projects. **[ULTIMATE]**
-- [Security Dashboard](security_dashboard.md): Security Dashboard. **[ULTIMATE]**
+- [Insights](insights/index.md): configure the Insights that matter for your projects. **(ULTIMATE)**
+- [Security Dashboard](security_dashboard.md): Security Dashboard. **(ULTIMATE)**
 - [Syntax highlighting](highlighting.md): an alternative to customize
   your code blocks, overriding GitLab's default choice of language.
 - [Badges](badges.md): badges for the project overview.
 - [Releases](releases/index.md): a way to track deliverables in your project as snapshot in time of
   the source, build output, and other metadata or artifacts
   associated with a released version of your code.
-- [Maven packages](packages/maven_repository.md): your private Maven repository in GitLab. **[PREMIUM]**
-- [NPM packages](packages/npm_registry.md): your private NPM package registry in GitLab. **[PREMIUM]**
-- [Code owners](code_owners.md): specify code owners for certain files **[STARTER]**
-- [License Management](../application_security/license_management/index.md): approve and blacklist licenses for projects. **[ULTIMATE]**
+- [Maven packages](packages/maven_repository.md): your private Maven repository in GitLab. **(PREMIUM)**
+- [NPM packages](packages/npm_registry.md): your private NPM package registry in GitLab. **(PREMIUM)**
+- [Code owners](code_owners.md): specify code owners for certain files **(STARTER)**
+- [License Management](../application_security/license_management/index.md): approve and blacklist licenses for projects. **(ULTIMATE)**
 
 ### Project integrations
 
@@ -131,7 +131,7 @@ Read through the documentation on [project settings](settings/index.md).
 - [Export a project from GitLab](settings/import_export.md#exporting-a-project-and-its-data)
 - [Importing and exporting projects between GitLab instances](settings/import_export.md)
 
-## CI/CD for external repositories **[PREMIUM]**
+## CI/CD for external repositories **(PREMIUM)**
 
 Instead of importing a repository directly to GitLab, you can connect your repository
 as a CI/CD project.
@@ -193,7 +193,7 @@ password <personal_access_token>
 To quickly access a project from the GitLab UI using the project ID,
 visit the `/projects/:id` URL in your browser or other tool accessing the project.
 
-## Project aliases **[PREMIUM ONLY]**
+## Project aliases **(PREMIUM ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/3264) in [GitLab Premium](https://about.gitlab.com/pricing/) 12.1.
 
diff --git a/doc/user/project/insights/index.md b/doc/user/project/insights/index.md
index 1c6ad0b8b2b..76a6a96eec5 100644
--- a/doc/user/project/insights/index.md
+++ b/doc/user/project/insights/index.md
@@ -1,4 +1,4 @@
-# Insights **[ULTIMATE]**
+# Insights **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/groups/gitlab-org/-/epics/725) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 12.0.
 
diff --git a/doc/user/project/integrations/github.md b/doc/user/project/integrations/github.md
index 680fcdb78bb..e8ffbde1f57 100644
--- a/doc/user/project/integrations/github.md
+++ b/doc/user/project/integrations/github.md
@@ -1,4 +1,4 @@
-# GitHub project integration **[PREMIUM]**
+# GitHub project integration **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/3836) in GitLab Premium 10.6.
 
diff --git a/doc/user/project/integrations/project_services.md b/doc/user/project/integrations/project_services.md
index 0e4c71a9d3e..62e08a183f7 100644
--- a/doc/user/project/integrations/project_services.md
+++ b/doc/user/project/integrations/project_services.md
@@ -34,12 +34,12 @@ Click on the service links to see further configuration instructions and details
 | [Emails on push](emails_on_push.md) | Email the commits and diff of each push to a list of recipients |
 | External Wiki | Replaces the link to the internal wiki with a link to an external wiki |
 | Flowdock | Flowdock is a collaboration web app for technical teams |
-| [GitHub](github.md) **[PREMIUM]** | Sends pipeline notifications to GitHub |
+| [GitHub](github.md) **(PREMIUM)** | Sends pipeline notifications to GitHub |
 | [Hangouts Chat](hangouts_chat.md) | Receive events notifications in Google Hangouts Chat |
 | [HipChat](hipchat.md) | Private group chat and IM |
 | [Irker (IRC gateway)](irker.md) | Send IRC messages, on update, to a list of recipients through an Irker gateway |
 | [Jira](jira.md) | Jira issue tracker |
-| [Jenkins](../../../integration/jenkins.md) **[STARTER]** | An extendable open source continuous integration server |
+| [Jenkins](../../../integration/jenkins.md) **(STARTER)** | An extendable open source continuous integration server |
 | JetBrains TeamCity CI | A continuous integration and build server |
 | [Mattermost slash commands](mattermost_slash_commands.md) | Mattermost chat and ChatOps slash commands |
 | [Mattermost Notifications](mattermost.md) | Receive event notifications in Mattermost |
@@ -47,7 +47,7 @@ Click on the service links to see further configuration instructions and details
 | Packagist | Update your project on Packagist, the main Composer repository |
 | Pipelines emails | Email the pipeline status to a list of recipients |
 | [Slack Notifications](slack.md) | Send GitLab events (e.g. issue created) to Slack as notifications |
-| [Slack slash commands](slack_slash_commands.md) **[CORE ONLY]** | Use slash commands in Slack to control GitLab |
+| [Slack slash commands](slack_slash_commands.md) **(CORE ONLY)** | Use slash commands in Slack to control GitLab |
 | [GitLab Slack application](gitlab_slack_application.md) **[FREE ONLY]** | Use Slack's official application |
 | PivotalTracker | Project Management Software (Source Commits Endpoint) |
 | [Prometheus](prometheus.md) | Monitor the performance of your deployed apps |
diff --git a/doc/user/project/integrations/prometheus.md b/doc/user/project/integrations/prometheus.md
index aab7131e353..6e02761e041 100644
--- a/doc/user/project/integrations/prometheus.md
+++ b/doc/user/project/integrations/prometheus.md
@@ -93,7 +93,7 @@ GitLab will automatically scan the Prometheus server for metrics from known serv
 
 You can view the performance dashboard for an environment by [clicking on the monitoring button](../../../ci/environments.md#monitoring-environments).
 
-### Adding additional metrics **[PREMIUM]**
+### Adding additional metrics **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/3799) in [GitLab Premium](https://about.gitlab.com/pricing/) 10.6.
 
@@ -120,7 +120,7 @@ GitLab supports a limited set of [CI variables](../../../ci/variables/README.htm
 
 To specify a variable in a query, enclose it in curly braces with a leading percent. For example: `%{ci_environment_slug}`.
 
-### Setting up alerts for Prometheus metrics **[ULTIMATE]**
+### Setting up alerts for Prometheus metrics **(ULTIMATE)**
 
 #### Managed Prometheus instances
 
@@ -156,7 +156,7 @@ receivers:
   ...
 ```
 
-### Taking action on incidents **[ULTIMATE]**
+### Taking action on incidents **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/4925) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 11.11.
 
diff --git a/doc/user/project/integrations/prometheus_library/kubernetes.md b/doc/user/project/integrations/prometheus_library/kubernetes.md
index 8b1cf1a251a..0d300d3c418 100644
--- a/doc/user/project/integrations/prometheus_library/kubernetes.md
+++ b/doc/user/project/integrations/prometheus_library/kubernetes.md
@@ -36,7 +36,7 @@ In order to isolate and only display relevant CPU and Memory metrics for a given
 
 Instead, the [Deployment](https://kubernetes.io/docs/concepts/workloads/controllers/deployment/) or [DaemonSet](https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/) name should begin with [CI_ENVIRONMENT_SLUG](../../../../ci/variables/README.md#predefined-environment-variables). It can be followed by a `-` and additional content if desired. For example, a deployment name of `review-homepage-5620p5` would match the `review/homepage` environment.
 
-## Displaying Canary metrics **[PREMIUM]**
+## Displaying Canary metrics **(PREMIUM)**
 
 > Introduced in [GitLab 10.2](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/15201).
 
diff --git a/doc/user/project/integrations/slack_slash_commands.md b/doc/user/project/integrations/slack_slash_commands.md
index 371e78ca3a4..813066c51ac 100644
--- a/doc/user/project/integrations/slack_slash_commands.md
+++ b/doc/user/project/integrations/slack_slash_commands.md
@@ -1,4 +1,4 @@
-# Slack slash commands **[CORE ONLY]**
+# Slack slash commands **(CORE ONLY)**
 
 > Introduced in GitLab 8.15.
 
diff --git a/doc/user/project/issue_board.md b/doc/user/project/issue_board.md
index 31020de5208..3eb5581912a 100644
--- a/doc/user/project/issue_board.md
+++ b/doc/user/project/issue_board.md
@@ -28,11 +28,11 @@ Issue Boards** (version introduced in GitLab 8.11 - August 2016).
 ### Advanced features of Issue Boards
 
 With [GitLab Starter](https://about.gitlab.com/pricing/), you can create
-[multiple issue boards](#multiple-issue-boards-starter) for a given project. **[STARTER]**
+[multiple issue boards](#multiple-issue-boards-starter) for a given project. **(STARTER)**
 
 With [GitLab Premium](https://about.gitlab.com/pricing/), you can also create multiple
 issue boards for your groups, and add lists for [assignees](#assignee-lists-premium) and
-[milestones](#milestone-lists-premium). **[PREMIUM]**
+[milestones](#milestone-lists-premium). **(PREMIUM)**
 
 Check all the [advanced features of Issue Boards](#gitlab-enterprise-features-for-issue-boards)
 below.
@@ -163,7 +163,7 @@ on the following sections.
 
 For a collection of [features per tier](#summary-of-features-per-tier), check the summary below.
 
-### Multiple Issue Boards **[STARTER]**
+### Multiple Issue Boards **(STARTER)**
 
 > Introduced in [GitLab Enterprise Edition 8.13](https://about.gitlab.com/2016/10/22/gitlab-8-13-released/#multiple-issue-boards-ee).
 
@@ -188,7 +188,7 @@ NOTE: **Note:**
 The Multiple Issue Boards feature is available for
 **projects in GitLab Starter Edition** and for **groups in GitLab Premium Edition**.
 
-### Configurable Issue Boards **[STARTER]**
+### Configurable Issue Boards **(STARTER)**
 
 > Introduced in [GitLab Starter Edition 10.2](https://about.gitlab.com/2017/11/22/gitlab-10-2-released/#issue-boards-configuration).
 
@@ -208,7 +208,7 @@ If you don't have editing permission in a board, you're still able to see the co
 
 ![Viewing board configuration](img/issue_board_view_scope.png)
 
-### Focus mode **[STARTER]**
+### Focus mode **(STARTER)**
 
 > Introduced in [GitLab Starter 9.1](https://about.gitlab.com/2017/04/22/gitlab-9-1-released/#issue-boards-focus-mode-ees-eep).
 
@@ -216,7 +216,7 @@ Click the button at the top right to toggle focus mode on and off. In focus mode
 
 ![Board focus mode](img/issue_board_focus_mode.gif)
 
-### Sum of Issue Weights **[STARTER]**
+### Sum of Issue Weights **(STARTER)**
 
 The top of each list indicates the sum of issue weights for the issues that
 belong to that list. This is useful when using boards for capacity allocation,
@@ -224,7 +224,7 @@ especially in combination with [assignee lists](#assignee-lists-premium).
 
 ![Issue Board summed weights](img/issue_board_summed_weights.png)
 
-### Group Issue Boards **[PREMIUM]**
+### Group Issue Boards **(PREMIUM)**
 
 > Introduced in [GitLab Premium 10.0](https://about.gitlab.com/2017/09/22/gitlab-10-0-released/#group-issue-boards).
 
@@ -240,7 +240,7 @@ one group issue board per group was made available in GitLab 10.6 Core.
 
 ![Group issue board](img/group_issue_board.png)
 
-### Assignee lists **[PREMIUM]**
+### Assignee lists **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/5784) in GitLab 11.0 Premium.
 
@@ -259,7 +259,7 @@ To remove an assignee list, just as with a label list, click the trash icon.
 
 ![Assignee lists](img/issue_board_assignee_lists.png)
 
-### Milestone lists **[PREMIUM]**
+### Milestone lists **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/6469) in GitLab 11.2 Premium.
 
diff --git a/doc/user/project/issues/csv_export.md b/doc/user/project/issues/csv_export.md
index 56b94585672..0b7a7af5927 100644
--- a/doc/user/project/issues/csv_export.md
+++ b/doc/user/project/issues/csv_export.md
@@ -1,4 +1,4 @@
-# Export Issues to CSV **[STARTER]**
+# Export Issues to CSV **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/1126) in [GitLab Starter 9.0](https://about.gitlab.com/2017/03/22/gitlab-9-0-released/#export-issues-ees-eep).
 
diff --git a/doc/user/project/issues/index.md b/doc/user/project/issues/index.md
index f69b841e908..e917697e973 100644
--- a/doc/user/project/issues/index.md
+++ b/doc/user/project/issues/index.md
@@ -75,7 +75,7 @@ must be set.
 
 While you can view and manage the full details of an issue on the [issue page](#issue-page),
 you can also work with multiple issues at a time using the [Issues List](#issues-list),
-[Issue Boards](#issue-boards), Issue references, and [Epics](#epics-ultimate)**[ULTIMATE]**.
+[Issue Boards](#issue-boards), Issue references, and [Epics](#epics-ultimate)**(ULTIMATE)**.
 
 Key actions for Issues include:
 
@@ -111,7 +111,7 @@ For sorting by issue priority, see [Label Priority](../labels.md#label-priority)
 ![Issue board](img/issue_board.png)
 
 [Issue boards](../issue_board.md) are Kanban boards with columns that display issues based on their labels
-or their assignees**[PREMIUM]**. They offer the flexibility to manage issues using
+or their assignees**(PREMIUM)**. They offer the flexibility to manage issues using
 highly customizable workflows.
 
 You can reorder issues within a column. If you drag an issue card to another column, its
@@ -119,13 +119,13 @@ associated label or assignee will change to match that of the new column. The en
 board can also be filtered to only include issues from a certain milestone or an overarching
 label.
 
-### Epics **[ULTIMATE]**
+### Epics **(ULTIMATE)**
 
 [Epics](../../group/epics/index.md) let you manage your portfolio of projects more
 efficiently and with less effort by tracking groups of issues that share a theme, across
 projects and milestones.
 
-### Related issues **[STARTER]**
+### Related issues **(STARTER)**
 
 You can mark two issues as related, so that when viewing one, the other is always
 listed in its [Related Issues](related_issues.md) section. This can help display important
@@ -158,7 +158,7 @@ requires [GraphQL](../../../api/graphql/index.md) to be enabled.
 - [Bulk edit issues](../bulk_editing.md) - From the Issues List, select multiple issues
   in order to change their status, assignee, milestone, or labels in bulk.
 - [Import issues](csv_import.md)
-- [Export issues](csv_export.md) **[STARTER]**
+- [Export issues](csv_export.md) **(STARTER)**
 - [Issues API](../../../api/issues.md)
 - Configure an [external issue tracker](../../../integration/external-issue-tracker.md)
   such as Jira, Redmine, or Bugzilla.
diff --git a/doc/user/project/issues/issue_data_and_actions.md b/doc/user/project/issues/issue_data_and_actions.md
index b34263f0eec..9c4d0de46d3 100644
--- a/doc/user/project/issues/issue_data_and_actions.md
+++ b/doc/user/project/issues/issue_data_and_actions.md
@@ -59,7 +59,7 @@ TIP: **Tip:**
 If a user is not member of that project, it can only be
 assigned to them if they created the issue themselves.
 
-##### 3.1. Multiple Assignees **[STARTER]**
+##### 3.1. Multiple Assignees **(STARTER)**
 
 Often multiple people work on the same issue together, which can be especially difficult
 to track in large teams where there is shared ownership of an issue.
@@ -67,7 +67,7 @@ to track in large teams where there is shared ownership of an issue.
 In [GitLab Starter](https://about.gitlab.com/pricing/), you can
 [assign multiple people](multiple_assignees_for_issues.md) to an issue.
 
-#### 4. Epic **[ULTIMATE]**
+#### 4. Epic **(ULTIMATE)**
 
 You can assign issues to an [Epic](../../group/epics/index.md), which allows better
 management of groups of related issues.
@@ -102,7 +102,7 @@ TIP: **Tip:**
 If a label doesn't exist yet, you can click **Edit**, and it opens a dropdown menu
 from which you can select **Create new label**.
 
-#### 9. Weight **[STARTER]**
+#### 9. Weight **(STARTER)**
 
 [Assign a weight](../../../workflow/issue_weight.md) to an issue.
 Larger values are used to indicate more effort is required to complete the issue. Only
@@ -180,7 +180,7 @@ TIP: **Tip:**
 Avoid mentioning `@all` in issues and merge requests, as it sends an email notification
 to all the members of that project's group, which can be interpreted as spam.
 
-#### 18. Related Issues **[STARTER]**
+#### 18. Related Issues **(STARTER)**
 
 Issues that were mentioned as [related issues](related_issues.md) are listed here.
 You can also click the `+` to add more related issues.
diff --git a/doc/user/project/issues/managing_issues.md b/doc/user/project/issues/managing_issues.md
index 1eb835d4606..709588959c1 100644
--- a/doc/user/project/issues/managing_issues.md
+++ b/doc/user/project/issues/managing_issues.md
@@ -48,7 +48,7 @@ create issues for the same project.
 
 ![Create issue from group-level issue tracker](img/create_issue_from_group_level_issue_tracker.png)
 
-### New issue via Service Desk **[PREMIUM]**
+### New issue via Service Desk **(PREMIUM)**
 
 Enable [Service Desk](../service_desk.md) for your project and offer email support.
 By doing so, when your customer sends a new email, a new issue can be created in
@@ -209,7 +209,7 @@ as well as `#22` and `#23` in group/otherproject. `#17` won't be closed as it do
 not match the pattern. It works with multi-line commit messages as well as one-liners
 when used from the command line with `git commit -m`.
 
-#### Customizing the issue closing pattern **[CORE ONLY]**
+#### Customizing the issue closing pattern **(CORE ONLY)**
 
 In order to change the default issue closing pattern, GitLab administrators must edit the
 [`gitlab.rb` or `gitlab.yml` file](../../../administration/issue_closing_pattern.md)
diff --git a/doc/user/project/issues/multiple_assignees_for_issues.md b/doc/user/project/issues/multiple_assignees_for_issues.md
index d1db0790d69..c9efe9f5031 100644
--- a/doc/user/project/issues/multiple_assignees_for_issues.md
+++ b/doc/user/project/issues/multiple_assignees_for_issues.md
@@ -1,4 +1,4 @@
-# Multiple Assignees for Issues **[STARTER]**
+# Multiple Assignees for Issues **(STARTER)**
 
 > **Note:**
 [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/1904)
diff --git a/doc/user/project/issues/related_issues.md b/doc/user/project/issues/related_issues.md
index e679ebf86e6..9c72fe33d0d 100644
--- a/doc/user/project/issues/related_issues.md
+++ b/doc/user/project/issues/related_issues.md
@@ -1,4 +1,4 @@
-# Related issues **[STARTER]**
+# Related issues **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/1797) in [GitLab Starter](https://about.gitlab.com/pricing/) 9.4.
 
diff --git a/doc/user/project/labels.md b/doc/user/project/labels.md
index 3eca1313a18..fdfeb4aa4cd 100644
--- a/doc/user/project/labels.md
+++ b/doc/user/project/labels.md
@@ -11,7 +11,7 @@ In GitLab, you can create project and group labels:
 - **Project labels** can be assigned to issues or merge requests in that project only.
 - **Group labels** can be assigned to any issue or merge request of any project in that group or any subgroups of the group.
 
-## Scoped labels **[PREMIUM]**
+## Scoped labels **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/9175) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.10.
 
@@ -38,7 +38,7 @@ For example, `nested::key1::value1` and `nested::key1::value2` cannot both exist
 
 `nested::key1::value1` and `nested::key2::value1` can both exist on the same issue, as these are considered to use two different label scopes, `nested::key1` and `nested::key2`.
 
-### Workflows with scoped labels **[PREMIUM]**
+### Workflows with scoped labels **(PREMIUM)**
 
 Suppose you wanted a custom field in issues to track the platform operating system
 that your features target, where each issue should only target one platform. You
@@ -144,9 +144,9 @@ From the group epic list page, you can [filter](../search/index.md#issues-and-me
 ### Filtering in issue boards
 
 - From [project boards](issue_board.md), you can filter by both group labels and project labels in the [search and filter bar](../search/index.md#issue-boards).
-- From [group issue boards](issue_board.md#group-issue-boards-premium), you can filter by only group labels in the [search and filter bar](../search/index.md#issue-boards). **[PREMIUM]**
-- From [project boards](issue_board.md), you can filter by both group labels and project labels in the [issue board configuration](issue_board.md#configurable-issue-boards-starter). **[STARTER]**
-- From [group issue boards](issue_board.md#group-issue-boards-premium), you can filter by only group labels in the [issue board configuration](issue_board.md#configurable-issue-boards-starter). **[STARTER]**
+- From [group issue boards](issue_board.md#group-issue-boards-premium), you can filter by only group labels in the [search and filter bar](../search/index.md#issue-boards). **(PREMIUM)**
+- From [project boards](issue_board.md), you can filter by both group labels and project labels in the [issue board configuration](issue_board.md#configurable-issue-boards-starter). **(STARTER)**
+- From [group issue boards](issue_board.md#group-issue-boards-premium), you can filter by only group labels in the [issue board configuration](issue_board.md#configurable-issue-boards-starter). **(STARTER)**
 
 ## Subscribing to labels
 
diff --git a/doc/user/project/merge_requests/browser_performance_testing.md b/doc/user/project/merge_requests/browser_performance_testing.md
index f6c4f767e3c..e95ab7d02c4 100644
--- a/doc/user/project/merge_requests/browser_performance_testing.md
+++ b/doc/user/project/merge_requests/browser_performance_testing.md
@@ -2,7 +2,7 @@
 type: reference, howto
 ---
 
-# Browser Performance Testing **[PREMIUM]**
+# Browser Performance Testing **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/3507)
 in [GitLab Premium](https://about.gitlab.com/pricing/) 10.3.
diff --git a/doc/user/project/merge_requests/code_quality.md b/doc/user/project/merge_requests/code_quality.md
index c3c2bdd94b3..ad1d79ae5b1 100644
--- a/doc/user/project/merge_requests/code_quality.md
+++ b/doc/user/project/merge_requests/code_quality.md
@@ -2,7 +2,7 @@
 type: reference, howto
 ---
 
-# Code Quality **[STARTER]**
+# Code Quality **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/1984)
 in [GitLab Starter](https://about.gitlab.com/pricing/) 9.3.
diff --git a/doc/user/project/merge_requests/index.md b/doc/user/project/merge_requests/index.md
index 169b10572b0..37a0630d0f3 100644
--- a/doc/user/project/merge_requests/index.md
+++ b/doc/user/project/merge_requests/index.md
@@ -37,16 +37,16 @@ With GitLab merge requests, you can:
 
 With **[GitLab Enterprise Edition][ee]**, you can also:
 
-- Prepare a full review and submit it once it's ready with [Merge Request Reviews](../../discussions/index.md#merge-request-reviews-premium) **[PREMIUM]**
-- View the deployment process across projects with [Multi-Project Pipelines](../../../ci/multi_project_pipelines.md) **[PREMIUM]**
-- Request [approvals](merge_request_approvals.md) from your managers **[STARTER]**
-- Analyze the impact of your changes with [Code Quality reports](code_quality.md) **[STARTER]**
-- Manage the licenses of your dependencies with [License Management](../../application_security/license_management/index.md) **[ULTIMATE]**
-- Analyze your source code for vulnerabilities with [Static Application Security Testing](../../application_security/sast/index.md) **[ULTIMATE]**
-- Analyze your running web applications for vulnerabilities with [Dynamic Application Security Testing](../../application_security/dast/index.md) **[ULTIMATE]**
-- Analyze your dependencies for vulnerabilities with [Dependency Scanning](../../application_security/dependency_scanning/index.md) **[ULTIMATE]**
-- Analyze your Docker images for vulnerabilities with [Container Scanning](../../application_security/container_scanning/index.md) **[ULTIMATE]**
-- Determine the performance impact of changes with [Browser Performance Testing](#browser-performance-testing-premium) **[PREMIUM]**
+- Prepare a full review and submit it once it's ready with [Merge Request Reviews](../../discussions/index.md#merge-request-reviews-premium) **(PREMIUM)**
+- View the deployment process across projects with [Multi-Project Pipelines](../../../ci/multi_project_pipelines.md) **(PREMIUM)**
+- Request [approvals](merge_request_approvals.md) from your managers **(STARTER)**
+- Analyze the impact of your changes with [Code Quality reports](code_quality.md) **(STARTER)**
+- Manage the licenses of your dependencies with [License Management](../../application_security/license_management/index.md) **(ULTIMATE)**
+- Analyze your source code for vulnerabilities with [Static Application Security Testing](../../application_security/sast/index.md) **(ULTIMATE)**
+- Analyze your running web applications for vulnerabilities with [Dynamic Application Security Testing](../../application_security/dast/index.md) **(ULTIMATE)**
+- Analyze your dependencies for vulnerabilities with [Dependency Scanning](../../application_security/dependency_scanning/index.md) **(ULTIMATE)**
+- Analyze your Docker images for vulnerabilities with [Container Scanning](../../application_security/container_scanning/index.md) **(ULTIMATE)**
+- Determine the performance impact of changes with [Browser Performance Testing](#browser-performance-testing-premium) **(PREMIUM)**
 
 ## Use cases
 
@@ -54,9 +54,9 @@ A. Consider you are a software developer working in a team:
 
 1. You checkout a new branch, and submit your changes through a merge request
 1. You gather feedback from your team
-1. You work on the implementation optimizing code with [Code Quality reports](code_quality.md) **[STARTER]**
+1. You work on the implementation optimizing code with [Code Quality reports](code_quality.md) **(STARTER)**
 1. You verify your changes with [JUnit test reports](../../../ci/junit_test_reports.md) in GitLab CI/CD
-1. You avoid using dependencies whose license is not compatible with your project with [License Management reports](license_management.md) **[ULTIMATE]**
+1. You avoid using dependencies whose license is not compatible with your project with [License Management reports](license_management.md) **(ULTIMATE)**
 1. You request the [approval](#merge-request-approvals-starter) from your manager
 1. Your manager pushes a commit with their final review, [approves the merge request](merge_request_approvals.md), and set it to [merge when pipeline succeeds](#merge-when-pipeline-succeeds) (Merge Request Approvals are available in GitLab Starter)
 1. Your changes get deployed to production with [manual actions](../../../ci/yaml/README.md#whenmanual) for GitLab CI/CD
@@ -68,7 +68,7 @@ B. Consider you're a web developer writing a webpage for your company's website:
 1. You gather feedback from your reviewers
 1. Your changes are previewed with [Review Apps](../../../ci/review_apps/index.md)
 1. You request your web designers for their implementation
-1. You request the [approval](merge_request_approvals.md) from your manager **[STARTER]**
+1. You request the [approval](merge_request_approvals.md) from your manager **(STARTER)**
 1. Once approved, your merge request is [squashed and merged](squash_and_merge.md), and [deployed to staging with GitLab Pages](https://about.gitlab.com/2016/08/26/ci-deployment-and-environments/)
 1. Your production team [cherry picks](#cherry-pick-changes) the merge commit into production
 
@@ -172,7 +172,7 @@ in a Merge Request. To do so, click the **...** button in the gutter of the Merg
 
 ![Comment on any diff file line](img/comment-on-any-diff-line.png)
 
-## Perform a Review **[PREMIUM]**
+## Perform a Review **(PREMIUM)**
 
 Start a review in order to create multiple comments on a diff and publish them once you're ready.
 Starting a review allows you to get all your thoughts in order and ensure you haven't missed anything
@@ -197,7 +197,7 @@ can easily apply them to the codebase directly from the UI. Read
 through the documentation on [Suggest changes](../../discussions/index.md#suggest-changes)
 to learn more.
 
-## Multiple assignees **[STARTER]**
+## Multiple assignees **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/2004)
 in [GitLab Starter 11.11](https://about.gitlab.com/pricing).
@@ -364,7 +364,7 @@ have been marked as a **Work In Progress**.
 
 [Learn more about setting a merge request as "Work In Progress".](work_in_progress_merge_requests.md)
 
-## Merge request approvals **[STARTER]**
+## Merge request approvals **(STARTER)**
 
 > Included in [GitLab Starter][products].
 
@@ -375,7 +375,7 @@ list of approvers that will need to approve every merge request in a project.
 
 [Read more about merge request approvals.](merge_request_approvals.md)
 
-## Code Quality **[STARTER]**
+## Code Quality **(STARTER)**
 
 > Introduced in [GitLab Starter][products] 9.3.
 
@@ -385,7 +385,7 @@ can show the Code Climate report right in the merge request widget area.
 
 [Read more about Code Quality reports.](code_quality.md)
 
-## Browser Performance Testing **[PREMIUM]**
+## Browser Performance Testing **(PREMIUM)**
 
 > Introduced in [GitLab Premium][products] 10.3.
 
@@ -395,7 +395,7 @@ GitLab runs the [Sitespeed.io container][sitespeed-container] and displays the d
 
 [Read more about Browser Performance Testing.](browser_performance_testing.md)
 
-## Security reports **[ULTIMATE]**
+## Security reports **(ULTIMATE)**
 
 GitLab can scan and report any vulnerabilities found in your project.
 
diff --git a/doc/user/project/merge_requests/merge_request_approvals.md b/doc/user/project/merge_requests/merge_request_approvals.md
index 8e8ec26daf2..0f392676316 100644
--- a/doc/user/project/merge_requests/merge_request_approvals.md
+++ b/doc/user/project/merge_requests/merge_request_approvals.md
@@ -2,7 +2,7 @@
 type: reference, concepts
 ---
 
-# Merge request approvals **[STARTER]**
+# Merge request approvals **(STARTER)**
 
 > Introduced in [GitLab Enterprise Edition 7.12](https://about.gitlab.com/2015/06/22/gitlab-7-12-released/#merge-request-approvers-ee-only).
 
@@ -64,7 +64,7 @@ suitable to your workflow:
   [overridden per merge request](#overriding-the-merge-request-approvals-default-settings)
 - Choose whether [approvals will be reset with new pushed commits](#resetting-approvals-on-push)
 
-## Editing approvals **[PREMIUM]**
+## Editing approvals **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/1979) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.8.
 
@@ -85,7 +85,7 @@ request approval rules:
 
     ![Approvals premium project edit](img/approvals_premium_project_edit.png)
 
-## Multiple approval rules **[PREMIUM]**
+## Multiple approval rules **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/1979) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.8.
 
@@ -165,7 +165,7 @@ are other conditions that may block it, such as merge conflicts,
 [pending discussions](../../discussions/index.md#only-allow-merge-requests-to-be-merged-if-all-discussions-are-resolved)
 or a [failed CI/CD pipeline](merge_when_pipeline_succeeds.md).
 
-## Code Owners approvals **[PREMIUM]**
+## Code Owners approvals **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/4418) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.9.
 
@@ -237,7 +237,7 @@ If you are contributing to a forked project, things are a little different.
 Read what happens  when the
 [source and target branches are not the same](#merge-requests-with-different-source-branch-and-target-branch-projects).
 
-## Overriding merge request approvals default settings **[PREMIUM]**
+## Overriding merge request approvals default settings **(PREMIUM)**
 
 In GitLab Premium, when the approval rules are [set at the project level](#editing-approvals-premium), and
 **Can override approvers and approvals required per merge request** is checked, there are a few more
@@ -295,7 +295,7 @@ enabling [**Prevent approval of merge requests by their committers**](#prevent-a
 1. Tick the checkbox **Prevent approval of merge requests by their committers**.
 1. Click **Save changes**.
 
-## Require authentication when approving a merge request **[STARTER]**
+## Require authentication when approving a merge request **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/5981) in [GitLab Starter](https://about.gitlab.com/pricing/) 12.0.
 
diff --git a/doc/user/project/milestones/burndown_charts.md b/doc/user/project/milestones/burndown_charts.md
index 7ffeb032d7f..84e08b4eeb8 100644
--- a/doc/user/project/milestones/burndown_charts.md
+++ b/doc/user/project/milestones/burndown_charts.md
@@ -1,4 +1,4 @@
-# Burndown Charts **[STARTER]**
+# Burndown Charts **(STARTER)**
 
 > **Notes:**
 > - [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/1540) in [GitLab Starter](https://about.gitlab.com/pricing/) 9.1 for project milestones.
diff --git a/doc/user/project/milestones/index.md b/doc/user/project/milestones/index.md
index 6cd866b5c0d..b0745b1e2c5 100644
--- a/doc/user/project/milestones/index.md
+++ b/doc/user/project/milestones/index.md
@@ -84,9 +84,9 @@ From the project issue/merge request list pages and the group issue/merge reques
 ### Filtering in issue boards
 
 - From [project issue boards](../issue_board.md), you can filter by both group milestones and project milestones in the [search and filter bar](../../search/index.md#issue-boards).
-- From [group issue boards](../issue_board.md#group-issue-boards-premium), you can filter by only group milestones in the [search and filter bar](../../search/index.md#issue-boards). **[PREMIUM]**
-- From [project issue boards](../issue_board.md), you can filter by both group milestones and project milestones in the [issue board configuration](../issue_board.md#configurable-issue-boards-starter). **[STARTER]**
-- From [group issue boards](../issue_board.md#group-issue-boards-premium) you can filter by only group milestones in the [issue board configuration](../issue_board.md#configurable-issue-boards-starter). **[STARTER]**
+- From [group issue boards](../issue_board.md#group-issue-boards-premium), you can filter by only group milestones in the [search and filter bar](../../search/index.md#issue-boards). **(PREMIUM)**
+- From [project issue boards](../issue_board.md), you can filter by both group milestones and project milestones in the [issue board configuration](../issue_board.md#configurable-issue-boards-starter). **(STARTER)**
+- From [group issue boards](../issue_board.md#group-issue-boards-premium) you can filter by only group milestones in the [issue board configuration](../issue_board.md#configurable-issue-boards-starter). **(STARTER)**
 
 ### Special milestone filters
 
@@ -124,13 +124,13 @@ These features are only available for project milestones and not group milestone
 - Participants and labels that are used in issues and merge requests that have the milestone assigned are displayed.
 - [Burndown chart](#project-burndown-charts-starter).
 
-### Project Burndown Charts **[STARTER]**
+### Project Burndown Charts **(STARTER)**
 
 For project milestones in [GitLab Starter](https://about.gitlab.com/pricing), a [burndown chart](burndown_charts.md) is in the milestone view, showing the progress of completing a milestone.
 
 ![burndown chart](img/burndown_chart.png)
 
-### Group Burndown Charts **[PREMIUM]**
+### Group Burndown Charts **(PREMIUM)**
 
 For group milestones in [GitLab Premium](https://about.gitlab.com/pricing), a [burndown chart](burndown_charts.md) is in the milestone view, showing the progress of completing a milestone.
 
diff --git a/doc/user/project/operations/feature_flags.md b/doc/user/project/operations/feature_flags.md
index a5db3d70bb9..fdc1e978291 100644
--- a/doc/user/project/operations/feature_flags.md
+++ b/doc/user/project/operations/feature_flags.md
@@ -1,4 +1,4 @@
-# Feature Flags **[PREMIUM]**
+# Feature Flags **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/11845) in GitLab 11.4.
 
diff --git a/doc/user/project/operations/index.md b/doc/user/project/operations/index.md
index 84711d1146f..2da9c3e70cf 100644
--- a/doc/user/project/operations/index.md
+++ b/doc/user/project/operations/index.md
@@ -7,6 +7,6 @@ your applications:
 - Deploy to different [environments](../../../ci/environments.md).
 - Connect your project to a [Kubernetes cluster](../clusters/index.md).
 - Discover and view errors generated by your applications with [Error Tracking](error_tracking.md).
-- Create, toggle, and remove [Feature Flags](feature_flags.md). **[PREMIUM]**
-- [Trace](tracing.md) the performance and health of a deployed application. **[ULTIMATE]**
+- Create, toggle, and remove [Feature Flags](feature_flags.md). **(PREMIUM)**
+- [Trace](tracing.md) the performance and health of a deployed application. **(ULTIMATE)**
 - Add a [button to the Monitoring dashboard](linking_to_an_external_dashboard.md) linking directly to your existing external dashboards.
diff --git a/doc/user/project/operations/tracing.md b/doc/user/project/operations/tracing.md
index 0416e096cf2..a74233bbd02 100644
--- a/doc/user/project/operations/tracing.md
+++ b/doc/user/project/operations/tracing.md
@@ -1,4 +1,4 @@
-# Tracing **[ULTIMATE]**
+# Tracing **(ULTIMATE)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/7903) in GitLab Ultimate 11.5.
 
diff --git a/doc/user/project/packages/maven_repository.md b/doc/user/project/packages/maven_repository.md
index 9b7af738696..27c052fb2bc 100644
--- a/doc/user/project/packages/maven_repository.md
+++ b/doc/user/project/packages/maven_repository.md
@@ -1,4 +1,4 @@
-# GitLab Maven Repository **[PREMIUM]**
+# GitLab Maven Repository **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/5811) in
   [GitLab Premium](https://about.gitlab.com/pricing/) 11.3.
@@ -12,7 +12,7 @@ project can have its own space to store its Maven artifacts.
 
 NOTE: **Note:**
 This option is available only if your GitLab administrator has
-[enabled support for the Maven repository](../../../administration/packages.md).**[PREMIUM ONLY]**
+[enabled support for the Maven repository](../../../administration/packages.md).**(PREMIUM ONLY)**
 
 After the Packages feature is enabled, the Maven Repository will be available for
 all new projects by default. To enable it for existing projects, or if you want
diff --git a/doc/user/project/packages/npm_registry.md b/doc/user/project/packages/npm_registry.md
index 2e274573434..b2cfe10836f 100644
--- a/doc/user/project/packages/npm_registry.md
+++ b/doc/user/project/packages/npm_registry.md
@@ -1,4 +1,4 @@
-# GitLab NPM Registry **[PREMIUM]**
+# GitLab NPM Registry **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/5934)
   in [GitLab Premium](https://about.gitlab.com/pricing/) 11.7.
@@ -20,7 +20,7 @@ within a subgroup is not supported yet.
 
 NOTE: **Note:**
 This option is available only if your GitLab administrator has
-[enabled support for the NPM registry](../../../administration/packages.md).**[PREMIUM ONLY]**
+[enabled support for the NPM registry](../../../administration/packages.md).**(PREMIUM ONLY)**
 
 After the NPM registry is enabled, it will be available for all new projects
 by default. To enable it for existing projects, or if you want to disable it:
diff --git a/doc/user/project/pages/introduction.md b/doc/user/project/pages/introduction.md
index 4ea3bd9be9b..9451b5349c0 100644
--- a/doc/user/project/pages/introduction.md
+++ b/doc/user/project/pages/introduction.md
@@ -67,7 +67,7 @@ Some static site generators provide plugins for that functionality so that you
 don't have to create and edit HTML files manually. For example, Jekyll has the
 [redirect-from plugin](https://github.com/jekyll/jekyll-redirect-from).
 
-## GitLab Pages Access Control **[CORE ONLY]**
+## GitLab Pages Access Control **(CORE ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/33422) in GitLab 11.5.
 
diff --git a/doc/user/project/protected_branches.md b/doc/user/project/protected_branches.md
index 99cede557a0..20a03dff2da 100644
--- a/doc/user/project/protected_branches.md
+++ b/doc/user/project/protected_branches.md
@@ -66,7 +66,7 @@ dropdown list in the "Already protected" area.
 If you don't choose any of those options while creating a protected branch,
 they are set to "Maintainers" by default.
 
-## Restricting push and merge access to certain users **[STARTER]**
+## Restricting push and merge access to certain users **(STARTER)**
 
 > This feature was [introduced][ce-5081] in [GitLab Starter][ee] 8.11.
 
diff --git a/doc/user/project/quick_actions.md b/doc/user/project/quick_actions.md
index d20b44d4b92..8b8aa51b6dd 100644
--- a/doc/user/project/quick_actions.md
+++ b/doc/user/project/quick_actions.md
@@ -26,9 +26,9 @@ discussions, and descriptions:
 | `/award :emoji:`           | Toggle emoji award             | ✓     | ✓             |
 | `/assign me`               | Assign yourself                | ✓     | ✓             |
 | `/assign @user`            | Assign one user                | ✓     | ✓             |
-| `/assign @user1 @user2`    | Assign multiple users **[STARTER]** | ✓ | ✓            |
-| `/unassign @user1 @user2`  | Remove assignee(s) **[STARTER]** | ✓     | ✓             |
-| `/reassign @user1 @user2`  | Change assignee **[STARTER]**  | ✓     | ✓             |
+| `/assign @user1 @user2`    | Assign multiple users **(STARTER)** | ✓ | ✓            |
+| `/unassign @user1 @user2`  | Remove assignee(s) **(STARTER)** | ✓     | ✓             |
+| `/reassign @user1 @user2`  | Change assignee **(STARTER)**  | ✓     | ✓             |
 | `/unassign`                | Remove current assignee        | ✓     | ✓             |
 | `/milestone %milestone`    | Set milestone                  | ✓     | ✓             |
 | `/remove_milestone`        | Remove milestone               | ✓     | ✓             |
@@ -44,11 +44,11 @@ discussions, and descriptions:
 | `/unlock`                  | Unlock the discussion          | ✓     | ✓             |
 | <code>/due &lt;in 2 days &#124; this Friday &#124; December 31st&gt;</code>| Set due date | ✓ | |
 | `/remove_due_date`         | Remove due date                | ✓     |               |
-| <code>/weight &lt;0 &#124; 1 &#124; 2 &#124; ...&gt;</code> | Set weight **[STARTER]**       | ✓     |               |
-| `/clear_weight`            | Clears weight **[STARTER]**    | ✓     |               |
-| <code>/epic &lt;&epic &#124; group&epic &#124; Epic URL&gt;</code> | Add to epic **[ULTIMATE]** | ✓ |             |
-| `/remove_epic`             | Removes from epic **[ULTIMATE]** | ✓   |               |
-| `/promote`                 | Promote issue to epic **[ULTIMATE]** | ✓   |               |
+| <code>/weight &lt;0 &#124; 1 &#124; 2 &#124; ...&gt;</code> | Set weight **(STARTER)**       | ✓     |               |
+| `/clear_weight`            | Clears weight **(STARTER)**    | ✓     |               |
+| <code>/epic &lt;&epic &#124; group&epic &#124; Epic URL&gt;</code> | Add to epic **(ULTIMATE)** | ✓ |             |
+| `/remove_epic`             | Removes from epic **(ULTIMATE)** | ✓   |               |
+| `/promote`                 | Promote issue to epic **(ULTIMATE)** | ✓   |               |
 | `/confidential`            | Make confidential              | ✓     |               |
 | `/duplicate <#issue>`        | Mark this issue as a duplicate of another issue | ✓    |
 | `/move <path/to/project>`    | Move this issue to another project | ✓ |               |
@@ -57,7 +57,7 @@ discussions, and descriptions:
 | `/approve`                 | Approve the merge request      |       | ✓             |
 | `/merge`                   | Merge (when pipeline succeeds) |       | ✓             |
 | `/create_merge_request <branch name>` | Create a new merge request starting from the current issue | ✓ | |
-| `/relate #issue1 #issue2`  | Mark issues as related **[STARTER]** | ✓     |               |
+| `/relate #issue1 #issue2`  | Mark issues as related **(STARTER)** | ✓     |               |
 
 ## Quick actions for commit messages
 
@@ -67,7 +67,7 @@ The following quick actions are applicable for commit messages:
 |:------------------------|:------------------------------------------|
 | `/tag v1.2.3 <message>` | Tags this commit with an optional message |
 
-## Quick actions for Epics **[ULTIMATE]**
+## Quick actions for Epics **(ULTIMATE)**
 
 The following quick actions are applicable for epics threads and description:
 
diff --git a/doc/user/project/repository/gpg_signed_commits/index.md b/doc/user/project/repository/gpg_signed_commits/index.md
index 3260a355fdc..cf0a986887e 100644
--- a/doc/user/project/repository/gpg_signed_commits/index.md
+++ b/doc/user/project/repository/gpg_signed_commits/index.md
@@ -261,7 +261,7 @@ To remove a GPG key from your account:
 1. Navigate to the **GPG keys** tab.
 1. Click on the trash icon besides the GPG key you want to delete.
 
-## Rejecting commits that are not signed **[PREMIUM]**
+## Rejecting commits that are not signed **(PREMIUM)**
 
 You can configure your project to reject commits that aren't GPG-signed
 via [push rules](../../../../push_rules/push_rules.md).
diff --git a/doc/user/project/repository/index.md b/doc/user/project/repository/index.md
index 5e0f4c69b5e..5b5685b3418 100644
--- a/doc/user/project/repository/index.md
+++ b/doc/user/project/repository/index.md
@@ -221,7 +221,7 @@ Select branches to compare using the [branch filter search box](branches/index.m
 
 Find it under your project's **Repository > Compare**.
 
-## Locked files **[PREMIUM]**
+## Locked files **(PREMIUM)**
 
 Use [File Locking](../file_lock.md) to
 lock your files to prevent any conflicting changes.
diff --git a/doc/user/project/service_desk.md b/doc/user/project/service_desk.md
index 1a582164d03..f899120f0c2 100644
--- a/doc/user/project/service_desk.md
+++ b/doc/user/project/service_desk.md
@@ -1,4 +1,4 @@
-# Service Desk **[PREMIUM]**
+# Service Desk **(PREMIUM)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/149) in [GitLab Premium 9.1](https://about.gitlab.com/2017/04/22/gitlab-9-1-released/#service-desk-eep).
 
diff --git a/doc/user/project/settings/index.md b/doc/user/project/settings/index.md
index 01763c49207..06b431decad 100644
--- a/doc/user/project/settings/index.md
+++ b/doc/user/project/settings/index.md
@@ -42,13 +42,13 @@ Set up your project's merge request settings:
 
 - Set up the merge request method (merge commit, [fast-forward merge](../merge_requests/fast_forward_merge.html)).
 - Merge request [description templates](../description_templates.md#description-templates).
-- Enable [merge request approvals](../merge_requests/merge_request_approvals.md). **[STARTER]**
+- Enable [merge request approvals](../merge_requests/merge_request_approvals.md). **(STARTER)**
 - Enable [merge only of pipeline succeeds](../merge_requests/merge_when_pipeline_succeeds.md).
 - Enable [merge only when all discussions are resolved](../../discussions/index.md#only-allow-merge-requests-to-be-merged-if-all-discussions-are-resolved).
 
 ![project's merge request settings](img/merge_requests_settings.png)
 
-### Service Desk **[PREMIUM]**
+### Service Desk **(PREMIUM)**
 
 Enable [Service Desk](../service_desk.md) for your project to offer customer support.
 
@@ -135,6 +135,6 @@ namespace if needed.
 
 Configure Error Tracking to discover and view [Sentry errors within GitLab](../operations/error_tracking.md).
 
-### Jaeger tracing **[ULTIMATE]**
+### Jaeger tracing **(ULTIMATE)**
 
 Add the URL of a Jaeger server to allow your users to [easily access the Jaeger UI from within GitLab](../operations/tracing.md).
diff --git a/doc/user/project/web_ide/index.md b/doc/user/project/web_ide/index.md
index 7d85f4adfed..3d92508ad04 100644
--- a/doc/user/project/web_ide/index.md
+++ b/doc/user/project/web_ide/index.md
@@ -129,7 +129,7 @@ below.
 }
 ```
 
-## Interactive Web Terminals for the Web IDE **[ULTIMATE ONLY]**
+## Interactive Web Terminals for the Web IDE **(ULTIMATE ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/5426) in [GitLab Ultimate](https://about.gitlab.com/pricing/) 11.6.
 
@@ -151,7 +151,7 @@ to work:
 - The Runner needs to have
   [`[session_server]` configured properly](https://docs.gitlab.com/runner/configuration/advanced-configuration.html#the-session_server-section).
 - If you are using a reverse proxy with your GitLab instance, web terminals need to be
-  [enabled](../../../administration/integration/terminal.md#enabling-and-disabling-terminal-support). **[ULTIMATE ONLY]**
+  [enabled](../../../administration/integration/terminal.md#enabling-and-disabling-terminal-support). **(ULTIMATE ONLY)**
 
 If you have the terminal open and the job has finished with its tasks, the
 terminal will block the job from finishing for the duration configured in
diff --git a/doc/user/search/advanced_global_search.md b/doc/user/search/advanced_global_search.md
index f80f4183802..52da6d65000 100644
--- a/doc/user/search/advanced_global_search.md
+++ b/doc/user/search/advanced_global_search.md
@@ -1,4 +1,4 @@
-# Advanced Global Search **[STARTER ONLY]**
+# Advanced Global Search **(STARTER ONLY)**
 
 > - [Introduced][ee-109] in GitLab [Starter][ee] 8.4.
 > - This is the user documentation. To install and configure Elasticsearch,
diff --git a/doc/user/search/advanced_search_syntax.md b/doc/user/search/advanced_search_syntax.md
index d302cb7a809..ad9f065b19b 100644
--- a/doc/user/search/advanced_search_syntax.md
+++ b/doc/user/search/advanced_search_syntax.md
@@ -1,4 +1,4 @@
-# Advanced Syntax Search **[STARTER ONLY]**
+# Advanced Syntax Search **(STARTER ONLY)**
 
 > **Notes:**
 > - Introduced in [GitLab Enterprise Starter][ee] 9.2
diff --git a/doc/user/search/index.md b/doc/user/search/index.md
index d6e2f036cf2..c34b9ae3d7e 100644
--- a/doc/user/search/index.md
+++ b/doc/user/search/index.md
@@ -143,14 +143,14 @@ and **Labels**, select multiple issues to add to a list of your choice:
 
 ![search and select issues to add to board](img/search_issues_board.png)
 
-## Advanced Global Search **[STARTER]**
+## Advanced Global Search **(STARTER)**
 
 Leverage Elasticsearch for faster, more advanced code search across your entire
 GitLab instance.
 
 [Learn how to use the Advanced Global Search.](advanced_global_search.md)
 
-## Advanced Syntax Search **[STARTER]**
+## Advanced Syntax Search **(STARTER)**
 
 Use advanced queries for more targeted search results.
 
diff --git a/doc/workflow/README.md b/doc/workflow/README.md
index 45bd8c29a48..6ad61932868 100644
--- a/doc/workflow/README.md
+++ b/doc/workflow/README.md
@@ -13,15 +13,15 @@ comments: false
 - [Groups](../user/group/index.md)
 - Issues - The GitLab Issue Tracker is an advanced and complete tool for
   tracking the evolution of a new idea or the process of solving a problem.
-  - [Exporting Issues](../user/project/issues/csv_export.md) **[STARTER]** Export issues as a CSV, emailed as an attachment.
+  - [Exporting Issues](../user/project/issues/csv_export.md) **(STARTER)** Export issues as a CSV, emailed as an attachment.
   - [Confidential issues](../user/project/issues/confidential_issues.md)
   - [Due date for issues](../user/project/issues/due_dates.md)
 - [Issue Board](../user/project/issue_board.md)
 - [Keyboard shortcuts](shortcuts.md)
 - [File finder](file_finder.md)
-- [File lock](../user/project/file_lock.md) **[PREMIUM]**
+- [File lock](../user/project/file_lock.md) **(PREMIUM)**
 - [Labels](../user/project/labels.md)
-- [Issue weight](issue_weight.md) **[STARTER]**
+- [Issue weight](issue_weight.md) **(STARTER)**
 - [Notification emails](notifications.md)
 - [Projects](../user/project/index.md)
 - [Project forking workflow](forking_workflow.md)
@@ -44,9 +44,9 @@ comments: false
   - [Merge requests versions](../user/project/merge_requests/versions.md)
   - ["Work In Progress" merge requests](../user/project/merge_requests/work_in_progress_merge_requests.md)
   - [Fast-forward merge requests](../user/project/merge_requests/fast_forward_merge.md)
-  - [Merge request approvals](../user/project/merge_requests/merge_request_approvals.md) **[STARTER]**
-- [Repository mirroring](repository_mirroring.md) **[STARTER]**
-- [Service Desk](../user/project/service_desk.md) **[PREMIUM]**
+  - [Merge request approvals](../user/project/merge_requests/merge_request_approvals.md) **(STARTER)**
+- [Repository mirroring](repository_mirroring.md) **(STARTER)**
+- [Service Desk](../user/project/service_desk.md) **(PREMIUM)**
 - [Manage large binaries with Git LFS](lfs/manage_large_binaries_with_git_lfs.md)
 - [Importing from SVN, GitHub, Bitbucket, etc](importing/README.md)
 - [Todos](todos.md)
diff --git a/doc/workflow/issue_weight.md b/doc/workflow/issue_weight.md
index 267160dae2a..afb623e1967 100644
--- a/doc/workflow/issue_weight.md
+++ b/doc/workflow/issue_weight.md
@@ -1,4 +1,4 @@
-# Issue Weight **[STARTER]**
+# Issue Weight **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/76)
 > in [GitLab Starter](https://about.gitlab.com/pricing/) 8.3.
diff --git a/doc/workflow/notifications.md b/doc/workflow/notifications.md
index d49d29c805a..1e8674f863d 100644
--- a/doc/workflow/notifications.md
+++ b/doc/workflow/notifications.md
@@ -84,11 +84,11 @@ In most of the below cases, the notification will be sent to:
 - Participants:
   - the author and assignee of the issue/merge request
   - authors of comments on the issue/merge request
-  - anyone mentioned by `@username` in the title or description of the issue, merge request or epic **[ULTIMATE]**
+  - anyone mentioned by `@username` in the title or description of the issue, merge request or epic **(ULTIMATE)**
   - anyone with notification level "Participating" or higher that is mentioned by `@username`
-    in any of the comments on the issue, merge request, or epic **[ULTIMATE]**
+    in any of the comments on the issue, merge request, or epic **(ULTIMATE)**
 - Watchers: users with notification level "Watch"
-- Subscribers: anyone who manually subscribed to the issue, merge request, or epic **[ULTIMATE]**
+- Subscribers: anyone who manually subscribed to the issue, merge request, or epic **(ULTIMATE)**
 - Custom: Users with notification level "custom" who turned on notifications for any of the events present in the table below
 
 | Event                  | Sent to |
@@ -111,9 +111,9 @@ In most of the below cases, the notification will be sent to:
 | New comment            | The above, plus anyone mentioned by `@username` in the comment, with notification level "Mention" or higher |
 | Failed pipeline        | The author of the pipeline |
 | Successful pipeline    | The author of the pipeline, if they have the custom notification setting for successful pipelines set |
-| New epic **[ULTIMATE]** |        |
-| Close epic **[ULTIMATE]** |      |
-| Reopen epic **[ULTIMATE]** |     |
+| New epic **(ULTIMATE)** |        |
+| Close epic **(ULTIMATE)** |      |
+| Reopen epic **(ULTIMATE)** |     |
 
 In addition, if the title or description of an Issue or Merge Request is
 changed, notifications will be sent to any **new** mentions by `@username` as
diff --git a/doc/workflow/repository_mirroring.md b/doc/workflow/repository_mirroring.md
index 92e88ea224a..87ca46e94be 100644
--- a/doc/workflow/repository_mirroring.md
+++ b/doc/workflow/repository_mirroring.md
@@ -13,7 +13,7 @@ Repository mirroring is useful when you want to use a repository outside of GitL
 There are two kinds of repository mirroring supported by GitLab:
 
 - Push: for mirroring a GitLab repository to another location.
-- Pull: for mirroring a repository from another location to GitLab. **[STARTER]**
+- Pull: for mirroring a repository from another location to GitLab. **(STARTER)**
 
 When the mirror repository is updated, all new branches, tags, and commits will be visible in the
 project's activity feed.
@@ -30,12 +30,12 @@ The following are some possible use cases for repository mirroring:
 
 - You migrated to GitLab but still need to keep your project in another source. In that case, you
   can simply set it up to mirror to GitLab (pull) and all the essential history of commits, tags,
-  and branches will be available in your GitLab instance. **[STARTER]**
+  and branches will be available in your GitLab instance. **(STARTER)**
 - You have old projects in another source that you don't use actively anymore, but don't want to
   remove for archiving purposes. In that case, you can create a push mirror so that your active
   GitLab repository can push its changes to the old location.
 
-## Pushing to a remote repository **[CORE]**
+## Pushing to a remote repository **(CORE)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/249) in GitLab Enterprise
 > Edition 8.7. [Moved to GitLab Core](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/18715) in 10.8.
@@ -65,7 +65,7 @@ Changes pushed to files in the repository are automatically pushed to the remote
 In the case of a diverged branch, you will see an error indicated at the **Mirroring repositories**
 section.
 
-### Push only protected branches **[CORE]**
+### Push only protected branches **(CORE)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/3350) in
 > [GitLab Starter](https://about.gitlab.com/pricing/) 10.3. [Moved to GitLab Core](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/18715) in 10.8.
@@ -75,7 +75,7 @@ You can choose to only push your protected branches from GitLab to your remote r
 To use this option, check the **Only mirror protected branches** box when creating a repository
 mirror.
 
-## Setting up a push mirror from GitLab to GitHub **[CORE]**
+## Setting up a push mirror from GitLab to GitHub **(CORE)**
 
 To set up a mirror from GitLab to GitHub, you need to follow these steps:
 
@@ -96,7 +96,7 @@ The repository will push soon. To force a push, click the appropriate button.
     1. Fill in **Password** field with the GitLab personal access token created on the destination GitLab instance.
     1. Click the **Mirror repository** button.
 
-## Pulling from a remote repository **[STARTER]**
+## Pulling from a remote repository **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/51) in GitLab Enterprise Edition 8.2.
 > [Added Git LFS support](https://gitlab.com/gitlab-org/gitlab-ee/issues/10871) in [GitLab Starter](https://about.gitlab.com/pricing/) 11.11.
@@ -243,7 +243,7 @@ If you need to change the key at any time, you can remove and re-add the mirror
 to generate a new key. You'll have to update the other repository with the new
 key to keep the mirror running.
 
-### Overwrite diverged branches **[STARTER]**
+### Overwrite diverged branches **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/4559) in
 > [GitLab Starter](https://about.gitlab.com/pricing/) 10.6.
@@ -256,7 +256,7 @@ For mirrored branches, enabling this option results in the loss of local changes
 
 To use this option, check the **Overwrite diverged branches** box when creating a repository mirror.
 
-### Only mirror protected branches **[STARTER]**
+### Only mirror protected branches **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/3326) in
 > [GitLab Starter](https://about.gitlab.com/pricing/) 10.3.
@@ -266,7 +266,7 @@ Non-protected branches are not mirrored and can diverge.
 
 To use this option, check the **Only mirror protected branches** box when creating a repository mirror.
 
-### Hard failure **[STARTER]**
+### Hard failure **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/3117) in
 > [GitLab Starter](https://about.gitlab.com/pricing/) 10.2.
@@ -280,7 +280,7 @@ failed. This will become visible in either the:
 When a project is hard failed, it will no longer get picked up for mirroring. A user can resume the
 project mirroring again by [Forcing an update](#forcing-an-update-core).
 
-### Trigger update using API **[STARTER]**
+### Trigger update using API **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/3453) in
 [GitLab Starter](https://about.gitlab.com/pricing/) 10.3.
@@ -291,14 +291,14 @@ updates will be pulled immediately.
 
 For more information, see [Start the pull mirroring process for a Project](../api/projects.md#start-the-pull-mirroring-process-for-a-project-starter).
 
-## Forcing an update **[CORE]**
+## Forcing an update **(CORE)**
 
 While mirrors are scheduled to update automatically, you can always force an update by using the
 update button which is available on the **Mirroring repositories** section of the **Repository Settings** page.
 
 ![Repository mirroring force update user interface](img/repository_mirroring_force_update.png)
 
-## Bidirectional mirroring **[STARTER]**
+## Bidirectional mirroring **(STARTER)**
 
 CAUTION: **Caution:**
 Bidirectional mirroring may cause conflicts.
@@ -395,7 +395,7 @@ else
 fi
 ```
 
-### Mirroring with Perforce Helix via Git Fusion **[STARTER]**
+### Mirroring with Perforce Helix via Git Fusion **(STARTER)**
 
 CAUTION: **Warning:**
 Bidirectional mirroring should not be used as a permanent configuration. Refer to
diff --git a/doc/workflow/shortcuts.md b/doc/workflow/shortcuts.md
index 5068b5d4d20..fd67ea8ce87 100644
--- a/doc/workflow/shortcuts.md
+++ b/doc/workflow/shortcuts.md
@@ -85,7 +85,7 @@ You can see GitLab's keyboard shortcuts by using <kbd>shift</kbd> + <kbd>?</kbd>
 | <kbd>]</kbd> or <kbd>j</kbd> | Move to next file |
 | <kbd>[</kbd> or <kbd>k</kbd> | Move to previous file |
 
-## Epics **[ULTIMATE]**
+## Epics **(ULTIMATE)**
 
 | Keyboard Shortcut | Description |
 | ----------------- | ----------- |
diff --git a/doc/workflow/todos.md b/doc/workflow/todos.md
index f501a222cd5..1f8900c734b 100644
--- a/doc/workflow/todos.md
+++ b/doc/workflow/todos.md
@@ -33,7 +33,7 @@ A To Do displays on your To-Do List when:
 - You are `@mentioned` in the description or comment of an:
     - Issue
     - Merge Request
-    - Epic **[ULTIMATE]**
+    - Epic **(ULTIMATE)**
 - You are `@mentioned` in a comment on a commit
 - A job in the CI pipeline running for your merge request failed, but this
   job is not allowed to fail
@@ -75,7 +75,7 @@ You can also add the following to your To-Do List by clicking the **Add a To Do*
 
 - Issue
 - Merge Request
-- Epic **[ULTIMATE]**
+- Epic **(ULTIMATE)**
 
 ![Adding a To Do from the issuable sidebar](img/todos_add_todo_sidebar.png)
 
@@ -85,7 +85,7 @@ Any action to the following will mark the corresponding To Do as done:
 
 - Issue
 - Merge Request
-- Epic **[ULTIMATE]**
+- Epic **(ULTIMATE)**
 
 Actions that dismiss To-Do items include:
 
@@ -104,7 +104,7 @@ To prevent other users from closing issues without you being notified, if someon
 
 - Issue
 - Merge request
-- Epic **[ULTIMATE]**
+- Epic **(ULTIMATE)**
 
 There is just one To Do for each of these, so mentioning a user a hundred times in an issue will only trigger one To Do.
 
@@ -119,7 +119,7 @@ You can also mark a To Do as done by clicking the **Mark as done** button in the
 
 - Issue
 - Merge Request
-- Epic **[ULTIMATE]**
+- Epic **(ULTIMATE)**
 
 ![Mark as done from the issuable sidebar](img/todos_mark_done_sidebar.png)
 
@@ -135,7 +135,7 @@ There are four kinds of filters you can use on your To-Do List.
 | Project | Filter by project |
 | Group   | Filter by group |
 | Author  | Filter by the author that triggered the To Do |
-| Type    | Filter by issue, merge request, or epic **[ULTIMATE]** |
+| Type    | Filter by issue, merge request, or epic **(ULTIMATE)** |
 | Action  | Filter by the action that triggered the To Do |
 
 You can also filter by more than one of these at the same time. The possible Actions are `Any Action`, `Assigned`, `Mentioned`, `Added`, `Pipelines`, and `Directly Addressed`, [as described above](#what-triggers-a-to-do).

From 56c129293578cb620daf1c19b1bc61cd18d9fa83 Mon Sep 17 00:00:00 2001
From: Thong Kuah <tkuah@gitlab.com>
Date: Mon, 8 Jul 2019 09:36:22 +1200
Subject: [PATCH 145/195] Add retry:0 for controller specs n+1

As a workaround for https://gitlab.com/gitlab-org/gitlab-ce/issues/64116
---
 spec/controllers/projects/merge_requests_controller_spec.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/spec/controllers/projects/merge_requests_controller_spec.rb b/spec/controllers/projects/merge_requests_controller_spec.rb
index 2a6736018ea..9878f88a395 100644
--- a/spec/controllers/projects/merge_requests_controller_spec.rb
+++ b/spec/controllers/projects/merge_requests_controller_spec.rb
@@ -878,7 +878,7 @@ describe Projects::MergeRequestsController do
         expect(control_count).to be <= 137
       end
 
-      it 'has no N+1 issues for environments', :request_store do
+      it 'has no N+1 issues for environments', :request_store, retry: 0 do
         # First run to insert test data from lets, which does take up some 30 queries
         get_ci_environments_status
 

From aeb2efaba2da5eaef150dfb21a29166d9bc27750 Mon Sep 17 00:00:00 2001
From: Natalia Tepluhina <ntepluhina@gitlab.com>
Date: Mon, 8 Jul 2019 09:49:48 +0000
Subject: [PATCH 146/195] Backported EE fix to CE

- fixed attribute to be not hyphenated
- applied parallel diffs view on CE
- separated left and right drafts
- added fallback for hasDrafts
---
 .../diffs/components/inline_diff_comment_row.vue     |  6 ++++++
 .../diffs/components/inline_diff_view.vue            |  1 +
 .../diffs/components/parallel_diff_comment_row.vue   | 12 ++++++++++++
 .../diffs/components/parallel_diff_view.vue          |  2 ++
 .../javascripts/diffs/mixins/draft_comments.js       |  2 ++
 5 files changed, 23 insertions(+)

diff --git a/app/assets/javascripts/diffs/components/inline_diff_comment_row.vue b/app/assets/javascripts/diffs/components/inline_diff_comment_row.vue
index ca3285e9afd..a06dbd70ac5 100644
--- a/app/assets/javascripts/diffs/components/inline_diff_comment_row.vue
+++ b/app/assets/javascripts/diffs/components/inline_diff_comment_row.vue
@@ -24,6 +24,11 @@ export default {
       required: false,
       default: '',
     },
+    hasDraft: {
+      type: Boolean,
+      required: false,
+      default: false,
+    },
   },
   computed: {
     className() {
@@ -55,6 +60,7 @@ export default {
           :help-page-path="helpPagePath"
         />
         <diff-discussion-reply
+          v-if="!hasDraft"
           :has-form="line.hasForm"
           :render-reply-placeholder="Boolean(line.discussions.length)"
           @showNewDiscussionForm="
diff --git a/app/assets/javascripts/diffs/components/inline_diff_view.vue b/app/assets/javascripts/diffs/components/inline_diff_view.vue
index 8c76a555b62..b2bc3d9914f 100644
--- a/app/assets/javascripts/diffs/components/inline_diff_view.vue
+++ b/app/assets/javascripts/diffs/components/inline_diff_view.vue
@@ -57,6 +57,7 @@ export default {
           :diff-file-hash="diffFile.file_hash"
           :line="line"
           :help-page-path="helpPagePath"
+          :has-draft="shouldRenderDraftRow(diffFile.file_hash, line) || false"
         />
         <inline-draft-comment-row
           v-if="shouldRenderDraftRow(diffFile.file_hash, line)"
diff --git a/app/assets/javascripts/diffs/components/parallel_diff_comment_row.vue b/app/assets/javascripts/diffs/components/parallel_diff_comment_row.vue
index c00b0e010ff..65b41b0e456 100644
--- a/app/assets/javascripts/diffs/components/parallel_diff_comment_row.vue
+++ b/app/assets/javascripts/diffs/components/parallel_diff_comment_row.vue
@@ -28,6 +28,16 @@ export default {
       required: false,
       default: '',
     },
+    hasDraftLeft: {
+      type: Boolean,
+      required: false,
+      default: false,
+    },
+    hasDraftRight: {
+      type: Boolean,
+      required: false,
+      default: false,
+    },
   },
   computed: {
     hasExpandedDiscussionOnLeft() {
@@ -121,6 +131,7 @@ export default {
         />
       </div>
       <diff-discussion-reply
+        v-if="!hasDraftLeft"
         :has-form="showLeftSideCommentForm"
         :render-reply-placeholder="shouldRenderReplyPlaceholderOnLeft"
         @showNewDiscussionForm="showNewDiscussionForm"
@@ -145,6 +156,7 @@ export default {
         />
       </div>
       <diff-discussion-reply
+        v-if="!hasDraftRight"
         :has-form="showRightSideCommentForm"
         :render-reply-placeholder="shouldRenderReplyPlaceholderOnRight"
         @showNewDiscussionForm="showNewDiscussionForm"
diff --git a/app/assets/javascripts/diffs/components/parallel_diff_view.vue b/app/assets/javascripts/diffs/components/parallel_diff_view.vue
index 41a80d99850..c477e68c33c 100644
--- a/app/assets/javascripts/diffs/components/parallel_diff_view.vue
+++ b/app/assets/javascripts/diffs/components/parallel_diff_view.vue
@@ -58,6 +58,8 @@ export default {
           :diff-file-hash="diffFile.file_hash"
           :line-index="index"
           :help-page-path="helpPagePath"
+          :has-draft-left="hasParallelDraftLeft(diffFile.file_hash, line) || false"
+          :has-draft-right="hasParallelDraftRight(diffFile.file_hash, line) || false"
         />
         <parallel-draft-comment-row
           v-if="shouldRenderParallelDraftRow(diffFile.file_hash, line)"
diff --git a/app/assets/javascripts/diffs/mixins/draft_comments.js b/app/assets/javascripts/diffs/mixins/draft_comments.js
index dfb71bf38ce..b6c9b132aeb 100644
--- a/app/assets/javascripts/diffs/mixins/draft_comments.js
+++ b/app/assets/javascripts/diffs/mixins/draft_comments.js
@@ -6,5 +6,7 @@ export default {
     imageDiscussions() {
       return this.diffFile.discussions;
     },
+    hasParallelDraftLeft: () => () => false,
+    hasParallelDraftRight: () => () => false,
   },
 };

From 4f93fa4b7d8322aa1f0b39066d65a83c9b10977e Mon Sep 17 00:00:00 2001
From: Evan Read <eread@gitlab.com>
Date: Mon, 8 Jul 2019 11:07:07 +0000
Subject: [PATCH 147/195] Add lint rule that headings must increment one level
 at a time

Also fixes instances in Markdown that broke the rule.
---
 .gitlab/ci/docs.gitlab-ci.yml                        |  2 +-
 doc/administration/high_availability/database.md     |  8 ++++----
 doc/administration/merge_request_diffs.md            | 12 ++++++------
 doc/administration/uploads.md                        |  8 ++++----
 doc/api/project_snippets.md                          |  4 ++--
 doc/api/v3_to_v4.md                                  |  4 ++--
 .../examples/end_to_end_testing_webdriverio/index.md |  8 ++++----
 doc/customization/libravatar.md                      | 12 ++++++------
 doc/development/changelog.md                         | 12 ++++++------
 doc/development/ee_features.md                       |  9 ++++-----
 doc/development/fe_guide/security.md                 |  7 ++++---
 doc/development/testing_guide/ci.md                  |  4 ++--
 doc/integration/oauth2_generic.md                    | 10 +++++-----
 13 files changed, 50 insertions(+), 50 deletions(-)

diff --git a/.gitlab/ci/docs.gitlab-ci.yml b/.gitlab/ci/docs.gitlab-ci.yml
index 6acbce6cf0c..57ee91e4385 100644
--- a/.gitlab/ci/docs.gitlab-ci.yml
+++ b/.gitlab/ci/docs.gitlab-ci.yml
@@ -68,7 +68,7 @@ docs lint:
     # Lint Markdown
     # https://github.com/markdownlint/markdownlint/blob/master/docs/RULES.md
     - bundle exec mdl content/$DOCS_GITLAB_REPO_SUFFIX/**/*.md --ignore-front-matter --rules \
-        MD004,MD032,MD034
+        MD001,MD032,MD034
     # Build HTML from Markdown
     - bundle exec nanoc
     # Check the internal links
diff --git a/doc/administration/high_availability/database.md b/doc/administration/high_availability/database.md
index 88b5aa883e8..d7acc1e7eb1 100644
--- a/doc/administration/high_availability/database.md
+++ b/doc/administration/high_availability/database.md
@@ -1109,7 +1109,7 @@ If you enable Monitoring, it must be enabled on **all** database servers.
 
 ## Troubleshooting
 
-#### Consul and PostgreSQL changes not taking effect.
+### Consul and PostgreSQL changes not taking effect.
 
 Due to the potential impacts, `gitlab-ctl reconfigure` only reloads Consul and PostgreSQL, it will not restart the services. However, not all changes can be activated by reloading.
 
@@ -1119,7 +1119,7 @@ For PostgreSQL, it is usually safe to restart the master node by default. Automa
 
 On the consul server nodes, it is important to restart the consul service in a controlled fashion. Read our [consul documentation](consul.md#restarting-the-server-cluster) for instructions on how to restart the service.
 
-#### `gitlab-ctl repmgr-check-master` command produces errors
+### `gitlab-ctl repmgr-check-master` command produces errors
 
 If this command displays errors about database permissions it is likely that something failed during
 install, resulting in the `gitlab-consul` database user getting incorrect permissions. Follow these
@@ -1134,7 +1134,7 @@ steps to fix the problem:
 
 Now there should not be errors. If errors still occur then there is another problem.
 
-#### PGBouncer error `ERROR: pgbouncer cannot connect to server`
+### PGBouncer error `ERROR: pgbouncer cannot connect to server`
 
 You may get this error when running `gitlab-rake gitlab:db:configure` or you
 may see the error in the PGBouncer log file.
@@ -1162,7 +1162,7 @@ postgresql['trust_auth_cidr_addresses'] = %w(123.123.123.123/32 <other_cidrs>)
 
 [Reconfigure GitLab] for the changes to take effect.
 
-#### Issues with other components
+### Issues with other components
 
 If you're running into an issue with a component not outlined here, be sure to check the troubleshooting section of their specific documentation page.
 
diff --git a/doc/administration/merge_request_diffs.md b/doc/administration/merge_request_diffs.md
index 65b8c0000ce..c328d4c3aaa 100644
--- a/doc/administration/merge_request_diffs.md
+++ b/doc/administration/merge_request_diffs.md
@@ -10,7 +10,7 @@ By default, merge request diffs are stored in the database, in a table named
 `merge_request_diff_files`. Larger installations may find this table grows too
 large, in which case, switching to external storage is recommended.
 
-### Using external storage
+## Using external storage
 
 Merge request diffs can be stored on disk, or in object storage. In general, it
 is better to store the diffs in the database than on disk.
@@ -46,7 +46,7 @@ To enable external storage of merge request diffs, follow the instructions below
       enabled: true
     ```
 
-1. _The external diffs will be stored in 
+1. _The external diffs will be stored in
    `/home/git/gitlab/shared/external-diffs`._ To change the path, for example,
    to `/mnt/storage/external-diffs`, edit `/home/git/gitlab/config/gitlab.yml`
    and add or amend the following lines:
@@ -59,13 +59,13 @@ To enable external storage of merge request diffs, follow the instructions below
 
 1. Save the file and [restart GitLab](restart_gitlab.md#installations-from-source) for the changes to take effect.
 
-### Using object storage
+## Using object storage
 
 Instead of storing the external diffs on disk, we recommended the use of an object
 store like AWS S3 instead. This configuration relies on valid AWS credentials to
 be configured already.
 
-### Object Storage Settings
+## Object Storage Settings
 
 For source installations, these settings are nested under `external_diffs:` and
 then `object_store:`. On Omnibus installations, they are prefixed by
@@ -80,7 +80,7 @@ then `object_store:`. On Omnibus installations, they are prefixed by
 | `proxy_download` | Set to true to enable proxying all files served. Option allows to reduce egress traffic as this allows clients to download directly from remote storage instead of proxying all data | `false` |
 | `connection` | Various connection options described below | |
 
-#### S3 compatible connection settings
+### S3 compatible connection settings
 
 The connection settings match those provided by [Fog](https://github.com/fog), and are as follows:
 
@@ -146,7 +146,7 @@ The connection settings match those provided by [Fog](https://github.com/fog), a
 
 1. Save the file and [restart GitLab](restart_gitlab.md#installations-from-source) for the changes to take effect.
 
-### Alternative in-database storage
+## Alternative in-database storage
 
 Enabling external diffs may reduce the performance of merge requests, as they
 must be retrieved in a separate operation to other data. A compromise may be
diff --git a/doc/administration/uploads.md b/doc/administration/uploads.md
index acfc0684f6d..c6103a28204 100644
--- a/doc/administration/uploads.md
+++ b/doc/administration/uploads.md
@@ -3,7 +3,7 @@
 >**Notes:**
 Uploads represent all user data that may be sent to GitLab as a single file. As an example, avatars and notes' attachments are uploads. Uploads are integral to GitLab functionality, and therefore cannot be disabled.
 
-### Using local storage
+## Using local storage
 
 >**Notes:**
 This is the default configuration
@@ -48,7 +48,7 @@ _The uploads are stored by default in
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 
-### Using object storage **(CORE ONLY)**
+## Using object storage **(CORE ONLY)**
 
 > **Notes:**
 >
@@ -60,7 +60,7 @@ If you don't want to use the local disk where GitLab is installed to store the
 uploads, you can use an object storage provider like AWS S3 instead.
 This configuration relies on valid AWS credentials to be configured already.
 
-### Object Storage Settings
+## Object Storage Settings
 
 For source installations the following settings are nested under `uploads:` and then `object_store:`. On omnibus installs they are prefixed by `uploads_object_store_`.
 
@@ -73,7 +73,7 @@ For source installations the following settings are nested under `uploads:` and
 | `proxy_download` | Set to true to enable proxying all files served. Option allows to reduce egress traffic as this allows clients to download directly from remote storage instead of proxying all data | `false` |
 | `connection` | Various connection options described below | |
 
-#### S3 compatible connection settings
+### S3 compatible connection settings
 
 The connection settings match those provided by [Fog](https://github.com/fog), and are as follows:
 
diff --git a/doc/api/project_snippets.md b/doc/api/project_snippets.md
index 2b2e40fb276..c1588f2292a 100644
--- a/doc/api/project_snippets.md
+++ b/doc/api/project_snippets.md
@@ -1,6 +1,6 @@
 # Project snippets
 
-### Snippet visibility level
+## Snippet visibility level
 
 Snippets in GitLab can be either private, internal or public.
 You can set it with the `visibility` field in the snippet.
@@ -14,7 +14,7 @@ Constants for snippet visibility levels are:
 | `public`   | The snippet can be accessed without any authentication |
 
 NOTE: **Note:**
-From July 2019, the `Internal` visibility setting is disabled for new projects, groups, 
+From July 2019, the `Internal` visibility setting is disabled for new projects, groups,
 and snippets on GitLab.com. Existing projects, groups, and snippets using the `Internal`
 visibility setting keep this setting. You can read more about the change in the
 [relevant issue](https://gitlab.com/gitlab-org/gitlab-ee/issues/12388).
diff --git a/doc/api/v3_to_v4.md b/doc/api/v3_to_v4.md
index 5752fb7c078..5f875528a6c 100644
--- a/doc/api/v3_to_v4.md
+++ b/doc/api/v3_to_v4.md
@@ -9,7 +9,7 @@ The V3 API documentation is still
 
 Below are the changes made between V3 and V4.
 
-### 8.17
+## 8.17
 
 - Removed `GET /projects/:search` (use: `GET /projects?search=x`) [!8877](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/8877)
 - `iid` filter has been removed from `GET /projects/:id/issues` [!8967](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/8967)
@@ -18,7 +18,7 @@ Below are the changes made between V3 and V4.
 - Project snippets do not return deprecated field `expires_at` [!8723](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/8723)
 - Endpoints under `GET /projects/:id/keys` have been removed (use `GET /projects/:id/deploy_keys`) [!8716](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/8716)
 
-### 9.0
+## 9.0
 
 - Status 409 returned for `POST /projects/:id/members` when a member already exists [!9093](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/9093)
 - Moved `DELETE /projects/:id/star` to `POST /projects/:id/unstar` [!9328](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/9328)
diff --git a/doc/ci/examples/end_to_end_testing_webdriverio/index.md b/doc/ci/examples/end_to_end_testing_webdriverio/index.md
index 7f1beb96bbf..38fcf05f519 100644
--- a/doc/ci/examples/end_to_end_testing_webdriverio/index.md
+++ b/doc/ci/examples/end_to_end_testing_webdriverio/index.md
@@ -32,7 +32,7 @@ through the process of setting up GitLab CI/CD for end-to-end testing Javascript
 with WebdriverIO, but the general strategy should carry over to other languages.
 We assume you are familiar with GitLab, [GitLab CI/CD](../../README.md), [Review Apps](../../review_apps/index.md), and running your app locally, e.g., on `localhost:8000`.
 
-### What to test
+## What to test
 
 In the widely-used [testing pyramid strategy](https://martinfowler.com/bliki/TestPyramid.html), end-to-end tests act more like a
 safeguard: [most of your code should be covered by
@@ -40,9 +40,9 @@ unit tests](https://vincenttunru.com/100-percent-coverage/) that allow you to ea
 will likely want to
 [limit the number of end-to-end tests](https://testing.googleblog.com/2015/04/just-say-no-to-more-end-to-end-tests.html)
 to just enough to give you the confidence that the deployment went as intended, that your
-infrastructure is up and running, and that your units of code work well together. 
+infrastructure is up and running, and that your units of code work well together.
 
-### Selenium and WebdriverIO
+## Selenium and WebdriverIO
 
 [Selenium](http://www.seleniumhq.org/) is a piece of software that can control web browsers, e.g., to make them
 visit a specific URL or interact with elements on the page. It can be programmatically controlled
@@ -65,7 +65,7 @@ describe('A visitor without account', function(){
         expect(browser.getUrl()).toMatch('page-that-does-not-exist');
 
         browser.element('.content a[href="/"]').click();
-        
+
         expect(browser.getUrl()).not.toMatch('page-that-does-not-exist');
     });
 });
diff --git a/doc/customization/libravatar.md b/doc/customization/libravatar.md
index 18aaeb5a712..e618f3be2fe 100644
--- a/doc/customization/libravatar.md
+++ b/doc/customization/libravatar.md
@@ -6,12 +6,12 @@ Libravatar is a service which delivers your avatar (profile picture) to other we
 
 This means that it is not complicated to switch to Libravatar avatar service or even self hosted Libravatar server.
 
-# Configuration
+## Configuration
 
 In [gitlab.yml gravatar section](https://gitlab.com/gitlab-org/gitlab-ce/blob/672bd3902d86b78d730cea809fce312ec49d39d7/config/gitlab.yml.example#L122) set
 the configuration options as follows:
 
-## For HTTP
+### For HTTP
 
 ```yml
   gravatar:
@@ -20,7 +20,7 @@ the configuration options as follows:
     plain_url: "http://cdn.libravatar.org/avatar/%{hash}?s=%{size}&d=identicon"
 ```
 
-## For HTTPS
+### For HTTPS
 
 ```yml
   gravatar:
@@ -29,7 +29,7 @@ the configuration options as follows:
     ssl_url: "https://seccdn.libravatar.org/avatar/%{hash}?s=%{size}&d=identicon"
 ```
 
-## Self-hosted
+### Self-hosted
 
 If you are [running your own libravatar service](https://wiki.libravatar.org/running_your_own/) the URL will be different in the configuration
 but the important part is to provide the same placeholders so GitLab can parse the URL correctly.
@@ -38,7 +38,7 @@ For example, you host a service on `http://libravatar.example.com` the `plain_ur
 
 `http://libravatar.example.com/avatar/%{hash}?s=%{size}&d=identicon`
 
-## Omnibus-gitlab example
+### Omnibus-gitlab example
 
 In `/etc/gitlab/gitlab.rb`:
 
@@ -67,7 +67,7 @@ For example, you can use `retro` set in which case the URL would look like: `pla
 
 ## Usage examples
 
-#### For Microsoft Office 365
+### For Microsoft Office 365
 
 If your users are Office 365-users, the "GetPersonaPhoto" service can be used. Note that this service requires login, so this use case is
 most useful in a corporate installation, where all users have access to Office 365.
diff --git a/doc/development/changelog.md b/doc/development/changelog.md
index f13c447fef2..3ed586f07e9 100644
--- a/doc/development/changelog.md
+++ b/doc/development/changelog.md
@@ -144,7 +144,7 @@ If you're working on the GitLab EE repository, the entry will be added to
 | [`--type`](#--type-or--t)          | `-t`      | The category of the change, valid options are: `added`, `fixed`, `changed`, `deprecated`, `removed`, `security`, `performance`, `other` |
 | `--help`          | `-h`      | Print help message                                                                                                                      |
 
-##### `--amend`
+#### `--amend`
 
 You can pass the **`--amend`** argument to automatically stage the generated
 file and amend it to the previous commit.
@@ -166,7 +166,7 @@ author:
 type:
 ```
 
-##### `--force` or `-f`
+#### `--force` or `-f`
 
 Use **`--force`** or **`-f`** to overwrite an existing changelog entry if it
 already exists.
@@ -184,7 +184,7 @@ author:
 type:
 ```
 
-##### `--merge-request` or `-m`
+#### `--merge-request` or `-m`
 
 Use the **`--merge-request`** or **`-m`** argument to provide the
 `merge_request` value:
@@ -199,7 +199,7 @@ author:
 type:
 ```
 
-##### `--dry-run` or `-n`
+#### `--dry-run` or `-n`
 
 Use the **`--dry-run`** or **`-n`** argument to prevent actually writing or
 committing anything:
@@ -216,7 +216,7 @@ type:
 $ ls changelogs/unreleased/
 ```
 
-##### `--git-username` or `-u`
+#### `--git-username` or `-u`
 
 Use the **`--git-username`** or **`-u`** argument to automatically fill in the
 `author` value with your configured Git `user.name` value:
@@ -234,7 +234,7 @@ author: Jane Doe
 type:
 ```
 
-##### `--type` or `-t`
+#### `--type` or `-t`
 
 Use the **`--type`** or **`-t`** argument to provide the `type` value:
 
diff --git a/doc/development/ee_features.md b/doc/development/ee_features.md
index 6f4a36d4066..dc17b59a9a0 100644
--- a/doc/development/ee_features.md
+++ b/doc/development/ee_features.md
@@ -446,7 +446,6 @@ The disadvantage of this:
   port `render_if_exists` to CE.
 - If we have typos in the partial name, it would be silently ignored.
 
-
 ##### Caveats
 
 The `render_if_exists` view path argument must be relative to `app/views/` and `ee/app/views`.
@@ -973,7 +972,7 @@ For regular JS files, the approach is similar.
    1. An EE file should be created with the EE only code, and it should extend the CE counterpart.
    1. For code inside functions that can't be extended, the code should be moved into a new file and we should use `ee_else_ce` helper:
 
-##### Example:
+#### Example:
 
 ```javascript
   import eeCode from 'ee_else_ce/ee_code';
@@ -1000,7 +999,7 @@ styles are usually kept in stylesheet that is common for both CE and EE, and it
 to isolate such ruleset from rest of CE rules (along with adding comment describing the same)
 to avoid conflicts during CE to EE merge.
 
-#### Bad
+### Bad
 
 ```scss
 .section-body {
@@ -1016,7 +1015,7 @@ to avoid conflicts during CE to EE merge.
 }
 ```
 
-#### Good
+### Good
 
 ```scss
 .section-body {
@@ -1034,7 +1033,7 @@ to avoid conflicts during CE to EE merge.
 // EE-specific end
 ```
 
-### Backporting changes from EE to CE
+## Backporting changes from EE to CE
 
 Until the work completed to merge the ce and ee codebases, which is tracked on [epic &802](https://gitlab.com/groups/gitlab-org/-/epics/802), there exists times in which some changes for EE require specific changes to the CE
 code base.  Examples of backports include the following:
diff --git a/doc/development/fe_guide/security.md b/doc/development/fe_guide/security.md
index 83bb449e54d..47ac87fc895 100644
--- a/doc/development/fe_guide/security.md
+++ b/doc/development/fe_guide/security.md
@@ -1,5 +1,6 @@
 # Security
-### Resources
+
+## Resources
 
 [Mozilla’s HTTP Observatory CLI][observatory-cli] and the
 [Qualys SSL Labs Server Test][qualys-ssl] are good resources for finding
@@ -56,7 +57,7 @@ Some resources on implementing Subresource Integrity:
 
 -->
 
-### Including external resources
+## Including external resources
 
 External fonts, CSS, and JavaScript should never be used with the exception of
 Google Analytics and Piwik - and only when the instance has enabled it. Assets
@@ -64,7 +65,7 @@ should always be hosted and served locally from the GitLab instance. Embedded
 resources via `iframes` should never be used except in certain circumstances
 such as with ReCaptcha, which cannot be used without an `iframe`.
 
-### Avoiding inline scripts and styles
+## Avoiding inline scripts and styles
 
 In order to protect users from [XSS vulnerabilities][xss], we will disable
 inline scripts in the future using Content Security Policy.
diff --git a/doc/development/testing_guide/ci.md b/doc/development/testing_guide/ci.md
index 7a7fca46534..87d48726268 100644
--- a/doc/development/testing_guide/ci.md
+++ b/doc/development/testing_guide/ci.md
@@ -1,6 +1,6 @@
 # GitLab tests in the Continuous Integration (CI) context
 
-### Test suite parallelization on the CI
+## Test suite parallelization on the CI
 
 Our current CI parallelization setup is as follows:
 
@@ -26,7 +26,7 @@ Our current CI parallelization setup is as follows:
 After that, the next pipeline will use the up-to-date
 `knapsack/${CI_PROJECT_NAME}/rspec_report-master.json` file.
 
-### Monitoring
+## Monitoring
 
 The GitLab test suite is [monitored] for the `master` branch, and any branch
 that includes `rspec-profile` in their name.
diff --git a/doc/integration/oauth2_generic.md b/doc/integration/oauth2_generic.md
index 3e72589ce12..3c1a0f2a117 100644
--- a/doc/integration/oauth2_generic.md
+++ b/doc/integration/oauth2_generic.md
@@ -1,7 +1,7 @@
 # Sign into GitLab with (almost) any OAuth2 provider
 
 The `omniauth-oauth2-generic` gem allows Single Sign On between GitLab and your own OAuth2 provider
-(or any OAuth2 provider compatible with this gem) 
+(or any OAuth2 provider compatible with this gem)
 
 This strategy is designed to allow configuration of the simple OmniAuth SSO process outlined below:
 
@@ -12,7 +12,7 @@ This strategy is designed to allow configuration of the simple OmniAuth SSO proc
 1. Strategy parses user information from the response, using a **configurable** format
 1. GitLab finds or creates the returned user and logs them in
 
-### Limitations of this Strategy:
+## Limitations of this Strategy:
 
 - It can only be used for Single Sign on, and will not provide any other access granted by any OAuth provider
   (importing projects or users, etc)
@@ -20,7 +20,7 @@ This strategy is designed to allow configuration of the simple OmniAuth SSO proc
 - It is not able to fetch user information from more than one URL
 - It has not been tested with user information formats other than JSON
 
-### Config Instructions
+## Config Instructions
 
 1. Register your application in the OAuth2 provider you wish to authenticate with.
 
@@ -57,9 +57,9 @@ This strategy is designed to allow configuration of the simple OmniAuth SSO proc
 
 1. Restart GitLab for the changes to take effect
 
-On the sign in page there should now be a new button below the regular sign in form. 
+On the sign in page there should now be a new button below the regular sign in form.
 Click the button to begin your provider's authentication process. This will direct
 the browser to your OAuth2 Provider's authentication page. If everything goes well
 the user will be returned to your GitLab instance and will be signed in.
 
-[1]: https://gitlab.com/satorix/omniauth-oauth2-generic#gitlab-config-example
\ No newline at end of file
+[1]: https://gitlab.com/satorix/omniauth-oauth2-generic#gitlab-config-example

From 6f315eda7ccb868a150bb8b78e3d7f0d1400655f Mon Sep 17 00:00:00 2001
From: Ezekiel Kigbo <ekigbo@gitlab.com>
Date: Mon, 8 Jul 2019 23:21:54 +1000
Subject: [PATCH 148/195] Fix - use `s__` for namespaced translations

---
 .../javascripts/boards/components/board_blank_state.vue   | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/app/assets/javascripts/boards/components/board_blank_state.vue b/app/assets/javascripts/boards/components/board_blank_state.vue
index f58149c9f7b..d8b0b60c183 100644
--- a/app/assets/javascripts/boards/components/board_blank_state.vue
+++ b/app/assets/javascripts/boards/components/board_blank_state.vue
@@ -61,7 +61,7 @@ export default {
   <div class="board-blank-state p-3">
     <p>
       {{
-        __('BoardBlankState|Add the following default lists to your Issue Board with one click:')
+        s__('BoardBlankState|Add the following default lists to your Issue Board with one click:')
       }}
     </p>
     <ul class="list-unstyled board-blank-state-list">
@@ -76,7 +76,7 @@ export default {
     </ul>
     <p>
       {{
-        __(
+        s__(
           'BoardBlankState|Starting out with the default set of lists will get you right on the way to making the most of your board.',
         )
       }}
@@ -86,10 +86,10 @@ export default {
       type="button"
       @click.stop="addDefaultLists"
     >
-      {{ __('BoardBlankState|Add default lists') }}
+      {{ s__('BoardBlankState|Add default lists') }}
     </button>
     <button class="btn btn-default btn-block" type="button" @click.stop="clearBlankState">
-      {{ __("BoardBlankState|Nevermind, I'll use my own") }}
+      {{ s__("BoardBlankState|Nevermind, I'll use my own") }}
     </button>
   </div>
 </template>

From deb6b687b7d2051c61d73901547e95e4f7a3c643 Mon Sep 17 00:00:00 2001
From: Achilleas Pipinellis <axil@gitlab.com>
Date: Mon, 8 Jul 2019 13:44:42 +0000
Subject: [PATCH 149/195] Refactor the Visual Reviews docs

Reorganize and better explain what Visual Reviews are
---
 .../review_apps/img/toolbar_feeback_form.png  | Bin 71676 -> 24599 bytes
 doc/ci/review_apps/index.md                   | 138 +++++++++++++-----
 2 files changed, 98 insertions(+), 40 deletions(-)

diff --git a/doc/ci/review_apps/img/toolbar_feeback_form.png b/doc/ci/review_apps/img/toolbar_feeback_form.png
index d147981a38754059c4577f0e7da7746b48fd7e1d..fe1c7e6e611de6ecad9106255d234852c16ec375 100644
GIT binary patch
literal 24599
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

literal 71676
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

diff --git a/doc/ci/review_apps/index.md b/doc/ci/review_apps/index.md
index c7f8792a830..9b89988bf42 100644
--- a/doc/ci/review_apps/index.md
+++ b/doc/ci/review_apps/index.md
@@ -27,7 +27,7 @@ In the above example:
 - Once the review as passed, `topic branch` is merged into `master` where it's deploy to staging.
 - After been approved in staging, the changes that were merged into `master` are deployed in to production.
 
-### How Review Apps work
+## How Review Apps work
 
 A Review App is a mapping of a branch with an [environment](../environments.md).
 Access to the Review App is made available as a link on the [merge request](../../user/project/merge_requests.md) relevant to the branch.
@@ -41,27 +41,34 @@ In this example, a branch was:
 - Successfully built.
 - Deployed under a dynamic environment that can be reached by clicking on the **View app** button.
 
+After adding Review Apps to your workflow, you follow the branched Git flow. That is:
+
+1. Push a branch and let the Runner deploy the Review App based on the `script` definition of the dynamic environment job.
+1. Wait for the Runner to build and deploy your web application.
+1. Click on the link provided in the merge request related to the branch to see the changes live.
+
 ## Configuring Review Apps
 
 Review Apps are built on [dynamic environments](../environments.md#configuring-dynamic-environments), which allow you to dynamically create a new environment for each branch.
 
 The process of configuring Review Apps is as follows:
 
-1. Set up the infrastructure to host and deploy the Review Apps.
+1. Set up the infrastructure to host and deploy the Review Apps (check the [examples](#review-apps-examples) below).
 1. [Install](https://docs.gitlab.com/runner/install/) and [configure](https://docs.gitlab.com/runner/commands/) a Runner to do deployment.
 1. Set up a job in `.gitlab-ci.yml` that uses the [predefined CI environment variable](../variables/README.md) `${CI_COMMIT_REF_NAME}` to create dynamic environments and restrict it to run only on branches.
 1. Optionally, set a job that [manually stops](../environments.md#stopping-an-environment) the Review Apps.
 
-### Examples
+## Review Apps examples
 
 The following are example projects that demonstrate Review App configuration:
 
 - [NGINX](https://gitlab.com/gitlab-examples/review-apps-nginx).
 - [OpenShift](https://gitlab.com/gitlab-examples/review-apps-openshift).
 
+<i class="fa fa-youtube-play youtube" aria-hidden="true"></i>
 See also the video [Demo: Cloud Native Development with GitLab](https://www.youtube.com/watch?v=jfIyQEwrocw), which includes a Review Apps example.
 
-### Route Maps
+## Route Maps
 
 > Introduced in GitLab 8.17. In GitLab 11.5, the file links are available in the merge request widget.
 
@@ -82,7 +89,7 @@ To set up a route map, add a a file inside the repository at `.gitlab/route-map.
 which contains a YAML array that maps `source` paths (in the repository) to `public`
 paths (on the website).
 
-#### Route Maps example
+### Route Maps example
 
 The following is an example of a route map for [Middleman](https://middlemanapp.com),
 a static site generator (SSG) used to build [GitLab's website](https://about.gitlab.com),
@@ -146,51 +153,102 @@ Once you have the route mapping set up, it will take effect in the following loc
 
     !["View on env" button in file view](img/view_on_env_blob.png)
 
-## Working with Review Apps
-
-After adding Review Apps to your workflow, you follow the branched Git flow. That is:
-
-1. Push a branch and let the Runner deploy the Review App based on the `script` definition of the dynamic environment job.
-1. Wait for the Runner to build and deploy your web application.
-1. Click on the link that provided in the merge request related to the branch to see the changes live.
-
-### Visual Reviews **(STARTER)**
+## Visual Reviews **(STARTER)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/10761) in GitLab Starter 12.0.
 
-The Visual Reviews feedback form can be added to a Review App to enable reviewers to post comments
-directly from the app back to the merge request that spawned the Review App.
+With Visual Reviews, you can provide a feedback form to your Review Apps so
+that reviewers can post comments directly from the app back to the merge request
+that spawned the Review App.
 
-For example, a form like the following can be configured to post the contents of the
-text field into the discussion thread of a merge request:
-
-![feedback form](img/toolbar_feeback_form.png)
-
-#### Using Visual Reviews
-
-If Visual Reviews has been [enabled](#configuring-visual-reviews) for the Review App, the Visual Reviews feedback form is overlaid on the app's pages at the bottom-right corner.
-
-To use the feedback form, you will need to create a [personal access token](../../user/profile/personal_access_tokens.md) with the API scope selected.
-
-Paste the token into the feedback box, when prompted. If you select **Remember me**, your browser stores the token so that future visits to Review Apps at the same URL will not require you to re-enter the token. To clear the token, click **Log out**.
-
-Because tokens must be entered on a per-domain basis and they can only be accessed once, you can save the token to your password manager specifically for the purpose of Visual Reviews. This way, you will not need to create additional tokens for each merge request.
-
-Comments can make use of all the [Markdown annotations](../../user/markdown.md)
-available in merge request comment boxes.
-
-#### Configuring Visual Reviews
+### Configuring Visual Reviews
 
 The feedback form is served through a script you add to pages in your Review App.
-To access the code to include the script, click the **Review** button in the **Pipeline** section of the merge request.
+If you have [Developer permissions](../../user/permissions.md) to the project,
+you can access it by clicking the **Review** button in the **Pipeline** section
+of the merge request.
 
 ![review button](img/review_button.png)
 
-The provided script hardcodes the project and merge request IDs. You may want to consider
-using features of your programming language to use environment variables or other
-means to inject these at runtime.
+The provided script should be added to the `<head>` of you application and
+consists of some project and merge request specific values. Here's what it
+looks like:
 
-Future enhancements [are planned](https://gitlab.com/gitlab-org/gitlab-ee/issues/11322) to make this process even easier.
+```html
+<script
+  data-project-id='11790219'
+  data-merge-request-id='1'
+  data-mr-url='https://gitlab.example.com'
+  data-project-path='sarah/review-app-tester'
+  id='review-app-toolbar-script'
+  src='https://gitlab.example.com/assets/webpack/visual_review_toolbar.js'>
+</script>
+```
+
+Ideally, you should use [environment variables](../variables/predefined_variables.md)
+to replace those values at runtime when each review app is created:
+
+- `data-project-id` is the project ID, which can be found by the `CI_PROJECT_ID`
+  variable.
+- `data-merge-request-id` is the merge request ID, which can be found by the
+  `CI_MERGE_REQUEST_IID` variable. `CI_MERGE_REQUEST_IID` is available only if
+  [`only: [merge_requests]`](../merge_request_pipelines/index.md)
+  is used and the merge request is created.
+- `data-mr-url` is the URL of the GitLab instance and will be the same for all
+  review apps.
+- `data-project-path` is the project's path, which can be found by `CI_PROJECT_PATH`.
+- `id` is always `review-app-toolbar-script`, you don't need to change that.
+- `src` is the source of the review toolbar script, which resides in the
+  respective GitLab instance and will be the same for all review apps.
+
+For example, in a Ruby application, you would need to have this script:
+
+```html
+<script
+  data-project-id="ENV['CI_PROJECT_ID']"
+  data-merge-request-id="ENV['CI_MERGE_REQUEST_IID']"
+  data-mr-url='https://gitlab.example.com'
+  data-project-path="ENV['CI_PROJECT_PATH']"
+  id='review-app-toolbar-script'
+  src='https://gitlab.example.com/assets/webpack/visual_review_toolbar.js'>
+</script>
+```
+
+Then, when your app is deployed via GitLab CI/CD, those variables should get
+replaced with their real values.
+
+NOTE: **Note:**
+Future enhancements [are planned](https://gitlab.com/gitlab-org/gitlab-ee/issues/11322)
+to make this process even easier.
+
+### Using Visual Reviews
+
+After Visual Reviews has been [enabled](#configuring-visual-reviews) for the
+Review App, the Visual Reviews feedback form is overlaid on the app's pages at
+the bottom-right corner.
+
+![Visual review feedback form](img/toolbar_feeback_form.png)
+
+To use the feedback form:
+
+1. Create a [personal access token](../../user/profile/personal_access_tokens.md)
+   with the API scope selected.
+1. Paste the token into the feedback box when prompted. If you select **Remember me**,
+   your browser stores the token so that future visits to Review Apps at the same URL
+   will not require you to re-enter the token. To clear the token, click **Log out**.
+1. Make a comment on the visual review. You can make use of all the
+   [Markdown annotations](../../user/markdown.md) that are also available in
+   merge request comments.
+1. Finally, click **Send feedback**.
+
+After you make and submit a comment in the visual review box, it will appear
+automatically in the respective merge request.
+
+TIP: **Tip:**
+Because tokens must be entered on a per-domain basis and they can only be accessed
+once, different review apps will not remember your token. You can save the token
+to your password manager specifically for the purpose of Visual Reviews. This way,
+you will not need to create additional tokens for each merge request.
 
 ## Limitations
 

From 67de299bb6018bbf460b119404fbab70f3a325c0 Mon Sep 17 00:00:00 2001
From: Fabio Pitino <fpitino@gitlab.com>
Date: Mon, 8 Jul 2019 11:18:07 +0100
Subject: [PATCH 150/195] Allow ReactiveCaching to support nil value

When :calculate_reactive_caching returns a nil value
this caused ReactiveCaching to schedule a worker
every time the code using :with_reactive_cache was called.

This issue caused an increasing amount of Sidekiq jobs
being created continuously.

Implementing this fix behind feature flag
:reactive_caching_check_key_exists
---
 app/models/concerns/reactive_caching.rb       |  6 +-
 .../allow-reactive-caching-of-nil.yml         |  5 ++
 spec/models/concerns/reactive_caching_spec.rb | 56 ++++++++++---------
 .../helpers/reactive_caching_helpers.rb       |  2 +-
 4 files changed, 40 insertions(+), 29 deletions(-)
 create mode 100644 changelogs/unreleased/allow-reactive-caching-of-nil.yml

diff --git a/app/models/concerns/reactive_caching.rb b/app/models/concerns/reactive_caching.rb
index 5b3880f94ba..d91be73d6f0 100644
--- a/app/models/concerns/reactive_caching.rb
+++ b/app/models/concerns/reactive_caching.rb
@@ -173,7 +173,11 @@ module ReactiveCaching
     end
 
     def within_reactive_cache_lifetime?(*args)
-      !!Rails.cache.read(alive_reactive_cache_key(*args))
+      if Feature.enabled?(:reactive_caching_check_key_exists, default_enabled: true)
+        Rails.cache.exist?(alive_reactive_cache_key(*args))
+      else
+        !!Rails.cache.read(alive_reactive_cache_key(*args))
+      end
     end
 
     def enqueuing_update(*args)
diff --git a/changelogs/unreleased/allow-reactive-caching-of-nil.yml b/changelogs/unreleased/allow-reactive-caching-of-nil.yml
new file mode 100644
index 00000000000..b20edd803ee
--- /dev/null
+++ b/changelogs/unreleased/allow-reactive-caching-of-nil.yml
@@ -0,0 +1,5 @@
+---
+title: Allow ReactiveCaching to support nil value
+merge_request: 30456
+author:
+type: fixed
diff --git a/spec/models/concerns/reactive_caching_spec.rb b/spec/models/concerns/reactive_caching_spec.rb
index e2ab9ddd4a5..3d026932f59 100644
--- a/spec/models/concerns/reactive_caching_spec.rb
+++ b/spec/models/concerns/reactive_caching_spec.rb
@@ -47,30 +47,12 @@ describe ReactiveCaching, :use_clean_rails_memory_store_caching do
 
     subject(:go!) { instance.result }
 
-    context 'when cache is empty' do
-      it { is_expected.to be_nil }
-
-      it 'enqueues a background worker to bootstrap the cache' do
-        expect(ReactiveCachingWorker).to receive(:perform_async).with(CacheTest, 666)
-
-        go!
-      end
-
-      it 'updates the cache lifespan' do
-        expect(reactive_cache_alive?(instance)).to be_falsy
-
-        go!
-
-        expect(reactive_cache_alive?(instance)).to be_truthy
-      end
-    end
-
-    context 'when the cache is full' do
+    shared_examples 'a cacheable value' do |cached_value|
       before do
-        stub_reactive_cache(instance, 4)
+        stub_reactive_cache(instance, cached_value)
       end
 
-      it { is_expected.to eq(4) }
+      it { is_expected.to eq(cached_value) }
 
       it 'does not enqueue a background worker' do
         expect(ReactiveCachingWorker).not_to receive(:perform_async)
@@ -90,9 +72,7 @@ describe ReactiveCaching, :use_clean_rails_memory_store_caching do
         end
 
         it { is_expected.to be_nil }
-      end
 
-      context 'when cache was invalidated' do
         it 'refreshes cache' do
           expect(ReactiveCachingWorker).to receive(:perform_async).with(CacheTest, 666)
 
@@ -101,12 +81,34 @@ describe ReactiveCaching, :use_clean_rails_memory_store_caching do
       end
     end
 
-    context 'when cache contains non-nil but blank value' do
-      before do
-        stub_reactive_cache(instance, false)
+    context 'when cache is empty' do
+      it { is_expected.to be_nil }
+
+      it 'enqueues a background worker to bootstrap the cache' do
+        expect(ReactiveCachingWorker).to receive(:perform_async).with(CacheTest, 666)
+
+        go!
       end
 
-      it { is_expected.to eq(false) }
+      it 'updates the cache lifespan' do
+        expect(reactive_cache_alive?(instance)).to be_falsy
+
+        go!
+
+        expect(reactive_cache_alive?(instance)).to be_truthy
+      end
+    end
+
+    context 'when the cache is full' do
+      it_behaves_like 'a cacheable value', 4
+    end
+
+    context 'when the cache contains non-nil but blank value' do
+      it_behaves_like 'a cacheable value', false
+    end
+
+    context 'when the cache contains nil value' do
+      it_behaves_like 'a cacheable value', nil
     end
   end
 
diff --git a/spec/support/helpers/reactive_caching_helpers.rb b/spec/support/helpers/reactive_caching_helpers.rb
index b76b53db0b9..528da37e8cf 100644
--- a/spec/support/helpers/reactive_caching_helpers.rb
+++ b/spec/support/helpers/reactive_caching_helpers.rb
@@ -10,7 +10,7 @@ module ReactiveCachingHelpers
   def stub_reactive_cache(subject = nil, data = nil, *qualifiers)
     allow(ReactiveCachingWorker).to receive(:perform_async)
     allow(ReactiveCachingWorker).to receive(:perform_in)
-    write_reactive_cache(subject, data, *qualifiers) unless data.nil?
+    write_reactive_cache(subject, data, *qualifiers) unless subject.nil?
   end
 
   def synchronous_reactive_cache(subject)

From ec39a1d63d8a7952930442165f1ad828939749b2 Mon Sep 17 00:00:00 2001
From: Mayra Cabrera <mcabrera@gitlab.com>
Date: Mon, 8 Jul 2019 15:06:05 +0000
Subject: [PATCH 151/195] Schedule namespace aggregation in other contexts

Schedules a Namespace::AggregationSchedule worker if some of the project
statistics are refreshed.

The worker is only executed if the feature flag is enabled.
---
 app/models/project_statistics.rb          | 25 +++++++++++--
 spec/models/project_statistics_spec.rb    | 43 +++++++++++++++++++++++
 spec/workers/project_cache_worker_spec.rb | 14 ++++++++
 3 files changed, 80 insertions(+), 2 deletions(-)

diff --git a/app/models/project_statistics.rb b/app/models/project_statistics.rb
index 8a179b4d56d..3802d258664 100644
--- a/app/models/project_statistics.rb
+++ b/app/models/project_statistics.rb
@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 class ProjectStatistics < ApplicationRecord
+  include AfterCommitQueue
+
   belongs_to :project
   belongs_to :namespace
 
@@ -15,6 +17,7 @@ class ProjectStatistics < ApplicationRecord
 
   COLUMNS_TO_REFRESH = [:repository_size, :wiki_size, :lfs_objects_size, :commit_count].freeze
   INCREMENTABLE_COLUMNS = { build_artifacts_size: %i[storage_size], packages_size: %i[storage_size] }.freeze
+  NAMESPACE_RELATABLE_COLUMNS = [:repository_size, :wiki_size, :lfs_objects_size].freeze
 
   scope :for_project_ids, ->(project_ids) { where(project_id: project_ids) }
 
@@ -22,13 +25,17 @@ class ProjectStatistics < ApplicationRecord
     repository_size + lfs_objects_size
   end
 
-  def refresh!(only: nil)
+  def refresh!(only: [])
     COLUMNS_TO_REFRESH.each do |column, generator|
-      if only.blank? || only.include?(column)
+      if only.empty? || only.include?(column)
         public_send("update_#{column}") # rubocop:disable GitlabSecurity/PublicSend
       end
     end
 
+    if only.empty? || only.any? { |column| NAMESPACE_RELATABLE_COLUMNS.include?(column) }
+      schedule_namespace_aggregation_worker
+    end
+
     save!
   end
 
@@ -81,4 +88,18 @@ class ProjectStatistics < ApplicationRecord
 
     update_all(updates.join(', '))
   end
+
+  private
+
+  def schedule_namespace_aggregation_worker
+    run_after_commit do
+      next unless schedule_aggregation_worker?
+
+      Namespaces::ScheduleAggregationWorker.perform_async(project.namespace_id)
+    end
+  end
+
+  def schedule_aggregation_worker?
+    Feature.enabled?(:update_statistics_namespace, project&.root_ancestor)
+  end
 end
diff --git a/spec/models/project_statistics_spec.rb b/spec/models/project_statistics_spec.rb
index 1cb49d83ffa..db3e4902c64 100644
--- a/spec/models/project_statistics_spec.rb
+++ b/spec/models/project_statistics_spec.rb
@@ -135,6 +135,49 @@ describe ProjectStatistics do
         expect(statistics.wiki_size).to eq(0)
       end
     end
+
+    context 'when the column is namespace relatable' do
+      let(:namespace) { create(:group) }
+      let(:project) { create(:project, namespace: namespace) }
+
+      context 'when the feature flag is off' do
+        it 'does not schedule the aggregation worker' do
+          stub_feature_flags(update_statistics_namespace: false, namespace: namespace)
+
+          expect(Namespaces::ScheduleAggregationWorker)
+            .not_to receive(:perform_async)
+
+          statistics.refresh!(only: [:lfs_objects_size])
+        end
+      end
+
+      context 'when the feature flag is on' do
+        it 'schedules the aggregation worker' do
+          expect(Namespaces::ScheduleAggregationWorker)
+            .to receive(:perform_async)
+
+          statistics.refresh!(only: [:lfs_objects_size])
+        end
+      end
+
+      context 'when no argument is passed' do
+        it 'schedules the aggregation worker' do
+          expect(Namespaces::ScheduleAggregationWorker)
+            .to receive(:perform_async)
+
+          statistics.refresh!
+        end
+      end
+    end
+
+    context 'when the column is not namespace relatable' do
+      it 'does not schedules an aggregation worker' do
+        expect(Namespaces::ScheduleAggregationWorker)
+          .not_to receive(:perform_async)
+
+        statistics.refresh!(only: [:commit_count])
+      end
+    end
   end
 
   describe '#update_commit_count' do
diff --git a/spec/workers/project_cache_worker_spec.rb b/spec/workers/project_cache_worker_spec.rb
index 51afb076da1..edc55920b8e 100644
--- a/spec/workers/project_cache_worker_spec.rb
+++ b/spec/workers/project_cache_worker_spec.rb
@@ -36,6 +36,11 @@ describe ProjectCacheWorker do
     end
 
     context 'with an existing project' do
+      before do
+        lease_key = "namespace:namespaces_root_statistics:#{project.namespace_id}"
+        stub_exclusive_lease_taken(lease_key, timeout: Namespace::AggregationSchedule::DEFAULT_LEASE_TIMEOUT)
+      end
+
       it 'refreshes the method caches' do
         expect_any_instance_of(Repository).to receive(:refresh_method_caches)
           .with(%i(readme))
@@ -81,6 +86,10 @@ describe ProjectCacheWorker do
 
         expect(UpdateProjectStatisticsWorker).not_to receive(:perform_in)
 
+        expect(Namespaces::ScheduleAggregationWorker)
+          .not_to receive(:perform_async)
+          .with(project.namespace_id)
+
         worker.update_statistics(project, statistics)
       end
     end
@@ -98,6 +107,11 @@ describe ProjectCacheWorker do
           .with(lease_timeout, project.id, statistics)
           .and_call_original
 
+        expect(Namespaces::ScheduleAggregationWorker)
+          .to receive(:perform_async)
+          .with(project.namespace_id)
+          .twice
+
         worker.update_statistics(project, statistics)
       end
     end

From 77ff2249e42c1c5261c120d711ae4b6bd33c0789 Mon Sep 17 00:00:00 2001
From: Mike Lewis <mlewis@gitlab.com>
Date: Mon, 8 Jul 2019 15:44:50 +0000
Subject: [PATCH 152/195] Fix docs URL in trigger-build-docs puts text

---
 scripts/trigger-build-docs | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/scripts/trigger-build-docs b/scripts/trigger-build-docs
index dfc8ee6050a..0fc8f6fbd4b 100755
--- a/scripts/trigger-build-docs
+++ b/scripts/trigger-build-docs
@@ -105,8 +105,8 @@ def trigger_pipeline
   puts ""
   puts app_url
   puts ""
-  puts "=> For more information, read the documentation"
-  puts "=> https://docs.gitlab.com/ee/development/writing_documentation.html#previewing-the-changes-live"
+  puts "=> For more information, see the documentation"
+  puts "=> https://docs.gitlab.com/ee/development/documentation/index.html#previewing-the-changes-live"
   puts ""
   puts "=> If something doesn't work, drop a line in the #docs chat channel."
   puts ""

From 8ae165e6e7e63135077ebfccaf2762cde14e1fa6 Mon Sep 17 00:00:00 2001
From: Stan Hu <stanhu@gmail.com>
Date: Mon, 8 Jul 2019 10:48:02 -0700
Subject: [PATCH 153/195] Bump prometheus-client-mmap to 0.9.8

This fixes a critical error where a nil exception would be hit
if an error occurred while logging a Prometheus metric:

https://gitlab.com/gitlab-org/prometheus-client-mmap/merge_requests/36
---
 Gemfile      | 2 +-
 Gemfile.lock | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/Gemfile b/Gemfile
index f65549f2734..f567eac3ee0 100644
--- a/Gemfile
+++ b/Gemfile
@@ -309,7 +309,7 @@ group :metrics do
   gem 'influxdb', '~> 0.2', require: false
 
   # Prometheus
-  gem 'prometheus-client-mmap', '~> 0.9.7'
+  gem 'prometheus-client-mmap', '~> 0.9.8'
   gem 'raindrops', '~> 0.18'
 end
 
diff --git a/Gemfile.lock b/Gemfile.lock
index c1deaa74e1f..668cfff4fb4 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -652,7 +652,7 @@ GEM
       parser
       unparser
     procto (0.0.3)
-    prometheus-client-mmap (0.9.7)
+    prometheus-client-mmap (0.9.8)
     pry (0.11.3)
       coderay (~> 1.1.0)
       method_source (~> 0.9.0)
@@ -1173,7 +1173,7 @@ DEPENDENCIES
   peek-redis (~> 1.2.0)
   pg (~> 1.1)
   premailer-rails (~> 1.9.7)
-  prometheus-client-mmap (~> 0.9.7)
+  prometheus-client-mmap (~> 0.9.8)
   pry-byebug (~> 3.5.1)
   pry-rails (~> 0.3.4)
   puma (~> 3.12)

From 020289fa27adb2cd1fee3823994aad8b4e9f88a3 Mon Sep 17 00:00:00 2001
From: Fabio Pitino <fpitino@gitlab.com>
Date: Mon, 8 Jul 2019 19:26:20 +0100
Subject: [PATCH 154/195] Change changelog type to performance

---
 changelogs/unreleased/allow-reactive-caching-of-nil.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/changelogs/unreleased/allow-reactive-caching-of-nil.yml b/changelogs/unreleased/allow-reactive-caching-of-nil.yml
index b20edd803ee..abd88c09d74 100644
--- a/changelogs/unreleased/allow-reactive-caching-of-nil.yml
+++ b/changelogs/unreleased/allow-reactive-caching-of-nil.yml
@@ -2,4 +2,4 @@
 title: Allow ReactiveCaching to support nil value
 merge_request: 30456
 author:
-type: fixed
+type: performance

From 9f677359a78c78bce702411c4a0da5d7f3f429d6 Mon Sep 17 00:00:00 2001
From: Robert Speicher <rspeicher@gmail.com>
Date: Mon, 8 Jul 2019 14:46:34 -0500
Subject: [PATCH 155/195] Add EE-only initializers

These files are only used by EE, and are now wrapped in `Gitlab.ee`
blocks for file parity.
---
 config/initializers/0_license.rb            | 19 ++++++++
 config/initializers/elastic_client_setup.rb | 48 +++++++++++++++++++++
 config/initializers/geo.rb                  | 15 +++++++
 config/initializers/load_balancing.rb       | 23 ++++++++++
 config/initializers/sidekiq_cluster.rb      | 18 ++++++++
 5 files changed, 123 insertions(+)
 create mode 100644 config/initializers/0_license.rb
 create mode 100644 config/initializers/elastic_client_setup.rb
 create mode 100644 config/initializers/geo.rb
 create mode 100644 config/initializers/load_balancing.rb
 create mode 100644 config/initializers/sidekiq_cluster.rb

diff --git a/config/initializers/0_license.rb b/config/initializers/0_license.rb
new file mode 100644
index 00000000000..c4f9a2bc74e
--- /dev/null
+++ b/config/initializers/0_license.rb
@@ -0,0 +1,19 @@
+require_dependency 'lib/gitlab'
+
+Gitlab.ee do
+  begin
+    public_key_file = File.read(Rails.root.join(".license_encryption_key.pub"))
+    public_key = OpenSSL::PKey::RSA.new(public_key_file)
+    Gitlab::License.encryption_key = public_key
+  rescue
+    warn "WARNING: No valid license encryption key provided."
+  end
+
+  # Needed to run migration
+  if ActiveRecord::Base.connected? && ActiveRecord::Base.connection.data_source_exists?('licenses')
+    message = LicenseHelper.license_message(signed_in: true, is_admin: true, in_html: false)
+    if ::License.block_changes? && message.present?
+      warn "WARNING: #{message}"
+    end
+  end
+end
diff --git a/config/initializers/elastic_client_setup.rb b/config/initializers/elastic_client_setup.rb
new file mode 100644
index 00000000000..0f6d494ba3c
--- /dev/null
+++ b/config/initializers/elastic_client_setup.rb
@@ -0,0 +1,48 @@
+# Be sure to restart your server when you modify this file.
+
+require 'gitlab/current_settings'
+
+Gitlab.ee do
+  Elasticsearch::Model::Response::Records.prepend GemExtensions::Elasticsearch::Model::Response::Records
+  Elasticsearch::Model::Adapter::Multiple::Records.prepend GemExtensions::Elasticsearch::Model::Adapter::Multiple::Records
+  Elasticsearch::Model::Indexing::InstanceMethods.prepend GemExtensions::Elasticsearch::Model::Indexing::InstanceMethods
+
+  module Elasticsearch
+    module Model
+      module Client
+        # This mutex is only used to synchronize *creation* of a new client, so
+        # all including classes can share the same client instance
+        CLIENT_MUTEX = Mutex.new
+
+        cattr_accessor :cached_client
+        cattr_accessor :cached_config
+
+        module ClassMethods
+          # Override the default ::Elasticsearch::Model::Client implementation to
+          # return a client configured from application settings. All including
+          # classes will use the same instance, which is refreshed automatically
+          # if the settings change.
+          #
+          # _client is present to match the arity of the overridden method, where
+          # it is also not used.
+          #
+          # @return [Elasticsearch::Transport::Client]
+          def client(_client = nil)
+            store = ::Elasticsearch::Model::Client
+
+            store::CLIENT_MUTEX.synchronize do
+              config = Gitlab::CurrentSettings.elasticsearch_config
+
+              if store.cached_client.nil? || config != store.cached_config
+                store.cached_client = ::Gitlab::Elastic::Client.build(config)
+                store.cached_config = config
+              end
+            end
+
+            store.cached_client
+          end
+        end
+      end
+    end
+  end
+end
diff --git a/config/initializers/geo.rb b/config/initializers/geo.rb
new file mode 100644
index 00000000000..b820f629d92
--- /dev/null
+++ b/config/initializers/geo.rb
@@ -0,0 +1,15 @@
+Gitlab.ee do
+  if File.exist?(Rails.root.join('config/database_geo.yml'))
+    Rails.application.configure do
+      config.geo_database = config_for(:database_geo)
+    end
+  end
+
+  begin
+    if Gitlab::Geo.connected? && Gitlab::Geo.primary?
+      Gitlab::Geo.current_node&.update_clone_url!
+    end
+  rescue => e
+    warn "WARNING: Unable to check/update clone_url_prefix for Geo: #{e}"
+  end
+end
diff --git a/config/initializers/load_balancing.rb b/config/initializers/load_balancing.rb
new file mode 100644
index 00000000000..1ac422a6e8a
--- /dev/null
+++ b/config/initializers/load_balancing.rb
@@ -0,0 +1,23 @@
+# We need to run this initializer after migrations are done so it doesn't fail on CI
+
+Gitlab.ee do
+  if ActiveRecord::Base.connected? && ActiveRecord::Base.connection.data_source_exists?('licenses')
+    if Gitlab::Database::LoadBalancing.enable?
+      Gitlab::Database.disable_prepared_statements
+
+      Gitlab::Application.configure do |config|
+        config.middleware.use(Gitlab::Database::LoadBalancing::RackMiddleware)
+      end
+
+      Gitlab::Database::LoadBalancing.configure_proxy
+
+      # This needs to be executed after fork of clustered processes
+      Gitlab::Cluster::LifecycleEvents.on_worker_start do
+        # Service discovery must be started after configuring the proxy, as service
+        # discovery depends on this.
+        Gitlab::Database::LoadBalancing.start_service_discovery
+      end
+
+    end
+  end
+end
diff --git a/config/initializers/sidekiq_cluster.rb b/config/initializers/sidekiq_cluster.rb
new file mode 100644
index 00000000000..cbf8caef706
--- /dev/null
+++ b/config/initializers/sidekiq_cluster.rb
@@ -0,0 +1,18 @@
+if ENV['ENABLE_SIDEKIQ_CLUSTER'] && Gitlab.ee?
+  Thread.new do
+    Thread.current.abort_on_exception = true
+
+    parent = Process.ppid
+
+    loop do
+      sleep(5)
+
+      # In cluster mode it's possible that the master process is SIGKILL'd. In
+      # this case the parent PID changes and we need to terminate ourselves.
+      if Process.ppid != parent
+        Process.kill(:TERM, Process.pid)
+        break
+      end
+    end
+  end
+end

From 3d12f07331f8031748bdd281993c490d3edfd6da Mon Sep 17 00:00:00 2001
From: Robert Speicher <rspeicher@gmail.com>
Date: Mon, 8 Jul 2019 14:47:16 -0500
Subject: [PATCH 156/195] CE-EE parity for files in config/initializers

---
 config/initializers/1_settings.rb      |  1 +
 config/initializers/console_message.rb | 13 +++++++++++--
 config/initializers/health_check.rb    |  6 ++++++
 config/initializers/sidekiq.rb         | 13 +++++++++++++
 4 files changed, 31 insertions(+), 2 deletions(-)

diff --git a/config/initializers/1_settings.rb b/config/initializers/1_settings.rb
index bf187e9a282..0b8a6607250 100644
--- a/config/initializers/1_settings.rb
+++ b/config/initializers/1_settings.rb
@@ -76,6 +76,7 @@ Gitlab.ee do
   Settings['smartcard'] ||= Settingslogic.new({})
   Settings.smartcard['enabled'] = false if Settings.smartcard['enabled'].nil?
   Settings.smartcard['client_certificate_required_port'] = 3444 if Settings.smartcard['client_certificate_required_port'].nil?
+  Settings.smartcard['required_for_git_access'] = false if Settings.smartcard['required_for_git_access'].nil?
 end
 
 Settings['omniauth'] ||= Settingslogic.new({})
diff --git a/config/initializers/console_message.rb b/config/initializers/console_message.rb
index 05eb395028d..04c109aa844 100644
--- a/config/initializers/console_message.rb
+++ b/config/initializers/console_message.rb
@@ -2,9 +2,18 @@
 if defined?(Rails::Console)
   # note that this will not print out when using `spring`
   justify = 15
-  puts "-------------------------------------------------------------------------------------"
+
+  puts '-' * 80
   puts " GitLab:".ljust(justify) + "#{Gitlab::VERSION} (#{Gitlab.revision})"
   puts " GitLab Shell:".ljust(justify) + "#{Gitlab::VersionInfo.parse(Gitlab::Shell.new.version)}"
   puts " #{Gitlab::Database.human_adapter_name}:".ljust(justify) + Gitlab::Database.version
-  puts "-------------------------------------------------------------------------------------"
+
+  Gitlab.ee do
+    if Gitlab::Geo.enabled?
+      puts " Geo enabled:".ljust(justify) + 'yes'
+      puts " Geo server:".ljust(justify) + EE::GeoHelper.current_node_human_status
+    end
+  end
+
+  puts '-' * 80
 end
diff --git a/config/initializers/health_check.rb b/config/initializers/health_check.rb
index 959daa93f78..9f466dc39de 100644
--- a/config/initializers/health_check.rb
+++ b/config/initializers/health_check.rb
@@ -1,4 +1,10 @@
 HealthCheck.setup do |config|
   config.standard_checks = %w(database migrations cache)
   config.full_checks = %w(database migrations cache)
+
+  Gitlab.ee do
+    config.add_custom_check('geo') do
+      Gitlab::Geo::HealthCheck.new.perform_checks
+    end
+  end
 end
diff --git a/config/initializers/sidekiq.rb b/config/initializers/sidekiq.rb
index 7b69cf11288..f9ef5d66bfa 100644
--- a/config/initializers/sidekiq.rb
+++ b/config/initializers/sidekiq.rb
@@ -85,6 +85,19 @@ Sidekiq.configure_server do |config|
   ActiveRecord::Base.establish_connection(db_config)
   Rails.logger.debug("Connection Pool size for Sidekiq Server is now: #{ActiveRecord::Base.connection.pool.instance_variable_get('@size')}")
 
+  Gitlab.ee do
+    Gitlab::Mirror.configure_cron_job!
+
+    Gitlab::Geo.configure_cron_jobs!
+
+    if Gitlab::Geo.geo_database_configured?
+      Rails.configuration.geo_database['pool'] = Sidekiq.options[:concurrency]
+      Geo::TrackingBase.establish_connection(Rails.configuration.geo_database)
+
+      Rails.logger.debug("Connection Pool size for Sidekiq Server is now: #{Geo::TrackingBase.connection_pool.size} (Geo tracking database)")
+    end
+  end
+
   # Avoid autoload issue such as 'Mail::Parsers::AddressStruct'
   # https://github.com/mikel/mail/issues/912#issuecomment-214850355
   Mail.eager_autoload!

From bda379c51e4b002abb488bbe8bb7978841b37191 Mon Sep 17 00:00:00 2001
From: ddavison <ddavison@gitlab.com>
Date: Fri, 5 Jul 2019 13:52:20 -0700
Subject: [PATCH 157/195] Disable parts of the AutoDevOps Pipeline

Jobs Disabled: Code-Quality, DAST, Container-Scanning,
Dependency-Scanning, License-Management, SAST

Jobs still enabled: Build, Test, Deploy, Browser-Performance-Testing
---
 .../create_project_with_auto_devops_spec.rb   | 55 ++++++++++++++++---
 1 file changed, 47 insertions(+), 8 deletions(-)

diff --git a/qa/qa/specs/features/browser_ui/7_configure/auto_devops/create_project_with_auto_devops_spec.rb b/qa/qa/specs/features/browser_ui/7_configure/auto_devops/create_project_with_auto_devops_spec.rb
index 5ca9ddb6b19..99f0838b864 100644
--- a/qa/qa/specs/features/browser_ui/7_configure/auto_devops/create_project_with_auto_devops_spec.rb
+++ b/qa/qa/specs/features/browser_ui/7_configure/auto_devops/create_project_with_auto_devops_spec.rb
@@ -9,6 +9,52 @@ module QA
       Page::Main::Login.perform(&:sign_in_using_credentials)
     end
 
+    def disable_optional_jobs(project)
+      # Disable code_quality check in Auto DevOps pipeline as it takes
+      # too long and times out the test
+      Resource::CiVariable.fabricate_via_api! do |resource|
+        resource.project = project
+        resource.key = 'CODE_QUALITY_DISABLED'
+        resource.value = '1'
+        resource.masked = false
+      end
+
+      Resource::CiVariable.fabricate_via_api! do |resource|
+        resource.project = project
+        resource.key = 'LICENSE_MANAGEMENT_DISABLED'
+        resource.value = '1'
+        resource.masked = false
+      end
+
+      Resource::CiVariable.fabricate_via_api! do |resource|
+        resource.project = project
+        resource.key = 'SAST_DISABLED'
+        resource.value = '1'
+        resource.masked = false
+      end
+
+      Resource::CiVariable.fabricate_via_api! do |resource|
+        resource.project = project
+        resource.key = 'DEPENDENCY_SCANNING_DISABLED'
+        resource.value = '1'
+        resource.masked = false
+      end
+
+      Resource::CiVariable.fabricate_via_api! do |resource|
+        resource.project = project
+        resource.key = 'CONTAINER_SCANNING_DISABLED'
+        resource.value = '1'
+        resource.masked = false
+      end
+
+      Resource::CiVariable.fabricate_via_api! do |resource|
+        resource.project = project
+        resource.key = 'DAST_DISABLED'
+        resource.value = '1'
+        resource.masked = false
+      end
+    end
+
     # Failure issue: https://gitlab.com/gitlab-org/quality/nightly/issues/108
     describe 'Auto DevOps support', :orchestrated, :kubernetes, :quarantine do
       context 'when rbac is enabled' do
@@ -28,14 +74,7 @@ module QA
             p.description = 'Project with Auto DevOps'
           end
 
-          # Disable code_quality check in Auto DevOps pipeline as it takes
-          # too long and times out the test
-          Resource::CiVariable.fabricate! do |resource|
-            resource.project = @project
-            resource.key = 'CODE_QUALITY_DISABLED'
-            resource.value = '1'
-            resource.masked = false
-          end
+          disable_optional_jobs(@project)
 
           # Set an application secret CI variable (prefixed with K8S_SECRET_)
           Resource::CiVariable.fabricate! do |resource|

From 00780264a7f8eaaf304c22aaa481e1942ced05cd Mon Sep 17 00:00:00 2001
From: Cindy Pallares <cindy@gitlab.com>
Date: Mon, 8 Jul 2019 17:24:54 -0500
Subject: [PATCH 158/195] Update the installation link

The installation link has changed from /installation/ to /install/. This
commit will update all the remaining links that are missing.
---
 doc/administration/geo/replication/index.md           | 2 +-
 doc/administration/geo/replication/security_review.md | 2 +-
 doc/administration/gitaly/index.md                    | 8 ++++----
 doc/administration/high_availability/database.md      | 4 ++--
 doc/administration/high_availability/redis.md         | 6 +++---
 doc/administration/index.md                           | 2 +-
 doc/development/code_review.md                        | 2 +-
 doc/downgrade_ee_to_ce/README.md                      | 2 +-
 doc/install/google_cloud_platform/index.md            | 2 +-
 doc/install/requirements.md                           | 2 +-
 doc/intro/README.md                                   | 2 +-
 doc/university/support/README.md                      | 2 +-
 12 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/doc/administration/geo/replication/index.md b/doc/administration/geo/replication/index.md
index 5cfa6bcae56..f0d329d5296 100644
--- a/doc/administration/geo/replication/index.md
+++ b/doc/administration/geo/replication/index.md
@@ -178,7 +178,7 @@ The steps below should be followed in the order they appear. **Make sure the Git
 
 If you installed GitLab using the Omnibus packages (highly recommended):
 
-1. [Install GitLab Enterprise Edition](https://about.gitlab.com/installation/) on the server that will serve as the **secondary** node. Do not create an account or log in to the new **secondary** node.
+1. [Install GitLab Enterprise Edition](https://about.gitlab.com/install/) on the server that will serve as the **secondary** node. Do not create an account or log in to the new **secondary** node.
 1. [Upload the GitLab License](../../../user/admin_area/license.md) on the **primary** node to unlock Geo. The license must be for [GitLab Premium](https://about.gitlab.com/pricing/) or higher.
 1. [Set up the database replication](database.md) (`primary (read-write) <-> secondary (read-only)` topology).
 1. [Configure fast lookup of authorized SSH keys in the database](../../operations/fast_ssh_key_lookup.md). This step is required and needs to be done on **both** the **primary** and **secondary** nodes.
diff --git a/doc/administration/geo/replication/security_review.md b/doc/administration/geo/replication/security_review.md
index 7c21a348e23..ed3f1faa93e 100644
--- a/doc/administration/geo/replication/security_review.md
+++ b/doc/administration/geo/replication/security_review.md
@@ -115,7 +115,7 @@ questions from [owasp.org](https://www.owasp.org).
 ### What operating systems support the application?
 
 - Geo imposes no additional restrictions on operating system (see the
-  [GitLab installation](https://about.gitlab.com/installation/) page for more
+  [GitLab installation](https://about.gitlab.com/install/) page for more
   details), however we recommend using the operating systems listed in the [Geo documentation](index.md#requirements-for-running-geo).
 
 ### What details regarding required OS components and lock‐down needs have been defined?
diff --git a/doc/administration/gitaly/index.md b/doc/administration/gitaly/index.md
index b98383f30fc..4407facfca9 100644
--- a/doc/administration/gitaly/index.md
+++ b/doc/administration/gitaly/index.md
@@ -91,7 +91,7 @@ your GitLab installation has two repository storages, `default` and
 
 First install Gitaly using either Omnibus or from source.
 
-Omnibus: [Download/install](https://about.gitlab.com/installation) the Omnibus GitLab
+Omnibus: [Download/install](https://about.gitlab.com/install/) the Omnibus GitLab
 package you want using **steps 1 and 2** from the GitLab downloads page but
 **_do not_** provide the `EXTERNAL_URL=` value.
 
@@ -220,7 +220,7 @@ network, firewall, or name resolution problem preventing your GitLab
 server from reaching the Gitaly server then all Gitaly requests will
 fail.
 
-Additionally, you need to 
+Additionally, you need to
 [disable Rugged if previously manually enabled](../high_availability/nfs.md#improving-nfs-performance-with-gitlab).
 
 We assume that your Gitaly server can be reached at
@@ -436,8 +436,8 @@ particular machine.
 
 ## Eliminating NFS altogether
 
-If you are planning to use Gitaly without NFS for your storage needs 
-and want to eliminate NFS from your environment altogether, there are 
+If you are planning to use Gitaly without NFS for your storage needs
+and want to eliminate NFS from your environment altogether, there are
 a few things that you need to do:
 
  1. Make sure the [`git` user home directory](https://docs.gitlab.com/omnibus/settings/configuration.html#moving-the-home-directory-for-a-user) is on local disk.
diff --git a/doc/administration/high_availability/database.md b/doc/administration/high_availability/database.md
index d7acc1e7eb1..61432f57a77 100644
--- a/doc/administration/high_availability/database.md
+++ b/doc/administration/high_availability/database.md
@@ -31,7 +31,7 @@ deploy the bundled PostgreSQL.
 ### Standalone PostgreSQL using GitLab Omnibus **(CORE ONLY)**
 
 1. SSH into the PostgreSQL server.
-1. [Download/install](https://about.gitlab.com/installation) the Omnibus GitLab
+1. [Download/install](https://about.gitlab.com/install/) the Omnibus GitLab
    package you want using **steps 1 and 2** from the GitLab downloads page.
      - Do not complete any other steps on the download page.
 1. Generate a password hash for PostgreSQL. This assumes you will use the default
@@ -281,7 +281,7 @@ Few notes on the service itself:
 
 #### Installing Omnibus GitLab
 
-First, make sure to [download/install](https://about.gitlab.com/installation)
+First, make sure to [download/install](https://about.gitlab.com/install/)
 GitLab Omnibus **on each node**.
 
 Make sure you install the necessary dependencies from step 1,
diff --git a/doc/administration/high_availability/redis.md b/doc/administration/high_availability/redis.md
index 984c9688cdf..27310c59755 100644
--- a/doc/administration/high_availability/redis.md
+++ b/doc/administration/high_availability/redis.md
@@ -41,7 +41,7 @@ The steps below are the minimum necessary to configure a Redis server with
 Omnibus:
 
 1. SSH into the Redis server.
-1. [Download/install](https://about.gitlab.com/installation) the Omnibus GitLab
+1. [Download/install](https://about.gitlab.com/install/) the Omnibus GitLab
    package you want using **steps 1 and 2** from the GitLab downloads page.
      - Do not complete any other steps on the download page.
 
@@ -357,7 +357,7 @@ The prerequisites for a HA Redis setup are the following:
 ### Step 1. Configuring the master Redis instance
 
 1. SSH into the **master** Redis server.
-1. [Download/install](https://about.gitlab.com/installation) the Omnibus GitLab
+1. [Download/install](https://about.gitlab.com/install/) the Omnibus GitLab
    package you want using **steps 1 and 2** from the GitLab downloads page.
      - Make sure you select the correct Omnibus package, with the same version
        and type (Community, Enterprise editions) of your current install.
@@ -400,7 +400,7 @@ The prerequisites for a HA Redis setup are the following:
 ### Step 2. Configuring the slave Redis instances
 
 1. SSH into the **slave** Redis server.
-1. [Download/install](https://about.gitlab.com/installation) the Omnibus GitLab
+1. [Download/install](https://about.gitlab.com/install/) the Omnibus GitLab
    package you want using **steps 1 and 2** from the GitLab downloads page.
      - Make sure you select the correct Omnibus package, with the same version
        and type (Community, Enterprise editions) of your current install.
diff --git a/doc/administration/index.md b/doc/administration/index.md
index c5909e700c5..00c8863f200 100644
--- a/doc/administration/index.md
+++ b/doc/administration/index.md
@@ -11,7 +11,7 @@ GitLab has two product distributions available through [different subscriptions]
 - The open source [GitLab Community Edition (CE)](https://gitlab.com/gitlab-org/gitlab-ce).
 - The open core [GitLab Enterprise Edition (EE)](https://gitlab.com/gitlab-org/gitlab-ee).
 
-You can [install either GitLab CE or GitLab EE](https://about.gitlab.com/installation/ce-or-ee/).
+You can [install either GitLab CE or GitLab EE](https://about.gitlab.com/install/ce-or-ee/).
 However, the features you'll have access to depend on the subscription you choose
 (Core, Starter, Premium, or Ultimate).
 
diff --git a/doc/development/code_review.md b/doc/development/code_review.md
index 6123f9f845a..e60800f1ab7 100644
--- a/doc/development/code_review.md
+++ b/doc/development/code_review.md
@@ -319,7 +319,7 @@ reviewee.
 ### GitLab-specific concerns
 
 GitLab is used in a lot of places. Many users use
-our [Omnibus packages](https://about.gitlab.com/installation/), but some use
+our [Omnibus packages](https://about.gitlab.com/install/), but some use
 the [Docker images](https://docs.gitlab.com/omnibus/docker/), some are
 [installed from source](../install/installation.md),
 and there are other installation methods available. GitLab.com itself is a large
diff --git a/doc/downgrade_ee_to_ce/README.md b/doc/downgrade_ee_to_ce/README.md
index a187b3cbb07..a3f6f2b327c 100644
--- a/doc/downgrade_ee_to_ce/README.md
+++ b/doc/downgrade_ee_to_ce/README.md
@@ -81,7 +81,7 @@ To downgrade an Omnibus installation, it is sufficient to install the Community
 Edition package on top of the currently installed one. You can do this manually,
 by directly [downloading the package](https://packages.gitlab.com/gitlab/gitlab-ce)
 you need, or by adding our CE package repository and following the
-[CE installation instructions](https://about.gitlab.com/installation/?version=ce).
+[CE installation instructions](https://about.gitlab.com/install/?version=ce).
 
 **Source Installation**
 
diff --git a/doc/install/google_cloud_platform/index.md b/doc/install/google_cloud_platform/index.md
index 2070187255a..14bf7012c01 100644
--- a/doc/install/google_cloud_platform/index.md
+++ b/doc/install/google_cloud_platform/index.md
@@ -55,7 +55,7 @@ After a few seconds, the instance will be created and available to log in. The n
 
     ![GitLab first sign in](img/ssh_terminal.png)
 
-1. Next, follow the instructions for installing GitLab for the operating system you choose, at <https://about.gitlab.com/installation/>. You can use the IP address from the step above, as the hostname.
+1. Next, follow the instructions for installing GitLab for the operating system you choose, at <https://about.gitlab.com/install/>. You can use the IP address from the step above, as the hostname.
 
 1. Congratulations! GitLab is now installed and you can access it via your browser. To finish installation, open the URL in your browser and provide the initial administrator password. The username for this account is `root`.
 
diff --git a/doc/install/requirements.md b/doc/install/requirements.md
index 68c1bcbc801..25ab608de3a 100644
--- a/doc/install/requirements.md
+++ b/doc/install/requirements.md
@@ -30,7 +30,7 @@ For the installations options, see [the main installation page](README.md).
 - macOS
 
 Installation of GitLab on these operating systems is possible, but not supported.
-Please see the [installation from source guide](installation.md) and the [installation guides](https://about.gitlab.com/installation/) for more information.
+Please see the [installation from source guide](installation.md) and the [installation guides](https://about.gitlab.com/install/) for more information.
 
 ### Microsoft Windows
 
diff --git a/doc/intro/README.md b/doc/intro/README.md
index 9a8cd925e48..33b23372280 100644
--- a/doc/intro/README.md
+++ b/doc/intro/README.md
@@ -41,6 +41,6 @@ Use the built-in continuous integration in GitLab.
 
 Install and update your GitLab installation.
 
-- [Install GitLab](https://about.gitlab.com/installation/)
+- [Install GitLab](https://about.gitlab.com/install/)
 - [Update GitLab](https://about.gitlab.com/update/)
 - [Explore Omnibus GitLab configuration options](https://docs.gitlab.com/omnibus/settings/configuration.html)
diff --git a/doc/university/support/README.md b/doc/university/support/README.md
index 2c6e52acfde..fdeba89f9c8 100644
--- a/doc/university/support/README.md
+++ b/doc/university/support/README.md
@@ -45,7 +45,7 @@ It's important to understand how to install GitLab in the same way that our user
 
 Sometimes we need to upgrade customers from old versions of GitLab to latest, so it's good to get some experience of doing that now.
 
-- [Installation Methods](https://about.gitlab.com/installation/):
+- [Installation Methods](https://about.gitlab.com/install/):
   - [Omnibus](https://gitlab.com/gitlab-org/omnibus-gitlab/)
   - [Docker](https://gitlab.com/gitlab-org/gitlab-ce/tree/master/docker)
   - [Source](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/doc/install/installation.md)

From acd927fd5918c837358222cb0e36d0e57f96be0c Mon Sep 17 00:00:00 2001
From: Robert Speicher <rspeicher@gmail.com>
Date: Mon, 8 Jul 2019 17:36:29 -0500
Subject: [PATCH 159/195] Move lib/gitlab dependency to application

We use the `Gitlab.ee` and `.ee?` methods in several initializers now.
---
 config/application.rb            | 1 +
 config/initializers/0_license.rb | 2 --
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/config/application.rb b/config/application.rb
index c5ef6a2c60d..edf8b3e87f9 100644
--- a/config/application.rb
+++ b/config/application.rb
@@ -6,6 +6,7 @@ Bundler.require(:default, Rails.env)
 
 module Gitlab
   class Application < Rails::Application
+    require_dependency Rails.root.join('lib/gitlab')
     require_dependency Rails.root.join('lib/gitlab/redis/wrapper')
     require_dependency Rails.root.join('lib/gitlab/redis/cache')
     require_dependency Rails.root.join('lib/gitlab/redis/queues')
diff --git a/config/initializers/0_license.rb b/config/initializers/0_license.rb
index c4f9a2bc74e..0d101517c79 100644
--- a/config/initializers/0_license.rb
+++ b/config/initializers/0_license.rb
@@ -1,5 +1,3 @@
-require_dependency 'lib/gitlab'
-
 Gitlab.ee do
   begin
     public_key_file = File.read(Rails.root.join(".license_encryption_key.pub"))

From 0d4c6a14d81bb120b04e8edb76050110191435a9 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Mon, 8 Jul 2019 23:14:29 +0000
Subject: [PATCH 160/195] Update redirected links to final destinations

This updates redirected links in integration, update, user
and workflow dirs. Should now link to final URLs to avoid
redirect hops
---
 doc/integration/akismet.md                    |  2 +-
 doc/integration/azure.md                      | 96 +++++++++---------
 doc/integration/oauth_provider.md             |  4 +-
 doc/integration/openid_connect_provider.md    |  6 +-
 doc/integration/shibboleth.md                 |  4 +-
 doc/integration/twitter.md                    | 99 ++++++++++---------
 doc/update/mysql_to_postgresql.md             |  4 +-
 doc/update/upgrading_from_source.md           |  2 +-
 .../admin_area/custom_project_templates.md    |  2 +-
 .../settings/external_authorization.md        |  2 +-
 .../settings/instance_template_repository.md  |  2 +-
 doc/user/asciidoc.md                          |  2 +-
 doc/user/gitlab_com/index.md                  |  4 +-
 doc/user/group/custom_project_templates.md    |  2 +-
 doc/user/group/roadmap/index.md               |  4 +-
 doc/user/project/import/svn.md                |  2 +-
 doc/user/project/import/tfs.md                | 10 +-
 doc/user/project/integrations/github.md       |  2 +-
 doc/user/project/integrations/prometheus.md   |  9 +-
 .../prometheus_library/cloudwatch.md          |  2 +-
 doc/user/project/integrations/slack.md        |  2 +-
 .../browser_performance_testing.md            |  2 +-
 doc/user/project/operations/tracing.md        |  8 +-
 doc/workflow/lfs/lfs_administration.md        |  2 +-
 24 files changed, 136 insertions(+), 138 deletions(-)

diff --git a/doc/integration/akismet.md b/doc/integration/akismet.md
index 4f7be70baf2..cb8f25d2895 100644
--- a/doc/integration/akismet.md
+++ b/doc/integration/akismet.md
@@ -3,7 +3,7 @@
 > *Note:* Before 8.11 only issues submitted via the API and for non-project
 members were submitted to Akismet.
 
-GitLab leverages [Akismet](http://akismet.com) to protect against spam. Currently
+GitLab leverages [Akismet](https://akismet.com/) to protect against spam. Currently
 GitLab uses Akismet to prevent the creation of spam issues on public projects. Issues
 created via the WebUI or the API can be submitted to Akismet for review.
 
diff --git a/doc/integration/azure.md b/doc/integration/azure.md
index 7a6d4bb143f..a9468f201ef 100644
--- a/doc/integration/azure.md
+++ b/doc/integration/azure.md
@@ -2,21 +2,21 @@
 
 To enable the Microsoft Azure OAuth2 OmniAuth provider you must register your application with Azure. Azure will generate a client ID and secret key for you to use.
 
-1.  Sign in to the [Azure Management Portal](https://manage.windowsazure.com).
+1. Sign in to the [Azure Management Portal](https://portal.azure.com).
 
-1.  Select "Active Directory" on the left and choose the directory you want to use to register GitLab.
+1. Select "Active Directory" on the left and choose the directory you want to use to register GitLab.
 
-1.  Select "Applications" at the top bar and click the "Add" button the bottom.
+1. Select "Applications" at the top bar and click the "Add" button the bottom.
 
-1.  Select "Add an application my organization is developing".
+1. Select "Add an application my organization is developing".
 
-1.  Provide the project information and click the "Next" button.
-    - Name: 'GitLab' works just fine here.
-    - Type: 'WEB APPLICATION AND/OR WEB API'
+1. Provide the project information and click the "Next" button.
+   - Name: 'GitLab' works just fine here.
+   - Type: 'WEB APPLICATION AND/OR WEB API'
 
-1.  On the "App properties" page enter the needed URI's and click the "Complete" button.
-    - SIGN-IN URL: Enter the URL of your GitLab installation (e.g `https://gitlab.mycompany.com/`)
-    - APP ID URI: Enter the endpoint URL for Microsoft to use, just has to be unique (e.g `https://mycompany.onmicrosoft.com/gitlab`)
+1. On the "App properties" page enter the needed URI's and click the "Complete" button.
+   - SIGN-IN URL: Enter the URL of your GitLab installation (e.g `https://gitlab.mycompany.com/`)
+   - APP ID URI: Enter the endpoint URL for Microsoft to use, just has to be unique (e.g `https://mycompany.onmicrosoft.com/gitlab`)
 
 1. Select "Configure" in the top menu.
 
@@ -30,59 +30,59 @@ To enable the Microsoft Azure OAuth2 OmniAuth provider you must register your ap
 
 1. You will see lots of endpoint URLs in the form `https://login.microsoftonline.com/TENANT ID/...`, note down the TENANT ID part of one of those endpoints.
 
-1.  On your GitLab server, open the configuration file.
+1. On your GitLab server, open the configuration file.
 
-    For omnibus package:
+   For omnibus package:
 
-    ```sh
-      sudo editor /etc/gitlab/gitlab.rb
-    ```
+   ```sh
+   sudo editor /etc/gitlab/gitlab.rb
+   ```
 
-    For installations from source:
+   For installations from source:
 
-    ```sh
-      cd /home/git/gitlab
+   ```sh
+   cd /home/git/gitlab
 
-      sudo -u git -H editor config/gitlab.yml
-    ```
+   sudo -u git -H editor config/gitlab.yml
+   ```
 
-1.  See [Initial OmniAuth Configuration](omniauth.md#initial-omniauth-configuration) for initial settings.
+1. See [Initial OmniAuth Configuration](omniauth.md#initial-omniauth-configuration) for initial settings.
 
-1.  Add the provider configuration:
+1. Add the provider configuration:
 
-    For omnibus package:
+   For omnibus package:
 
-    ```ruby
-      gitlab_rails['omniauth_providers'] = [
-        {
-          "name" => "azure_oauth2",
-          "args" => {
-            "client_id" => "CLIENT ID",
-            "client_secret" => "CLIENT SECRET",
-            "tenant_id" => "TENANT ID",
-          }
-        }
-      ]
-    ```
+   ```ruby
+   gitlab_rails['omniauth_providers'] = [
+     {
+       "name" => "azure_oauth2",
+       "args" => {
+         "client_id" => "CLIENT ID",
+         "client_secret" => "CLIENT SECRET",
+         "tenant_id" => "TENANT ID",
+       }
+     }
+   ]
+   ```
 
-    For installations from source:
+   For installations from source:
 
-    ```
-     - { name: 'azure_oauth2',
-       args: { client_id: "CLIENT ID",
-       client_secret: "CLIENT SECRET",
-       tenant_id: "TENANT ID" } }
-    ```
+   ```
+   - { name: 'azure_oauth2',
+     args: { client_id: "CLIENT ID",
+     client_secret: "CLIENT SECRET",
+     tenant_id: "TENANT ID" } }
+   ```
 
-    The `base_azure_url` is optional and can be added for different locales;
-    e.g. `base_azure_url: "https://login.microsoftonline.de"`.
+   The `base_azure_url` is optional and can be added for different locales;
+   e.g. `base_azure_url: "https://login.microsoftonline.de"`.
 
-1.  Replace 'CLIENT ID', 'CLIENT SECRET' and 'TENANT ID' with the values you got above.
+1. Replace 'CLIENT ID', 'CLIENT SECRET' and 'TENANT ID' with the values you got above.
 
-1.  Save the configuration file.
+1. Save the configuration file.
 
-1.  [Reconfigure][] or [restart GitLab][] for the changes to take effect if you
-    installed GitLab via Omnibus or from source respectively.
+1. [Reconfigure][] or [restart GitLab][] for the changes to take effect if you
+   installed GitLab via Omnibus or from source respectively.
 
 On the sign in page there should now be a Microsoft icon below the regular sign in form. Click the icon to begin the authentication process. Microsoft will ask the user to sign in and authorize the GitLab application. If everything goes well the user will be returned to GitLab and will be signed in.
 
diff --git a/doc/integration/oauth_provider.md b/doc/integration/oauth_provider.md
index c02a29dffb4..b9dc2e123c5 100644
--- a/doc/integration/oauth_provider.md
+++ b/doc/integration/oauth_provider.md
@@ -11,7 +11,7 @@ If you want to use:
 
 ## Introduction to OAuth
 
-[OAuth] provides to client applications a 'secure delegated access' to server
+[OAuth](https://oauth.net/2/) provides to client applications a 'secure delegated access' to server
 resources on behalf of a resource owner. In fact, OAuth allows an authorization
 server to issue access tokens to third-party clients with the approval of the
 resource owner, or the end-user.
@@ -85,5 +85,3 @@ application can perform such as `read_user` and `api`. There are many more scope
 available.
 
 At any time you can revoke any access by just clicking **Revoke**.
-
-[oauth]: http://oauth.net/2/ "OAuth website"
diff --git a/doc/integration/openid_connect_provider.md b/doc/integration/openid_connect_provider.md
index a7f907254a1..89f4924d717 100644
--- a/doc/integration/openid_connect_provider.md
+++ b/doc/integration/openid_connect_provider.md
@@ -5,7 +5,7 @@ to sign in to other services.
 
 ## Introduction to OpenID Connect
 
-[OpenID Connect] \(OIDC) is a simple identity layer on top of the
+[OpenID Connect](https://openid.net/connect/) \(OIDC) is a simple identity layer on top of the
 OAuth 2.0 protocol. It allows clients to verify the identity of the end-user
 based on the authentication performed by GitLab, as well as to obtain
 basic profile information about the end-user in an interoperable and
@@ -14,7 +14,7 @@ but does so in a way that is API-friendly, and usable by native and
 mobile applications.
 
 On the client side, you can use [omniauth-openid-connect] for Rails
-applications, or any of the other available [client implementations].
+applications, or any of the other available [client implementations](https://openid.net/developers/libraries/#connect).
 
 GitLab's implementation uses the [doorkeeper-openid_connect] gem, refer
 to its README for more details about which parts of the specifications
@@ -46,8 +46,6 @@ Currently the following user information is shared with clients:
 
 Only the `sub` and `sub_legacy` claims are included in the ID token, all other claims are available from the `/oauth/userinfo` endpoint used by OIDC clients.
 
-[OpenID Connect]: http://openid.net/connect/ "OpenID Connect website"
 [doorkeeper-openid_connect]: https://github.com/doorkeeper-gem/doorkeeper-openid_connect "Doorkeeper::OpenidConnect website"
 [OAuth guide]: oauth_provider.md "GitLab as OAuth2 authentication service provider"
 [omniauth-openid-connect]: https://github.com/jjbohn/omniauth-openid-connect/ "OmniAuth::OpenIDConnect website"
-[client implementations]: http://openid.net/developers/libraries#connect "List of available client implementations"
diff --git a/doc/integration/shibboleth.md b/doc/integration/shibboleth.md
index 616f3a76b2c..07c83c1a049 100644
--- a/doc/integration/shibboleth.md
+++ b/doc/integration/shibboleth.md
@@ -5,8 +5,8 @@ This documentation is for enabling shibboleth with omnibus-gitlab package.
 In order to enable Shibboleth support in gitlab we need to use Apache instead of Nginx (It may be possible to use Nginx, however this is difficult to configure using the bundled Nginx provided in the omnibus-gitlab package). Apache uses mod_shib2 module for shibboleth authentication and can pass attributes as headers to omniauth-shibboleth provider.
 
 To enable the Shibboleth OmniAuth provider you must configure Apache shibboleth module.
-Installation and configuration of module it self is out of scope of this document.
-Check <https://wiki.shibboleth.net/> for more info.
+The installation and configuration of the module itself is out of the scope of this document.
+Check <https://wiki.shibboleth.net/confluence/display/SP3/Apache> for more info.
 
 You can find Apache config in gitlab-recipes (<https://gitlab.com/gitlab-org/gitlab-recipes/tree/master/web-server/apache>).
 
diff --git a/doc/integration/twitter.md b/doc/integration/twitter.md
index 1cbfd81dfa9..d8096993885 100644
--- a/doc/integration/twitter.md
+++ b/doc/integration/twitter.md
@@ -2,80 +2,81 @@
 
 To enable the Twitter OmniAuth provider you must register your application with Twitter. Twitter will generate a client ID and secret key for you to use.
 
-1.  Sign in to [Twitter Application Management](https://apps.twitter.com/).
+1. Sign in to [Twitter Application Management](https://developer.twitter.com/apps).
 
-1.  Select "Create new app"
+1. Select "Create new app"
 
-1.  Fill in the application details.
-    - Name: This can be anything. Consider something like `<Organization>'s GitLab` or `<Your Name>'s GitLab` or
-    something else descriptive.
-    - Description: Create a description.
-    - Website: The URL to your GitLab installation. `https://gitlab.example.com`
-    - Callback URL: `https://gitlab.example.com/users/auth/twitter/callback`
-    - Agree to the "Developer Agreement".
+1. Fill in the application details.
+   - Name: This can be anything. Consider something like `<Organization>'s GitLab` or `<Your Name>'s GitLab` or
+   something else descriptive.
+   - Description: Create a description.
+   - Website: The URL to your GitLab installation. `https://gitlab.example.com`
+   - Callback URL: `https://gitlab.example.com/users/auth/twitter/callback`
+   - Agree to the "Developer Agreement".
 
-    ![Twitter App Details](img/twitter_app_details.png)
-1.  Select "Create your Twitter application."
+   ![Twitter App Details](img/twitter_app_details.png)
 
-1.  Select the "Settings" tab.
+1. Select "Create your Twitter application."
 
-1.  Underneath the Callback URL check the box next to "Allow this application to be used to Sign in with Twitter."
+1. Select the "Settings" tab.
 
-1.  Select "Update settings" at the bottom to save changes.
+1. Underneath the Callback URL check the box next to "Allow this application to be used to Sign in with Twitter."
 
-1.  Select the "Keys and Access Tokens" tab.
+1. Select "Update settings" at the bottom to save changes.
 
-1.  You should now see an API key and API secret (see screenshot). Keep this page open as you continue configuration.
+1. Select the "Keys and Access Tokens" tab.
 
-    ![Twitter app](img/twitter_app_api_keys.png)
+1. You should now see an API key and API secret (see screenshot). Keep this page open as you continue configuration.
 
-1.  On your GitLab server, open the configuration file.
+   ![Twitter app](img/twitter_app_api_keys.png)
 
-    For omnibus package:
+1. On your GitLab server, open the configuration file.
 
-    ```sh
-      sudo editor /etc/gitlab/gitlab.rb
-    ```
+   For omnibus package:
 
-    For installations from source:
+   ```sh
+     sudo editor /etc/gitlab/gitlab.rb
+   ```
 
-    ```sh
-      cd /home/git/gitlab
+   For installations from source:
 
-      sudo -u git -H editor config/gitlab.yml
-    ```
+   ```sh
+     cd /home/git/gitlab
 
-1.  See [Initial OmniAuth Configuration](omniauth.md#initial-omniauth-configuration) for initial settings.
+     sudo -u git -H editor config/gitlab.yml
+   ```
 
-1.  Add the provider configuration:
+1. See [Initial OmniAuth Configuration](omniauth.md#initial-omniauth-configuration) for initial settings.
 
-    For omnibus package:
+1. Add the provider configuration:
 
-    ```ruby
-      gitlab_rails['omniauth_providers'] = [
-        {
-          "name" => "twitter",
-          "app_id" => "YOUR_APP_ID",
-          "app_secret" => "YOUR_APP_SECRET"
-        }
-      ]
-    ```
+   For omnibus package:
 
-    For installations from source:
+   ```ruby
+     gitlab_rails['omniauth_providers'] = [
+       {
+         "name" => "twitter",
+         "app_id" => "YOUR_APP_ID",
+         "app_secret" => "YOUR_APP_SECRET"
+       }
+     ]
+   ```
 
-    ```
-      - { name: 'twitter', app_id: 'YOUR_APP_ID',
-        app_secret: 'YOUR_APP_SECRET' }
-    ```
+   For installations from source:
 
-1.  Change 'YOUR_APP_ID' to the API key from Twitter page in step 11.
+   ```
+     - { name: 'twitter', app_id: 'YOUR_APP_ID',
+       app_secret: 'YOUR_APP_SECRET' }
+   ```
 
-1.  Change 'YOUR_APP_SECRET' to the API secret from the Twitter page in step 11.
+1. Change 'YOUR_APP_ID' to the API key from Twitter page in step 11.
 
-1.  Save the configuration file.
+1. Change 'YOUR_APP_SECRET' to the API secret from the Twitter page in step 11.
 
-1.  [Reconfigure][] or [restart GitLab][] for the changes to take effect if you
-    installed GitLab via Omnibus or from source respectively.
+1. Save the configuration file.
+
+1. [Reconfigure][] or [restart GitLab][] for the changes to take effect if you
+   installed GitLab via Omnibus or from source respectively.
 
 On the sign in page there should now be a Twitter icon below the regular sign in form. Click the icon to begin the authentication process. Twitter will ask the user to sign in and authorize the GitLab application. If everything goes well the user will be returned to GitLab and will be signed in.
 
diff --git a/doc/update/mysql_to_postgresql.md b/doc/update/mysql_to_postgresql.md
index 4b13e41ab53..1e424134242 100644
--- a/doc/update/mysql_to_postgresql.md
+++ b/doc/update/mysql_to_postgresql.md
@@ -13,7 +13,7 @@ NOTE: **Note:**
 Support for MySQL was removed in GitLab 12.1. This procedure should be performed
 **before** installing GitLab 12.1.
 
-[pgloader](http://pgloader.io) 3.4.1+ is required.
+[pgloader](https://pgloader.io/) 3.4.1+ is required.
 
 You can install it directly from your distribution, for example in
 Debian/Ubuntu:
@@ -59,7 +59,7 @@ pgloader within the container as it is not included in the container image.
    ```
 
 1. Install pgloader:
-    
+
    ``` bash
    apt-get update
    apt-get -y install pgloader
diff --git a/doc/update/upgrading_from_source.md b/doc/update/upgrading_from_source.md
index 023dc7d6de3..d3b0a3c2829 100644
--- a/doc/update/upgrading_from_source.md
+++ b/doc/update/upgrading_from_source.md
@@ -76,7 +76,7 @@ sudo gem install bundler --no-document --version '< 2'
 NOTE: Beginning in GitLab 11.8, we only support node 8 or higher, and dropped
 support for node 6. Be sure to upgrade if necessary.
 
-GitLab utilizes [webpack](http://webpack.js.org) to compile frontend assets.
+GitLab utilizes [webpack](https://webpack.js.org/) to compile frontend assets.
 This requires a minimum version of node v8.10.0.
 
 You can check which version you are running with `node -v`. If you are running
diff --git a/doc/user/admin_area/custom_project_templates.md b/doc/user/admin_area/custom_project_templates.md
index db853a58b91..427f3103cfc 100644
--- a/doc/user/admin_area/custom_project_templates.md
+++ b/doc/user/admin_area/custom_project_templates.md
@@ -1,6 +1,6 @@
 # Custom instance-level project templates **(PREMIUM ONLY)**
 
-> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/6860) in [GitLab Premium](https://about.gitlab.com/pricing) 11.2.
+> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/6860) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2.
 
 When you create a new [project](../project/index.md), creating it based on custom project templates is
 a convenient bootstrap option.
diff --git a/doc/user/admin_area/settings/external_authorization.md b/doc/user/admin_area/settings/external_authorization.md
index e920628d2c0..4fde7477490 100644
--- a/doc/user/admin_area/settings/external_authorization.md
+++ b/doc/user/admin_area/settings/external_authorization.md
@@ -5,7 +5,7 @@ type: reference
 # External authorization control **(CORE ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/4216) in
-> [GitLab Premium](https://about.gitlab.com/pricing) 10.6.
+> [GitLab Premium](https://about.gitlab.com/pricing/) 10.6.
 > [Moved](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/27056) to
 > [GitLab Core](https://about.gitlab.com/pricing/) in 11.10.
 
diff --git a/doc/user/admin_area/settings/instance_template_repository.md b/doc/user/admin_area/settings/instance_template_repository.md
index 2d861a0e15b..f2ba131d17b 100644
--- a/doc/user/admin_area/settings/instance_template_repository.md
+++ b/doc/user/admin_area/settings/instance_template_repository.md
@@ -5,7 +5,7 @@ type: reference
 # Instance template repository **(PREMIUM ONLY)**
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/5986) in
-> [GitLab Premium](https://about.gitlab.com/pricing) 11.3.
+> [GitLab Premium](https://about.gitlab.com/pricing/) 11.3.
 
 ## Overview
 
diff --git a/doc/user/asciidoc.md b/doc/user/asciidoc.md
index 0ed9bf3f518..06cc64b209d 100644
--- a/doc/user/asciidoc.md
+++ b/doc/user/asciidoc.md
@@ -1,7 +1,7 @@
 # AsciiDoc
 
 GitLab uses the [Asciidoctor](https://asciidoctor.org) gem to convert AsciiDoc content to HTML5.
-Consult the [Asciidoctor User Manual](https://asciidoctor.org/docs/user-manual) for a complete Asciidoctor reference.
+Consult the [Asciidoctor User Manual](https://asciidoctor.org/docs/user-manual/) for a complete Asciidoctor reference.
 
 ## Syntax
 
diff --git a/doc/user/gitlab_com/index.md b/doc/user/gitlab_com/index.md
index 769a22315be..7858c419e04 100644
--- a/doc/user/gitlab_com/index.md
+++ b/doc/user/gitlab_com/index.md
@@ -1,7 +1,7 @@
 # GitLab.com settings
 
 In this page you will find information about the settings that are used on
-[GitLab.com](https://about.gitlab.com/pricing).
+[GitLab.com](https://about.gitlab.com/pricing/).
 
 ## SSH host keys fingerprints
 
@@ -260,7 +260,7 @@ The list of GitLab.com specific settings (and their defaults) is as follows:
 | hot_standby_feedback                | on                                                                  | off                                   |
 | log_autovacuum_min_duration         | 0                                                                   | -1                                    |
 | log_checkpoints                     | on                                                                  | off                                   |
-| log_line_prefix                     | `%t [%p]: [%l-1] `                                                  | empty                                 |
+| log_line_prefix                     | `%t [%p]: [%l-1]`                                                   | empty                                 |
 | log_min_duration_statement          | 1000                                                                | -1                                    |
 | log_temp_files                      | 0                                                                   | -1                                    |
 | maintenance_work_mem                | 2048MB                                                              | 16 MB                                 |
diff --git a/doc/user/group/custom_project_templates.md b/doc/user/group/custom_project_templates.md
index e74644710a5..8a85c375490 100644
--- a/doc/user/group/custom_project_templates.md
+++ b/doc/user/group/custom_project_templates.md
@@ -4,7 +4,7 @@ type: reference
 
 # Custom group-level project templates **(PREMIUM)**
 
-> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/6861) in [GitLab Premium](https://about.gitlab.com/pricing) 11.6.
+> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/6861) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.6.
 
 When you create a new [project](../project/index.md), creating it based on custom project templates is
 a convenient bootstrap option.
diff --git a/doc/user/group/roadmap/index.md b/doc/user/group/roadmap/index.md
index 672149f8217..a72cd990706 100644
--- a/doc/user/group/roadmap/index.md
+++ b/doc/user/group/roadmap/index.md
@@ -4,7 +4,7 @@ type: reference
 
 # Roadmap **(ULTIMATE)**
 
-> Introduced in [GitLab Ultimate](https://about.gitlab.com/pricing) 10.5.
+> Introduced in [GitLab Ultimate](https://about.gitlab.com/pricing/) 10.5.
 
 An Epic within a group containing **Start date** and/or **Due date**
 can be visualized in a form of a timeline (e.g. a Gantt chart). The Epics Roadmap page
@@ -30,7 +30,7 @@ Roadmaps can also be [visualized inside an epic](../epics/index.md#roadmap-in-ep
 
 ## Timeline duration
 
-> Introduced in [GitLab Ultimate](https://about.gitlab.com/pricing) 11.0.
+> Introduced in [GitLab Ultimate](https://about.gitlab.com/pricing/) 11.0.
 
 Roadmap supports the following date ranges:
 
diff --git a/doc/user/project/import/svn.md b/doc/user/project/import/svn.md
index 4825b005a85..7359487e1bf 100644
--- a/doc/user/project/import/svn.md
+++ b/doc/user/project/import/svn.md
@@ -29,7 +29,7 @@ directly in a filesystem level.
 
 1. Install Oracle JRE 1.8 or newer. On Debian-based Linux distributions you can
    follow [this article](http://www.webupd8.org/2012/09/install-oracle-java-8-in-ubuntu-via-ppa.html).
-1. Download SubGit from <https://subgit.com/download/>.
+1. Download SubGit from <https://subgit.com/download>.
 1. Unpack the downloaded SubGit zip archive to the `/opt` directory. The `subgit`
    command will be available at `/opt/subgit-VERSION/bin/subgit`.
 
diff --git a/doc/user/project/import/tfs.md b/doc/user/project/import/tfs.md
index 8727c2ff6c3..b4597a4da60 100644
--- a/doc/user/project/import/tfs.md
+++ b/doc/user/project/import/tfs.md
@@ -1,6 +1,6 @@
 # Migrating from TFS
 
-[TFS](https://www.visualstudio.com/tfs/) is a set of tools developed by Microsoft
+[TFS](https://visualstudio.microsoft.com/tfs/) is a set of tools developed by Microsoft
 which also includes a centralized version control system (TFVC) similar to Git.
 
 In this document, we emphasize on the TFVC to Git migration.
@@ -18,10 +18,10 @@ The following list illustrates the main differences between TFVC and Git:
   a committed file(s) is stored in its entirety (snapshot). That means that's
   very easy in Git to revert or undo a whole change.
 
-_Check also Microsoft's documentation on the
-[comparison of Git and TFVC](https://www.visualstudio.com/en-us/docs/tfvc/comparison-git-tfvc)
-and the Wikipedia article on
-[comparing the different version control software](https://en.wikipedia.org/wiki/Comparison_of_version_control_software)._
+Check also Microsoft's documentation on the
+[comparison of Git and TFVC](https://docs.microsoft.com/en-us/azure/devops/repos/tfvc/comparison-git-tfvc?view=azure-devops)
+and the Wikipedia
+[comparison of version control software](https://en.wikipedia.org/wiki/Comparison_of_version_control_software).
 
 ## Why migrate
 
diff --git a/doc/user/project/integrations/github.md b/doc/user/project/integrations/github.md
index e8ffbde1f57..d0399f9193b 100644
--- a/doc/user/project/integrations/github.md
+++ b/doc/user/project/integrations/github.md
@@ -14,7 +14,7 @@ and is automatically configured on [GitHub import](../../../integration/github.m
 
 ### Complete these steps on GitHub
 
-This integration requires a [GitHub API token](https://help.github.com/articles/creating-a-personal-access-token-for-the-command-line/)
+This integration requires a [GitHub API token](https://help.github.com/en/articles/creating-a-personal-access-token-for-the-command-line)
 with `repo:status` access granted:
 
 1. Go to your "Personal access tokens" page at <https://github.com/settings/tokens>
diff --git a/doc/user/project/integrations/prometheus.md b/doc/user/project/integrations/prometheus.md
index 6e02761e041..01b6650bfab 100644
--- a/doc/user/project/integrations/prometheus.md
+++ b/doc/user/project/integrations/prometheus.md
@@ -18,6 +18,7 @@ Once enabled, GitLab will automatically detect metrics from known services in th
 ## Enabling Prometheus Integration
 
 ### Managed Prometheus on Kubernetes
+
 > **Note**: [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/28916) in GitLab 10.5
 
 GitLab can seamlessly deploy and manage Prometheus on a [connected Kubernetes cluster](../clusters/index.md), making monitoring of your apps easy.
@@ -39,9 +40,9 @@ Once you have a connected Kubernetes cluster with Helm installed, deploying a ma
 
 #### About managed Prometheus deployments
 
-Prometheus is deployed into the `gitlab-managed-apps` namespace, using the [official Helm chart](https://github.com/kubernetes/charts/tree/master/stable/prometheus). Prometheus is only accessible within the cluster, with GitLab communicating through the [Kubernetes API](https://kubernetes.io/docs/concepts/overview/kubernetes-api/).
+Prometheus is deployed into the `gitlab-managed-apps` namespace, using the [official Helm chart](https://github.com/helm/charts/tree/master/stable/prometheus). Prometheus is only accessible within the cluster, with GitLab communicating through the [Kubernetes API](https://kubernetes.io/docs/concepts/overview/kubernetes-api/).
 
-The Prometheus server will [automatically detect and monitor](https://prometheus.io/docs/prometheus/latest/configuration/configuration/#%3Ckubernetes_sd_config%3E) nodes, pods, and endpoints. To configure a resource to be monitored by Prometheus, simply set the following [Kubernetes annotations](https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/):
+The Prometheus server will [automatically detect and monitor](https://prometheus.io/docs/prometheus/latest/configuration/configuration/#kubernetes_sd_config) nodes, pods, and endpoints. To configure a resource to be monitored by Prometheus, simply set the following [Kubernetes annotations](https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/):
 
 - `prometheus.io/scrape` to `true` to enable monitoring of the resource.
 - `prometheus.io/port` to define the port of the metrics endpoint.
@@ -66,9 +67,9 @@ Integration with Prometheus requires the following:
 
 Installing and configuring Prometheus to monitor applications is fairly straight forward.
 
-1. [Install Prometheus](https://prometheus.io/docs/introduction/install/)
+1. [Install Prometheus](https://prometheus.io/docs/prometheus/latest/installation/)
 1. Set up one of the [supported monitoring targets](prometheus_library/index.md)
-1. Configure the Prometheus server to [collect their metrics](https://prometheus.io/docs/operating/configuration/#scrape_config)
+1. Configure the Prometheus server to [collect their metrics](https://prometheus.io/docs/prometheus/latest/configuration/configuration/#scrape_config)
 
 #### Configuration in GitLab
 
diff --git a/doc/user/project/integrations/prometheus_library/cloudwatch.md b/doc/user/project/integrations/prometheus_library/cloudwatch.md
index 01da7e00d74..5049733abdd 100644
--- a/doc/user/project/integrations/prometheus_library/cloudwatch.md
+++ b/doc/user/project/integrations/prometheus_library/cloudwatch.md
@@ -20,7 +20,7 @@ The [Prometheus service](../prometheus.md) must be enabled.
 
 To get started with Cloudwatch monitoring, you should install and configure the [Cloudwatch exporter](https://github.com/prometheus/cloudwatch_exporter) which retrieves and parses the specified Cloudwatch metrics and translates them into a Prometheus monitoring endpoint.
 
-Right now, the only AWS resource supported is the Elastic Load Balancer, whose Cloudwatch metrics can be found [here](http://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-cloudwatch-metrics.html).
+Right now, the only AWS resource supported is the Elastic Load Balancer, whose Cloudwatch metrics are [documented here](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-cloudwatch-metrics.html).
 
 A sample Cloudwatch Exporter configuration file, configured for basic AWS ELB monitoring, is [available for download](../samples/cloudwatch.yml).
 
diff --git a/doc/user/project/integrations/slack.md b/doc/user/project/integrations/slack.md
index bb8d276c2fc..508e72b5753 100644
--- a/doc/user/project/integrations/slack.md
+++ b/doc/user/project/integrations/slack.md
@@ -6,7 +6,7 @@ The Slack Notifications Service allows your GitLab project to send events (e.g.
 
 ## Slack Configuration
 
-1. Sign in to your Slack team and [start a new Incoming WebHooks configuration](https://my.slack.com/services/new/incoming-webhook/).
+1. Sign in to your Slack team and [start a new Incoming WebHooks configuration](https://my.slack.com/services/new/incoming-webhook).
 1. Select the Slack channel where notifications will be sent to by default. Click the **Add Incoming WebHooks integration** button to add the configuration.
 1. Copy the **Webhook URL**, which we'll use later in the GitLab configuration.
 
diff --git a/doc/user/project/merge_requests/browser_performance_testing.md b/doc/user/project/merge_requests/browser_performance_testing.md
index e95ab7d02c4..49b9826a52a 100644
--- a/doc/user/project/merge_requests/browser_performance_testing.md
+++ b/doc/user/project/merge_requests/browser_performance_testing.md
@@ -19,7 +19,7 @@ tool for measuring the performance of web sites, and has built a simple
 which outputs the results in a file called `performance.json`. This plugin
 outputs the performance score for each page that is analyzed.
 
-The [Sitespeed.io performance score](http://examples.sitespeed.io/6.0/2017-11-23-23-43-35/help.html)
+The [Sitespeed.io performance score](https://examples.sitespeed.io/6.0/2017-11-23-23-43-35/help.html)
 is a composite value based on best practices, and we will be expanding support
 for [additional metrics](https://gitlab.com/gitlab-org/gitlab-ee/issues/4370)
 in a future release.
diff --git a/doc/user/project/operations/tracing.md b/doc/user/project/operations/tracing.md
index a74233bbd02..b92d2e49839 100644
--- a/doc/user/project/operations/tracing.md
+++ b/doc/user/project/operations/tracing.md
@@ -17,8 +17,8 @@ systems.
 ### Deploying Jaeger
 
 To learn more about deploying Jaeger, read the official
-[Getting Started documentation](https://www.jaegertracing.io/docs/latest/getting-started/).
-There is an easy to use [all-in-one Docker image](https://www.jaegertracing.io/docs/latest/getting-started/#AllinoneDockerimage),
+[Getting Started documentation](https://www.jaegertracing.io/docs/1.13/getting-started/).
+There is an easy to use [all-in-one Docker image](https://www.jaegertracing.io/docs/1.13/getting-started/#AllinoneDockerimage),
 as well as deployment options for [Kubernetes](https://github.com/jaegertracing/jaeger-kubernetes)
 and [OpenShift](https://github.com/jaegertracing/jaeger-openshift).
 
@@ -27,8 +27,8 @@ and [OpenShift](https://github.com/jaegertracing/jaeger-openshift).
 GitLab provides an easy way to open the Jaeger UI from within your project:
 
 1. [Set up Jaeger](#deploying-jaeger) and configure your application using one of the
-   [client libraries](https://www.jaegertracing.io/docs/latest/client-libraries/).
+   [client libraries](https://www.jaegertracing.io/docs/1.13/client-libraries/).
 1. Navigate to your project's **Settings > Operations** and provide the Jaeger URL.
 1. Click **Save changes** for the changes to take effect.
 1. You can now visit **Operations > Tracing** in your project's sidebar and
-   GitLab will redirect you to the configured Jaeger URL.
\ No newline at end of file
+   GitLab will redirect you to the configured Jaeger URL.
diff --git a/doc/workflow/lfs/lfs_administration.md b/doc/workflow/lfs/lfs_administration.md
index 6d941135bf2..03af8fad759 100644
--- a/doc/workflow/lfs/lfs_administration.md
+++ b/doc/workflow/lfs/lfs_administration.md
@@ -54,7 +54,7 @@ to offload local hard disk R/W operations, and free up disk space significantly.
 GitLab is tightly integrated with `Fog`, so you can refer to its [documentation](http://fog.io/about/provider_documentation.html)
 to check which storage services can be integrated with GitLab.
 You can also use external object storage in a private local network. For example,
-[Minio](https://www.minio.io/) is a standalone object storage service, is easy to set up, and works well with GitLab instances.
+[Minio](https://min.io/) is a standalone object storage service, is easy to set up, and works well with GitLab instances.
 
 GitLab provides two different options for the uploading mechanism: "Direct upload" and "Background upload".
 

From d3824fbfd97476edb409191fc998d75e81b322bf Mon Sep 17 00:00:00 2001
From: Imre Farkas <ifarkas@gitlab.com>
Date: Mon, 8 Jul 2019 23:35:44 +0000
Subject: [PATCH 161/195] Doc for "Require session with smartcard login for Git
 access"

---
 doc/administration/auth/smartcard.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/doc/administration/auth/smartcard.md b/doc/administration/auth/smartcard.md
index 2f3289d6102..a0d4e9ef3b5 100644
--- a/doc/administration/auth/smartcard.md
+++ b/doc/administration/auth/smartcard.md
@@ -184,3 +184,31 @@ attribute. As a prerequisite, you must use an LDAP server that:
 
 1. Save the file and [restart](../restart_gitlab.md#installations-from-source)
    GitLab for the changes to take effect.
+
+### Require browser session with smartcard sign-in for Git access
+
+**For Omnibus installations**
+
+1. Edit `/etc/gitlab/gitlab.rb`:
+
+    ```ruby
+    gitlab_rails['smartcard_required_for_git_access'] = true
+    ```
+
+1. Save the file and [reconfigure](../restart_gitlab.md#omnibus-gitlab-reconfigure)
+   GitLab for the changes to take effect.
+
+**For installations from source**
+
+1. Edit `config/gitlab.yml`:
+
+    ```yaml
+    ## Smartcard authentication settings
+    smartcard:
+      # snip...
+      # Browser session with smartcard sign-in is required for Git access
+      required_for_git_access: true
+    ```
+
+1. Save the file and [restart](../restart_gitlab.md#installations-from-source)
+   GitLab for the changes to take effect.

From 7d73d817bdf2a1ded88f66ae997ddbf2af1247dd Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Cindy=20Pallares=20=F0=9F=A6=89?= <cindy@gitlab.com>
Date: Mon, 8 Jul 2019 23:42:35 +0000
Subject: [PATCH 162/195] Move the consul server docs to its own section

The consul docs are currently in the HA database section, but it should
be in it's own section.
---
 .../high_availability/consul.md               | 66 +++++++++++++++++++
 .../high_availability/database.md             | 55 +---------------
 2 files changed, 68 insertions(+), 53 deletions(-)

diff --git a/doc/administration/high_availability/consul.md b/doc/administration/high_availability/consul.md
index 3bdce7bce5e..49199b659bc 100644
--- a/doc/administration/high_availability/consul.md
+++ b/doc/administration/high_availability/consul.md
@@ -6,6 +6,72 @@ As part of its High Availability stack, GitLab Premium includes a bundled versio
 
 A Consul cluster consists of multiple server agents, as well as client agents that run on other nodes which need to talk to the consul cluster.
 
+## Prerequisites
+
+First, make sure to [download/install](https://about.gitlab.com/install/)
+GitLab Omnibus **on each node**.
+
+Choose an installation method, then make sure you complete steps:
+
+1. Install and configure the necessary dependencies.
+1. Add the GitLab package repository and install the package.
+
+When installing the GitLab package, do not supply `EXTERNAL_URL` value.
+
+## Configuring the Consul nodes
+
+On each Consul node perform the following:
+
+1. Make sure you collect [`CONSUL_SERVER_NODES`](database.md#consul-information), which are the IP addresses or DNS records of the Consul server nodes, for the next step, before executing the next step.
+
+1. Edit `/etc/gitlab/gitlab.rb` replacing values noted in the `# START user configuration` section:
+
+    ```ruby
+    # Disable all components except Consul
+    roles ['consul_role']
+
+    # START user configuration
+    # Replace placeholders:
+    #
+    # Y.Y.Y.Y consul1.gitlab.example.com Z.Z.Z.Z
+    # with the addresses gathered for CONSUL_SERVER_NODES
+    consul['configuration'] = {
+      server: true,
+      retry_join: %w(Y.Y.Y.Y consul1.gitlab.example.com Z.Z.Z.Z)
+    }
+
+    # Disable auto migrations
+    gitlab_rails['auto_migrate'] = false
+    #
+    # END user configuration
+    ```
+
+    > `consul_role` was introduced with GitLab 10.3
+
+1. [Reconfigure GitLab](../restart_gitlab.md#omnibus-gitlab-reconfigure) for the changes
+   to take effect.
+
+### Consul checkpoint
+
+Before moving on, make sure Consul is configured correctly. Run the following
+command to verify all server nodes are communicating:
+
+```sh
+/opt/gitlab/embedded/bin/consul members
+```
+
+The output should be similar to:
+
+```
+Node                 Address               Status  Type    Build  Protocol  DC
+CONSUL_NODE_ONE      XXX.XXX.XXX.YYY:8301  alive   server  0.9.2  2         gitlab_consul
+CONSUL_NODE_TWO      XXX.XXX.XXX.YYY:8301  alive   server  0.9.2  2         gitlab_consul
+CONSUL_NODE_THREE    XXX.XXX.XXX.YYY:8301  alive   server  0.9.2  2         gitlab_consul
+```
+
+If any of the nodes isn't `alive` or if any of the three nodes are missing,
+check the [Troubleshooting section](#troubleshooting) before proceeding.
+
 ## Operations
 
 ### Checking cluster membership
diff --git a/doc/administration/high_availability/database.md b/doc/administration/high_availability/database.md
index d7acc1e7eb1..5c6d7ba597c 100644
--- a/doc/administration/high_availability/database.md
+++ b/doc/administration/high_availability/database.md
@@ -288,61 +288,10 @@ Make sure you install the necessary dependencies from step 1,
 add GitLab package repository from step 2.
 When installing the GitLab package, do not supply `EXTERNAL_URL` value.
 
-#### Configuring the Consul nodes
-
-On each Consul node perform the following:
-
-1. Make sure you collect [`CONSUL_SERVER_NODES`](#consul-information) before executing the next step.
-
-1. Edit `/etc/gitlab/gitlab.rb` replacing values noted in the `# START user configuration` section:
-
-    ```ruby
-    # Disable all components except Consul
-    roles ['consul_role']
-
-    # START user configuration
-    # Replace placeholders:
-    #
-    # Y.Y.Y.Y consul1.gitlab.example.com Z.Z.Z.Z
-    # with the addresses gathered for CONSUL_SERVER_NODES
-    consul['configuration'] = {
-      server: true,
-      retry_join: %w(Y.Y.Y.Y consul1.gitlab.example.com Z.Z.Z.Z)
-    }
-
-    # Disable auto migrations
-    gitlab_rails['auto_migrate'] = false
-    #
-    # END user configuration
-    ```
-
-    > `consul_role` was introduced with GitLab 10.3
-
-1. [Reconfigure GitLab] for the changes to take effect.
-
-##### Consul Checkpoint
-
-Before moving on, make sure Consul is configured correctly. Run the following
-command to verify all server nodes are communicating:
-
-```sh
-/opt/gitlab/embedded/bin/consul members
-```
-
-The output should be similar to:
-
-```
-Node                 Address               Status  Type    Build  Protocol  DC
-CONSUL_NODE_ONE      XXX.XXX.XXX.YYY:8301  alive   server  0.9.2  2         gitlab_consul
-CONSUL_NODE_TWO      XXX.XXX.XXX.YYY:8301  alive   server  0.9.2  2         gitlab_consul
-CONSUL_NODE_THREE    XXX.XXX.XXX.YYY:8301  alive   server  0.9.2  2         gitlab_consul
-```
-
-If any of the nodes isn't `alive` or if any of the three nodes are missing,
-check the [Troubleshooting section](#troubleshooting) before proceeding.
 
 #### Configuring the Database nodes
 
+1. Make sure to [configure the Consul nodes](consul.md).
 1. Make sure you collect [`CONSUL_SERVER_NODES`](#consul-information), [`PGBOUNCER_PASSWORD_HASH`](#pgbouncer-information), [`POSTGRESQL_PASSWORD_HASH`](#postgresql-information), the [number of db nodes](#postgresql-information), and the [network address](#network-information) before executing the next step.
 
 1. On the master database node, edit `/etc/gitlab/gitlab.rb` replacing values noted in the `# START user configuration` section:
@@ -570,7 +519,7 @@ Check the [Troubleshooting section](#troubleshooting) before proceeding.
 
 1. [Reconfigure GitLab] for the changes to take effect.
 
-1. Create a `.pgpass` file so Consule is able to
+1. Create a `.pgpass` file so Consul is able to
    reload pgbouncer. Enter the `PGBOUNCER_PASSWORD` twice when asked:
 
     ```sh

From f00c1718e9b9046cd7b3f153eae37ffd26b78fb4 Mon Sep 17 00:00:00 2001
From: Paul Giberson <paul@halaslabs.com>
Date: Wed, 3 Jul 2019 10:11:03 -0700
Subject: [PATCH 163/195] Updates to php:latest

---
 changelogs/unreleased/patch-29.yml        | 5 +++++
 lib/gitlab/ci/templates/PHP.gitlab-ci.yml | 2 +-
 2 files changed, 6 insertions(+), 1 deletion(-)
 create mode 100644 changelogs/unreleased/patch-29.yml

diff --git a/changelogs/unreleased/patch-29.yml b/changelogs/unreleased/patch-29.yml
new file mode 100644
index 00000000000..674c06e1259
--- /dev/null
+++ b/changelogs/unreleased/patch-29.yml
@@ -0,0 +1,5 @@
+---
+title: Updates PHP template to php:latest to ensure always targeting latest stable
+merge_request: 30319
+author: Paul Giberson
+type: changed
diff --git a/lib/gitlab/ci/templates/PHP.gitlab-ci.yml b/lib/gitlab/ci/templates/PHP.gitlab-ci.yml
index b9fee2d5731..25ea20e454f 100644
--- a/lib/gitlab/ci/templates/PHP.gitlab-ci.yml
+++ b/lib/gitlab/ci/templates/PHP.gitlab-ci.yml
@@ -1,5 +1,5 @@
 # Select image from https://hub.docker.com/_/php/
-image: php:7.1.1
+image: php:latest
 
 # Select what we should cache between builds
 cache:

From 347a8799096d2ace4e1b4577f8f79518085ffa40 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Tue, 9 Jul 2019 00:20:40 +0000
Subject: [PATCH 164/195] Update redirected links to final destination

Updating redirected links in the development, install, policy
raketasks and university dirs. Should now link to final
URL to avoid redirect hops
---
 doc/development/chatops_on_gitlabcom.md         |  8 ++++----
 doc/development/contributing/community_roles.md |  4 ++--
 doc/development/contributing/index.md           |  2 +-
 doc/development/contributing/issue_workflow.md  |  9 ++++-----
 doc/development/contributing/style_guides.md    |  8 ++++----
 doc/development/fe_guide/architecture.md        |  2 +-
 doc/development/fe_guide/emojis.md              |  4 ++--
 doc/development/fe_guide/graphql.md             |  4 +---
 doc/development/integrations/jira_connect.md    |  4 ++--
 doc/development/migration_style_guide.md        |  2 +-
 .../new_fe_guide/development/components.md      |  2 +-
 .../new_fe_guide/development/performance.md     |  4 ++--
 .../new_fe_guide/development/testing.md         |  4 ++--
 doc/development/new_fe_guide/style/html.md      |  2 +-
 doc/development/python_guide/index.md           |  3 +--
 doc/development/query_recorder.md               |  4 ++--
 doc/development/testing_guide/index.md          |  3 +--
 doc/development/ux_guide/resources.md           |  4 ++--
 doc/install/openshift_and_gitlab/index.md       | 17 ++++++++---------
 doc/install/requirements.md                     |  2 +-
 doc/policy/maintenance.md                       |  2 +-
 doc/raketasks/README.md                         |  2 +-
 doc/university/training/index.md                |  6 +++---
 23 files changed, 48 insertions(+), 54 deletions(-)

diff --git a/doc/development/chatops_on_gitlabcom.md b/doc/development/chatops_on_gitlabcom.md
index de942c0ae94..3b681880401 100644
--- a/doc/development/chatops_on_gitlabcom.md
+++ b/doc/development/chatops_on_gitlabcom.md
@@ -13,10 +13,10 @@ tasks such as:
 To request access to Chatops on GitLab.com:
 
 1. Log into <https://ops.gitlab.net/users/sign_in> using the same username as for GitLab.com.
-1. Ask [anyone in the `chatops` project](https://gitlab.com/gitlab-com/chatops/project_members) to add you by running `/chatops run member add <username> gitlab-com/chatops --ops`.
+1. Ask [anyone in the `chatops` project](https://gitlab.com/gitlab-com/chatops/-/project_members) to add you by running `/chatops run member add <username> gitlab-com/chatops --ops`.
 
 ## See also
 
- - [Chatops Usage](../ci/chatops/README.md)
- - [Understanding EXPLAIN plans](understanding_explain_plans.md)
- - [Feature Groups](feature_flags/development.md#feature-groups)
+- [Chatops Usage](../ci/chatops/README.md)
+- [Understanding EXPLAIN plans](understanding_explain_plans.md)
+- [Feature Groups](feature_flags/development.md#feature-groups)
diff --git a/doc/development/contributing/community_roles.md b/doc/development/contributing/community_roles.md
index b9c369286d2..3296cb173d7 100644
--- a/doc/development/contributing/community_roles.md
+++ b/doc/development/contributing/community_roles.md
@@ -4,8 +4,8 @@ GitLab community members and their privileges/responsibilities.
 
 | Roles | Responsibilities | Requirements |
 |-------|------------------|--------------|
-| Maintainer | Accepts merge requests on several GitLab projects | Added to the [team page](https://about.gitlab.com/team/). An expert on code reviews and knows the product/code base |
-| Reviewer | Performs code reviews on MRs | Added to the [team page](https://about.gitlab.com/team/) |
+| Maintainer | Accepts merge requests on several GitLab projects | Added to the [team page](https://about.gitlab.com/company/team/). An expert on code reviews and knows the product/code base |
+| Reviewer | Performs code reviews on MRs | Added to the [team page](https://about.gitlab.com/company/team/) |
 | Developer |Has access to GitLab internal infrastructure & issues (e.g. HR-related) | GitLab employee or a Core Team member (with an NDA) |
 | Contributor | Can make contributions to all GitLab public projects | Have a GitLab.com account |
 
diff --git a/doc/development/contributing/index.md b/doc/development/contributing/index.md
index 59cf5014da4..853882e8642 100644
--- a/doc/development/contributing/index.md
+++ b/doc/development/contributing/index.md
@@ -4,7 +4,7 @@ Thank you for your interest in contributing to GitLab. This guide details how
 to contribute to GitLab in a way that is easy for everyone.
 
 For a first-time step-by-step guide to the contribution process, please see
-["Contributing to GitLab"](https://about.gitlab.com/contributing/).
+["Contributing to GitLab"](https://about.gitlab.com/community/contribute/).
 
 Looking for something to work on? Look for issues with the label [`Accepting merge requests`](#i-want-to-contribute).
 
diff --git a/doc/development/contributing/issue_workflow.md b/doc/development/contributing/issue_workflow.md
index 27c349c03aa..910f9f4bf7a 100644
--- a/doc/development/contributing/issue_workflow.md
+++ b/doc/development/contributing/issue_workflow.md
@@ -1,7 +1,7 @@
 # Workflow labels
 
 To allow for asynchronous issue handling, we use [milestones][milestones-page]
-and [labels][labels-page]. Leads and product managers handle most of the
+and [labels](https://gitlab.com/gitlab-org/gitlab-ce/-/labels). Leads and product managers handle most of the
 scheduling into milestones. Labelling is a task for everyone.
 
 Most issues will have labels for at least one of the following:
@@ -18,7 +18,7 @@ Most issues will have labels for at least one of the following:
 - Severity: ~S1, ~S2, ~S3, ~S4
 
 All labels, their meaning and priority are defined on the
-[labels page][labels-page].
+[labels page](https://gitlab.com/gitlab-org/gitlab-ce/-/labels).
 
 If you come across an issue that has none of these, and you're allowed to set
 labels, you can _always_ add the team and type, and often also the subject.
@@ -38,7 +38,7 @@ makes them float to the top, depending on their importance.
 Type labels are always lowercase, and can have any color, besides blue (which is
 already reserved for subject labels).
 
-The descriptions on the [labels page][labels-page] explain what falls under each type label.
+The descriptions on the [labels page](https://gitlab.com/gitlab-org/gitlab-ce/-/labels) explain what falls under each type label.
 
 ## Subject labels
 
@@ -89,7 +89,7 @@ The following team labels are **true** teams per our [organization structure](ht
 - ~Delivery
 - ~Documentation
 
-The descriptions on the [labels page][labels-page] explain what falls under the
+The descriptions on the [labels page](https://gitlab.com/gitlab-org/gitlab-ce/-/labels) explain what falls under the
 responsibility of each team.
 
 Within those team labels, we also have the ~backend and ~frontend labels to
@@ -500,7 +500,6 @@ A recent example of this was the issue for
 
 [Return to Contributing documentation](index.md)
 
-[labels-page]: https://gitlab.com/gitlab-org/gitlab-ce/labels
 [ce-tracker]: https://gitlab.com/gitlab-org/gitlab-ce/issues
 [ee-tracker]: https://gitlab.com/gitlab-org/gitlab-ee/issues
 [inferred-labels]: https://gitlab.com/gitlab-org/quality/triage-ops/merge_requests/155
diff --git a/doc/development/contributing/style_guides.md b/doc/development/contributing/style_guides.md
index 87e61a7476f..5c6ea1f469d 100644
--- a/doc/development/contributing/style_guides.md
+++ b/doc/development/contributing/style_guides.md
@@ -1,11 +1,11 @@
 # Style guides
 
-1. [Ruby](https://github.com/bbatsov/ruby-style-guide).
+1. [Ruby](https://github.com/rubocop-hq/ruby-style-guide).
    Important sections include [Source Code Layout][rss-source] and
    [Naming][rss-naming]. Use:
    - multi-line method chaining style **Option A**: dot `.` on the second line
    - string literal quoting style **Option A**: single quoted by default
-1. [Rails](https://github.com/bbatsov/rails-style-guide)
+1. [Rails](https://github.com/rubocop-hq/rails-style-guide)
 1. [Newlines styleguide][newlines-styleguide]
 1. [Testing][testing]
 1. [JavaScript styleguide][js-styleguide]
@@ -13,7 +13,7 @@
 1. [Shell commands (Ruby)](../shell_commands.md) created by GitLab
    contributors to enhance security
 1. [Database Migrations](../migration_style_guide.md)
-1. [Markdown](http://www.cirosantilli.com/markdown-styleguide)
+1. [Markdown](https://cirosantilli.com/markdown-style-guide/)
 1. [Documentation styleguide](../documentation/styleguide.md)
 1. Interface text should be written subjectively instead of objectively. It
    should be the GitLab core team addressing a person. It should be written in
@@ -25,7 +25,7 @@
 1. [Python](../python_guide/index.md)
 
 This is also the style used by linting tools such as
-[RuboCop](https://github.com/bbatsov/rubocop) and [Hound CI](https://houndci.com).
+[RuboCop](https://github.com/rubocop-hq/rubocop) and [Hound CI](https://houndci.com).
 
 ---
 
diff --git a/doc/development/fe_guide/architecture.md b/doc/development/fe_guide/architecture.md
index c67389b169e..49b74b5ebcf 100644
--- a/doc/development/fe_guide/architecture.md
+++ b/doc/development/fe_guide/architecture.md
@@ -11,7 +11,7 @@ Architectural decisions should be accessible to everyone, so please document
 them in the relevant Merge Request discussion or by updating our documentation
 when appropriate.
 
-You can find the Frontend Architecture experts on the [team page](https://about.gitlab.com/team).
+You can find the Frontend Architecture experts on the [team page](https://about.gitlab.com/company/team).
 
 ## Examples
 
diff --git a/doc/development/fe_guide/emojis.md b/doc/development/fe_guide/emojis.md
index 38794c47965..6d324d4c4a0 100644
--- a/doc/development/fe_guide/emojis.md
+++ b/doc/development/fe_guide/emojis.md
@@ -3,10 +3,10 @@
 GitLab supports native unicode emojis and fallsback to image-based emojis selectively
 when your platform does not support it.
 
-# How to update Emojis
+## How to update Emojis
 
  1. Update the `gemojione` gem
- 1. Update `fixtures/emojis/index.json` from [Gemojione](https://github.com/jonathanwiesel/gemojione/blob/master/config/index.json).
+ 1. Update `fixtures/emojis/index.json` from [Gemojione](https://github.com/bonusly/gemojione/blob/master/config/index.json).
     In the future, we could grab the file directly from the gem.
     We should probably make a PR on the Gemojione project to get access to
     all emojis after being parsed or just a raw path to the `json` file itself.
diff --git a/doc/development/fe_guide/graphql.md b/doc/development/fe_guide/graphql.md
index 9fcd32fddfa..55b719227e5 100644
--- a/doc/development/fe_guide/graphql.md
+++ b/doc/development/fe_guide/graphql.md
@@ -55,7 +55,6 @@ It is possible to manage an application state with Apollo by passing
 in a resolvers object when creating the default client. The default state can be set by writing
 to the cache after setting up the default client.
 
-
 ```javascript
 import Vue from 'vue';
 import VueApollo from 'vue-apollo';
@@ -115,13 +114,12 @@ defaultClient.query(query)
   .then(result => console.log(result));
 ```
 
-Read more about the [Apollo] client in the [Apollo documentation][apollo-client-docs].
+Read more about the [Apollo] client in the [Apollo documentation](https://www.apollographql.com/docs/tutorial/client/).
 
 [Apollo]: https://www.apollographql.com/
 [vue-apollo]: https://github.com/Akryum/vue-apollo/
 [vue-apollo-docs]: https://akryum.github.io/vue-apollo/
 [feature-flags]: ../feature_flags.md
 [default-client]: https://gitlab.com/gitlab-org/gitlab-ce/blob/master/app/assets/javascripts/lib/graphql.js
-[apollo-client-docs]: https://www.apollographql.com/docs/tutorial/client.html
 [vue-test-utils]: https://vue-test-utils.vuejs.org/
 [apollo-link-state]: https://www.apollographql.com/docs/link/links/state.html
diff --git a/doc/development/integrations/jira_connect.md b/doc/development/integrations/jira_connect.md
index 5bf43d320c6..9ba3b922fd8 100644
--- a/doc/development/integrations/jira_connect.md
+++ b/doc/development/integrations/jira_connect.md
@@ -4,7 +4,7 @@ The following are required to install and test the app:
 
 1. A Jira Cloud instance
 
-   Atlassian provides free instances for development and testing. [Click here to sign up](http://go.atlassian.com/cloud-dev).
+   Atlassian provides free instances for development and testing. [Click here to sign up](https://developer.atlassian.com/platform/marketplace/getting-started/#free-developer-instances-to-build-and-test-your-app).
 
 1. A GitLab instance available over the internet
 
@@ -15,7 +15,7 @@ The following are required to install and test the app:
 
 > This feature is currently behind the `:jira_connect_app` feature flag
 
-# Installing the app in Jira
+## Installing the app in Jira
 
 1. Enable Jira development mode to install apps that are not from the Atlassian Marketplace
 
diff --git a/doc/development/migration_style_guide.md b/doc/development/migration_style_guide.md
index 9b26f691b55..0c7601b415e 100644
--- a/doc/development/migration_style_guide.md
+++ b/doc/development/migration_style_guide.md
@@ -21,7 +21,7 @@ When downtime is necessary the migration has to be approved by:
 1. A Database Specialist
 
 An up-to-date list of people holding these titles can be found at
-<https://about.gitlab.com/team/>.
+<https://about.gitlab.com/company/team/>.
 
 When writing your migrations, also consider that databases might have stale data
 or inconsistencies and guard for that. Try to make as few assumptions as
diff --git a/doc/development/new_fe_guide/development/components.md b/doc/development/new_fe_guide/development/components.md
index 963ce53423b..cebdc87eab9 100644
--- a/doc/development/new_fe_guide/development/components.md
+++ b/doc/development/new_fe_guide/development/components.md
@@ -13,7 +13,7 @@ D3 is very popular across many projects outside of GitLab:
 
 - [The New York Times](https://archive.nytimes.com/www.nytimes.com/interactive/2012/02/13/us/politics/2013-budget-proposal-graphic.html)
 - [plot.ly](https://plot.ly/)
-- [Droptask](https://www.droptask.com/)
+- [Droptask](https://www.ayoa.com/previously-droptask/)
 
 Within GitLab, D3 has been used for the following notable features
 
diff --git a/doc/development/new_fe_guide/development/performance.md b/doc/development/new_fe_guide/development/performance.md
index 640a8d64176..c54b8305991 100644
--- a/doc/development/new_fe_guide/development/performance.md
+++ b/doc/development/new_fe_guide/development/performance.md
@@ -2,10 +2,10 @@
 
 ## Monitoring
 
-We have a performance dashboard available in one of our [grafana instances](https://dashboards.gitlab.net/d/1EBTz3Dmz/sitespeed-page-summary?orgId=1). This dashboard automatically aggregates metric data from [sitespeed.io](https://sitespeed.io) every 6 hours. These changes are displayed after a set number of pages are aggregated.
+We have a performance dashboard available in one of our [grafana instances](https://dashboards.gitlab.net/d/1EBTz3Dmz/sitespeed-page-summary?orgId=1). This dashboard automatically aggregates metric data from [sitespeed.io](https://www.sitespeed.io/) every 6 hours. These changes are displayed after a set number of pages are aggregated.
 
 These pages can be found inside a text file in the gitlab-build-images [repository](https://gitlab.com/gitlab-org/gitlab-build-images) called [gitlab.txt](https://gitlab.com/gitlab-org/gitlab-build-images/blob/master/scripts/gitlab.txt)
-Any frontend engineer can contribute to this dashboard. They can contribute by adding or removing urls of pages from this text file. Please have a [frontend monitoring expert](https://about.gitlab.com/team) review your changes before assigning to a maintainer of the `gitlab-build-images` project. The changes will go live on the next scheduled run after the changes are merged into `master`.
+Any frontend engineer can contribute to this dashboard. They can contribute by adding or removing urls of pages from this text file. Please have a [frontend monitoring expert](https://about.gitlab.com/company/team) review your changes before assigning to a maintainer of the `gitlab-build-images` project. The changes will go live on the next scheduled run after the changes are merged into `master`.
 
 There are 3 recommended high impact metrics to review on each page:
 
diff --git a/doc/development/new_fe_guide/development/testing.md b/doc/development/new_fe_guide/development/testing.md
index 8441089418e..2b62c2a41fe 100644
--- a/doc/development/new_fe_guide/development/testing.md
+++ b/doc/development/new_fe_guide/development/testing.md
@@ -261,7 +261,7 @@ scenario 'successfully', :js do
 end
 ```
 
-The steps of each test are written using capybara methods ([documentation](http://www.rubydoc.info/gems/capybara/2.15.1)).
+The steps of each test are written using capybara methods ([documentation](https://www.rubydoc.info/gems/capybara/2.15.1)).
 
 Bear in mind <abbr title="XMLHttpRequest">XHR</abbr> calls might require you to use `wait_for_requests` in between steps, like so:
 
@@ -277,7 +277,7 @@ expect(page).not_to have_selector('.card')
 
 ### Vuex Helper: `testAction`
 
-We have a helper available to make testing actions easier, as per [official documentation](https://vuex.vuejs.org/en/testing.html):
+We have a helper available to make testing actions easier, as per [official documentation](https://vuex.vuejs.org/guide/testing.html):
 
 ```
 testAction(
diff --git a/doc/development/new_fe_guide/style/html.md b/doc/development/new_fe_guide/style/html.md
index e8c9c2ccebf..1445da3f0e1 100644
--- a/doc/development/new_fe_guide/style/html.md
+++ b/doc/development/new_fe_guide/style/html.md
@@ -16,7 +16,7 @@ Button tags requires a `type` attribute according to the [W3C HTML specification
 
 ### Button role
 
-If an HTML element has an `onClick` handler but is not a button, it should have `role="button"`. This is [more accessible](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_button_role).
+If an HTML element has an `onClick` handler but is not a button, it should have `role="button"`. This is [more accessible](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/button_role).
 
 ```html
 // bad
diff --git a/doc/development/python_guide/index.md b/doc/development/python_guide/index.md
index 6025dc9ebf2..a80bee27d4a 100644
--- a/doc/development/python_guide/index.md
+++ b/doc/development/python_guide/index.md
@@ -36,7 +36,7 @@ You can read more about it in: <https://github.com/pyenv/pyenv-installer#prerequ
 Pyenv installation will add required changes to Bash. If you use a different shell,
 check for any additional steps required for it.
 
-For Fish, you can install a plugin for [Fisherman](https://github.com/fisherman/fisherman):
+For Fish, you can install a plugin for [Fisher](https://github.com/jorgebucaran/fisher):
 
 ```bash
 fisher add fisherman/pyenv
@@ -76,4 +76,3 @@ pipenv shell
 
 After running that command, you can run GitLab on the same shell and it will be using the Python and dependencies
 installed from the `pipenv install` command.
-
diff --git a/doc/development/query_recorder.md b/doc/development/query_recorder.md
index 2167ed57428..a6b60149ea4 100644
--- a/doc/development/query_recorder.md
+++ b/doc/development/query_recorder.md
@@ -1,6 +1,6 @@
 # QueryRecorder
 
-QueryRecorder is a tool for detecting the [N+1 queries problem](http://guides.rubyonrails.org/active_record_querying.html#eager-loading-associations) from tests.
+QueryRecorder is a tool for detecting the [N+1 queries problem](https://guides.rubyonrails.org/active_record_querying.html#eager-loading-associations) from tests.
 
 > Implemented in [spec/support/query_recorder.rb](https://gitlab.com/gitlab-org/gitlab-ce/blob/master/spec/support/helpers/query_recorder.rb) via [9c623e3e](https://gitlab.com/gitlab-org/gitlab-ce/commit/9c623e3e5d7434f2e30f7c389d13e5af4ede770a)
 
@@ -86,4 +86,4 @@ QueryRecorder SQL: SELECT COUNT(*) FROM "issues" WHERE "issues"."deleted_at" IS
 
 - [Bullet](profiling.md#Bullet) For finding `N+1` query problems
 - [Performance guidelines](performance.md)
-- [Merge request performance guidelines](merge_request_performance_guidelines.md#query-counts)
\ No newline at end of file
+- [Merge request performance guidelines](merge_request_performance_guidelines.md#query-counts)
diff --git a/doc/development/testing_guide/index.md b/doc/development/testing_guide/index.md
index c4b18391cb2..aadbea1a540 100644
--- a/doc/development/testing_guide/index.md
+++ b/doc/development/testing_guide/index.md
@@ -11,7 +11,7 @@ importance.
 
 ## Overview
 
-GitLab is built on top of [Ruby on Rails][rails], and we're using [RSpec] for all
+GitLab is built on top of [Ruby on Rails](https://rubyonrails.org/), and we're using [RSpec] for all
 the backend tests, with [Capybara] for end-to-end integration testing.
 On the frontend side, we're using [Karma] and [Jasmine] for JavaScript unit and
 integration testing.
@@ -80,7 +80,6 @@ Everything you should know about how to run end-to-end tests using
 
 [Return to Development documentation](../README.md)
 
-[rails]: http://rubyonrails.org/
 [RSpec]: https://github.com/rspec/rspec-rails#feature-specs
 [Capybara]: https://github.com/teamcapybara/capybara
 [Karma]: http://karma-runner.github.io/
diff --git a/doc/development/ux_guide/resources.md b/doc/development/ux_guide/resources.md
index baec235a8dd..ae092246d05 100644
--- a/doc/development/ux_guide/resources.md
+++ b/doc/development/ux_guide/resources.md
@@ -1,5 +1,5 @@
 ---
-redirect_to: 'https://design.gitlab.com/resources/design-resources'
+redirect_to: 'https://design.gitlab.com/resources/design-resources/'
 ---
 
-The content of this document was moved into the [GitLab Design System](https://design.gitlab.com/).
+The content of this document was moved into the [GitLab Design System](https://design.gitlab.com/resources/design-resources/).
diff --git a/doc/install/openshift_and_gitlab/index.md b/doc/install/openshift_and_gitlab/index.md
index 45d07ec5d11..e4a2d9ecd68 100644
--- a/doc/install/openshift_and_gitlab/index.md
+++ b/doc/install/openshift_and_gitlab/index.md
@@ -13,8 +13,8 @@ for details.
 
 ## Introduction
 
-[OpenShift Origin][openshift] is an open source container application
-platform created by [RedHat], based on [kubernetes] and [Docker]. That means
+[OpenShift Origin](https://www.okd.io/) (**Note:** renamed to OKD in Aug 2018) is an open source container application
+platform created by [RedHat], based on [kubernetes](https://kubernetes.io/) and [Docker]. That means
 you can host your own PaaS for free and almost with no hassle.
 
 In this tutorial, we will see how to deploy GitLab in OpenShift using GitLab's
@@ -27,8 +27,11 @@ For a video demonstration on installing GitLab on OpenShift, check the article [
 
 ## Prerequisites
 
-OpenShift 3 is not yet deployed on RedHat's offered Online platform ([openshift.com]),
-so in order to test it, we will use an [all-in-one Virtualbox image][vm] that is
+CAUTION: **Caution:** This information is no longer up to date, as the current versions
+have changed and products have been renamed.
+
+OpenShift 3 is not yet deployed on RedHat's offered Online platform, [openshift.com](https://www.openshift.com/),
+so in order to test it, we will use an [all-in-one Virtualbox image](https://www.okd.io/minishift/) that is
 offered by the OpenShift developers and managed by Vagrant. If you haven't done
 already, go ahead and install the following components as they are essential to
 test OpenShift easily:
@@ -458,7 +461,7 @@ OpenShift's website about [autoscaling].
 
 ## Current limitations
 
-As stated in the [all-in-one VM][vm] page:
+As stated in the [all-in-one VM](https://www.okd.io/minishift/) page:
 
 > By default, OpenShift will not allow a container to run as root or even a
 non-random container assigned userid. Most Docker images in the Dockerhub do not
@@ -506,12 +509,8 @@ is capable of. As always, you can refer to the detailed
 PaaS and managing your applications with the ease of containers.
 
 [RedHat]: https://www.redhat.com/en "RedHat website"
-[openshift]: https://www.openshift.org "OpenShift Origin website"
-[vm]: https://www.openshift.org/vm/ "OpenShift All-in-one VM"
 [vm-new]: https://app.vagrantup.com/openshift/boxes/origin-all-in-one "Official OpenShift Vagrant box on Vagrant Cloud"
 [template]: https://gitlab.com/gitlab-org/omnibus-gitlab/blob/master/docker/openshift-template.json "OpenShift template for GitLab"
-[openshift.com]: https://openshift.com "OpenShift Online"
-[kubernetes]: http://kubernetes.io/ "Kubernetes website"
 [Docker]: https://www.docker.com "Docker website"
 [oc]: https://docs.openshift.org/latest/cli_reference/get_started_cli.html "Documentation - oc CLI documentation"
 [VirtualBox]: https://www.virtualbox.org/wiki/Downloads "VirtualBox downloads"
diff --git a/doc/install/requirements.md b/doc/install/requirements.md
index 68c1bcbc801..25ab608de3a 100644
--- a/doc/install/requirements.md
+++ b/doc/install/requirements.md
@@ -30,7 +30,7 @@ For the installations options, see [the main installation page](README.md).
 - macOS
 
 Installation of GitLab on these operating systems is possible, but not supported.
-Please see the [installation from source guide](installation.md) and the [installation guides](https://about.gitlab.com/installation/) for more information.
+Please see the [installation from source guide](installation.md) and the [installation guides](https://about.gitlab.com/install/) for more information.
 
 ### Microsoft Windows
 
diff --git a/doc/policy/maintenance.md b/doc/policy/maintenance.md
index 72bace3d282..018c273c51a 100644
--- a/doc/policy/maintenance.md
+++ b/doc/policy/maintenance.md
@@ -9,7 +9,7 @@ patch and security releases. New releases are usually announced on the [GitLab b
 
 ## Versioning
 
-GitLab uses [Semantic Versioning](http://semver.org/) for its releases:
+GitLab uses [Semantic Versioning](https://semver.org/) for its releases:
 `(Major).(Minor).(Patch)` in a [pragmatic way](https://gist.github.com/jashkenas/cbd2b088e20279ae2c8e).
 
 For example, for GitLab version 10.5.7:
diff --git a/doc/raketasks/README.md b/doc/raketasks/README.md
index b28f21f83a9..dcc96507676 100644
--- a/doc/raketasks/README.md
+++ b/doc/raketasks/README.md
@@ -9,7 +9,7 @@ comments: false
 - [Cleanup](cleanup.md)
 - [Features](features.md)
 - [LDAP Maintenance](../administration/raketasks/ldap.md)
-- [General Maintenance](maintenance.md) and self-checks
+- [General Maintenance](../administration/raketasks/maintenance.md) and self-checks
 - [User management](user_management.md)
 - [Webhooks](web_hooks.md)
 - [Import](import.md) of git repositories in bulk
diff --git a/doc/university/training/index.md b/doc/university/training/index.md
index 4c8ae0d9ce8..61fde9d8336 100644
--- a/doc/university/training/index.md
+++ b/doc/university/training/index.md
@@ -6,7 +6,7 @@ type: index
 # GitLab Training Material
 
 All GitLab training material is stored in markdown format. Slides are
-generated using [Deskset](http://www.decksetapp.com/).
+generated using [Deskset](https://www.deckset.com/).
 
 All training material is open to public contribution.
 
@@ -35,8 +35,8 @@ This section contains the following topics:
 ## Additional Resources
 
 1. [GitLab Documentation](https://docs.gitlab.com)
-1. [GUI Clients](http://git-scm.com/downloads/guis)
-1. [Pro Git book](http://git-scm.com/book)
+1. [GUI Clients](https://git-scm.com/downloads/guis)
+1. [Pro Git book](https://git-scm.com/book/en/v2)
 1. [Platzi Course](https://courses.platzi.com/courses/git-gitlab/)
 1. [Code School tutorial](http://try.github.io/)
 1. Contact us at `subscribers@gitlab.com`

From 30e5b31eea5f1cab88db57aa681bcbf21f115741 Mon Sep 17 00:00:00 2001
From: Robert Speicher <rspeicher@gmail.com>
Date: Mon, 8 Jul 2019 20:06:24 -0500
Subject: [PATCH 165/195] Add frozen_string_literal to EE files now in CE

---
 config/initializers/0_license.rb            | 2 ++
 config/initializers/elastic_client_setup.rb | 2 ++
 config/initializers/geo.rb                  | 2 ++
 config/initializers/load_balancing.rb       | 2 ++
 config/initializers/sidekiq_cluster.rb      | 2 ++
 5 files changed, 10 insertions(+)

diff --git a/config/initializers/0_license.rb b/config/initializers/0_license.rb
index 0d101517c79..f750022dfdf 100644
--- a/config/initializers/0_license.rb
+++ b/config/initializers/0_license.rb
@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 Gitlab.ee do
   begin
     public_key_file = File.read(Rails.root.join(".license_encryption_key.pub"))
diff --git a/config/initializers/elastic_client_setup.rb b/config/initializers/elastic_client_setup.rb
index 0f6d494ba3c..2ecb7956007 100644
--- a/config/initializers/elastic_client_setup.rb
+++ b/config/initializers/elastic_client_setup.rb
@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Be sure to restart your server when you modify this file.
 
 require 'gitlab/current_settings'
diff --git a/config/initializers/geo.rb b/config/initializers/geo.rb
index b820f629d92..4cc9fbf49b2 100644
--- a/config/initializers/geo.rb
+++ b/config/initializers/geo.rb
@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 Gitlab.ee do
   if File.exist?(Rails.root.join('config/database_geo.yml'))
     Rails.application.configure do
diff --git a/config/initializers/load_balancing.rb b/config/initializers/load_balancing.rb
index 1ac422a6e8a..029c0ff4277 100644
--- a/config/initializers/load_balancing.rb
+++ b/config/initializers/load_balancing.rb
@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # We need to run this initializer after migrations are done so it doesn't fail on CI
 
 Gitlab.ee do
diff --git a/config/initializers/sidekiq_cluster.rb b/config/initializers/sidekiq_cluster.rb
index cbf8caef706..baa7495aa29 100644
--- a/config/initializers/sidekiq_cluster.rb
+++ b/config/initializers/sidekiq_cluster.rb
@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 if ENV['ENABLE_SIDEKIQ_CLUSTER'] && Gitlab.ee?
   Thread.new do
     Thread.current.abort_on_exception = true

From 385233981aca05f5c2ac2cf68af3688539bba62e Mon Sep 17 00:00:00 2001
From: Markus Koller <mkoller@gitlab.com>
Date: Tue, 9 Jul 2019 03:01:04 +0000
Subject: [PATCH 166/195] Centralize config for markdownlint

The configuration is currently only specified in CI, by moving it into
`.mdlrc` we get immediate feedback locally in supported editors.

To ensure `mdl` is available it's also added to the `Gemfile`, though
CI will still use the version installed in the `gitlab-docs-lint` image.
---
 .gitlab/ci/docs.gitlab-ci.yml                          |  4 +---
 .mdlrc                                                 |  4 ++++
 .mdlrc.style                                           |  7 +++++++
 Gemfile                                                |  1 +
 Gemfile.lock                                           | 10 ++++++++++
 .../unreleased/centralize-markdownlint-config.yml      |  5 +++++
 doc/ci/docker/using_docker_images.md                   | 10 +++++-----
 doc/development/documentation/styleguide.md            |  4 ++--
 doc/user/project/deploy_tokens/index.md                |  2 +-
 9 files changed, 36 insertions(+), 11 deletions(-)
 create mode 100644 .mdlrc
 create mode 100644 .mdlrc.style
 create mode 100644 changelogs/unreleased/centralize-markdownlint-config.yml

diff --git a/.gitlab/ci/docs.gitlab-ci.yml b/.gitlab/ci/docs.gitlab-ci.yml
index 57ee91e4385..5bc109f2b7f 100644
--- a/.gitlab/ci/docs.gitlab-ci.yml
+++ b/.gitlab/ci/docs.gitlab-ci.yml
@@ -66,9 +66,7 @@ docs lint:
     - mv doc/ /tmp/gitlab-docs/content/$DOCS_GITLAB_REPO_SUFFIX
     - cd /tmp/gitlab-docs
     # Lint Markdown
-    # https://github.com/markdownlint/markdownlint/blob/master/docs/RULES.md
-    - bundle exec mdl content/$DOCS_GITLAB_REPO_SUFFIX/**/*.md --ignore-front-matter --rules \
-        MD001,MD032,MD034
+    - bundle exec mdl content/$DOCS_GITLAB_REPO_SUFFIX -c $CI_PROJECT_DIR/.mdlrc
     # Build HTML from Markdown
     - bundle exec nanoc
     # Check the internal links
diff --git a/.mdlrc b/.mdlrc
new file mode 100644
index 00000000000..b2127dadc22
--- /dev/null
+++ b/.mdlrc
@@ -0,0 +1,4 @@
+# See https://github.com/markdownlint/markdownlint/blob/master/docs/configuration.md
+
+ignore_front_matter true
+style File.expand_path('.mdlrc.style', __dir__)
diff --git a/.mdlrc.style b/.mdlrc.style
new file mode 100644
index 00000000000..30abf03f462
--- /dev/null
+++ b/.mdlrc.style
@@ -0,0 +1,7 @@
+# See https://github.com/markdownlint/markdownlint/blob/master/docs/RULES.md
+
+rule 'MD001'
+# False positives, see https://github.com/markdownlint/markdownlint/issues/261
+# rule 'MD004', style: :dash
+rule 'MD032'
+rule 'MD034'
diff --git a/Gemfile b/Gemfile
index f567eac3ee0..33f9c4650ef 100644
--- a/Gemfile
+++ b/Gemfile
@@ -368,6 +368,7 @@ group :development, :test do
   gem 'haml_lint', '~> 0.31.0', require: false
   gem 'simplecov', '~> 0.16.1', require: false
   gem 'bundler-audit', '~> 0.5.0', require: false
+  gem 'mdl', '~> 0.5.0', require: false
 
   gem 'benchmark-ips', '~> 2.3.0', require: false
 
diff --git a/Gemfile.lock b/Gemfile.lock
index 668cfff4fb4..c8b8f0e4f90 100644
--- a/Gemfile.lock
+++ b/Gemfile.lock
@@ -459,6 +459,7 @@ GEM
     kgio (2.11.2)
     knapsack (1.17.0)
       rake
+    kramdown (1.17.0)
     kubeclient (4.2.2)
       http (~> 3.0)
       recursive-open-struct (~> 1.0, >= 1.0.4)
@@ -492,6 +493,10 @@ GEM
     mail (2.7.1)
       mini_mime (>= 0.1.1)
     mail_room (0.9.1)
+    mdl (0.5.0)
+      kramdown (~> 1.12, >= 1.12.0)
+      mixlib-cli (~> 1.7, >= 1.7.0)
+      mixlib-config (~> 2.2, >= 2.2.1)
     memoist (0.16.0)
     memoizable (0.4.2)
       thread_safe (~> 0.3, >= 0.3.1)
@@ -505,6 +510,9 @@ GEM
     mini_mime (1.0.1)
     mini_portile2 (2.4.0)
     minitest (5.11.3)
+    mixlib-cli (1.7.0)
+    mixlib-config (2.2.18)
+      tomlrb
     msgpack (1.2.10)
     multi_json (1.13.1)
     multi_xml (0.6.0)
@@ -943,6 +951,7 @@ GEM
       parslet (~> 1.8.0)
     toml-rb (1.0.0)
       citrus (~> 3.0, > 3.0)
+    tomlrb (1.2.8)
     truncato (0.7.11)
       htmlentities (~> 4.3.1)
       nokogiri (>= 1.7.0, <= 2.0)
@@ -1134,6 +1143,7 @@ DEPENDENCIES
   lograge (~> 0.5)
   loofah (~> 2.2)
   mail_room (~> 0.9.1)
+  mdl (~> 0.5.0)
   memory_profiler (~> 0.9)
   method_source (~> 0.8)
   mimemagic (~> 0.3.2)
diff --git a/changelogs/unreleased/centralize-markdownlint-config.yml b/changelogs/unreleased/centralize-markdownlint-config.yml
new file mode 100644
index 00000000000..9ca36078cf1
--- /dev/null
+++ b/changelogs/unreleased/centralize-markdownlint-config.yml
@@ -0,0 +1,5 @@
+---
+title: Centralize markdownlint configuration
+merge_request: 30263
+author:
+type: other
diff --git a/doc/ci/docker/using_docker_images.md b/doc/ci/docker/using_docker_images.md
index 816bd35018a..2d7fb323d79 100644
--- a/doc/ci/docker/using_docker_images.md
+++ b/doc/ci/docker/using_docker_images.md
@@ -530,11 +530,11 @@ There are two ways to determine the value of `DOCKER_AUTH_CONFIG`:
     ```
 
 - **Second way -** In some setups, it's possible that Docker client
-will use the available system keystore to store the result of `docker
-login`. In that case, it's impossible to read `~/.docker/config.json`,
-so you will need to prepare the required base64-encoded version of
-`${username}:${password}` manually. Open a terminal and execute the
-following command:
+  will use the available system keystore to store the result of `docker
+  login`. In that case, it's impossible to read `~/.docker/config.json`,
+  so you will need to prepare the required base64-encoded version of
+  `${username}:${password}` manually. Open a terminal and execute the
+  following command:
 
     ```bash
     echo -n "my_username:my_password" | base64
diff --git a/doc/development/documentation/styleguide.md b/doc/development/documentation/styleguide.md
index 7127efb7405..d9cea0614c3 100644
--- a/doc/development/documentation/styleguide.md
+++ b/doc/development/documentation/styleguide.md
@@ -518,7 +518,7 @@ you have your MR reviewed and approved by a technical writer.
 ```html
 leave a blank line here
 <div class="video-fallback">
-  See the video: [Video title](https://www.youtube.com/watch?v=MqL6BMOySIQ).
+  See the video: <a href="https://www.youtube.com/watch?v=MqL6BMOySIQ">Video title</a>.
 </div>
 <figure class="video-container">
   <iframe src="https://www.youtube.com/embed/MqL6BMOySIQ" frameborder="0" allowfullscreen="true"> </iframe>
@@ -529,7 +529,7 @@ leave a blank line here
 This is how it renders on docs.gitlab.com:
 
 <div class="video-fallback">
-  See the video: [What is GitLab](https://www.youtube.com/watch?v=enMumwvLAug).
+  See the video: <a href="https://www.youtube.com/watch?v=enMumwvLAug">What is GitLab</a>.
 </div>
 <figure class="video-container">
   <iframe src="https://www.youtube.com/embed/MqL6BMOySIQ" frameborder="0" allowfullscreen="true"> </iframe>
diff --git a/doc/user/project/deploy_tokens/index.md b/doc/user/project/deploy_tokens/index.md
index 5e11e7c0203..72594733cd3 100644
--- a/doc/user/project/deploy_tokens/index.md
+++ b/doc/user/project/deploy_tokens/index.md
@@ -41,7 +41,7 @@ the following table.
 
 ## Deploy token custom username
 
-> [Introduced][https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/29639] in GitLab 12.1.
+> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/29639) in GitLab 12.1.
 
 The default username format is `gitlab+deploy-token-#{n}`. Some tools or platforms may not support this format,
 in such case you can specify custom username to be used when creating the deploy token.

From 25aa4e0322cc44b9f2167cb6569b34c13afd12f1 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Tue, 9 Jul 2019 03:28:41 +0000
Subject: [PATCH 167/195] Remove extra whitespaces in docs

Removes all the extra whitespaces at end of lines,
inside tags, and removes extra newlines
---
 doc/administration/job_traces.md              |  2 +-
 doc/administration/packages.md                |  2 +-
 doc/administration/pseudonymizer.md           |  4 +-
 .../repository_storage_types.md               | 14 +++----
 doc/api/boards.md                             |  1 -
 doc/api/deploy_keys.md                        |  4 +-
 doc/api/epics.md                              |  2 +-
 doc/api/issue_links.md                        |  3 --
 doc/api/issues.md                             |  6 +--
 doc/api/issues_statistics.md                  |  7 ++--
 doc/api/jobs.md                               |  3 +-
 doc/api/license.md                            |  1 -
 doc/api/managed_licenses.md                   |  2 +-
 doc/api/merge_request_approvals.md            |  2 -
 doc/api/oauth2.md                             |  2 +-
 doc/api/packages.md                           |  2 +-
 doc/api/project_badges.md                     |  2 +-
 doc/api/project_statistics.md                 |  2 +-
 doc/api/project_templates.md                  |  4 +-
 doc/api/scim.md                               |  2 +-
 .../system_header_and_footer_messages.md      |  4 +-
 doc/development/api_styleguide.md             |  2 +-
 doc/development/code_comments.md              |  6 +--
 doc/development/emails.md                     |  2 +-
 .../licensed_feature_availability.md          | 20 +++++-----
 doc/development/newlines_styleguide.md        |  4 +-
 doc/development/packages.md                   | 38 +++++++++----------
 .../understanding_explain_plans.md            |  1 -
 28 files changed, 67 insertions(+), 77 deletions(-)

diff --git a/doc/administration/job_traces.md b/doc/administration/job_traces.md
index aa9d87562a3..6556614723d 100644
--- a/doc/administration/job_traces.md
+++ b/doc/administration/job_traces.md
@@ -72,7 +72,7 @@ To archive those legacy job traces, please follow the instruction below.
     ```
 
     After you executed this task, GitLab instance queues up Sidekiq jobs (asynchronous processes)
-    for migrating job trace files from local storage to object storage. 
+    for migrating job trace files from local storage to object storage.
     It could take time to complete the all migration jobs. You can check the progress by the following command
 
     ```bash
diff --git a/doc/administration/packages.md b/doc/administration/packages.md
index cc7d76d61f6..1da8de12188 100644
--- a/doc/administration/packages.md
+++ b/doc/administration/packages.md
@@ -11,7 +11,7 @@ The Packages feature allows GitLab to act as a repository for the following:
 | [Maven Repository](../user/project/packages/maven_repository.md) | The GitLab Maven Repository enables every project in GitLab to have its own space to store [Maven](https://maven.apache.org/) packages. | 11.3+ |
 | [NPM Registry](../user/project/packages/npm_registry.md)   | The GitLab NPM Registry enables every project in GitLab to have its own space to store [NPM](https://www.npmjs.com/) packages. | 11.7+ |
 
-Don't you see your package management system supported yet? 
+Don't you see your package management system supported yet?
 Please consider contributing
 to GitLab. This [development documentation](../development/packages.md) will guide you through the process.
 
diff --git a/doc/administration/pseudonymizer.md b/doc/administration/pseudonymizer.md
index faa565118ce..3278409d4b5 100644
--- a/doc/administration/pseudonymizer.md
+++ b/doc/administration/pseudonymizer.md
@@ -22,9 +22,9 @@ To configure the pseudonymizer, you need to:
 
 - Provide a manifest file that describes which fields should be included or
   pseudonymized ([example `manifest.yml` file](https://gitlab.com/gitlab-org/gitlab-ee/tree/master/config/pseudonymizer.yml)).
-  A default manifest is provided with the GitLab installation. Using a relative file path will be resolved from the Rails root. 
+  A default manifest is provided with the GitLab installation. Using a relative file path will be resolved from the Rails root.
   Alternatively, you can use an absolute file path.
-- Use an object storage and specify the connection parameters in the `pseudonymizer.upload.connection` configuration option. 
+- Use an object storage and specify the connection parameters in the `pseudonymizer.upload.connection` configuration option.
 
 **For Omnibus installations:**
 
diff --git a/doc/administration/repository_storage_types.md b/doc/administration/repository_storage_types.md
index 834b41b3a2c..f4cb89c84a4 100644
--- a/doc/administration/repository_storage_types.md
+++ b/doc/administration/repository_storage_types.md
@@ -6,19 +6,19 @@ Two different storage layouts can be used
 to store the repositories on disk and their characteristics.
 
 GitLab can be configured to use one or multiple repository shard locations
-that can be: 
+that can be:
 
 - Mounted to the local disk
 - Exposed as an NFS shared volume
 - Acessed via [gitaly] on its own machine.
 
 In GitLab, this is configured in `/etc/gitlab/gitlab.rb` by the `git_data_dirs({})`
-configuration hash. The storage layouts discussed here will apply to any shard 
+configuration hash. The storage layouts discussed here will apply to any shard
 defined in it.
 
 The `default` repository shard that is available in any installations
 that haven't customized it, points to the local folder: `/var/opt/gitlab/git-data`.
-Anything discussed below is expected to be part of that folder. 
+Anything discussed below is expected to be part of that folder.
 
 ## Legacy Storage
 
@@ -108,7 +108,7 @@ question.
 ### How to migrate to Hashed Storage
 
 To start a migration, enable Hashed Storage for new projects:
- 
+
 1. Go to **Admin > Settings > Repository** and expand the **Repository Storage** section.
 2. Select the **Use hashed storage paths for newly created and renamed projects** checkbox.
 
@@ -129,7 +129,7 @@ an Omnibus Gitlab installation:
 sudo gitlab-rake gitlab:storage:migrate_to_hashed ID_FROM=50 ID_TO=100
 ```
 
-Check the [documentation][rake/migrate-to-hashed] for additional information and instructions for 
+Check the [documentation][rake/migrate-to-hashed] for additional information and instructions for
 source-based installation.
 
 #### Rollback
@@ -140,12 +140,12 @@ projects:
 1. Go to **Admin > Settings > Repository** and expand the **Repository Storage** section.
 2. Uncheck the **Use hashed storage paths for newly created and renamed projects** checkbox.
 
-To schedule a complete rollback, see the 
+To schedule a complete rollback, see the
 [rake task documentation for storage rollback](raketasks/storage.md#rollback-from-hashed-storage-to-legacy-storage) for instructions.
 
 The rollback task also supports specifying a range of Project IDs. Here is an example
 of limiting the rollout to Project IDs 50 to 100, in an Omnibus Gitlab installation:
- 
+
 ```bash
 sudo gitlab-rake gitlab:storage:rollback_to_legacy ID_FROM=50 ID_TO=100
 ```
diff --git a/doc/api/boards.md b/doc/api/boards.md
index 926a0be1d8b..08ec1d832df 100644
--- a/doc/api/boards.md
+++ b/doc/api/boards.md
@@ -229,7 +229,6 @@ PUT /projects/:id/boards/:board_id
 | `labels`            | string         | no       | Comma-separated list of label names which the board should be scoped to |
 | `weight`            | integer        | no       | The weight range from 0 to 9, to which the board should be scoped to |
 
-
 ```bash
 curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/projects/5/boards/1?name=new_name&milestone_id=43&assignee_id=1&labels=Doing&weight=4
 ```
diff --git a/doc/api/deploy_keys.md b/doc/api/deploy_keys.md
index 1d7523fcc3d..41f6ab436e8 100644
--- a/doc/api/deploy_keys.md
+++ b/doc/api/deploy_keys.md
@@ -19,13 +19,13 @@ Example response:
   {
     "id": 1,
     "title": "Public key",
-    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAIEAiPWx6WM4lhHNedGfBpPJNPpZ7yKu+dnn1SJejgt4596k6YjzGGphH2TUxwKzxcKDKKezwkpfnxPkSMkuEspGRt/aZZ9wa++Oi7Qkr8prgHc4soW6NUlfDzpvZK2H5E7eQaSeP3SAwGmQKUFHCddNaP0L+hM7zhFNzjFvpaMgJw0=",    
+    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAIEAiPWx6WM4lhHNedGfBpPJNPpZ7yKu+dnn1SJejgt4596k6YjzGGphH2TUxwKzxcKDKKezwkpfnxPkSMkuEspGRt/aZZ9wa++Oi7Qkr8prgHc4soW6NUlfDzpvZK2H5E7eQaSeP3SAwGmQKUFHCddNaP0L+hM7zhFNzjFvpaMgJw0=",
     "created_at": "2013-10-02T10:12:29Z"
   },
   {
     "id": 3,
     "title": "Another Public key",
-    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAIEAiPWx6WM4lhHNedGfBpPJNPpZ7yKu+dnn1SJejgt4596k6YjzGGphH2TUxwKzxcKDKKezwkpfnxPkSMkuEspGRt/aZZ9wa++Oi7Qkr8prgHc4soW6NUlfDzpvZK2H5E7eQaSeP3SAwGmQKUFHCddNaP0L+hM7zhFNzjFvpaMgJw0=",    
+    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAIEAiPWx6WM4lhHNedGfBpPJNPpZ7yKu+dnn1SJejgt4596k6YjzGGphH2TUxwKzxcKDKKezwkpfnxPkSMkuEspGRt/aZZ9wa++Oi7Qkr8prgHc4soW6NUlfDzpvZK2H5E7eQaSeP3SAwGmQKUFHCddNaP0L+hM7zhFNzjFvpaMgJw0=",
     "created_at": "2013-10-02T11:12:29Z"
   }
 ]
diff --git a/doc/api/epics.md b/doc/api/epics.md
index 563f6feb546..d05eb0a8804 100644
--- a/doc/api/epics.md
+++ b/doc/api/epics.md
@@ -302,7 +302,7 @@ POST /groups/:id/epics/:epic_iid/todo
 | Attribute   | Type    | Required | Description                          |
 |-------------|---------|----------|--------------------------------------|
 | `id`        | integer/string | yes   | The ID or [URL-encoded path of the group](README.md#namespaced-path-encoding) owned by the authenticated user  |
-| `epic_iid ` | integer | yes          | The internal ID of a group's epic |
+| `epic_iid` | integer | yes          | The internal ID of a group's epic |
 
 ```bash
 curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/1/epics/5/todo
diff --git a/doc/api/issue_links.md b/doc/api/issue_links.md
index 31776568b8e..280431fa87c 100644
--- a/doc/api/issue_links.md
+++ b/doc/api/issue_links.md
@@ -67,7 +67,6 @@ POST /projects/:id/issues/:issue_iid/links
 | `target_project_id` | integer/string | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) of a target project  |
 | `target_issue_iid` | integer/string | yes      | The internal ID of a target project's issue |
 
-
 ```json
 {
   "source_issue" : {
@@ -141,14 +140,12 @@ Deletes an issue link, thus removes the two-way relationship.
 DELETE /projects/:id/issues/:issue_iid/links/:issue_link_id
 ```
 
-
 | Attribute   | Type    | Required | Description                          |
 |-------------|---------|----------|--------------------------------------|
 | `id`        | integer/string | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user  |
 | `issue_iid` | integer | yes      | The internal ID of a project's issue |
 | `issue_link_id` | integer/string | yes      | The ID of an issue relationship |
 
-
 ```json
 {
   "source_issue" : {
diff --git a/doc/api/issues.md b/doc/api/issues.md
index 6952426c322..23126a05b66 100644
--- a/doc/api/issues.md
+++ b/doc/api/issues.md
@@ -57,7 +57,7 @@ GET /issues?confidential=true
 | `created_before`    | datetime         | no         | Return issues created on or before the given time                                                                                                   |
 | `updated_after`     | datetime         | no         | Return issues updated on or after the given time                                                                                                    |
 | `updated_before`    | datetime         | no         | Return issues updated on or before the given time                                                                                                   |
-| `confidential `     | Boolean          | no         | Filter confidential or public issues.                                                                                                               |
+| `confidential`     | Boolean          | no         | Filter confidential or public issues.                                                                                                               |
 
 ```bash
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/issues
@@ -206,7 +206,7 @@ GET /groups/:id/issues?confidential=true
 | `created_before`    | datetime         | no         | Return issues created on or before the given time                                                                             |
 | `updated_after`     | datetime         | no         | Return issues updated on or after the given time                                                                              |
 | `updated_before`    | datetime         | no         | Return issues updated on or before the given time                                                                             |
-| `confidential `     | Boolean          | no         | Filter confidential or public issues.                                                                                         |
+| `confidential`     | Boolean          | no         | Filter confidential or public issues.                                                                                         |
 
 ```bash
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/4/issues
@@ -355,7 +355,7 @@ GET /projects/:id/issues?confidential=true
 | `created_before`    | datetime         | no         | Return issues created on or before the given time                                                                             |
 | `updated_after`     | datetime         | no         | Return issues updated on or after the given time                                                                              |
 | `updated_before`    | datetime         | no         | Return issues updated on or before the given time                                                                             |
-| `confidential `     | Boolean          | no         | Filter confidential or public issues.                                                                                         |
+| `confidential`     | Boolean          | no         | Filter confidential or public issues.                                                                                         |
 
 
 ```bash
diff --git a/doc/api/issues_statistics.md b/doc/api/issues_statistics.md
index 58a32e879d7..d7edb296be2 100644
--- a/doc/api/issues_statistics.md
+++ b/doc/api/issues_statistics.md
@@ -43,7 +43,7 @@ GET /issues_statistics?confidential=true
 | `created_before`    | datetime         | no         | Return issues created on or before the given time                                                                                                   |
 | `updated_after`     | datetime         | no         | Return issues updated on or after the given time                                                                                                    |
 | `updated_before`    | datetime         | no         | Return issues updated on or before the given time                                                                                                   |
-| `confidential `     | Boolean          | no         | Filter confidential or public issues.                                                                                                               |
+| `confidential`     | Boolean          | no         | Filter confidential or public issues.                                                                                                               |
 
 ```bash
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/issues_statistics
@@ -99,7 +99,7 @@ GET /groups/:id/issues_statistics?confidential=true
 | `created_before`    | datetime         | no         | Return issues created on or before the given time                                                                             |
 | `updated_after`     | datetime         | no         | Return issues updated on or after the given time                                                                              |
 | `updated_before`    | datetime         | no         | Return issues updated on or before the given time                                                                             |
-| `confidential `     | Boolean          | no         | Filter confidential or public issues.                                                                                         |
+| `confidential`     | Boolean          | no         | Filter confidential or public issues.                                                                                         |
 
 ```bash
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/groups/4/issues_statistics
@@ -155,8 +155,7 @@ GET /projects/:id/issues_statistics?confidential=true
 | `created_before`    | datetime         | no         | Return issues created on or before the given time                                                                             |
 | `updated_after`     | datetime         | no         | Return issues updated on or after the given time                                                                              |
 | `updated_before`    | datetime         | no         | Return issues updated on or before the given time                                                                             |
-| `confidential `     | Boolean          | no         | Filter confidential or public issues.                                                                                         |
-
+| `confidential`     | Boolean          | no         | Filter confidential or public issues.                                                                                         |
 
 ```bash
 curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/projects/4/issues_statistics
diff --git a/doc/api/jobs.md b/doc/api/jobs.md
index bb8df6187a9..1add5f432ac 100644
--- a/doc/api/jobs.md
+++ b/doc/api/jobs.md
@@ -485,7 +485,7 @@ Parameters
 | Attribute       | Type           | Required | Description                                                                                                      |
 |-----------------|----------------|----------|------------------------------------------------------------------------------------------------------------------|
 | `id`            | integer/string | yes      | ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user. |
-| `job_id  `      | integer        | yes      | The unique job identifier.                                                                                       |
+| `job_id`        | integer        | yes      | The unique job identifier.                                                                                       |
 | `artifact_path` | string         | yes      | Path to a file inside the artifacts archive.                                                                     |
 
 Example request:
@@ -782,7 +782,6 @@ DELETE /projects/:id/jobs/:job_id/artifacts
 | `id`      | integer/string | yes      | ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) |
 | `job_id`  | integer        | yes      | ID of a job.                                                                |
 
-
 Example request:
 
 ```sh
diff --git a/doc/api/license.md b/doc/api/license.md
index 02754d63bd4..12f1d03d576 100644
--- a/doc/api/license.md
+++ b/doc/api/license.md
@@ -131,7 +131,6 @@ Returns:
 - `201 Created` if the license is successfully added.
 - `400 Bad Request` if the license couldn't be added, with an error message explaining the reason.
 
-
 ## Delete a license
 
 ```
diff --git a/doc/api/managed_licenses.md b/doc/api/managed_licenses.md
index 9521be5abac..1af7567626f 100644
--- a/doc/api/managed_licenses.md
+++ b/doc/api/managed_licenses.md
@@ -105,7 +105,7 @@ DELETE /projects/:id/managed_licenses/:managed_license_id
 curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/managed_licenses/4"
 ```
 
-When successful, it replies with an HTTP 204 response. 
+When successful, it replies with an HTTP 204 response.
 
 ## Edit an existing managed license
 
diff --git a/doc/api/merge_request_approvals.md b/doc/api/merge_request_approvals.md
index 504ce56f569..c211916464a 100644
--- a/doc/api/merge_request_approvals.md
+++ b/doc/api/merge_request_approvals.md
@@ -178,7 +178,6 @@ PUT /projects/:id/approvers
 }
 ```
 
-
 ## Merge Request-level MR approvals
 
 Configuration for approvals on a specific Merge Request. Must be authenticated for all endpoints.
@@ -250,7 +249,6 @@ POST /projects/:id/merge_requests/:merge_request_iid/approvals
 | `merge_request_iid`  | integer | yes      | The IID of MR                              |
 | `approvals_required` | integer | yes      | Approvals required before MR can be merged |
 
-
 ```json
 {
   "id": 5,
diff --git a/doc/api/oauth2.md b/doc/api/oauth2.md
index dfe62554852..76e3a0fa1a4 100644
--- a/doc/api/oauth2.md
+++ b/doc/api/oauth2.md
@@ -192,7 +192,7 @@ access_token = client.password.get_token('user@example.com', 'secret')
 puts access_token.token
 ```
 
-##  Access GitLab API with `access token`
+## Access GitLab API with `access token`
 
 The `access token` allows you to make requests to the API on behalf of a user.
 You can pass the token either as GET parameter:
diff --git a/doc/api/packages.md b/doc/api/packages.md
index 1a795c0cfa7..ca90771b085 100644
--- a/doc/api/packages.md
+++ b/doc/api/packages.md
@@ -76,7 +76,7 @@ Example response:
 
 > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/9305) in GitLab 11.8.
 
-Get a list of package files of a single package. 
+Get a list of package files of a single package.
 
 ```
 GET /projects/:id/packages/:package_id/package_files
diff --git a/doc/api/project_badges.md b/doc/api/project_badges.md
index 3a7b3d8975e..1c382232837 100644
--- a/doc/api/project_badges.md
+++ b/doc/api/project_badges.md
@@ -91,7 +91,7 @@ POST /projects/:id/badges
 
 | Attribute | Type | Required | Description |
 | --------- | ---- | -------- | ----------- |
-| `id`      | integer/string | yes | The ID or [URL-encoded path of the project ](README.md#namespaced-path-encoding) owned by the authenticated user |
+| `id`      | integer/string | yes | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user |
 | `link_url` | string         | yes | URL of the badge link |
 | `image_url` | string | yes | URL of the badge image |
 
diff --git a/doc/api/project_statistics.md b/doc/api/project_statistics.md
index 34d73abfcbf..2732fa47fa0 100644
--- a/doc/api/project_statistics.md
+++ b/doc/api/project_statistics.md
@@ -14,7 +14,7 @@ GET /projects/:id/statistics
 
 | Attribute  | Type   | Required | Description |
 | ---------- | ------ | -------- | ----------- |
-| `id `      | integer / string | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) |
+| `id`      | integer / string | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) |
 
 Example response:
 
diff --git a/doc/api/project_templates.md b/doc/api/project_templates.md
index 69d61b3974b..cc932e3ef58 100644
--- a/doc/api/project_templates.md
+++ b/doc/api/project_templates.md
@@ -27,7 +27,7 @@ GET /projects/:id/templates/:type
 
 | Attribute  | Type   | Required | Description |
 | ---------- | ------ | -------- | ----------- |
-| `id `      | integer / string | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) |
+| `id`      | integer / string | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) |
 | `type`     | string | yes| The type `(dockerfiles|gitignores|gitlab_ci_ymls|licenses)` of the template |
 
 Example response (licenses):
@@ -93,7 +93,7 @@ GET /projects/:id/templates/:type/:key
 
 | Attribute  | Type   | Required | Description |
 | ---------- | ------ | -------- | ----------- |
-| `id `      | integer / string | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) |
+| `id`      | integer / string | yes      | The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) |
 | `type`     | string | yes| The type `(dockerfiles|gitignores|gitlab_ci_ymls|licenses)` of the template |
 | `key`      | string | yes      | The key of the template, as obtained from the collection endpoint |
 | `project`  | string | no       | The project name to use when expanding placeholders in the template. Only affects licenses |
diff --git a/doc/api/scim.md b/doc/api/scim.md
index 46498465261..ece7f56e394 100644
--- a/doc/api/scim.md
+++ b/doc/api/scim.md
@@ -6,7 +6,7 @@ The SCIM API implements the [the RFC7644 protocol](https://tools.ietf.org/html/r
 
 NOTE: **Note:**
 [Group SSO](../user/group/saml_sso/index.md) and the feature
-flag `:group_scim` must be enabled for the group. For more information, see [SCIM setup documentation](../user/group/saml_sso/scim_setup.md#requirements). 
+flag `:group_scim` must be enabled for the group. For more information, see [SCIM setup documentation](../user/group/saml_sso/scim_setup.md#requirements).
 
 ## Get a list of SAML users
 
diff --git a/doc/customization/system_header_and_footer_messages.md b/doc/customization/system_header_and_footer_messages.md
index 7eee79abc77..15830be4e8a 100644
--- a/doc/customization/system_header_and_footer_messages.md
+++ b/doc/customization/system_header_and_footer_messages.md
@@ -8,8 +8,8 @@ Navigate to the **Admin** area and go to the **Appearance** page.
 Under **System header and footer** insert your header message and/or footer message.
 Both background and font color of the header and footer are customizable.
 
-You can also apply the header and footer messages to gitlab emails, 
-by checking the **Enable header and footer in emails** checkbox. 
+You can also apply the header and footer messages to gitlab emails,
+by checking the **Enable header and footer in emails** checkbox.
 Note that color settings will only be applied within the app interface and not to emails
 
 ![appearance](system_header_and_footer_messages/appearance.png)
diff --git a/doc/development/api_styleguide.md b/doc/development/api_styleguide.md
index 4fc38a460f8..0866d3baeeb 100644
--- a/doc/development/api_styleguide.md
+++ b/doc/development/api_styleguide.md
@@ -53,7 +53,7 @@ allowed.
 
 ### Exclude params from parent namespaces!
 
-> By default `declared(params) `includes parameters that were defined in all
+> By default `declared(params)`includes parameters that were defined in all
 parent namespaces.
 
 – <https://github.com/ruby-grape/grape#include-parent-namespaces>
diff --git a/doc/development/code_comments.md b/doc/development/code_comments.md
index 36962eb46d4..827a610efa2 100644
--- a/doc/development/code_comments.md
+++ b/doc/development/code_comments.md
@@ -1,11 +1,11 @@
 # Code comments
 
-Whenever you add comment to the code that is expected to be addressed at any time 
-in future, please create a technical debt issue for it. Then put a link to it 
+Whenever you add comment to the code that is expected to be addressed at any time
+in future, please create a technical debt issue for it. Then put a link to it
 to the code comment you've created. This will allow other developers to quickly
 check if a comment is still relevant and what needs to be done to address it.
 
-Examples: 
+Examples:
 
 ```rb
 # Deprecated scope until code_owner column has been migrated to rule_type.
diff --git a/doc/development/emails.md b/doc/development/emails.md
index 8baf343b133..1fd4139c91e 100644
--- a/doc/development/emails.md
+++ b/doc/development/emails.md
@@ -76,7 +76,7 @@ See the [Rails guides] for more info.
 
 ## Email namespace
 
-As of GitLab 11.7, we support a new format for email handler addresses.  This was done to 
+As of GitLab 11.7, we support a new format for email handler addresses.  This was done to
 support catch-all mailboxes.
 
 If you need to implement a feature which requires a new email handler, follow these rules
diff --git a/doc/development/licensed_feature_availability.md b/doc/development/licensed_feature_availability.md
index 7d0a6f6acda..80ec7b8c0cf 100644
--- a/doc/development/licensed_feature_availability.md
+++ b/doc/development/licensed_feature_availability.md
@@ -1,18 +1,18 @@
 # Licensed feature availability **(STARTER)**
 
-As of GitLab 9.4, we've been supporting a simplified version of licensed 
-feature availability checks via `ee/app/models/license.rb`, both for 
+As of GitLab 9.4, we've been supporting a simplified version of licensed
+feature availability checks via `ee/app/models/license.rb`, both for
 on-premise or GitLab.com plans and features.
 
 ## Restricting features scoped by namespaces or projects
 
 GitLab.com plans are persisted on user groups and namespaces, therefore, if you're adding a
-feature such as [Related issues](../user/project/issues/related_issues.md) or 
-[Service desk](../user/project/service_desk.md), 
+feature such as [Related issues](../user/project/issues/related_issues.md) or
+[Service desk](../user/project/service_desk.md),
 it should be restricted on namespace scope.
 
-1. Add the feature symbol on `EES_FEATURES`, `EEP_FEATURES` or `EEU_FEATURES` constants in 
-  `ee/app/models/license.rb`. Note on `ee/app/models/ee/namespace.rb` that _Bronze_ GitLab.com 
+1. Add the feature symbol on `EES_FEATURES`, `EEP_FEATURES` or `EEU_FEATURES` constants in
+  `ee/app/models/license.rb`. Note on `ee/app/models/ee/namespace.rb` that _Bronze_ GitLab.com
   features maps to on-premise _EES_, _Silver_ to _EEP_ and _Gold_ to _EEU_.
 2. Check using:
 
@@ -22,12 +22,12 @@ project.feature_available?(:feature_symbol)
 
 ## Restricting global features (instance)
 
-However, for features such as [Geo](../administration/geo/replication/index.md) and 
-[Load balancing](../administration/database_load_balancing.md), which cannot be restricted 
-to only a subset of projects or namespaces, the check will be made directly in 
+However, for features such as [Geo](../administration/geo/replication/index.md) and
+[Load balancing](../administration/database_load_balancing.md), which cannot be restricted
+to only a subset of projects or namespaces, the check will be made directly in
 the instance license.
 
-1. Add the feature symbol on `EES_FEATURES`, `EEP_FEATURES` or `EEU_FEATURES` constants in 
+1. Add the feature symbol on `EES_FEATURES`, `EEP_FEATURES` or `EEU_FEATURES` constants in
   `ee/app/models/license.rb`.
 2. Add the same feature symbol to `GLOBAL_FEATURES`
 3. Check using:
diff --git a/doc/development/newlines_styleguide.md b/doc/development/newlines_styleguide.md
index 5f7210020b6..a13adc2f13e 100644
--- a/doc/development/newlines_styleguide.md
+++ b/doc/development/newlines_styleguide.md
@@ -11,7 +11,7 @@ def method
 
   issue.save
 
-  render json: issue 
+  render json: issue
 end
 ```
 
@@ -21,7 +21,7 @@ def method
   issue = Issue.new
   issue.save
 
-  render json: issue 
+  render json: issue
 end
 ```
 
diff --git a/doc/development/packages.md b/doc/development/packages.md
index 418efd9eef9..08aa0b08525 100644
--- a/doc/development/packages.md
+++ b/doc/development/packages.md
@@ -5,11 +5,11 @@ This document will guide you through adding another [package management system](
 See already supported package types in [Packages documentation](../administration/packages.md)
 
 Since GitLab packages' UI is pretty generic, it is possible to add new
-package system support by solely backend changes. This guide is superficial and does 
-not cover the way the code should be written. However, you can find a good example 
-by looking at existing merge requests with Maven and NPM support: 
+package system support by solely backend changes. This guide is superficial and does
+not cover the way the code should be written. However, you can find a good example
+by looking at existing merge requests with Maven and NPM support:
 
-- [NPM registry support](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/8673). 
+- [NPM registry support](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/8673).
 - [Maven repository](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/6607).
 - [Instance level endpoint for Maven repository](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/8757)
 
@@ -17,44 +17,44 @@ by looking at existing merge requests with Maven and NPM support:
 
 The existing database model requires the following:
 
-- Every package belongs to a project. 
+- Every package belongs to a project.
 - Every package file belongs to a package.
 - A package can have one or more package files.
 - The package model is based on storing information about the package and its version.
 
 ## API endpoints
 
-Package systems work with GitLab via API. For example `ee/lib/api/npm_packages.rb` 
-implements API endpoints to work with NPM clients. So, the first thing to do is to 
-add a new `ee/lib/api/your_name_packages.rb` file with API endpoints that are 
-necessary to make the package system client to work. Usually that means having 
-endpoints like: 
+Package systems work with GitLab via API. For example `ee/lib/api/npm_packages.rb`
+implements API endpoints to work with NPM clients. So, the first thing to do is to
+add a new `ee/lib/api/your_name_packages.rb` file with API endpoints that are
+necessary to make the package system client to work. Usually that means having
+endpoints like:
 
 - GET package information.
 - GET package file content.
 - PUT upload package.
 
 Since the packages belong to a project, it's expected to have project-level endpoint
-for uploading and downloading them. For example: 
+for uploading and downloading them. For example:
 
 ```
 GET https://gitlab.com/api/v4/projects/<your_project_id>/packages/npm/
 PUT https://gitlab.com/api/v4/projects/<your_project_id>/packages/npm/
 ```
 
-Group-level and instance-level endpoints are good to have but are optional. 
+Group-level and instance-level endpoints are good to have but are optional.
 
 NOTE: **Note:**
-To avoid name conflict for instance-level endpoints we use 
+To avoid name conflict for instance-level endpoints we use
 [the package naming convention](../user/project/packages/npm_registry.md#package-naming-convention)
 
 ## Configuration
 
-GitLab has a `packages` section in its configuration file (`gitlab.rb`). 
-It applies to all package systems supported by GitLab. Usually you don't need 
-to add anything there. 
+GitLab has a `packages` section in its configuration file (`gitlab.rb`).
+It applies to all package systems supported by GitLab. Usually you don't need
+to add anything there.
 
-Packages can be configured to use object storage, therefore your code must support it. 
+Packages can be configured to use object storage, therefore your code must support it.
 
 ## Database
 
@@ -63,6 +63,6 @@ Every time you upload a new package, you can either create a new record of `Pack
 or add files to existing record. `PackageFile` should be able to store all file-related
 information like the file `name`, `side`, `sha1`, etc.
 
-If there is specific data necessary to be stored for only one package system support, 
-consider creating a separate metadata model. See `packages_maven_metadata` table 
+If there is specific data necessary to be stored for only one package system support,
+consider creating a separate metadata model. See `packages_maven_metadata` table
 and `Packages::MavenMetadatum` model as example for package specific data.
diff --git a/doc/development/understanding_explain_plans.md b/doc/development/understanding_explain_plans.md
index bfbb7be70e3..11aafd7b639 100644
--- a/doc/development/understanding_explain_plans.md
+++ b/doc/development/understanding_explain_plans.md
@@ -654,7 +654,6 @@ and related tools such as:
 - <https://explain.depesz.com/>
 - <http://tatiyants.com/postgres-query-plan-visualization/>
 
-
 ## Producing query plans
 
 There are a few ways to get the output of a query plan. Of course you

From bcd813c0958b10a9b87e162a85a434255002e027 Mon Sep 17 00:00:00 2001
From: Mayra Cabrera <mcabrera@gitlab.com>
Date: Tue, 9 Jul 2019 03:58:49 +0000
Subject: [PATCH 168/195] Limit user information to RackAttack throttles

rack.attack.match_discriminator is only return on
throttle_authenticated_api or throttle_authenticated_web requests, so
we're avoiding logging user_id on blacklist requests

Follow up of https://gitlab.com/gitlab-org/gitlab-ce/issues/62756
---
 config/initializers/rack_attack_logging.rb | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/config/initializers/rack_attack_logging.rb b/config/initializers/rack_attack_logging.rb
index 338e968cc6c..7eb34bd69e5 100644
--- a/config/initializers/rack_attack_logging.rb
+++ b/config/initializers/rack_attack_logging.rb
@@ -12,7 +12,7 @@ ActiveSupport::Notifications.subscribe('rack.attack') do |name, start, finish, r
       fullpath: req.fullpath
     }
 
-    if req.env['rack.attack.matched'] != 'throttle_unauthenticated'
+    if %w(throttle_authenticated_api throttle_authenticated_web).include? req.env['rack.attack.matched']
       user_id = req.env['rack.attack.match_discriminator']
       user = User.find_by(id: user_id)
 

From 9062c9f11b5ae06901b31dc7b169ad3b04c2c1b9 Mon Sep 17 00:00:00 2001
From: Sarah Yasonik <syasonik@gitlab.com>
Date: Tue, 9 Jul 2019 04:04:59 +0000
Subject: [PATCH 169/195] Push feature flag for embedding metrics

---
 lib/gitlab/gon_helper.rb | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/lib/gitlab/gon_helper.rb b/lib/gitlab/gon_helper.rb
index 92917028851..41ec8741eb1 100644
--- a/lib/gitlab/gon_helper.rb
+++ b/lib/gitlab/gon_helper.rb
@@ -38,6 +38,11 @@ module Gitlab
         gon.current_user_fullname = current_user.name
         gon.current_user_avatar_url = current_user.avatar_url
       end
+
+      # Flag controls a GFM feature used across many routes.
+      # Pushing the flag from one place simplifies control
+      # and facilitates easy removal.
+      push_frontend_feature_flag(:gfm_embedded_metrics)
     end
 
     # Exposes the state of a feature flag to the frontend code.

From 9613a34a24bda78661ce74348ceb55d1e3b50b53 Mon Sep 17 00:00:00 2001
From: Natalia Tepluhina <ntepluhina@gitlab.com>
Date: Tue, 9 Jul 2019 04:22:48 +0000
Subject: [PATCH 170/195] Fixed editing form

- applied functional component patch
- fixed border radius for list
- fixed Karma test to take a correct li amount
---
 .../notes/components/discussion_notes.vue     |  8 +--
 .../discussion_notes_replies_wrapper.vue      | 27 ++++++++++
 app/assets/stylesheets/pages/diff.scss        |  4 ++
 app/assets/stylesheets/pages/notes.scss       |  1 -
 .../discussion_notes_replies_wrapper_spec.js  | 51 +++++++++++++++++++
 .../diffs/components/inline_diff_view_spec.js |  3 +-
 6 files changed, 88 insertions(+), 6 deletions(-)
 create mode 100644 app/assets/javascripts/notes/components/discussion_notes_replies_wrapper.vue
 create mode 100644 spec/frontend/notes/components/discussion_notes_replies_wrapper_spec.js

diff --git a/app/assets/javascripts/notes/components/discussion_notes.vue b/app/assets/javascripts/notes/components/discussion_notes.vue
index 2ff0fee62f3..0b136549c14 100644
--- a/app/assets/javascripts/notes/components/discussion_notes.vue
+++ b/app/assets/javascripts/notes/components/discussion_notes.vue
@@ -8,12 +8,14 @@ import SystemNote from '~/vue_shared/components/notes/system_note.vue';
 import NoteableNote from './noteable_note.vue';
 import ToggleRepliesWidget from './toggle_replies_widget.vue';
 import NoteEditedText from './note_edited_text.vue';
+import DiscussionNotesRepliesWrapper from './discussion_notes_replies_wrapper.vue';
 
 export default {
   name: 'DiscussionNotes',
   components: {
     ToggleRepliesWidget,
     NoteEditedText,
+    DiscussionNotesRepliesWrapper,
   },
   props: {
     discussion: {
@@ -119,9 +121,7 @@ export default {
           />
           <slot slot="avatar-badge" name="avatar-badge"></slot>
         </component>
-        <div
-          :class="discussion.diff_discussion ? 'discussion-collapsible bordered-box clearfix' : ''"
-        >
+        <discussion-notes-replies-wrapper :is-diff-discussion="discussion.diff_discussion">
           <toggle-replies-widget
             v-if="hasReplies"
             :collapsed="!isExpanded"
@@ -141,7 +141,7 @@ export default {
             />
           </template>
           <slot :show-replies="isExpanded || !hasReplies" name="footer"></slot>
-        </div>
+        </discussion-notes-replies-wrapper>
       </template>
       <template v-else>
         <component
diff --git a/app/assets/javascripts/notes/components/discussion_notes_replies_wrapper.vue b/app/assets/javascripts/notes/components/discussion_notes_replies_wrapper.vue
new file mode 100644
index 00000000000..2ddca56ddd5
--- /dev/null
+++ b/app/assets/javascripts/notes/components/discussion_notes_replies_wrapper.vue
@@ -0,0 +1,27 @@
+<script>
+/**
+ * Wrapper for discussion notes replies section.
+ *
+ * This is a functional component using the render method because in some cases
+ * the wrapper is not needed and we want to simply render along the children.
+ */
+export default {
+  functional: true,
+  props: {
+    isDiffDiscussion: {
+      type: Boolean,
+      required: false,
+      default: false,
+    },
+  },
+  render(h, { props, children }) {
+    if (props.isDiffDiscussion) {
+      return h('li', { class: 'discussion-collapsible bordered-box clearfix' }, [
+        h('ul', { class: 'notes' }, children),
+      ]);
+    }
+
+    return children;
+  },
+};
+</script>
diff --git a/app/assets/stylesheets/pages/diff.scss b/app/assets/stylesheets/pages/diff.scss
index 623c44e062f..3ffe8ae304d 100644
--- a/app/assets/stylesheets/pages/diff.scss
+++ b/app/assets/stylesheets/pages/diff.scss
@@ -1095,6 +1095,10 @@ table.code {
 
 .discussion-collapsible {
   margin: 0 $gl-padding $gl-padding 71px;
+
+  .notes {
+    border-radius: $border-radius-default;
+  }
 }
 
 .parallel {
diff --git a/app/assets/stylesheets/pages/notes.scss b/app/assets/stylesheets/pages/notes.scss
index 5db0136e3f1..b9b8eabf909 100644
--- a/app/assets/stylesheets/pages/notes.scss
+++ b/app/assets/stylesheets/pages/notes.scss
@@ -139,7 +139,6 @@ $note-form-margin-left: 72px;
     border-radius: 4px 4px 0 0;
 
     &.collapsed {
-      border: 0;
       border-radius: 4px;
     }
   }
diff --git a/spec/frontend/notes/components/discussion_notes_replies_wrapper_spec.js b/spec/frontend/notes/components/discussion_notes_replies_wrapper_spec.js
new file mode 100644
index 00000000000..279ca017b44
--- /dev/null
+++ b/spec/frontend/notes/components/discussion_notes_replies_wrapper_spec.js
@@ -0,0 +1,51 @@
+import { mount } from '@vue/test-utils';
+import DiscussionNotesRepliesWrapper from '~/notes/components/discussion_notes_replies_wrapper.vue';
+
+const TEST_CHILDREN = '<li>Hello!</li><li>World!</li>';
+
+// We have to wrap our SUT with a TestComponent because multiple roots are possible
+// because it's a functional component.
+const TestComponent = {
+  components: { DiscussionNotesRepliesWrapper },
+  template: `<ul><discussion-notes-replies-wrapper v-bind="$attrs">${TEST_CHILDREN}</discussion-notes-replies-wrapper></ul>`,
+};
+
+describe('DiscussionNotesRepliesWrapper', () => {
+  let wrapper;
+
+  const createComponent = (props = {}) => {
+    wrapper = mount(TestComponent, {
+      propsData: props,
+      sync: false,
+    });
+  };
+
+  afterEach(() => {
+    wrapper.destroy();
+  });
+
+  describe('when normal discussion', () => {
+    beforeEach(() => {
+      createComponent();
+    });
+
+    it('renders children directly', () => {
+      expect(wrapper.html()).toEqual(`<ul>${TEST_CHILDREN}</ul>`);
+    });
+  });
+
+  describe('when diff discussion', () => {
+    beforeEach(() => {
+      createComponent({
+        isDiffDiscussion: true,
+      });
+    });
+
+    it('wraps children with notes', () => {
+      const notes = wrapper.find('li.discussion-collapsible ul.notes');
+
+      expect(notes.exists()).toBe(true);
+      expect(notes.html()).toEqual(`<ul class="notes">${TEST_CHILDREN}</ul>`);
+    });
+  });
+});
diff --git a/spec/javascripts/diffs/components/inline_diff_view_spec.js b/spec/javascripts/diffs/components/inline_diff_view_spec.js
index 0b3890b68d6..9b61dbe7975 100644
--- a/spec/javascripts/diffs/components/inline_diff_view_spec.js
+++ b/spec/javascripts/diffs/components/inline_diff_view_spec.js
@@ -10,6 +10,7 @@ describe('InlineDiffView', () => {
   let component;
   const getDiffFileMock = () => Object.assign({}, diffFileMockData);
   const getDiscussionsMockData = () => [Object.assign({}, discussionsMockData)];
+  const notesLength = getDiscussionsMockData()[0].notes.length;
 
   beforeEach(done => {
     const diffFile = getDiffFileMock();
@@ -40,7 +41,7 @@ describe('InlineDiffView', () => {
 
       Vue.nextTick(() => {
         expect(el.querySelectorAll('.notes_holder').length).toEqual(1);
-        expect(el.querySelectorAll('.notes_holder .note-discussion li').length).toEqual(6);
+        expect(el.querySelectorAll('.notes_holder .note').length).toEqual(notesLength + 1);
         expect(el.innerText.indexOf('comment 5')).toBeGreaterThan(-1);
         component.$store.dispatch('setInitialNotes', []);
 

From bf6e0c16473128417e458a7952d0209b6a240107 Mon Sep 17 00:00:00 2001
From: Mark Lapierre <mlapierre@gitlab.com>
Date: Tue, 9 Jul 2019 14:25:48 +1000
Subject: [PATCH 171/195] Quarantine failing test

---
 .../3_create/repository/push_over_http_file_size_spec.rb       | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/qa/qa/specs/features/browser_ui/3_create/repository/push_over_http_file_size_spec.rb b/qa/qa/specs/features/browser_ui/3_create/repository/push_over_http_file_size_spec.rb
index 247cde38e52..11fd570d131 100644
--- a/qa/qa/specs/features/browser_ui/3_create/repository/push_over_http_file_size_spec.rb
+++ b/qa/qa/specs/features/browser_ui/3_create/repository/push_over_http_file_size_spec.rb
@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 module QA
-  context 'Create', :requires_admin do
+  # Failure issue: https://gitlab.com/gitlab-org/quality/nightly/issues/113
+  context 'Create', :requires_admin, :quarantine do
     describe 'push after setting the file size limit via admin/application_settings' do
       before(:context) do
         @project = Resource::Project.fabricate_via_api! do |p|

From f47ad4d640fd80481a986c8ed7f9665069bbfbfb Mon Sep 17 00:00:00 2001
From: Patrick Bajao <ebajao@gitlab.com>
Date: Tue, 9 Jul 2019 13:15:16 +0800
Subject: [PATCH 172/195] Fix typo on confidential MR dropdown

Change issues to issue's
---
 .../components/project_form_group.vue                         | 4 ++--
 locale/gitlab.pot                                             | 4 ++--
 .../components/__snapshots__/project_form_group_spec.js.snap  | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/app/assets/javascripts/confidential_merge_request/components/project_form_group.vue b/app/assets/javascripts/confidential_merge_request/components/project_form_group.vue
index b89729375be..29d2cca6aed 100644
--- a/app/assets/javascripts/confidential_merge_request/components/project_form_group.vue
+++ b/app/assets/javascripts/confidential_merge_request/components/project_form_group.vue
@@ -41,7 +41,7 @@ export default {
     noForkText() {
       return sprintf(
         __(
-          'To protect this issues confidentiality, %{link_start}fork the project%{link_end} and set the forks visiblity to private.',
+          "To protect this issue's confidentiality, %{link_start}fork the project%{link_end} and set the forks visiblity to private.",
         ),
         { link_start: `<a href="${this.newForkPath}" class="help-link">`, link_end: '</a>' },
         false,
@@ -118,7 +118,7 @@ export default {
         <template v-if="projects.length">
           {{
             __(
-              'To protect this issues confidentiality, a private fork of this project was selected.',
+              "To protect this issue's confidentiality, a private fork of this project was selected.",
             )
           }}
         </template>
diff --git a/locale/gitlab.pot b/locale/gitlab.pot
index 07534e9c941..f1cfb0ac06d 100644
--- a/locale/gitlab.pot
+++ b/locale/gitlab.pot
@@ -11224,10 +11224,10 @@ msgstr ""
 msgid "To preserve performance only <strong>%{display_size} of %{real_size}</strong> files are displayed."
 msgstr ""
 
-msgid "To protect this issues confidentiality, %{link_start}fork the project%{link_end} and set the forks visiblity to private."
+msgid "To protect this issue's confidentiality, %{link_start}fork the project%{link_end} and set the forks visiblity to private."
 msgstr ""
 
-msgid "To protect this issues confidentiality, a private fork of this project was selected."
+msgid "To protect this issue's confidentiality, a private fork of this project was selected."
 msgstr ""
 
 msgid "To see all the user's personal access tokens you must impersonate them first."
diff --git a/spec/frontend/confidential_merge_request/components/__snapshots__/project_form_group_spec.js.snap b/spec/frontend/confidential_merge_request/components/__snapshots__/project_form_group_spec.js.snap
index a241c764df7..ba0ee8dfd59 100644
--- a/spec/frontend/confidential_merge_request/components/__snapshots__/project_form_group_spec.js.snap
+++ b/spec/frontend/confidential_merge_request/components/__snapshots__/project_form_group_spec.js.snap
@@ -19,7 +19,7 @@ exports[`Confidential merge request project form group component renders empty s
       <br />
        
       <span>
-        To protect this issues confidentiality, 
+        To protect this issue's confidentiality, 
         <a
           class="help-link"
           href="https://test.com"
@@ -69,7 +69,7 @@ exports[`Confidential merge request project form group component renders fork dr
       <br />
        
       <span>
-        To protect this issues confidentiality, 
+        To protect this issue's confidentiality, 
         <a
           class="help-link"
           href="https://test.com"

From 0aed6e598e3cab6d9fb4b1e643283be8a0504f72 Mon Sep 17 00:00:00 2001
From: Shinya Maeda <shinya@gitlab.com>
Date: Tue, 9 Jul 2019 05:55:24 +0000
Subject: [PATCH 173/195] Fix WorkhorseHelpers module is missing

This interferes spec execution on local environment.
---
 spec/support/helpers/git_http_helpers.rb | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/spec/support/helpers/git_http_helpers.rb b/spec/support/helpers/git_http_helpers.rb
index cd49bb148f2..c83860d7b51 100644
--- a/spec/support/helpers/git_http_helpers.rb
+++ b/spec/support/helpers/git_http_helpers.rb
@@ -1,4 +1,8 @@
+require_relative 'workhorse_helpers'
+
 module GitHttpHelpers
+  include WorkhorseHelpers
+
   def clone_get(project, options = {})
     get "/#{project}/info/refs", params: { service: 'git-upload-pack' }, headers: auth_env(*options.values_at(:user, :password, :spnego_request_token))
   end

From 3306aa860b1cb2b7c6bb973b17402eee8266f975 Mon Sep 17 00:00:00 2001
From: Lyle Kozloff <lkozloff@gitlab.com>
Date: Tue, 9 Jul 2019 06:23:17 +0000
Subject: [PATCH 174/195] Makes copying host keys a recommended step

---
 doc/administration/high_availability/gitlab.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/administration/high_availability/gitlab.md b/doc/administration/high_availability/gitlab.md
index 3045be616a6..9b1b7142e83 100644
--- a/doc/administration/high_availability/gitlab.md
+++ b/doc/administration/high_availability/gitlab.md
@@ -125,7 +125,7 @@ need some extra configuration.
    from running on upgrade. Only the primary GitLab application server should
    handle migrations.
 
-1. **Optional** Configure host keys. Copy all contents(primary and public keys) inside `/etc/ssh/` on
+1. **Recommended** Configure host keys. Copy the contents (primary and public keys) of `/etc/ssh/` on
    the primary application server to `/etc/ssh` on all secondary servers. This
    prevents false man-in-the-middle-attack alerts when accessing servers in your
    High Availability cluster behind a load balancer.

From 81547207ca3842bda347a24a0dfb462ac164fb84 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Tue, 9 Jul 2019 06:27:43 +0000
Subject: [PATCH 175/195] Docs: Update danger to accept docs linting changes

---
 danger/only_documentation/Dangerfile | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/danger/only_documentation/Dangerfile b/danger/only_documentation/Dangerfile
index 0e5f841c891..ff65f8713d2 100644
--- a/danger/only_documentation/Dangerfile
+++ b/danger/only_documentation/Dangerfile
@@ -1,7 +1,7 @@
 # rubocop:disable Style/SignalException
 # frozen_string_literal: true
 
-has_only_docs_changes = helper.all_changed_files.all? { |file| file.start_with?('doc/', '.gitlab/ci/docs.gitlab-ci.yml') }
+has_only_docs_changes = helper.all_changed_files.all? { |file| file.start_with?('doc/', '.gitlab/ci/docs.gitlab-ci.yml', '.mdlrc') }
 is_docs_only_branch = gitlab.branch_for_head =~ /(^docs[\/-].*|.*-docs$)/
 
 if is_docs_only_branch && !has_only_docs_changes

From 5abfc57ec3bf2ff910e524e282f0e9b16112c784 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Tue, 9 Jul 2019 07:16:17 +0000
Subject: [PATCH 176/195] Fix spacing of code blocks

Code blocks should not be spaced 4 times, as this will
prevent the code from being colored. They should
also be spaced the same as the lists they are a part
of, to make reading easier.
---
 doc/administration/container_registry.md      | 300 +++++++-------
 doc/administration/database_load_balancing.md |  26 +-
 doc/administration/incoming_email.md          |  40 +-
 doc/administration/issue_closing_pattern.md   |  13 +-
 doc/administration/job_artifacts.md           | 150 ++++---
 doc/administration/job_traces.md              |  48 +--
 doc/administration/merge_request_diffs.md     | 112 ++---
 doc/administration/packages.md                | 140 +++----
 doc/administration/pseudonymizer.md           |  60 +--
 .../reply_by_email_postfix_setup.md           | 384 +++++++++---------
 .../repository_storage_paths.md               |  42 +-
 doc/administration/uploads.md                 |  78 ++--
 doc/api/README.md                             |  14 +-
 doc/api/lint.md                               |  38 +-
 doc/api/repositories.md                       |   6 +-
 doc/api/runners.md                            |   8 +-
 doc/ci/git_submodules.md                      |  14 +-
 doc/development/architecture.md               |   6 +-
 doc/development/ee_features.md                |  76 ++--
 doc/development/emails.md                     |  82 ++--
 doc/development/gotchas.md                    |   8 +-
 doc/development/logging.md                    |  80 ++--
 doc/development/profiling.md                  |   8 +-
 doc/development/routing.md                    |  34 +-
 doc/development/sql.md                        |   4 +-
 25 files changed, 896 insertions(+), 875 deletions(-)

diff --git a/doc/administration/container_registry.md b/doc/administration/container_registry.md
index 2e4b4efa0ac..04f52783d22 100644
--- a/doc/administration/container_registry.md
+++ b/doc/administration/container_registry.md
@@ -1,7 +1,5 @@
 # GitLab Container Registry administration
 
-> **Notes:**
->
 > - [Introduced][ce-4040] in GitLab 8.8.
 > - Container Registry manifest `v1` support was added in GitLab 8.9 to support
 >   Docker versions earlier than 1.10.
@@ -125,21 +123,21 @@ otherwise you will run into conflicts.
 1. Your `/etc/gitlab/gitlab.rb` should contain the Registry URL as well as the
    path to the existing TLS certificate and key used by GitLab:
 
-    ```ruby
-    registry_external_url 'https://gitlab.example.com:4567'
-    ```
+   ```ruby
+   registry_external_url 'https://gitlab.example.com:4567'
+   ```
 
-    Note how the `registry_external_url` is listening on HTTPS under the
-    existing GitLab URL, but on a different port.
+   Note how the `registry_external_url` is listening on HTTPS under the
+   existing GitLab URL, but on a different port.
 
-    If your TLS certificate is not in `/etc/gitlab/ssl/gitlab.example.com.crt`
-    and key not in `/etc/gitlab/ssl/gitlab.example.com.key` uncomment the lines
-    below:
+   If your TLS certificate is not in `/etc/gitlab/ssl/gitlab.example.com.crt`
+   and key not in `/etc/gitlab/ssl/gitlab.example.com.key` uncomment the lines
+   below:
 
-    ```ruby
-    registry_nginx['ssl_certificate'] = "/path/to/certificate.pem"
-    registry_nginx['ssl_certificate_key'] = "/path/to/certificate.key"
-    ```
+   ```ruby
+   registry_nginx['ssl_certificate'] = "/path/to/certificate.pem"
+   registry_nginx['ssl_certificate_key'] = "/path/to/certificate.key"
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -150,12 +148,12 @@ otherwise you will run into conflicts.
 1. Open `/home/git/gitlab/config/gitlab.yml`, find the `registry` entry and
    configure it with the following settings:
 
-    ```
-    registry:
-      enabled: true
-      host: gitlab.example.com
-      port: 4567
-    ```
+   ```
+   registry:
+     enabled: true
+     host: gitlab.example.com
+     port: 4567
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 1. Make the relevant changes in NGINX as well (domain, port, TLS certificates path).
@@ -188,17 +186,17 @@ Let's assume that you want the container Registry to be accessible at
    `/etc/gitlab/ssl/registry.gitlab.example.com.key` and make sure they have
    correct permissions:
 
-    ```bash
-    chmod 600 /etc/gitlab/ssl/registry.gitlab.example.com.*
-    ```
+   ```bash
+   chmod 600 /etc/gitlab/ssl/registry.gitlab.example.com.*
+   ```
 
 1. Once the TLS certificate is in place, edit `/etc/gitlab/gitlab.rb` with:
 
-    ```ruby
-    registry_external_url 'https://registry.gitlab.example.com'
-    ```
+   ```ruby
+   registry_external_url 'https://registry.gitlab.example.com'
+   ```
 
-    Note how the `registry_external_url` is listening on HTTPS.
+   Note how the `registry_external_url` is listening on HTTPS.
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -219,11 +217,11 @@ look like:
 1. Open `/home/git/gitlab/config/gitlab.yml`, find the `registry` entry and
    configure it with the following settings:
 
-    ```
-    registry:
-      enabled: true
-      host: registry.gitlab.example.com
-    ```
+   ```yaml
+   registry:
+     enabled: true
+     host: registry.gitlab.example.com
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 1. Make the relevant changes in NGINX as well (domain, port, TLS certificates path).
@@ -248,9 +246,9 @@ Registry application itself.
 
 1. Open `/etc/gitlab/gitlab.rb` and set `registry['enable']` to `false`:
 
-    ```ruby
-    registry['enable'] = false
-    ```
+   ```ruby
+   registry['enable'] = false
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -261,10 +259,10 @@ Registry application itself.
 1. Open `/home/git/gitlab/config/gitlab.yml`, find the `registry` entry and
    set `enabled` to `false`:
 
-    ```
-    registry:
-      enabled: false
-    ```
+   ```yaml
+   registry:
+     enabled: false
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 
@@ -280,9 +278,9 @@ the Container Registry by themselves, follow the steps below.
 
 1. Edit `/etc/gitlab/gitlab.rb` and add the following line:
 
-    ```ruby
-    gitlab_rails['gitlab_default_projects_features_container_registry'] = false
-    ```
+   ```ruby
+   gitlab_rails['gitlab_default_projects_features_container_registry'] = false
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -293,16 +291,16 @@ the Container Registry by themselves, follow the steps below.
 1. Open `/home/git/gitlab/config/gitlab.yml`, find the `default_projects_features`
    entry and configure it so that `container_registry` is set to `false`:
 
-    ```
-    ## Default project features settings
-    default_projects_features:
-      issues: true
-      merge_requests: true
-      wiki: true
-      snippets: false
-      builds: true
-      container_registry: false
-    ```
+   ```yaml
+   ## Default project features settings
+   default_projects_features:
+     issues: true
+     merge_requests: true
+     wiki: true
+     snippets: false
+     builds: true
+     container_registry: false
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 
@@ -332,9 +330,9 @@ The default location where images are stored in Omnibus, is
 
 1. Edit `/etc/gitlab/gitlab.rb`:
 
-    ```ruby
-    gitlab_rails['registry_path'] = "/path/to/registry/storage"
-    ```
+   ```ruby
+   gitlab_rails['registry_path'] = "/path/to/registry/storage"
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -348,10 +346,10 @@ The default location where images are stored in source installations, is
 1. Open `/home/git/gitlab/config/gitlab.yml`, find the `registry` entry and
    change the `path` setting:
 
-    ```
-    registry:
-      path: shared/registry
-    ```
+   ```yaml
+   registry:
+     path: shared/registry
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 
@@ -393,17 +391,17 @@ To configure the `s3` storage driver in Omnibus:
 
 1. Edit `/etc/gitlab/gitlab.rb`:
 
-    ```ruby
-    registry['storage'] = {
-      's3' => {
-        'accesskey' => 's3-access-key',
-        'secretkey' => 's3-secret-key-for-access-key',
-        'bucket' => 'your-s3-bucket',
-        'region' => 'your-s3-region',
-        'regionendpoint' => 'your-s3-regionendpoint'
-      }
-    }
-    ```
+   ```ruby
+   registry['storage'] = {
+     's3' => {
+       'accesskey' => 's3-access-key',
+       'secretkey' => 's3-secret-key-for-access-key',
+       'bucket' => 'your-s3-bucket',
+       'region' => 'your-s3-region',
+       'regionendpoint' => 'your-s3-regionendpoint'
+     }
+   }
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -442,9 +440,9 @@ In the examples below we set the Registry's port to `5001`.
 
 1. Open `/etc/gitlab/gitlab.rb` and set `registry['registry_http_addr']`:
 
-    ```ruby
-    registry['registry_http_addr'] = "localhost:5001"
-    ```
+   ```ruby
+   registry['registry_http_addr'] = "localhost:5001"
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -455,10 +453,10 @@ In the examples below we set the Registry's port to `5001`.
 1. Open the configuration file of your Registry server and edit the
    [`http:addr`][registry-http-config] value:
 
-    ```
-    http
-      addr: localhost:5001
-    ```
+   ```yaml
+   http
+     addr: localhost:5001
+   ```
 
 1. Save the file and restart the Registry server.
 
@@ -476,14 +474,14 @@ You can use GitLab as an auth endpoint and use a non-bundled Container Registry.
 
 1. Open `/etc/gitlab/gitlab.rb` and set necessary configurations:
 
-    ```ruby
-    gitlab_rails['registry_enabled'] = true
-    gitlab_rails['registry_host'] = "registry.gitlab.example.com"
-    gitlab_rails['registry_port'] = "5005"
-    gitlab_rails['registry_api_url'] = "http://localhost:5000"
-    gitlab_rails['registry_path'] = "/var/opt/gitlab/gitlab-rails/shared/registry"
-    gitlab_rails['registry_issuer'] = "omnibus-gitlab-issuer"
-    ```
+   ```ruby
+   gitlab_rails['registry_enabled'] = true
+   gitlab_rails['registry_host'] = "registry.gitlab.example.com"
+   gitlab_rails['registry_port'] = "5005"
+   gitlab_rails['registry_api_url'] = "http://localhost:5000"
+   gitlab_rails['registry_path'] = "/var/opt/gitlab/gitlab-rails/shared/registry"
+   gitlab_rails['registry_issuer'] = "omnibus-gitlab-issuer"
+   ```
 
 1. A certificate keypair is required for GitLab and the Container Registry to
    communicate securely.  By default omnibus-gitlab will generate one keypair,
@@ -492,19 +490,19 @@ You can use GitLab as an auth endpoint and use a non-bundled Container Registry.
    custom certificate key. To do that, add the following to
    `/etc/gitlab/gitlab.rb`
 
-    ```ruby
-    gitlab_rails['registry_key_path'] = "/custom/path/to/registry-key.key"
-    # registry['internal_key'] should contain the contents of the custom key
-    # file. Line breaks in the key file should be marked using `\n` character
-    # Example:
-    registry['internal_key'] = "---BEGIN RSA PRIVATE KEY---\nMIIEpQIBAA\n"
-    ```
+   ```ruby
+   gitlab_rails['registry_key_path'] = "/custom/path/to/registry-key.key"
+   # registry['internal_key'] should contain the contents of the custom key
+   # file. Line breaks in the key file should be marked using `\n` character
+   # Example:
+   registry['internal_key'] = "---BEGIN RSA PRIVATE KEY---\nMIIEpQIBAA\n"
+   ```
 
-    **Note:** The file specified at `registry_key_path` gets populated with the
-    content specified by `internal_key`, each time reconfigure is executed. If
-    no file is specified, omnibus-gitlab will default it to
-    `/var/opt/gitlab/gitlab-rails/etc/gitlab-registry.key` and will populate
-    it.
+   **Note:** The file specified at `registry_key_path` gets populated with the
+   content specified by `internal_key`, each time reconfigure is executed. If
+   no file is specified, omnibus-gitlab will default it to
+   `/var/opt/gitlab/gitlab-rails/etc/gitlab-registry.key` and will populate
+   it.
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -512,18 +510,18 @@ You can use GitLab as an auth endpoint and use a non-bundled Container Registry.
 
 1. Open `/home/git/gitlab/config/gitlab.yml`, and edit the configuration settings under `registry`:
 
-    ```
-    ## Container Registry
+   ```yaml
+   ## Container Registry
 
-    registry:
-      enabled: true
-      host: "registry.gitlab.example.com"
-      port: "5005"
-      api_url: "http://localhost:5000"
-      path: /var/opt/gitlab/gitlab-rails/shared/registry
-      key: /var/opt/gitlab/gitlab-rails/certificate.key
-      issuer: omnibus-gitlab-issuer
-    ```
+   registry:
+     enabled: true
+     host: "registry.gitlab.example.com"
+     port: "5005"
+     api_url: "http://localhost:5000"
+     path: /var/opt/gitlab/gitlab-rails/shared/registry
+     key: /var/opt/gitlab/gitlab-rails/certificate.key
+     issuer: omnibus-gitlab-issuer
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 
@@ -550,20 +548,20 @@ To configure a notification endpoint in Omnibus:
 
 1. Edit `/etc/gitlab/gitlab.rb`:
 
-    ```ruby
-    registry['notifications'] = [
-      {
-        'name' => 'test_endpoint',
-        'url' => 'https://gitlab.example.com/notify',
-        'timeout' => '500ms',
-        'threshold' => 5,
-        'backoff' => '1s',
-        'headers' => {
-          "Authorization" => ["AUTHORIZATION_EXAMPLE_TOKEN"]
-        }
-      }
-    ]
-    ```
+   ```ruby
+   registry['notifications'] = [
+     {
+       'name' => 'test_endpoint',
+       'url' => 'https://gitlab.example.com/notify',
+       'timeout' => '500ms',
+       'threshold' => 5,
+       'backoff' => '1s',
+       'headers' => {
+         "Authorization" => ["AUTHORIZATION_EXAMPLE_TOKEN"]
+       }
+     }
+   ]
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -629,16 +627,16 @@ Start with a value between `25000000` (25MB) and `50000000` (50MB).
 
 1. Edit `/etc/gitlab/gitlab.rb`:
 
-    ```ruby
-    registry['storage'] = {
-      's3' => {
-        'accesskey' => 'AKIAKIAKI',
-        'secretkey' => 'secret123',
-        'bucket'    => 'gitlab-registry-bucket-AKIAKIAKI',
-        'chunksize' => 25000000
-      }
-    }
-    ```
+   ```ruby
+   registry['storage'] = {
+     's3' => {
+       'accesskey' => 'AKIAKIAKI',
+       'secretkey' => 'secret123',
+       'bucket'    => 'gitlab-registry-bucket-AKIAKIAKI',
+       'chunksize' => 25000000
+     }
+   }
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -648,14 +646,14 @@ Start with a value between `25000000` (25MB) and `50000000` (50MB).
 
 1. Edit `config/gitlab.yml`:
 
-    ```yaml
-    storage:
-      s3:
-        accesskey: 'AKIAKIAKI'
-        secretkey: 'secret123'
-        bucket:    'gitlab-registry-bucket-AKIAKIAKI'
-        chunksize: 25000000
-    ```
+   ```yaml
+   storage:
+     s3:
+       accesskey: 'AKIAKIAKI'
+       secretkey: 'secret123'
+       bucket:    'gitlab-registry-bucket-AKIAKIAKI'
+       chunksize: 25000000
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 
@@ -669,9 +667,9 @@ You can add a configuration option for backwards compatibility.
 
 1. Edit `/etc/gitlab/gitlab.rb`:
 
-    ```ruby
-    registry['compatibility_schema1_enabled'] = true
-    ```
+   ```ruby
+   registry['compatibility_schema1_enabled'] = true
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -681,11 +679,11 @@ You can add a configuration option for backwards compatibility.
 
 1. Edit the YML configuration file you created when you [deployed the registry][registry-deploy]. Add the following snippet:
 
-    ```yaml
-    compatibility:
-        schema1:
-            enabled: true
-    ```
+   ```yaml
+   compatibility:
+       schema1:
+           enabled: true
+   ```
 
 1. Restart the registry for the changes to take affect.
 
@@ -694,9 +692,9 @@ You can add a configuration option for backwards compatibility.
 A Docker connection error can occur when there are special characters in either the group,
 project or branch name. Special characters can include:
 
-* Leading underscore
-* Trailing hyphen/dash
-* Double hyphen/dash
+- Leading underscore
+- Trailing hyphen/dash
+- Double hyphen/dash
 
 To get around this, you can [change the group path](../user/group/index.md#changing-a-groups-path), 
 [change the project path](../user/project/settings/index.md#renaming-a-repository) or change the 
diff --git a/doc/administration/database_load_balancing.md b/doc/administration/database_load_balancing.md
index e76d3b14a40..dc4cc401fca 100644
--- a/doc/administration/database_load_balancing.md
+++ b/doc/administration/database_load_balancing.md
@@ -74,9 +74,9 @@ the following. This will balance the load between `host1.example.com` and
 
 1. Edit `/etc/gitlab/gitlab.rb` and add the following line:
 
-    ```ruby
-    gitlab_rails['db_load_balancing'] = { 'hosts' => ['host1.example.com', 'host2.example.com'] }
-    ```
+   ```ruby
+   gitlab_rails['db_load_balancing'] = { 'hosts' => ['host1.example.com', 'host2.example.com'] }
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -86,16 +86,16 @@ the following. This will balance the load between `host1.example.com` and
 
 1. Edit `/home/git/gitlab/config/database.yml` and add or amend the following lines:
 
-    ```yaml
-    production:
-      username: gitlab
-      database: gitlab
-      encoding: unicode
-      load_balancing:
-        hosts:
-          - host1.example.com
-          - host2.example.com
-    ```
+   ```yaml
+   production:
+     username: gitlab
+     database: gitlab
+     encoding: unicode
+     load_balancing:
+       hosts:
+         - host1.example.com
+         - host2.example.com
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 
diff --git a/doc/administration/incoming_email.md b/doc/administration/incoming_email.md
index 53a61358670..73a39a6dd35 100644
--- a/doc/administration/incoming_email.md
+++ b/doc/administration/incoming_email.md
@@ -102,16 +102,16 @@ for a real-world example of this exploit.
 
 1. Reconfigure GitLab for the changes to take effect:
 
-    ```sh
-    sudo gitlab-ctl reconfigure
-    sudo gitlab-ctl restart
-    ```
+   ```sh
+   sudo gitlab-ctl reconfigure
+   sudo gitlab-ctl restart
+   ```
 
 1. Verify that everything is configured correctly:
 
-    ```sh
-    sudo gitlab-rake gitlab:incoming_email:check
-    ```
+   ```sh
+   sudo gitlab-rake gitlab:incoming_email:check
+   ```
 
 Reply by email should now be working.
 
@@ -119,31 +119,31 @@ Reply by email should now be working.
 
 1. Go to the GitLab installation directory:
 
-    ```sh
-    cd /home/git/gitlab
-    ```
+   ```sh
+   cd /home/git/gitlab
+   ```
 
 1. Find the `incoming_email` section in `config/gitlab.yml`, enable the feature
   and fill in the details for your specific IMAP server and email account (see [examples](#config-examples) below).
 
 1. Enable `mail_room` in the init script at `/etc/default/gitlab`:
 
-    ```sh
-    sudo mkdir -p /etc/default
-    echo 'mail_room_enabled=true' | sudo tee -a /etc/default/gitlab
-    ```
+   ```sh
+   sudo mkdir -p /etc/default
+   echo 'mail_room_enabled=true' | sudo tee -a /etc/default/gitlab
+   ```
 
 1. Restart GitLab:
 
-    ```sh
-    sudo service gitlab restart
-    ```
+   ```sh
+   sudo service gitlab restart
+   ```
 
 1. Verify that everything is configured correctly:
 
-    ```sh
-    sudo -u git -H bundle exec rake gitlab:incoming_email:check RAILS_ENV=production
-    ```
+   ```sh
+   sudo -u git -H bundle exec rake gitlab:incoming_email:check RAILS_ENV=production
+   ```
 
 Reply by email should now be working.
 
diff --git a/doc/administration/issue_closing_pattern.md b/doc/administration/issue_closing_pattern.md
index f2877c49d05..e1bbabb2878 100644
--- a/doc/administration/issue_closing_pattern.md
+++ b/doc/administration/issue_closing_pattern.md
@@ -27,9 +27,10 @@ Because Rubular doesn't understand `%{issue_ref}`, you can replace this by
 1. Change the value of `gitlab_rails['gitlab_issue_closing_pattern']` to a regular
    expression of your liking:
 
-    ```ruby
-    gitlab_rails['gitlab_issue_closing_pattern'] = "\b((?:[Cc]los(?:e[sd]|ing)|\b[Ff]ix(?:e[sd]|ing)?) +(?:(?:issues? +)?%{issue_ref}(?:(?:, *| +and +)?))+)"
-    ```
+   ```ruby
+   gitlab_rails['gitlab_issue_closing_pattern'] = "\b((?:[Cc]los(?:e[sd]|ing)|\b[Ff]ix(?:e[sd]|ing)?) +(?:(?:issues? +)?%{issue_ref}(?:(?:, *| +and +)?))+)"
+   ```
+
 1. [Reconfigure] GitLab for the changes to take effect.
 
 **For installations from source**
@@ -37,9 +38,9 @@ Because Rubular doesn't understand `%{issue_ref}`, you can replace this by
 1. Open `gitlab.yml` with your editor.
 1. Change the value of `issue_closing_pattern`:
 
-    ```yaml
-    issue_closing_pattern: "\b((?:[Cc]los(?:e[sd]|ing)|\b[Ff]ix(?:e[sd]|ing)?) +(?:(?:issues? +)?%{issue_ref}(?:(?:, *| +and +)?))+)"
-    ```
+   ```yaml
+   issue_closing_pattern: "\b((?:[Cc]los(?:e[sd]|ing)|\b[Ff]ix(?:e[sd]|ing)?) +(?:(?:issues? +)?%{issue_ref}(?:(?:, *| +and +)?))+)"
+   ```
 
 1. [Restart] GitLab for the changes to take effect.
 
diff --git a/doc/administration/job_artifacts.md b/doc/administration/job_artifacts.md
index 05e15fc303b..9df7b2526e2 100644
--- a/doc/administration/job_artifacts.md
+++ b/doc/administration/job_artifacts.md
@@ -1,7 +1,5 @@
 # Jobs artifacts administration
 
-> **Notes:**
->
 > - Introduced in GitLab 8.2 and GitLab Runner 0.7.0.
 > - Starting with GitLab 8.4 and GitLab Runner 1.0, the artifacts archive format changed to `ZIP`.
 > - Starting with GitLab 8.17, builds are renamed to jobs.
@@ -21,9 +19,9 @@ To disable artifacts site-wide, follow the steps below.
 
 1. Edit `/etc/gitlab/gitlab.rb` and add the following line:
 
-    ```ruby
-    gitlab_rails['artifacts_enabled'] = false
-    ```
+   ```ruby
+   gitlab_rails['artifacts_enabled'] = false
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -33,10 +31,10 @@ To disable artifacts site-wide, follow the steps below.
 
 1. Edit `/home/git/gitlab/config/gitlab.yml` and add or amend the following lines:
 
-    ```yaml
-    artifacts:
-      enabled: false
-    ```
+   ```yaml
+   artifacts:
+     enabled: false
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 
@@ -61,9 +59,9 @@ _The artifacts are stored by default in
 1. To change the storage path for example to `/mnt/storage/artifacts`, edit
    `/etc/gitlab/gitlab.rb` and add the following line:
 
-    ```ruby
-    gitlab_rails['artifacts_path'] = "/mnt/storage/artifacts"
-    ```
+   ```ruby
+   gitlab_rails['artifacts_path'] = "/mnt/storage/artifacts"
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -77,18 +75,16 @@ _The artifacts are stored by default in
 1. To change the storage path for example to `/mnt/storage/artifacts`, edit
    `/home/git/gitlab/config/gitlab.yml` and add or amend the following lines:
 
-    ```yaml
-    artifacts:
-      enabled: true
-      path: /mnt/storage/artifacts
-    ```
+   ```yaml
+   artifacts:
+     enabled: true
+     path: /mnt/storage/artifacts
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 
 ### Using object storage
 
-> **Notes:**
->
 > - [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/1762) in
 >   [GitLab Premium](https://about.gitlab.com/pricing/) 9.4.
 > - Since version 9.5, artifacts are [browsable](../user/project/pipelines/job_artifacts.md#browsing-artifacts),
@@ -141,35 +137,35 @@ _The artifacts are stored by default in
 1. Edit `/etc/gitlab/gitlab.rb` and add the following lines by replacing with
    the values you want:
 
-    ```ruby
-    gitlab_rails['artifacts_enabled'] = true
-    gitlab_rails['artifacts_object_store_enabled'] = true
-    gitlab_rails['artifacts_object_store_remote_directory'] = "artifacts"
-    gitlab_rails['artifacts_object_store_connection'] = {
-      'provider' => 'AWS',
-      'region' => 'eu-central-1',
-      'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
-      'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY'
-    }
-    ```
+   ```ruby
+   gitlab_rails['artifacts_enabled'] = true
+   gitlab_rails['artifacts_object_store_enabled'] = true
+   gitlab_rails['artifacts_object_store_remote_directory'] = "artifacts"
+   gitlab_rails['artifacts_object_store_connection'] = {
+     'provider' => 'AWS',
+     'region' => 'eu-central-1',
+     'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
+     'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY'
+   }
+   ```
 
-    NOTE: For GitLab 9.4+, if you are using AWS IAM profiles, be sure to omit the
-    AWS access key and secret access key/value pairs. For example:
+   NOTE: For GitLab 9.4+, if you are using AWS IAM profiles, be sure to omit the
+   AWS access key and secret access key/value pairs. For example:
 
-    ```ruby
-    gitlab_rails['artifacts_object_store_connection'] = {
-      'provider' => 'AWS',
-      'region' => 'eu-central-1',
-      'use_iam_profile' => true
-    }
-    ```
+   ```ruby
+   gitlab_rails['artifacts_object_store_connection'] = {
+     'provider' => 'AWS',
+     'region' => 'eu-central-1',
+     'use_iam_profile' => true
+   }
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 1. Migrate any existing local artifacts to the object storage:
 
-    ```bash
-    gitlab-rake gitlab:artifacts:migrate
-    ```
+   ```bash
+   gitlab-rake gitlab:artifacts:migrate
+   ```
 
 ---
 
@@ -181,25 +177,25 @@ _The artifacts are stored by default in
 1. Edit `/home/git/gitlab/config/gitlab.yml` and add or amend the following
    lines:
 
-    ```yaml
-    artifacts:
-      enabled: true
-      object_store:
-        enabled: true
-        remote_directory: "artifacts" # The bucket name
-        connection:
-          provider: AWS # Only AWS supported at the moment
-          aws_access_key_id: AWS_ACCESS_KEY_ID
-          aws_secret_access_key: AWS_SECRET_ACCESS_KEY
-          region: eu-central-1
-    ```
+   ```yaml
+   artifacts:
+     enabled: true
+     object_store:
+       enabled: true
+       remote_directory: "artifacts" # The bucket name
+       connection:
+         provider: AWS # Only AWS supported at the moment
+         aws_access_key_id: AWS_ACCESS_KEY_ID
+         aws_secret_access_key: AWS_SECRET_ACCESS_KEY
+         region: eu-central-1
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 1. Migrate any existing local artifacts to the object storage:
 
-    ```bash
-    sudo -u git -H bundle exec rake gitlab:artifacts:migrate RAILS_ENV=production
-    ```
+   ```bash
+   sudo -u git -H bundle exec rake gitlab:artifacts:migrate RAILS_ENV=production
+   ```
 
 ## Expiring artifacts
 
@@ -217,9 +213,9 @@ steps below.
 
 1. Edit `/etc/gitlab/gitlab.rb` and comment out or add the following line
 
-    ```ruby
-    gitlab_rails['expire_build_artifacts_worker_cron'] = "50 * * * *"
-    ```
+   ```ruby
+   gitlab_rails['expire_build_artifacts_worker_cron'] = "50 * * * *"
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -230,10 +226,10 @@ steps below.
 1. Edit `/home/git/gitlab/config/gitlab.yml` and add or amend the following
    lines:
 
-    ```yaml
-    expire_build_artifacts_worker:
-      cron: "50 * * * *"
-    ```
+   ```yaml
+   expire_build_artifacts_worker:
+     cron: "50 * * * *"
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 
@@ -250,15 +246,15 @@ you can flip the feature flag from a Rails console.
 
 1. Enter the Rails console:
 
-    ```sh
-    sudo gitlab-rails console
-    ```
+   ```sh
+   sudo gitlab-rails console
+   ```
 
 1. Flip the switch and disable it:
 
-    ```ruby
-    Feature.enable('ci_disable_validates_dependencies')
-    ```
+   ```ruby
+   Feature.enable('ci_disable_validates_dependencies')
+   ```
 
 ---
 
@@ -266,16 +262,16 @@ you can flip the feature flag from a Rails console.
 
 1. Enter the Rails console:
 
-    ```sh
-    cd /home/git/gitlab
-    RAILS_ENV=production sudo -u git -H bundle exec rails console
-    ```
+   ```sh
+   cd /home/git/gitlab
+   RAILS_ENV=production sudo -u git -H bundle exec rails console
+   ```
 
 1. Flip the switch and disable it:
 
-    ```ruby
-    Feature.enable('ci_disable_validates_dependencies')
-    ```
+   ```ruby
+   Feature.enable('ci_disable_validates_dependencies')
+   ```
 
 ## Set the maximum file size of the artifacts
 
diff --git a/doc/administration/job_traces.md b/doc/administration/job_traces.md
index 6556614723d..957916893d7 100644
--- a/doc/administration/job_traces.md
+++ b/doc/administration/job_traces.md
@@ -25,11 +25,11 @@ To change the location where the job logs will be stored, follow the steps below
 
 **In Omnibus installations:**
 
-1.  Edit `/etc/gitlab/gitlab.rb` and add or amend the following line:
+1. Edit `/etc/gitlab/gitlab.rb` and add or amend the following line:
 
-    ```
-    gitlab_ci['builds_directory'] = '/mnt/to/gitlab-ci/builds'
-    ```
+   ```ruby
+   gitlab_ci['builds_directory'] = '/mnt/to/gitlab-ci/builds'
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -39,12 +39,12 @@ To change the location where the job logs will be stored, follow the steps below
 
 1. Edit `/home/git/gitlab/config/gitlab.yml` and add or amend the following lines:
 
-    ```yaml
-    gitlab_ci:
-      # The location where build traces are stored (default: builds/).
-      # Relative paths are relative to Rails.root.
-      builds_path: path/to/builds/
-    ```
+   ```yaml
+   gitlab_ci:
+     # The location where build traces are stored (default: builds/).
+     # Relative paths are relative to Rails.root.
+     builds_path: path/to/builds/
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 
@@ -67,24 +67,24 @@ To archive those legacy job traces, please follow the instruction below.
 
 1. Execute the following command
 
-    ```bash
-    gitlab-rake gitlab:traces:archive
-    ```
+   ```bash
+   gitlab-rake gitlab:traces:archive
+   ```
 
-    After you executed this task, GitLab instance queues up Sidekiq jobs (asynchronous processes)
-    for migrating job trace files from local storage to object storage.
-    It could take time to complete the all migration jobs. You can check the progress by the following command
+   After you executed this task, GitLab instance queues up Sidekiq jobs (asynchronous processes)
+   for migrating job trace files from local storage to object storage.
+   It could take time to complete the all migration jobs. You can check the progress by the following command
 
-    ```bash
-    sudo gitlab-rails console
-    ```
+   ```bash
+   sudo gitlab-rails console
+   ```
 
-    ```bash
-    [1] pry(main)> Sidekiq::Stats.new.queues['pipeline_background:archive_trace']
-    => 100
-    ```
+   ```bash
+   [1] pry(main)> Sidekiq::Stats.new.queues['pipeline_background:archive_trace']
+   => 100
+   ```
 
-    If the count becomes zero, the archiving processes are done
+   If the count becomes zero, the archiving processes are done
 
 ## How to migrate archived job traces to object storage
 
diff --git a/doc/administration/merge_request_diffs.md b/doc/administration/merge_request_diffs.md
index c328d4c3aaa..99cd9051778 100644
--- a/doc/administration/merge_request_diffs.md
+++ b/doc/administration/merge_request_diffs.md
@@ -21,18 +21,18 @@ To enable external storage of merge request diffs, follow the instructions below
 
 1. Edit `/etc/gitlab/gitlab.rb` and add the following line:
 
-    ```ruby
-    gitlab_rails['external_diffs_enabled'] = true
-    ```
+   ```ruby
+   gitlab_rails['external_diffs_enabled'] = true
+   ```
 
 1. _The external diffs will be stored in in
    `/var/opt/gitlab/gitlab-rails/shared/external-diffs`._ To change the path,
    for example, to `/mnt/storage/external-diffs`, edit `/etc/gitlab/gitlab.rb`
    and add the following line:
 
-    ```ruby
-    gitlab_rails['external_diffs_storage_path'] = "/mnt/storage/external-diffs"
-    ```
+   ```ruby
+   gitlab_rails['external_diffs_storage_path'] = "/mnt/storage/external-diffs"
+   ```
 
 1. Save the file and [reconfigure GitLab](restart_gitlab.md#omnibus-gitlab-reconfigure) for the changes to take effect.
 
@@ -41,21 +41,21 @@ To enable external storage of merge request diffs, follow the instructions below
 1. Edit `/home/git/gitlab/config/gitlab.yml` and add or amend the following
    lines:
 
-    ```yaml
-    external_diffs:
-      enabled: true
-    ```
+   ```yaml
+   external_diffs:
+     enabled: true
+   ```
 
 1. _The external diffs will be stored in
    `/home/git/gitlab/shared/external-diffs`._ To change the path, for example,
    to `/mnt/storage/external-diffs`, edit `/home/git/gitlab/config/gitlab.yml`
    and add or amend the following lines:
 
-    ```yaml
-    external_diffs:
-      enabled: true
-      storage_path: /mnt/storage/external-diffs
-    ```
+   ```yaml
+   external_diffs:
+     enabled: true
+     storage_path: /mnt/storage/external-diffs
+   ```
 
 1. Save the file and [restart GitLab](restart_gitlab.md#installations-from-source) for the changes to take effect.
 
@@ -101,28 +101,28 @@ The connection settings match those provided by [Fog](https://github.com/fog), a
 1. Edit `/etc/gitlab/gitlab.rb` and add the following lines by replacing with
    the values you want:
 
-    ```ruby
-    gitlab_rails['external_diffs_enabled'] = true
-    gitlab_rails['external_diffs_object_store_enabled'] = true
-    gitlab_rails['external_diffs_object_store_remote_directory'] = "external-diffs"
-    gitlab_rails['external_diffs_object_store_connection'] = {
-      'provider' => 'AWS',
-      'region' => 'eu-central-1',
-      'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
-      'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY'
-    }
-    ```
+   ```ruby
+   gitlab_rails['external_diffs_enabled'] = true
+   gitlab_rails['external_diffs_object_store_enabled'] = true
+   gitlab_rails['external_diffs_object_store_remote_directory'] = "external-diffs"
+   gitlab_rails['external_diffs_object_store_connection'] = {
+     'provider' => 'AWS',
+     'region' => 'eu-central-1',
+     'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
+     'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY'
+   }
+   ```
 
-    Note that, if you are using AWS IAM profiles, be sure to omit the
-    AWS access key and secret access key/value pairs. For example:
+   Note that, if you are using AWS IAM profiles, be sure to omit the
+   AWS access key and secret access key/value pairs. For example:
 
-    ```ruby
-    gitlab_rails['external_diffs_object_store_connection'] = {
-      'provider' => 'AWS',
-      'region' => 'eu-central-1',
-      'use_iam_profile' => true
-    }
-    ```
+   ```ruby
+   gitlab_rails['external_diffs_object_store_connection'] = {
+     'provider' => 'AWS',
+     'region' => 'eu-central-1',
+     'use_iam_profile' => true
+   }
+   ```
 
 1. Save the file and [reconfigure GitLab](restart_gitlab.md#omnibus-gitlab-reconfigure) for the changes to take effect.
 
@@ -131,18 +131,18 @@ The connection settings match those provided by [Fog](https://github.com/fog), a
 1. Edit `/home/git/gitlab/config/gitlab.yml` and add or amend the following
    lines:
 
-    ```yaml
-    external_diffs:
-      enabled: true
-      object_store:
-        enabled: true
-        remote_directory: "external-diffs" # The bucket name
-        connection:
-          provider: AWS # Only AWS supported at the moment
-          aws_access_key_id: AWS_ACCESS_KEY_ID
-          aws_secret_access_key: AWS_SECRET_ACCESS_KEY
-          region: eu-central-1
-    ```
+   ```yaml
+   external_diffs:
+     enabled: true
+     object_store:
+       enabled: true
+       remote_directory: "external-diffs" # The bucket name
+       connection:
+         provider: AWS # Only AWS supported at the moment
+         aws_access_key_id: AWS_ACCESS_KEY_ID
+         aws_secret_access_key: AWS_SECRET_ACCESS_KEY
+         region: eu-central-1
+   ```
 
 1. Save the file and [restart GitLab](restart_gitlab.md#installations-from-source) for the changes to take effect.
 
@@ -157,11 +157,11 @@ To enable this feature, perform the following steps:
 
 **In Omnibus installations:**
 
-1.  Edit `/etc/gitlab/gitlab.rb` and add the following line:
+1. Edit `/etc/gitlab/gitlab.rb` and add the following line:
 
-    ```ruby
-    gitlab_rails['external_diffs_when'] = 'outdated'
-    ```
+   ```ruby
+   gitlab_rails['external_diffs_when'] = 'outdated'
+   ```
 
 1. Save the file and [reconfigure GitLab](restart_gitlab.md#omnibus-gitlab-reconfigure) for the changes to take effect.
 
@@ -170,11 +170,11 @@ To enable this feature, perform the following steps:
 1. Edit `/home/git/gitlab/config/gitlab.yml` and add or amend the following
    lines:
 
-    ```yaml
-    external_diffs:
-      enabled: true
-      when: outdated
-    ```
+   ```yaml
+   external_diffs:
+     enabled: true
+     when: outdated
+   ```
 
 1. Save the file and [restart GitLab](restart_gitlab.md#installations-from-source) for the changes to take effect.
 
diff --git a/doc/administration/packages.md b/doc/administration/packages.md
index 1da8de12188..c0f8777a8c0 100644
--- a/doc/administration/packages.md
+++ b/doc/administration/packages.md
@@ -28,9 +28,9 @@ To enable the Packages feature:
 
 1. Edit `/etc/gitlab/gitlab.rb` and add the following line:
 
-    ```ruby
-    gitlab_rails['packages_enabled'] = true
-    ```
+   ```ruby
+   gitlab_rails['packages_enabled'] = true
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -39,10 +39,11 @@ To enable the Packages feature:
 1. After the installation is complete, you will have to configure the `packages`
    section in `config/gitlab.yml`. Set to `true` to enable it:
 
-      ```yaml
-      packages:
-        enabled: true
-      ```
+   ```yaml
+   packages:
+     enabled: true
+   ```
+
 1. [Restart GitLab] for the changes to take effect.
 
 ## Changing the storage path
@@ -61,9 +62,9 @@ To change the local storage path:
 
 1. Edit `/etc/gitlab/gitlab.rb` and add the following line:
 
-    ```ruby
-    gitlab_rails['packages_storage_path'] = "/mnt/packages"
-    ```
+   ```ruby
+   gitlab_rails['packages_storage_path'] = "/mnt/packages"
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -71,11 +72,12 @@ To change the local storage path:
 
 1. Edit the `packages` section in `config/gitlab.yml`:
 
-      ```yaml
-      packages:
-        enabled: true
-        storage_path: shared/packages
-      ```
+   ```yaml
+   packages:
+     enabled: true
+     storage_path: shared/packages
+   ```
+
 1. [Restart GitLab] for the changes to take effect.
 
 ### Using object storage
@@ -88,31 +90,31 @@ upload packages:
 1. Edit `/etc/gitlab/gitlab.rb` and add the following lines (uncomment where
    necessary):
 
-    ```ruby
-    gitlab_rails['packages_enabled'] = true
-    gitlab_rails['packages_storage_path'] = "/var/opt/gitlab/gitlab-rails/shared/packages"
-    gitlab_rails['packages_object_store_enabled'] = true
-    gitlab_rails['packages_object_store_remote_directory'] = "packages" # The bucket name.
-    gitlab_rails['packages_object_store_direct_upload'] = false         # Use Object Storage directly for uploads instead of background uploads if enabled (Default: false).
-    gitlab_rails['packages_object_store_background_upload'] = true      # Temporary option to limit automatic upload (Default: true).
-    gitlab_rails['packages_object_store_proxy_download'] = false        # Passthrough all downloads via GitLab instead of using Redirects to Object Storage.
-    gitlab_rails['packages_object_store_connection'] = {
-      ##
-      ## If the provider is AWS S3, uncomment the following
-      ##
-      #'provider' => 'AWS',
-      #'region' => 'eu-west-1',
-      #'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
-      #'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY',
-      ##
-      ## If the provider is other than AWS (an S3-compatible one), uncomment the following
-      ##
-      #'host' => 's3.amazonaws.com',
-      #'aws_signature_version' => 4             # For creation of signed URLs. Set to 2 if provider does not support v4.
-      #'endpoint' => 'https://s3.amazonaws.com' # Useful for S3-compliant services such as DigitalOcean Spaces.
-      #'path_style' => false                    # If true, use 'host/bucket_name/object' instead of 'bucket_name.host/object'.
-    }
-    ```
+   ```ruby
+   gitlab_rails['packages_enabled'] = true
+   gitlab_rails['packages_storage_path'] = "/var/opt/gitlab/gitlab-rails/shared/packages"
+   gitlab_rails['packages_object_store_enabled'] = true
+   gitlab_rails['packages_object_store_remote_directory'] = "packages" # The bucket name.
+   gitlab_rails['packages_object_store_direct_upload'] = false         # Use Object Storage directly for uploads instead of background uploads if enabled (Default: false).
+   gitlab_rails['packages_object_store_background_upload'] = true      # Temporary option to limit automatic upload (Default: true).
+   gitlab_rails['packages_object_store_proxy_download'] = false        # Passthrough all downloads via GitLab instead of using Redirects to Object Storage.
+   gitlab_rails['packages_object_store_connection'] = {
+     ##
+     ## If the provider is AWS S3, uncomment the following
+     ##
+     #'provider' => 'AWS',
+     #'region' => 'eu-west-1',
+     #'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
+     #'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY',
+     ##
+     ## If the provider is other than AWS (an S3-compatible one), uncomment the following
+     ##
+     #'host' => 's3.amazonaws.com',
+     #'aws_signature_version' => 4             # For creation of signed URLs. Set to 2 if provider does not support v4.
+     #'endpoint' => 'https://s3.amazonaws.com' # Useful for S3-compliant services such as DigitalOcean Spaces.
+     #'path_style' => false                    # If true, use 'host/bucket_name/object' instead of 'bucket_name.host/object'.
+   }
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -120,35 +122,35 @@ upload packages:
 
 1. Edit the `packages` section in `config/gitlab.yml` (uncomment where necessary):
 
-    ```yaml
-      packages:
-        enabled: true
-        ##
-        ## The location where build packages are stored (default: shared/packages).
-        ##
-        #storage_path: shared/packages
-        object_store:
-          enabled: false
-          remote_directory: packages # The bucket name.
-          #direct_upload: false      # Use Object Storage directly for uploads instead of background uploads if enabled (Default: false).
-          #background_upload: true   # Temporary option to limit automatic upload (Default: true).
-          #proxy_download: false     # Passthrough all downloads via GitLab instead of using Redirects to Object Storage.
-          connection:
-            ##
-            ## If the provider is AWS S3, uncomment the following
-            ##
-            #provider: AWS
-            #region: us-east-1
-            #aws_access_key_id: AWS_ACCESS_KEY_ID
-            #aws_secret_access_key: AWS_SECRET_ACCESS_KEY
-            ##
-            ## If the provider is other than AWS (an S3-compatible one), uncomment the following
-            ##
-            #host: 's3.amazonaws.com'             # default: s3.amazonaws.com.
-            #aws_signature_version: 4             # For creation of signed URLs. Set to 2 if provider does not support v4.
-            #endpoint: 'https://s3.amazonaws.com' # Useful for S3-compliant services such as DigitalOcean Spaces.
-            #path_style: false                    # If true, use 'host/bucket_name/object' instead of 'bucket_name.host/object'.
-    ```
+   ```yaml
+     packages:
+       enabled: true
+       ##
+       ## The location where build packages are stored (default: shared/packages).
+       ##
+       #storage_path: shared/packages
+       object_store:
+         enabled: false
+         remote_directory: packages # The bucket name.
+         #direct_upload: false      # Use Object Storage directly for uploads instead of background uploads if enabled (Default: false).
+         #background_upload: true   # Temporary option to limit automatic upload (Default: true).
+         #proxy_download: false     # Passthrough all downloads via GitLab instead of using Redirects to Object Storage.
+         connection:
+           ##
+           ## If the provider is AWS S3, uncomment the following
+           ##
+           #provider: AWS
+           #region: us-east-1
+           #aws_access_key_id: AWS_ACCESS_KEY_ID
+           #aws_secret_access_key: AWS_SECRET_ACCESS_KEY
+           ##
+           ## If the provider is other than AWS (an S3-compatible one), uncomment the following
+           ##
+           #host: 's3.amazonaws.com'             # default: s3.amazonaws.com.
+           #aws_signature_version: 4             # For creation of signed URLs. Set to 2 if provider does not support v4.
+           #endpoint: 'https://s3.amazonaws.com' # Useful for S3-compliant services such as DigitalOcean Spaces.
+           #path_style: false                    # If true, use 'host/bucket_name/object' instead of 'bucket_name.host/object'.
+   ```
 
 1. [Restart GitLab] for the changes to take effect.
 
diff --git a/doc/administration/pseudonymizer.md b/doc/administration/pseudonymizer.md
index 3278409d4b5..78b2751da13 100644
--- a/doc/administration/pseudonymizer.md
+++ b/doc/administration/pseudonymizer.md
@@ -31,27 +31,27 @@ To configure the pseudonymizer, you need to:
 1. Edit `/etc/gitlab/gitlab.rb` and add the following lines by replacing with
    the values you want:
 
-    ```ruby
-    gitlab_rails['pseudonymizer_manifest'] = 'config/pseudonymizer.yml'
-    gitlab_rails['pseudonymizer_upload_remote_directory'] = 'gitlab-elt' # bucket name
-    gitlab_rails['pseudonymizer_upload_connection'] = {
-      'provider' => 'AWS',
-      'region' => 'eu-central-1',
-      'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
-      'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY'
-    }
-    ```
+   ```ruby
+   gitlab_rails['pseudonymizer_manifest'] = 'config/pseudonymizer.yml'
+   gitlab_rails['pseudonymizer_upload_remote_directory'] = 'gitlab-elt' # bucket name
+   gitlab_rails['pseudonymizer_upload_connection'] = {
+     'provider' => 'AWS',
+     'region' => 'eu-central-1',
+     'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
+     'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY'
+   }
+   ```
 
-    NOTE: **Note:**
-    If you are using AWS IAM profiles, be sure to omit the AWS access key and secret access key/value pairs.
+   NOTE: **Note:**
+   If you are using AWS IAM profiles, be sure to omit the AWS access key and secret access key/value pairs.
 
-    ```ruby
-    gitlab_rails['pseudonymizer_upload_connection'] = {
-      'provider' => 'AWS',
-      'region' => 'eu-central-1',
-      'use_iam_profile' => true
-    }
-    ```
+   ```ruby
+   gitlab_rails['pseudonymizer_upload_connection'] = {
+     'provider' => 'AWS',
+     'region' => 'eu-central-1',
+     'use_iam_profile' => true
+   }
+   ```
 
 1. Save the file and [reconfigure GitLab](restart_gitlab.md#omnibus-gitlab-reconfigure)
    for the changes to take effect.
@@ -63,17 +63,17 @@ To configure the pseudonymizer, you need to:
 1. Edit `/home/git/gitlab/config/gitlab.yml` and add or amend the following
    lines:
 
-    ```yaml
-    pseudonymizer:
-	  manifest: config/pseudonymizer.yml
-	  upload:
-        remote_directory: 'gitlab-elt' # bucket name
-        connection:
-          provider: AWS
-          aws_access_key_id: AWS_ACCESS_KEY_ID
-          aws_secret_access_key: AWS_SECRET_ACCESS_KEY
-          region: eu-central-1
-    ```
+   ```yaml
+   pseudonymizer:
+   manifest: config/pseudonymizer.yml
+   upload:
+       remote_directory: 'gitlab-elt' # bucket name
+       connection:
+         provider: AWS
+         aws_access_key_id: AWS_ACCESS_KEY_ID
+         aws_secret_access_key: AWS_SECRET_ACCESS_KEY
+         region: eu-central-1
+   ```
 
 1. Save the file and [restart GitLab](restart_gitlab.md#installations-from-source)
    for the changes to take effect.
diff --git a/doc/administration/reply_by_email_postfix_setup.md b/doc/administration/reply_by_email_postfix_setup.md
index d57fc67c83e..406f7e8a034 100644
--- a/doc/administration/reply_by_email_postfix_setup.md
+++ b/doc/administration/reply_by_email_postfix_setup.md
@@ -14,109 +14,109 @@ The instructions make the assumption that you will be using the email address `i
 
 1. Install the `postfix` package if it is not installed already:
 
-    ```sh
-    sudo apt-get install postfix
-    ```
+   ```sh
+   sudo apt-get install postfix
+   ```
 
-    When asked about the environment, select 'Internet Site'. When asked to confirm the hostname, make sure it matches `gitlab.example.com`.
+   When asked about the environment, select 'Internet Site'. When asked to confirm the hostname, make sure it matches gitlab.example.com`.
 
 1. Install the `mailutils` package.
 
-    ```sh
-    sudo apt-get install mailutils
-    ```
+   ```sh
+   sudo apt-get install mailutils
+   ```
 
 ## Create user
 
 1. Create a user for incoming email.
 
-    ```sh
-    sudo useradd -m -s /bin/bash incoming
-    ```
+   ```sh
+   sudo useradd -m -s /bin/bash incoming
+   ```
 
 1. Set a password for this user.
 
-    ```sh
-    sudo passwd incoming
-    ```
+   ```sh
+   sudo passwd incoming
+   ```
 
-    Be sure not to forget this, you'll need it later.
+   Be sure not to forget this, you'll need it later.
 
 ## Test the out-of-the-box setup
 
 1. Connect to the local SMTP server:
 
-    ```sh
-    telnet localhost 25
-    ```
+   ```sh
+   telnet localhost 25
+   ```
 
-    You should see a prompt like this:
+   You should see a prompt like this:
 
-    ```sh
-    Trying 127.0.0.1...
-    Connected to localhost.
-    Escape character is '^]'.
-    220 gitlab.example.com ESMTP Postfix (Ubuntu)
-    ```
+   ```sh
+   Trying 127.0.0.1...
+   Connected to localhost.
+   Escape character is '^]'.
+   220 gitlab.example.com ESMTP Postfix (Ubuntu)
+   ```
 
-    If you get a `Connection refused` error instead, verify that `postfix` is running:
+   If you get a `Connection refused` error instead, verify that `postfix` is running:
 
-    ```sh
-    sudo postfix status
-    ```
+   ```sh
+   sudo postfix status
+   ```
 
-    If it is not, start it:
+   If it is not, start it:
 
-    ```sh
-    sudo postfix start
-    ```
+   ```sh
+   sudo postfix start
+   ```
 
 1. Send the new `incoming` user a dummy email to test SMTP, by entering the following into the SMTP prompt:
 
-    ```
-    ehlo localhost
-    mail from: root@localhost
-    rcpt to: incoming@localhost
-    data
-    Subject: Re: Some issue
+   ```
+   ehlo localhost
+   mail from: root@localhost
+   rcpt to: incoming@localhost
+   data
+   Subject: Re: Some issue
 
-    Sounds good!
-    .
-    quit
-    ```
+   Sounds good!
+   .
+   quit
+   ```
 
-    _**Note:** The `.` is a literal period on its own line._
+   _**Note:** The `.` is a literal period on its own line._
 
-    _**Note:** If you receive an error after entering `rcpt to: incoming@localhost`
-    then your Postfix `my_network` configuration is not correct. The error will
-    say 'Temporary lookup failure'. See
-    [Configure Postfix to receive email from the Internet](#configure-postfix-to-receive-email-from-the-internet)._
+   _**Note:** If you receive an error after entering `rcpt to: incoming@localhost`
+   then your Postfix `my_network` configuration is not correct. The error will
+   say 'Temporary lookup failure'. See
+   [Configure Postfix to receive email from the Internet](#configure-postfix-to-receive-email-from-the-internet)._
 
 1. Check if the `incoming` user received the email:
 
-    ```sh
-    su - incoming
-    mail
-    ```
+   ```sh
+   su - incoming
+   mail
+   ```
 
-    You should see output like this:
+   You should see output like this:
 
-    ```
-    "/var/mail/incoming": 1 message 1 unread
-    >U   1 root@localhost                           59/2842  Re: Some issue
-    ```
+   ```
+   "/var/mail/incoming": 1 message 1 unread
+   >U   1 root@localhost                           59/2842  Re: Some issue
+   ```
 
-    Quit the mail app:
+   Quit the mail app:
 
-    ```sh
-    q
-    ```
+   ```sh
+   q
+   ```
 
 1. Log out of the `incoming` account and go back to being `root`:
 
-    ```sh
-    logout
-    ```
+   ```sh
+   logout
+   ```
 
 ## Configure Postfix to use Maildir-style mailboxes
 
@@ -124,208 +124,212 @@ Courier, which we will install later to add IMAP authentication, requires mailbo
 
 1. Configure Postfix to use Maildir-style mailboxes:
 
-    ```sh
-    sudo postconf -e "home_mailbox = Maildir/"
-    ```
+   ```sh
+   sudo postconf -e "home_mailbox = Maildir/"
+   ```
 
 1. Restart Postfix:
 
-    ```sh
-    sudo /etc/init.d/postfix restart
-    ```
+   ```sh
+   sudo /etc/init.d/postfix restart
+   ```
 
 1. Test the new setup:
 
-    1. Follow steps 1 and 2 of _[Test the out-of-the-box setup](#test-the-out-of-the-box-setup)_.
-    1. Check if the `incoming` user received the email:
+   1. Follow steps 1 and 2 of _[Test the out-of-the-box setup](#test-the-out-of-the-box-setup)_.
+   1. Check if the `incoming` user received the email:
 
-        ```sh
-        su - incoming
-        MAIL=/home/incoming/Maildir
-        mail
-        ```
+      ```sh
+      su - incoming
+      MAIL=/home/incoming/Maildir
+      mail
+      ```
 
-        You should see output like this:
+      You should see output like this:
 
-        ```
-        "/home/incoming/Maildir": 1 message 1 unread
-        >U   1 root@localhost                           59/2842  Re: Some issue
-        ```
+      ```
+      "/home/incoming/Maildir": 1 message 1 unread
+      >U   1 root@localhost                           59/2842  Re: Some issue
+      ```
 
-        Quit the mail app:
+      Quit the mail app:
 
-        ```sh
-        q
-        ```
+      ```sh
+      q
+      ```
 
-    _**Note:** If `mail` returns an error `Maildir: Is a directory` then your
-    version of `mail` doesn't support Maildir style mailboxes. Install
-    `heirloom-mailx` by running `sudo apt-get install heirloom-mailx`. Then,
-    try the above steps again, substituting `heirloom-mailx` for the `mail`
-    command._
+   _**Note:** If `mail` returns an error `Maildir: Is a directory` then your
+   version of `mail` doesn't support Maildir style mailboxes. Install
+   `heirloom-mailx` by running `sudo apt-get install heirloom-mailx`. Then,
+   try the above steps again, substituting `heirloom-mailx` for the `mail`
+   command._
 
 1. Log out of the `incoming` account and go back to being `root`:
 
-    ```sh
-    logout
-    ```
+   ```sh
+   logout
+   ```
 
 ## Install the Courier IMAP server
 
 1. Install the `courier-imap` package:
 
-    ```sh
-    sudo apt-get install courier-imap
-    ```
+   ```sh
+   sudo apt-get install courier-imap
+   ```
 
-    And start `imapd`:
-    ```sh
-    imapd start
-    ```
+   And start `imapd`:
+
+   ```sh
+   imapd start
+   ```
 
 1. The courier-authdaemon isn't started after installation. Without it, imap authentication will fail:
-    ```sh
-    sudo service courier-authdaemon start
-    ```
-    You can also configure courier-authdaemon to start on boot:
-    ```sh
-    sudo systemctl enable courier-authdaemon
-    ```
+
+   ```sh
+   sudo service courier-authdaemon start
+   ```
+
+   You can also configure courier-authdaemon to start on boot:
+
+   ```sh
+   sudo systemctl enable courier-authdaemon
+   ```
 
 ## Configure Postfix to receive email from the internet
 
 1. Let Postfix know about the domains that it should consider local:
 
-    ```sh
-    sudo postconf -e "mydestination = gitlab.example.com, localhost.localdomain, localhost"
-    ```
+   ```sh
+   sudo postconf -e "mydestination = gitlab.example.com, localhost.localdomain, localhost"
+   ```
 
 1. Let Postfix know about the IPs that it should consider part of the LAN:
 
-    We'll assume `192.168.1.0/24` is your local LAN. You can safely skip this step if you don't have other machines in the same local network.
+   We'll assume `192.168.1.0/24` is your local LAN. You can safely skip this step if you don't have other machines in the same local network.
 
-    ```sh
-    sudo postconf -e "mynetworks = 127.0.0.0/8, 192.168.1.0/24"
-    ```
+   ```sh
+   sudo postconf -e "mynetworks = 127.0.0.0/8, 192.168.1.0/24"
+   ```
 
 1. Configure Postfix to receive mail on all interfaces, which includes the internet:
 
-    ```sh
-    sudo postconf -e "inet_interfaces = all"
-    ```
+   ```sh
+   sudo postconf -e "inet_interfaces = all"
+   ```
 
 1. Configure Postfix to use the `+` delimiter for sub-addressing:
 
-    ```sh
-    sudo postconf -e "recipient_delimiter = +"
-    ```
+   ```sh
+   sudo postconf -e "recipient_delimiter = +"
+   ```
 
 1. Restart Postfix:
 
-    ```sh
-    sudo service postfix restart
-    ```
+   ```sh
+   sudo service postfix restart
+   ```
 
 ## Test the final setup
 
 1. Test SMTP under the new setup:
 
-    1. Connect to the SMTP server:
+   1. Connect to the SMTP server:
 
-        ```sh
-        telnet gitlab.example.com 25
-        ```
+      ```sh
+      telnet gitlab.example.com 25
+      ```
 
-        You should see a prompt like this:
+      You should see a prompt like this:
 
-        ```sh
-        Trying 123.123.123.123...
-        Connected to gitlab.example.com.
-        Escape character is '^]'.
-        220 gitlab.example.com ESMTP Postfix (Ubuntu)
-        ```
+      ```sh
+      Trying 123.123.123.123...
+      Connected to gitlab.example.com.
+      Escape character is '^]'.
+      220 gitlab.example.com ESMTP Postfix (Ubuntu)
+      ```
 
-        If you get a `Connection refused` error instead, make sure your firewall is set up to allow inbound traffic on port 25.
+      If you get a `Connection refused` error instead, make sure your firewall is set up to allow inbound traffic on port 25.
 
-    1. Send the `incoming` user a dummy email to test SMTP, by entering the following into the SMTP prompt:
+   1. Send the `incoming` user a dummy email to test SMTP, by entering the following into the SMTP prompt:
 
-        ```
-        ehlo gitlab.example.com
-        mail from: root@gitlab.example.com
-        rcpt to: incoming@gitlab.example.com
-        data
-        Subject: Re: Some issue
+      ```
+      ehlo gitlab.example.com
+      mail from: root@gitlab.example.com
+      rcpt to: incoming@gitlab.example.com
+      data
+      Subject: Re: Some issue
 
-        Sounds good!
-        .
-        quit
-        ```
+      Sounds good!
+      .
+      quit
+      ```
 
-        (Note: The `.` is a literal period on its own line)
+      (Note: The `.` is a literal period on its own line)
 
-    1. Check if the `incoming` user received the email:
+   1. Check if the `incoming` user received the email:
 
-        ```sh
-        su - incoming
-        MAIL=/home/incoming/Maildir
-        mail
-        ```
+      ```sh
+      su - incoming
+      MAIL=/home/incoming/Maildir
+      mail
+      ```
 
-        You should see output like this:
+      You should see output like this:
 
-        ```
-        "/home/incoming/Maildir": 1 message 1 unread
-        >U   1 root@gitlab.example.com                           59/2842  Re: Some issue
-        ```
+      ```
+      "/home/incoming/Maildir": 1 message 1 unread
+      >U   1 root@gitlab.example.com                           59/2842  Re: Some issue
+      ```
 
-        Quit the mail app:
+      Quit the mail app:
 
-        ```sh
-        q
-        ```
+      ```sh
+      q
+      ```
 
-    1. Log out of the `incoming` account and go back to being `root`:
+   1. Log out of the `incoming` account and go back to being `root`:
 
-        ```sh
-        logout
-        ```
+      ```sh
+      logout
+      ```
 
 1. Test IMAP under the new setup:
 
-    1. Connect to the IMAP server:
+   1. Connect to the IMAP server:
 
-        ```sh
-        telnet gitlab.example.com 143
-        ```
+      ```sh
+      telnet gitlab.example.com 143
+      ```
 
-        You should see a prompt like this:
+      You should see a prompt like this:
 
-        ```sh
-        Trying 123.123.123.123...
-        Connected to mail.example.gitlab.com.
-        Escape character is '^]'.
-        - OK [CAPABILITY IMAP4rev1 UIDPLUS CHILDREN NAMESPACE THREAD=ORDEREDSUBJECT THREAD=REFERENCES SORT QUOTA IDLE ACL ACL2=UNION] Courier-IMAP ready. Copyright 1998-2011 Double Precision, Inc.  See COPYING for distribution information.
-        ```
+      ```sh
+      Trying 123.123.123.123...
+      Connected to mail.example.gitlab.com.
+      Escape character is '^]'.
+      - OK [CAPABILITY IMAP4rev1 UIDPLUS CHILDREN NAMESPACE THREAD=ORDEREDSUBJECT THREAD=REFERENCES SORT QUOTA IDLE ACL ACL2=UNION] Courier-IMAP ready. Copyright 1998-2011 Double Precision, Inc.  See COPYING for distribution information.
+      ```
 
-    1. Sign in as the `incoming` user to test IMAP, by entering the following into the IMAP prompt:
+   1. Sign in as the `incoming` user to test IMAP, by entering the following into the IMAP prompt:
 
-        ```
-        a login incoming PASSWORD
-        ```
+      ```
+      a login incoming PASSWORD
+      ```
 
-        Replace PASSWORD with the password you set on the `incoming` user earlier.
+      Replace PASSWORD with the password you set on the `incoming` user earlier.
 
-        You should see output like this:
+      You should see output like this:
 
-        ```
-        a OK LOGIN Ok.
-        ```
+      ```
+      a OK LOGIN Ok.
+      ```
 
-    1. Disconnect from the IMAP server:
+   1. Disconnect from the IMAP server:
 
-        ```sh
-        a logout
-        ```
+      ```sh
+      a logout
+      ```
 
 ## Done!
 
diff --git a/doc/administration/repository_storage_paths.md b/doc/administration/repository_storage_paths.md
index 4aafc06cfdc..3de860f9240 100644
--- a/doc/administration/repository_storage_paths.md
+++ b/doc/administration/repository_storage_paths.md
@@ -68,18 +68,18 @@ NOTE: **Note:** This example uses NFS and CephFS. We do not recommend using EFS
 
 1. Edit `gitlab.yml` and add the storage paths:
 
-    ```yaml
-    repositories:
-      # Paths where repositories can be stored. Give the canonicalized absolute pathname.
-      # NOTE: REPOS PATHS MUST NOT CONTAIN ANY SYMLINK!!!
-      storages: # You must have at least a 'default' storage path.
-        default:
-          path: /home/git/repositories
-        nfs:
-          path: /mnt/nfs/repositories
-        cephfs:
-          path: /mnt/cephfs/repositories
-    ```
+   ```yaml
+   repositories:
+     # Paths where repositories can be stored. Give the canonicalized absolute pathname.
+     # NOTE: REPOS PATHS MUST NOT CONTAIN ANY SYMLINK!!!
+     storages: # You must have at least a 'default' storage path.
+       default:
+         path: /home/git/repositories
+       nfs:
+         path: /mnt/nfs/repositories
+       cephfs:
+         path: /mnt/cephfs/repositories
+   ```
 
 1. [Restart GitLab][restart-gitlab] for the changes to take effect.
 
@@ -97,16 +97,16 @@ working, you can remove the `repos_path` line.
 1. Edit `/etc/gitlab/gitlab.rb` by appending the rest of the paths to the
    default one:
 
-    ```ruby
-    git_data_dirs({
-      "default" => { "path" => "/var/opt/gitlab/git-data" },
-      "nfs" => { "path" => "/mnt/nfs/git-data" },
-      "cephfs" => { "path" => "/mnt/cephfs/git-data" }
-    })
-    ```
+   ```ruby
+   git_data_dirs({
+     "default" => { "path" => "/var/opt/gitlab/git-data" },
+     "nfs" => { "path" => "/mnt/nfs/git-data" },
+     "cephfs" => { "path" => "/mnt/cephfs/git-data" }
+   })
+   ```
 
-    Note that Omnibus stores the repositories in a `repositories` subdirectory
-    of the `git-data` directory.
+   Note that Omnibus stores the repositories in a `repositories` subdirectory
+   of the `git-data` directory.
 
 ## Choose where new project repositories will be stored
 
diff --git a/doc/administration/uploads.md b/doc/administration/uploads.md
index c6103a28204..c6529812ec3 100644
--- a/doc/administration/uploads.md
+++ b/doc/administration/uploads.md
@@ -23,10 +23,10 @@ _The uploads are stored by default in `/var/opt/gitlab/gitlab-rails/uploads`._
 1. To change the storage path for example to `/mnt/storage/uploads`, edit
    `/etc/gitlab/gitlab.rb` and add the following line:
 
-    ```ruby
-    gitlab_rails['uploads_storage_path'] = "/mnt/storage/"
-	gitlab_rails['uploads_base_dir'] = "uploads"
-    ```
+   ```ruby
+   gitlab_rails['uploads_storage_path'] = "/mnt/storage/"
+   gitlab_rails['uploads_base_dir'] = "uploads"
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 
@@ -40,11 +40,11 @@ _The uploads are stored by default in
 1. To change the storage path for example to `/mnt/storage/uploads`, edit
    `/home/git/gitlab/config/gitlab.yml` and add or amend the following lines:
 
-    ```yaml
-	uploads:
-	  storage_path: /mnt/storage
-	  base_dir: uploads
-    ```
+   ```yaml
+   uploads:
+   storage_path: /mnt/storage
+   base_dir: uploads
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 
@@ -97,27 +97,27 @@ _The uploads are stored by default in
 1. Edit `/etc/gitlab/gitlab.rb` and add the following lines by replacing with
    the values you want:
 
-    ```ruby
-    gitlab_rails['uploads_object_store_enabled'] = true
-    gitlab_rails['uploads_object_store_remote_directory'] = "uploads"
-    gitlab_rails['uploads_object_store_connection'] = {
-      'provider' => 'AWS',
-      'region' => 'eu-central-1',
-      'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
-      'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY'
-    }
-    ```
+   ```ruby
+   gitlab_rails['uploads_object_store_enabled'] = true
+   gitlab_rails['uploads_object_store_remote_directory'] = "uploads"
+   gitlab_rails['uploads_object_store_connection'] = {
+     'provider' => 'AWS',
+     'region' => 'eu-central-1',
+     'aws_access_key_id' => 'AWS_ACCESS_KEY_ID',
+     'aws_secret_access_key' => 'AWS_SECRET_ACCESS_KEY'
+   }
+   ```
 
-	>**Note:**
-	If you are using AWS IAM profiles, be sure to omit the AWS access key and secret access key/value pairs.
+   >**Note:**
+   >If you are using AWS IAM profiles, be sure to omit the AWS access key and secret access key/value pairs.
 
-    ```ruby
-    gitlab_rails['uploads_object_store_connection'] = {
-      'provider' => 'AWS',
-      'region' => 'eu-central-1',
-      'use_iam_profile' => true
-    }
-    ```
+   ```ruby
+   gitlab_rails['uploads_object_store_connection'] = {
+     'provider' => 'AWS',
+     'region' => 'eu-central-1',
+     'use_iam_profile' => true
+   }
+   ```
 
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
 1. Migrate any existing local uploads to the object storage using [`gitlab:uploads:migrate` rake task](raketasks/uploads/migrate.md).
@@ -132,17 +132,17 @@ _The uploads are stored by default in
 1. Edit `/home/git/gitlab/config/gitlab.yml` and add or amend the following
    lines:
 
-    ```yaml
-    uploads:
-      object_store:
-        enabled: true
-        remote_directory: "uploads" # The bucket name
-        connection:
-          provider: AWS # Only AWS supported at the moment
-          aws_access_key_id: AWS_ACESS_KEY_ID
-          aws_secret_access_key: AWS_SECRET_ACCESS_KEY
-          region: eu-central-1
-    ```
+   ```yaml
+   uploads:
+     object_store:
+       enabled: true
+       remote_directory: "uploads" # The bucket name
+       connection:
+         provider: AWS # Only AWS supported at the moment
+         aws_access_key_id: AWS_ACESS_KEY_ID
+         aws_secret_access_key: AWS_SECRET_ACCESS_KEY
+         region: eu-central-1
+   ```
 
 1. Save the file and [restart GitLab][] for the changes to take effect.
 1. Migrate any existing local uploads to the object storage using [`gitlab:uploads:migrate` rake task](raketasks/uploads/migrate.md).
diff --git a/doc/api/README.md b/doc/api/README.md
index 6284bc82e27..3ded230370c 100644
--- a/doc/api/README.md
+++ b/doc/api/README.md
@@ -311,9 +311,9 @@ By default, impersonation is enabled. To disable impersonation:
 
 1. Edit `/etc/gitlab/gitlab.rb`:
 
-    ```ruby
-    gitlab_rails['impersonation_enabled'] = false
-    ```
+   ```ruby
+   gitlab_rails['impersonation_enabled'] = false
+   ```
 
 1. Save the file and [reconfigure](../administration/restart_gitlab.md#omnibus-gitlab-reconfigure)
    GitLab for the changes to take effect.
@@ -326,10 +326,10 @@ To re-enable impersonation, remove this configuration and reconfigure GitLab.
 
 1. Edit `config/gitlab.yml`:
 
-    ```yaml
-    gitlab:
-      impersonation_enabled: false
-    ```
+   ```yaml
+   gitlab:
+     impersonation_enabled: false
+   ```
 
 1. Save the file and [restart](../administration/restart_gitlab.md#installations-from-source)
    GitLab for the changes to take effect.
diff --git a/doc/api/lint.md b/doc/api/lint.md
index 71c09d35b8c..b9b49f3df27 100644
--- a/doc/api/lint.md
+++ b/doc/api/lint.md
@@ -22,30 +22,30 @@ Example responses:
 
 - Valid content:
 
-    ```json
-    {
-      "status": "valid",
-      "errors": []
-    }
-    ```
+  ```json
+  {
+    "status": "valid",
+    "errors": []
+  }
+  ```
 
 - Invalid content:
 
-    ```json
-    {
-      "status": "invalid",
-      "errors": [
-        "variables config should be a hash of key value pairs"
-      ]
-    }
-    ```
+  ```json
+  {
+    "status": "invalid",
+    "errors": [
+      "variables config should be a hash of key value pairs"
+    ]
+  }
+  ```
 
 - Without the content attribute:
 
-    ```json
-    {
-      "error": "content is missing"
-    }
-    ```
+  ```json
+  {
+    "error": "content is missing"
+  }
+  ```
 
 [ce-5953]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/5953
diff --git a/doc/api/repositories.md b/doc/api/repositories.md
index 681dc72c934..ffae5c17310 100644
--- a/doc/api/repositories.md
+++ b/doc/api/repositories.md
@@ -121,9 +121,9 @@ Parameters:
 - `id` (required) - The ID or [URL-encoded path of the project](README.md#namespaced-path-encoding) owned by the authenticated user
 - `sha` (optional) - The commit SHA to download. A tag, branch reference, or SHA can be used. This defaults to the tip of the default branch if not specified. For example:
 
-    ```sh
-    curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.com/api/v4/projects/<project_id>/repository/archive?sha=<commit_sha>
-    ```
+```sh
+curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.com/api/v4/projects/<project_id>/repository/archive?sha=<commit_sha>
+```
 
 ## Compare branches, tags or commits
 
diff --git a/doc/api/runners.md b/doc/api/runners.md
index 1318b9ca828..e6962d17a98 100644
--- a/doc/api/runners.md
+++ b/doc/api/runners.md
@@ -20,10 +20,10 @@ Here's an example of how the two tokens are used in Runner registration:
 1. You use that authentication token and add it to the
    [Runner's configuration file](https://docs.gitlab.com/runner/commands/#configuration-file):
 
-    ```toml
-    [[runners]]
-      token = "<authentication_token>"
-    ```
+   ```toml
+   [[runners]]
+     token = "<authentication_token>"
+   ```
 
 GitLab and Runner are then connected.
 
diff --git a/doc/ci/git_submodules.md b/doc/ci/git_submodules.md
index 551044dd76f..1354a26d6e2 100644
--- a/doc/ci/git_submodules.md
+++ b/doc/ci/git_submodules.md
@@ -79,14 +79,14 @@ correctly with your CI jobs:
 1. If you are using an older version of `gitlab-runner`, then use
    `git submodule sync/update` in `before_script`:
 
-    ```yaml
-    before_script:
-      - git submodule sync --recursive
-      - git submodule update --init --recursive
-    ```
+   ```yaml
+   before_script:
+     - git submodule sync --recursive
+     - git submodule update --init --recursive
+   ```
 
-    `--recursive` should be used in either both or none (`sync/update`) depending on
-    whether you have recursive submodules.
+   `--recursive` should be used in either both or none (`sync/update`) depending on
+   whether you have recursive submodules.
 
 The rationale to set the `sync` and `update` in `before_script` is because of
 the way Git submodules work. On a fresh Runner workspace, Git will set the
diff --git a/doc/development/architecture.md b/doc/development/architecture.md
index 8319603fea2..b645a72567c 100644
--- a/doc/development/architecture.md
+++ b/doc/development/architecture.md
@@ -484,9 +484,11 @@ When making a request to an HTTP Endpoint (think `/users/sign_in`) the request w
 Below we describe the different pathing that HTTP vs. SSH Git requests will take. There is some overlap with the Web Request Cycle but also some differences.
 
 ### Web Request (80/443)
+
 TODO
 
 ### SSH Request (22)
+
 TODO
 
 ## System Layout
@@ -505,7 +507,9 @@ To summarize here's the [directory structure of the `git` user home directory](.
 
 ### Processes
 
-    ps aux | grep '^git'
+```sh
+ps aux | grep '^git'
+```
 
 GitLab has several components to operate. As a system user (i.e. any user that is not the `git` user) it requires a persistent database (MySQL/PostreSQL) and redis database. It also uses Apache httpd or Nginx to proxypass Unicorn. As the `git` user it starts Sidekiq and Unicorn (a simple ruby HTTP server running on port `8080` by default). Under the GitLab user there are normally 4 processes: `unicorn_rails master` (1 process), `unicorn_rails worker` (2 processes), `sidekiq` (1 process).
 
diff --git a/doc/development/ee_features.md b/doc/development/ee_features.md
index dc17b59a9a0..7131b717353 100644
--- a/doc/development/ee_features.md
+++ b/doc/development/ee_features.md
@@ -182,52 +182,52 @@ There are a few gotchas with it:
   pattern](https://en.wikipedia.org/wiki/Template_method_pattern).
   For example, given this base:
 
-    ```ruby
-      class Base
-        def execute
-          return unless enabled?
+  ```ruby
+    class Base
+      def execute
+        return unless enabled?
 
-          # ...
-          # ...
-        end
+        # ...
+        # ...
       end
-    ```
+    end
+  ```
 
-    Instead of just overriding `Base#execute`, we should update it and extract
-    the behaviour into another method:
+  Instead of just overriding `Base#execute`, we should update it and extract
+  the behaviour into another method:
 
-    ```ruby
-      class Base
-        def execute
-          return unless enabled?
+  ```ruby
+    class Base
+      def execute
+        return unless enabled?
 
-          do_something
-        end
-
-        private
-
-        def do_something
-          # ...
-          # ...
-        end
+        do_something
       end
-    ```
 
-    Then we're free to override that `do_something` without worrying about the
-    guards:
+      private
 
-    ```ruby
-      module EE::Base
-        extend ::Gitlab::Utils::Override
-
-        override :do_something
-        def do_something
-          # Follow the above pattern to call super and extend it
-        end
+      def do_something
+        # ...
+        # ...
       end
-    ```
+    end
+  ```
 
-    This would require updating CE first, or make sure this is back ported to CE.
+  Then we're free to override that `do_something` without worrying about the
+  guards:
+
+  ```ruby
+    module EE::Base
+      extend ::Gitlab::Utils::Override
+
+      override :do_something
+      def do_something
+        # Follow the above pattern to call super and extend it
+      end
+    end
+  ```
+
+  This would require updating CE first, or make sure this is back ported to CE.
 
 When prepending, place them in the `ee/` specific sub-directory, and
 wrap class or module in `module EE` to avoid naming conflicts.
@@ -1038,8 +1038,8 @@ to avoid conflicts during CE to EE merge.
 Until the work completed to merge the ce and ee codebases, which is tracked on [epic &802](https://gitlab.com/groups/gitlab-org/-/epics/802), there exists times in which some changes for EE require specific changes to the CE
 code base.  Examples of backports include the following:
 
-* Features intended or originally built for EE that are later decided to move to CE
-* Sometimes some code in CE may impact the EE feature
+- Features intended or originally built for EE that are later decided to move to CE
+- Sometimes some code in CE may impact the EE feature
 
 Here is a workflow to make sure those changes end up backported safely into CE too.
 
diff --git a/doc/development/emails.md b/doc/development/emails.md
index 1fd4139c91e..e6af075a282 100644
--- a/doc/development/emails.md
+++ b/doc/development/emails.md
@@ -26,51 +26,51 @@ See the [Rails guides] for more info.
    feature and fill in the details for your specific IMAP server and email
    account:
 
-    Configuration for Gmail / Google Apps, assumes mailbox gitlab-incoming@gmail.com
+   Configuration for Gmail / Google Apps, assumes mailbox `gitlab-incoming@gmail.com`:
 
-    ```yaml
-    incoming_email:
-      enabled: true
+   ```yaml
+   incoming_email:
+     enabled: true
 
-      # The email address including the `%{key}` placeholder that will be replaced to reference the item being replied to.
-      # The placeholder can be omitted but if present, it must appear in the "user" part of the address (before the `@`).
-      address: "gitlab-incoming+%{key}@gmail.com"
+     # The email address including the `%{key}` placeholder that will be replaced to reference the item being replied to.
+     # The placeholder can be omitted but if present, it must appear in the "user" part of the address (before the `@`).
+     address: "gitlab-incoming+%{key}@gmail.com"
 
-      # Email account username
-      # With third party providers, this is usually the full email address.
-      # With self-hosted email servers, this is usually the user part of the email address.
-      user: "gitlab-incoming@gmail.com"
-      # Email account password
-      password: "[REDACTED]"
+     # Email account username
+     # With third party providers, this is usually the full email address.
+     # With self-hosted email servers, this is usually the user part of the email address.
+     user: "gitlab-incoming@gmail.com"
+     # Email account password
+     password: "[REDACTED]"
 
-      # IMAP server host
-      host: "imap.gmail.com"
-      # IMAP server port
-      port: 993
-      # Whether the IMAP server uses SSL
-      ssl: true
-      # Whether the IMAP server uses StartTLS
-      start_tls: false
+     # IMAP server host
+     host: "imap.gmail.com"
+     # IMAP server port
+     port: 993
+     # Whether the IMAP server uses SSL
+     ssl: true
+     # Whether the IMAP server uses StartTLS
+     start_tls: false
 
-      # The mailbox where incoming mail will end up. Usually "inbox".
-      mailbox: "inbox"
-      # The IDLE command timeout.
-      idle_timeout: 60
-    ```
+     # The mailbox where incoming mail will end up. Usually "inbox".
+     mailbox: "inbox"
+     # The IDLE command timeout.
+     idle_timeout: 60
+   ```
 
-    As mentioned, the part after `+` is ignored, and this will end up in the mailbox for `gitlab-incoming@gmail.com`.
+   As mentioned, the part after `+` is ignored, and this will end up in the mailbox for `gitlab-incoming@gmail.com`.
 
 1. Run this command in the GitLab root directory to launch `mail_room`:
 
-    ```sh
-    bundle exec mail_room -q -c config/mail_room.yml
-    ```
+   ```sh
+   bundle exec mail_room -q -c config/mail_room.yml
+   ```
 
 1. Verify that everything is configured correctly:
 
-    ```sh
-    bundle exec rake gitlab:incoming_email:check RAILS_ENV=development
-    ```
+   ```sh
+   bundle exec rake gitlab:incoming_email:check RAILS_ENV=development
+   ```
 
 1. Reply by email should now be working.
 
@@ -91,10 +91,10 @@ for the format of the email key:
 
 Examples of valid email keys:
 
- - `gitlab-org-gitlab-ce-20-Author_Token12345678-issue` (create a new issue)
- - `gitlab-org-gitlab-ce-20-Author_Token12345678-merge-request` (create a new merge request)
- - `1234567890abcdef1234567890abcdef-unsubscribe` (unsubscribe from a conversation)
- - `1234567890abcdef1234567890abcdef` (reply to a conversation)
+- `gitlab-org-gitlab-ce-20-Author_Token12345678-issue` (create a new issue)
+- `gitlab-org-gitlab-ce-20-Author_Token12345678-merge-request` (create a new merge request)
+- `1234567890abcdef1234567890abcdef-unsubscribe` (unsubscribe from a conversation)
+- `1234567890abcdef1234567890abcdef` (reply to a conversation)
 
 Please note that the action `-issue-` is used in GitLab Premium as the handler for the Service Desk feature.
 
@@ -103,10 +103,10 @@ Please note that the action `-issue-` is used in GitLab Premium as the handler f
 Although we continue to support the older legacy format, no new features should use a legacy format.
 These are the only valid legacy formats for an email handler:
 
- - `path/to/project+namespace`
- - `path/to/project+namespace+action`
- - `namespace`
- - `namespace+action`
+- `path/to/project+namespace`
+- `path/to/project+namespace+action`
+- `namespace`
+- `namespace+action`
 
 Please note that `path/to/project` is used in GitLab Premium as handler for the Service Desk feature.
 
diff --git a/doc/development/gotchas.md b/doc/development/gotchas.md
index 1b9ebb50c29..13dda17bb7d 100644
--- a/doc/development/gotchas.md
+++ b/doc/development/gotchas.md
@@ -101,10 +101,10 @@ end
   in a prepended module, which is very likely the case in EE. We could see
   error like this:
 
-    ```
-    1.1) Failure/Error: expect_any_instance_of(ApplicationSetting).to receive_messages(messages)
-         Using `any_instance` to stub a method (elasticsearch_indexing) that has been defined on a prepended module (EE::ApplicationSetting) is not supported.
-    ```
+  ```
+  1.1) Failure/Error: expect_any_instance_of(ApplicationSetting).to receive_messages(messages)
+       Using `any_instance` to stub a method (elasticsearch_indexing) that has been defined on a prepended module (EE::ApplicationSetting) is not supported.
+  ```
 
 ### Alternative: `expect_next_instance_of`
 
diff --git a/doc/development/logging.md b/doc/development/logging.md
index d61441813b2..4f63c84fc0e 100644
--- a/doc/development/logging.md
+++ b/doc/development/logging.md
@@ -30,8 +30,8 @@ Completed 200 OK in 166ms (Views: 117.4ms | ActiveRecord: 27.2ms)
 These logs suffer from a number of problems:
 
 1. They often lack timestamps or other contextual information (e.g. project ID, user)
-2. They may span multiple lines, which make them hard to find via Elasticsearch.
-3. They lack a common structure, which make them hard to parse by log
+1. They may span multiple lines, which make them hard to find via Elasticsearch.
+1. They lack a common structure, which make them hard to parse by log
    forwarders, such as Logstash or Fluentd. This also makes them hard to
    search.
 
@@ -67,46 +67,46 @@ importer progresses. Here's what to do:
    make it easy for people to search pertinent logs in one place. For
    example, `geo.log` contains all logs pertaining to GitLab Geo.
    To create a new file:
-    1. Choose a filename (e.g. `importer_json.log`).
-    1. Create a new subclass of `Gitlab::JsonLogger`:
+   1. Choose a filename (e.g. `importer_json.log`).
+   1. Create a new subclass of `Gitlab::JsonLogger`:
 
-        ```ruby
-        module Gitlab
-          module Import
-            class Logger < ::Gitlab::JsonLogger
-              def self.file_name_noext
-                'importer'
-              end
+      ```ruby
+      module Gitlab
+        module Import
+          class Logger < ::Gitlab::JsonLogger
+            def self.file_name_noext
+              'importer'
             end
-           end
-        end
-        ```
+          end
+         end
+      end
+      ```
 
-    1. In your class where you want to log, you might initialize the logger as an instance variable:
+   1. In your class where you want to log, you might initialize the logger as an instance variable:
 
-        ```ruby
-        attr_accessor :logger
+      ```ruby
+      attr_accessor :logger
 
-        def initialize
-          @logger = Gitlab::Import::Logger.build
-        end
-        ```
+      def initialize
+        @logger = Gitlab::Import::Logger.build
+      end
+      ```
 
-        Note that it's useful to memoize this because creating a new logger
-        each time you log will open a file, adding unnecessary overhead.
+      Note that it's useful to memoize this because creating a new logger
+      each time you log will open a file, adding unnecessary overhead.
 
 1. Now insert log messages into your code. When adding logs,
    make sure to include all the context as key-value pairs:
 
-    ```ruby
-    # BAD
-    logger.info("Unable to create project #{project.id}")
-    ```
+   ```ruby
+   # BAD
+   logger.info("Unable to create project #{project.id}")
+   ```
 
-    ```ruby
-    # GOOD
-    logger.info(message: "Unable to create project", project_id: project.id)
-    ```
+   ```ruby
+   # GOOD
+   logger.info(message: "Unable to create project", project_id: project.id)
+   ```
 
 1. Be sure to create a common base structure of your log messages. For example,
    all messages might have `current_user_id` and `project_id` to make it easier
@@ -116,16 +116,16 @@ importer progresses. Here's what to do:
    logs properly if you [mix integer and string
    types](https://www.elastic.co/guide/en/elasticsearch/guide/current/mapping.html#_avoiding_type_gotchas):
 
-    ```ruby
-    # BAD
-    logger.info(message: "Import error", error: 1)
-    logger.info(message: "Import error", error: "I/O failure")
-    ```
+   ```ruby
+   # BAD
+   logger.info(message: "Import error", error: 1)
+   logger.info(message: "Import error", error: "I/O failure")
+   ```
 
-    ```ruby
-    # GOOD
-    logger.info(message: "Import error", error_code: 1, error: "I/O failure")
-    ```
+   ```ruby
+   # GOOD
+   logger.info(message: "Import error", error_code: 1, error: "I/O failure")
+   ```
 
 ## Additional steps with new log files
 
diff --git a/doc/development/profiling.md b/doc/development/profiling.md
index 795523b82aa..e1d1d2e33fa 100644
--- a/doc/development/profiling.md
+++ b/doc/development/profiling.md
@@ -95,7 +95,9 @@ Sherlock is a custom profiling tool built into GitLab. Sherlock is _only_
 available when running GitLab in development mode _and_ when setting the
 environment variable `ENABLE_SHERLOCK` to a non empty value. For example:
 
-    ENABLE_SHERLOCK=1 bundle exec rails s
+```sh
+ENABLE_SHERLOCK=1 bundle exec rails s
+```
 
 Recorded transactions can be found by navigating to `/sherlock/transactions`.
 
@@ -106,7 +108,9 @@ Bullet adds quite a bit of logging noise it's disabled by default. To enable
 Bullet, set the environment variable `ENABLE_BULLET` to a non-empty value before
 starting GitLab. For example:
 
-    ENABLE_BULLET=true bundle exec rails s
+```sh
+ENABLE_BULLET=true bundle exec rails s
+```
 
 Bullet will log query problems to both the Rails log as well as the Chrome
 console.
diff --git a/doc/development/routing.md b/doc/development/routing.md
index e9c0ad8d4e8..a25eb48b73c 100644
--- a/doc/development/routing.md
+++ b/doc/development/routing.md
@@ -7,11 +7,15 @@ support subgroups, GitLab project and group routes use the wildcard
 character to match project and group routes. For example, we might have
 a path such as:
 
-    /gitlab-com/customer-success/north-america/west/customerA
+```
+/gitlab-com/customer-success/north-america/west/customerA
+```
 
 However, paths can be ambiguous. Consider the following example:
 
-    /gitlab-com/edit
+```
+/gitlab-com/edit
+```
 
 It's ambiguous whether there is a subgroup named `edit` or whether
 this is a special endpoint to edit the `gitlab-com` group.
@@ -25,8 +29,10 @@ number of [reserved names](../user/reserved_names.md).
 
 We have a number of global routes. For example:
 
-    /-/health
-    /-/metrics
+```
+/-/health
+/-/metrics
+```
 
 ## Group routes
 
@@ -34,10 +40,12 @@ Every group route must be under the `/-/` scope.
 
 Examples:
 
-    gitlab-org/-/edit
-    gitlab-org/-/activity
-    gitlab-org/-/security/dashboard
-    gitlab-org/serverless/-/activity
+```
+gitlab-org/-/edit
+gitlab-org/-/activity
+gitlab-org/-/security/dashboard
+gitlab-org/serverless/-/activity
+```
 
 To achieve that, use the `scope '-'` method.
 
@@ -48,10 +56,12 @@ client or other software requires something different.
 
 Examples:
 
-    gitlab-org/gitlab-ce/-/activity
-    gitlab-org/gitlab-ce/-/jobs/123
-    gitlab-org/gitlab-ce/-/settings/repository
-    gitlab-org/serverless/runtimes/-/settings/repository
+```
+gitlab-org/gitlab-ce/-/activity
+gitlab-org/gitlab-ce/-/jobs/123
+gitlab-org/gitlab-ce/-/settings/repository
+gitlab-org/serverless/runtimes/-/settings/repository
+```
 
 Currently, only some project routes are placed under the `/-/` scope. However,
 you can help us migrate more of them! To migrate project routes:
diff --git a/doc/development/sql.md b/doc/development/sql.md
index edeca7fb298..a256fd46c09 100644
--- a/doc/development/sql.md
+++ b/doc/development/sql.md
@@ -94,7 +94,9 @@ on the amount of data indexed).
 To keep naming of these indexes consistent please use the following naming
 pattern:
 
-    index_TABLE_on_COLUMN_trigram
+```
+index_TABLE_on_COLUMN_trigram
+```
 
 For example, a GIN/trigram index for `issues.title` would be called
 `index_issues_on_title_trigram`.

From e83519bb7cceb1979946e11f38ebcfe4fe8c6794 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Tue, 9 Jul 2019 07:16:55 +0000
Subject: [PATCH 177/195] Docs: Add missing backtick fence to code block

---
 doc/api/users.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/api/users.md b/doc/api/users.md
index 4e427766750..884a02dd2bf 100644
--- a/doc/api/users.md
+++ b/doc/api/users.md
@@ -164,6 +164,7 @@ the `group_saml` provider option:
     ...
   }
 ]
+```
 
 You can lookup users by external UID and provider:
 

From eb4ea5d60cb9b6a962b03e0ea57493ec3b9fcce8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Eduardo=20Mej=C3=ADa?= <eduar.mreyes@gmail.com>
Date: Tue, 9 Jul 2019 07:45:50 +0000
Subject: [PATCH 178/195] add font weight to links in wiki pages to be more
 distinguishable from static information

---
 app/assets/stylesheets/pages/wiki.scss | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/app/assets/stylesheets/pages/wiki.scss b/app/assets/stylesheets/pages/wiki.scss
index 10120a472d3..60400f10ca5 100644
--- a/app/assets/stylesheets/pages/wiki.scss
+++ b/app/assets/stylesheets/pages/wiki.scss
@@ -168,6 +168,10 @@
 }
 
 ul.wiki-pages-list.content-list {
+  a {
+    color: $blue-600;
+  }
+
   ul {
     list-style: none;
     margin-left: 0;

From 1be94ee5b3082e01b8792d0f628615a700206977 Mon Sep 17 00:00:00 2001
From: Evan Read <eread@gitlab.com>
Date: Tue, 9 Jul 2019 08:26:22 +0000
Subject: [PATCH 179/195] Tidy up timezone topic

---
 doc/workflow/timezone.md | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/doc/workflow/timezone.md b/doc/workflow/timezone.md
index da51c0f2c93..60a4d0f19de 100644
--- a/doc/workflow/timezone.md
+++ b/doc/workflow/timezone.md
@@ -2,13 +2,12 @@
 
 The global time zone configuration parameter can be changed in `config/gitlab.yml`:
 
-```
+```text
 # time_zone: 'UTC'
 ```
 
 Uncomment and customize if you want to change the default time zone of the GitLab application.
 
-
 ## Viewing available timezones
 
 To see all available time zones, run `bundle exec rake time:zones:all`.
@@ -26,14 +25,13 @@ To obtain a list of timezones, log in to your GitLab application server and run
 
 To update, add the timezone that best applies to your location. For example:
 
-```
+```ruby
 gitlab_rails['time_zone'] = 'America/New_York'
 ```
 
 After adding the configuration parameter, reconfigure and restart your GitLab instance:
 
-```
+```sh
 gitlab-ctl reconfigure
 gitlab-ctl restart
 ```
-

From 63c84a9a56159876b2743b83de609aa8ad4433fb Mon Sep 17 00:00:00 2001
From: Phil Hughes <me@iamphill.com>
Date: Tue, 9 Jul 2019 09:35:53 +0100
Subject: [PATCH 180/195] Fix dropdown styling issues

---
 .../components/project_form_group.vue         |  4 ---
 .../stylesheets/framework/dropdowns.scss      |  4 +--
 .../project_form_group_spec.js.snap           | 34 -------------------
 3 files changed, 2 insertions(+), 40 deletions(-)

diff --git a/app/assets/javascripts/confidential_merge_request/components/project_form_group.vue b/app/assets/javascripts/confidential_merge_request/components/project_form_group.vue
index 29d2cca6aed..99d77a75c23 100644
--- a/app/assets/javascripts/confidential_merge_request/components/project_form_group.vue
+++ b/app/assets/javascripts/confidential_merge_request/components/project_form_group.vue
@@ -126,10 +126,6 @@ export default {
           {{ __('No forks available to you.') }}<br />
           <span v-html="noForkText"></span>
         </template>
-        <gl-link :href="helpPagePath" class="help-link" target="_blank">
-          <span class="sr-only">{{ __('Read more') }}</span>
-          <i class="fa fa-question-circle" aria-hidden="true"></i>
-        </gl-link>
       </p>
     </div>
   </div>
diff --git a/app/assets/stylesheets/framework/dropdowns.scss b/app/assets/stylesheets/framework/dropdowns.scss
index a12029d2419..e75c1379dfb 100644
--- a/app/assets/stylesheets/framework/dropdowns.scss
+++ b/app/assets/stylesheets/framework/dropdowns.scss
@@ -287,8 +287,8 @@
     list-style: none;
     padding: 0 1px;
 
-    a:not(.help-link),
-    button:not(.btn),
+    a,
+    button:not(.dropdown-toggle,.ci-action-icon-container),
     .menu-item {
       @include dropdown-link;
     }
diff --git a/spec/frontend/confidential_merge_request/components/__snapshots__/project_form_group_spec.js.snap b/spec/frontend/confidential_merge_request/components/__snapshots__/project_form_group_spec.js.snap
index ba0ee8dfd59..fd307ce5ab3 100644
--- a/spec/frontend/confidential_merge_request/components/__snapshots__/project_form_group_spec.js.snap
+++ b/spec/frontend/confidential_merge_request/components/__snapshots__/project_form_group_spec.js.snap
@@ -28,23 +28,6 @@ exports[`Confidential merge request project form group component renders empty s
         </a>
          and set the forks visiblity to private.
       </span>
-       
-      <gllink-stub
-        class="help-link"
-        href="/help"
-        target="_blank"
-      >
-        <span
-          class="sr-only"
-        >
-          Read more
-        </span>
-         
-        <i
-          aria-hidden="true"
-          class="fa fa-question-circle"
-        />
-      </gllink-stub>
     </p>
   </div>
 </div>
@@ -78,23 +61,6 @@ exports[`Confidential merge request project form group component renders fork dr
         </a>
          and set the forks visiblity to private.
       </span>
-       
-      <gllink-stub
-        class="help-link"
-        href="/help"
-        target="_blank"
-      >
-        <span
-          class="sr-only"
-        >
-          Read more
-        </span>
-         
-        <i
-          aria-hidden="true"
-          class="fa fa-question-circle"
-        />
-      </gllink-stub>
     </p>
   </div>
 </div>

From b9e52612feb4956f0b3cc26af0f98810e67a5287 Mon Sep 17 00:00:00 2001
From: Tim Zallmann <tzallmann@gitlab.com>
Date: Tue, 9 Jul 2019 08:44:19 +0000
Subject: [PATCH 181/195] Updates on success of an MR the count on top and in
 other tabs

New API endpoint for merge request count
Updates all open tabs at the same time with one call
Restructured API response

API response changed to 401 if no current_user

Added API + JS specs

Fix for Static Check

Updated Count on Open/Close, Assign/Unassign of MR's

Checking if MR Count is refreshed

Added # frozen_string_literal: true to spec

Added Changelog
---
 app/assets/javascripts/api.js                 |   6 +
 app/assets/javascripts/commons/index.js       |   3 +
 .../commons/nav/user_merge_requests.js        |  67 +++++++++++
 .../notes/components/comment_form.vue         |  11 +-
 .../assignees/sidebar_assignees.vue           |   4 +
 .../components/states/ready_to_merge.vue      |   3 +
 .../tz-update-mr-count-over-tabs.yml          |   6 +
 doc/api/users.md                              |  24 ++++
 lib/api/api.rb                                |   1 +
 lib/api/user_counts.rb                        |  18 +++
 spec/frontend/api_spec.js                     |  16 +++
 .../commons/nav/user_merge_requests_spec.js   | 113 ++++++++++++++++++
 .../notes/components/comment_form_spec.js     |  15 +++
 .../states/mr_widget_ready_to_merge_spec.js   |   3 +
 spec/requests/api/user_counts_spec.rb         |  40 +++++++
 15 files changed, 328 insertions(+), 2 deletions(-)
 create mode 100644 app/assets/javascripts/commons/nav/user_merge_requests.js
 create mode 100644 changelogs/unreleased/tz-update-mr-count-over-tabs.yml
 create mode 100644 lib/api/user_counts.rb
 create mode 100644 spec/frontend/commons/nav/user_merge_requests_spec.js
 create mode 100644 spec/requests/api/user_counts_spec.rb

diff --git a/app/assets/javascripts/api.js b/app/assets/javascripts/api.js
index 4f66a5d080c..a649c521405 100644
--- a/app/assets/javascripts/api.js
+++ b/app/assets/javascripts/api.js
@@ -24,6 +24,7 @@ const Api = {
   issuableTemplatePath: '/:namespace_path/:project_path/templates/:type/:key',
   projectTemplatePath: '/api/:version/projects/:id/templates/:type/:key',
   projectTemplatesPath: '/api/:version/projects/:id/templates/:type',
+  userCountsPath: '/api/:version/user_counts',
   usersPath: '/api/:version/users.json',
   userPath: '/api/:version/users/:id',
   userStatusPath: '/api/:version/users/:id/status',
@@ -312,6 +313,11 @@ const Api = {
     });
   },
 
+  userCounts() {
+    const url = Api.buildUrl(this.userCountsPath);
+    return axios.get(url);
+  },
+
   userStatus(id, options) {
     const url = Api.buildUrl(this.userStatusPath).replace(':id', encodeURIComponent(id));
     return axios.get(url, {
diff --git a/app/assets/javascripts/commons/index.js b/app/assets/javascripts/commons/index.js
index 0d2fe2925d8..ad0f6cc1496 100644
--- a/app/assets/javascripts/commons/index.js
+++ b/app/assets/javascripts/commons/index.js
@@ -4,3 +4,6 @@ import './jquery';
 import './bootstrap';
 import './vue';
 import '../lib/utils/axios_utils';
+import { openUserCountsBroadcast } from './nav/user_merge_requests';
+
+openUserCountsBroadcast();
diff --git a/app/assets/javascripts/commons/nav/user_merge_requests.js b/app/assets/javascripts/commons/nav/user_merge_requests.js
new file mode 100644
index 00000000000..8e694cca6a1
--- /dev/null
+++ b/app/assets/javascripts/commons/nav/user_merge_requests.js
@@ -0,0 +1,67 @@
+import Api from '~/api';
+
+let channel;
+
+function broadcastCount(newCount) {
+  if (!channel) {
+    return;
+  }
+
+  channel.postMessage(newCount);
+}
+
+function updateUserMergeRequestCounts(newCount) {
+  const mergeRequestsCountEl = document.querySelector('.merge-requests-count');
+  mergeRequestsCountEl.textContent = newCount.toLocaleString();
+  mergeRequestsCountEl.classList.toggle('hidden', Number(newCount) === 0);
+}
+
+/**
+ * Refresh user counts (and broadcast if open)
+ */
+export function refreshUserMergeRequestCounts() {
+  return Api.userCounts()
+    .then(({ data }) => {
+      const count = data.merge_requests;
+
+      updateUserMergeRequestCounts(count);
+      broadcastCount(count);
+    })
+    .catch(ex => {
+      console.error(ex); // eslint-disable-line no-console
+    });
+}
+
+/**
+ * Close the broadcast channel for user counts
+ */
+export function closeUserCountsBroadcast() {
+  if (!channel) {
+    return;
+  }
+
+  channel.close();
+  channel = null;
+}
+
+/**
+ * Open the broadcast channel for user counts, adds user id so we only update
+ *
+ * **Please note:**
+ * Not supported in all browsers, but not polyfilling for now
+ * to keep bundle size small and
+ * no special functionality lost except cross tab notifications
+ */
+export function openUserCountsBroadcast() {
+  closeUserCountsBroadcast();
+
+  if (window.BroadcastChannel) {
+    const currentUserId = typeof gon !== 'undefined' && gon && gon.current_user_id;
+    if (currentUserId) {
+      channel = new BroadcastChannel(`mr_count_channel_${currentUserId}`);
+      channel.onmessage = ev => {
+        updateUserMergeRequestCounts(ev.data);
+      };
+    }
+  }
+}
diff --git a/app/assets/javascripts/notes/components/comment_form.vue b/app/assets/javascripts/notes/components/comment_form.vue
index 6c1738f0f1b..fda494fec07 100644
--- a/app/assets/javascripts/notes/components/comment_form.vue
+++ b/app/assets/javascripts/notes/components/comment_form.vue
@@ -13,6 +13,7 @@ import {
   splitCamelCase,
   slugifyWithUnderscore,
 } from '../../lib/utils/text_utility';
+import { refreshUserMergeRequestCounts } from '~/commons/nav/user_merge_requests';
 import * as constants from '../constants';
 import eventHub from '../event_hub';
 import issueWarning from '../../vue_shared/components/issue/issue_warning.vue';
@@ -234,7 +235,10 @@ export default {
     toggleIssueState() {
       if (this.isOpen) {
         this.closeIssue()
-          .then(() => this.enableButton())
+          .then(() => {
+            this.enableButton();
+            refreshUserMergeRequestCounts();
+          })
           .catch(() => {
             this.enableButton();
             this.toggleStateButtonLoading(false);
@@ -247,7 +251,10 @@ export default {
           });
       } else {
         this.reopenIssue()
-          .then(() => this.enableButton())
+          .then(() => {
+            this.enableButton();
+            refreshUserMergeRequestCounts();
+          })
           .catch(({ data }) => {
             this.enableButton();
             this.toggleStateButtonLoading(false);
diff --git a/app/assets/javascripts/sidebar/components/assignees/sidebar_assignees.vue b/app/assets/javascripts/sidebar/components/assignees/sidebar_assignees.vue
index 70dc3d2cdfa..be1e4811856 100644
--- a/app/assets/javascripts/sidebar/components/assignees/sidebar_assignees.vue
+++ b/app/assets/javascripts/sidebar/components/assignees/sidebar_assignees.vue
@@ -2,6 +2,7 @@
 import Flash from '~/flash';
 import eventHub from '~/sidebar/event_hub';
 import Store from '~/sidebar/stores/sidebar_store';
+import { refreshUserMergeRequestCounts } from '~/commons/nav/user_merge_requests';
 import AssigneeTitle from './assignee_title.vue';
 import Assignees from './assignees.vue';
 import { __ } from '~/locale';
@@ -73,6 +74,9 @@ export default {
       this.mediator
         .saveAssignees(this.field)
         .then(setLoadingFalse.bind(this))
+        .then(() => {
+          refreshUserMergeRequestCounts();
+        })
         .catch(() => {
           setLoadingFalse();
           return new Flash(__('Error occurred when saving assignees'));
diff --git a/app/assets/javascripts/vue_merge_request_widget/components/states/ready_to_merge.vue b/app/assets/javascripts/vue_merge_request_widget/components/states/ready_to_merge.vue
index d1f75593d14..d4514767912 100644
--- a/app/assets/javascripts/vue_merge_request_widget/components/states/ready_to_merge.vue
+++ b/app/assets/javascripts/vue_merge_request_widget/components/states/ready_to_merge.vue
@@ -6,6 +6,7 @@ import simplePoll from '~/lib/utils/simple_poll';
 import { __ } from '~/locale';
 import readyToMergeMixin from 'ee_else_ce/vue_merge_request_widget/mixins/ready_to_merge';
 import MergeRequest from '../../../merge_request';
+import { refreshUserMergeRequestCounts } from '~/commons/nav/user_merge_requests';
 import Flash from '../../../flash';
 import statusIcon from '../mr_widget_status_icon.vue';
 import eventHub from '../../event_hub';
@@ -174,6 +175,8 @@ export default {
             MergeRequest.decreaseCounter();
             stopPolling();
 
+            refreshUserMergeRequestCounts();
+
             // If user checked remove source branch and we didn't remove the branch yet
             // we should start another polling for source branch remove process
             if (this.removeSourceBranch && data.source_branch_exists) {
diff --git a/changelogs/unreleased/tz-update-mr-count-over-tabs.yml b/changelogs/unreleased/tz-update-mr-count-over-tabs.yml
new file mode 100644
index 00000000000..61a49dd8ecc
--- /dev/null
+++ b/changelogs/unreleased/tz-update-mr-count-over-tabs.yml
@@ -0,0 +1,6 @@
+---
+title: New API for User Counts, updates on success of an MR the count on top and in
+  other tabs
+merge_request: 29441
+author:
+type: added
diff --git a/doc/api/users.md b/doc/api/users.md
index 884a02dd2bf..213d1865aca 100644
--- a/doc/api/users.md
+++ b/doc/api/users.md
@@ -593,6 +593,30 @@ Example responses
 }
 ```
 
+## User counts
+
+Get the counts (same as in top right menu) of the currently signed in user. 
+
+| Attribute | Type | Description |
+| --------- | ---- | ----------- |
+| `merge_requests`   | number | Merge requests that are active and assigned to current user. |
+
+```
+GET /user_counts
+```
+
+```bash
+curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/user_counts"
+```
+
+Example response:
+
+```json
+{
+  "merge_requests": 4
+}
+```
+
 ## List user projects
 
 Please refer to the [List of user projects](projects.md#list-user-projects).
diff --git a/lib/api/api.rb b/lib/api/api.rb
index 42499c5b41e..7016a66593d 100644
--- a/lib/api/api.rb
+++ b/lib/api/api.rb
@@ -166,6 +166,7 @@ module API
     mount ::API::Templates
     mount ::API::Todos
     mount ::API::Triggers
+    mount ::API::UserCounts
     mount ::API::Users
     mount ::API::Variables
     mount ::API::Version
diff --git a/lib/api/user_counts.rb b/lib/api/user_counts.rb
new file mode 100644
index 00000000000..8df4b381bbf
--- /dev/null
+++ b/lib/api/user_counts.rb
@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module API
+  class UserCounts < Grape::API
+    resource :user_counts do
+      desc 'Return the user specific counts' do
+        detail 'Open MR Count'
+      end
+      get do
+        unauthorized! unless current_user
+
+        {
+          merge_requests: current_user.assigned_open_merge_requests_count
+        }
+      end
+    end
+  end
+end
diff --git a/spec/frontend/api_spec.js b/spec/frontend/api_spec.js
index 0188d12a57d..7004373be0e 100644
--- a/spec/frontend/api_spec.js
+++ b/spec/frontend/api_spec.js
@@ -412,6 +412,22 @@ describe('Api', () => {
     });
   });
 
+  describe('user counts', () => {
+    it('fetches single user counts', done => {
+      const expectedUrl = `${dummyUrlRoot}/api/${dummyApiVersion}/user_counts`;
+      mock.onGet(expectedUrl).reply(200, {
+        merge_requests: 4,
+      });
+
+      Api.userCounts()
+        .then(({ data }) => {
+          expect(data.merge_requests).toBe(4);
+        })
+        .then(done)
+        .catch(done.fail);
+    });
+  });
+
   describe('user status', () => {
     it('fetches single user status', done => {
       const userId = '123456';
diff --git a/spec/frontend/commons/nav/user_merge_requests_spec.js b/spec/frontend/commons/nav/user_merge_requests_spec.js
new file mode 100644
index 00000000000..4da6d53557a
--- /dev/null
+++ b/spec/frontend/commons/nav/user_merge_requests_spec.js
@@ -0,0 +1,113 @@
+import {
+  openUserCountsBroadcast,
+  closeUserCountsBroadcast,
+  refreshUserMergeRequestCounts,
+} from '~/commons/nav/user_merge_requests';
+import Api from '~/api';
+
+jest.mock('~/api');
+
+const TEST_COUNT = 1000;
+const MR_COUNT_CLASS = 'merge-requests-count';
+
+describe('User Merge Requests', () => {
+  let channelMock;
+  let newBroadcastChannelMock;
+
+  beforeEach(() => {
+    global.gon.current_user_id = 123;
+
+    channelMock = {
+      postMessage: jest.fn(),
+      close: jest.fn(),
+    };
+    newBroadcastChannelMock = jest.fn().mockImplementation(() => channelMock);
+
+    global.BroadcastChannel = newBroadcastChannelMock;
+    setFixtures(`<div class="${MR_COUNT_CLASS}">0</div>`);
+  });
+
+  const findMRCountText = () => document.body.querySelector(`.${MR_COUNT_CLASS}`).textContent;
+
+  describe('refreshUserMergeRequestCounts', () => {
+    beforeEach(() => {
+      Api.userCounts.mockReturnValue(
+        Promise.resolve({
+          data: { merge_requests: TEST_COUNT },
+        }),
+      );
+    });
+
+    describe('with open broadcast channel', () => {
+      beforeEach(() => {
+        openUserCountsBroadcast();
+
+        return refreshUserMergeRequestCounts();
+      });
+
+      it('updates the top count of merge requests', () => {
+        expect(findMRCountText()).toEqual(TEST_COUNT.toLocaleString());
+      });
+
+      it('calls the API', () => {
+        expect(Api.userCounts).toHaveBeenCalled();
+      });
+
+      it('posts count to BroadcastChannel', () => {
+        expect(channelMock.postMessage).toHaveBeenCalledWith(TEST_COUNT);
+      });
+    });
+
+    describe('without open broadcast channel', () => {
+      beforeEach(() => refreshUserMergeRequestCounts());
+
+      it('does not post anything', () => {
+        expect(channelMock.postMessage).not.toHaveBeenCalled();
+      });
+    });
+  });
+
+  describe('openUserCountsBroadcast', () => {
+    beforeEach(() => {
+      openUserCountsBroadcast();
+    });
+
+    it('creates BroadcastChannel that updates DOM on message received', () => {
+      expect(findMRCountText()).toEqual('0');
+
+      channelMock.onmessage({ data: TEST_COUNT });
+
+      expect(findMRCountText()).toEqual(TEST_COUNT.toLocaleString());
+    });
+
+    it('closes if called while already open', () => {
+      expect(channelMock.close).not.toHaveBeenCalled();
+
+      openUserCountsBroadcast();
+
+      expect(channelMock.close).toHaveBeenCalled();
+    });
+  });
+
+  describe('closeUserCountsBroadcast', () => {
+    describe('when not opened', () => {
+      it('does nothing', () => {
+        expect(channelMock.close).not.toHaveBeenCalled();
+      });
+    });
+
+    describe('when opened', () => {
+      beforeEach(() => {
+        openUserCountsBroadcast();
+      });
+
+      it('closes', () => {
+        expect(channelMock.close).not.toHaveBeenCalled();
+
+        closeUserCountsBroadcast();
+
+        expect(channelMock.close).toHaveBeenCalled();
+      });
+    });
+  });
+});
diff --git a/spec/javascripts/notes/components/comment_form_spec.js b/spec/javascripts/notes/components/comment_form_spec.js
index 362963ddaf4..88c86746992 100644
--- a/spec/javascripts/notes/components/comment_form_spec.js
+++ b/spec/javascripts/notes/components/comment_form_spec.js
@@ -251,6 +251,21 @@ describe('issue_comment_form component', () => {
           });
         });
       });
+
+      describe('when toggling state', () => {
+        it('should update MR count', done => {
+          spyOn(vm, 'closeIssue').and.returnValue(Promise.resolve());
+
+          const updateMrCountSpy = spyOnDependency(CommentForm, 'refreshUserMergeRequestCounts');
+          vm.toggleIssueState();
+
+          Vue.nextTick(() => {
+            expect(updateMrCountSpy).toHaveBeenCalled();
+
+            done();
+          });
+        });
+      });
     });
 
     describe('issue is confidential', () => {
diff --git a/spec/javascripts/vue_mr_widget/components/states/mr_widget_ready_to_merge_spec.js b/spec/javascripts/vue_mr_widget/components/states/mr_widget_ready_to_merge_spec.js
index bb76616be56..ba3ba01944d 100644
--- a/spec/javascripts/vue_mr_widget/components/states/mr_widget_ready_to_merge_spec.js
+++ b/spec/javascripts/vue_mr_widget/components/states/mr_widget_ready_to_merge_spec.js
@@ -58,9 +58,11 @@ const createComponent = (customConfig = {}) => {
 
 describe('ReadyToMerge', () => {
   let vm;
+  let updateMrCountSpy;
 
   beforeEach(() => {
     vm = createComponent();
+    updateMrCountSpy = spyOnDependency(ReadyToMerge, 'refreshUserMergeRequestCounts');
   });
 
   afterEach(() => {
@@ -461,6 +463,7 @@ describe('ReadyToMerge', () => {
           expect(eventHub.$emit).toHaveBeenCalledWith('MRWidgetUpdateRequested');
           expect(eventHub.$emit).toHaveBeenCalledWith('FetchActionsContent');
           expect(vm.initiateRemoveSourceBranchPolling).toHaveBeenCalled();
+          expect(updateMrCountSpy).toHaveBeenCalled();
           expect(cpc).toBeFalsy();
           expect(spc).toBeTruthy();
 
diff --git a/spec/requests/api/user_counts_spec.rb b/spec/requests/api/user_counts_spec.rb
new file mode 100644
index 00000000000..c833bd047e2
--- /dev/null
+++ b/spec/requests/api/user_counts_spec.rb
@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe API::UserCounts do
+  let(:user) { create(:user) }
+  let(:project) { create(:project, :public) }
+
+  let!(:merge_request) { create(:merge_request, :simple, author: user, assignees: [user], source_project: project, title: "Test") }
+
+  describe 'GET /user_counts' do
+    context 'when unauthenticated' do
+      it 'returns authentication error' do
+        get api('/user_counts')
+
+        expect(response.status).to eq(401)
+      end
+    end
+
+    context 'when authenticated' do
+      it 'returns open counts for current user' do
+        get api('/user_counts', user)
+
+        expect(response.status).to eq(200)
+        expect(json_response).to be_a Hash
+        expect(json_response['merge_requests']).to eq(1)
+      end
+
+      it 'updates the mr count when a new mr is assigned' do
+        create(:merge_request, source_project: project, author: user, assignees: [user])
+
+        get api('/user_counts', user)
+
+        expect(response.status).to eq(200)
+        expect(json_response).to be_a Hash
+        expect(json_response['merge_requests']).to eq(2)
+      end
+    end
+  end
+end

From 966596533b6c1e786b18ba05fb28f07b21fa9902 Mon Sep 17 00:00:00 2001
From: Lukas Eipert <leipert@gitlab.com>
Date: Tue, 9 Jul 2019 09:25:11 +0000
Subject: [PATCH 182/195] Update dependency @gitlab/ui to ^5.5.0

---
 package.json | 2 +-
 yarn.lock    | 8 ++++----
 2 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/package.json b/package.json
index 5b255f55e33..5955790488a 100644
--- a/package.json
+++ b/package.json
@@ -38,7 +38,7 @@
     "@babel/preset-env": "^7.4.4",
     "@gitlab/csslab": "^1.9.0",
     "@gitlab/svgs": "^1.67.0",
-    "@gitlab/ui": "^5.3.2",
+    "@gitlab/ui": "^5.5.0",
     "apollo-cache-inmemory": "^1.5.1",
     "apollo-client": "^2.5.1",
     "apollo-link": "^1.2.11",
diff --git a/yarn.lock b/yarn.lock
index 825a1785c3e..bebc81d6847 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -705,10 +705,10 @@
   resolved "https://registry.yarnpkg.com/@gitlab/svgs/-/svgs-1.67.0.tgz#c7b94eca13b99fd3aaa737fb6dcc0abc41d3c579"
   integrity sha512-hJOmWEs6RkjzyKkb1vc9wwKGZIBIP0coHkxu/KgOoxhBVudpGk4CH7xJ6UuB2TKpb0SEh5CC1CzRZfBYaFhsaA==
 
-"@gitlab/ui@^5.3.2":
-  version "5.3.2"
-  resolved "https://registry.yarnpkg.com/@gitlab/ui/-/ui-5.3.2.tgz#8ee906cf0586834de0077e165f25764c0bf8a9e9"
-  integrity sha512-VgxlDXqG2q+u72Km+/Ljdvjh0DzvljvsztiXTxnOO+Eb+/I26JBWfdboqFr3E02JzT8W4s4rRinhRttLWfcM/A==
+"@gitlab/ui@^5.5.0":
+  version "5.5.0"
+  resolved "https://registry.yarnpkg.com/@gitlab/ui/-/ui-5.5.0.tgz#2000b2ed0c3825dd8c4430191023f4d03c923ecb"
+  integrity sha512-6e/AFFLDk/gm4wKnHM9rcpTRqCsWkPKW/Vjsnd6h4wyfif2/TusHeIn/jedQxUaORbO/XZKzg4V5COhXXbCx4w==
   dependencies:
     "@babel/standalone" "^7.0.0"
     "@gitlab/vue-toasted" "^1.2.1"

From d90e226dabceed4bdea9550ef8538d11b591e373 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Francisco=20Javier=20L=C3=B3pez?= <fjlopez@gitlab.com>
Date: Tue, 9 Jul 2019 09:59:55 +0000
Subject: [PATCH 183/195] Fix subgroup url in search drop down

Inside a subgroup scope, when the user clicks on the
search drop down in the header, some options are displayed.

Some of this links direct the user to the issues and merge
requests linked to the subgroup. Nevertheless, the url
was broken because they doesn't include the complete
group namespace
---
 app/views/layouts/_search.html.haml           |   2 +-
 .../unreleased/fj-fix-subgroup-search-url.yml |   5 +
 .../user_uses_header_search_field_spec.rb     | 124 +++++++++---------
 3 files changed, 68 insertions(+), 63 deletions(-)
 create mode 100644 changelogs/unreleased/fj-fix-subgroup-search-url.yml

diff --git a/app/views/layouts/_search.html.haml b/app/views/layouts/_search.html.haml
index 496ec3c78b0..a5f57f5893c 100644
--- a/app/views/layouts/_search.html.haml
+++ b/app/views/layouts/_search.html.haml
@@ -1,5 +1,5 @@
 - if @group && @group.persisted? && @group.path
-  - group_data_attrs = { group_path: j(@group.path), name: @group.name, issues_path: issues_group_path(j(@group.path)), mr_path: merge_requests_group_path(j(@group.path)) }
+  - group_data_attrs = { group_path: j(@group.path), name: j(@group.name), issues_path: issues_group_path(@group), mr_path: merge_requests_group_path(@group) }
 - if @project && @project.persisted?
   - project_data_attrs = { project_path: j(@project.path), name: j(@project.name), issues_path: project_issues_path(@project), mr_path: project_merge_requests_path(@project), issues_disabled: !@project.issues_enabled? }
 .search.search-form{ data: { track_label: "navbar_search", track_event: "activate_form_input" } }
diff --git a/changelogs/unreleased/fj-fix-subgroup-search-url.yml b/changelogs/unreleased/fj-fix-subgroup-search-url.yml
new file mode 100644
index 00000000000..bee6e97fb6f
--- /dev/null
+++ b/changelogs/unreleased/fj-fix-subgroup-search-url.yml
@@ -0,0 +1,5 @@
+---
+title: Fix subgroup url in search drop down
+merge_request: 30457
+author:
+type: fixed
diff --git a/spec/features/search/user_uses_header_search_field_spec.rb b/spec/features/search/user_uses_header_search_field_spec.rb
index 1cc47cd6bd1..7ddd5c12cdf 100644
--- a/spec/features/search/user_uses_header_search_field_spec.rb
+++ b/spec/features/search/user_uses_header_search_field_spec.rb
@@ -1,6 +1,6 @@
 require 'spec_helper'
 
-describe 'User uses header search field' do
+describe 'User uses header search field', :js do
   include FilteredSearchHelpers
 
   let(:project) { create(:project) }
@@ -11,57 +11,12 @@ describe 'User uses header search field' do
     sign_in(user)
   end
 
-  context 'when user is in a global scope', :js do
+  shared_examples 'search field examples' do
     before do
-      visit(root_path)
-      page.find('#search').click
+      visit(url)
     end
 
-    context 'when clicking issues' do
-      it 'shows assigned issues' do
-        find('.search-input-container .dropdown-menu').click_link('Issues assigned to me')
-
-        expect(page).to have_selector('.filtered-search')
-        expect_tokens([assignee_token(user.name)])
-        expect_filtered_search_input_empty
-      end
-
-      it 'shows created issues' do
-        find('.search-input-container .dropdown-menu').click_link("Issues I've created")
-
-        expect(page).to have_selector('.filtered-search')
-        expect_tokens([author_token(user.name)])
-        expect_filtered_search_input_empty
-      end
-    end
-
-    context 'when clicking merge requests' do
-      let!(:merge_request) { create(:merge_request, source_project: project, author: user, assignees: [user]) }
-
-      it 'shows assigned merge requests' do
-        find('.search-input-container .dropdown-menu').click_link('Merge requests assigned to me')
-
-        expect(page).to have_selector('.filtered-search')
-        expect_tokens([assignee_token(user.name)])
-        expect_filtered_search_input_empty
-      end
-
-      it 'shows created merge requests' do
-        find('.search-input-container .dropdown-menu').click_link("Merge requests I've created")
-
-        expect(page).to have_selector('.filtered-search')
-        expect_tokens([author_token(user.name)])
-        expect_filtered_search_input_empty
-      end
-    end
-  end
-
-  context 'when user is in a project scope' do
-    before do
-      visit(project_path(project))
-    end
-
-    it 'starts searching by pressing the enter key', :js do
+    it 'starts searching by pressing the enter key' do
       fill_in('search', with: 'gitlab')
       find('#search').native.send_keys(:enter)
 
@@ -70,30 +25,31 @@ describe 'User uses header search field' do
       end
     end
 
-    context 'when clicking the search field', :js do
+    context 'when clicking the search field' do
       before do
         page.find('#search').click
+        wait_for_all_requests
       end
 
       it 'shows category search dropdown' do
-        expect(page).to have_selector('.dropdown-header', text: /#{project.name}/i)
+        expect(page).to have_selector('.dropdown-header', text: /#{scope_name}/i)
       end
 
       context 'when clicking issues' do
         let!(:issue) { create(:issue, project: project, author: user, assignees: [user]) }
 
         it 'shows assigned issues' do
-          find('.dropdown-menu').click_link('Issues assigned to me')
+          find('.search-input-container .dropdown-menu').click_link('Issues assigned to me')
 
-          expect(page).to have_selector('.filtered-search')
+          expect(page).to have_selector('.issues-list .issue')
           expect_tokens([assignee_token(user.name)])
           expect_filtered_search_input_empty
         end
 
         it 'shows created issues' do
-          find('.dropdown-menu').click_link("Issues I've created")
+          find('.search-input-container .dropdown-menu').click_link("Issues I've created")
 
-          expect(page).to have_selector('.filtered-search')
+          expect(page).to have_selector('.issues-list .issue')
           expect_tokens([author_token(user.name)])
           expect_filtered_search_input_empty
         end
@@ -103,33 +59,77 @@ describe 'User uses header search field' do
         let!(:merge_request) { create(:merge_request, source_project: project, author: user, assignees: [user]) }
 
         it 'shows assigned merge requests' do
-          find('.dropdown-menu').click_link('Merge requests assigned to me')
+          find('.search-input-container .dropdown-menu').click_link('Merge requests assigned to me')
 
-          expect(page).to have_selector('.merge-requests-holder')
+          expect(page).to have_selector('.mr-list .merge-request')
           expect_tokens([assignee_token(user.name)])
           expect_filtered_search_input_empty
         end
 
         it 'shows created merge requests' do
-          find('.dropdown-menu').click_link("Merge requests I've created")
+          find('.search-input-container .dropdown-menu').click_link("Merge requests I've created")
 
-          expect(page).to have_selector('.merge-requests-holder')
+          expect(page).to have_selector('.mr-list .merge-request')
           expect_tokens([author_token(user.name)])
           expect_filtered_search_input_empty
         end
       end
     end
 
-    context 'when entering text into the search field', :js do
+    context 'when entering text into the search field' do
       before do
         page.within('.search-input-wrap') do
-          fill_in('search', with: project.name[0..3])
+          fill_in('search', with: scope_name.first(4))
         end
       end
 
       it 'does not display the category search dropdown' do
-        expect(page).not_to have_selector('.dropdown-header', text: /#{project.name}/i)
+        expect(page).not_to have_selector('.dropdown-header', text: /#{scope_name}/i)
       end
     end
   end
+
+  context 'when user is in a global scope' do
+    include_examples 'search field examples' do
+      let(:url) { root_path }
+      let(:scope_name) { 'All GitLab' }
+    end
+  end
+
+  context 'when user is in a project scope' do
+    include_examples 'search field examples' do
+      let(:url) { project_path(project) }
+      let(:scope_name) { project.name }
+    end
+  end
+
+  context 'when user is in a group scope' do
+    let(:group) { create(:group) }
+    let(:project) { create(:project, namespace: group) }
+
+    before do
+      group.add_maintainer(user)
+    end
+
+    include_examples 'search field examples' do
+      let(:url) { group_path(group) }
+      let(:scope_name) { group.name }
+    end
+  end
+
+  context 'when user is in a subgroup scope' do
+    let(:group) { create(:group) }
+    let(:subgroup) { create(:group, :public, parent: group) }
+    let(:project) { create(:project, namespace: subgroup) }
+
+    before do
+      group.add_owner(user)
+      subgroup.add_owner(user)
+    end
+
+    include_examples 'search field examples' do
+      let(:url) { group_path(subgroup) }
+      let(:scope_name) { subgroup.name }
+    end
+  end
 end

From e2eb0f8bfbedb40ccf507f58d778991c0e5eda2a Mon Sep 17 00:00:00 2001
From: James Ramsay <jramsay@gitlab.com>
Date: Thu, 13 Jun 2019 12:57:58 +0300
Subject: [PATCH 184/195] Enable repository object pools by default

Object pools allow Git objects to be shared from the parent project to forks,
reducing storage requirements.
---
 app/models/project.rb                         |  2 +-
 ...ramsay-enable-object-dedupe-by-default.yml |  5 +++++
 .../repository_storage_types.md               | 19 +++++++------------
 3 files changed, 13 insertions(+), 13 deletions(-)
 create mode 100644 changelogs/unreleased/jramsay-enable-object-dedupe-by-default.yml

diff --git a/app/models/project.rb b/app/models/project.rb
index 0f4fba5d0b6..075f7882d72 100644
--- a/app/models/project.rb
+++ b/app/models/project.rb
@@ -2144,7 +2144,7 @@ class Project < ApplicationRecord
       public? &&
       repository_exists? &&
       Gitlab::CurrentSettings.hashed_storage_enabled &&
-      Feature.enabled?(:object_pools, self)
+      Feature.enabled?(:object_pools, self, default_enabled: true)
   end
 
   def leave_pool_repository
diff --git a/changelogs/unreleased/jramsay-enable-object-dedupe-by-default.yml b/changelogs/unreleased/jramsay-enable-object-dedupe-by-default.yml
new file mode 100644
index 00000000000..b953d7c0fc8
--- /dev/null
+++ b/changelogs/unreleased/jramsay-enable-object-dedupe-by-default.yml
@@ -0,0 +1,5 @@
+---
+title: Enable Git object pools
+merge_request: 29595
+author: jramsay
+type: changed
diff --git a/doc/administration/repository_storage_types.md b/doc/administration/repository_storage_types.md
index f4cb89c84a4..9dea6074a3f 100644
--- a/doc/administration/repository_storage_types.md
+++ b/doc/administration/repository_storage_types.md
@@ -80,25 +80,20 @@ by another folder with the next 2 characters. They are both stored in a special
 
 ### Hashed object pools
 
-CAUTION: **Beta:**
-Hashed objects pools are considered beta, and are not ready for production use.
-Follow [gitaly#1548](https://gitlab.com/gitlab-org/gitaly/issues/1548) for
-updates.
+> [Introduced](https://gitlab.com/gitlab-org/gitaly/issues/1606) in GitLab 12.1.
 
-For deduplication of public forks and their parent repository, objects are pooled
-in an object pool. These object pools are a third repository where shared objects
-are stored.
+Forks of public projects are deduplicated by creating a third repository, the object pool, containing the objects from the source project. Using `objects/info/alternates`, the source project and forks use the object pool for shared objects. Objects are moved from the source project to the object pool when housekeeping is run on the source project.
 
 ```ruby
 # object pool paths
 "@pools/#{hash[0..1]}/#{hash[2..3]}/#{hash}.git"
 ```
 
-The object pool feature is behind the `object_pools` feature flag, and can be
-enabled for individual projects by executing
-`Feature.enable(:object_pools, Project.find(<id>))`. Note that the project has to
-be on hashed storage, should not be a fork itself, and hashed storage should be
-enabled for all new projects.
+Object pools can be disabled using the `object_pools` feature flag, and can be
+disabled for individual projects by executing
+`Feature.disable(:object_pools, Project.find(<id>))`. Disabling object pools
+will not change existing deduplicated forks, but will prevent new forks from
+being deduplicated.
 
 DANGER: **Danger:**
 Do not run `git prune` or `git gc` in pool repositories! This can

From 14e2412ee4969d7b4124ebedbc2dd76eb0ebda47 Mon Sep 17 00:00:00 2001
From: Fatih Acet <acetfatih@gmail.com>
Date: Tue, 9 Jul 2019 11:46:16 +0000
Subject: [PATCH 185/195] CE Port of Allow bulk update for group issues

This is a port MR for CE

Original MR:

https://gitlab.com/gitlab-org/gitlab-ee/merge_requests/14141
---
 .../issuable_bulk_update_actions.js           |   4 +-
 app/assets/javascripts/issuable_index.js      |  17 +-
 .../issuable_init_bulk_update_sidebar.js      |  19 +
 .../javascripts/pages/groups/issues/index.js  |   4 +
 app/controllers/concerns/issuable_actions.rb  |   4 +-
 app/services/issuable/bulk_update_service.rb  |  10 +-
 app/views/groups/issues.html.haml             |   9 +
 spec/javascripts/issuable_spec.js             |  12 +-
 .../issuable/bulk_update_service_spec.rb      | 682 +++++++++---------
 9 files changed, 408 insertions(+), 353 deletions(-)
 create mode 100644 app/assets/javascripts/issuable_init_bulk_update_sidebar.js

diff --git a/app/assets/javascripts/issuable_bulk_update_actions.js b/app/assets/javascripts/issuable_bulk_update_actions.js
index bc9d7fcf30d..c855f3973b0 100644
--- a/app/assets/javascripts/issuable_bulk_update_actions.js
+++ b/app/assets/javascripts/issuable_bulk_update_actions.js
@@ -1,4 +1,4 @@
-/* eslint-disable consistent-return, func-names, array-callback-return, prefer-arrow-callback, no-unused-vars */
+/* eslint-disable consistent-return, func-names, array-callback-return, prefer-arrow-callback */
 
 import $ from 'jquery';
 import _ from 'underscore';
@@ -7,7 +7,7 @@ import Flash from './flash';
 import { __ } from './locale';
 
 export default {
-  init({ container, form, issues, prefixId } = {}) {
+  init({ form, issues, prefixId } = {}) {
     this.prefixId = prefixId || 'issue_';
     this.form = form || this.getElement('.bulk-update');
     this.$labelDropdown = this.form.find('.js-label-select');
diff --git a/app/assets/javascripts/issuable_index.js b/app/assets/javascripts/issuable_index.js
index 16f88cddce3..f3f8b6ec715 100644
--- a/app/assets/javascripts/issuable_index.js
+++ b/app/assets/javascripts/issuable_index.js
@@ -2,26 +2,13 @@ import $ from 'jquery';
 import axios from './lib/utils/axios_utils';
 import flash from './flash';
 import { s__, __ } from './locale';
-import IssuableBulkUpdateSidebar from './issuable_bulk_update_sidebar';
-import IssuableBulkUpdateActions from './issuable_bulk_update_actions';
+import issuableInitBulkUpdateSidebar from './issuable_init_bulk_update_sidebar';
 
 export default class IssuableIndex {
   constructor(pagePrefix) {
-    this.initBulkUpdate(pagePrefix);
+    issuableInitBulkUpdateSidebar.init(pagePrefix);
     IssuableIndex.resetIncomingEmailToken();
   }
-  initBulkUpdate(pagePrefix) {
-    const userCanBulkUpdate = $('.issues-bulk-update').length > 0;
-    const alreadyInitialized = Boolean(this.bulkUpdateSidebar);
-
-    if (userCanBulkUpdate && !alreadyInitialized) {
-      IssuableBulkUpdateActions.init({
-        prefixId: pagePrefix,
-      });
-
-      this.bulkUpdateSidebar = new IssuableBulkUpdateSidebar();
-    }
-  }
 
   static resetIncomingEmailToken() {
     const $resetToken = $('.incoming-email-token-reset');
diff --git a/app/assets/javascripts/issuable_init_bulk_update_sidebar.js b/app/assets/javascripts/issuable_init_bulk_update_sidebar.js
new file mode 100644
index 00000000000..da8969c80f3
--- /dev/null
+++ b/app/assets/javascripts/issuable_init_bulk_update_sidebar.js
@@ -0,0 +1,19 @@
+import IssuableBulkUpdateSidebar from './issuable_bulk_update_sidebar';
+import issuableBulkUpdateActions from './issuable_bulk_update_actions';
+
+export default {
+  bulkUpdateSidebar: null,
+
+  init(prefixId) {
+    const bulkUpdateEl = document.querySelector('.issues-bulk-update');
+    const alreadyInitialized = Boolean(this.bulkUpdateSidebar);
+
+    if (bulkUpdateEl && !alreadyInitialized) {
+      issuableBulkUpdateActions.init({ prefixId });
+
+      this.bulkUpdateSidebar = new IssuableBulkUpdateSidebar();
+    }
+
+    return this.bulkUpdateSidebar;
+  },
+};
diff --git a/app/assets/javascripts/pages/groups/issues/index.js b/app/assets/javascripts/pages/groups/issues/index.js
index 23fb5656008..dcdee77a8ab 100644
--- a/app/assets/javascripts/pages/groups/issues/index.js
+++ b/app/assets/javascripts/pages/groups/issues/index.js
@@ -1,11 +1,15 @@
 import projectSelect from '~/project_select';
 import initFilteredSearch from '~/pages/search/init_filtered_search';
+import issuableInitBulkUpdateSidebar from '~/issuable_init_bulk_update_sidebar';
 import { FILTERED_SEARCH } from '~/pages/constants';
 import IssuableFilteredSearchTokenKeys from 'ee_else_ce/filtered_search/issuable_filtered_search_token_keys';
 import initManualOrdering from '~/manual_ordering';
 
+const ISSUE_BULK_UPDATE_PREFIX = 'issue_';
+
 document.addEventListener('DOMContentLoaded', () => {
   IssuableFilteredSearchTokenKeys.addExtraTokensForIssues();
+  issuableInitBulkUpdateSidebar.init(ISSUE_BULK_UPDATE_PREFIX);
 
   initFilteredSearch({
     page: FILTERED_SEARCH.ISSUES,
diff --git a/app/controllers/concerns/issuable_actions.rb b/app/controllers/concerns/issuable_actions.rb
index 065d2d3a4ec..6fa2f75be33 100644
--- a/app/controllers/concerns/issuable_actions.rb
+++ b/app/controllers/concerns/issuable_actions.rb
@@ -92,7 +92,7 @@ module IssuableActions
   end
 
   def bulk_update
-    result = Issuable::BulkUpdateService.new(project, current_user, bulk_update_params).execute(resource_name)
+    result = Issuable::BulkUpdateService.new(current_user, bulk_update_params).execute(resource_name)
     quantity = result[:count]
 
     render json: { notice: "#{quantity} #{resource_name.pluralize(quantity)} updated" }
@@ -181,7 +181,7 @@ module IssuableActions
   end
 
   def authorize_admin_issuable!
-    unless can?(current_user, :"admin_#{resource_name}", @project) # rubocop:disable Gitlab/ModuleWithInstanceVariables
+    unless can?(current_user, :"admin_#{resource_name}", parent)
       return access_denied!
     end
   end
diff --git a/app/services/issuable/bulk_update_service.rb b/app/services/issuable/bulk_update_service.rb
index c4beddf2294..6d215d7a3b9 100644
--- a/app/services/issuable/bulk_update_service.rb
+++ b/app/services/issuable/bulk_update_service.rb
@@ -1,7 +1,15 @@
 # frozen_string_literal: true
 
 module Issuable
-  class BulkUpdateService < IssuableBaseService
+  class BulkUpdateService
+    include Gitlab::Allowable
+
+    attr_accessor :current_user, :params
+
+    def initialize(user = nil, params = {})
+      @current_user, @params = user, params.dup
+    end
+
     # rubocop: disable CodeReuse/ActiveRecord
     def execute(type)
       model_class = type.classify.constantize
diff --git a/app/views/groups/issues.html.haml b/app/views/groups/issues.html.haml
index 91d17cfd745..f05e269553a 100644
--- a/app/views/groups/issues.html.haml
+++ b/app/views/groups/issues.html.haml
@@ -1,3 +1,5 @@
+- @can_bulk_update = can?(current_user, :admin_issue, @group)
+
 - page_title "Issues"
 = content_for :meta_tags do
   = auto_discovery_link_tag(:atom, safe_params.merge(rss_url_options).to_h, title: "#{@group.name} issues")
@@ -9,8 +11,15 @@
     = render 'shared/issuable/nav', type: :issues
     .nav-controls
       = render 'shared/issuable/feed_buttons'
+
+      - if @can_bulk_update
+        = render_if_exists 'shared/issuable/bulk_update_button'
+
       = render 'shared/new_project_item_select', path: 'issues/new', label: "New issue", type: :issues, with_feature_enabled: 'issues', with_shared: false, include_projects_in_subgroups: true
 
   = render 'shared/issuable/search_bar', type: :issues
 
+  - if @can_bulk_update
+    = render_if_exists 'shared/issuable/group_bulk_update_sidebar', group: @group, type: :issues
+
   = render 'shared/issues'
diff --git a/spec/javascripts/issuable_spec.js b/spec/javascripts/issuable_spec.js
index 25543053eba..4d57bfb1b33 100644
--- a/spec/javascripts/issuable_spec.js
+++ b/spec/javascripts/issuable_spec.js
@@ -2,14 +2,14 @@ import $ from 'jquery';
 import MockAdaptor from 'axios-mock-adapter';
 import axios from '~/lib/utils/axios_utils';
 import IssuableIndex from '~/issuable_index';
+import issuableInitBulkUpdateSidebar from '~/issuable_init_bulk_update_sidebar';
 
 describe('Issuable', () => {
-  let Issuable;
   describe('initBulkUpdate', () => {
     it('should not set bulkUpdateSidebar', () => {
-      Issuable = new IssuableIndex('issue_');
+      new IssuableIndex('issue_'); // eslint-disable-line no-new
 
-      expect(Issuable.bulkUpdateSidebar).not.toBeDefined();
+      expect(issuableInitBulkUpdateSidebar.bulkUpdateSidebar).toBeNull();
     });
 
     it('should set bulkUpdateSidebar', () => {
@@ -17,9 +17,9 @@ describe('Issuable', () => {
       element.classList.add('issues-bulk-update');
       document.body.appendChild(element);
 
-      Issuable = new IssuableIndex('issue_');
+      new IssuableIndex('issue_'); // eslint-disable-line no-new
 
-      expect(Issuable.bulkUpdateSidebar).toBeDefined();
+      expect(issuableInitBulkUpdateSidebar.bulkUpdateSidebar).toBeDefined();
     });
   });
 
@@ -36,7 +36,7 @@ describe('Issuable', () => {
       input.setAttribute('id', 'issuable_email');
       document.body.appendChild(input);
 
-      Issuable = new IssuableIndex('issue_');
+      new IssuableIndex('issue_'); // eslint-disable-line no-new
 
       mock = new MockAdaptor(axios);
 
diff --git a/spec/services/issuable/bulk_update_service_spec.rb b/spec/services/issuable/bulk_update_service_spec.rb
index aebc5ba2874..3d2d4b5f216 100644
--- a/spec/services/issuable/bulk_update_service_spec.rb
+++ b/spec/services/issuable/bulk_update_service_spec.rb
@@ -11,343 +11,371 @@ describe Issuable::BulkUpdateService do
       .reverse_merge(issuable_ids: Array(issuables).map(&:id).join(','))
 
     type = Array(issuables).first.model_name.param_key
-    Issuable::BulkUpdateService.new(project, user, bulk_update_params).execute(type)
+    Issuable::BulkUpdateService.new(user, bulk_update_params).execute(type)
   end
 
-  describe 'close issues' do
-    let(:issues) { create_list(:issue, 2, project: project) }
-
-    it 'succeeds and returns the correct number of issues updated' do
-      result = bulk_update(issues, state_event: 'close')
-
-      expect(result[:success]).to be_truthy
-      expect(result[:count]).to eq(issues.count)
-    end
-
-    it 'closes all the issues passed' do
-      bulk_update(issues, state_event: 'close')
-
-      expect(project.issues.opened).to be_empty
-      expect(project.issues.closed).not_to be_empty
-    end
-
-    context 'when issue for a different project is created' do
-      let(:private_project) { create(:project, :private) }
-      let(:issue) { create(:issue, project: private_project, author: user) }
-
-      context 'when user has access to the project' do
-        it 'closes all issues passed' do
-          private_project.add_maintainer(user)
-
-          bulk_update(issues + [issue], state_event: 'close')
-
-          expect(project.issues.opened).to be_empty
-          expect(project.issues.closed).not_to be_empty
-          expect(private_project.issues.closed).not_to be_empty
-        end
-      end
-
-      context 'when user does not have access to project' do
-        it 'only closes all issues that the user has access to' do
-          bulk_update(issues + [issue], state_event: 'close')
-
-          expect(project.issues.opened).to be_empty
-          expect(project.issues.closed).not_to be_empty
-          expect(private_project.issues.closed).to be_empty
-        end
-      end
-    end
-  end
-
-  describe 'reopen issues' do
-    let(:issues) { create_list(:closed_issue, 2, project: project) }
-
-    it 'succeeds and returns the correct number of issues updated' do
-      result = bulk_update(issues, state_event: 'reopen')
-
-      expect(result[:success]).to be_truthy
-      expect(result[:count]).to eq(issues.count)
-    end
-
-    it 'reopens all the issues passed' do
-      bulk_update(issues, state_event: 'reopen')
-
-      expect(project.issues.closed).to be_empty
-      expect(project.issues.opened).not_to be_empty
-    end
-  end
-
-  describe 'updating merge request assignee' do
-    let(:merge_request) { create(:merge_request, target_project: project, source_project: project, assignees: [user]) }
-
-    context 'when the new assignee ID is a valid user' do
-      it 'succeeds' do
-        new_assignee = create(:user)
-        project.add_developer(new_assignee)
-
-        result = bulk_update(merge_request, assignee_ids: [user.id, new_assignee.id])
-
-        expect(result[:success]).to be_truthy
-        expect(result[:count]).to eq(1)
-      end
-
-      it 'updates the assignee to the user ID passed' do
-        assignee = create(:user)
-        project.add_developer(assignee)
-
-        expect { bulk_update(merge_request, assignee_ids: [assignee.id]) }
-          .to change { merge_request.reload.assignee_ids }.from([user.id]).to([assignee.id])
-      end
-    end
-
-    context "when the new assignee ID is #{IssuableFinder::NONE}" do
-      it 'unassigns the issues' do
-        expect { bulk_update(merge_request, assignee_ids: [IssuableFinder::NONE]) }
-          .to change { merge_request.reload.assignee_ids }.to([])
-      end
-    end
-
-    context 'when the new assignee ID is not present' do
-      it 'does not unassign' do
-        expect { bulk_update(merge_request, assignee_ids: []) }
-          .not_to change { merge_request.reload.assignee_ids }
-      end
-    end
-  end
-
-  describe 'updating issue assignee' do
-    let(:issue) { create(:issue, project: project, assignees: [user]) }
-
-    context 'when the new assignee ID is a valid user' do
-      it 'succeeds' do
-        new_assignee = create(:user)
-        project.add_developer(new_assignee)
-
-        result = bulk_update(issue, assignee_ids: [new_assignee.id])
-
-        expect(result[:success]).to be_truthy
-        expect(result[:count]).to eq(1)
-      end
-
-      it 'updates the assignee to the user ID passed' do
-        assignee = create(:user)
-        project.add_developer(assignee)
-        expect { bulk_update(issue, assignee_ids: [assignee.id]) }
-          .to change { issue.reload.assignees.first }.from(user).to(assignee)
-      end
-    end
-
-    context "when the new assignee ID is #{IssuableFinder::NONE}" do
-      it "unassigns the issues" do
-        expect { bulk_update(issue, assignee_ids: [IssuableFinder::NONE.to_s]) }
-          .to change { issue.reload.assignees.count }.from(1).to(0)
-      end
-    end
-
-    context 'when the new assignee ID is not present' do
-      it 'does not unassign' do
-        expect { bulk_update(issue, assignee_ids: []) }
-          .not_to change { issue.reload.assignees }
-      end
-    end
-  end
-
-  describe 'updating milestones' do
-    let(:issue)     { create(:issue, project: project) }
-    let(:milestone) { create(:milestone, project: project) }
-
+  shared_examples 'updates milestones' do
     it 'succeeds' do
-      result = bulk_update(issue, milestone_id: milestone.id)
+      result = bulk_update(issues, milestone_id: milestone.id)
 
       expect(result[:success]).to be_truthy
-      expect(result[:count]).to eq(1)
+      expect(result[:count]).to eq(issues.count)
     end
 
-    it 'updates the issue milestone' do
-      expect { bulk_update(issue, milestone_id: milestone.id) }
-        .to change { issue.reload.milestone }.from(nil).to(milestone)
-    end
-  end
-
-  describe 'updating labels' do
-    def create_issue_with_labels(labels)
-      create(:labeled_issue, project: project, labels: labels)
-    end
-
-    let(:bug) { create(:label, project: project) }
-    let(:regression) { create(:label, project: project) }
-    let(:merge_requests) { create(:label, project: project) }
-
-    let(:issue_all_labels) { create_issue_with_labels([bug, regression, merge_requests]) }
-    let(:issue_bug_and_regression) { create_issue_with_labels([bug, regression]) }
-    let(:issue_bug_and_merge_requests) { create_issue_with_labels([bug, merge_requests]) }
-    let(:issue_no_labels) { create(:issue, project: project) }
-    let(:issues) { [issue_all_labels, issue_bug_and_regression, issue_bug_and_merge_requests, issue_no_labels] }
-
-    let(:labels) { [] }
-    let(:add_labels) { [] }
-    let(:remove_labels) { [] }
-
-    let(:bulk_update_params) do
-      {
-        label_ids:        labels.map(&:id),
-        add_label_ids:    add_labels.map(&:id),
-        remove_label_ids: remove_labels.map(&:id)
-      }
-    end
-
-    before do
-      bulk_update(issues, bulk_update_params)
-    end
-
-    context 'when label_ids are passed' do
-      let(:issues) { [issue_all_labels, issue_no_labels] }
-      let(:labels) { [bug, regression] }
-
-      it 'updates the labels of all issues passed to the labels passed' do
-        expect(issues.map(&:reload).map(&:label_ids)).to all(match_array(labels.map(&:id)))
-      end
-
-      it 'does not update issues not passed in' do
-        expect(issue_bug_and_regression.label_ids).to contain_exactly(bug.id, regression.id)
-      end
-
-      context 'when those label IDs are empty' do
-        let(:labels) { [] }
-
-        it 'updates the issues passed to have no labels' do
-          expect(issues.map(&:reload).map(&:label_ids)).to all(be_empty)
-        end
-      end
-    end
-
-    context 'when add_label_ids are passed' do
-      let(:issues) { [issue_all_labels, issue_bug_and_merge_requests, issue_no_labels] }
-      let(:add_labels) { [bug, regression, merge_requests] }
-
-      it 'adds those label IDs to all issues passed' do
-        expect(issues.map(&:reload).map(&:label_ids)).to all(include(*add_labels.map(&:id)))
-      end
-
-      it 'does not update issues not passed in' do
-        expect(issue_bug_and_regression.label_ids).to contain_exactly(bug.id, regression.id)
-      end
-    end
-
-    context 'when remove_label_ids are passed' do
-      let(:issues) { [issue_all_labels, issue_bug_and_merge_requests, issue_no_labels] }
-      let(:remove_labels) { [bug, regression, merge_requests] }
-
-      it 'removes those label IDs from all issues passed' do
-        expect(issues.map(&:reload).map(&:label_ids)).to all(be_empty)
-      end
-
-      it 'does not update issues not passed in' do
-        expect(issue_bug_and_regression.label_ids).to contain_exactly(bug.id, regression.id)
-      end
-    end
-
-    context 'when add_label_ids and remove_label_ids are passed' do
-      let(:issues) { [issue_all_labels, issue_bug_and_merge_requests, issue_no_labels] }
-      let(:add_labels) { [bug] }
-      let(:remove_labels) { [merge_requests] }
-
-      it 'adds the label IDs to all issues passed' do
-        expect(issues.map(&:reload).map(&:label_ids)).to all(include(bug.id))
-      end
-
-      it 'removes the label IDs from all issues passed' do
-        expect(issues.map(&:reload).map(&:label_ids).flatten).not_to include(merge_requests.id)
-      end
-
-      it 'does not update issues not passed in' do
-        expect(issue_bug_and_regression.label_ids).to contain_exactly(bug.id, regression.id)
-      end
-    end
-
-    context 'when add_label_ids and label_ids are passed' do
-      let(:issues) { [issue_all_labels, issue_bug_and_regression, issue_bug_and_merge_requests] }
-      let(:labels) { [merge_requests] }
-      let(:add_labels) { [regression] }
-
-      it 'adds the label IDs to all issues passed' do
-        expect(issues.map(&:reload).map(&:label_ids)).to all(include(regression.id))
-      end
-
-      it 'ignores the label IDs parameter' do
-        expect(issues.map(&:reload).map(&:label_ids)).to all(include(bug.id))
-      end
-
-      it 'does not update issues not passed in' do
-        expect(issue_no_labels.label_ids).to be_empty
-      end
-    end
-
-    context 'when remove_label_ids and label_ids are passed' do
-      let(:issues) { [issue_no_labels, issue_bug_and_regression] }
-      let(:labels) { [merge_requests] }
-      let(:remove_labels) { [regression] }
-
-      it 'removes the label IDs from all issues passed' do
-        expect(issues.map(&:reload).map(&:label_ids).flatten).not_to include(regression.id)
-      end
-
-      it 'ignores the label IDs parameter' do
-        expect(issues.map(&:reload).map(&:label_ids).flatten).not_to include(merge_requests.id)
-      end
-
-      it 'does not update issues not passed in' do
-        expect(issue_all_labels.label_ids).to contain_exactly(bug.id, regression.id, merge_requests.id)
-      end
-    end
-
-    context 'when add_label_ids, remove_label_ids, and label_ids are passed' do
-      let(:issues) { [issue_bug_and_merge_requests, issue_no_labels] }
-      let(:labels) { [regression] }
-      let(:add_labels) { [bug] }
-      let(:remove_labels) { [merge_requests] }
-
-      it 'adds the label IDs to all issues passed' do
-        expect(issues.map(&:reload).map(&:label_ids)).to all(include(bug.id))
-      end
-
-      it 'removes the label IDs from all issues passed' do
-        expect(issues.map(&:reload).map(&:label_ids).flatten).not_to include(merge_requests.id)
-      end
-
-      it 'ignores the label IDs parameter' do
-        expect(issues.map(&:reload).map(&:label_ids).flatten).not_to include(regression.id)
-      end
-
-      it 'does not update issues not passed in' do
-        expect(issue_bug_and_regression.label_ids).to contain_exactly(bug.id, regression.id)
-      end
-    end
-  end
-
-  describe 'subscribe to issues' do
-    let(:issues) { create_list(:issue, 2, project: project) }
-
-    it 'subscribes the given user' do
-      bulk_update(issues, subscription_event: 'subscribe')
-
-      expect(issues).to all(be_subscribed(user, project))
-    end
-  end
-
-  describe 'unsubscribe from issues' do
-    let(:issues) do
-      create_list(:closed_issue, 2, project: project) do |issue|
-        issue.subscriptions.create(user: user, project: project, subscribed: true)
-      end
-    end
-
-    it 'unsubscribes the given user' do
-      bulk_update(issues, subscription_event: 'unsubscribe')
+    it 'updates the issues milestone' do
+      bulk_update(issues, milestone_id: milestone.id)
 
       issues.each do |issue|
-        expect(issue).not_to be_subscribed(user, project)
+        expect(issue.reload.milestone).to eq(milestone)
       end
     end
   end
+
+  context 'with project issues' do
+    describe 'close issues' do
+      let(:issues) { create_list(:issue, 2, project: project) }
+
+      it 'succeeds and returns the correct number of issues updated' do
+        result = bulk_update(issues, state_event: 'close')
+
+        expect(result[:success]).to be_truthy
+        expect(result[:count]).to eq(issues.count)
+      end
+
+      it 'closes all the issues passed' do
+        bulk_update(issues, state_event: 'close')
+
+        expect(project.issues.opened).to be_empty
+        expect(project.issues.closed).not_to be_empty
+      end
+
+      context 'when issue for a different project is created' do
+        let(:private_project) { create(:project, :private) }
+        let(:issue) { create(:issue, project: private_project, author: user) }
+
+        context 'when user has access to the project' do
+          it 'closes all issues passed' do
+            private_project.add_maintainer(user)
+
+            bulk_update(issues + [issue], state_event: 'close')
+
+            expect(project.issues.opened).to be_empty
+            expect(project.issues.closed).not_to be_empty
+            expect(private_project.issues.closed).not_to be_empty
+          end
+        end
+
+        context 'when user does not have access to project' do
+          it 'only closes all issues that the user has access to' do
+            bulk_update(issues + [issue], state_event: 'close')
+
+            expect(project.issues.opened).to be_empty
+            expect(project.issues.closed).not_to be_empty
+            expect(private_project.issues.closed).to be_empty
+          end
+        end
+      end
+    end
+
+    describe 'reopen issues' do
+      let(:issues) { create_list(:closed_issue, 2, project: project) }
+
+      it 'succeeds and returns the correct number of issues updated' do
+        result = bulk_update(issues, state_event: 'reopen')
+
+        expect(result[:success]).to be_truthy
+        expect(result[:count]).to eq(issues.count)
+      end
+
+      it 'reopens all the issues passed' do
+        bulk_update(issues, state_event: 'reopen')
+
+        expect(project.issues.closed).to be_empty
+        expect(project.issues.opened).not_to be_empty
+      end
+    end
+
+    describe 'updating merge request assignee' do
+      let(:merge_request) { create(:merge_request, target_project: project, source_project: project, assignees: [user]) }
+
+      context 'when the new assignee ID is a valid user' do
+        it 'succeeds' do
+          new_assignee = create(:user)
+          project.add_developer(new_assignee)
+
+          result = bulk_update(merge_request, assignee_ids: [user.id, new_assignee.id])
+
+          expect(result[:success]).to be_truthy
+          expect(result[:count]).to eq(1)
+        end
+
+        it 'updates the assignee to the user ID passed' do
+          assignee = create(:user)
+          project.add_developer(assignee)
+
+          expect { bulk_update(merge_request, assignee_ids: [assignee.id]) }
+            .to change { merge_request.reload.assignee_ids }.from([user.id]).to([assignee.id])
+        end
+      end
+
+      context "when the new assignee ID is #{IssuableFinder::NONE}" do
+        it 'unassigns the issues' do
+          expect { bulk_update(merge_request, assignee_ids: [IssuableFinder::NONE]) }
+            .to change { merge_request.reload.assignee_ids }.to([])
+        end
+      end
+
+      context 'when the new assignee ID is not present' do
+        it 'does not unassign' do
+          expect { bulk_update(merge_request, assignee_ids: []) }
+            .not_to change { merge_request.reload.assignee_ids }
+        end
+      end
+    end
+
+    describe 'updating issue assignee' do
+      let(:issue) { create(:issue, project: project, assignees: [user]) }
+
+      context 'when the new assignee ID is a valid user' do
+        it 'succeeds' do
+          new_assignee = create(:user)
+          project.add_developer(new_assignee)
+
+          result = bulk_update(issue, assignee_ids: [new_assignee.id])
+
+          expect(result[:success]).to be_truthy
+          expect(result[:count]).to eq(1)
+        end
+
+        it 'updates the assignee to the user ID passed' do
+          assignee = create(:user)
+          project.add_developer(assignee)
+          expect { bulk_update(issue, assignee_ids: [assignee.id]) }
+            .to change { issue.reload.assignees.first }.from(user).to(assignee)
+        end
+      end
+
+      context "when the new assignee ID is #{IssuableFinder::NONE}" do
+        it "unassigns the issues" do
+          expect { bulk_update(issue, assignee_ids: [IssuableFinder::NONE.to_s]) }
+            .to change { issue.reload.assignees.count }.from(1).to(0)
+        end
+      end
+
+      context 'when the new assignee ID is not present' do
+        it 'does not unassign' do
+          expect { bulk_update(issue, assignee_ids: []) }
+            .not_to change { issue.reload.assignees }
+        end
+      end
+    end
+
+    describe 'updating milestones' do
+      let(:issues)    { [create(:issue, project: project)] }
+      let(:milestone) { create(:milestone, project: project) }
+
+      it_behaves_like 'updates milestones'
+    end
+
+    describe 'updating labels' do
+      def create_issue_with_labels(labels)
+        create(:labeled_issue, project: project, labels: labels)
+      end
+
+      let(:bug) { create(:label, project: project) }
+      let(:regression) { create(:label, project: project) }
+      let(:merge_requests) { create(:label, project: project) }
+
+      let(:issue_all_labels) { create_issue_with_labels([bug, regression, merge_requests]) }
+      let(:issue_bug_and_regression) { create_issue_with_labels([bug, regression]) }
+      let(:issue_bug_and_merge_requests) { create_issue_with_labels([bug, merge_requests]) }
+      let(:issue_no_labels) { create(:issue, project: project) }
+      let(:issues) { [issue_all_labels, issue_bug_and_regression, issue_bug_and_merge_requests, issue_no_labels] }
+
+      let(:labels) { [] }
+      let(:add_labels) { [] }
+      let(:remove_labels) { [] }
+
+      let(:bulk_update_params) do
+        {
+          label_ids:        labels.map(&:id),
+          add_label_ids:    add_labels.map(&:id),
+          remove_label_ids: remove_labels.map(&:id)
+        }
+      end
+
+      before do
+        bulk_update(issues, bulk_update_params)
+      end
+
+      context 'when label_ids are passed' do
+        let(:issues) { [issue_all_labels, issue_no_labels] }
+        let(:labels) { [bug, regression] }
+
+        it 'updates the labels of all issues passed to the labels passed' do
+          expect(issues.map(&:reload).map(&:label_ids)).to all(match_array(labels.map(&:id)))
+        end
+
+        it 'does not update issues not passed in' do
+          expect(issue_bug_and_regression.label_ids).to contain_exactly(bug.id, regression.id)
+        end
+
+        context 'when those label IDs are empty' do
+          let(:labels) { [] }
+
+          it 'updates the issues passed to have no labels' do
+            expect(issues.map(&:reload).map(&:label_ids)).to all(be_empty)
+          end
+        end
+      end
+
+      context 'when add_label_ids are passed' do
+        let(:issues) { [issue_all_labels, issue_bug_and_merge_requests, issue_no_labels] }
+        let(:add_labels) { [bug, regression, merge_requests] }
+
+        it 'adds those label IDs to all issues passed' do
+          expect(issues.map(&:reload).map(&:label_ids)).to all(include(*add_labels.map(&:id)))
+        end
+
+        it 'does not update issues not passed in' do
+          expect(issue_bug_and_regression.label_ids).to contain_exactly(bug.id, regression.id)
+        end
+      end
+
+      context 'when remove_label_ids are passed' do
+        let(:issues) { [issue_all_labels, issue_bug_and_merge_requests, issue_no_labels] }
+        let(:remove_labels) { [bug, regression, merge_requests] }
+
+        it 'removes those label IDs from all issues passed' do
+          expect(issues.map(&:reload).map(&:label_ids)).to all(be_empty)
+        end
+
+        it 'does not update issues not passed in' do
+          expect(issue_bug_and_regression.label_ids).to contain_exactly(bug.id, regression.id)
+        end
+      end
+
+      context 'when add_label_ids and remove_label_ids are passed' do
+        let(:issues) { [issue_all_labels, issue_bug_and_merge_requests, issue_no_labels] }
+        let(:add_labels) { [bug] }
+        let(:remove_labels) { [merge_requests] }
+
+        it 'adds the label IDs to all issues passed' do
+          expect(issues.map(&:reload).map(&:label_ids)).to all(include(bug.id))
+        end
+
+        it 'removes the label IDs from all issues passed' do
+          expect(issues.map(&:reload).map(&:label_ids).flatten).not_to include(merge_requests.id)
+        end
+
+        it 'does not update issues not passed in' do
+          expect(issue_bug_and_regression.label_ids).to contain_exactly(bug.id, regression.id)
+        end
+      end
+
+      context 'when add_label_ids and label_ids are passed' do
+        let(:issues) { [issue_all_labels, issue_bug_and_regression, issue_bug_and_merge_requests] }
+        let(:labels) { [merge_requests] }
+        let(:add_labels) { [regression] }
+
+        it 'adds the label IDs to all issues passed' do
+          expect(issues.map(&:reload).map(&:label_ids)).to all(include(regression.id))
+        end
+
+        it 'ignores the label IDs parameter' do
+          expect(issues.map(&:reload).map(&:label_ids)).to all(include(bug.id))
+        end
+
+        it 'does not update issues not passed in' do
+          expect(issue_no_labels.label_ids).to be_empty
+        end
+      end
+
+      context 'when remove_label_ids and label_ids are passed' do
+        let(:issues) { [issue_no_labels, issue_bug_and_regression] }
+        let(:labels) { [merge_requests] }
+        let(:remove_labels) { [regression] }
+
+        it 'removes the label IDs from all issues passed' do
+          expect(issues.map(&:reload).map(&:label_ids).flatten).not_to include(regression.id)
+        end
+
+        it 'ignores the label IDs parameter' do
+          expect(issues.map(&:reload).map(&:label_ids).flatten).not_to include(merge_requests.id)
+        end
+
+        it 'does not update issues not passed in' do
+          expect(issue_all_labels.label_ids).to contain_exactly(bug.id, regression.id, merge_requests.id)
+        end
+      end
+
+      context 'when add_label_ids, remove_label_ids, and label_ids are passed' do
+        let(:issues) { [issue_bug_and_merge_requests, issue_no_labels] }
+        let(:labels) { [regression] }
+        let(:add_labels) { [bug] }
+        let(:remove_labels) { [merge_requests] }
+
+        it 'adds the label IDs to all issues passed' do
+          expect(issues.map(&:reload).map(&:label_ids)).to all(include(bug.id))
+        end
+
+        it 'removes the label IDs from all issues passed' do
+          expect(issues.map(&:reload).map(&:label_ids).flatten).not_to include(merge_requests.id)
+        end
+
+        it 'ignores the label IDs parameter' do
+          expect(issues.map(&:reload).map(&:label_ids).flatten).not_to include(regression.id)
+        end
+
+        it 'does not update issues not passed in' do
+          expect(issue_bug_and_regression.label_ids).to contain_exactly(bug.id, regression.id)
+        end
+      end
+    end
+
+    describe 'subscribe to issues' do
+      let(:issues) { create_list(:issue, 2, project: project) }
+
+      it 'subscribes the given user' do
+        bulk_update(issues, subscription_event: 'subscribe')
+
+        expect(issues).to all(be_subscribed(user, project))
+      end
+    end
+
+    describe 'unsubscribe from issues' do
+      let(:issues) do
+        create_list(:closed_issue, 2, project: project) do |issue|
+          issue.subscriptions.create(user: user, project: project, subscribed: true)
+        end
+      end
+
+      it 'unsubscribes the given user' do
+        bulk_update(issues, subscription_event: 'unsubscribe')
+
+        issues.each do |issue|
+          expect(issue).not_to be_subscribed(user, project)
+        end
+      end
+    end
+  end
+
+  context 'with group issues' do
+    let(:group) { create(:group) }
+
+    context 'updating milestone' do
+      let(:milestone) { create(:milestone, group: group) }
+      let(:project1)  { create(:project, :repository, group: group) }
+      let(:project2)  { create(:project, :repository, group: group) }
+      let(:issue1)    { create(:issue, project: project1) }
+      let(:issue2)    { create(:issue, project: project2) }
+      let(:issues)    { [issue1, issue2] }
+
+      before do
+        group.add_maintainer(user)
+      end
+
+      it_behaves_like 'updates milestones'
+    end
+  end
 end

From 639ab5214cb569dce70080020e3181946e5d3bf1 Mon Sep 17 00:00:00 2001
From: charlie ablett <cablett@gitlab.com>
Date: Tue, 9 Jul 2019 12:45:23 +0000
Subject: [PATCH 186/195] Remove `:graphql` feature flag

- Remove `FeatureConstrainer` call wrapping api endpoint
- Remove `Feature.enabled?(:graphql)` conditionals in back and frontend
- Modify graphql test to be graphql flag agnostic
- Remove api routing spec
- Remove frontend feature flag via `gon`
---
 .../javascripts/pages/projects/issues/form.js |  4 +---
 app/controllers/graphql_controller.rb         |  5 ----
 app/controllers/projects/issues_controller.rb |  6 -----
 app/helpers/projects_helper.rb                |  2 +-
 app/views/shared/issuable/_form.html.haml     |  3 +--
 config/routes/api.rb                          |  6 ++---
 doc/api/graphql/index.md                      | 16 +++----------
 lib/api/helpers/graphql_helpers.rb            |  2 --
 lib/gitlab/graphql.rb                         |  4 ----
 spec/requests/api/graphql_spec.rb             | 10 --------
 spec/routing/api_routing_spec.rb              | 23 -------------------
 11 files changed, 8 insertions(+), 73 deletions(-)
 delete mode 100644 spec/routing/api_routing_spec.rb

diff --git a/app/assets/javascripts/pages/projects/issues/form.js b/app/assets/javascripts/pages/projects/issues/form.js
index 941c4552579..2205a7bafe3 100644
--- a/app/assets/javascripts/pages/projects/issues/form.js
+++ b/app/assets/javascripts/pages/projects/issues/form.js
@@ -17,7 +17,5 @@ export default () => {
   new MilestoneSelect();
   new IssuableTemplateSelectors();
 
-  if (gon.features.graphql) {
-    initSuggestions();
-  }
+  initSuggestions();
 };
diff --git a/app/controllers/graphql_controller.rb b/app/controllers/graphql_controller.rb
index 1ce0afac83b..9fbbe373b0d 100644
--- a/app/controllers/graphql_controller.rb
+++ b/app/controllers/graphql_controller.rb
@@ -11,7 +11,6 @@ class GraphqlController < ApplicationController
   # around in GraphiQL.
   protect_from_forgery with: :null_session, only: :execute
 
-  before_action :check_graphql_feature_flag!
   before_action :authorize_access_api!
   before_action(only: [:execute]) { authenticate_sessionless_user!(:api) }
 
@@ -86,8 +85,4 @@ class GraphqlController < ApplicationController
 
     render json: error, status: status
   end
-
-  def check_graphql_feature_flag!
-    render_404 unless Gitlab::Graphql.enabled?
-  end
 end
diff --git a/app/controllers/projects/issues_controller.rb b/app/controllers/projects/issues_controller.rb
index b866f574f67..228de8bc6f3 100644
--- a/app/controllers/projects/issues_controller.rb
+++ b/app/controllers/projects/issues_controller.rb
@@ -45,8 +45,6 @@ class Projects::IssuesController < Projects::ApplicationController
   before_action :authorize_import_issues!, only: [:import_csv]
   before_action :authorize_download_code!, only: [:related_branches]
 
-  before_action :set_suggested_issues_feature_flags, only: [:new]
-
   respond_to :html
 
   def index
@@ -285,8 +283,4 @@ class Projects::IssuesController < Projects::ApplicationController
     # 3. https://gitlab.com/gitlab-org/gitlab-ce/issues/42426
     Gitlab::QueryLimiting.whitelist('https://gitlab.com/gitlab-org/gitlab-ce/issues/42422')
   end
-
-  def set_suggested_issues_feature_flags
-    push_frontend_feature_flag(:graphql, default_enabled: true)
-  end
 end
diff --git a/app/helpers/projects_helper.rb b/app/helpers/projects_helper.rb
index 8dee842a22d..8d0079a4dd3 100644
--- a/app/helpers/projects_helper.rb
+++ b/app/helpers/projects_helper.rb
@@ -662,6 +662,6 @@ module ProjectsHelper
   end
 
   def vue_file_list_enabled?
-    Gitlab::Graphql.enabled? && Feature.enabled?(:vue_file_list, @project)
+    Feature.enabled?(:vue_file_list, @project)
   end
 end
diff --git a/app/views/shared/issuable/_form.html.haml b/app/views/shared/issuable/_form.html.haml
index 1bd56e064d5..214e87052da 100644
--- a/app/views/shared/issuable/_form.html.haml
+++ b/app/views/shared/issuable/_form.html.haml
@@ -17,8 +17,7 @@
 
   = render 'shared/issuable/form/template_selector', issuable: issuable
   = render 'shared/issuable/form/title', issuable: issuable, form: form, has_wip_commits: commits && commits.detect(&:work_in_progress?)
-- if Gitlab::Graphql.enabled?
-  #js-suggestions{ data: { project_path: @project.full_path } }
+#js-suggestions{ data: { project_path: @project.full_path } }
 
 = render 'shared/form_elements/description', model: issuable, form: form, project: project
 
diff --git a/config/routes/api.rb b/config/routes/api.rb
index 3ba9176d943..c6c17b5708e 100644
--- a/config/routes/api.rb
+++ b/config/routes/api.rb
@@ -1,7 +1,5 @@
-constraints(::Constraints::FeatureConstrainer.new(:graphql, default_enabled: true)) do
-  post '/api/graphql', to: 'graphql#execute'
-  mount GraphiQL::Rails::Engine, at: '/-/graphql-explorer', graphql_path: '/api/graphql'
-end
+post '/api/graphql', to: 'graphql#execute'
+mount GraphiQL::Rails::Engine, at: '/-/graphql-explorer', graphql_path: '/api/graphql'
 
 ::API::API.logger Rails.logger
 mount ::API::API => '/'
diff --git a/doc/api/graphql/index.md b/doc/api/graphql/index.md
index 3bf96e279b7..db073321808 100644
--- a/doc/api/graphql/index.md
+++ b/doc/api/graphql/index.md
@@ -1,4 +1,4 @@
-# GraphQL API (Alpha)
+# GraphQL API
 
 > [Introduced][ce-19008] in GitLab 11.0.
 
@@ -23,23 +23,13 @@ programmatically with GitLab. To achieve this, it needs full coverage - anything
 possible in the REST API should also be possible in the GraphQL API.
 
 To help us meet this vision, the frontend should use GraphQL in preference to
-the REST API for new features, although the alpha status of GraphQL may prevent
-this from being a possibility at times.
+the REST API for new features.
 
 There are no plans to deprecate the REST API. To reduce the technical burden of
 supporting two APIs in parallel, they should share implementations as much as
 possible.
 
-## Enabling the GraphQL feature
-
-The GraphQL API itself is currently in Alpha, and therefore hidden behind a
-feature flag. You can enable the feature using the [features api][features-api] on a self-hosted instance.
-
-For example:
-
-```shell
-curl --data "value=100" --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/features/graphql
-```
+As of the 12.1 release, GraphQL is always enabled.
 
 ## Available queries
 
diff --git a/lib/api/helpers/graphql_helpers.rb b/lib/api/helpers/graphql_helpers.rb
index 94010ab1bc2..bd60470fbd6 100644
--- a/lib/api/helpers/graphql_helpers.rb
+++ b/lib/api/helpers/graphql_helpers.rb
@@ -7,8 +7,6 @@ module API
     # should be in app/graphql/ or lib/gitlab/graphql/
     module GraphqlHelpers
       def conditionally_graphql!(fallback:, query:, context: {}, transform: nil)
-        return fallback.call unless Feature.enabled?(:graphql)
-
         result = GitlabSchema.execute(query, context: context)
 
         if transform
diff --git a/lib/gitlab/graphql.rb b/lib/gitlab/graphql.rb
index 8a59e83974f..74c04e5380e 100644
--- a/lib/gitlab/graphql.rb
+++ b/lib/gitlab/graphql.rb
@@ -3,9 +3,5 @@
 module Gitlab
   module Graphql
     StandardGraphqlError = Class.new(StandardError)
-
-    def self.enabled?
-      Feature.enabled?(:graphql, default_enabled: true)
-    end
   end
 end
diff --git a/spec/requests/api/graphql_spec.rb b/spec/requests/api/graphql_spec.rb
index 67371cb35b6..54401ec4085 100644
--- a/spec/requests/api/graphql_spec.rb
+++ b/spec/requests/api/graphql_spec.rb
@@ -6,16 +6,6 @@ describe 'GraphQL' do
 
   let(:query) { graphql_query_for('echo', 'text' => 'Hello world' ) }
 
-  context 'graphql is disabled by feature flag' do
-    before do
-      stub_feature_flags(graphql: false)
-    end
-
-    it 'does not generate a route for GraphQL' do
-      expect { post_graphql(query) }.to raise_error(ActionController::RoutingError)
-    end
-  end
-
   context 'logging' do
     shared_examples 'logging a graphql query' do
       let(:expected_params) do
diff --git a/spec/routing/api_routing_spec.rb b/spec/routing/api_routing_spec.rb
deleted file mode 100644
index 3c48ead4ff2..00000000000
--- a/spec/routing/api_routing_spec.rb
+++ /dev/null
@@ -1,23 +0,0 @@
-require 'spec_helper'
-
-describe 'api', 'routing' do
-  context 'when graphql is disabled' do
-    before do
-      stub_feature_flags(graphql: false)
-    end
-
-    it 'does not route to the GraphqlController' do
-      expect(post('/api/graphql')).not_to route_to('graphql#execute')
-    end
-  end
-
-  context 'when graphql is enabled' do
-    before do
-      stub_feature_flags(graphql: true)
-    end
-
-    it 'routes to the GraphqlController' do
-      expect(post('/api/graphql')).to route_to('graphql#execute')
-    end
-  end
-end

From 8c81d543a1fa1693fb3e8e1cb0620edd97c23703 Mon Sep 17 00:00:00 2001
From: Marcel Amirault <mamirault@gitlab.com>
Date: Tue, 9 Jul 2019 13:25:58 +0000
Subject: [PATCH 187/195] Docs: audit/auditor docs images

---
 doc/administration/audit_events.md                  |   2 +-
 doc/administration/auditor_users.md                 |   2 +-
 doc/administration/{ => img}/audit_log.png          | Bin
 .../{ => img}/auditor_access_form.png               | Bin
 4 files changed, 2 insertions(+), 2 deletions(-)
 rename doc/administration/{ => img}/audit_log.png (100%)
 rename doc/administration/{ => img}/auditor_access_form.png (100%)

diff --git a/doc/administration/audit_events.md b/doc/administration/audit_events.md
index ae1f6e00ea5..a80ff330e03 100644
--- a/doc/administration/audit_events.md
+++ b/doc/administration/audit_events.md
@@ -99,7 +99,7 @@ It is possible to filter particular actions by choosing an audit data type from
 the filter drop-down. You can further filter by specific group, project or user
 (for authentication events).
 
-![audit log](audit_log.png)
+![audit log](img/audit_log.png)
 
 ### Missing events
 
diff --git a/doc/administration/auditor_users.md b/doc/administration/auditor_users.md
index daba5b4ca82..65d36612d85 100644
--- a/doc/administration/auditor_users.md
+++ b/doc/administration/auditor_users.md
@@ -52,7 +52,7 @@ section.
    **Admin Area > Users**. You will find the option of the access level under
    the 'Access' section.
 
-    ![Admin Area Form](auditor_access_form.png)
+    ![Admin Area Form](img/auditor_access_form.png)
 
 1. Click **Save changes** or **Create user** for the changes to take effect.
 
diff --git a/doc/administration/audit_log.png b/doc/administration/img/audit_log.png
similarity index 100%
rename from doc/administration/audit_log.png
rename to doc/administration/img/audit_log.png
diff --git a/doc/administration/auditor_access_form.png b/doc/administration/img/auditor_access_form.png
similarity index 100%
rename from doc/administration/auditor_access_form.png
rename to doc/administration/img/auditor_access_form.png

From 476f0955480eb67fe3c6e2a95137caf91a27b5d4 Mon Sep 17 00:00:00 2001
From: Nick Kipling <nkipling@gitlab.com>
Date: Tue, 9 Jul 2019 13:43:53 +0000
Subject: [PATCH 188/195] Implemented frontend suggestions

Converted storage details into a small partial
Reworded the storage details summary as suggested
Updated pot file
---
 app/helpers/storage_helper.rb                               | 2 +-
 app/views/admin/groups/show.html.haml                       | 6 +-----
 app/views/admin/projects/show.html.haml                     | 6 +-----
 app/views/shared/_storage_counter_statistics.html.haml      | 4 ++++
 ...ollow-up-from-add-packages_size-to-projectstatistics.yml | 5 +++++
 locale/gitlab.pot                                           | 6 +++---
 spec/features/admin/admin_sees_project_statistics_spec.rb   | 2 +-
 spec/helpers/storage_helper_spec.rb                         | 2 +-
 8 files changed, 17 insertions(+), 16 deletions(-)
 create mode 100644 app/views/shared/_storage_counter_statistics.html.haml
 create mode 100644 changelogs/unreleased/61284-frontend-follow-up-from-add-packages_size-to-projectstatistics.yml

diff --git a/app/helpers/storage_helper.rb b/app/helpers/storage_helper.rb
index ecf37bae6b3..ce810433a3a 100644
--- a/app/helpers/storage_helper.rb
+++ b/app/helpers/storage_helper.rb
@@ -17,6 +17,6 @@ module StorageHelper
       counter_lfs_objects: storage_counter(statistics.lfs_objects_size)
     }
 
-    _("%{counter_repositories} repositories, %{counter_wikis} wikis, %{counter_build_artifacts} build artifacts, %{counter_lfs_objects} LFS") % counters
+    _("Repository: %{counter_repositories} / Wikis: %{counter_wikis} / Build Artifacts: %{counter_build_artifacts} / LFS: %{counter_lfs_objects}") % counters
   end
 end
diff --git a/app/views/admin/groups/show.html.haml b/app/views/admin/groups/show.html.haml
index f524d35d79e..98230684d56 100644
--- a/app/views/admin/groups/show.html.haml
+++ b/app/views/admin/groups/show.html.haml
@@ -43,11 +43,7 @@
         = render_if_exists 'admin/namespace_plan_info', namespace: @group
 
         %li
-          %span.light= _('Storage:')
-          %strong= storage_counter(@group.storage_size)
-          (
-          = storage_counters_details(@group)
-          )
+          = render 'shared/storage_counter_statistics', storage_size: @group.storage_size, storage_details: @group
 
         %li
           %span.light= _('Group Git LFS status:')
diff --git a/app/views/admin/projects/show.html.haml b/app/views/admin/projects/show.html.haml
index e23accc1ea9..0fae8060b32 100644
--- a/app/views/admin/projects/show.html.haml
+++ b/app/views/admin/projects/show.html.haml
@@ -73,11 +73,7 @@
               = @project.repository.relative_path
 
           %li
-            %span.light= _('Storage:')
-            %strong= storage_counter(@project.statistics&.storage_size)
-            - if @project.statistics
-              = surround '(', ')' do
-                = storage_counters_details(@project.statistics)
+            = render 'shared/storage_counter_statistics', storage_size: @project.statistics&.storage_size, storage_details: @project.statistics
 
           %li
             %span.light last commit:
diff --git a/app/views/shared/_storage_counter_statistics.html.haml b/app/views/shared/_storage_counter_statistics.html.haml
new file mode 100644
index 00000000000..99b2323ca82
--- /dev/null
+++ b/app/views/shared/_storage_counter_statistics.html.haml
@@ -0,0 +1,4 @@
+%span.light= _('Storage:')
+%strong= storage_counter(storage_size)
+- if storage_details
+  (#{storage_counters_details(storage_details)})
diff --git a/changelogs/unreleased/61284-frontend-follow-up-from-add-packages_size-to-projectstatistics.yml b/changelogs/unreleased/61284-frontend-follow-up-from-add-packages_size-to-projectstatistics.yml
new file mode 100644
index 00000000000..3445057f7fb
--- /dev/null
+++ b/changelogs/unreleased/61284-frontend-follow-up-from-add-packages_size-to-projectstatistics.yml
@@ -0,0 +1,5 @@
+---
+title: Improved readability of storage statistics in group / project admin area
+merge_request: 30406
+author:
+type: other
diff --git a/locale/gitlab.pot b/locale/gitlab.pot
index f1cfb0ac06d..9b6e8d8c8a4 100644
--- a/locale/gitlab.pot
+++ b/locale/gitlab.pot
@@ -124,9 +124,6 @@ msgstr ""
 msgid "%{commit_author_link} authored %{commit_timeago}"
 msgstr ""
 
-msgid "%{counter_repositories} repositories, %{counter_wikis} wikis, %{counter_build_artifacts} build artifacts, %{counter_lfs_objects} LFS"
-msgstr ""
-
 msgid "%{count} more"
 msgstr ""
 
@@ -8877,6 +8874,9 @@ msgstr ""
 msgid "Repository storage"
 msgstr ""
 
+msgid "Repository: %{counter_repositories} / Wikis: %{counter_wikis} / Build Artifacts: %{counter_build_artifacts} / LFS: %{counter_lfs_objects}"
+msgstr ""
+
 msgid "Request Access"
 msgstr ""
 
diff --git a/spec/features/admin/admin_sees_project_statistics_spec.rb b/spec/features/admin/admin_sees_project_statistics_spec.rb
index b5323a1c76d..ecd0aab925b 100644
--- a/spec/features/admin/admin_sees_project_statistics_spec.rb
+++ b/spec/features/admin/admin_sees_project_statistics_spec.rb
@@ -15,7 +15,7 @@ describe "Admin > Admin sees project statistics" do
     let(:project) { create(:project, :repository) }
 
     it "shows project statistics" do
-      expect(page).to have_content("Storage: 0 Bytes (0 Bytes repositories, 0 Bytes wikis, 0 Bytes build artifacts, 0 Bytes LFS)")
+      expect(page).to have_content("Storage: 0 Bytes (Repository: 0 Bytes / Wikis: 0 Bytes / Build Artifacts: 0 Bytes / LFS: 0 Bytes)")
     end
   end
 
diff --git a/spec/helpers/storage_helper_spec.rb b/spec/helpers/storage_helper_spec.rb
index 62c00964524..4bd0fbb76ca 100644
--- a/spec/helpers/storage_helper_spec.rb
+++ b/spec/helpers/storage_helper_spec.rb
@@ -31,7 +31,7 @@ describe StorageHelper do
                                build_artifacts_size: 30.megabytes))
     end
 
-    let(:message) { '10 KB repositories, 10 Bytes wikis, 30 MB build artifacts, 20 GB LFS' }
+    let(:message) { 'Repository: 10 KB / Wikis: 10 Bytes / Build Artifacts: 30 MB / LFS: 20 GB' }
 
     it 'works on ProjectStatistics' do
       expect(helper.storage_counters_details(project.statistics)).to eq(message)

From 3084c37f3e1e5c1260fbc4a00082300ec0a7b0bd Mon Sep 17 00:00:00 2001
From: Stan Hu <stanhu@gmail.com>
Date: Tue, 9 Jul 2019 07:07:41 -0700
Subject: [PATCH 189/195] Perform more redactions in Redis performance bar
 traces

HMSET and AUTH commands were not properly redacted. This commit
does that and adds a test.

Closes https://gitlab.com/gitlab-org/gitlab-ce/issues/64309
---
 lib/peek/views/redis.rb                    |  8 +++--
 spec/lib/peek/views/redis_detailed_spec.rb | 36 ++++++++++++++++++++++
 2 files changed, 42 insertions(+), 2 deletions(-)
 create mode 100644 spec/lib/peek/views/redis_detailed_spec.rb

diff --git a/lib/peek/views/redis.rb b/lib/peek/views/redis.rb
index ad3c3c9fe01..73de8672fa4 100644
--- a/lib/peek/views/redis.rb
+++ b/lib/peek/views/redis.rb
@@ -37,6 +37,8 @@ end
 module Peek
   module Views
     module RedisDetailed
+      REDACTED_MARKER = "<redacted>"
+
       def results
         super.merge(details: details)
       end
@@ -57,10 +59,12 @@ module Peek
       end
 
       def format_command(cmd)
+        if cmd.length >= 2 && cmd.first =~ /^auth$/i
+          cmd[-1] = REDACTED_MARKER
         # Scrub out the value of the SET calls to avoid binary
         # data or large data from spilling into the view
-        if cmd.length >= 2 && cmd.first =~ /set/i
-          cmd[-1] = "<redacted>"
+        elsif cmd.length >= 3 && cmd.first =~ /set/i
+          cmd[2..-1] = REDACTED_MARKER
         end
 
         cmd.join(' ')
diff --git a/spec/lib/peek/views/redis_detailed_spec.rb b/spec/lib/peek/views/redis_detailed_spec.rb
new file mode 100644
index 00000000000..da13b6df53b
--- /dev/null
+++ b/spec/lib/peek/views/redis_detailed_spec.rb
@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Peek::Views::RedisDetailed do
+  let(:redis_detailed_class) do
+    Class.new do
+      include Peek::Views::RedisDetailed
+    end
+  end
+
+  subject { redis_detailed_class.new }
+
+  using RSpec::Parameterized::TableSyntax
+
+  where(:cmd, :expected) do
+    [:auth, 'test'] | 'auth <redacted>'
+    [:set, 'key', 'value'] | 'set key <redacted>'
+    [:set, 'bad'] | 'set bad'
+    [:hmset, 'key1', 'value1', 'key2', 'value2'] | 'hmset key1 <redacted>'
+    [:get, 'key'] | 'get key'
+  end
+
+  with_them do
+    it 'scrubs Redis commands', :request_store do
+      subject.detail_store << { cmd: cmd, duration: 1.second }
+
+      expect(subject.details.count).to eq(1)
+      expect(subject.details.first)
+        .to eq({
+                 cmd: expected,
+                 duration: 1000
+               })
+    end
+  end
+end

From bdbaebf87e95d513baaf9c3b735ba7420a1aa6aa Mon Sep 17 00:00:00 2001
From: Felipe Artur <fcardozo@gitlab.com>
Date: Tue, 9 Jul 2019 15:21:10 +0000
Subject: [PATCH 190/195] Skip spam check for task list updates

Task list updates should not mark users action as spam on akismet.
---
 app/services/issuable_base_service.rb       |  4 ++--
 app/services/issues/update_service.rb       |  4 ++--
 changelogs/unreleased/issue_64021.yml       |  5 +++++
 spec/services/issues/update_service_spec.rb | 16 ++++++++++++++++
 4 files changed, 25 insertions(+), 4 deletions(-)
 create mode 100644 changelogs/unreleased/issue_64021.yml

diff --git a/app/services/issuable_base_service.rb b/app/services/issuable_base_service.rb
index 02de080e0ba..db673cace81 100644
--- a/app/services/issuable_base_service.rb
+++ b/app/services/issuable_base_service.rb
@@ -182,7 +182,7 @@ class IssuableBaseService < BaseService
     # To be overridden by subclasses
   end
 
-  def before_update(issuable)
+  def before_update(issuable, skip_spam_check: false)
     # To be overridden by subclasses
   end
 
@@ -257,7 +257,7 @@ class IssuableBaseService < BaseService
                                               last_edited_at: Time.now,
                                               last_edited_by: current_user))
 
-      before_update(issuable)
+      before_update(issuable, skip_spam_check: true)
 
       if issuable.with_transaction_returning_status { issuable.save }
         # We do not touch as it will affect a update on updated_at field
diff --git a/app/services/issues/update_service.rb b/app/services/issues/update_service.rb
index 6b9f23f24cd..7cd825aa967 100644
--- a/app/services/issues/update_service.rb
+++ b/app/services/issues/update_service.rb
@@ -17,8 +17,8 @@ module Issues
       super
     end
 
-    def before_update(issue)
-      spam_check(issue, current_user)
+    def before_update(issue, skip_spam_check: false)
+      spam_check(issue, current_user) unless skip_spam_check
     end
 
     def handle_changes(issue, options)
diff --git a/changelogs/unreleased/issue_64021.yml b/changelogs/unreleased/issue_64021.yml
new file mode 100644
index 00000000000..088d9348619
--- /dev/null
+++ b/changelogs/unreleased/issue_64021.yml
@@ -0,0 +1,5 @@
+---
+title: Skip spam check for task list updates
+merge_request: 30279
+author:
+type: fixed
diff --git a/spec/services/issues/update_service_spec.rb b/spec/services/issues/update_service_spec.rb
index 28fa5d12d9c..468e7c286d5 100644
--- a/spec/services/issues/update_service_spec.rb
+++ b/spec/services/issues/update_service_spec.rb
@@ -480,6 +480,22 @@ describe Issues::UpdateService, :mailer do
           update_issue(description: "- [x] Task 1\n- [X] Task 2")
         end
 
+        it 'does not check for spam on task status change' do
+          params = {
+            update_task: {
+              index: 1,
+              checked: false,
+              line_source: '- [x] Task 1',
+              line_number: 1
+            }
+          }
+          service = described_class.new(project, user, params)
+
+          expect(service).not_to receive(:spam_check)
+
+          service.execute(issue)
+        end
+
         it 'creates system note about task status change' do
           note1 = find_note('marked the task **Task 1** as completed')
           note2 = find_note('marked the task **Task 2** as completed')

From 7d97102f72d6e85546cd317a96655ca3b20d34d2 Mon Sep 17 00:00:00 2001
From: Mark Lapierre <mlapierre@gitlab.com>
Date: Tue, 9 Jul 2019 15:40:46 +0000
Subject: [PATCH 191/195] Run tests in parallel via parallel_tests

Uses the parallel_tests gem to execute tests in multiple processes
simultaneously on the same machine.

Adds the `--parallel` CLI option that instructs the QA framework
to use the parallel_tests executable.

Tests need access to global state contained in `Runtime::Scenario`
so when `--parallel` is invoked `Runtime::Scenario` is serialized
to an environment variable, which is passed to parallel_tests,
and then deserialized in `spec_helper`.
---
 qa/.rspec_parallel                    |  5 ++
 qa/Gemfile                            |  2 +
 qa/Gemfile.lock                       |  6 +++
 qa/qa.rb                              |  1 +
 qa/qa/runtime/browser.rb              |  6 ++-
 qa/qa/runtime/env.rb                  |  8 +++
 qa/qa/runtime/scenario.rb             |  6 +++
 qa/qa/scenario/shared_attributes.rb   |  1 +
 qa/qa/specs/parallel_runner.rb        | 33 +++++++++++++
 qa/qa/specs/runner.rb                 | 70 ++++++++++++++++-----------
 qa/spec/page/logging_spec.rb          |  8 +--
 qa/spec/spec_helper.rb                |  4 ++
 qa/spec/specs/parallel_runner_spec.rb | 58 ++++++++++++++++++++++
 qa/spec/specs/runner_spec.rb          |  8 +--
 14 files changed, 178 insertions(+), 38 deletions(-)
 create mode 100644 qa/.rspec_parallel
 create mode 100644 qa/qa/specs/parallel_runner.rb
 create mode 100644 qa/spec/specs/parallel_runner_spec.rb

diff --git a/qa/.rspec_parallel b/qa/.rspec_parallel
new file mode 100644
index 00000000000..e5927927eaa
--- /dev/null
+++ b/qa/.rspec_parallel
@@ -0,0 +1,5 @@
+--color
+--format documentation
+--format ParallelTests::RSpec::SummaryLogger --out tmp/spec_summary.log
+--format ParallelTests::RSpec::RuntimeLogger --out tmp/parallel_runtime_rspec.log
+--require spec_helper
diff --git a/qa/Gemfile b/qa/Gemfile
index 12994b85322..c46be8a0362 100644
--- a/qa/Gemfile
+++ b/qa/Gemfile
@@ -1,5 +1,6 @@
 source 'https://rubygems.org'
 
+gem 'gitlab-qa'
 gem 'pry-byebug', '~> 3.5.1', platform: :mri
 gem 'capybara', '~> 2.16.1'
 gem 'capybara-screenshot', '~> 1.0.18'
@@ -11,3 +12,4 @@ gem 'nokogiri', '~> 1.10.3'
 gem 'rspec-retry', '~> 0.6.1'
 gem 'faker', '~> 1.6', '>= 1.6.6'
 gem 'knapsack', '~> 1.17'
+gem 'parallel_tests', '~> 2.29'
diff --git a/qa/Gemfile.lock b/qa/Gemfile.lock
index 6b0635ed0e2..73aabf2c6ad 100644
--- a/qa/Gemfile.lock
+++ b/qa/Gemfile.lock
@@ -35,6 +35,7 @@ GEM
     faker (1.9.3)
       i18n (>= 0.7)
     ffi (1.9.25)
+    gitlab-qa (4.0.0)
     http-cookie (1.0.3)
       domain_name (~> 0.5)
     i18n (0.9.1)
@@ -53,6 +54,9 @@ GEM
     netrc (0.11.0)
     nokogiri (1.10.3)
       mini_portile2 (~> 2.4.0)
+    parallel (1.17.0)
+    parallel_tests (2.29.0)
+      parallel
     pry (0.11.3)
       coderay (~> 1.1.0)
       method_source (~> 0.9.0)
@@ -104,8 +108,10 @@ DEPENDENCIES
   capybara (~> 2.16.1)
   capybara-screenshot (~> 1.0.18)
   faker (~> 1.6, >= 1.6.6)
+  gitlab-qa
   knapsack (~> 1.17)
   nokogiri (~> 1.10.3)
+  parallel_tests (~> 2.29)
   pry-byebug (~> 3.5.1)
   rake (~> 12.3.0)
   rspec (~> 3.7)
diff --git a/qa/qa.rb b/qa/qa.rb
index 10d44b6f6d9..be73776425b 100644
--- a/qa/qa.rb
+++ b/qa/qa.rb
@@ -360,6 +360,7 @@ module QA
   module Specs
     autoload :Config, 'qa/specs/config'
     autoload :Runner, 'qa/specs/runner'
+    autoload :ParallelRunner, 'qa/specs/parallel_runner'
 
     module Helpers
       autoload :Quarantine, 'qa/specs/helpers/quarantine'
diff --git a/qa/qa/runtime/browser.rb b/qa/qa/runtime/browser.rb
index ed0779b93cc..2987bb1a213 100644
--- a/qa/qa/runtime/browser.rb
+++ b/qa/qa/runtime/browser.rb
@@ -13,6 +13,8 @@ module QA
 
       NotRespondingError = Class.new(RuntimeError)
 
+      CAPYBARA_MAX_WAIT_TIME = 10
+
       def initialize
         self.class.configure!
       end
@@ -43,6 +45,8 @@ module QA
           end
         end
 
+        Capybara.server_port = 9887 + ENV['TEST_ENV_NUMBER'].to_i
+
         return if Capybara.drivers.include?(:chrome)
 
         Capybara.register_driver QA::Runtime::Env.browser do |app|
@@ -119,7 +123,7 @@ module QA
         Capybara.configure do |config|
           config.default_driver = QA::Runtime::Env.browser
           config.javascript_driver = QA::Runtime::Env.browser
-          config.default_max_wait_time = 10
+          config.default_max_wait_time = CAPYBARA_MAX_WAIT_TIME
           # https://github.com/mattheworiordan/capybara-screenshot/issues/164
           config.save_path = ::File.expand_path('../../tmp', __dir__)
         end
diff --git a/qa/qa/runtime/env.rb b/qa/qa/runtime/env.rb
index 96f337dc081..d50f618ff82 100644
--- a/qa/qa/runtime/env.rb
+++ b/qa/qa/runtime/env.rb
@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'gitlab/qa'
+
 module QA
   module Runtime
     module Env
@@ -7,6 +9,8 @@ module QA
 
       attr_writer :personal_access_token, :ldap_username, :ldap_password
 
+      ENV_VARIABLES = Gitlab::QA::Runtime::Env::ENV_VARIABLES
+
       # The environment variables used to indicate if the environment under test
       # supports the given feature
       SUPPORTED_FEATURES = {
@@ -201,6 +205,10 @@ module QA
         enabled?(ENV[SUPPORTED_FEATURES[feature]], default: true)
       end
 
+      def runtime_scenario_attributes
+        ENV['QA_RUNTIME_SCENARIO_ATTRIBUTES']
+      end
+
       private
 
       def remote_grid_credentials
diff --git a/qa/qa/runtime/scenario.rb b/qa/qa/runtime/scenario.rb
index 5067322804b..3662ebe671b 100644
--- a/qa/qa/runtime/scenario.rb
+++ b/qa/qa/runtime/scenario.rb
@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'json'
+
 module QA
   module Runtime
     ##
@@ -24,6 +26,10 @@ module QA
         end
       end
 
+      def from_env(var)
+        JSON.parse(Runtime::Env.runtime_scenario_attributes).each { |k, v| define(k, v) }
+      end
+
       def method_missing(name, *)
         raise ArgumentError, "Scenario attribute `#{name}` not defined!"
       end
diff --git a/qa/qa/scenario/shared_attributes.rb b/qa/qa/scenario/shared_attributes.rb
index 40d5c6b1ff1..52f50ec8c27 100644
--- a/qa/qa/scenario/shared_attributes.rb
+++ b/qa/qa/scenario/shared_attributes.rb
@@ -7,6 +7,7 @@ module QA
 
       attribute :gitlab_address, '--address URL', 'Address of the instance to test'
       attribute :enable_feature, '--enable-feature FEATURE_FLAG', 'Enable a feature before running tests'
+      attribute :parallel, '--parallel', 'Execute tests in parallel'
     end
   end
 end
diff --git a/qa/qa/specs/parallel_runner.rb b/qa/qa/specs/parallel_runner.rb
new file mode 100644
index 00000000000..b92fdb610b6
--- /dev/null
+++ b/qa/qa/specs/parallel_runner.rb
@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'open3'
+
+module QA
+  module Specs
+    module ParallelRunner
+      module_function
+
+      def run(args)
+        unless args.include?('--')
+          index = args.index { |opt| opt.include?('features') }
+
+          args.insert(index, '--') if index
+        end
+
+        env = {}
+        Runtime::Env::ENV_VARIABLES.each_key do |key|
+          env[key] = ENV[key] if ENV[key]
+        end
+        env['QA_RUNTIME_SCENARIO_ATTRIBUTES'] = Runtime::Scenario.attributes.to_json
+        env['GITLAB_QA_ACCESS_TOKEN'] = Runtime::API::Client.new(:gitlab).personal_access_token unless env['GITLAB_QA_ACCESS_TOKEN']
+
+        cmd = "bundle exec parallel_test -t rspec --combine-stderr --serialize-stdout -- #{args.flatten.join(' ')}"
+        ::Open3.popen2e(env, cmd) do |_, out, wait|
+          out.each { |line| puts line }
+
+          exit wait.value.exitstatus
+        end
+      end
+    end
+  end
+end
diff --git a/qa/qa/specs/runner.rb b/qa/qa/specs/runner.rb
index f1cb9378de8..6aa08cf77b4 100644
--- a/qa/qa/specs/runner.rb
+++ b/qa/qa/specs/runner.rb
@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
+require 'knapsack'
 require 'rspec/core'
 require 'rspec/expectations'
-require 'knapsack'
 
 module QA
   module Specs
@@ -17,44 +17,56 @@ module QA
         @options = []
       end
 
+      def paths_from_knapsack
+        allocator = Knapsack::AllocatorBuilder.new(Knapsack::Adapters::RSpecAdapter).allocator
+
+        QA::Runtime::Logger.info ''
+        QA::Runtime::Logger.info 'Report specs:'
+        QA::Runtime::Logger.info allocator.report_node_tests.join(', ')
+        QA::Runtime::Logger.info ''
+        QA::Runtime::Logger.info 'Leftover specs:'
+        QA::Runtime::Logger.info allocator.leftover_node_tests.join(', ')
+        QA::Runtime::Logger.info ''
+
+        ['--', allocator.node_tests]
+      end
+
+      def rspec_tags
+        tags_for_rspec = []
+
+        if tags.any?
+          tags.each { |tag| tags_for_rspec.push(['--tag', tag.to_s]) }
+        else
+          tags_for_rspec.push(%w[--tag ~orchestrated]) unless (%w[-t --tag] & options).any?
+        end
+
+        tags_for_rspec.push(%w[--tag ~skip_signup_disabled]) if QA::Runtime::Env.signup_disabled?
+
+        QA::Runtime::Env.supported_features.each_key do |key|
+          tags_for_rspec.push(%W[--tag ~requires_#{key}]) unless QA::Runtime::Env.can_test? key
+        end
+
+        tags_for_rspec
+      end
+
       def perform
         args = []
         args.push('--tty') if tty
-
-        if tags.any?
-          tags.each { |tag| args.push(['--tag', tag.to_s]) }
-        else
-          args.push(%w[--tag ~orchestrated]) unless (%w[-t --tag] & options).any?
-        end
-
-        args.push(%w[--tag ~skip_signup_disabled]) if QA::Runtime::Env.signup_disabled?
-
-        QA::Runtime::Env.supported_features.each_key do |key|
-          args.push(["--tag", "~requires_#{key}"]) unless QA::Runtime::Env.can_test? key
-        end
-
+        args.push(rspec_tags)
         args.push(options)
 
-        Runtime::Browser.configure!
-
         if Runtime::Env.knapsack?
-          allocator = Knapsack::AllocatorBuilder.new(Knapsack::Adapters::RSpecAdapter).allocator
-
-          QA::Runtime::Logger.info ''
-          QA::Runtime::Logger.info 'Report specs:'
-          QA::Runtime::Logger.info allocator.report_node_tests.join(', ')
-          QA::Runtime::Logger.info ''
-          QA::Runtime::Logger.info 'Leftover specs:'
-          QA::Runtime::Logger.info allocator.leftover_node_tests.join(', ')
-          QA::Runtime::Logger.info ''
-
-          args.push(['--', allocator.node_tests])
+          args.push(paths_from_knapsack)
         else
           args.push(DEFAULT_TEST_PATH_ARGS) unless options.any? { |opt| opt =~ %r{/features/} }
         end
 
-        RSpec::Core::Runner.run(args.flatten, $stderr, $stdout).tap do |status|
-          abort if status.nonzero?
+        if Runtime::Scenario.attributes[:parallel]
+          ParallelRunner.run(args.flatten)
+        else
+          RSpec::Core::Runner.run(args.flatten, $stderr, $stdout).tap do |status|
+            abort if status.nonzero?
+          end
         end
       end
     end
diff --git a/qa/spec/page/logging_spec.rb b/qa/spec/page/logging_spec.rb
index 0f1ed039149..92a4f7b40e6 100644
--- a/qa/spec/page/logging_spec.rb
+++ b/qa/spec/page/logging_spec.rb
@@ -91,26 +91,26 @@ describe QA::Support::Page::Logging do
 
   it 'logs has_element?' do
     expect { subject.has_element?(:element) }
-      .to output(/has_element\? :element \(wait: 2\) returned: true/).to_stdout_from_any_process
+      .to output(/has_element\? :element \(wait: #{QA::Runtime::Browser::CAPYBARA_MAX_WAIT_TIME}\) returned: true/).to_stdout_from_any_process
   end
 
   it 'logs has_element? with text' do
     expect { subject.has_element?(:element, text: "some text") }
-      .to output(/has_element\? :element with text \"some text\" \(wait: 2\) returned: true/).to_stdout_from_any_process
+      .to output(/has_element\? :element with text \"some text\" \(wait: #{QA::Runtime::Browser::CAPYBARA_MAX_WAIT_TIME}\) returned: true/).to_stdout_from_any_process
   end
 
   it 'logs has_no_element?' do
     allow(page).to receive(:has_no_css?).and_return(true)
 
     expect { subject.has_no_element?(:element) }
-      .to output(/has_no_element\? :element \(wait: 2\) returned: true/).to_stdout_from_any_process
+      .to output(/has_no_element\? :element \(wait: #{QA::Runtime::Browser::CAPYBARA_MAX_WAIT_TIME}\) returned: true/).to_stdout_from_any_process
   end
 
   it 'logs has_no_element? with text' do
     allow(page).to receive(:has_no_css?).and_return(true)
 
     expect { subject.has_no_element?(:element, text: "more text") }
-      .to output(/has_no_element\? :element with text \"more text\" \(wait: 2\) returned: true/).to_stdout_from_any_process
+      .to output(/has_no_element\? :element with text \"more text\" \(wait: #{QA::Runtime::Browser::CAPYBARA_MAX_WAIT_TIME}\) returned: true/).to_stdout_from_any_process
   end
 
   it 'logs has_text?' do
diff --git a/qa/spec/spec_helper.rb b/qa/spec/spec_helper.rb
index f25dbf3a8ab..21bfd2876a9 100644
--- a/qa/spec/spec_helper.rb
+++ b/qa/spec/spec_helper.rb
@@ -8,6 +8,10 @@ if ENV['CI'] && QA::Runtime::Env.knapsack? && !ENV['NO_KNAPSACK']
   Knapsack::Adapters::RSpecAdapter.bind
 end
 
+QA::Runtime::Browser.configure!
+
+QA::Runtime::Scenario.from_env(QA::Runtime::Env.runtime_scenario_attributes) if QA::Runtime::Env.runtime_scenario_attributes
+
 %w[helpers shared_examples].each do |d|
   Dir[::File.join(__dir__, d, '**', '*.rb')].each { |f| require f }
 end
diff --git a/qa/spec/specs/parallel_runner_spec.rb b/qa/spec/specs/parallel_runner_spec.rb
new file mode 100644
index 00000000000..67d94a1f648
--- /dev/null
+++ b/qa/spec/specs/parallel_runner_spec.rb
@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+describe QA::Specs::ParallelRunner do
+  include Helpers::StubENV
+
+  before do
+    allow(QA::Runtime::Scenario).to receive(:attributes).and_return(parallel: true)
+    stub_env('GITLAB_QA_ACCESS_TOKEN', 'skip_token_creation')
+  end
+
+  it 'passes args to parallel_tests' do
+    expect_cli_arguments(['--tag', '~orchestrated', *QA::Specs::Runner::DEFAULT_TEST_PATH_ARGS])
+
+    subject.run(['--tag', '~orchestrated', *QA::Specs::Runner::DEFAULT_TEST_PATH_ARGS])
+  end
+
+  it 'passes a given test path to parallel_tests and adds a separator' do
+    expect_cli_arguments(%w[-- qa/specs/features/foo])
+
+    subject.run(%w[qa/specs/features/foo])
+  end
+
+  it 'passes tags and test paths to parallel_tests and adds a separator' do
+    expect_cli_arguments(%w[--tag smoke -- qa/specs/features/foo qa/specs/features/bar])
+
+    subject.run(%w[--tag smoke qa/specs/features/foo qa/specs/features/bar])
+  end
+
+  it 'passes tags and test paths with separators to parallel_tests' do
+    expect_cli_arguments(%w[-- --tag smoke -- qa/specs/features/foo qa/specs/features/bar])
+
+    subject.run(%w[-- --tag smoke -- qa/specs/features/foo qa/specs/features/bar])
+  end
+
+  it 'passes supported environment variables' do
+    # Test only env vars starting with GITLAB because some of the others
+    # affect how the runner behaves, and we're not concerned with those
+    # behaviors in this test
+    gitlab_env_vars = QA::Runtime::Env::ENV_VARIABLES.reject { |v| !v.start_with?('GITLAB') }
+
+    gitlab_env_vars.each do |k, v|
+      stub_env(k, v)
+    end
+
+    gitlab_env_vars['QA_RUNTIME_SCENARIO_ATTRIBUTES'] = '{"parallel":true}'
+
+    expect_cli_arguments([], gitlab_env_vars)
+
+    subject.run([])
+  end
+
+  def expect_cli_arguments(arguments, env = { 'QA_RUNTIME_SCENARIO_ATTRIBUTES' => '{"parallel":true}' })
+    cmd = "bundle exec parallel_test -t rspec --combine-stderr --serialize-stdout -- #{arguments.join(' ')}"
+    expect(Open3).to receive(:popen2e)
+      .with(hash_including(env), cmd)
+      .and_return(0)
+  end
+end
diff --git a/qa/spec/specs/runner_spec.rb b/qa/spec/specs/runner_spec.rb
index f94145d148e..6c533c6dc7d 100644
--- a/qa/spec/specs/runner_spec.rb
+++ b/qa/spec/specs/runner_spec.rb
@@ -58,11 +58,11 @@ describe QA::Specs::Runner do
       end
     end
 
-    context 'when "-- qa/specs/features/foo" is set as options' do
-      subject { described_class.new.tap { |runner| runner.options = %w[-- qa/specs/features/foo] } }
+    context 'when "--tag smoke" and "qa/specs/features/foo" are set as options' do
+      subject { described_class.new.tap { |runner| runner.options = %w[--tag smoke qa/specs/features/foo] } }
 
-      it 'passes the given tests path and excludes the orchestrated tag' do
-        expect_rspec_runner_arguments(['--tag', '~orchestrated', '--', 'qa/specs/features/foo'])
+      it 'focuses on the given tag and includes the path without excluding the orchestrated tag' do
+        expect_rspec_runner_arguments(['--tag', 'smoke', 'qa/specs/features/foo'])
 
         subject.perform
       end

From 00369eba01cb796b2affaf4592de3c439ab1addc Mon Sep 17 00:00:00 2001
From: Steve Abrams <sabrams@gitlab.com>
Date: Tue, 9 Jul 2019 15:42:13 +0000
Subject: [PATCH 192/195] NPM Registry docs new package naming convention

The documentation is updated to include details on the new
limitations and rules to naming NPM packages. A note is included
on how naming collisions are handled.
---
 doc/user/project/packages/npm_registry.md | 15 ++++++++-------
 1 file changed, 8 insertions(+), 7 deletions(-)

diff --git a/doc/user/project/packages/npm_registry.md b/doc/user/project/packages/npm_registry.md
index b2cfe10836f..481b1ce0337 100644
--- a/doc/user/project/packages/npm_registry.md
+++ b/doc/user/project/packages/npm_registry.md
@@ -11,11 +11,6 @@ project can have its own space to store NPM packages.
 NOTE: **Note:**
 Only [scoped](https://docs.npmjs.com/misc/scope) packages are supported.
 
-
-NOTE: **Note:**
-As `@group/subgroup/project` is not a valid NPM package name, publishing a package 
-within a subgroup is not supported yet. 
-
 ## Enabling the NPM Registry
 
 NOTE: **Note:**
@@ -36,12 +31,15 @@ get familiar with the package naming convention.
 
 ## Package naming convention
 
-**Only packages that have the same path as the project** are supported. For
- example:
+**Packages must be scoped in the root namespace of the project**. The package
+name may be anything but it is preferred that the project name be used unless
+it is not possible due to a naming collision. For example:
 
 | Project                | Package                 | Supported |
 | ---------------------- | ----------------------- | --------- |
 | `foo/bar`              | `@foo/bar`              | Yes       |
+| `foo/bar/baz`          | `@foo/baz`              | Yes       |
+| `foo/bar/buz`          | `@foo/anything`         | Yes       |
 | `gitlab-org/gitlab-ce` | `@gitlab-org/gitlab-ce` | Yes       |
 | `gitlab-org/gitlab-ce` | `@foo/bar`              | No        |
 
@@ -113,6 +111,9 @@ npm publish
 You can then navigate to your project's **Packages** page and see the uploaded
 packages or even delete them.
 
+If you attempt to publish a package with a name that already exists within
+a given scope, you will receive a `403 Forbidden!` error.
+
 ## Uploading a package with the same version twice
 
 If you upload a package with a same name and version twice, GitLab will show

From 4d8f28f6e9b192b6a9f64a62c3f33d62354e3848 Mon Sep 17 00:00:00 2001
From: Maikel <maikel@mediamoose.nl>
Date: Thu, 6 Jun 2019 11:12:12 +0000
Subject: [PATCH 193/195] Document the negative commit message push rule for
 the API.

---
 doc/api/projects.md | 51 ++++++++++++++++++++++++---------------------
 1 file changed, 27 insertions(+), 24 deletions(-)

diff --git a/doc/api/projects.md b/doc/api/projects.md
index da05b090699..6468d73e0af 100644
--- a/doc/api/projects.md
+++ b/doc/api/projects.md
@@ -1631,6 +1631,7 @@ GET /projects/:id/push_rule
   "id": 1,
   "project_id": 3,
   "commit_message_regex": "Fixes \d+\..*",
+  "commit_message_negative_regex": "ssh\:\/\/",
   "branch_name_regex": "",
   "deny_delete_tag": false,
   "created_at": "2012-10-12T17:04:47Z",
@@ -1663,18 +1664,19 @@ Adds a push rule to a specified project.
 POST /projects/:id/push_rule
 ```
 
-| Attribute                              | Type           | Required | Description |
-| -------------------------------------- | -------------- | -------- | ----------- |
-| `id`                                   | integer/string | yes      | The ID of the project or NAMESPACE/PROJECT_NAME |
-| `deny_delete_tag` **(STARTER)**        | boolean        | no       | Deny deleting a tag |
-| `member_check` **(STARTER)**           | boolean        | no       | Restrict commits by author (email) to existing GitLab users |
-| `prevent_secrets` **(STARTER)**        | boolean        | no       | GitLab will reject any files that are likely to contain secrets |
-| `commit_message_regex` **(STARTER)**   | string         | no       | All commit messages must match this, e.g. `Fixed \d+\..*` |
-| `branch_name_regex` **(STARTER)**      | string         | no       | All branch names must match this, e.g. `(feature|hotfix)\/*` |
-| `author_email_regex` **(STARTER)**     | string         | no       | All commit author emails must match this, e.g. `@my-company.com$` |
-| `file_name_regex` **(STARTER)**        | string         | no       | All commited filenames must **not** match this, e.g. `(jar|exe)$` |
-| `max_file_size` **(STARTER)**          | integer        | no       | Maximum file size (MB) |
-| `commit_committer_check` **(PREMIUM)** | boolean        | no       | Users can only push commits to this repository that were committed with one of their own verified emails. |
+| Attribute                                     | Type           | Required | Description |
+| --------------------------------------------- | -------------- | -------- | ----------- |
+| `id`                                          | integer/string | yes      | The ID of the project or NAMESPACE/PROJECT_NAME |
+| `deny_delete_tag` **(STARTER)**               | boolean        | no       | Deny deleting a tag |
+| `member_check` **(STARTER)**                  | boolean        | no       | Restrict commits by author (email) to existing GitLab users |
+| `prevent_secrets` **(STARTER)**               | boolean        | no       | GitLab will reject any files that are likely to contain secrets |
+| `commit_message_regex` **(STARTER)**          | string         | no       | All commit messages must match this, e.g. `Fixed \d+\..*` |
+| `commit_message_negative_regex` **(STARTER)** | string         | no       | No commit message is allowed to match this, e.g. `ssh\:\/\/` |
+| `branch_name_regex` **(STARTER)**             | string         | no       | All branch names must match this, e.g. `(feature|hotfix)\/*` |
+| `author_email_regex` **(STARTER)**            | string         | no       | All commit author emails must match this, e.g. `@my-company.com$` |
+| `file_name_regex` **(STARTER)**               | string         | no       | All commited filenames must **not** match this, e.g. `(jar|exe)$` |
+| `max_file_size` **(STARTER)**                 | integer        | no       | Maximum file size (MB) |
+| `commit_committer_check` **(PREMIUM)**        | boolean        | no       | Users can only push commits to this repository that were committed with one of their own verified emails. |
 
 ### Edit project push rule
 
@@ -1684,18 +1686,19 @@ Edits a push rule for a specified project.
 PUT /projects/:id/push_rule
 ```
 
-| Attribute                              | Type           | Required | Description |
-| -------------------------------------- | -------------- | -------- | ----------- |
-| `id`                                   | integer/string | yes      | The ID of the project or NAMESPACE/PROJECT_NAME |
-| `deny_delete_tag` **(STARTER)**        | boolean        | no       | Deny deleting a tag |
-| `member_check` **(STARTER)**           | boolean        | no       | Restrict commits by author (email) to existing GitLab users |
-| `prevent_secrets` **(STARTER)**        | boolean        | no       | GitLab will reject any files that are likely to contain secrets |
-| `commit_message_regex` **(STARTER)**   | string         | no       | All commit messages must match this, e.g. `Fixed \d+\..*` |
-| `branch_name_regex` **(STARTER)**      | string         | no       | All branch names must match this, e.g. `(feature|hotfix)\/*` |
-| `author_email_regex` **(STARTER)**     | string         | no       | All commit author emails must match this, e.g. `@my-company.com$` |
-| `file_name_regex` **(STARTER)**        | string         | no       | All commited filenames must **not** match this, e.g. `(jar|exe)$` |
-| `max_file_size` **(STARTER)**          | integer        | no       | Maximum file size (MB) |
-| `commit_committer_check` **(PREMIUM)** | boolean        | no       | Users can only push commits to this repository that were committed with one of their own verified emails. |
+| Attribute                                     | Type           | Required | Description |
+| --------------------------------------------- | -------------- | -------- | ----------- |
+| `id`                                          | integer/string | yes      | The ID of the project or NAMESPACE/PROJECT_NAME |
+| `deny_delete_tag` **(STARTER)**               | boolean        | no       | Deny deleting a tag |
+| `member_check` **(STARTER)**                  | boolean        | no       | Restrict commits by author (email) to existing GitLab users |
+| `prevent_secrets` **(STARTER)**               | boolean        | no       | GitLab will reject any files that are likely to contain secrets |
+| `commit_message_regex` **(STARTER)**          | string         | no       | All commit messages must match this, e.g. `Fixed \d+\..*` |
+| `commit_message_negative_regex` **(STARTER)** | string         | no       | No commit message is allowed to match this, e.g. `ssh\:\/\/` |
+| `branch_name_regex` **(STARTER)**             | string         | no       | All branch names must match this, e.g. `(feature|hotfix)\/*` |
+| `author_email_regex` **(STARTER)**            | string         | no       | All commit author emails must match this, e.g. `@my-company.com$` |
+| `file_name_regex` **(STARTER)**               | string         | no       | All commited filenames must **not** match this, e.g. `(jar|exe)$` |
+| `max_file_size` **(STARTER)**                 | integer        | no       | Maximum file size (MB) |
+| `commit_committer_check` **(PREMIUM)**        | boolean        | no       | Users can only push commits to this repository that were committed with one of their own verified emails. |
 
 ### Delete project push rule
 

From b6f7ad238a165f6ac6704f1d44d5471fd551e89a Mon Sep 17 00:00:00 2001
From: Maikel <maikel@mediamoose.nl>
Date: Thu, 6 Jun 2019 11:28:39 +0000
Subject: [PATCH 194/195] Add the changelog entry.

---
 .../unreleased/api-doc-negative-commit-message-push-rule.yml | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 changelogs/unreleased/api-doc-negative-commit-message-push-rule.yml

diff --git a/changelogs/unreleased/api-doc-negative-commit-message-push-rule.yml b/changelogs/unreleased/api-doc-negative-commit-message-push-rule.yml
new file mode 100644
index 00000000000..0500978a2e1
--- /dev/null
+++ b/changelogs/unreleased/api-doc-negative-commit-message-push-rule.yml
@@ -0,0 +1,5 @@
+---
+title: "Document the negative commit message push rule for the API."
+merge_request: 14004
+author: Maikel Vlasman
+type: added

From a215c8ece97e5a9f83c7d829a99c4225420bba78 Mon Sep 17 00:00:00 2001
From: Michael Leopard <mleopard@gitlab.com>
Date: Tue, 9 Jul 2019 16:06:48 +0000
Subject: [PATCH 195/195] Resolve "Update project import/export docs to include
 what exactly is imported/exported"

---
 doc/user/project/settings/import_export.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/user/project/settings/import_export.md b/doc/user/project/settings/import_export.md
index 819515d7a4c..98bcc7cc09f 100644
--- a/doc/user/project/settings/import_export.md
+++ b/doc/user/project/settings/import_export.md
@@ -74,6 +74,13 @@ The following items will NOT be exported:
 - CI variables
 - Webhooks
 - Any encrypted tokens
+- Merge Request Approvers
+- Push Rules
+- Awards
+
+NOTE: **Note:**
+For more details on the specific data persisted in a project export, see the 
+[`import_export.yml`](https://gitlab.com/gitlab-org/gitlab-ee/blob/master/lib/gitlab/import_export/import_export.yml) file.
 
 ## Exporting a project and its data