skeleton icon indicating copy to clipboard operation
skeleton copied to clipboard

Docs: Reorganize various doc sections

Open endigo9740 opened this issue 2 months ago • 2 comments

Describe the Issue (screenshots encouraged!)

As we implemented our technical updates to the doc site, I think it will make sense to reorganize a number of sections of the documentation. Below are a few recommendations, but may be expanded over time.

  • [x] Move the “Headless Integration” guides under the standard “Integrations” section. (Per #3991)
  • [x] Move the Iconography section under the “Design System” category. (Per #3991)
  • [x] Rename “Functional Components” → “Framework Components” (Per #3991)
  • [ ] Consider sunsetting the Cookbook section and redistribute content (proposal)
  • [x] Move the Tutorials > Figma guide under the Figma top-level section
  • [x] Find a new home for the “Showcase” section

endigo9740 avatar Oct 15 '25 15:10 endigo9740

Proposed redistribution of Cookbook sections:

Free Blocks
-------------
Alerts
Breadcrumbs
Chat
Dialog Element
Image Layouts
Logo Cloud
Scroll Containers
SVG Filters
Table of Contents

Guides
-------------
Dynamic Theme Switching -> extend Theme docs
Light Switch -> extend Dark Mode docs

Replace w/ Zag Components
-------------
Clipboard API -> Clipboard
Stepper -> Step

Remove / Out of Scope
-------------
Floating UI Attachments

endigo9740 avatar Oct 22 '25 01:10 endigo9740

@Hugos68 let's handle the Cookbook stuff as part of the v5 update. I'll bump this ticket over to that Milestone.

endigo9740 avatar Oct 25 '25 23:10 endigo9740