Remove extra blank lines from docs

Removing extra blank lines in docs that serve
no purpose, as well as some --- lines that also
are not needed.

doc/administration/geo/replication/external_database.md

@@ -25,7 +25,6 @@ developed and tested. We aim to be compatible with most external
    This command will use your defined `external_url` in `/etc/gitlab/gitlab.rb`.
-
 ### Configure the external database to be replicated
 To set up an external database, you can either:

doc/administration/housekeeping.md

@@ -2,7 +2,6 @@
 > [Introduced][ce-2371] in GitLab 8.4.
----
 ## Automatic housekeeping
 GitLab automatically runs `git gc` and `git repack` on repositories
@@ -32,8 +31,6 @@ the `pushes_since_gc` value is 200 a `git gc` will be run.
 You can find this option under your project's **Settings > General > Advanced**.
----
-
 ![Housekeeping settings](img/housekeeping_settings.png)
 [ce-2371]: https://gitlab.com/gitlab-org/gitlab-ce/merge_requests/2371 "Housekeeping merge request"

doc/administration/job_artifacts.md

@@ -13,8 +13,6 @@ if you want to know how to disable it.
 To disable artifacts site-wide, follow the steps below.
----
-
 **In Omnibus installations:**
 1. Edit `/etc/gitlab/gitlab.rb` and add the following line:
@@ -25,8 +23,6 @@ To disable artifacts site-wide, follow the steps below.
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
----
-
 **In installations from source:**
 1. Edit `/home/git/gitlab/config/gitlab.yml` and add or amend the following lines:
@@ -49,8 +45,6 @@ this is done when the job succeeds, but can also be done on failure, or always,
 To change the location where the artifacts are stored locally, follow the steps
 below.
----
-
 **In Omnibus installations:**
 _The artifacts are stored by default in
@@ -65,8 +59,6 @@ _The artifacts are stored by default in
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
----
-
 **In installations from source:**
 _The artifacts are stored by default in
@@ -167,8 +159,6 @@ _The artifacts are stored by default in
    gitlab-rake gitlab:artifacts:migrate
    ```
----
-
 **In installations from source:**
 _The artifacts are stored by default in
@@ -207,8 +197,6 @@ right after that date passes. Artifacts are cleaned up by the
 To change the default schedule on which the artifacts are expired, follow the
 steps below.
----
-
 **In Omnibus installations:**
 1. Edit `/etc/gitlab/gitlab.rb` and comment out or add the following line
@@ -219,8 +207,6 @@ steps below.
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
----
-
 **In installations from source:**
 1. Edit `/home/git/gitlab/config/gitlab.yml` and add or amend the following
@@ -240,8 +226,6 @@ steps below.
 To disable [the dependencies validation](../ci/yaml/README.md#when-a-dependent-job-will-fail),
 you can flip the feature flag from a Rails console.
----
-
 **In Omnibus installations:**
 1. Enter the Rails console:
@@ -256,8 +240,6 @@ you can flip the feature flag from a Rails console.
    Feature.enable('ci_disable_validates_dependencies')
    ```
----
-
 **In installations from source:**
 1. Enter the Rails console:

doc/administration/monitoring/performance/gitlab_configuration.md

@@ -8,12 +8,8 @@ The minimum required settings you need to set are the InfluxDB host and port.
 Make sure _Enable InfluxDB Metrics_ is checked and hit **Save** to save the
 changes.
----
-
 ![GitLab Performance Monitoring Admin Settings](img/metrics_gitlab_configuration_settings.png)
----
-
 Finally, a restart of all GitLab processes is required for the changes to take
 effect:
@@ -30,8 +26,6 @@ sudo service gitlab restart
 When any migrations are pending, the metrics are disabled until the migrations
 have been performed.
----
-
 Read more on:
 - [Introduction to GitLab Performance Monitoring](introduction.md)

doc/administration/monitoring/performance/performance_bar.md

