Visual inconsistencies on elements in docs

[dylanf9797]

Hi,

I think there are some inconsistency in the docs.

Examples:

• https://kubernetes.io/docs/concepts/containers/

In this page, why "node" has a tooltip and "Pods" not, in this section ?

Each [node](https://kubernetes.io/docs/concepts/architecture/nodes/) in a Kubernetes cluster runs the containers that form the [Pods](https://kubernetes.io/docs/concepts/workloads/pods/)
assigned to that node. Containers in a Pod are co-located and co-scheduled to run on the same node.

• https://kubernetes.io/docs/setup/best-practices/certificates/

Same thing here
Why no tooltip or link on K8s components ?

Server certificates
Server certificate for the API server endpoint
Server certificate for the etcd server
[Server certificates](https://kubernetes.io/docs/reference/access-authn-authz/kubelet-tls-bootstrapping/#client-and-serving-certificates) for each kubelet (every [node](https://kubernetes.io/docs/concepts/architecture/nodes/) runs a kubelet)
Optional server certificate for the [front-proxy](https://kubernetes.io/docs/tasks/extend-kubernetes/configure-aggregation-layer/)

[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.

[dylanf9797]

These were examples but i think there are others pages like that.

[moficodes]

I don't know where you got these markdown from.

But from the first page you linked these are the actual markdown in the file.

https://github.com/kubernetes/website/blob/main/content/en/docs/concepts/containers/_index.md?plain=1#L27-L30

Each {{< glossary_tooltip text="node" term_id="node" >}} in a Kubernetes
cluster runs the containers that form the
[Pods](/docs/concepts/workloads/pods/) assigned to that node.
Containers in a Pod are co-located and co-scheduled to run on the same node.

The first item is a different thing that renders as a tooltip.

[dylanf9797]

The markdown is wrong, yes, i copied from the website directly instead of the code so it was generated by github, sorry for that but the idea is here.

[moficodes]

For certain items in the doc they use the glossary tooltip to give a quick overview of the definition.

They look different because they are different things. I am not sure if this is something that would need a fix/change.

[dylanf9797]

This {{< glossary_tooltip text="node" term_id="node" >}} creates a link and a tooltip.

On some pages, we have tooltip for pod for example and not on others, I don't understand why.

• https://kubernetes.io/docs/setup/best-practices/certificates/
  Here we have the glossary only for node and not some important items

• https://kubernetes.io/docs/concepts/architecture/
  Here we have it for node, Pod, control plane, Service, container and they can appear multiple times for the same item.

So can anyone explain me why there are differences ?
For example, we should have something like this:

Each {{< glossary_tooltip text="node" term_id="node" >}} in a Kubernetes
cluster runs the containers that form the
{{< glossary_tooltip text="Pods" term_id="pod" >}} assigned to that {{< glossary_tooltip text="node" term_id="node" >}}.
Containers in a {{< glossary_tooltip text="Pod" term_id="pod" >}} are co-located and co-scheduled to run on the same {{< glossary_tooltip text="node" term_id="node" >}}.