search

w3c / json-ld-syntax

JSON-LD 1.1 Specification
https://w3c.github.io/json-ld-syntax/
Other
112 stars 22 forks source link

Specs have references to themselves. #186

Closed gkellogg closed 5 years ago

gkellogg commented 5 years ago

For example, there’s a reference to [JSON-LD11], which shouldn’t be there. This is due to some change in ReSpec.

gkellogg commented 5 years ago

See https://github.com/w3c/respec/issues/2363; ReSpec should be filtering them out.

gkellogg commented 5 years ago

There are also problems with data-cite where the citation is a self-reference. For example in the last WD, the definition for context references "The Context" section which is not a relative URL, but a link back to the ED with ReSpec query parameters used for publishing.

Unless something can be done in ReSpec, we may need to surround such spans in terms.html with something that can cause them to be removed, or use an alternative text.

gkellogg commented 5 years ago

@marcoscaceres, it doesn't seem that xref is a solution for this. It isn't wrong, but seems odd for a bibliographic section to have an entry for itself.

I might imagine that if in JSON-LD11, a reference to [[JSON-LD11]] might be a direct reference to the document itself, rather than to a bibliographic section. We could eliminate the [[JSON-LD11]] in the spec through post-processing, but we'd still have those that come from data-cite="JSON-LD11#..." that would create entries.

gkellogg commented 5 years ago

Fixed in 989b53bccecde70a8141602f5e9b59b105a769fb, https://github.com/w3c/json-ld-framing/commit/88110d9b3172934d814facaa924ba710cdab6ee3, and https://github.com/w3c/json-ld-api/commit/e1e989c35195449bd45c2899f4b13396ea399a59.