v3(services)(docs) Updated description of service route bindings

[#175559034](https://www.pivotaltracker.com/story/show/175559034)

Author: FelisiaM

docs/v3/source/includes/experimental_resources/service_route_bindings/_header.md

@@ -1,3 +1,7 @@
 ## Service Route Binding
 
-An instantiation of a service route binding.
+Service route bindings are relations between a service instance and a route.
+
+Not all service instances support route binding. 
+In order to bind to a managed service instance, the service instance should be created from a service offering that has requires route forwarding (`requires=[route_forwarding]`). 
+In order to bind to a user-provided service instance, the service instance must have `route_service_url` set.

docs/v3/source/includes/resources/service_offerings/_object.md.erb

@@ -16,7 +16,7 @@ Name | Type | Description
 **description** | _string_ | Description of the service offering
 **available** | _boolean_ | Whether or not the service offering is available
 **tags** | _list of strings_ | Descriptive tags for the service offering
-**requires** | _list of strings_ | A list of permissions that the user would have to give the service, if they provision it; the only permissions currently supported are syslog_drain, route_forwarding and volume_mount
+**requires** | _list of strings_ | A list of permissions that the user would have to give the service, if they provision it; the only permissions currently supported are `syslog_drain`, `route_forwarding` and `volume_mount`
 **shareable** | _boolean_ | Whether or not service Instances of this service offering can be shared across organizations and spaces
 **documentation_url** | _string_ | Url that points to a documentation page for the service offering, if provided by the service broker as part of the metadata field
 **broker_catalog** | _[broker catalog object](#the-service-offering-broker-catalog)_ | This object contains information obtained from the service broker Catalog

…ources/_service_instance_routes_in_v3.md …service_instance_route_bindings_in_v3.mddocs/v3/source/includes/upgrade_guide/changed_resources/_service_instance_routes_in_v3.md renamed to docs/v3/source/includes/upgrade_guide/changed_resources/_service_instance_route_bindings_in_v3.md docs/v3/source/includes/upgrade_guide/changed_resources/_service_instance_routes_in_v3.md renamed to docs/v3/source/includes/upgrade_guide/changed_resources/_service_instance_route_bindings_in_v3.md

@@ -1,6 +1,8 @@
-### Service Instance routes in V3
+### Service Instance Route Bindings in V3
 
-There is a new resource `service route binding` that represents a binding between a route and a service instance.
+In v2, binding a service instance to a route was done as a relationship request for the service instance.  
+
+In v3, there is a new resource `service route binding` that represents a binding between a route and a service instance.
 
 Creation/Deletion of bindings is therefore done via that endpoint in v3.
 

docs/v3/source/includes/upgrade_guide/new_resources/_service_route_bindings.md

@@ -1,8 +1,8 @@
 ### Service Route Bindings
 
-There is a new resource `service route binding` that represents a binding between a route and a service instance.a
+There is a new resource `service route binding` that represents a binding between a route and a service instance.
 
-Creation/Deletion of bindings is therefore done via that endpoint in v3.
+Creation/Deletion of these bindings is therefore done via that endpoint in v3.
 
 This resource also supports metadata both in create and update requests.
 

docs/v3/source/index.html.md

@@ -418,7 +418,7 @@ includes:
   - upgrade_guide/changed_resources/routes_in_v3
   - upgrade_guide/changed_resources/security_groups_in_v3
   - upgrade_guide/changed_resources/service_brokers_in_v3
-  - upgrade_guide/changed_resources/service_instance_routes_in_v3
+  - upgrade_guide/changed_resources/service_instance_route_bindings_in_v3
   - upgrade_guide/changed_resources/service_offerings_in_v3
   - upgrade_guide/changed_resources/service_plans_in_v3
   - upgrade_guide/changed_resources/service_plan_visibility_in_v3