Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added migration page overview #1061

Draft
wants to merge 52 commits into
base: main
Choose a base branch
from
Draft
Changes from 4 commits
Commits
Show all changes
52 commits
Select commit Hold shift + click to select a range
859a6f1
Added migration page overview
kwennB Oct 24, 2024
93bcaba
Update pages/specification/migration/_index.md
kwennB Oct 25, 2024
d4c8b24
Update pages/specification/migration/_index.md
kwennB Oct 25, 2024
8eb9721
Updated migration overview
kwennB Oct 28, 2024
75ee2a1
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
a967f66
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
b22b2ff
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
c5d352e
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
136ee2e
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
fa6391b
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
83536f1
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
dd364ba
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
dd1d4e7
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
33b69ab
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
9c583ce
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
5a4b8b3
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
24488f9
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
4e5a08d
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
d17e308
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
c5b1f87
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
95276a0
Update pages/specification/migration/_index.md
kwennB Oct 29, 2024
288e5d9
Update pages/specification/migration/_index.md
kwennB Oct 30, 2024
7199292
Update pages/specification/migration/_index.md
kwennB Oct 30, 2024
8cc36f0
Update pages/specification/migration/_index.md
kwennB Oct 30, 2024
45aecbc
Update pages/specification/migration/_index.md
kwennB Oct 30, 2024
65ba898
Update pages/specification/migration/_index.md
kwennB Oct 30, 2024
9891c6e
Update pages/specification/migration/_index.md
kwennB Oct 30, 2024
5bdfc65
added updates to migration overview
kwennB Oct 30, 2024
3ef35de
Adding migration folders and cards
benjagm Nov 2, 2024
a68d4f3
updated overview
kwennB Nov 7, 2024
65325b8
renamed page and added metadata
benjagm Nov 8, 2024
419ea36
updated links to the rights migration docs
benjagm Nov 8, 2024
43f9816
Added Alterschema details and individual draft pages
kwennB Nov 8, 2024
bb62eaa
Added migration data to single page-Draft 3-4.
kwennB Nov 12, 2024
757f1f9
Updated the Draft 3-4
kwennB Nov 14, 2024
5eae100
Updated Draft 3-4
kwennB Nov 15, 2024
93da171
Update pages/specification/migration/_index.md
kwennB Nov 20, 2024
994f731
Update pages/draft-04/migration-notes.md
kwennB Nov 20, 2024
ffcf639
Update pages/draft-04/migration-notes.md
kwennB Nov 20, 2024
b439468
Update pages/draft-04/migration-notes.md
kwennB Nov 20, 2024
85b9ceb
Update pages/draft-04/migration-notes.md
kwennB Nov 20, 2024
81ebeea
Updated Draft 3-4 & Overview
kwennB Nov 24, 2024
d718e51
added draft 2-3
kwennB Nov 24, 2024
3a5a632
Update pages/draft-04/migration-notes.md
kwennB Dec 2, 2024
33e536b
Update pages/specification/migration/_index.md
kwennB Dec 2, 2024
266963b
Update pages/specification/migration/_index.md
kwennB Dec 2, 2024
e75e0da
Update pages/specification/migration/_index.md
kwennB Dec 2, 2024
78d912a
Update pages/specification/migration/_index.md
kwennB Dec 2, 2024
5a46c9d
Update pages/draft-03/migration-notes.md
kwennB Dec 2, 2024
91c3b63
Update pages/draft-03/migration-notes.md
kwennB Dec 2, 2024
ddec102
Update pages/draft-03/migration-notes.md
kwennB Dec 2, 2024
f0fd4c2
Updated draft 2-3
kwennB Dec 2, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
75 changes: 74 additions & 1 deletion pages/specification/migration/_index.md
kwennB marked this conversation as resolved.
Show resolved Hide resolved
Original file line number Diff line number Diff line change
Expand Up @@ -3,5 +3,78 @@ title: Migrating from older drafts
section: docs
---

The release notes discuss the changes impacting users and implementers:
### Introduction

Just as your schemas evolve over time, the JSON Schema specification does as well. This guide provides useful information to make upgrading your schemas across versions of the specification a breeze.
kwennB marked this conversation as resolved.
Show resolved Hide resolved

