UI Improvement for k8s.io/docs/tutorials/kubernetes-basics/create-cluster/cluster-intro/

[gsarkardev]

I am learning Kubernetes from the available documentation. When browsing through tutorials of this good quality, the medium and the way content is formatted becomes crucial for the learner. But I see that ~ 40% or more of the available screen estate is consumed by the very unnecessary section of "Edit this page, Create child page..." etc. Please refer to the marked portion in the screenshot attached to clearly pinpoint the section I'm talking about. The specific page is https://kubernetes.io/docs/tutorials/kubernetes-basics/create-cluster/cluster-intro/.

I feel the section instead of consuming almost half of the page, can be easily moved down at the bottom or moved up to the up of a tutorial. This allows for a better zoomed - in experience as well as a cleaner and more optimal layout when at normal zoom levels.

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

[dipesh-rawat]

Page reported in issue: https://kubernetes.io/docs/tutorials/kubernetes-basics/create-cluster/cluster-intro/
/area web-development

[dipesh-rawat]

The side menu with "Edit this page" options are features of the Docsy theme used by the site. Moving them below the page might not be very practical or feasible. While it is possible to adjust the padding and alignment, I'm concerned about the impact on other pages. The current layout looks good to me, but I'm open to improvements if others have suggestions.

[gsarkardev]

I understand that you might consider changes if others have suggestions.

... I'm concerned about the impact on other pages.

Considering that I'm new to Kubernetes, and not necessarily would have visited other pages, would you mind sharing what is your concern about the impact on other pages?

[aj11anuj]

The blank white sidebar that you are referring to is utilized on other pages to navigate the headings of that page, see below -

• Changing or removing the yellow section can break the site's structure.
• Removing the sidebar may make some pages look empty that contain less content.
• The documentation site is responsive and doesn't cause viewing or reading issues on different devices.