[DOCS] add replace yb-master docs

docs/content/latest/troubleshoot/cluster/replace_master.md

@@ -24,24 +24,31 @@ For the steps below, the examples use the following scenario:
 - A new YB-Master server (`M4`) will replace `M1`.
 - The default master RPC port is `7100`
 
+{{< note title="Note" >}}
+If the master you wish to replace is already dead (eg: VM was terminated), you might want to first do the `REMOVE` step, then do the `ADD` step.
+{{< /note >}}
+
 
-1. Start the new (replacement) YB-Master server in standby mode. 
+## Start the new (standby) YB-Master server in standby mode. 
 
-To start `yb-master` in standby mode, set the `--master_addresses` flag to an empty string (`""`).
+To start `yb-master` in standby mode, set the `--master_addresses` flag to an empty string (`""`). When the
+ `--master_addresses` is `""`, this master server starts running without joining any existing master
+  quorum. The node will be added to the master quorum in a later step.
 
 ```sh
-./bin/yb-master --master_addresses=""
+./bin/yb-master --master_addresses="" --fs_data_dirs=<your data directories> [any other flags you would normally pass
+ to this master process]
 ```
 
-2. Add the new YB-Master server into the existing cluster.
+## Add the new YB-Master server into the existing cluster.
 
 To add the new YB-Master server, run the [`yb-admin change_master_config ADD_SERVER`](../../admin/cli/yb-admin/#change-master-config) command.
 
 ```sh
 ./bin/yb-admin -master_addresses M1:7100,M2:7100,M3:7100 change_master_config ADD_SERVER M4 7100
 ```
 
-3. Remove the old YB-Master server from the cluster.
+## Remove the old YB-Master server from the cluster.
 
 To remove the failed YB-Master server from the cluster, use the [`yb-admin change_master_config REMOVE_SERVER`](../../admin/yb-admin/#change-master-config`) command.
 
@@ -50,7 +57,7 @@ To remove the failed YB-Master server from the cluster, use the [`yb-admin chang
 ```
 {{< note title="Note" >}}
 
-Make sure to specify all YB-Master addresses which will prevent the new YB-Master server from unexpectedly becoming the leader.
+Make sure to specify all YB-Master addresses including M4 to make sure that if M4 becomes the leader, then yb-admin can find it.
 
 {{< /note >}}
 ## Validate cluster
@@ -67,7 +74,3 @@ If any one of those masters is still part of the active quorum, then they will p
 If, however, none of the current masters are present in the TS flag, then the TS will not be able to join the cluster! 
 
 So it is important to make sure to update `--tserver_master_addrs` on every TS to the new set of master addresses, `M2:7100,M3:7100,M4:7100`!
-
-{{< note title="Note" >}}
-If the master you wish to replace is already dead (eg: VM was terminated), you might want to first do the `REMOVE` step, then do the `ADD` step.
-{{< /note >}}