Skip to content

Clarify that the test suite is not a Style Guide #324

Open
@Julian

Description

@Julian

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

No one assigned

    Labels

    documentationA request for new or updated documentation for the suiteenhancementAn enhancement to the tooling or structure of the suite (as opposed to a new test).

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions