Re: [remote-playback] Fix ReSpec definitions of RemotePlayback interface and other issues. (#151)

> No problem with most of the simplifications to use more modern ReSpec shorthands in that pull request.
> 
> That said, I see the PR also updates the spec so that the IDL definitions end up in the IDL block. That is not the recommended way. At least, that's not the [recommended approach in the ReSpec Documentation](https://respec.org/docs/#ideal-linking-setup) (FWIW, the Presentation API spec follows that recommendation).

I can try to follow that setup but I would like to understand how it works first; the ReSpec guide doesn't seem to explain how you can have multiple definitions of the same term.
 
> You mention #137 but that change is not going to have any impact from a cross-reference perspective. Whether definitions are in an IDL block or in the prose, ReSpec understand they are IDL terms and will export them with the right attributes so that they can be picked up by tools that creates cross-references databases. Typically, IDL terms are already in [ReSpec's cross-ref database](https://respec.org/xref/?term=RemotePlayback) and you can already use `{{RemotePlayback}}` from another ReSpec spec. These terms cannot be used from within a Bikeshed spec for now because the Remote Playback API is not part of Shepherd's crawl. Nothing prevents that and I requested addition some time ago in [tabatkins/bikeshed#1664](https://github.com/tabatkins/bikeshed/issues/1664)

From the issue it sounded like we shouldn't submit this spec for cross referencing yet because of issues with term definitions like `RemotePlayback`; @tabatkins says you can't define it with a plain `<dfn>`, which is what this PR is trying to resolve.



-- 
GitHub Notification of comment by mfoltzgoogle
Please view or discuss this issue at https://github.com/w3c/remote-playback/pull/151#issuecomment-1262538556 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Thursday, 29 September 2022 16:45:34 UTC