Refactor documentation

[Kludex]

🚧 WIP

• Related to Refactor documentation #7322

Checklist

• Remember to check if all redirect links are included on the mkdocs.yml. See how to do it on

  pydantic/mkdocs.yml

  Lines 211 to 212 in 3b297ad

  	'usage/validation_errors.md': 'errors/validation_errors.md'
  	'usage/errors.md': 'errors/usage_errors.md'

  .

Note

Should we really squash this?

[cloudflare-pages]

Deploying with    Cloudflare Pages

Latest commit:	f849608
Status:	✅  Deploy successful!
Preview URL:	https://33924420.pydantic-docs2.pages.dev
Branch Preview URL:	https://refactor-docs.pydantic-docs2.pages.dev

View logs

[samuelcolvin]

LGTM.

[samuelcolvin]

There are still some links to usage:

pydantic/types.py
1541:    'See https://pydantic-docs.helpmanual.io/usage/types/extra_types/payment_cards/.',

pydantic/color.py
11:    See [`pydantic-extra-types.Color`](../usage/types/extra_types/color_types.md)
73:    'See https://pydantic-docs.helpmanual.io/usage/types/extra_types/color_types/.',

pydantic/_internal/_generate_schema.py
253:            f'`json_encoders` is deprecated. See https://docs.pydantic.dev/{version_short()}/usage/serialization/#custom-serializers for alternatives',

docs/plugins/main.py
235:    if page.file.src_uri != 'usage/schema.md':
265:    if page.file.src_uri != 'usage/conversion_table.md':

docs/blog/pydantic-v2.md
647:[`__get_validators__`](https://docs.pydantic.dev/usage/types/#classes-with-__get_validators__)
754:7. [Settings Management](https://docs.pydantic.dev/usage/settings/) ??? - I definitely don't want to

[samuelcolvin]

We should move "API documentation" up/left to just after concepts.

[RitikShah]

I found this documentation system a while back that might be useful for this: https://documentation.divio.com/

it's a bit overwhelming, so I've generally cherry picked ideas, but I love the concept overall.

[samuelcolvin]

Merging this, we can work on more stuff, from main.

Still to do:

• move more stuff from concepts to API docs
• check all old pages have redirects