Topology Manager docs update for 1.19

[klueska]

Signed-off-by: Kevin Klues kklues@nvidia.com

[k8sio-netlify-preview-bot]

Deploy preview for kubernetes-io-vnext-staging processing.

Building with commit 7b270b4

https://app.netlify.com/sites/kubernetes-io-vnext-staging/deploys/5f0c75caa7f90c0007719e0a

[savitharaghunathan]

/milestone 1.19
/assign

[annajung]

Hi @klueska, docs shadow here 👋 just a friendly reminder this PR needs tech and doc review by July 16th.

[nolancon]

One small nit. LGTM otherwise.

[nolancon]

/lgtm

[klueska]

@annajung, @nolancon has provided the necessary tech review and added his LGTM. Who do I need to ping for the doc review?

[annajung]

Hi @klueska, you can reach out to docs team at #sig-docs channel to request a review, please let me know if you need any help

[sftim]

Hi @klueska

Here's some feedback.

1. I recommend using a note shortcode (see inline suggestion)
2. Does https://kubernetes.io/docs/reference/command-line-tools-reference/feature-gates/ require any changes as part of this PR?

[sftim]

Suggested change

	**Note:** Plugins are not required to provide useful implementations for
	`GetPreferredAllocation()` or `PreStartContainer()`. Flags indicating which
	(if any) of these calls are available should be set in the `DevicePluginOptions`
	message sent back by a call to `GetDevicePluginOptions()`. The `kubelet` will
	always call `GetDevicePluginOptions()` to see which optional functions are
	available, before calling any of them directly.
	{{% note %}}
	Plugins are not required to provide useful implementations for
	`GetPreferredAllocation()` or `PreStartContainer()`. Flags indicating which
	(if any) of these calls are available should be set in the `DevicePluginOptions`
	message sent back by a call to `GetDevicePluginOptions()`. The kubelet
	always calls `GetDevicePluginOptions()` to see which optional functions are
	available, before calling any of them directly.
	{{% /note %}}

Use a Note shortcode (untested).

[klueska]

1. Updated per your suggestion with 1 minor difference. I used {{< note >}} not {{% note %}} as the link you provided suggested.
2. No, this actually moved to beta in 1.18, but the documentation was never updated to reflect that. The feature gate was toggled to "always-on" back before 1.18 was released.

[sftim]

On detail 1, I did also file #22488 about the advice being not quite right for callout shortcodes. Anyway, it renders well enough as is.

[klueska]

It looks good to me: https://deploy-preview-21607--kubernetes-io-vnext-staging.netlify.app/docs/concepts/extend-kubernetes/compute-storage-net/device-plugins/

[vpickard]

Looks good, thanks for updating the docs.

/lgtm

[klueska]

Hello, @kubernetes/sig-docs-en-owners

I am looking for an approval on this PR. It's already got a LGTM from a technical perspective.

[irvifa]

/approve

[savitharaghunathan]

/approve

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: irvifa, savitharaghunathan

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• content/en/OWNERS [savitharaghunathan]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment