v3: Add documentation for port and protocol fields on routes

[finishes #162107369, #172512289]

Authored-by: Sarah Weinstein <sweinstein@pivotal.io>

Author: sweinstein22

docs/v3/source/includes/api_resources/_routes.erb

@@ -1,6 +1,8 @@
 <% content_for :single_route do | metadata={} | %>
 {
   "guid": "cbad697f-cac1-48f4-9017-ac08f39dfb31",
+  "protocol": "tcp",
+  "port": 6666,
   "created_at": "2019-05-10T17:17:48Z",
   "updated_at": "2019-05-10T17:17:48Z",
   "host": "a-hostname",
@@ -86,6 +88,7 @@
   "resources": [
     {
       "guid": "cbad697f-cac1-48f4-9017-ac08f39dfb31",
+      "protocol": "http",
       "created_at": "2019-05-10T17:17:48Z",
       "updated_at": "2019-05-10T17:17:48Z",
       "host": "a-hostname",

docs/v3/source/includes/resources/routes/_create.md.erb

@@ -12,6 +12,7 @@ curl "https://api.example.org/v3/routes" \
   -d '{
     "host": "a-hostname",
     "path": "/some_path",
+    "port": 6666,
     "relationships": {
       "domain": {
         "data": { "guid": "domain-guid" }
@@ -54,6 +55,7 @@ Content-Type: application/json
 | ----------------------------------------- | ----------------------------------- | --------------------------------- |
 | **host**                                  | _string_                            | The host component for the route. |
 | **path**                                  | _string_                            | The path component for the route. Should begin with a `/`.
+| **port** _(experimental)_                 | _integer_                           | The port the route will listen on. Only compatible with routes leveraging a domain that supports the `tcp` protocol.
 | **metadata.annotations**                  | [_annotation object_](#annotations) | Annotations applied to the route. |
 | **metadata.labels**                       | [_label object_](#labels) | Labels applied to the route.      |
 

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

@@ -11,6 +11,8 @@ Example Route object
 | Name                                      | Type                                           | Description                                                                                                                     |
 | --------------                            | ------------------------                       | ------------------------------------------------------                                                                          |
 | **guid**                                  | _uuid_                                         | Unique identifier for the route.
+| **protocol** _(experimental)_             | _string_                                       | The protocol supported by the route, based on the route's domain configuration.
+| **port** _(experimental)_                 | _integer or `null`_                            | The port that the route listens on. Only compatible with routes leveraging the `tcp` protocol.
 | **created_at**                            | _datetime_                                     | The time with zone when the object was created.                                                                                 |
 | **updated_at**                            | _datetime_                                     | The time with zone when the object was last updated.                                                                         |
 | **host**                                  | _string_                                       | The hostname for the route.<br>Must be under 63 character long and only contain letters, numbers, dashes (-) or underscores(_). |