Clarify that the test suite is not a Style Guide #324
Labels
documentation
A request for new or updated documentation for the suite
enhancement
An enhancement to the tooling or structure of the suite (as opposed to a new test).
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.
The text was updated successfully, but these errors were encountered: