You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Misleading GitHub Link in navbar and broken edit links #415
I've AI-generated a fix for both which works like this:
npm install runs getDocs.js, which copies docs from the repos listed in docs.package.json. While copying, it writes each file's source repo, path and branch to docs.sources.json.
populateStds.js then adds the pages it generates, such as /standards/iaas/scs-0102, to that file and marks them as coming from the standards repo.
During the build, the new plugin docusaurus-plugin-source-repo reads docs.sources.json. It matches every doc page's URL to its source repo and publishes that map as global data.
The navbar GitHub item, now type: 'custom-sourceRepo', looks up the current URL in that map. It links to the matching repo, or falls back to SovereignCloudStack/docs if the page isn't listed.
The operator docs' editUrl uses the same file to build "Edit this page" links that open the file in its source repo.
Before sharing any slop I wanted to get some feedback if this problem is already known and how you think it should be tackled.
This problem has been known for a while (several years I estimate). Of course, one can try to solve it, but this solution here is quite involved and needs quite the brains to be maintained, particularly taking into account that most people working on the docs won't have years of experience with this repo. So if we no longer want to ignore the problem, I suggest we find a simple way to remove the buttons in question.
Activity
mbuechse commentedon Nov 10, 2026
This problem has been known for a while (several years I estimate). Of course, one can try to solve it, but this solution here is quite involved and needs quite the brains to be maintained, particularly taking into account that most people working on the docs won't have years of experience with this repo. So if we no longer want to ignore the problem, I suggest we find a simple way to remove the buttons in question.