This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 29741 - WebDriver spec is a REST API spec and should be documented like one
Summary: WebDriver spec is a REST API spec and should be documented like one
Status: NEW
Alias: None
Product: Browser Test/Tools WG
Classification: Unclassified
Component: WebDriver (show other bugs)
Version: unspecified
Hardware: All All
: P2 normal
Target Milestone: ---
Assignee: Browser Testing and Tools WG
QA Contact: Browser Testing and Tools WG
URL: http://raml.org
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2016-07-19 15:06 UTC by uchuugaka
Modified: 2016-07-19 15:08 UTC (History)
2 users (show)

See Also:


Attachments

Description uchuugaka 2016-07-19 15:06:33 UTC
As the WebDriver spec is fundamentally a REST API spec, it makes sense to use a documenting format to define the spec in a clear, unmistakable terms and format.

I would propose using RAML 1.0 as the API spec for WebDriver.
http://raml.org

This makes it more consistent and clear and widely machine readable and human readable and maintainable.