Skip to content

Should spec conformance statements be understandable as sentences out of context? #162

Open
@wip-abramson

Description

@wip-abramson

As I was looking over the the test statements extracted into this hackmd document - https://hackmd.io/pxOH-leKR8KD8LOxdb7w5A - I realized a lot of the conformance statement sentences are not clear when taken out of context. They are also multiple statements that are the same.

For example

If present, the associated value MUST be an ASCII string.

This sentence appears 5 times in the spec.

Now, maybe this is fine because sentences like this shouldnt really be taken out of context.

But I did wonder if it would be clearer for us to update them.

E.g.

If the service parameter is present, the associated value MUST be an ASCII string.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions