Merge pull request #10020 from hashicorp/docs-update-install-brew

Updated Homebrew install instructions

website/content/docs/install/index.mdx

@@ -16,7 +16,6 @@ operating systems. You can also [build Nomad from source](#from-source).
 <Tabs>
 <Tab heading="Manual installation">
 
-
 You can download a [precompiled binary](/downloads) and
 run it on your machine locally. You can also verify the binary using the
 available SHA-256 sums. After downloading Nomad, unzip the package. Make sure
@@ -52,14 +51,12 @@ Nomad binary's location to that list and then launch a new console window.
 </Tab>
 <Tab heading="Linux Packages">
 
-
 HashiCorp officially maintains and signs packages for the following Linux
 distributions.
 
 <Tabs>
 <Tab heading="Ubuntu/Debian">
 
-
 Add the HashiCorp [GPG key][gpg-key].
 
 ```shell-session
@@ -81,7 +78,6 @@ $ sudo apt-get update && sudo apt-get install nomad
 </Tab>
 <Tab heading="CentOS/RHEL">
 
-
 Install `yum-config-manager` to manage your repositories.
 
 ```shell-session
@@ -103,7 +99,6 @@ $ sudo yum -y install nomad
 </Tab>
 <Tab heading="Fedora">
 
-
 Install `dnf config-manager` to manage your repositories.
 
 ```shell-session
@@ -125,7 +120,6 @@ $ sudo dnf -y install nomad
 </Tab>
 <Tab heading="Amazon Linux">
 
-
 Install `yum-config-manager` to manage your repositories.
 
 ```shell-session
@@ -147,7 +141,6 @@ $ sudo yum -y install nomad
 </Tab>
 </Tabs>
 
-
 -> **TIP:** Now that you have added the HashiCorp repository, you can install
 [Consul](https://learn.hashicorp.com/consul) and
 [Vault](https://learn.hashicorp.com/vault) with the same command.
@@ -155,27 +148,35 @@ $ sudo yum -y install nomad
 </Tab>
 <Tab heading="Homebrew (macOS)">
 
+[Homebrew](https://brew.sh) is a free and open source package management system
+for Mac OS X. Install the official [Nomad
+formula](https://github.com/hashicorp/homebrew-tap) from the terminal.
 
-[Homebrew](https://brew.sh) is a free and open-source package management system
+First, install the HashiCorp tap, a repository of all of the HashiCorp Homebrew
-for macOS. Install the [Nomad formula](https://formulae.brew.sh/formula/nomad)
+packages.
-from the terminal.
 
 ```shell-session
-$ brew install nomad
+$ brew tap hashicorp/tap
 ```
 
-~> **NOTE:** Homebrew and the Nomad formula are **NOT** directly maintained by
+Now, install Nomad with `hashicorp/tap/nomad`.
-HashiCorp. The latest version of Nomad is always available by manual
-installation.
 
-~> **NOTE**: On macOS, machines without a Java environment installed will be
+```shell-session
-prompted to install Java because of a [known issue—#7865][gh-7865]. The linked
+$ brew install hashicorp/tap/nomad
-GitHub issue has workarounds for this issue.
+```
+
+~> **NOTE:** This installs a signed binary and is automatically updated with
+every new official release.
+
+To update to the latest, run
+
+```shell-session
+$ brew upgrade hashicorp/tap/nomad
+```
 
 </Tab>
 <Tab heading="Chocolatey (Windows)">
 
-
 [Chocolatey](https://chocolatey.org/) is a free and open-source package
 management system for Windows. Install the [Nomad
 package](https://chocolatey.org/packages/nomad) from the command-line.
@@ -191,7 +192,6 @@ installation.
 </Tab>
 </Tabs>
 
-
 ---
 
 ## Verify the Installation