w3c / webdriver-bidi

Bidirectional WebDriver protocol for browser automation
https://w3c.github.io/webdriver-bidi/
336 stars 35 forks source link

List known external specifications #710

Closed OrKoN closed 1 month ago

OrKoN commented 1 month ago

Closes https://github.com/w3c/webdriver-bidi/issues/506


Preview | Diff

jgraham commented 1 month ago

Is there precedent for having this kind of list in the spec itself? It seems like something that's a pain to keep up to date, and might be better served by an external wiki page or similar.

OrKoN commented 1 month ago

I don't know of any precedents but I agree with https://github.com/w3c/webdriver-bidi/issues/506#issuecomment-2092962629 that having links in the spec document would help with discoverability for implementors. As for the overhead of keeping it up to date, I am not sure if it is the same or more effector compared to a wiki page.

whimboo commented 1 month ago

I agree here as well. Having the list of external specs on some Wiki page doesn't make it discoverable. So we would need at least a link to that page in the spec, and updates from our side are necessary in both situations.

sadym-chromium commented 1 month ago

I don't know of any precedents but I agree with #506 (comment) that having links in the spec document would help with discoverability for implementors. As for the overhead of keeping it up to date, I am not sure if it is the same or more effector compared to a wiki page.

+1 for having the links in the spec for discoverability

OrKoN commented 1 month ago

@jgraham do you have concerns still or were they addressed by the discussion? Could we go ahead with merging the PR?

jgraham commented 1 month ago

I'm still a bit worried about the maintenance burden here.

Concretely I think we should make two changes:

OrKoN commented 1 month ago

Moved to an appendix.