Skip to content

Improve version banner in our docs#3872

Merged
kcp-ci-bot merged 3 commits intokcp-dev:mainfrom
xrstf:fix-docs-banner
Mar 2, 2026
Merged

Improve version banner in our docs#3872
kcp-ci-bot merged 3 commits intokcp-dev:mainfrom
xrstf:fix-docs-banner

Conversation

@xrstf
Copy link
Contributor

@xrstf xrstf commented Mar 2, 2026

Summary

I got triggered hard by our docs shifting themselves down by a few lines every time you navigate through them and load a new page. Everytime I clicked on a link, began to rea---- ah, sorry, everything just shifted down. Infuriating.

This PR moves the JS code from the page head to the end of the <body>, which allows it to immediately get all the necessary DOM elements and inject itself into the page. This significantly reduces the likelihood of a visual tear on pageload.

I also changed the background color a bit, since the contrast was very low and it was hard to read for me. The color was chosen from the !!! note blocks' border.

Old:

screenshot_20260302_143305

New:

screenshot_20260302_143313

I also removed the explicit positioning (setting the top CSS property) since I could not see/reproduce what this might be used for. Without it, it still looks fine in Chrome and Firefox.

Lastly, since I got bit by that, too, I ran txtidy on the docs and stripped all trailing whitespace.

What Type of PR Is This?

/kind documentation

Release Notes

NONE

xrstf added 3 commits March 2, 2026 13:56
On-behalf-of: @SAP christoph.mewes@sap.com
On-behalf-of: @SAP christoph.mewes@sap.com
On-behalf-of: @SAP christoph.mewes@sap.com
@kcp-ci-bot kcp-ci-bot added release-note-none Denotes a PR that doesn't merit a release note. kind/documentation Categorizes issue or PR as related to documentation. dco-signoff: yes Indicates the PR's author has signed the DCO. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Mar 2, 2026
Copy link
Member

@ntnn ntnn left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/lgtm
/approve

@kcp-ci-bot kcp-ci-bot added the lgtm Indicates that a PR is ready to be merged. label Mar 2, 2026
@kcp-ci-bot
Copy link
Contributor

LGTM label has been added.

DetailsGit tree hash: 691c6a426cdb3ae2809565627fd40921f9bbda09

@kcp-ci-bot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: ntnn

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

The pull request process is described here

Details Needs approval from an approver in each of these files:

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

@kcp-ci-bot kcp-ci-bot added the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Mar 2, 2026
@kcp-ci-bot kcp-ci-bot merged commit 97480a1 into kcp-dev:main Mar 2, 2026
6 checks passed
@xrstf xrstf deleted the fix-docs-banner branch March 2, 2026 13:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. dco-signoff: yes Indicates the PR's author has signed the DCO. kind/documentation Categorizes issue or PR as related to documentation. lgtm Indicates that a PR is ready to be merged. release-note-none Denotes a PR that doesn't merit a release note. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants