Updating docs for EndpointSlice changes in 1.18 (#19316)

content/en/docs/reference/command-line-tools-reference/feature-gates.md

@@ -91,6 +91,8 @@ different Kubernetes components.
 | `DynamicKubeletConfig` | `true` | Beta | 1.11 | |
 | `EndpointSlice` | `false` | Alpha | 1.16 | 1.16 |
 | `EndpointSlice` | `false` | Beta | 1.17 | |
+| `EndpointSlice` | `true` | Beta | 1.18 | |
+| `EndpointSliceProxying` | `false` | Alpha | 1.18 | |
 | `EphemeralContainers` | `false` | Alpha | 1.16 | |
 | `ExpandCSIVolumes` | `false` | Alpha | 1.14 | 1.15 |
 | `ExpandCSIVolumes` | `true` | Beta | 1.16 | |
@@ -399,8 +401,10 @@ Each feature gate is designed for enabling/disabling a specific feature:
    capabilities (e.g. `MKNODE`, `SYS_MODULE` etc.). This should only be enabled
    if user namespace remapping is enabled in the Docker daemon.
 - `EndpointSlice`: Enables Endpoint Slices for more scalable and extensible
-   network endpoints. Requires corresponding API and Controller to be enabled.
+   network endpoints. See [Enabling Endpoint Slices](/docs/tasks/administer-cluster/enabling-endpointslices/).
-   See [Enabling Endpoint Slices](/docs/tasks/administer-cluster/enabling-endpointslices/).
+- `EndpointSliceProxying`: When this feature gate is enabled, kube-proxy will
+   use EndpointSlices as the primary data source instead of Endpoints, enabling
+   scalability and performance improvements. See [Enabling Endpoint Slices](/docs/tasks/administer-cluster/enabling-endpointslices/).
 - `GCERegionalPersistentDisk`: Enable the regional PD feature on GCE.
 - `HugePages`: Enable the allocation and consumption of pre-allocated [huge pages](/docs/tasks/manage-hugepages/scheduling-hugepages/).
 - `HugePageStorageMediumSize`: Enable support for multiple sizes pre-allocated [huge pages](/docs/tasks/manage-hugepages/scheduling-hugepages/).

content/en/docs/tasks/administer-cluster/enabling-endpointslices.md

@@ -35,28 +35,25 @@ components still rely on Endpoints. For now, enabling EndpointSlices should be
 seen as an addition to Endpoints in a cluster, not a replacement for them.
 {{< /note >}}
 
-EndpointSlices are considered a beta feature, but only the API is enabled by
+EndpointSlices are a beta feature. Both the API and the EndpointSlice
-default. Both the EndpointSlice controller and the usage of EndpointSlices by
+{< glossary_tooltip term_id="controller" >}} are enabled by default.
-kube-proxy are not enabled by default.
+{{<  glossary_tooltip text="kube-proxy" term_id="kube-proxy" >}}
+uses Endpoints by default, not EndpointSlices.
 
-The EndpointSlice controller creates and manages EndpointSlices in a cluster.
+For better scalability and performance, you can enable the
-You can enable it with the `EndpointSlice` [feature
+`EndpointSliceProxying`
-gate](/docs/reference/command-line-tools-reference/feature-gates/) on the {{<
+[feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
-glossary_tooltip text="kube-apiserver" term_id="kube-apiserver" >}} and {{<
+on kube-proxy. That change
-glossary_tooltip text="kube-controller-manager"
+switches the data source to be EndpointSlices, which reduces the amount of
-term_id="kube-controller-manager" >}} (`--feature-gates=EndpointSlice=true`).
+Kubernetes API traffic to and from kube-proxy.
-
-For better scalability, you can also enable this feature gate on {{<
-glossary_tooltip text="kube-proxy" term_id="kube-proxy" >}} so EndpointSlices
-will be used as the data source instead of Endpoints.
 
 ## Using EndpointSlices
 
 With EndpointSlices fully enabled in your cluster, you should see corresponding
 EndpointSlice resources for each Endpoints resource. In addition to supporting
-existing Endpoints functionality, EndpointSlices should include new bits of
+existing Endpoints functionality, EndpointSlices include new bits of information
-information such as topology. They will allow for greater scalability and
+such as topology. They will allow for greater scalability and extensibility of
-extensibility of network endpoints in your cluster.
+network endpoints in your cluster.
 
 {{% capture whatsnext %}}