feat(documentation): reorganize the whole documentation

site/data/plugins.yml

@@ -1,10 +1,10 @@
 - name: Alert
   description: Show and hide alert messages to your users.
-  link: components/alerts/#javascript-behavior
+  link: components/alert/#javascript-behavior
 
 - name: Button
   description: Programmatically control the active state for buttons.
-  link: components/buttons/#button-plugin
+  link: components/button/#button-plugin
 
 - name: Carousel
   description: Add slideshows to any page, including support for crossfade.
@@ -16,7 +16,7 @@
 
 - name: Dropdown
   description: Create menus of links, actions, forms, and more.
-  link: components/dropdowns/
+  link: components/dropdown/
 
 - name: Modal
   description: Add flexible and responsive dialogs to your project.
@@ -28,20 +28,20 @@
 
 - name: Popover
   description: Create custom overlays. Built on Popper.
-  link: components/popovers/
+  link: components/popover/
 
 - name: Scrollspy
   description: Automatically update active nav links based on page scroll.
   link: components/scrollspy/
 
 - name: Tab
   description: Allow Bootstrap nav components to toggle contents.
-  link: components/navs-tabs/
+  link: components/nav-tab/
 
 - name: Toast
   description: Show and hide notifications to your visitors.
-  link: components/toasts/
+  link: components/toast/
 
 - name: Tooltip
   description: Replace browser tooltips with custom ones. Built on Popper.
-  link: components/tooltips/
+  link: components/tooltip/

site/data/sidebar.yml

@@ -6,43 +6,51 @@
   icon_color: body-color
   pages:
     - title: Introduction
+    - title: Migration from Boosted
     - title: Download
     - title: Contents
     - title: Browsers & devices
+    - title: Accessibility
+    - title: RFS
+      draft: true
+    - title: RTL
+      draft: true
     - title: JavaScript
       draft: true
+    - title: Sass
+      draft: true
+    - title: Optimize
+      draft: true
+    - title: Contribute
     - title: Webpack
       draft: true
     - title: Parcel
       draft: true
     - title: Vite
       draft: true
-    - title: Accessibility
-    - title: RFS
-      draft: true
-    - title: RTL
-      draft: true
-    - title: Contribute
+    - title: Migration
 
-- title: Customize
-  icon: palette2
+- title: Foundation
+  icon: design-token-figma
   icon_color: body-color
   pages:
-    - title: Overview
-      draft: true
-    - title: Custom libraries
-    - title: Sass
+    - title: Approach
+    - title: Tokens
       draft: true
-    - title: Options
     - title: Color palette
     - title: Color theme
       draft: true
     - title: Color modes
-    - title: Components
-      draft: true
     - title: CSS variables
       draft: true
-    - title: Optimize
+    - title: Options
+    - title: Reboot
+    - title: Typography
+    - title: Component
+      draft: true
+    - title: Images # Do we keep the following ?
+      draft: true
+    - title: Figures
       draft: true
 
 - title: Layout
@@ -57,73 +65,55 @@
     - title: Utilities
     - title: Z-index
     - title: CSS Grid
-
-- title: Content
-  icon: file-earmark-richtext
-  icon_color: body-color
-  pages:
-    - title: Reboot
-    - title: Typography
-    - title: Images
-      draft: true
-    - title: Tables
-      draft: true
-    - title: Figures
-      draft: true
-
-- title: Forms
-  icon: ui-radios
-  icon_color: body-color
-  pages:
-    - title: Overview
-    - title: Form control
-      draft: true
-    - title: Select
-      draft: true
-    - title: Checkbox
-    - title: Radio button
-    - title: Switch
-    - title: Range
+    - title: Form layout
       draft: true
-    - title: Input group
-      draft: true
-    - title: Floating labels
-      draft: true
-    - title: Quantity selector
-      draft: true
-    - title: Layout
-      draft: true
-    - title: Validation
 
 - title: Components
   icon: menu-button-wide-fill
   icon_color: body-color
   pages:
     - title: Accordion
       draft: true
