Service plan visibilities upgrade guide. Move out of experimental and deprecate V2

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

Author: pivotal-marcela-campo

docs/v2/index.html

@@ -981,9 +981,19 @@ <h2>
   <div class="article">
     <h2>
         <a id="service-plan-visibilities" class="anchor" href="#service-plan-visibilities">&#128279;</a>
-        Service Plan Visibilities
+        Service Plan Visibilities - Deprecated
     </h2>
 
+    <div class="panel panel-warning">
+      <div class="panel-heading" style="background-color:#f0b37e;">
+        <h3 class="panel-title" style="color:white;">Warning:</h3>
+      </div>
+      <div class="panel-body" style="background-color:#ffedcc;">
+        The V2 Service Plan Visibilities resource is deprecated, please refer to the Service Plan Visibility section of the
+        <a href="http://v3-apidocs.cloudfoundry.org#service-plan-visibility" class="alert-link">V3 Docs</a>
+      </div>
+    </div>
+
     <ul>
       <li>
         <a href="service_plan_visibilities/creating_a_service_plan_visibility.html">Creating a Service Plan Visibility</a>

…es/service_plan_visibility/_apply.md.erb …es/service_plan_visibility/_apply.md.erbdocs/v3/source/includes/experimental_resources/service_plan_visibility/_apply.md.erb renamed to docs/v3/source/includes/resources/service_plan_visibility/_apply.md.erb docs/v3/source/includes/experimental_resources/service_plan_visibility/_apply.md.erb renamed to docs/v3/source/includes/resources/service_plan_visibility/_apply.md.erb

@@ -167,8 +167,7 @@ cf curl /v3/apps/:guid?include=space
 
 In addition, some resources provide the possibility of including specified fields of a related resource.
 
-For example, to include the service broker name and guid in the service offering's response:
-
+For example, to include the service broker `name` and `guid` in the service offering's response:
 ```
 cf curl /v3/service_offerings/:guid?fields[service_broker]=name,guid
 ```
@@ -379,6 +378,8 @@ This table shows how V2 resources map to their respective V3 counterparts. Note
 |Service Bindings, Service Keys|Service Keys|
 |Service Brokers|Service Brokers|[Service Brokers in V3](#service-brokers-in-v3)
 |Service Instances, User-Provided Service Instances|Service Instances|
+|Service Plans|Service Plans|[Service Plans in V3](#service-plans-in-v3)
+|Service Plan Visibilities|Service Plan Visibility|[Service Plan Visibility in V3](#service-plan-visibility-in-v3)
 |Spaces|Spaces|
 |Space Quota Definitions|Space Quotas|[Space Quotas in V3](#space-quotas-in-v3)
 |Stacks|Stacks|
@@ -512,6 +513,13 @@ unique_id | broker_catalog_ids
 
 Read more about the [service plan resource](#service-plans).
 
+### Service Plan Visibility in V3
+
+`v2/service_plan_visibilities` has been replaced in v3 with a nested resource `v3/service_plans/:guid/visibility`
+
+This new resource has a `type`, and can have a list of `organizations` a `space` or be of type `public`
+
+Read more about the [service plan visibility resource](#service-plan-visibility).
 
 ### Space Quotas in V3
 

…s/service_plan_visibility/_delete.md.erb …s/service_plan_visibility/_delete.md.erbdocs/v3/source/includes/experimental_resources/service_plan_visibility/_delete.md.erb renamed to docs/v3/source/includes/resources/service_plan_visibility/_delete.md.erb docs/v3/source/includes/experimental_resources/service_plan_visibility/_delete.md.erb renamed to docs/v3/source/includes/resources/service_plan_visibility/_delete.md.erb

@@ -259,6 +259,13 @@ includes:
   - resources/service_plans/list
   - resources/service_plans/update
   - resources/service_plans/delete
+  - resources/service_plan_visibility/header
+  - resources/service_plan_visibility/object
+  - resources/service_plan_visibility/visibility_types
+  - resources/service_plan_visibility/get
+  - resources/service_plan_visibility/update
+  - resources/service_plan_visibility/apply
+  - resources/service_plan_visibility/delete  
   - resources/spaces/header
   - resources/spaces/object
   - resources/spaces/create
@@ -327,13 +334,6 @@ includes:
   - experimental_resources/service_bindings/get
   - experimental_resources/service_bindings/list
   - experimental_resources/service_bindings/delete
-  - experimental_resources/service_plan_visibility/header
-  - experimental_resources/service_plan_visibility/object
-  - experimental_resources/service_plan_visibility/visibility_types
-  - experimental_resources/service_plan_visibility/get
-  - experimental_resources/service_plan_visibility/update
-  - experimental_resources/service_plan_visibility/apply
-  - experimental_resources/service_plan_visibility/delete
   - experimental_resources/service_instances/header
   - experimental_resources/service_instances/create
   - experimental_resources/service_instances/get