Merge branch '6-dev' into bump-plone-6.0.0.2

Author: stevepiercy

.github/workflows/test.yml

@@ -20,6 +20,14 @@ jobs:
         run: |
           python -m pip install --upgrade pip
           pip install -q -r requirements.txt
+          sudo snap install --edge vale
 
       - name: Run tests with make test
         run: make test
+
+      - name: Run vale
+        run: |
+          git clone https://github.com/errata-ai/Microsoft.git
+          cp -r ./Microsoft/Microsoft ./styles
+          VALEFILES=$(find -L ./docs/ -type d \( -path "./docs/plone.restapi/lib/*" -o -path "./docs/plone.restapi/performance/*" \) -prune -false -o -type f -name "*.md" -print)
+          vale --no-exit $VALEFILES

docs/_static/switcher.json

@@ -0,0 +1,19 @@
+[
+    {
+        "name": "6 (stable)",
+        "version": "6.0",
+        "url": "https://6.docs.plone.org/"
+    },
+    {
+        "version": "5",
+        "url": "https://5.docs.plone.org/"
+    },
+    {
+        "version": "4",
+        "url": "https://4.docs.plone.org/"
+    },
+    {
+        "version": "3",
+        "url": "https://3.docs.plone.org/"
+    }
+]

docs/_templates/page.html

@@ -4,12 +4,13 @@
 <title>{{ title|striptags|e }}{%- for parent in parents %} – {{ parent.title }}{%- endfor %}{{ titlesuffix }}</title>
 {%- endblock %}
 
+
 {% block footer %}
     <script type="text/javascript">
         $(document).ready(function() {
             // Hide empty sub menu.
-            if ($.trim($(".topbar-contents .bd-toc").html()) === "") {
-                $(".topbar-contents .bd-toc").css("visibility", "hidden");
+            if ($.trim($(".sticky-top .bd-toc").html()) === "") {
+                $(".sticky-top .bd-toc").css("visibility", "hidden");
             }
         });
     </script>

docs/_templates/sections/sidebar.html

@@ -0,0 +1,4 @@
+{%- for sidebartemplate in sidebars %}
+{%- include sidebartemplate %}
+{%- endfor %}
+{%- include 'version-switcher.html' -%}

docs/conf.py

@@ -123,6 +123,7 @@
     "plone.restapi/news",
     "plone.restapi/performance",
     "plone.restapi/src",
+    "volto/developer-guidelines/branch-policy.md",
 ]
 
 html_js_files = [
@@ -224,13 +225,25 @@
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_use_opensearch
 html_use_opensearch = "https://6.docs.plone.org"
 
+html_sidebars = {
+    "**": [
+        "sidebar-logo.html",
+        "search-field.html",
+        "sbt-sidebar-nav.html",
+    ]
+}
+
 html_theme_options = {
     "path_to_docs": "docs",
     "repository_url": "https://github.com/plone/documentation",
     "repository_branch": "main",
     "use_repository_button": True,
     "use_issues_button": True,
     "use_edit_page_button": True,
+    "switcher": {
+        "json_url": "/_static/switcher.json",
+        "version_match": version,
+    },
     "extra_navbar": """
     <p class="ploneorglink">
         <a href="https://plone.org">