@@ -40,10 +40,6 @@ display it.
 You can toggle the Bar using the same shortcut.
----
-
 ![GitLab Performance Bar Admin Settings](img/performance_bar_configuration_settings.png)
----
-
 [Gitaly]: ../../gitaly/index.md

doc/administration/repository_storage_paths.md

@@ -55,8 +55,6 @@ storage2:
 > don't specify the full repository path but the parent path), but not for source
 > installations.
----
-
 Now that you've read that big fat warning above, let's edit the configuration
 files and add the full paths of the alternative repository storage paths. In
 the example below, we add two more mountpoints that are named `nfs` and `cephfs`
@@ -90,8 +88,6 @@ are upgrading from a version prior to 8.10, make sure to add the configuration
 as described in the step above. After you make the changes and confirm they are
 working, you can remove the `repos_path` line.
----
-
 **For Omnibus installations**
 1. Edit `/etc/gitlab/gitlab.rb` by appending the rest of the paths to the

doc/administration/uploads.md

@@ -10,8 +10,6 @@ This is the default configuration
 To change the location where the uploads are stored locally, follow the steps
 below.
----
-
 **In Omnibus installations:**
 NOTE: **Note:**
@@ -29,8 +27,6 @@ _The uploads are stored by default in `/var/opt/gitlab/gitlab-rails/uploads`._
 1. Save the file and [reconfigure GitLab][] for the changes to take effect.
----
-
 **In installations from source:**
 _The uploads are stored by default in
@@ -121,8 +117,6 @@ _The uploads are stored by default in
 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).
----
-
 **In installations from source:**
 _The uploads are stored by default in

doc/api/README.md

@@ -321,8 +321,6 @@ By default, impersonation is enabled. To disable impersonation:
 To re-enable impersonation, remove this configuration and reconfigure GitLab.
----
-
 **For installations from source**
 1. Edit `config/gitlab.yml`:
@@ -381,8 +379,6 @@ returned with status code `404`:
 }
 ```
----
-
 Example of a valid API call and a request using cURL with sudo request,
 providing a username:

doc/api/issues.md

@@ -357,7 +357,6 @@ GET /projects/:id/issues?confidential=true
 | `updated_before`    | datetime         | no         | Return issues updated on or before the given time                                                                             |
 | `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
 ```

doc/api/system_hooks.md

@@ -11,8 +11,6 @@ Read more about [system hooks](../system_hooks/system_hooks.md).
 Get a list of all system hooks.
----
-
 ```
 GET /hooks
 ```
@@ -44,8 +42,6 @@ Example response:
 Add a new system hook.
----
-
 ```
 POST /hooks
 ```
@@ -116,8 +112,6 @@ Example response:
 Deletes a system hook.
----
-
 ```
 DELETE /hooks/:id
 ```
@@ -130,4 +124,4 @@ Example request:
 ```bash
 curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/hooks/2
-```
\ No newline at end of file
+```

doc/development/fe_guide/index.md

@@ -17,8 +17,6 @@ Working with our frontend assets requires Node (v8.10.0 or greater) and Yarn
 For our currently-supported browsers, see our [requirements][requirements].
