fixup! Document rationale for some maintenance practices

This commit is contained in:
Mike Pennisi 2022-04-01 17:37:27 -04:00 committed by Philip Chimento
parent f59823860e
commit 97477ad1f6
1 changed files with 10 additions and 1 deletions

View File

@ -95,7 +95,9 @@ for the "harness" files which Test262 maintains to assist in test writing.
Directories are not generally applied beyond these limits; further
differentiation is instead achieved through structured file names which follow
ad-hoc conventions. This organization balances the need to group tests
logically with the need to discover tests.
logically with the need to discover tests. See, for example, [the tests for
template
literals](https://github.com/tc39/test262/tree/main/test/language/expressions/template-literal).
Many consumers use file names as a way to compare test results across revisions
and between implementations. For this reason, tests files are rarely
@ -112,6 +114,13 @@ qualities. Because Test262 is not maintained as a repository of regression
tests, contributions which include these kinds of tests will be weighed against
their likelihood of identifying error in a plurality of implementations.
For example, assume that some runtime spuriously accesses the `toJSON` property
of the value passed to
[`String.prototype.repeat`](https://tc39.es/ecma262/#sec-string.prototype.repeat).
While the maintainers of the engine may decide to include a regression test
which disallows that behavior in their project, the maintainers of Test262
would not necessarily accept such a test.
## Large tests
Test262 tests are typically very focused. The vast majority exercise just one