feat: restructure docs

[anxolin]

Description

This PR restructure the documentation to be simpler to navigate and understand.

Disclaimer

This change has been vibe code using Claude. We can review it and accept it or use it as a prototype to experiment with this idea of simplifying the docs.

Context

It is a bit hard to find anything in https://docs.cow.fi anymore.

The main reason is that it tries to document all products in the same place. Normally, readers only learn about one product at a time.

Trying to have all the produc pages under the same menu increases the number of levels in the menu. There's some pages that are hidden in level 5!!! (see how ideally 2 levels is best https://ux.stackexchange.com/questions/38948/two-level-menus-why-and-when?utm_source=chatgpt.com)

Breaking in apps removes all the cluter and allow us to have a better search, only local to the product.

Also, I took this chance to highlight more products like the widget, and make the SDK and API more accesible.

Changes

• Breaks the docs into multiple products
• Creates a better landing
• Creates a navigation menu to jump between products or access the DAO pages
• Creates a product for the widget
• Promotes CoW Swap also as product
• Make the API and SDK, critical parts of integration to be in LEVEL 1 of the menu

Test

https://docs-git-restructure-docs-cowswap.vercel.app/

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Updated (UTC)
docs	Ready	Preview	Oct 30, 2025 3:59pm

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch restructure-docs

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[anxolin]

Will be closed. Context here: https://nomevlabs.slack.com/archives/C035N0YEB6J/p1761829543409939

DEMO: https://docs-git-restructure-docs-cowswap.vercel.app

Pawel plans to enhance the docs, might take also some ideas from thie PoC