feat: refactor documentation

[roushou]

This PR is a first step to make the documentation more readable and maintainable. There's a lot of subjectivity so feel free to discard if it doesn't align with your taste. The concerns I have with the current documentation:

• Things are packed and unorganized which make harder to know where to look
• There are a lot of superfluous content like code blocks showing return values true, 1000 etc...
• Showing the HTML generated is not necessary following the discussions on this PR feat: refacto CSS #500
• There are a lot of copy paste and often with some parts tied together which make it hard to maintain

The main reference I have is Shadcn because I find it simple to read. I find Radix UI documentation much better because I don't have to switch between tabs but I don't know how to replicate it using Vocs. One common point is that things have enough spacing between them.

There are still some work so feel free to add your changes. Or merge it if you prefer to do it incrementally.

[roushou]

This PR might be better to be reviewed by launching the documentation locally. The main difference with the current documentation is that it emphasizes demos of components by using code-group blocks where the first tab is a Preview and the second the Code used for the preview.

There are a lot of improvements to be done like using snippets so we can benefit from reusability and all the LSP stuff.

Some wording have been changed so feel free to adapt it to your taste.

Also contents in return html blocks have been removed because I don't think that's relevant to show anymore and it's just too much work to maintain.

[Zizzamia]

One quick thought, I am not a fan of Demo being hidden by a tab. Mostly because it adds an extra click when seen.

Even thought they feel cleaner, I like see demo components as I scroll, without the need to click.

[roushou]

Makes sense. Leaving this PR open and will close if there's no positive feedback in the following days.

[roushou]

Closing since nobody seems up for it