w3c / w3c/json-ld-syntax

minor rewording re application of type-scoped contexts

Open Beginner friendly
#445 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Editorial ErratumRaised
Dominant language
HTML
Stars
139
Forks
23
PR merge metrics
No merged PRs in 30d

Description

In Scoped Contexts, the description of Type-Scoped Contexts has two notes (right after this note):

When expanding, each value of @type is considered (in code point order) where that value is also a term in the active context having its own type-scoped context. If so, that the scoped context is applied to the active context.

The values of @type are unordered, so if multiple types are listed, the order that type-scoped contexts are applied is based on code point ordering

I suggest to merge these two notes and make it more explicit that later contexts override earlier contexts;
and add a last sentence to say explicitly that @type must be present in the JSON-LD instance for type-scoped contexts to work:

When expanding, each value of @type is considered. If the value is also a term in the active context having its own type-scoped context, the scoped context is applied to the active context. If multiple @type types are present they are applied in code point order (since the values of @type are unordered), and terms defined in later scoped contexts take precedence. If no @type is present then no type-scoped contexts are applied.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start in the Scoped Contexts section at the two notes immediately after note 14. Merge the notes using the proposed wording, including code point ordering, precedence for later contexts, and the behavior when @type is absent; the updated specification text should make all three points explicit.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
72/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.