docs: Add new in version notes

[roll]

• fixes #928

[cloudflare-workers-and-pages[bot]]

Deploying datapackage with    Cloudflare Pages

Latest commit:	36f1938
Status:	✅  Deploy successful!
Preview URL:	https://2e4d568e.datapackage-6gp.pages.dev
Branch Preview URL:	https://928-add-new-in-version-notes.datapackage-6gp.pages.dev

View logs

[roll]

Hi @peterdesmet, can you please take a look?

[roll]

@peterdesmet That's a nice idea regarding new properties. Let me try if I can make it work.

What would you suggest on changes like schema.missingValues (new labeled missingness)

[roll]

Another example - https://radashi.js.org/reference/array/group/

[peterdesmet]

What would you suggest on changes like schema.missingValues (new labeled missingness)

I guess we could mention the version in the text where relevant:

missingValues

...

missingValues MUST be an array where each entry is a unique string, or (since v2.0) an array where each entry is an object.

Although that's probably to hard to maintain. Alternatively, we consistently add a label to all headers where something has changed and link to the corresponding CHANGELOG section for context.

$schema New in v2.0

...

$missingValues Updated in v2.0

...