summaryrefslogtreecommitdiffstats
path: root/testing/web-platform/tests/annotation-protocol/CONTRIBUTING.md
blob: cc585fd7d11c77426536f8c7d7f0e046791441a1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
Annotation-Protocol: Guidelines for Contributing Tests
======================================================

This document describes the method people should use for authoring tests and
integrating them into the repository.  Anyone is welcome to submit new tests to
this collection.  If you do, please create the tests following the guidelines
below.  Then submit them as a pull request so they can be evaluated

Structure
---------

Tests are organized by client or server, and then by major section of the Annotation
Protocol specification.  The folders associated with these are:

* client - tests a client needs to run
* server - tests to be run against a server

Within these folders, special files ending with the suffix ".html" provide the source
for the test as a set javascript calls to perform the test.

* scripts - JavaScript that are included by tests
* tools - supporting scripts and files

Client Test Cases
-----------------

@@@TODO@@@ describe the structure of client test cases.

Server Test Cases
-----------------

@@@TODO@@@ describe the structure of server test cases.


Command Line Tools
------------------

### Stand-alone Annotation Server ###