Repository: kubernetes
Issue: API documentation incorrectly states that resizePolicy can be set to ephemeral containers
Labels: priority/backlog,kind/documentation,sig/node,help wanted,good first issue,triage/accepted

### What happened?

![스크린샷 2024-10-27 172423](https://github.com/user-attachments/assets/67362294-40c0-4af6-a4e9-40b06f9ec9e8)
Based on the concept of `resizePolicy`, it is expected behavior that `resizePolicy` cannot be assigned to ephemeral containers, as they do not support resource requests or limits.

However, in the Kubernetes v1.31 API documentation, there is no clear indication that the `resizePolicy` option is disallowed for ephemeral containers, which may lead to confusion for users.
![image](https://github.com/user-attachments/assets/c480ec78-4c3d-4190-8339-e10e03bed9ca)
![image](https://github.com/user-attachments/assets/10b178ba-299b-4e06-a9dc-aa139851cbb6)

### `pkg/apis/core/validation/validation_test.go`
```go
func TestValidateEphemeralContainers(t *testing.T) {
...
...
...
	{
			"Container uses disallowed field: ResizePolicy",
			line(),
			[]core.EphemeralContainer{{
				EphemeralContainerCommon: core.EphemeralContainerCommon{
					Name:                     "resources-resize-policy",
					Image:                    "image",
					ImagePullPolicy:          "IfNotPresent",
					TerminationMessagePolicy: "File",
					ResizePolicy: []core.ContainerResizePolicy{
						{ResourceName: "cpu", RestartPolicy: "NotRequired"},
					},
				},
			}},
			field.ErrorList{{Type: field.ErrorTypeForbidden, Field: "ephemeralContainers[0].resizePolicy"}},
		}
	...
	...
	...
```
As shown in the code above, it is explicitly stated that `resizePolicy` cannot be assigned to ephemeral containers.
This restriction is not reflected in the API documentation, potentially leading users to believe they can apply `resizePolicy` to ephemeral containers. Including this limitation in the documentation would improve clarity and enhance the user experience.

### What did you expect to happen?

The Kubernetes v1.31 API documentation should clearly state that `resizePolicy` cannot be assigned to ephemeral containers, as they do not support resource requests or limits. This clarification would prevent users from mistakenly assuming that `resizePolicy` can be applied to ephemeral containers and help avoid configuration errors.

### How can we reproduce it (as minimally and precisely as possible)?

1. Go to the Kubernetes v1.31 API documentation.
2. [Navigate to the section discussing `resizePolicy` for containers.](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.31/#containerresizepolicy-v1-core)
3. [Review the documentation regarding ephemeral containers.](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.31/#ephemeralcontainer-v1-core)
4. Observe that there is no mention or clarification that `resizePolicy` cannot be applied to ephemeral containers, leading to potential misunderstandings.

### Anything else we need to know?

_No response_

### Kubernetes version

<details>

```console
$ kubectl version
Client Version: v1.31.1
Kustomize Version: v5.4.2
Server Version: v1.31.1

```

</details>


### Cloud provider

<details>
On-Premises
</details>

### OS version

<details>

```console
# On Linux:
$ cat /etc/os-release
RETTY_NAME="Ubuntu 22.04.4 LTS"
NAME="Ubuntu"
VERSION_ID="22.04"
VERSION="22.04.4 LTS (Jammy Jellyfish)"
VERSION_CODENAME=jammy
ID=ubuntu
ID_LIKE=debian
HOME_URL="https://www.ubuntu.com/"
SUPPORT_URL="https://help.ubuntu.com/"
BUG_REPORT_URL="https://bugs.launchpad.net/ubuntu/"
PRIVACY_POLICY_URL="https://www.ubuntu.com/legal/terms-and-policies/privacy-policy"
UBUNTU_CODENAME=jammy

$ uname -a
Linux masternode-virtual-machine 6.8.0-47-generic #47~22.04.1-Ubuntu SMP PREEMPT_DYNAMIC Wed Oct  2 16:16:55 UTC 2 x86_64 x86_64 x86_64 GNU/Linux

```

</details>


### Install tools

<details>
kubeadm
</details>


### Container runtime (CRI) and version (if applicable)

<details>
containerd
</details>


### Related plugins (CNI, CSI, ...) and versions (if applicable)

<details>

</details>