From 3b9fc92d66862d0f29dcd3743b24c848a0169e15 Mon Sep 17 00:00:00 2001
From: "Celeste A. Seberras" <38491560+har00ga@users.noreply.github.com>
Date: Wed, 29 Jul 2020 06:59:39 -0400
Subject: [PATCH 1/2] Update mining.md

---
 documentation/en/mining.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/documentation/en/mining.md b/documentation/en/mining.md
index 3b1f5a8a3..790a3ae6a 100644
--- a/documentation/en/mining.md
+++ b/documentation/en/mining.md
@@ -99,3 +99,23 @@ This env var can be used with `lotus-storage-miner`, `lotus-seal-worker`, and `l
 ### `FIL_PROOFS_USE_GPU_COLUMN_BUILDER=1` Environment variable
 
 This env var can be used with `lotus-storage-miner`, `lotus-seal-worker`, and `lotus-bench` to enable experimental precommit2 GPU acceleration
+
+### 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`). 
+
+Once added, set the on-chain record of your 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
+when a client attempts to make a deal. Any number of addresses can be provided.
+
+For example:
+
+```
+ lotus-miner actor set-addrs /ip4/123.123.73.123/tcp/12345 /ip4/223.223.83.223/tcp/23456 
+```

From 5d1e51da9c45d7c1b5885f3cb41546fe6f841421 Mon Sep 17 00:00:00 2001
From: "Celeste A. Seberras" <38491560+har00ga@users.noreply.github.com>
Date: Thu, 30 Jul 2020 02:57:25 -0400
Subject: [PATCH 2/2] Update mining.md

---
 documentation/en/mining.md | 12 +++++++-----
 1 file changed, 7 insertions(+), 5 deletions(-)

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