[Bug 29741] New: WebDriver spec is a REST API spec and should be documented like one

https://www.w3.org/Bugs/Public/show_bug.cgi?id=29741

            Bug ID: 29741
           Summary: WebDriver spec is a REST API spec and should be
                    documented like one
           Product: Browser Test/Tools WG
           Version: unspecified
          Hardware: All
                OS: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: WebDriver
          Assignee: public-browser-tools-testing@w3.org
          Reporter: uchuugaka@icloud.com
        QA Contact: public-browser-tools-testing@w3.org
                CC: mike@w3.org
  Target Milestone: ---

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.

-- 
You are receiving this mail because:
You are the QA Contact for the bug.

Received on Tuesday, 19 July 2016 15:06:41 UTC