Docs: Update changelog and docs for annotation region change (#18593)

CHANGELOG.md

@@ -1,5 +1,10 @@
 # 6.4.0 (unreleased)
 
+### Breaking changes
+
+* **Annotations**: There are some breaking changes in the annotations HTTP API for region annotations. Region
+    annotations are now represented using a single event instead of two seperate events. Check HTTP docs for more details.
+
 # 6.3.3 (2019-08-15)
 
 ### Bug Fixes

docs/sources/http_api/annotations.md

@@ -27,7 +27,6 @@ Content-Type: application/json
 Authorization: Basic YWRtaW46YWRtaW4=
 ```
 
-
 Query Parameters:
 
 - `from`: epoch datetime in milliseconds. Optional.
@@ -88,9 +87,13 @@ Content-Type: application/json
 ]
 ```
 
+> Starting in Grafana v6.4 regions annotations are now returned in one entity that now includes the timeEnd property.
+
 ## Create Annotation
 
-Creates an annotation in the Grafana database. The `dashboardId` and `panelId` fields are optional. If they are not specified then a global annotation is created and can be queried in any dashboard that adds the Grafana annotations data source. When creating a region annotation the response will include both `id` and `endId`, if not only `id`.
+Creates an annotation in the Grafana database. The `dashboardId` and `panelId` fields are optional.
+If they are not specified then a global annotation is created and can be queried in any dashboard that adds
+the Grafana annotations data source. When creating a region annotation include the timeEnd property.
 
 `POST /api/annotations`
 
@@ -120,10 +123,13 @@ Content-Type: application/json
 {
     "message":"Annotation added",
     "id": 1,
-    "endId": 2
 }
 ```
 
+> The response for this HTTP request is slightly different in versions prior to v6.4. In prior versions you would
+also get an endId if you where creating a region. But in 6.4 regions are represented using a single event with time &
+timeEnd properties.
+
 ## Create Annotation in Graphite format
 
 Creates an annotation by using Graphite-compatible event format. The `when` and `data` fields are optional. If `when` is not specified then the current time will be used as annotation's timestamp. The `tags` field can also be in prior to Graphite `0.10.0`
@@ -198,7 +204,7 @@ Content-Type: application/json
 
 Updates one or more properties of an annotation that matches the specified id.
 
-This operation currently supports updating of the `text`, `tags`, `time` and `timeEnd` properties. 
+This operation currently supports updating of the `text`, `tags`, `time` and `timeEnd` properties.
 
 **Example Request**:
 
@@ -249,4 +255,4 @@ Content-Type: application/json
 {
     "message":"Annotation deleted"
 }
-```
+```