diff --git a/documentation/en/mining.md b/documentation/en/mining.md
index 790a3ae6a..71e6124a4 100644
--- a/documentation/en/mining.md
+++ b/documentation/en/mining.md
@@ -102,19 +102,21 @@ This env var can be used with `lotus-storage-miner`, `lotus-seal-worker`, and `l
 
 ### Setting multiaddresses
 
-It it possible to set multiaddresses for the miner to listen on in a miner's `config.toml` file 
-(by default, it is located at `~/.lotusminer/config.toml`). 
+Set multiaddresses for the miner to listen on in a miner's `config.toml` file 
+(by default, it is located at `~/.lotusminer/config.toml`). The `ListenAddresses` in this file should be interface listen addresses (usually `/ip4/0.0.0.0/tcp/PORT`), and the `AnnounceAddresses` should match the addresses being passed to `set-addrs`.
 
-Once added, set the on-chain record of your miner's listen addresses:
+The addresses passed to `set-addrs` parameter in the commands below should be currently active and dialable; confirm they are before entering them.
+
+Once the config file has been updated, set the on-chain record of the miner's listen addresses:
  
  ```
  lotus-miner actor set-addrs <multiaddr_1> <multiaddr_2> ... <multiaddr_n>
 ```
 
-This updates the `MinerInfo` object in your miner's actor, which will be looked up
+This updates the `MinerInfo` object in the miner's actor, which will be looked up
 when a client attempts to make a deal. Any number of addresses can be provided.
 
-For example:
+Example:
 
 ```
  lotus-miner actor set-addrs /ip4/123.123.73.123/tcp/12345 /ip4/223.223.83.223/tcp/23456