Re: external references in working group documents

> On Apr 4, 2023, at 1:49 PM, Peter F. Patel-Schneider <pfpschneider@gmail.com> wrote:
> 
> External references in RDF Semantics have been converted to <dfn>.   Sometimes this is not what is desired, for example when RDF Semantics refers to the section in RDF Concepts where vocabulary prefixes are provided.
> 
> How are documents supposed to include external references that are not definitions?

ReSpec considers every citation to be a kind of definition, either defined in the spec, or defined in the referenced spec. This is an artifact of the [[spec]] and/or data-cite behavior and is not an error. Although they are “definitions”, they should not be exported as such, but I don’t know of a way to see this just by looking at the spec. Typically, only those terms defined using <dfn> are exported, which can be controlled if you include data-cite (which makes it an alias to the definition in another spec), or class=“no-export”. Machinery which controls WebRef (https://github.com/w3c/webref/) seems to use this to determine definitions published by the different specs.

Feel free to tag me in a PR or offline to look at specific issues.

Gregg


> peter
> 
> 

Received on Tuesday, 4 April 2023 21:14:42 UTC