README.md in ruby_rides-0.0.1 vs README.md in ruby_rides-0.0.2

@@ -1,29 +1,47 @@
-# RubyRides
+#ruby_rides
+---
+A Ruby gem to interface with Hubway's API. 
 
-TODO: Write a gem description
-
 ## Installation
+```ruby
+gem install ruby_rides
+```
+Alternately, you can include this line in your Gemfile... 
+```ruby
+gem 'ruby_rides'
+```
 
-Add this line to your application's Gemfile:
+And bundle install.
+```ruby
+$ bundle
+```
 
-    gem 'ruby_rides'
+## Configuration
+To use the gem, you'll need to register with the Hubway data API, linked below, to acquire a username and apikey.
 
-And then execute:
+http://hubwaydatachallenge.org/data-api/
 
-    $ bundle
+Define a client using your credentials, which I'd suggest you access using a .env file. Once this is set up, you can access gem methods in your application. 
 
-Or install it yourself as:
+```ruby
+client = RubyRides::Client.new(client_id: YOUR_USERNAME, client_api_key: YOUR_APIKEY)
+```
 
-    $ gem install ruby_rides
+# Usage
+Return a hash listing data for all Hubway stations in the dataset.
+```ruby
+client.station_data
+```
 
-## Usage
+Return a location hash of all Hubway stations in the dataset with lat/long values for each and names as the key values.
+```ruby
+client.station_geo_locations
+```
 
-TODO: Write usage instructions here
-
 ## Contributing
 
 1. Fork it
 2. Create your feature branch (`git checkout -b my-new-feature`)
 3. Commit your changes (`git commit -am 'Add some feature'`)
 4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+5. Create new Pull Request
\ No newline at end of file