docs(schema): add deprecation policy

[markborkum]

No description provided.

[macintoshpie]

Looks great 👍

[corymosiman12]

Putting it in the schema seems fine but can we also add it to developer docs?

[corymosiman12]

Also add to developer docs

[markborkum]

Putting it in the schema seems fine but can we also add it to developer docs?

I'd prefer not. If the deprecation policy is an intrinsic part of schema file, then it is exchanged with the schema file and it travels with the schema file, wherever it goes. Having an alternate representation of the deprecation policy in the docs/ folder is disadvantageous because it would force us to either maintain a duplicate the same content or to maintain a URL, which must be resolvable, within the schema file to a "raw" file (e.g., in the GitHub repository).

[corymosiman12]

Sure I mean maybe we just make a note in the developer docs that the deprecation policy is defined by the schema doc. My point is most people look to documentation on Github. It wouldn't be intuitive to me that the deprecation policy is defined in the Schema itself.

[corymosiman12]

🌭

[nllong]

looks great.

[nllong]

👍