Merge pull request #188 from BookingSync/review-update

add docs about review title

Author: ZenCocoon

api_calls/reference/reviews/create-request.json

@@ -2,7 +2,8 @@
   "reviews": [
     {
       "comment": "It was awesome!",
-      "rating": 5
+      "rating": 5,
+      "title": "Awesome"
     }
   ]
 }

api_calls/reference/reviews/public-reviews_write-scope-response.json

@@ -13,6 +13,7 @@
       "rating": 5,
       "comment": "It was awesome!",
       "name": "John S.",
+      "title": "Awesome",
       "created_at": "CREATED_AT",
       "updated_at": "UPDATED_AT"
     }

content/reference/changelog.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 2016-10-18
+
+ * [api improvement] `title` attribute added to `reviews`.
+
 ## 2016-09-26
 
  * [api improvement] `priced_only` mapping parameter added to `availabilities`.

content/reference/endpoints/reviews.md

@@ -18,6 +18,7 @@ id               | Integer | Read       | Review's id.
 comment          | Text    | Read       | Review's comment.
 name             | String  | Read       | Reviewer's name, cropped to show only the initial of the last name.
 rating           | Integer | Read       | Review's rating.
+title            | String  | Read       | Review's title.
 -----------------|---------|------------|------------
 created_at       | [Time](/reference/enums#formats) | Read       | Review's create time.
 updated_at       | [Time](/reference/enums#formats) | Read       | Review's update time.
@@ -28,9 +29,10 @@ Name             | Type    | Read/Write | Description
 -----------------|---------|------------|------------
 id               | Integer | Read       | Review's id.
 -----------------|---------|------------|------------
-comment          | Text    | Read/Write | Review's comment.  (10 min, 2000 max characters)
+comment          | Text    | Read/Write | **Required**. Review's comment. (10 min, 2000 max characters)
 name             | String  | Read       | Reviewer's name, cropped to show only the initial of the last name.
 rating           | Integer | Read/Write | **Required**. Review's rating. (between 1 and 6)
+title            | String  | Read/Write | Review's title. (3 min, 100 max characters)
 -----------------|---------|------------|------------
 created_at       | [Time](/reference/enums#formats) | Read       | Review's create time.
 updated_at       | [Time](/reference/enums#formats) | Read       | Review's update time.