----
-
 ## Initiatives
 Current high-level frontend goals are listed on [Frontend Epics](https://gitlab.com/groups/gitlab-org/-/epics?label_name%5B%5D=frontend).
@@ -77,8 +75,6 @@ How we use Snowplow to track custom events.
 Read the [frontend's FAQ](frontend_faq.md) for common small pieces of helpful information.
----
-
 ## Style Guides
 ### [JavaScript Style Guide](style_guide_js.md)
@@ -91,20 +87,14 @@ changes.
 Our SCSS conventions which are enforced through [scss-lint][scss-lint].
----
-
 ## [Performance](performance.md)
 Best practices for monitoring and maximizing frontend performance.
----
-
 ## [Security](security.md)
 Frontend security practices.
----
-
 ## [Accessibility](accessibility.md)
 Our accessibility standards and resources.

doc/development/new_fe_guide/index.md

@@ -19,7 +19,6 @@ Learn about all the internal JavaScript modules that make up our frontend.
 Style guides to keep our code consistent.
-
 ## [Tips](tips.md)
 Tips from our frontend team to develop more efficiently and effectively.

doc/development/testing_guide/index.md

@@ -22,62 +22,44 @@ automated testing means, and what are its principles:
 - [Five Factor Testing](https://www.devmynd.com/blog/five-factor-testing): Why do we need tests?
 - [Principles of Automated Testing](http://www.lihaoyi.com/post/PrinciplesofAutomatedTesting.html): Levels of testing. Prioritize tests. Cost of tests.
----
-
 ## [Testing levels](testing_levels.md)
 Learn about the different testing levels, and how to decide at what level your
 changes should be tested.
----
-
 ## [Testing best practices](best_practices.md)
 Everything you should know about how to write good tests: Test Design, RSpec, FactoryBot,
 system tests, parameterized tests etc.
----
-
 ## [Frontend testing standards and style guidelines](frontend_testing.md)
 Everything you should know about how to write good Frontend tests: Karma,
 testing promises, stubbing etc.
----
-
 ## [Flaky tests](flaky_tests.md)
 What are flaky tests, the different kind of flaky tests we encountered, and what
 we do about them.
----
-
 ## [GitLab tests in the Continuous Integration (CI) context](ci.md)
 How GitLab test suite is run in the CI context: setup, caches, artifacts,
 parallelization, monitoring.
----
-
 ## [Review apps](review_apps.md)
 How review apps are set up for GitLab CE/EE and how to use them.
----
-
 ## [Testing Rake tasks](testing_rake_tasks.md)
 Everything you should know about how to test Rake tasks.
----
-
 ## [End-to-end tests](end_to_end/index.md)
 Everything you should know about how to run end-to-end tests using
 [GitLab QA][gitlab-qa] testing framework.
----
-
 [Return to Development documentation](../README.md)
 [RSpec]: https://github.com/rspec/rspec-rails#feature-specs

doc/integration/oauth_provider.md

@@ -25,8 +25,6 @@ can be used for authentication to your GitLab instance
 The 'GitLab Importer' feature is also using the OAuth protocol to give access
 to repositories without sharing user credentials to your GitLab.com account.
----
-
 GitLab supports two ways of adding a new OAuth2 application to an instance. You
 can either add an application as a regular user or add it in the admin area.
 What this means is that GitLab can actually have instance-wide and a user-wide
@@ -41,24 +39,18 @@ In order to add a new application via your profile, navigate to
 ![New OAuth application](img/oauth_provider_user_wide_applications.png)
----
-
 In the application form, enter a **Name** (arbitrary), and make sure to set up
 correctly the **Redirect URI** which is the URL where users will be sent after
 they authorize with GitLab.
 ![New OAuth application form](img/oauth_provider_application_form.png)
----
-
 When you hit **Submit** you will be provided with the application ID and
 the application secret which you can then use with your application that
 connects to GitLab.
 ![OAuth application ID and secret](img/oauth_provider_application_id_secret.png)
----
-
 ## OAuth applications in the admin area
 To create an application that does not belong to a certain user, you can create
@@ -69,8 +61,6 @@ it from the admin area.
 You're also able to mark an application as _trusted_ when creating it through the admin area. By doing that,
 the user authorization step is automatically skipped for this application.
----
-
 ## Authorized applications
 Every application you authorized to use your GitLab credentials will be shown
@@ -78,8 +68,6 @@ in the **Authorized applications** section under **Profile Settings > Applicatio
 ![Authorized_applications](img/oauth_provider_authorized_application.png)
----
-
 GitLab's OAuth applications support scopes, which allow various actions that any given
 application can perform such as `read_user` and `api`. There are many more scopes
 available.

doc/raketasks/backup_restore.md

@@ -315,8 +315,6 @@ if you see `411 Length Required` errors after attempting to upload, you may
 need to downgrade the `aws_signature_version` value from the default value to
 2 [due to this issue](https://github.com/fog/fog-aws/issues/428).
----
-
 For installations from source:
 1. Edit `home/git/gitlab/config/gitlab.yml`:
@@ -428,8 +426,6 @@ For Omnibus GitLab packages:
 1. [Reconfigure GitLab] for the changes to take effect
----
-
 For installations from source:
 1. Edit `home/git/gitlab/config/gitlab.yml`:
@@ -490,8 +486,6 @@ For Omnibus GitLab packages:
 1. [Reconfigure GitLab] for the changes to take effect.
----
-
 For installations from source:
 1. Edit `home/git/gitlab/config/gitlab.yml`:
@@ -527,8 +521,6 @@ For Omnibus GitLab packages:
 1. [Reconfigure GitLab] for the changes to take effect.
----
-
 For installations from source:
 1. Edit `/home/git/gitlab/config/gitlab.yml`:
@@ -580,8 +572,6 @@ There, add the following line to schedule the backup for everyday at 2 AM:
 You may also want to set a limited lifetime for backups to prevent regular
 backups using all your disk space.
----
-
 For installations from source:
 1. Edit `home/git/gitlab/config/gitlab.yml`:
@@ -815,6 +805,7 @@ will have all your repositories, but not any other data.
 ## Troubleshooting
 ### Restoring database backup using omnibus packages outputs warnings
+
 If you are using backup restore procedures you might encounter the following warnings:
 ```

doc/security/unlock_user.md

 ---
 type: howto
 ---
+
 # How to unlock a locked user
 To unlock a locked user, first log into your server with root privileges.
 Start a Ruby on Rails console with this command:
-
 ```bash
 gitlab-rails console production
 ```

doc/topics/autodevops/index.md

@@ -109,10 +109,10 @@ To make full use of Auto DevOps, you will need:
    To enable deployments, you will need Kubernetes 1.5+. You need a [Kubernetes cluster][kubernetes-clusters]
    for the project, or a Kubernetes [default service template](../../user/project/integrations/services_templates.md)
    for the entire GitLab installation.
-    1. **A load balancer** - You can use NGINX ingress by deploying it to your
-       Kubernetes cluster using the
-       [`nginx-ingress`](https://github.com/kubernetes/charts/tree/master/stable/nginx-ingress)
-       Helm chart.
+   1. **A load balancer** - You can use NGINX ingress by deploying it to your
+      Kubernetes cluster using the
+      [`nginx-ingress`](https://github.com/kubernetes/charts/tree/master/stable/nginx-ingress)
+      Helm chart.
 1. **Prometheus** (needed for Auto Monitoring) - To enable Auto Monitoring, you
    will need Prometheus installed somewhere (inside or outside your cluster) and
    configured to scrape your Kubernetes cluster. To get response metrics
@@ -168,7 +168,6 @@ From GitLab 11.8, `KUBE_INGRESS_BASE_DOMAIN` replaces `AUTO_DEVOPS_DOMAIN`.
 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)**
 When using Auto DevOps, you may want to deploy different environments to
@@ -202,7 +201,7 @@ To add a different cluster for each environment:
 1. Navigate to your project's **Operations > Kubernetes** and create the Kubernetes clusters
    with their respective environment scope as described from the table above.
-    ![Auto DevOps multiple clusters](img/autodevops_multiple_clusters.png)
+   ![Auto DevOps multiple clusters](img/autodevops_multiple_clusters.png)
 1. After the clusters are created, navigate to each one and install Helm Tiller
    and Ingress. Wait for the Ingress IP address to be assigned.

doc/user/application_security/license_management/index.md

@@ -196,11 +196,12 @@ To approve or blacklist a license:
 1. Click the **Add a license** button.
    ![License Management Add License](img/license_management_add_license.png)
+
 1. In the **License name** dropdown, either:
-    - Select one of the available licenses. You can search for licenses in the field
-   at the top of the list.
-    - Enter arbitrary text in the field at the top of the list. This will cause the text to be
-    added as a license name to the list.
+   - Select one of the available licenses. You can search for licenses in the field
+     at the top of the list.
+   - Enter arbitrary text in the field at the top of the list. This will cause the text to be
+     added as a license name to the list.
 1. Select the **Approve** or **Blacklist** radio button to approve or blacklist respectively
    the selected license.

doc/user/project/issues/csv_export.md

@@ -48,7 +48,6 @@ Exported issues are always sorted by `Issue ID`.
 Data will be encoded with a comma as the column delimiter, with `"` used to quote fields if needed, and newlines to separate rows. The first row will be the headers, which are listed in the following table along with a description of the values:
-
 | Column  | Description |
 |---------|-------------|
 | Issue ID | Issue `iid` |
@@ -71,7 +70,6 @@ Data will be encoded with a comma as the column delimiter, with `"` used to quot
 | Time Estimate | [Time estimate](../../../workflow/time_tracking.md#estimates) in seconds |
 | Time Spent | [Time spent](../../../workflow/time_tracking.md#time-spent) in seconds |
-
 ## Limitations
 As the issues will be sent as an email attachment, there is a limit on how much data can be exported. Currently this limit is 20MB to ensure successful delivery across a range of email providers. If this limit is reached we suggest narrowing the search before export, perhaps by exporting open and closed issues separately.

doc/user/project/members/index.md

@@ -10,8 +10,6 @@ or import a new user to your project.
 To view, edit, add, and remove project's members, go to your
 project's **Settings > Members**.
----
-
 ## Add a user
 Right next to **People**, start typing the name or username of the user you
@@ -19,22 +17,16 @@ want to add.
 ![Search for people](img/add_user_search_people.png)
----
-
 Select the user and the [permission level](../../permissions.md)
 that you'd like to give the user. Note that you can select more than one user.
 ![Give user permissions](img/add_user_give_permissions.png)
----
-
 Once done, hit **Add users to project** and they will be immediately added to
 your project with the permissions you gave them above.
 ![List members](img/add_user_list_members.png)
----
-
 From there on, you can either remove an existing user or change their access
 level to the project.
@@ -47,8 +39,6 @@ In the dropdown menu, you can see only the projects you are Maintainer on.
 ![Import members from another project](img/add_user_import_members_from_another_project.png)
----
-
 Select the one you want and hit **Import project members**. A flash message
 notifying you that the import was successful will appear, and the new members
 are now in the project's members list. Notice that the permissions that they
@@ -56,8 +46,6 @@ had on the project you imported from are retained.
 ![Members list of new members](img/add_user_imported_members.png)
----
-
 ## Invite people using their e-mail address
 If a user you want to give access to doesn't have an account on your GitLab
@@ -66,23 +54,17 @@ user search field.
 ![Invite user by mail](img/add_user_email_search.png)
----
-
 As you can imagine, you can mix inviting multiple people and adding existing
 GitLab users to the project.
 ![Invite user by mail ready to submit](img/add_user_email_ready.png)
----
-
 Once done, hit **Add users to project** and watch that there is a new member
 with the e-mail address we used above. From there on, you can resend the
 invitation, change their access level, or even delete them.
 ![Invite user members list](img/add_user_email_accept.png)
----
-
 Once the user accepts the invitation, they will be prompted to create a new
 GitLab account using the same e-mail address the invitation was sent to.
@@ -97,15 +79,11 @@ side of your screen.
 ![Request access button](img/request_access_button.png)
----
-
 Project owners & maintainers will be notified of your request and will be able to approve or
 decline it on the members page.
 ![Manage access requests](img/access_requests_management.png)
----
-
 If you change your mind before your request is approved, just click the
 **Withdraw Access Request** button.