Skip to content

docs(ep3): name the schemas in the Organization note - #201

Merged
simontaurus merged 1 commit into
mainfrom
docs/ep3-org-note
Oct 8, 2026
Merged

simontaurus merged 1 commit into
mainfrom
docs/ep3-org-note

Conversation

@simontaurus

Copy link
Copy Markdown
Contributor

Slide 7 said:

Organization does both at once: an extension at the root, and an embedded object under the address property.

"An extension at the root" is a nominalisation that makes the reader reconstruct what is being extended, and it names neither schema. The diagram directly above the note shows Thing.schema.json and Address.schema.json by name, and the code panel shows "allOf": [ { "$ref": "Thing.schema.json" } ].

Organization does both at once: it extends Thing in allOf at the root, and embeds Address under the address property.

Both halves are verbs now, and both name the schema on screen. "in allOf at the root" is the phrasing the later comparison slide already uses.

'an extension at the root' made the reader reconstruct which schema is
extended, while the diagram above names Thing and Address.
@github-actions

github-actions Bot commented Oct 8, 2026

Copy link
Copy Markdown
Contributor

tutorials beats changed by this pull request

ep3-dark - 1 changed

07-hasa-organization (before | after)

07-hasa-organization

ep3-light - 1 changed

07-hasa-organization (before | after)

07-hasa-organization

Rendered from b5f8754d071f12c3f1c9a42e1496b75db46fa848. Left is the merge base, right is this pull request. Images live on the ci-review-images prerelease, not in the repository.

@simontaurus
simontaurus merged commit b0952be into main Oct 8, 2026
14 checks passed
@simontaurus
simontaurus deleted the docs/ep3-org-note branch October 8, 2026 06:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant