summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorRick Waldron <waldron.rick@gmail.com>2017-10-10 10:28:52 -0400
committerRick Waldron <waldron.rick@gmail.com>2017-10-10 10:28:52 -0400
commit53778cdf1faf12671817e7a2e2def2d2f1db157a (patch)
tree5651ae2e3c672e53a7ae95d073e7211f6076e947 /README.md
parent1afb7c74fd8752072397259a3ddf6ab85afdf785 (diff)
downloadqtdeclarative-testsuites-53778cdf1faf12671817e7a2e2def2d2f1db157a.tar.gz
readme revisions, first pass
Diffstat (limited to 'README.md')
-rw-r--r--README.md32
1 files changed, 24 insertions, 8 deletions
diff --git a/README.md b/README.md
index 06229022f..7a9ae28ea 100644
--- a/README.md
+++ b/README.md
@@ -1,20 +1,36 @@
-## Test262 is the official ECMAScript (ECMA-262) conformance suite.
+## Test262: ECMAScript Test Suite ([ECMA TR/104]((http://ecma-international.org/publications/techreports/E-TR-104.htm)))
-Test262 tests conformance to the continually maintained draft future ECMAScript standard found at http://tc39.github.io/ecma262/ , together with any Stage 3 or later TC39 proposals. It is maintained by Tom Care (@tcare) and Leo Balter (@leobalter) with significant contributions from many in the ECMAScript community.
-This project is also described by the [Ecma Technical Report 104](http://ecma-international.org/publications/techreports/E-TR-104.htm).
+Test262 is the implementation conformance test suite for the latest drafts (or most recent published edition) of the following Ecma specifications:
+
+- [ECMA-262, ECMAScript Language Specification](https://tc39.github.io/ecma262/)
+- [ECMA-402, ECMAScript Internationalization API Specification](https://tc39.github.io/ecma402/)
+- [ECMA-404, The JSON Data Interchange Format](https://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf) (pdf)
+
+Test262 itself is described in [ECMA TR/104]((http://ecma-international.org/publications/techreports/E-TR-104.htm)) and is included in [ECMA-414](http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-414.pdf) (pdf).
+
+As defined in the [TC39 Process](https://tc39.github.io/process-document/), Stage 4 Entrance Criteria requires tests for new feature proposals to advance. Tests may be written by proposal champions, implementers, or any interested community member.
+
+A **proposal champion** is someone that worked on the feature proposal and specification directly.
+
+An **implementer** is someone that works on implementing the proposal into a JavaScript engine, parser, runtime or embedding.
+
+A **community member** is _you_, and we welcome you to contribute! If you're having trouble getting started, or even just want to ask a question, feel free to open an issue.
### Contributing to Test262
-> See [CONTRIBUTING.md](./CONTRIBUTING.md)
-1. Sign the [Test262 CLA](http://tc39.github.io/test262-cla).
-2. Send a pull request. Please make sure you have one commit per pull request. If you have multiple commits, squash them before sending the pull request.
+Guidance for contributing to Test262 can be found in [CONTRIBUTING.md](./CONTRIBUTING.md).
+
+**Authors of contributions from non-Ecma member organizations must sign the [Test262 CLA](http://tc39.github.io/test262-cla)**
### Running Test262
-> See [INTERPRETING.md](./INTERPRETING.md)
+Guidance for running Test262 and explanations of how a test file is interpreted by a test runner is in [INTERPRETING](./INTERPRETING.md)
+
+
+### Test262 Runners & Harnesses
-There are a number of volunteer-maintained projects that may be used to execute Test262 in various ECMAScript hosts:
+Volunteer-maintained projects that may be used to execute Test262 in various ECMAScript hosts:
- https://github.com/bterlson/test262-harness (platform: Node.js)
- https://github.com/test262-utils/test262-harness-py (platform: Python)