README.md in masheri-0.3.1 vs README.md in masheri-0.3.4

@@ -1,3 +1,58 @@
+# masheri
 
+A Rails library for the [Mashery API](http://support.mashery.com/docs/mashery_api).
 
-Fix this!
+## Installation
+
+Add the following to your `Gemfile`
+
+```ruby
+gem "masheri"
+```
+
+Then run the installer to create `config/masheri.yml`
+
+```bash
+$ rails g masheri:install
+```
+
+## Configuration
+
+Edit `config/masheri.yml` with your `site_key`, `api_key` and `shared_secret` options.
+
+
+
+```yaml
+development:
+  site_id: 123
+  api_key: abc
+  shared_secret: xyz
+
+test:
+  site_id: 123
+  api_key: abc
+  shared_secret: xyz
+
+production:
+  site_id: 123
+  api_key: abc
+  shared_secret: xyz
+```
+
+## Usage
+
+
+### Members
+
+```ruby
+Masheri::Member.fetch_all #=>
+```
+
+### ???
+
+
+### ???
+
+
+### ???
+