descriptions

content/components/accordion.md

@@ -1,6 +1,6 @@
 ---
 title: Accordion
-description: Organizes content into collapsible sections.
+description: Organizes content into collapsible sections, allowing users to focus on one section at a time.
 ---
 
 <script>

content/components/alert-dialog.md

@@ -1,6 +1,6 @@
 ---
 title: Alert Dialog
-description: Presents critical information or prompts to the user, typically requiring their attention or action.
+description: A modal window that alerts users with important information and awaits their acknowledgment or action.
 ---
 
 <script>

content/components/aspect-ratio.md

@@ -1,6 +1,6 @@
 ---
 title: Aspect Ratio
-description: Displays content with a specified aspect ratio, ensuring consistent and visually balanced presentation.
+description: Displays content while maintaining a specified aspect ratio, ensuring consistent visual proportions.
 ---
 
 <script>

content/components/avatar.md

@@ -1,6 +1,6 @@
 ---
 title: Avatar
-description: Displays images with a fallback option for failed loading, ensuring consistent visual representation.
+description: Represents a user or entity with a recognizable image or placeholder in UI elements.
 ---
 
 <script>

content/components/calendar.md

@@ -1,6 +1,6 @@
 ---
 title: Calendar
-description: A calendar component.
+description: Displays dates and days of the week, facilitating date-related interactions.
 ---
 
 <script>

content/components/checkbox.md

@@ -1,6 +1,6 @@
 ---
 title: Checkbox
-description: Allow users to mark options as checked, unchecked, or indeterminate, accommodating versatile states.
+description: Allow users to switch between checked, unchecked, and indeterminate states.
 ---
 
 <script>

content/components/collapsible.md

@@ -1,6 +1,6 @@
 ---
 title: Collapsible
-description: An interactive component which expands and collapses content.
+description: Conceals or reveals content sections, enhancing space utilization and organization.
 ---
 
 <script>

content/components/context-menu.md

@@ -1,6 +1,6 @@
 ---
 title: Context Menu
-description: Displays a menu at the pointer's position when the trigger is right-clicked or long-pressed.
+description: Displays options or actions relevant to a specific context or selected item, triggered by a right-click.
 ---
 
 <script>

content/components/date-field.md

@@ -1,6 +1,6 @@
 ---
 title: Date Field
-description: A date field component.
+description: Enables users to input specific dates within a designated field.
 ---
 
 <script>

content/components/date-picker.md

@@ -1,6 +1,6 @@
 ---
 title: Date Picker
-description: A date picker component.
+description: Facilitates the selection of dates through an input and calendar-based interface.
 ---
 
 <script>

content/components/date-range-field.md

@@ -1,6 +1,6 @@
 ---
 title: Date Range Field
-description: A date range field component.
+description: Allows users to input a range of dates within a designated field.
 ---
 
 <script>

content/components/date-range-picker.md

@@ -1,6 +1,6 @@
 ---
 title: Date Range Picker
-description: A date range picker component.
+description: Facilitates the selection of date ranges through an input and calendar-based interface.
 ---
 
 <script>

content/components/dialog.md

@@ -1,6 +1,6 @@
 ---
 title: Dialog
-description: A window overlaid on either the primary window or another dialog window, rendering the content underneath inert.
+description: A modal window presenting content or seeking user input without navigating away from the current context.
 ---
 
 <script>

content/components/dropdown-menu.md

@@ -1,6 +1,6 @@
 ---
 title: Dropdown Menu
-description: Displays a menu to the user, which can consist of links or functions, triggered by a button.
+description: Displays a menu of items that users can select from when triggered.
 ---
 
 <script>

content/components/label.md

@@ -1,6 +1,6 @@
 ---
 title: Label
-description: An enhanced version of the native HTML label element.
+description: Identifies or describes associated UI elements.
 ---
 
 <script>

content/components/link-preview.md

@@ -1,6 +1,6 @@
 ---
 title: Link Preview
-description: Enable sighted users to preview content behind a link.
+description: Displays a summarized preview of a linked content's details or information.
 ---
 
 <script>

