-
-
Notifications
You must be signed in to change notification settings - Fork 221
Open
Labels
documentationA request for new or updated documentation for the suiteA request for new or updated documentation for the suiteenhancementAn enhancement to the tooling or structure of the suite (as opposed to a new test).An enhancement to the tooling or structure of the suite (as opposed to a new test).
Description
This seems to be a point of confusion, or even contention, so we need to document it.
The test suite is not a set of what schemas or instances one should write.
It's a verification of "specified" behavior.
We should clarify to end users that "just because you see it here, doesn't mean it's a good idea", and to implementors that "if it's here it's because that's the behavior prescribed by the spec regardless of whether it's a good idea or not to do it".
Style guides, and what users should or should not do, are separate things.
Metadata
Metadata
Assignees
Labels
documentationA request for new or updated documentation for the suiteA request for new or updated documentation for the suiteenhancementAn enhancement to the tooling or structure of the suite (as opposed to a new test).An enhancement to the tooling or structure of the suite (as opposed to a new test).