add an example of how to retrieve reviews
@@ -426,7 +426,7 @@ Users with appropriate access can comment on a submission and reply to other's c
:align: center
-Extracting all notes given an invitation
+Retrieving all notes given an invitation
-------------------------------------------
Users can access all notes by using an invitation id.
@@ -438,7 +438,7 @@ Consider the following example which gets all the papers submitted to ICLR 2018:
Please note, get_notes() will return only the first 1000 notes. If you expect the number of notes returned to be more, you will require tools.iterget_notes() which returns an iterator and lets you access all the notes.
-Extracting all Public Comments for a conference
+Retrieving all Public Comments for a conference
--------------------------------------------------
Comments, just like submissions, are saved as notes. So they are also accessible using get_notes().
@@ -451,8 +451,33 @@ This code returns public comments made during the conference "ICLR.cc/2019/Confe
Please note that the invitation regex used in above example represents the convention that OpenReview follows while creating invitations for ICLR Conferences. So, the invitations do not necessarily have to follow this regex for all conferences or workshops.
+Retrieving all Official Reviews for a conference
+-------------------------------------------------
-Extracting comments made on a forum
+Like comments and submissions, reviews are also usually represented as Notes. Conferences often distinguish reviews written by official conference reviewers with the invitation suffix "Official_Review".
+
+For example, the reviews in ICLR 2019 all have invitations with the following pattern::
+
+ ICLR.cc/2019/Conference/-/Paper.*/Official_Review
+
+To retrieve the Official Reviews for a given ICLR 2019 paper, do the following::
+
+ >>> paper123_reviews = client.get_notes(invitation='ICLR.cc/2019/Conference/-/Paper123/Official_Review')
+
+The specific structure of the review's ``content`` field is determined by the conference, but a typical review's content will include fields like ``title``, ``review``, ``rating``, and ``confidence``::
+
+ >>> review0 = paper123_reviews[0]
+ >>> print(review0.content['rating'])
+ '8: Top 50% of accepted papers, clear accept'
+
+Conferences as large as ICLR 2019 will often have a number of reviews that exceeds the default API limit. To retrieve all Official Reviews for all ICLR 2019 papers, create an iterator over reviews by doing the following::
+
+ >>> review_iterator = openreview.tools.iterget_notes(client, invitation='ICLR.cc/2019/Conference/-/Paper.*/Official_Review')
+ >>> for review in review_iterator:
+ >>> #do something
+
+
+Retrieving comments made on a forum
----------------------------------------
All comments made on a particular forum/submission can be extracted like this::