-    - title: Alerts
+    - title: Alert
       draft: true
     - title: Back to top
       draft: true
     - title: Badge
+      category: Indicator
     - title: Breadcrumb
+      category: Navigation
     - title: Bullet list
-    - title: Buttons
+      category: Content display
+    - title: Button
+      category: Actions
     - title: Button group
       draft: true
     - title: Card
       draft: true
     - title: Carousel
       draft: true
+    - title: Checkbox
+      category: Control
     - title: Close button
       draft: true
     - title: Collapse
       draft: true
-    - title: Dropdowns
+    - title: Divider
+      category: Layout
+    - title: Dropdown
+      draft: true
+    - title: Icon
+      category: Visual assets
+    - title: Floating label
       draft: true
-    - title: Links
     - title: Footer
       draft: true
+    - title: Form control
+      draft: true
+    - title: Input group
+      draft: true
+    - title: Link
+      category: Navigation
     - title: List group
       draft: true
     - title: Local navigation
@@ -132,85 +122,84 @@
       draft: true
     - title: Navbar
       draft: true
-    - title: Navs & tabs
+    - title: Nav & tab
       draft: true
     - title: Offcanvas
       draft: true
     - title: Orange navbar
       draft: true
     - title: Pagination
       draft: true
-    - title: Placeholders
+    - title: Placeholder
       draft: true
-    - title: Popovers
+    - title: Popover
       draft: true
     - title: Progress
       draft: true
+    - title: Quantity selector
+      draft: true
+    - title: Radio button
+      category: Control
+    - title: Range
+      draft: true
     - title: Scrollspy
       draft: true
-    - title: Spinners
+    - title: Select
+      draft: true
+    - title: Spinner
       draft: true
     - title: Stepped process
       draft: true
     - title: Sticker
       draft: true
-    - title: Tags
+    - title: Switch
+      category: Control
+    - title: Table
       draft: true
-    - title: Title bars
+    - title: Tag
       draft: true
-    - title: Toasts
+    - title: Title bar
       draft: true
-    - title: Tooltips
+    - title: Toast
       draft: true
-
-- title: Helpers
-  icon: magic
-  icon_color: body-color
-  pages:
-    - title: Clearfix
-    - title: Color & background
-    - title: Colored links
-    - title: Divider
-    - title: Focus ring
+    - title: Tooltip
       draft: true
-    - title: Position
-    - title: Ratio
-    - title: Stacks
-    - title: Stretched link
-    - title: Text truncation
-    - title: Visually hidden
+    - title: Validation
 
 - title: Utilities
   icon: braces-asterisk
   icon_color: body-color
   pages:
     - title: API
     - title: Background
-    - title: Borders
-    - title: Colors
+    - title: Border
+    - title: Clearfix
+    - title: Color & background
+    - title: Colored link
+    - title: Color
     - title: Display
     - title: Flex
     - title: Float
-    - title: Interactions
+    - title: Focus ring
+      draft: true
+    - title: Interaction
     - title: Object fit
     - title: Opacity
     - title: Overflow
     - title: Position
-    - title: Shadows
+    - title: Ratio
+    - title: Shadow
     - title: Sizing
     - title: Spacing
+    - title: Stack
+    - title: Stretched link
     - title: Text
+    - title: Text truncation
     - title: Vertical align
     - title: Visibility
+    - title: Visually hidden
     - title: Z-index
 
-- title: Extend
-  icon: tools
-  icon_color: body-color
-  pages:
-    - title: Approach
-    - title: Icons
-
 - title: About
   icon: globe2
   icon_color: body-color
@@ -223,10 +212,3 @@
     - title: License
     - title: Translations
     - title: Cookies
-
-- title: Migrations
-  icon: transfers
-  icon_color: body-color
-  pages:
-    - title: Migration
-    - title: Migration from Boosted