Homebrew guide: doc improvements related to #1573

Author: michaelklishin

site/install-generic-unix.md

@@ -29,7 +29,7 @@ in development environments.
 There's a separate [binary package for Windows](./install-windows-manual.html).
 
 Unlike with the cases of [Debian](./install-debian.html), [RPM](./install-rpm.html) and [Windows installer](./install-windows.html) packages,
-[node management](#running-generic-unix) with this package type is performed solely using
+[node management](#managing-node) with this package type is performed solely using
 [RabbitMQ CLI tools](./cli.html) or by the operator setting up e.g. a `systemd` service manually.
 
 ## <a id="downloads" class="anchor" href="#downloads">Downloads</a>
@@ -74,7 +74,7 @@ It is a good candidate for including into `PATH`.
 
 ## <a id="operations" class="anchor" href="#operations">Operations</a>
 
-### <a id="running-generic-unix" class="anchor" href="#running-generic-unix">Running and Managing the Node</a>
+### <a id="managing-node" class="anchor" href="#managing-node">Running and Managing the Node</a>
 
 Unlike some other installation methods, namely the [Debian](./install-debian.html) and [RPM packages](./install-rpm.html), RabbitMQ
 generic UNIX binary build does not require `sudo`. It can be uncompressed

site/install-homebrew.md

@@ -23,7 +23,7 @@ limitations under the License.
 [RabbitMQ formula](https://github.com/Homebrew/homebrew-core/blob/master/Formula/rabbitmq.rb) is available from
 [Homebrew](https://brew.sh/)'s core tap (out of the box).
 
-The formula will also install a reasonably recent [supported Erlang/OTP version](./which-erlang.html)
+The formula will also install a recent [supported Erlang/OTP version](./which-erlang.html)
 as a dependency.
 
 
@@ -43,10 +43,79 @@ brew install rabbitmq
 
 Installing the RabbitMQ formula will install key dependencies such as a [supported Erlang/OTP version](./which-erlang.html).
 
-## <a id="operations" class="anchor" href="#operations">Operations</a>
+## <a id="locations" class="anchor" href="#locations">Locations</a>
 
-The RabbitMQ server scripts and [CLI tools](./cli.html) are installed into the `sbin` directory under `/usr/local/Cellar/rabbitmq/<version>/` for macOS Intel or `/opt/homebrew/Cellar/rabbitmq/<version>/` for Apple Silicon,
-which is accessible from `/usr/local/opt/rabbitmq/sbin` for for macOS Intel or `/opt/homebrew/opt/rabbitmq/sbin` for Apple Silicon. Links to binaries have been created under `/usr/local/sbin` for macOS Intel or `/opt/homebrew/sbin` for Apple Silicon.
+The RabbitMQ server scripts and [CLI tools](./cli.html) are installed into the `sbin` directory under `/usr/local/Cellar/rabbitmq/{version}/` for Intel Macs
+or `/opt/homebrew/Cellar/rabbitmq/<version>/` for Apple Silicon Macs.
+
+They should be accessible from `/usr/local/opt/rabbitmq/sbin` for for Intel Macs or `/opt/homebrew/opt/rabbitmq/sbin` for Apple Silicon Macs.
+Links to binaries have been created under `/usr/local/sbin` for Intel Macs or `/opt/homebrew/sbin` for Apple Silicon ones.
+
+To find out locations for your installation, use
+
+<pre class="lang-bash">
+brew info rabbitmq
+</pre>
+
+With Homebrew, the node and CLI tools will use the logged in user account by default.
+
+
+## <a id="managing-node" class="anchor" href="#managing-node">Running and Managing the Node</a>
+
+Unlike some other installation methods, namely the [Debian](./install-debian.html) and [RPM packages](./install-rpm.html), RabbitMQ
+Homebrew formula uses [generic UNIX binary builds](./install-generic-unix.html) and does not require `sudo`.
+
+#### Starting the Server
+
+To start a node in the foreground, run
+
+<pre class="lang-bash">
+CONF_ENV_FILE="/opt/homebrew/etc/rabbitmq/rabbitmq-env.conf" /opt/homebrew/opt/rabbitmq/sbin/rabbitmq-server
+</pre>
+
+To start a node in the background, use `brew service start`:
+
+<pre class="lang-bash">
+brew services start rabbitmq
+</pre>
+
+#### Stopping the Server
+
+To stop a running node, use
+
+<pre class="lang-bash">
+brew services stop rabbitmq
+</pre>
+
+or CLI tools directly:
+
+<pre class="lang-bash">
+/opt/homebrew/opt/rabbitmq/sbin/rabbitmqctl shutdown
+</pre>
+
+The command will wait for the node process to stop. If the target node is not running,
+it will exit with an error.
+
+#### Configuring the Server
+
+File and directory locations used by Homebrew differ from Intel Macs to Apple Silicon ones.
+To find out locations for your installation, use
+
+<pre class="lang-bash">
+brew info rabbitmq
+</pre>
+
+On Apple Silicon Macs, [RabbitMQ configuration file](configure.html#configuration-files) located at `/opt/homebrew/etc/rabbitmq/rabbitmq.conf`.
+The file does not exist by default and can be created.
+
+It is possible to [use environment variables](configure.html#customise-general-unix-environment) to control certain settings.
+`rabbitmq-env.conf` is located at `/opt/homebrew/etc/rabbitmq/rabbitmq-env.conf`
+
+See RabbitMQ [configuration guide](configure.html) to learn more.
+
+## <a id="cli" class="anchor" href="#cli"></a>
+
+The formula sets up links to CLI tools under `/usr/local/sbin` for Intel Macs or `/opt/homebrew/sbin` for Apple Silicon Macs.
 
 In case that directory is not in `PATH` it's recommended to append it:
 
@@ -59,13 +128,3 @@ export PATH=$PATH:/opt/homebrew/sbin
 
 Add the above export to the shell profile (such as `~/.bashrc` for bash or `~/.zshrc` for zsh)
 to have `PATH` updated for every new shell, including OS restarts.
-
-The server can then be started with `rabbitmq-server` in the foreground or with `brew services start rabbitmq`
-to have it run under launchd in the background.
-
-With Homebrew, the node and CLI tools will use the logged in user account by default.
-Using `sudo` is not required.
-
-Otherwise operations are no different from the generic binary build.
-Please refer to the [Operations section](install-generic-unix.html#operations) of
-the generic binary build guide.