Add .describe() for annotating types with descriptions

[jasonkuhrt]

Originally came up here https://twitter.com/JasonKuhrt/status/1443331235598700544

Idea is that it would be great to be able to add descriptions to schema types so that it can be passed off to other destinations.

Example:

const foo = z.object({
  bar: z.string().description(`about bar`)
}).description(`about foo`)

[colinhacks]

Added in zod@3.11.4! 👍

Slight change to proposed API:

const schema = z.string().describe("A description.");
schema.description; // =>  "A description."

[yeongjet]

Already documented ? I can't find any information about .describe() in offical doc . @colinhacks