Closed Bug 1437090 Opened 6 years ago Closed 5 years ago

Add skeleton documentation for WebDriver

Categories

(Developer Documentation Graveyard :: API: Miscellaneous, enhancement)

enhancement
Not set
normal

Tracking

(Not tracked)

RESOLVED FIXED

People

(Reporter: ato, Unassigned)

References

()

Details

The WebDriver standard [1] is missing from MDN, but there are
ongoing implementations in all user agents.  This bug will track
adding skeleton documentation for all commands to MDN.

  [1] https://w3c.github.io/webdriver/webdriver-spec.html
So I have a question. On which content should this document be based on? Is it the latest WdSpec release or the living document (the URL as specified in comment 1). Being based on the latter would require us to keep a constant eye on also updating the MDN content whenever the spec changes. As best an update should be done by the patch author.
(In reply to Henrik Skupin (:whimboo) from comment #2)
> So I have a question. On which content should this document be based on? Is
> it the latest WdSpec release or the living document (the URL as specified in
> comment 1). Being based on the latter would require us to keep a constant
> eye on also updating the MDN content whenever the spec changes. As best an
> update should be done by the patch author.

Ideally the tests and the spec should be aligned as PRs for the spec need test PRs too so let's do it off the document.
(In reply to Henrik Skupin (:whimboo) from comment #2)

> So I have a question. On which content should this document be
> based on? Is it the latest WdSpec release or the living document
> (the URL as specified in comment 1). Being based on the latter
> would require us to keep a constant eye on also updating the MDN
> content whenever the spec changes.

MDN follows the current reality of user agents.  If the
specification reflects reality, which it does for WHATWG and
(mostly) for the WebDriver living document, then we follow that.
The end goal here should be to make end-user documentation that
reflects the tools available to them.
WebDriver is documented here: https://developer.mozilla.org/en-US/docs/Web/WebDriver
Status: NEW → RESOLVED
Closed: 5 years ago
Resolution: --- → FIXED
You need to log in before you can comment on or make changes to this bug.