1 files changed, 52 insertions, 0 deletions
diff --git a/testing/web-platform/tests/webvtt/parsing/file-parsing/README.md b/testing/web-platform/tests/webvtt/parsing/file-parsing/README.md
new file mode 100644
index 0000000000..4cff0af952
--- /dev/null
+++ b/testing/web-platform/tests/webvtt/parsing/file-parsing/README.md
@@ -0,0 +1,52 @@
+# Tests for http://w3c.github.io/webvtt/#file-parsing
+
+Tests that expect an 'error' event (due to invalid signature) are:
+
+```bash
+./signature-invalid.html
+./support/*.vtt
+```
+
+Other tests are generated from source files with a custom format. The source files are:
+
+```bash
+./support/*.test
+```
+
+## .test Format
+
+* The first line is the title of the test.
+* Subsequent lines until a blank line contain HTML metadata.
+* Subsequent lines until a `===` line contains JS assertions.
+* Finally the WebVTT file. Special characters can be escaped using python3 escape sequences: `\x00`, `\r`.
+
+## Building Tests
+
+Requirements: Python 3.2 or newer
+
+```bash
+$ python3 tools/build.py
+```
+
+## Spec Coverage Report
+
+There is also a python implementation of the WebVTT file parser algorithm and a
+script to create a test coverage report of this implementation, under `tools/`.
+
+Requirements:
+* Python 3.2 or newer
+* [Coverage.py](https://pypi.python.org/pypi/coverage)
+
+Installing Coverage.py using [pip](https://pypi.python.org/pypi/pip).
+
+```bash
+$ pip3 install coverage
+```
+
+Generating the report:
+
+```bash
+$ python3 spec_report.py
+```
+
+Will output `report.html`.