Updated getting started instructions to OAuth v2 workflow.

Author: dblock

CONTRIBUTING.md

@@ -27,15 +27,15 @@ bundle exec rake
 
 ### Run Examples in Development
 
-Sign up for Slack, create a private slack group for yourself.
+Sign up for Slack, create a private Slack team for yourself, then [generate an API token](https://api.slack.com/tutorials/tracks/getting-a-token) for your app and use it for some interactions.
 
-Create a new App under [https://api.slack.com/apps](https://api.slack.com/apps).
+Try running the examples in the [examples](examples) directory.
 
-![](screenshots/create-app.png)
-
-On the next screen, note the API token.
-
-To run [the example in examples/hi_real_time_and_web](examples/hi_real_time_and_web/hi.rb), open a terminal, cd into _examples/hi_real_time_and_web_, run `bundle install`, followed by `SLACK_API_TOKEN=<your API token> bundle exec ruby hi.rb`.
+```bash
+cd examples/hi_web
+bundle install
+SLACK_API_TOKEN=... bundle exec ruby hi.rb
+```
 
 ## Contribute Code
 

README.md

@@ -105,11 +105,9 @@ Run `bundle install`.
 
 To integrate your bot with Slack, you must first create a new [Slack App](https://api.slack.com/apps).
 
-![](screenshots/create-app.png)
-
 ### OAuth Code Grant
 
-Once created, go to the app's Basic Info tab and grab the Client ID and Client Secret.  You'll need these in order complete an [OAuth code grant flow](https://api.slack.com/docs/oauth#flow) as described at [slack-ruby-bot-server](https://github.com/slack-ruby/slack-ruby-bot-server).
+Once created, go to the app's Basic Info tab and grab the Client ID and Client Secret. You'll need these in order complete an [OAuth Workflow](https://api.slack.com/authentication/oauth-v2). A working sample that starts a local web server and obtains a bot or a user token for your app using OAuth v2 is available in [examples/oauth_v2](examples/oauth_v2).
 
 ### Using an API Token