From 090ce7e721e0ae437365cc970de007fabcf71b98 Mon Sep 17 00:00:00 2001
From: Thomas Moraine <thomas.moraine@vates.tech>
Date: Fri, 3 Jul 2026 10:30:40 +0200
Subject: [PATCH] docs(xo): refactor navbar navigation to create a unified
 documentation ecosystem (#10067)

* docs(xo): overhaul navbar to create a unified doc ecosystem

- Clean up the navbar by dropping the redundant GitHub link (retained in footer).
- Relocate "Blog" to the "What's new in XO 6" sidebar.
- Introduce direct navbar links for XCP-ng and Vates VMS.
- Rename "Documentation" to "Xen Orchestra".

This aligns the navigation layout across our three documentation sites, allowing readers to smoothly transition between ecosystems with a fully unified experience.

Signed-off-by: Thomas Moraine <thomas.moraine@vates.tech>

* docs(xo): move home link from header to footer

To make the navbar cleaner and make space
for the links to the other documentation websites
We're moving the Home link from the header to the footer
and renaming the link to 'About Xen Orchestra'.
Also, we're displaying the 'What's new in XO 6' section again
which now contains a link to the XO blog

Signed-off-by: Thomas Moraine <thomas.moraine@vates.tech>
---
 docs/docusaurus.config.ts | 11 +++++++----
 docs/sidebars.ts          | 10 +++-------
 docs/src/css/custom.css   |  5 +++++
 3 files changed, 15 insertions(+), 11 deletions(-)

diff --git a/docs/docusaurus.config.ts b/docs/docusaurus.config.ts
index 97185a015f..f0acd93d58 100644
--- a/docs/docusaurus.config.ts
+++ b/docs/docusaurus.config.ts
@@ -241,10 +241,9 @@ export default {
       title: 'Xen Orchestra Documentation',
       logo: { alt: 'Xen Orchestra logo', src: 'img/logo.png', href: '/' },
       items: [
-        { href: 'https://xen-orchestra.com', label: 'Home', position: 'right' },
-        { href: 'https://xen-orchestra.com/blog/', label: 'Blog', position: 'right' },
-        { href: '/', label: 'Documentation', position: 'right' },
-        { href: 'https://github.com/vatesfr/xen-orchestra', label: 'GitHub', position: 'right' },
+        { to: 'https://docs.vates.tech/', label: 'Vates VMS', position: 'right', target: '_self'},
+        { to: 'https://docs.xcp-ng.org/', label: 'XCP-ng', position: 'right', target: '_self'},
+        { href: '/', label: 'Xen Orchestra', position: 'right' },
       ],
     },
     footer: {
@@ -253,6 +252,10 @@ export default {
         {
           title: 'Learn',
           items: [
+            {
+              label: 'About Xen Orchestra',
+              href: 'https://xen-orchestra.com/#!/xo-home',
+            },
             {
               label: 'Introduction',
               href: '/',
diff --git a/docs/sidebars.ts b/docs/sidebars.ts
index eb187d20ef..f0003ff7b7 100644
--- a/docs/sidebars.ts
+++ b/docs/sidebars.ts
@@ -44,17 +44,13 @@ export default {
       collapsible: true,
       collapsed: false,
       items:[
-        /* These categories are hidden until they no longer only contain blank pages
         {
           type: 'category',
           label: 'What\'s new in XO6',
-          collapsible: true,
-          collapsed: true,
-          items:[
-            'xo6/whatsnew',
-            'xo6/xo6vsxo5',
-          ],
+          type: 'link',
+          href: 'https://xen-orchestra.com/blog/',
         },
+        /* These categories are hidden until they no longer only contain blank pages
         {
           type: 'category',
           label: 'Getting started',
diff --git a/docs/src/css/custom.css b/docs/src/css/custom.css
index 9a0e5f7e96..05b46d252e 100644
--- a/docs/src/css/custom.css
+++ b/docs/src/css/custom.css
@@ -29,6 +29,11 @@
   --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.3);
 }
 
+/* Make all text links inside the navbar bold */
+.navbar__item {
+  font-weight: bold;
+}
+
 [data-theme='dark'] .DocSearch {
   --docsearch-text-color: var(--ifm-font-color-base);
   --docsearch-muted-color: var(--ifm-color-secondary-darkest);