Change services endpoints docs capitalisation to be consistent with the

pivotal-marcela-campo · pivotal-marcela-campo · commit 7ce8c1d8584a · 2020-05-22T11:42:36.000+01:00
rest of the documentation [#171356816](https://www.pivotaltracker.com/story/show/171356816)
diff --git a/docs/v3/source/includes/concepts/_fields.md.erb b/docs/v3/source/includes/concepts/_fields.md.erb
@@ -10,7 +10,7 @@ Developers may choose to use the `fields` feature to reduce the number of API ca
 query param can be used with a single resource or a list of resources.
 
 The fields query parameter may also grant visibility to parts of resources where the whole resource is not visible.
-For instance, the name of an Organization may be retrieved with fields, where the whole Organization resource may
+For instance, the name of an organization may be retrieved with fields, where the whole organization resource may
 not be visible.
 
 ### Fields parameter
diff --git a/docs/v3/source/includes/experimental_resources/service_bindings/_create.md.erb b/docs/v3/source/includes/experimental_resources/service_bindings/_create.md.erb
@@ -51,7 +51,7 @@ Name | Type | Description
 ---- | ---- | -----------
 **type** | _string_ | Service binding type. Valid value is `app`.
 **relationships.app** | [_to-one relationship_](#to-one-relationships) | A relationship to an app.
-**relationships.service_instance** | [_to-one relationship_](#to-one-relationships) | A relationship to a service_instance.
+**relationships.service_instance** | [_to-one relationship_](#to-one-relationships) | A relationship to a service instance.
 
 #### Optional parameters
 
diff --git a/docs/v3/source/includes/experimental_resources/service_bindings/_object.md.erb b/docs/v3/source/includes/experimental_resources/service_bindings/_object.md.erb
@@ -1,7 +1,7 @@
 ### The service binding object
 
 ```
-Example Service Binding object
+Example service binding object
 ```
 ```json
 <%= yield_content :single_service_binding %>
diff --git a/docs/v3/source/includes/experimental_resources/service_instances/_credentials.md.erb b/docs/v3/source/includes/experimental_resources/service_instances/_credentials.md.erb
@@ -1,4 +1,4 @@
-### Get Credentials for a User-Provided Service Instance
+### Get credentials for a user-provided service instance
 
 ```
 Example Request
@@ -21,8 +21,8 @@ Content-Type: application/json
 <%= yield_content :user_provided_service_instance_credentials %>
 ```
 
-Retrieves the credentials for a User-Provided Service Instance.
-This endpoint is not available for Managed Service Instances.
+Retrieves the credentials for a user-provided service instance.
+This endpoint is not available for managed service instances.
 
 #### Definition
 `GET /v3/service_instances/:guid/credentials`
diff --git a/docs/v3/source/includes/experimental_resources/service_instances/_get.md.erb b/docs/v3/source/includes/experimental_resources/service_instances/_get.md.erb
@@ -1,4 +1,4 @@
-### Get a Service Instance
+### Get a service instance
 
 ```
 Example Request
diff --git a/docs/v3/source/includes/experimental_resources/service_instances/_parameters.md.erb b/docs/v3/source/includes/experimental_resources/service_instances/_parameters.md.erb
@@ -1,4 +1,4 @@
-### Get Parameters for a Managed Service Instance
+### Get parameters for a managed service instance
 
 ```
 Example Request
diff --git a/docs/v3/source/includes/resources/service_brokers/_jobs.md.erb b/docs/v3/source/includes/resources/service_brokers/_jobs.md.erb
@@ -1,4 +1,4 @@
-### Service Broker Jobs
+### Service broker jobs
 
 CRUD operations for service brokers are asynchronous. `create`, `update` and `delete` endpoints include a job URL in the `Location` header of the HTTP response.
 
diff --git a/docs/v3/source/includes/resources/service_brokers/_update.md.erb b/docs/v3/source/includes/resources/service_brokers/_update.md.erb
@@ -39,7 +39,7 @@ Location: https://api.example.org/v3/jobs/af5c57f6-8769-41fa-a499-2c84ed896788
 This endpoint updates a broker and creates a job to synchronize the service offerings and service plans with those in the broker's catalog.
 The `Location` header refers to the created job which syncs the broker with the catalog. See [_Service broker jobs_](#service-broker-jobs) for more information and limitations.
 
-Service Brokers that are in the process of being synchronized or deleted cannot be updated.
+Service brokers that are in the process of being synchronized or deleted cannot be updated.
 
 #### Definition
 `PATCH /v3/service_brokers/[guid]`
diff --git a/docs/v3/source/includes/resources/service_instances/_object.md.erb b/docs/v3/source/includes/resources/service_instances/_object.md.erb
@@ -25,7 +25,7 @@ Name | Type | Description
 **syslog_drain_url** _(experimental)_| _string_ | URL to which logs for bound applications will be streamed. Only shown when type is `user-provided`.
 **route_service_url** _(experimental)_| _string_ | URL to which requests for bound routes will be forwarded. Only shown when type is `user-provided`.
 **maintenance_info** _(experimental)_| _[maintenance_info object](#the-maintenance-info-object-for-service-instances)_ | Information about the version of this service instance. Only shown when type is `managed`.
-**upgrade_available** _(experimental)_| _bool_ | Whether or not an upgrade of this Service Instance is available on the current Service Plan. Details are available in the maintenance_info object. Only shown when type is `managed`.
+**upgrade_available** _(experimental)_| _bool_ | Whether or not an upgrade of this service instance is available on the current Service Plan. Details are available in the maintenance_info object. Only shown when type is `managed`.
 **dashboard_url** _(experimental)_| _string_ | The URL to the service instance dashboard (or null if there is none). Only shown when type is `managed`.
 **last_operation** _(experimental)_| _[last operation object](#the-last-operation-object-for-service-instances)_ | The last operation of this service instance. Only shown when type is `managed`.
 **relationships.service_plan** | [_to-one relationship_](#to-one-relationships) | The service plan the service instance relates to. Only shown when type is `managed`.
@@ -39,7 +39,7 @@ Name | Type | Description
 
 Name | Type | Description
 ---- | ---- | -----------
-**version** | _string_ | The current semantic version of this Service Instance. Comparing this version with the version of the Service Plan can be used to determine whether or not this Service Instance is up to date with the Service Plan.
+**version** | _string_ | The current semantic version of this service instance. Comparing this version with the version of the Service Plan can be used to determine whether or not this service instance is up to date with the Service Plan.
 **description** | _string_ | A textual explanation associated with this version.
 
 
diff --git a/docs/v3/source/includes/resources/service_offerings/_delete.md.erb b/docs/v3/source/includes/resources/service_offerings/_delete.md.erb
@@ -18,12 +18,12 @@ Example Response
 HTTP/1.1 204 No Content
 ```
 
-This endpoint deletes a Service Offering. This is typically used to remove orphan Service Offerings from the Cloud
-Foundry database when they have been removed from the Service Broker catalog, or when the Service Broker has been
+This endpoint deletes a service offering. This is typically used to remove orphan service offerings from the Cloud
+Foundry database when they have been removed from the service broker catalog, or when the service broker has been
 removed.
 
-Note that this operation only affects the Cloud Foundry database, and no attempt is made to contact the Service
-Broker.
+Note that this operation only affects the Cloud Foundry database, and no attempt is made to contact the service
+broker.
 
 #### Definition
 `DELETE /v3/service_offerings/:guid`
diff --git a/docs/v3/source/includes/resources/service_offerings/_get.md.erb b/docs/v3/source/includes/resources/service_offerings/_get.md.erb
@@ -1,4 +1,4 @@
-### Get a Service Offering
+### Get a service offering
 
 ```
 Example Request
diff --git a/docs/v3/source/includes/resources/service_offerings/_header.md b/docs/v3/source/includes/resources/service_offerings/_header.md
@@ -1,6 +1,6 @@
 ## Service Offerings
 
-Service Offerings represent the services offered by Service Brokers.
-A Service Broker will have one or more Service Offerings.
-A Service Offering will have one or more Service Plans.
-Service Offerings and Service Plans are created and updated when a Service Broker is registered or updated.
+Service offerings represent the services offered by service brokers.
+A service broker will have one or more service offerings.
+A service offering will have one or more service plans.
+Service offerings and service plans are created and updated when a service broker is registered or updated.
diff --git a/docs/v3/source/includes/resources/service_offerings/_list.md.erb b/docs/v3/source/includes/resources/service_offerings/_list.md.erb
@@ -32,10 +32,10 @@ Name | Type | Description
 ---- | ---- | ------------
 **names** | _list of strings_ | Comma-delimited list of names to filter by.
 **available** | _boolean_ | Filter by the `available` property. Valid values are `true` or `false`.
-**service_broker_guids** | _list of strings_ | Comma-delimited list of Service Broker GUIDs to filter by.
-**service_broker_names** | _list of strings_ | Comma-delimited list of Service Broker names to filter by.
-**space_guids** | _list of strings_ | Comma-delimited list of Space GUIDs to filter by.
-**organization_guids** | _list of strings_ | Comma-delimited list of Organization GUIDs to filter by.
+**service_broker_guids** | _list of strings_ | Comma-delimited list of service broker GUIDs to filter by.
+**service_broker_names** | _list of strings_ | Comma-delimited list of service broker names to filter by.
+**space_guids** | _list of strings_ | Comma-delimited list of space GUIDs to filter by.
+**organization_guids** | _list of strings_ | Comma-delimited list of organization GUIDs to filter by.
 **label_selector** | _string_ | **Experimental** - A query string containing a list of [label selector](#labels-and-selectors) requirements.
 **fields** | [_fields parameter_](#fields-parameter) | **Experimental** [_Allowed values_](#service-offerings-list-fields)
 
diff --git a/docs/v3/source/includes/resources/service_offerings/_object.md.erb b/docs/v3/source/includes/resources/service_offerings/_object.md.erb
@@ -1,4 +1,4 @@
-### The Service Offering object
+### The service offering object
 
 ```
 Example Service Offering object
@@ -9,31 +9,31 @@ Example Service Offering object
 
 Name | Type | Description
 ---- | ---- | -----------
-**guid** | _uuid_ | Unique identifier for the Service Offering.
-**name** | _string_ | Name of the Service Offering.
-**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.
+**guid** | _uuid_ | Unique identifier for the service offering.
+**name** | _string_ | Name of the service offering.
+**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.
 **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.
-**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.
-**relationships.service_broker** | [_to-one relationship_](#to-one-relationships) | The Service Broker that provides this Service Offering.
-**metadata.labels**       | [_label object_](#labels)      | Labels applied to the Service Offering.
-**metadata.annotations**  | [_annotation object_](#annotations) | Annotations added to the Service Offering.
+**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.
+**relationships.service_broker** | [_to-one relationship_](#to-one-relationships) | The service broker that provides this service offering.
+**metadata.labels**       | [_label object_](#labels)      | Labels applied to the service offering.
+**metadata.annotations**  | [_annotation object_](#annotations) | Annotations added to the service offering.
 **links** | [_links object_](#links) | Links to related resources.
 
 #### The service offering broker catalog
 
 Name | Type | Description
 ---- | ---- | -----------
-**id** | _string_ | The identifier that the Service Broker provided for this Service Offering.
-**metadata** | _object_ | Additional information provided by the Service Broker as specified by [OSBAPI](https://github.com/openservicebrokerapi/servicebroker/blob/master/profile.md#service-metadata-fields).
-**features.plan_updateable** | _boolean_ | Whether the Service Offering supports upgrade/downgrade for Service Plans by default
-**features.bindable** | _boolean_ | Specifies whether Service Instances of the service can be bound to applications.
-**features.instances_retrievable** | _boolean_ | Specifies whether the Fetching a Service Instance endpoint is supported for all Service Plans.
-**features.bindings_retrievable** | _boolean_ | Specifies whether the Fetching a Service Binding endpoint is supported for all Service Plans.
-**features.allow_context_updates** | _boolean_ | Specifies whether Service Instance updates relating only to context are propagated to the Service Broker.
+**id** | _string_ | The identifier that the service broker provided for this service offering.
+**metadata** | _object_ | Additional information provided by the service broker as specified by [OSBAPI](https://github.com/openservicebrokerapi/servicebroker/blob/master/profile.md#service-metadata-fields).
+**features.plan_updateable** | _boolean_ | Whether the service offering supports upgrade/downgrade for service plans by default
+**features.bindable** | _boolean_ | Specifies whether service Instances of the service can be bound to applications.
+**features.instances_retrievable** | _boolean_ | Specifies whether the Fetching a service instance endpoint is supported for all service plans.
+**features.bindings_retrievable** | _boolean_ | Specifies whether the Fetching a service binding endpoint is supported for all service plans.
+**features.allow_context_updates** | _boolean_ | Specifies whether service instance updates relating only to context are propagated to the service broker.
 
diff --git a/docs/v3/source/includes/resources/service_offerings/_update.md.erb b/docs/v3/source/includes/resources/service_offerings/_update.md.erb
@@ -28,7 +28,7 @@ Content-Type: application/json
 <%= yield_content :single_service_offering %>
 ```
 
-This endpoint updates a Service Offering with labels and annotations.
+This endpoint updates a service offering with labels and annotations.
 
 #### Definition
 `PATCH /v3/service_offerings/[guid]`
diff --git a/docs/v3/source/includes/resources/service_offerings/_visibility.md.erb b/docs/v3/source/includes/resources/service_offerings/_visibility.md.erb
@@ -1,27 +1,27 @@
-### Visibility of Service Offerings
+### Visibility of service offerings
 
-This table shows the Service Offerings that different roles can see.
-The Service Offerings that a user can see relate to their Space and Organization roles,
-regardless of which Space or Organization is being targeted.
+This table shows the service offerings that different roles can see.
+The service offerings that a user can see relate to their space and organization roles,
+regardless of which space or organization is being targeted.
 
-A Service Offering can be seen when at least one of its Service Plans can be seen.
-Service Plans may be configured to be Public,
-or they may be configured with a relationship to a restricted list of Organizations.
+A service offering can be seen when at least one of its service plans can be seen.
+Service plans may be configured to be `public`,
+or they may be configured with a relationship to a restricted list of organizations.
 
-Service Offerings and Service Plans from a space-scoped Service Broker cannot have their visibility configured.
-They are only visible to members of that Space.
+Service offerings and service plans from a space-scoped service broker cannot have their visibility configured.
+They are only visible to members of that space.
 
-Role | Public Plans | Restricted Plans | From space-scoped Service Brokers
+Role | Public plans | Restricted plans | From space-scoped service brokers
 --- | --- | --- | ---
 Admin | All | All | All
 Admin Read | All | All | All
 Global Auditor | All | All | All
-Org Manager | All | In Organisation | None
-Org Auditor | All | In Organisation | None
-Org Billing | All | In Organisation | None
-Space Manager | All | In Organisation | In Space
-Space Developer | All | In Organisation | In Space
-Space Auditor | All | In Organisation | In Space
+Org Manager | All | In organisation | None
+Org Auditor | All | In organisation | None
+Org Billing | All | In organisation | None
+Space Manager | All | In organisation | In space
+Space Developer | All | In organisation | In space
+Space Auditor | All | In organisation | In space
 Unauthenticated | All* | None | None
 
 *Unless the `hide_marketplace_from_unauthenticated_users` feature flag is `true`
diff --git a/docs/v3/source/includes/resources/service_plan_visibility/_apply.md.erb b/docs/v3/source/includes/resources/service_plan_visibility/_apply.md.erb
@@ -1,4 +1,4 @@
-### Apply a Service Plan Visibility
+### Apply a service plan visibility
 
 ```
 Example Request
@@ -28,7 +28,7 @@ Content-Type: application/json
 <%= yield_content :service_plan_visibility_with_new_org %>
 ```
 
-This endpoint applies a Service Plan Visibility. It behaves similar to the [PATCH Service Plan Visibility endpoint](#update-a-service-plan-visibility) but this endpoint will append to the existing list of organizations when the Service Plan is `organization` visible.
+This endpoint applies a service plan visibility. It behaves similar to the [PATCH service plan visibility endpoint](#update-a-service-plan-visibility) but this endpoint will append to the existing list of organizations when the service plan is `organization` visible.
 
 #### Definition
 `POST /v3/service_plans/[guid]/visibility`
diff --git a/docs/v3/source/includes/resources/service_plan_visibility/_delete.md.erb b/docs/v3/source/includes/resources/service_plan_visibility/_delete.md.erb
@@ -1,4 +1,4 @@
-### Remove Organization from a Service Plan Visibility
+### Remove organization from a service plan visibility
 
 ```
 Example Request
diff --git a/docs/v3/source/includes/resources/service_plan_visibility/_get.md.erb b/docs/v3/source/includes/resources/service_plan_visibility/_get.md.erb
@@ -1,4 +1,4 @@
-### Get a Service Plan Visibility
+### Get a service plan visibility
 
 ```
 Example Request
diff --git a/docs/v3/source/includes/resources/service_plan_visibility/_header.md b/docs/v3/source/includes/resources/service_plan_visibility/_header.md
@@ -1,3 +1,3 @@
 ## Service Plan Visibility
 
-Service Plan Visibility is used to manage whether a role has access to a given Service Plan and its Service Offering.
+Service plan visibility is used to manage whether a role has access to a given service plan and its service offering.
diff --git a/docs/v3/source/includes/resources/service_plan_visibility/_object.md.erb b/docs/v3/source/includes/resources/service_plan_visibility/_object.md.erb
@@ -1,14 +1,14 @@
-### The Service Plan Visibility object
+### The service plan visibility object
 
 ```
-Example Service Plan Visibility object - Organization restricted
+Example Service Plan Visibility object - organization restricted
 ```
 ```json
 <%= yield_content :org_service_plan_visibility %>
 ```
 
 ```
-Example Service Plan Visibility object - Space restricted
+Example Service Plan Visibility object - space restricted
 ```
 ```json
 <%= yield_content :space_service_plan_visibility %>
diff --git a/docs/v3/source/includes/resources/service_plan_visibility/_update.md.erb b/docs/v3/source/includes/resources/service_plan_visibility/_update.md.erb
@@ -1,4 +1,4 @@
-### Update a Service Plan Visibility
+### Update a service plan visibility
 
 ```
 Example Request
@@ -28,7 +28,7 @@ Content-Type: application/json
 <%= yield_content :new_org_service_plan_visibility %>
 ```
 
-This endpoint updates a Service Plan Visibility. It behaves similar to the [POST Service Plan Visibility endpoint](#apply-a-service-plan-visibility) but this endpoint will replace the existing list of organizations when the Service Plan is `organization` visible.
+This endpoint updates a service plan visibility. It behaves similar to the [POST service plan visibility endpoint](#apply-a-service-plan-visibility) but this endpoint will replace the existing list of organizations when the service plan is `organization` visible.
 
 #### Definition
 `PATCH /v3/service_plans/[guid]/visibility`
diff --git a/docs/v3/source/includes/resources/service_plan_visibility/_visibility_types.md.erb b/docs/v3/source/includes/resources/service_plan_visibility/_visibility_types.md.erb
@@ -2,7 +2,7 @@
 
 Name | Description
 ---- | -----------
-**public** | Everyone, including unauthenticated users can see the Service Plan.
-**admin** | Only Admin, Admin Read-Only and Global Auditor can see the Service Plan.
-**organization** | Restricted to members of a set of Organizations.
-**space** | Restricted to members of a Space. Only possible if the Plan comes from a space-scoped Service Broker.
+**public** | Everyone, including unauthenticated users can see the service plan.
+**admin** | Only Admin, Admin Read-Only and Global Auditor can see the service plan.
+**organization** | Restricted to members of a set of organizations.
+**space** | Restricted to members of a space. Only possible if the plan comes from a space-scoped service broker.
diff --git a/docs/v3/source/includes/resources/service_plans/_delete.md.erb b/docs/v3/source/includes/resources/service_plans/_delete.md.erb
@@ -1,4 +1,4 @@
-### Delete a Service Plan
+### Delete a service plan
 
 ```
 Example Request
diff --git a/docs/v3/source/includes/resources/service_plans/_get.md.erb b/docs/v3/source/includes/resources/service_plans/_get.md.erb
@@ -1,4 +1,4 @@
-### Get a Service Plan
+### Get a service plan
 
 ```
 Example Request
diff --git a/docs/v3/source/includes/resources/service_plans/_header.md b/docs/v3/source/includes/resources/service_plans/_header.md
@@ -1,5 +1,5 @@
 ## Service Plans
 
-Service Plans represent the service plans offered by a Service Offering.
-A Service Offering will have one or more Service Plans.
-Service Offerings and Service Plans are created and updated when a Service Broker is registered or updated.
+Service plans represent the service plans offered by a service offering.
+A service offering will have one or more service plans.
+Service offerings and service plans are created and updated when a service broker is registered or updated.
diff --git a/docs/v3/source/includes/resources/service_plans/_list.md.erb b/docs/v3/source/includes/resources/service_plans/_list.md.erb
diff --git a/docs/v3/source/includes/resources/service_plans/_object.md.erb b/docs/v3/source/includes/resources/service_plans/_object.md.erb
diff --git a/docs/v3/source/includes/resources/service_plans/_update.md.erb b/docs/v3/source/includes/resources/service_plans/_update.md.erb
diff --git a/docs/v3/source/includes/upgrade_guide/upgrade_guide.md b/docs/v3/source/includes/upgrade_guide/upgrade_guide.md

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-### Get a Service Instance`
	`1`	`+### Get a service instance`
`2`	`2`
`3`	`3`	```
`4`	`4`	`Example Request`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-### Get Parameters for a Managed Service Instance`
	`1`	`+### Get parameters for a managed service instance`
`2`	`2`
`3`	`3`	```
`4`	`4`	`Example Request`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-### Service Broker Jobs`
	`1`	`+### Service broker jobs`
`2`	`2`
`3`	`3`	CRUD operations for service brokers are asynchronous. `create`, `update` and `delete` endpoints include a job URL in the `Location` header of the HTTP response.
`4`	`4`