content/components/menubar.md

@@ -1,6 +1,6 @@
 ---
 title: Menubar
-description: Displays a list of menus that can be used to control the application.
+description: Organizes and presents a collection of menu options or actions within a horizontal bar.
 ---
 
 <script>

content/components/popover.md

@@ -1,6 +1,6 @@
 ---
 title: Popover
-description: Displays content in a floating container that appears above the surrounding content.
+description: Display supplementary content or information when users interact with specific elements.
 ---
 
 <script>

content/components/progress.md

@@ -1,6 +1,6 @@
 ---
 title: Progress
-description: A visual indicator that displays the progress of a task, usually in the form of a progress bar.
+description: Visualizes the progress or completion status of a task or process.
 ---
 
 <script>

content/components/radio-group.md

@@ -1,6 +1,6 @@
 ---
 title: Radio Group
-description: Allows users to select a single option from a predetermined set of choices.
+description: Allows users to select a single option from a list of mutually exclusive choices.
 ---
 
 <script>

content/components/range-calendar.md

@@ -1,6 +1,6 @@
 ---
 title: Range Calendar
-description: A calendar component with range selection.
+description: Presents a calendar view tailored for selecting date ranges.
 ---
 
 <script>

content/components/select.md

@@ -1,6 +1,6 @@
 ---
 title: Select
-description: Enable users to choose a single option from a dropdown menu that presents a list of selectable items.
+description: Enables users to choose from a list of options presented in a dropdown.
 ---
 
 <script>

content/components/separator.md

@@ -1,6 +1,6 @@
 ---
 title: Separator
-description: Visually divide or separate sections or elements, providing clarity and organization.
+description: Visually separates content or UI elements for clarity and organization.
 ---
 
 <script>

content/components/slider.md

@@ -1,6 +1,6 @@
 ---
 title: Slider
-description: Enable users to select a value within a specific range with sliding handles.
+description: Allows users to select a value from a continuous range by sliding a handle.
 ---
 
 <script>

content/components/switch.md

@@ -1,6 +1,6 @@
 ---
 title: Switch
-description: Enables users to toggle between two states.
+description: A toggle control enabling users to switch between "on" and "off" states.
 ---
 
 <script>

content/components/tabs.md

@@ -1,6 +1,6 @@
 ---
 title: Tabs
-description: Allows users to navigate between different views
+description: Organizes content into distinct sections, allowing users to switch between them.
 ---
 
 <script>

content/components/toggle-group.md

@@ -1,6 +1,6 @@
 ---
 title: Toggle Group
-description: An interactive component that toggles between two states.
+description: A control element that switches between two states, providing a binary choice.
 ---
 
 <script>

content/components/toggle.md

@@ -1,6 +1,6 @@
 ---
 title: Toggle
-description: An interactive component that toggles between two states.
+description: Groups multiple toggle controls, allowing users to enable one or multiple options.
 ---
 
 <script>

content/components/tooltip.md

@@ -1,6 +1,6 @@
 ---
 title: Tooltip
-description: Displays floating content containing additional information about an action on hover or focus.
+description: Provides additional information or context when users hover over or interact with an element.
 ---
 
 <script>

content/introduction.md

@@ -9,8 +9,9 @@ Under the hood, most of these components are powered by [Melt UI](https://melt-u
 
 ## Credits
 
+- [Bitworks](https://bitworks.cz) - The design team behind the Bits UI documentation and example components.
 - [Melt UI](https://melt-ui.com) - The underlying builder API that powers Bits.
-- [Radix UI](https://radix-ui.com) - The de-facto standard for headless APIs that we've strived to follow.
-- [React Spectrum](https://react-spectrum.adobe.com) - Another incredible collection of headless components we've taken inspiration from.
+- [Radix UI](https://radix-ui.com) - The incredible headless component APIs that we've taken heavy inspiration from.
+- [React Spectrum](https://react-spectrum.adobe.com) - An incredible collection of headless components we've taken inspiration from.
 
 🚧 **UNDER CONSTRUCTION** 🚧