Update docs for how to connect to a team

1 files changed, 16 insertions, 11 deletions

diff --git a/README.md b/README.md
index 27aaadb..feec373 100644
--- a/README.md
+++ b/README.md
@@ -81,14 +81,17 @@ Log in to Slack:
 ```
 
 This command prints a link you should open in your browser to authorize WeeChat
-with Slack. Once you've accomplished this, copy the "code" portion of the URL in
-the browser and pass it to this command:
+with Slack. If the page shows a different team than the one you want to add,
+you can change the team in the top right corner of the page.
+
+Once you've accomplished this, the page will show a command which you should
+run in WeeChat. The command is of the form:
 
 ```
-/slack register [CODE_FROM_URL]
+/slack register <code>
 ```
 
-Your Slack team is now added, and you can complete setup by restarting the
+Your Slack team is now added, and you can complete the setup by reloading the
 wee-slack script.
 
 ```
@@ -97,28 +100,30 @@ wee-slack script.
 
 Alternatively, you can click the "Request token" button at the
 [Slack legacy token page](https://api.slack.com/custom-integrations/legacy-tokens),
-and paste it directly into your settings:
+and use that instead of following the procedure above:
 
 ```
-/set plugins.var.python.slack.slack_api_token [YOUR_SLACK_TOKEN]
+/slack register <YOUR_SLACK_TOKEN>
 ```
 
-If you don't want to store your API token in plaintext you can use the secure features of weechat:
+The tokens you add will be stored in the option
+`plugins.var.python.slack.slack_api_token`. If you don't want to store your API
+token in plaintext you can use the secure features of WeeChat:
 
 ```
 /secure passphrase this is a super secret password
-/secure set slack_token [YOUR_SLACK_TOKEN]
+/secure set slack_token <YOUR_SLACK_TOKEN>
 /set plugins.var.python.slack.slack_api_token ${sec.data.slack_token}
 ```
 
 #### Optional: Connecting to multiple teams
 
 You can run the register command multiple times to connect to multiple teams.
-If you set the token yourself, you can use the above command with multiple
-tokens separated by commas.
+If you set the token option yourself, you should separate the tokens with
+commas.
 
 ```
-/set plugins.var.python.slack.slack_api_token [token1],[token2],[token3]
+/set plugins.var.python.slack.slack_api_token <token1>,<token2>,<token3>
 ```
 
 Commands and options