diff --git a/README.md b/README.md
index 7f97ac8..c95bdb1 100644
--- a/README.md
+++ b/README.md
@@ -40,7 +40,7 @@ ConnOR accepts 3 mandatory command line arguments
 
 ## `--bootstrap-servers`
 
-A comma-separated list of Kafka broker URLs, e.g. `localhost:9092`.
+A comma-separated list of Kafka broker URLs.
 
 ## `--offset-topic`
 
@@ -48,10 +48,12 @@ The name of the internal topic where Kafka Connect stores its source connector o
 
 ## `--connector-name`
 
-The name of the source connector to reset.
+The name of the source connector whose offsets you want to reset.
 
 # Usage
 
+:exclamation: Shut down the source connector before running the following command.
+
 Run `connor` with all 3 mandatory arguments set, e.g.
 
 ```sh