[Badge] Update documentation in Storybook and Docusaurus

[emirgens]

Summary

Documentation should be added or updated to reflect changes in the codebase, clarify existing content, or provide new information to users.

Verify that Storybook documentation is accurate, comprehensive, and user-friendly, including usage guidelines, variant descriptions, accessibility notes, and examples.
Ensure Docusaurus documentation is updated to reflect any changes in the Select's design, usage, or accessibility features.

Acceptance Criteria

• Usage guidelines written (when to use / when not to use)
• Variant descriptions documented
• Accessibility notes included
• Do/Don't examples provided
• Migration notes added (if component replaces or modifies existing version)
• Examples reflect production-ready usage