Learn how to use our migration guides and tooling ([AlterSchema](https://alterschema.sourcemeta.com/)) to bring your work with you.
kwennB marked this conversation as resolved.
Show resolved Hide resolved

### Keywords Overview

Here is a comprehensive overview to get you going.
kwennB marked this conversation as resolved.
Show resolved Hide resolved

| All Keywords | Specification | Draft introduction | Removed | Changed |
| ----------------------- | ------------- | ------------------ | ------- | ------------------------------ |
| `$anchor` | Core | 2019-09 | No | No (updated in 2020) |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `$comment` | Core | 07 | Yes | - |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `$id` | Core | 06 | No | Replaced `id` |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `$defs` | Core | 2019-09 | No | Replaced `definitions` |
| `$dynamicAnchor` | Core | 2020-12 | No | Replaced `$recursiveAnchor` |
| `$dynamicRef` | Core | 2020-12 | No | Replaced `$recursiveRef` |
| `$recursiveAnchor` | Core | 2019-09 | No | Replaced by `$dynamicAnchor` |
| `$recursiveRef` | Core | 2019-09 | No | Replaced by `$dynamicRef` |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `$ref` | Core | 2019-09 | No | No |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `$schema` | Core | 02 | No | No |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `$vocabualry` | Core | 2019-09 | No | No |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `additionalItems` | Core | 03 | No | No |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `allOf` | Core | 04 | No | No |
| `anyOf` | Core | 04 | No | No |
| `const` | Validation | 06 | No | No |
| `contains` | Core | 06 | No | No |
| `contentEncoding` | Validation | 07 | No | No |
| `contentMediaType` | Validation | 07 | No | No |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `contentSchema` | Validation | 2019-09 | No | No |
| `definitions` | Validation | 04 | No | Replaced by` $defs` |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `default` | Validation | 01 | No | No |
| `dependencies` | Core | 03 | No | No |
| `dependentRequired` | Validation | 2019-09 | No | No |
| `dependentSchemas` | Core | 2019-09 | No | Replaced `dependencies` |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `deprecated` | Validation | 2019-09 | No | No |
| `disallow` | Validation | 03 | Yes | No |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `divisibleBy` | Validation | 02 | No | Replaced by `multipleOf` |
| `else` | Core | 07 | No | No |
| `enum` | Validation | 01 | No | No |
| `examples` | Validation | 06 | No | No |
| `exclusiveMaximum` | Validation | 03 | No | Replaced `maximumCanEqual` |
| `exclusiveMinimum` | Validation | 03 | No | Replaced `minimumCanEqual` |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `extends` | Validation | 03 | Yes | No |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `format` | Validation | 02 | No | - |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `id` | Core | 04 | No | Replaced by `$id` |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `if` | Core | 07 | No | No |
| `items` | Core | 2019-09 | No | Replaced by `prefixItems` |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `maxContains` | Validation | 2019-09 | No | No |
| `maxProperties` | Validation | 04 | No | No |
| `maximumCanEqual` | Validation | 02 | No | Replaced by `exclusiveMaximum` |
| `minimumCanEqual` | Validation | 02 | No | Replaced by `exclusiveMinimum` |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `minContains` | Validation | 2019-09 | No | No |
| `minProperties` | Validation | 04 | No | No |
| `multipleOf` | Validation | 04 | No | Replaced `divisibleBy` |
| `not` | Core | 04 | No | No |
| `oneOf` | Core | 04 | No | No |
| `optional` | Validation | 02 | No | Replaced by `required` |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `pattern` | Core | 03 | No | No |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `patternProperties` | Core | 03 | No | No |
| `prefixItems` | Core | 2020-12 | No | Replaced `items` |
| `propertyNames` | Core | 06 | No | No |
| `readOnly` | Validation | 07 | No | No |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `required` | Validation | 03 | No | No |
| `requires` | Validation | 02 | Yes | - |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `title` | Validation | 01 | No | No |
| `then` | Core | 07 | No | No |
| `type` | Validation | 02 | No | No |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `unevaluatedItems` | Core | 2019-09 | No | No |
| `unevaluatedProperties` | Core | 2019-09 | No | No |
| `uniqueItems` | Assertion | 02 | Yes | No |
kwennB marked this conversation as resolved.
Show resolved Hide resolved
| `writeOnly` | Validation | 07 | No | No |

For a detailed read-through about all the changes see each Draft migration guide.
kwennB marked this conversation as resolved.
Show resolved Hide resolved