readme revisions, first pass

This commit is contained in:
Rick Waldron 2017-10-10 10:28:52 -04:00
parent 1afb7c74fd
commit 53778cdf1f

View File

@ -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 ### Contributing to Test262
> See [CONTRIBUTING.md](./CONTRIBUTING.md)
1. Sign the [Test262 CLA](http://tc39.github.io/test262-cla). Guidance for contributing to Test262 can be found in [CONTRIBUTING.md](./CONTRIBUTING.md).
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.
**Authors of contributions from non-Ecma member organizations must sign the [Test262 CLA](http://tc39.github.io/test262-cla)**
### Running Test262 ### 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)
There are a number of volunteer-maintained projects that may be used to execute Test262 in various ECMAScript hosts:
### Test262 Runners & Harnesses
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/bterlson/test262-harness (platform: Node.js)
- https://github.com/test262-utils/test262-harness-py (platform: Python) - https://github.com/test262-utils/test262-harness-py (platform: Python)