DOC-5590 RS: Deprecate setting cluster policy during bootstrap

Author: rrelledge

content/operate/rs/references/rest-api/objects/bootstrap/_index.md

@@ -18,24 +18,24 @@ A bootstrap configuration object.
 | action | 'create_cluster'<br />'join_cluster'<br />'recover_cluster' | Action to perform |
 | cluster | [cluster_identity]({{< relref "/operate/rs/references/rest-api/objects/bootstrap/cluster_identity" >}}) object | Cluster to join or create |
 | cnm_https_port | integer | Port to join a cluster with non-default cnm_https port |
-| crdb_coordinator_port | integer, (range:&nbsp;1024-65535) (default:&nbsp;9081) | CRDB coordinator port |
+| crdb_coordinator_port | integer, (range: 1024-65535) (default: 9081) | CRDB coordinator port |
 | credentials | [credentials]({{< relref "/operate/rs/references/rest-api/objects/bootstrap/credentials" >}}) object | Cluster admin credentials |
-| dns_suffixes | {{<code>}}
+| dns_suffixes | object | Explicit configuration of DNS suffixes<br />{{<code>}}
 [{
   "name": string,
   "cluster_default": boolean,
   "use_aaaa_ns": boolean,
   "use_internal_addr": boolean,
   "slaves": array
 }, ...]
-{{</code>}} | Explicit configuration of DNS suffixes<br />**name**: DNS suffix name<br />**cluster_default**: Should this suffix be the default cluster suffix<br />**use_aaaa_ns**: Should AAAA records be published for NS records<br />**use_internal_addr**: Should internal cluster IPs be published for databases<br />**slaves**: List of replica servers that should be published as NS and notified |
-| envoy_admin_port | integer, (range:&nbsp;1024-65535) | Envoy admin port. Changing this port during runtime might result in an empty response because envoy serves as the cluster gateway.|
-| envoy_mgmt_server_port | integer, (range:&nbsp;1024-65535) | Envoy management server port|
-| gossip_envoy_admin_port | integer, (range:&nbsp;1024-65535) | Gossip envoy admin port|
+{{</code>}}<br />**name**: DNS suffix name<br />**cluster_default**: Should this suffix be the default cluster suffix<br />**use_aaaa_ns**: Should AAAA records be published for NS records<br />**use_internal_addr**: Should internal cluster IPs be published for databases<br />**slaves**: List of replica servers that should be published as NS and notified |
+| envoy_admin_port | integer, (range: 1024-65535) | Envoy admin port. Changing this port during runtime might result in an empty response because envoy serves as the cluster gateway.|
+| envoy_mgmt_server_port | integer, (range: 1024-65535) | Envoy management server port|
+| gossip_envoy_admin_port | integer, (range: 1024-65535) | Gossip envoy admin port|
 | license | string | License string. If not provided, a trial license is set by default. |
 | max_retries | integer | Max number of retries in case of recoverable errors |
 | node | [node_identity]({{< relref "/operate/rs/references/rest-api/objects/bootstrap/node_identity" >}}) object | Node description |
-| policy | [policy]({{< relref "/operate/rs/references/rest-api/objects/bootstrap/policy" >}}) object | Policy object |
+| policy | [policy]({{< relref "/operate/rs/references/rest-api/objects/bootstrap/policy" >}}) object | Policy object (deprecated; use [`PUT /v1/cluster/policy`]({{< relref "/operate/rs/references/rest-api/requests/cluster/policy#put-cluster-policy" >}}) after cluster creation instead) |
 | recovery_filename | string | Name of backup file to recover from |
 | required_version | string | This node can only join the cluster if all nodes in the cluster have a version greater than the required_version (deprecated as of Redis Enterprise Software v7.8.6) |
 | retry_time | integer | Max waiting time between retries (in seconds) |

content/operate/rs/release-notes/rs-8-0-releases/_index.md

@@ -45,7 +45,7 @@ Redis Enterprise Software version 8.0 introduces the following breaking changes:
 
 #### API deprecations
 
-- TBA
+- Deprecated the `policy` field for [bootstrap]({{<relref "/operate/rs/references/rest-api/requests/bootstrap">}}) REST API requests. Use [`PUT /v1/cluster/policy`]({{< relref "/operate/rs/references/rest-api/requests/cluster/policy#put-cluster-policy" >}}) to change cluster policies after cluster creation instead.
 
 #### Internal monitoring and v1 Prometheus metrics deprecation
 

content/operate/rs/release-notes/rs-8-0-releases/rs-8-0-tba.md

@@ -115,7 +115,7 @@ Redis Software version 8.0.x introduces the following breaking changes:
 
 #### API deprecations
 
-- TBA
+- Deprecated the `policy` field for [bootstrap]({{<relref "/operate/rs/references/rest-api/requests/bootstrap">}}) REST API requests. Use [`PUT /v1/cluster/policy`]({{< relref "/operate/rs/references/rest-api/requests/cluster/policy#put-cluster-policy" >}}) to change cluster policies after cluster creation instead.
 
 #### Internal monitoring and v1 Prometheus metrics deprecation