Merge branch 'docs-install-edits' into 'master'

Docs: Remove alerts from GitLab install page, and style edits

See merge request gitlab-org/gitlab!45542

doc/install/README.md

@@ -9,33 +9,42 @@ type: index
 
 # 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
-performance, reliability, ease of administration (backups, upgrades and troubleshooting),
-and cost of hosting.
-
-There are many ways you can install GitLab depending on your platform:
-
-1. [**Omnibus GitLab**](#installing-gitlab-using-the-omnibus-gitlab-package-recommended): The official deb/rpm packages that contain a bundle of GitLab
-   and the various components it depends on, like PostgreSQL, Redis, Sidekiq, etc.
-1. [**GitLab Helm chart**](#installing-gitlab-on-kubernetes-via-the-gitlab-helm-charts): The cloud native Helm chart for installing GitLab and all its components on Kubernetes.
-1. [**Docker**](#installing-gitlab-with-docker): The Omnibus GitLab packages dockerized.
-1. [**Source**](#installing-gitlab-from-source): Install GitLab and all its components from scratch.
-1. [**Cloud provider**](#installing-gitlab-on-cloud-providers): Install directly from platforms like AWS, Azure, GCP.
-
-TIP: **If in doubt, choose Omnibus:**
-The Omnibus GitLab packages are mature,
-[scalable](../administration/reference_architectures/index.md) and are used
+GitLab can be installed in most GNU/Linux distributions and with several
+cloud providers. To get the best experience from GitLab, you must balance
+performance, reliability, ease of administration (backups, upgrades, and
+troubleshooting), and the cost of hosting.
+
+Depending on your platform, select from the following available methods to
+install GitLab:
+
+- [_Omnibus GitLab_](#installing-gitlab-using-the-omnibus-gitlab-package-recommended):
+  The official deb/rpm packages that contain a bundle of GitLab and the
+  components it depends on, including PostgreSQL, Redis, and Sidekiq.
+- [_GitLab Helm chart_](#installing-gitlab-on-kubernetes-via-the-gitlab-helm-charts):
+  The cloud native Helm chart for installing GitLab and all of its components
+  on Kubernetes.
+- [_Docker_](#installing-gitlab-with-docker): The Omnibus GitLab packages,
+  dockerized.
+- [_Source_](#installing-gitlab-from-source): Install GitLab and all of its
+  components from scratch.
+- [_Cloud provider_](#installing-gitlab-on-cloud-providers): Install directly
+  from platforms like AWS, Azure, and GCP.
+
+If you're not sure which installation method to use, we recommend you use
+Omnibus GitLab. The Omnibus GitLab packages are mature,
+[scalable](../administration/reference_architectures/index.md), and are used
 today on GitLab.com. The Helm charts are recommended for those who are familiar
 with Kubernetes.
 
 ## Requirements
 
-Before installing GitLab, it is of critical importance to review the system [requirements](requirements.md). The system requirements include details on the minimum hardware, software, database, and additional requirements to support GitLab.
+Before you install GitLab, be sure to review the [system requirements](requirements.md).
+The system requirements include details about the minimum hardware, software,
+database, and additional requirements to support GitLab.
 
 ## Installing GitLab using the Omnibus GitLab package (recommended)
 
-The Omnibus GitLab package uses our official deb/rpm repositories. This is
+The Omnibus GitLab package uses our official deb/rpm repositories, and is
 recommended for most users.
 
 If you need additional flexibility and resilience, we recommend deploying
@@ -45,11 +54,6 @@ GitLab as described in our [reference architecture documentation](../administrat
 
 ## Installing GitLab on Kubernetes via the GitLab Helm charts
 
-NOTE: **Kubernetes experience required:**
-We recommend being familiar with Kubernetes before using it to deploy GitLab in
-production. The methods for management, observability, and some concepts are
-different than traditional deployments.
-
 When installing GitLab on Kubernetes, there are some trade-offs that you
 need to be aware of:
 
@@ -59,11 +63,17 @@ need to be aware of:
   are deployed in a redundant fashion.
 - There are some feature [limitations to be aware of](https://docs.gitlab.com/charts/#limitations).
 
+Due to these trade-offs, having Kubernetes experience is a requirement for
+using this method. We recommend being familiar with Kubernetes before using it
+to deploy GitLab in production. The methods for management, observability, and
+some concepts are different than traditional deployments.
+
 [**> Install GitLab on Kubernetes using the GitLab Helm charts.**](https://docs.gitlab.com/charts/)
 
 ## Installing GitLab with Docker
 
-GitLab maintains a set of official Docker images based on the Omnibus GitLab package.
+GitLab maintains a set of official Docker images based on the Omnibus GitLab
+package.
 
 [**> Install GitLab using the official GitLab Docker images.**](docker.md)