Merge pull request #3951 from camilamacedo86/book-v3-header

📖 Add header to clarify that book-v3 is legacy documentation
kubernetes-sigs · May 23, 2024 · e71f017 · e71f017
2 parents 9b3a9f1 + b722de5
commit e71f017
Show file tree

Hide file tree

Showing 3 changed files with 34 additions and 1 deletion.
diff --git a/docs/book/theme/css/custom.css b/docs/book/theme/css/custom.css
@@ -1,3 +1,30 @@
 .menu-title img {
     vertical-align: bottom;
 }
+
+#notice-bar {
+    background: var(--bg);
+    padding: 1em;
+    margin-left: calc(-1 * var(--page-padding));
+    margin-right: calc(-1 * var(--page-padding));
+    margin-bottom: 1em;
+
+    border-bottom: 1px solid var(--table-border-color);
+    box-shadow: 0 1px 5px 0 var(--table-border-color);
+}
+
+#notice-bar * {
+    color: var(--fg);
+}
+
+#notice-bar a {
+    text-decoration: none;
+}
+
+#notice-bar a:not(.header) {
+    color: var(--links);
+}
+
+#notice-bar h2 {
+    margin-top: 0;
+}
diff --git a/docs/book/theme/header.hbs b/docs/book/theme/header.hbs
@@ -0,0 +1,3 @@
+<header id="notice-bar">
+    <h2>Viewing legacy documentation for Kubebuilder, check out the <a href="https://book.kubebuilder.io">latest</a> documentation instead.</h2>
+</header>
diff --git a/docs/book/theme/index.hbs b/docs/book/theme/index.hbs
@@ -132,7 +132,8 @@
                             <i class="fa fa-book"></i>
                             </button>
                             <div class="version-dropdown-content">
-                                <a href="https://book.kubebuilder.io/"target="_blank" rel="noopener noreferrer">v3-book</a>
+                                <a href="https://book.kubebuilder.io/"target="_blank" rel="noopener noreferrer">latest (V4x)</a>
+                                <a href="https://book-v3.book.kubebuilder.io/"target="_blank" rel="noopener noreferrer">v3-book</a>
                                 <a href="https://book-v2.book.kubebuilder.io/"target="_blank" rel="noopener noreferrer">v2-book</a>
                                 <a href="https://book-v1.book.kubebuilder.io/"target="_blank" rel="noopener noreferrer">v1-book</a>
                             </div>
@@ -158,6 +159,8 @@
                     </div>
                 </div>
 
+                {{> header}}
+
                 {{#if search_enabled}}
                 <div id="search-wrapper" class="hidden">
                     <form id="searchbar-outer" class="searchbar-outer">