docs(ContentSwitcher): update docs

[tw15egan]

Closes #6630

Updates ContentSwitcher to new CSF format and adds in prop documentation

Done

• Update to CSF
• Create ContentSwitcher.mdx and fill out with template
• Document any discrepancies for v11

Changelog

New

• Docs tab now includes detailed descriptions of each prop as well as examples and code snippets

Testing / Reviewing

Check updated docs for grammar usage and that the examples look correct

Questions for reviewers:

I've updated the Docs table for both Button and ContentSwitcher to include the prop subsections for easier access. I can remove it if this is too distracting.

Notes for V11

• Need to fix onChange when using keyboard (fix(content-switcher): call onChange with correct data with keyboard #6257)

[netlify]

Deploy preview for carbon-elements ready!

Built with commit 625cde0

https://deploy-preview-6650--carbon-elements.netlify.app

[netlify]

Deploy preview for carbon-components-react ready!

Built with commit 625cde0

https://deploy-preview-6650--carbon-components-react.netlify.app

[joshblack]

Seems great! This is definitely one of our most problematic components, it seems 😬 It's nice to have these docs up though, and I'm curious what you would recommend we change in v11 🤔

It seems like we leave a lot up to our users, and don't implement the accordion pattern if I'm looking at this correctly. Would be great if the component handled switching sections for folks.

Separately, would we want to leave a reference to the current bug with onChange that I have a PR up for over in #6257 ? Or is that better not listed here?

[tw15egan]

@joshblack are we sure that it will always be toggling a content section? I could see this also toggling data in a table, toggling view modes, filtering unread/all email, etc.. so I kind of like that it isn't too prescriptive. Would be worth looking into and getting some feedback (if we haven't compiled that somewhere already).

Will definitely add a note in the PR. Do we want to add anything to the actual docs?