Clarify 'always on' sidebar by default in. Closes #165

knadh · knadh · commit f4e78c0dc3d6 · 2026-06-19T15:07:32.000+05:30
diff --git a/docs/content/components/sidebar.md b/docs/content/components/sidebar.md
@@ -5,7 +5,7 @@ description = "Responsive admin dashboard layout with sticky sidebar, optional t
 +++
 
 - Use `data-sidebar-layout` on a container (typically `<body>`) with `<aside data-sidebar>` for the sidebar and `<main>` for content. The sidebar stays sticky while the main content scrolls.
-- On mobile, the sidebar becomes a slide-out overlay toggled by a `[data-sidebar-toggle]` button. To make the sidebar collapsible at all widths, set `data-sidebar-layout="always"`.
+- On mobile, the sidebar becomes a slide-out overlay toggled by a `[data-sidebar-toggle]` button. To show the toggle and make it collapse the sidebar at all widths, set `data-sidebar-layout="always"`.
 - Set the `--sidebar-width` variable to adjust its width globally.
 
 <div class="sidebar-example">
@@ -43,7 +43,7 @@ description = "Responsive admin dashboard layout with sticky sidebar, optional t
 
 ### Always-collapsible
 
-Set `data-sidebar-layout="always"` to keep the toggle visible on all screen sizes.
+Set `data-sidebar-layout="always"` to keep the toggle visible and make it collapse the sidebar on all screen sizes.
 
 ```html
 <body data-sidebar-layout="always">
@@ -76,11 +76,11 @@ Add `data-topnav` to a header element for a full-width top navigation bar. The s
 
 #### Structure
 
-| Attribute             | Element    |                                                          |
-| --------------------- | ---------- | -------------------------------------------------------- |
-| `data-sidebar-layout` | Container  | Grid layout wrapper (sidebar + main), typically `<body>` |
-| `data-sidebar-layout="always"` | Container | Always-collapsible sidebar (toggle visible on screen sizes) |
-| `data-topnav`         | `<header>` | Full-width top nav (optional, spans full width)          |
-| `data-sidebar`        | `<aside>`  | Sticky sidebar element                                   |
-| `data-sidebar-toggle` | `<button>` | Toggles sidebar (mobile) and collapse (always mode)      |
-| `data-sidebar-open`   | Layout     | Applied to layout when sidebar is open                   |
+| Attribute                      | Element    |                                                                                |
+| ------------------------------ | ---------- | ------------------------------------------------------------------------------ |
+| `data-sidebar-layout`          | Container  | Grid layout wrapper (sidebar + main), typically `<body>`                       |
+| `data-sidebar-layout="always"` | Container  | Always-collapsible sidebar (toggle visible and functional on all screen sizes) |
+| `data-topnav`                  | `<header>` | Full-width top nav (optional, spans full width)                                |
+| `data-sidebar`                 | `<aside>`  | Sticky sidebar element                                                         |
+| `data-sidebar-toggle`          | `<button>` | Toggles sidebar (mobile) and collapse (always mode)                            |
+| `data-sidebar-open`            | Layout     | Applied to layout when sidebar is open                                         |
