Node-pressure Eviction FEATURE STATE note is misleading

[nathanperkins]

The Node-pressure Eviction page has a note at the top:

FEATURE STATE: Kubernetes v1.31 [beta] (enabled by default: true)

The split image filesystem feature, which enables support for the containerfs filesystem, adds several new eviction signals, thresholds and metrics. To use containerfs, the Kubernetes release v1.33 requires the KubeletSeparateDiskGC feature gate to be enabled. Currently, only CRI-O (v1.29 or higher) offers the containerfs filesystem support.

At a glance, the way this note is presented makes it look like it applies to the Node-pressure Eviction feature itself, but a closer look finds that the note is specific to the split image filesystem feature.

I poked around a bunch of other pages in the documentation and found that the common pattern is for this kind of note to be nested within the discussion of the specific feature, rather than at the top of the page.

I'd recommend this note be adjusted to make it more obvious that it is not talking about Node-pressure Eviction as a whole. For instance, it could be moved into a section which talks about the split image filesystem feature specifically.

[shannonxtreme]

The page is https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/

This feature-state shortcode and its description (everything between the {{<note>}} shortcodes) should move to the point about the containerfs filesystem in the Filesystem signals section.

/triage accepted
/help

[k8s-ci-robot]

@shannonxtreme:
This request has been marked as needing help from a contributor.

Guidelines

Please ensure that the issue body includes answers to the following questions:

• Why are we solving this issue?
• To address this issue, are there any code changes? If there are code changes, what needs to be done in the code and what places can the assignee treat as reference points?
• How can the assignee reach out to you for help?

For more details on the requirements of such an issue, please see here and ensure that they are met.

If this request no longer meets these requirements, the label can be removed
by commenting with the /remove-help command.

In response to this:

The page is https://kubernetes.io/docs/concepts/scheduling-eviction/node-pressure-eviction/

This feature-state shortcode and its description (everything between the {{<note>}} shortcodes) should move to the point about the containerfs filesystem in the Filesystem signals section.

/triage accepted
/help

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

[aman4433]

/assign