Document the ory.sh/kratos object (schema extensions) with a schema

[space88man]

Preflight checklist

• I could not find a solution in the existing issues, docs, nor discussions.
• I agree to follow this project's Code of Conduct.
• I have read and am following this repository's Contribution Guidelines.
• This issue affects my Ory Network project.
• I have joined the Ory Community Slack.
• I am signed up to the Ory Security Patch Newsletter.

Describe your problem

The ory.sh/kratos object used in Identity Schema Extension is not clearly defined but instead is presented by example and in several locations. See the discussion here: ory/kratos#3389

It would be useful for a single JSON schema to be used to describe the properties and types allowed in this object.

Describe your ideal solution

A JSON schema for the object used as a ory.sh/kratos property

Workarounds or alternatives

See by example what properties this object contains as listed in the discussion ory/kratos#3389

Version

v1.0.0

Additional Context

In the examples, the ory.sh/kratos property suddenly pops up as it is needed for Identity Schema Extensions. There isn't a section in the documentation that clearly defines the purpose and schema of this object.

[vinckr]

Thanks for the issue!
I transferred it to /docs as it just documenting something that is implemented.
I am not sure where to look but if anyone reading this wants to work on this and needs help with our docs, let me know!