[webauthn] Ambiguous reference to [=Window=] (#1910)

emlun has just created a new issue for https://github.com/w3c/webauthn:

== Ambiguous reference to [=Window=] ==
Bikeshed currently shows this error:

```
LINE ~3513: Multiple possible 'window' dfn refs.
Arbitrarily chose https://drafts.csswg.org/css-color-3/#window
To auto-select one of the following refs, insert one of these lines into a <pre class=link-defaults> block:
spec:css-color-3; type:dfn; text:window
spec:fetch; type:dfn; text:window
spec:screen-capture; type:dfn; text:window
[=Window=]
```

The spec text in question is:

>The [visibility](https://www.w3.org/TR/page-visibility/#visibility-states) and [focus](https://html.spec.whatwg.org/#focus) state of the [Window](https://drafts.csswg.org/css-color-3/#window) object determines whether the [[[Create]](origin, options, sameOriginWithAncestors)](https://w3c.github.io/webauthn/#dom-publickeycredential-create-slot) and [[[DiscoverFromExternalSource]](origin, options, sameOriginWithAncestors)](https://w3c.github.io/webauthn/#dom-publickeycredential-discoverfromexternalsource-slot) operations should continue. When the [Window](https://drafts.csswg.org/css-color-3/#window) object associated with the [Document](https://dom.spec.whatwg.org/#concept-document) loses focus, [[[Create]](origin, options, sameOriginWithAncestors)](https://w3c.github.io/webauthn/#dom-publickeycredential-create-slot) and [[[DiscoverFromExternalSource]](origin, options, sameOriginWithAncestors)](https://w3c.github.io/webauthn/#dom-publickeycredential-discoverfromexternalsource-slot) operations SHOULD be aborted.

And indeed, this quote from the current state of the [editor's draft](https://w3c.github.io/webauthn) incorrectly links to ["Window" in the CSS spec](https://drafts.csswg.org/css-color-3/#window). L2 and L1 both link to ["Window" in the Fetch spec](https://fetch.spec.whatwg.org/#concept-request-window), which also seems incorrect. It seems to me like this should probably point to either the [`Window` interface](https://html.spec.whatwg.org/multipage/nav-history-apis.html#window) or its [`window` property](https://html.spec.whatwg.org/multipage/nav-history-apis.html#dom-window), both in the HTML spec.

There is also a `[=Document=]` link in the same paragraph, which links to the [documents concept](https://dom.spec.whatwg.org/#concept-document) in the DOM spec. I'm not sure if that ought to link to the [`Document` interface](https://dom.spec.whatwg.org/#document) too, but both are right next to each other either way.

## Proposed Change

Change the `[=Window=]` links to `{{Window}}`, thus linking to the [`Window` interface](https://html.spec.whatwg.org/multipage/nav-history-apis.html#window) in the HTML spec.

There are references throughout the DOM spec such as "Each [Window](https://html.spec.whatwg.org/multipage/nav-history-apis.html#window) object has an associated **current event**", linking to the `Window` interface. So it seems like `{{Window}} object` is the preferred reference format, rather than linking to the `window` property.

Please view or discuss this issue at https://github.com/w3c/webauthn/issues/1910 using your GitHub account


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

Received on Wednesday, 28 June 2023 10:36:08 UTC