[Bug 26275] New: Make specification more precise

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

            Bug ID: 26275
           Summary: Make specification more precise
           Product: Browser Test/Tools WG
           Version: unspecified
          Hardware: PC
                OS: Linux
            Status: NEW
          Severity: normal
          Priority: P2
         Component: WebDriver
          Assignee: public-browser-tools-testing@w3.org
          Reporter: james@hoppipolla.co.uk
        QA Contact: public-browser-tools-testing@w3.org
                CC: mike@w3.org

This is a sort of meta-bug.

The current spec is a bit confused in a number of ways. It defines everything
in terms of the non-normative client API. It also uses WebIDL to try and define
the message format. In addition the description of the commands is very
imprecise so it's pretty hard to tell what, exactly, the remote end is supposed
to do when it receives a command. Several things need to be changed in order to
fix this:

* Clearly define the message format in terms of something that isn't WebIDL

* Define the deserialisation of messages

* Define how values are extracted from the messages

* Define a bunch of terms and small algorithms that are reused throughout the
spec

* Define some code that matches on the command and sends the message to the
right sub-algorithm

* Define a precise algorithm for each part of the spec, using references to
other specs where necessary to ensure that the behaviour is well defined.

Example of this last style for the "get" command:
https://pastebin.mozilla.org/5528630

* Write a testsuite that is (partially) against the raw JSON protocol so that
the fine details can be tested.

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

Received on Monday, 7 July 2014 10:42:14 UTC