w3c / webdriver-bidi

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

Document our design principles / rules of thumb #78

Open foolip opened 3 years ago

foolip commented 3 years ago

In https://github.com/w3c/webdriver-bidi/issues/46#issuecomment-739803667 I spelled out a principle about the ability to implement WebDriver BiDi both as part of a driver binary like ChromeDriver, or as part of the browser directly, and avoiding assumptions that only make sense in one scenario. @jgraham agreed:

I don't think that there's a requirement that the connection has multiple hops (I don't expect the gecko implementation to have multiple hops in the default case). There may also be middleware that adds additional hops to the connection.

It would be good to write down some things like this which we've converged on, to be able to point to. A few others that come to mind, which I don't know if others agree with:

foolip commented 3 years ago

@sadym-chromium points via in https://github.com/w3c/webdriver-bidi/issues/82 that maybe we should also have a rule about an Id suffix for identifiers.