Fixed a few broken links and code sample errors

Jim Ray · Jim Ray · commit b940063acc2e · 2019-06-19T15:42:49.000-04:00
diff --git a/README.md b/README.md
@@ -146,7 +146,7 @@ In our example below, we watch for a [message event][message-event] that contain
             )
 
     slack_token = os.environ["SLACK_API_TOKEN"]
-    rtm_client = slack.RTMClient(slack_token)
+    rtm_client = slack.RTMClient(token=slack_token)
     rtm_client.start()
 ```
 
diff --git a/docs-src/auth.rst b/docs-src/auth.rst
@@ -50,8 +50,8 @@ To configure your app for OAuth, you'll need a client ID, a client secret, and a
 .. code-block:: python
 
   import os
+  import slack
   from flask import Flask, request
-  from slackclient import SlackClient
 
   client_id = os.environ["SLACK_CLIENT_ID"]
   client_secret = os.environ["SLACK_CLIENT_SECRET"]
@@ -109,6 +109,6 @@ If your Slack app includes a `bot user <https://api.slack.com/docs/bots>`_, the
 
 Once your user has completed the OAuth flow, you'll be able to use the provided tokens to call any of Slack's API methods that require an access token.
 
-See the :ref:`Web API usage <web-api-examples>` section of this documentation for usage examples.
+See the :ref:`Web API usage <basic_usage>` section of this documentation for usage examples.
 
 .. include:: metadata.rst
diff --git a/docs-src/basic_usage.rst b/docs-src/basic_usage.rst
@@ -300,7 +300,7 @@ Here's a very basic example of how one might deal with rate limited requests.
   import time
 
   slack_token = os.environ["SLACK_API_TOKEN"]
-  client = slack.WebClient(slack_token)
+  client = slack.WebClient(token=slack_token)
 
   # Simple wrapper for sending a Slack message
   def send_slack_message(channel, message):
diff --git a/docs-src/faq.rst b/docs-src/faq.rst
@@ -10,14 +10,14 @@ That's great! Thank you. Let us know on the `Issue Tracker`_. If you're feeling
 There's a feature missing!
 *******************************
 
-There's always something more that could be added! You can let us know in the `Issue Tracker`_ to start a discussion around the proposed feature, that's a good start. If you're feeling particularly ambitious, why not write the feature yourself, and submit a `pull request`_! We love feedback and we love help and we don't bite. Much.
+There's always something more that could be added! You can let us know in the `Issue Tracker <https://github.com/slackapi/python-slackclient/issues>`_ to start a discussion around the proposed feature, that's a good start. If you're feeling particularly ambitious, why not write the feature yourself, and submit a `pull request <https://github.com/slackapi/python-slackclient/pulls>`_! We love feedback and we love help and we don't bite. Much.
 
 How do I contribute?
 *********************************
 
-What an excellent question. First of all, please have a look at our general `contributing guidelines`_.
+What an excellent question. First of all, please have a look at our general `contributing guidelines <https://github.com/slackapi/python-slackclient/blob/master/.github/contributing.md>`_.
 
-All done? Great! While we're super excited to incorporate your new feature into |product_name|, there are a couple of things we want to make sure you've given thought to.
+All done? Great! While we're super excited to incorporate your new feature, there are a couple of things we want to make sure you've given thought to.
 
 - Please write unit tests for your new code. But don't **just** aim to increase the test coverage, rather, we expect you
   to have written **thoughtful** tests that ensure your new feature will continue to work as expected, and to help future

Original file line number	Diff line number	Diff line change
`@@ -146,7 +146,7 @@ In our example below, we watch for a [message event][message-event] that contain`
`146`	`146`	`)`
`147`	`147`
`148`	`148`	`slack_token = os.environ["SLACK_API_TOKEN"]`
`149`		`- rtm_client = slack.RTMClient(slack_token)`
	`149`	`+ rtm_client = slack.RTMClient(token=slack_token)`
`150`	`150`	`rtm_client.start()`
`151`	`151`	```
`152`	`152`