Corrections for Inaccurate Descriptions of taint and toleration

[yuto-kimura-g]

• https://github.com/kubernetes/website/blob/main/content/en/docs/reference/glossary/taint.md
• https://github.com/kubernetes/website/blob/main/content/en/docs/reference/glossary/toleration.md

Problem:

• Regarding the explanation of taint, the Glossary list of core objects is wrong #45972 issue removed the core-object tag, but the phrase core object remains in the description, which may cause confusion.
• For both taint and toleration, the phrasing three required properties: key, value, and effect is used. However, for taint, the value property is optional (not required). Also, for toleration, we can omit one of the key, value, or effect properties.

Proposed Solution:

• Remove the phrase core object from the taint description.
• Remove the term required from the descriptions of both taint and toleration.

FYI:

• Glossary list of core objects is wrong #45972
• [ja] Translate content/en/docs/reference/glossary/taint.md into Japanese #50399
• [ja] Translate content/en/docs/reference/glossary/toleration.md into Japanese #50419

[k8s-ci-robot]

This issue is currently awaiting triage.

SIG Docs takes a lead on issue triage for this website, but any Kubernetes member can accept issues by applying the triage/accepted label.

The triage/accepted label can be added by org members by writing /triage accepted in a comment.

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.

[yuto-kimura-g]

/language en

[lmktfy]

I agree with the report, except the proposes solution. Some of the fields are required and we should document that.