Fix sidebar component to render slot before

With this preliminary PR,
we display the missing title h2 in sidebar component,
when provided via slot `before`.

- Display slot 'before' if provides, with `<%= slotted :before %>`
- Favor tag h2 for this slot, to have only one h1 per page

This PR will be necessary to display a OpenAPI version select button,
and prepare the release of version v3.2

Author: Polo2

src/_components/shared/sidebar.css

@@ -6,17 +6,18 @@ side-bar {
 
   aside {
     padding: var(--spacing-14) var(--spacing-4);
-  
+
     > button {
       display: none;
     }
   }
 
-  :is(h1) {
+  :is(h2) {
     display: flex;
     flex-wrap: wrap;
     justify-content: space-between;
-    font-size: var(--text-l);
+    align-items: baseline;
+    font-size: var(--text-xl);
     margin-block-end: var(--spacing-4);
 
     span {

src/_components/shared/sidebar.erb

@@ -4,6 +4,7 @@
       <svg width="11" height="12" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="m10 6 .543.517a.75.75 0 0 0 0-1.034L10 6ZM0 6.75h10v-1.5H0v1.5Zm10.543-1.267-4.762-5-1.086 1.034 4.762 5 1.086-1.034Zm-1.086 0-4.762 5 1.086 1.034 4.762-5-1.086-1.034Z" fill="#025FD7"/></svg>
       Hide menu
     </button>
+    <%= slotted :before %>
     <ul class="sidebar-list" data-controller="sidebar">
       <% @data.each do |page| %>
         <li>

src/_guides/openapi/specification/v3.1/_defaults.yml

@@ -1,2 +1,2 @@
-sidebar_version: "v3.1"
+sidebar_version: "3.1"
 sidebar_name: openapi_v3-1

src/_layouts/documentation.erb

@@ -6,10 +6,11 @@ layout: application
 <%= render Shared::Sidebar.new(data: @entries, current: resource) do |sidebar| %>
   <% if resource.data.sidebar_title.present? %>
     <% sidebar.slot :before do %>
-      <h1>
+      <h2>
         <%= resource.data.sidebar_title %>
+        <% # TODO: replace by select with version v3.2 %>
         <span class="version"><%= resource.data.sidebar_version %></span>
-      </h1>
+      </h2>
     <% end %>
   <% end %>
   <% if resource.data.display_cta.present? %>