From 327b6f41206f6a35d470f7328a00a636e0e68a4f Mon Sep 17 00:00:00 2001
From: stve <steve.agalloco@gmail.com>
Date: Sun, 30 Aug 2015 23:05:41 -0400
Subject: [PATCH] update README examples

---
 README.md | 34 ++++++++++++++++++++++++++++++++--
 1 file changed, 32 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 67a14fa..cfdcd58 100644
--- a/README.md
+++ b/README.md
@@ -42,7 +42,7 @@ end
 To obtain an access token via xAuth:
 
 ```ruby
-client.token(username, password)
+client.access_token(username, password)
 ```
 
 You can also verify credentials once you have received tokens:
@@ -62,7 +62,12 @@ client.bookmarks
 Add a new bookmark:
 
 ```ruby
-client.add_bookmark('http://someurl.com', :title => 'This is the title', :description => 'This is the description')
+bookmark = {
+  title: 'This is the title',
+  description: 'This is the description',
+}
+
+client.add_bookmark('http://someurl.com', bookmark)
 ```
 
 Remove a bookmark:
@@ -130,6 +135,31 @@ Lastly, the folders can be reordered:
 client.set_order(['folder_id1:2','folder_id2:1'])
 ```
 
+## Highlights Operations
+
+Obtain highlights for a bookmark:
+
+```ruby
+client.highlights(bookmark_id)
+```
+
+Add a highlight for a bookmark:
+
+```ruby
+highlight = {
+  text: 'And so we beat on, boats against the current, borne back ceaselessly into the past.',
+  position: 20,
+}
+
+client.add_highlight(bookmark_id, highlight)
+```
+
+Remove a highlight:
+
+```ruby
+client.delete_highlight(highlight_id)
+```
+
 ## Documentation
 
 [http://rdoc.info/gems/instapaper](http://rdoc.info/gems/instapaper)