Improve typechecking, docs, and minor bugs with Field/FieldInfo

[dmontagu]

Selected Reviewer: @lig

[cloudflare-pages]

Deploying with    Cloudflare Pages

Latest commit:	4c0aeb5
Status:	✅  Deploy successful!
Preview URL:	https://a80804d3.pydantic-docs2.pages.dev
Branch Preview URL:	https://field-updates.pydantic-docs2.pages.dev

View logs

[dmontagu]

please review

[dmontagu]

This adds a change that breaks pydantic-settings. I have opened a PR that will fix that in pydantic/pydantic-settings#59. I will disable CI for pydantic settings here for now then we can reenable once everything is back in sync.

[dmontagu]

Not sure why cloudflare pages is failing but that's the only problem now. (Because I disabled the run of pydantic-settings. We could re-enable once it is updated to use this version of pydantic.)

Perhaps related to it needing to clone pydantic-settings for the docs..?

---

For context, the reason pydantic-settings is incompatible with this branch is because I changed FieldInfo from storing the pre-processed validation_alias that is compatible with pydantic-core into keeping AliasChoices and AliasPath unmodified. (Right now, pydantic-settings expects validation_alias to potentially be a list, not AliasPath/AliasChoices.)

(And as noted above, I have already opened a PR on pydantic-settings that will fix its compatibility with pydantic.)

[dmontagu]

Going to try reopening to see if that resolves the cloudflare build issue..

[dmontagu]

Hmm nope couldn't get it to work. @samuelcolvin I guess I need some info about the cloudflare thing

[hramezani]

@dmontagu Why do we need to addpydantic-settings as submodule here?