Subject: [Acme] status required missing

From: Josh Soref <[email-masked]>
Date: Sun, 19 Feb 2017 12:14:40 -0500

> status (required, string):
> : The status of this authorization.
> Possible values are: "pending", "processing", "valid", "invalid", and "revoked".
> If this field is missing, then the default value is "pending".

1. This last sentence seems to contradict "required".
2. I'm not a fan of the construct "if missing, default value is", to
me it implies "if there is a value, there is no default", which isn't
what you're trying to say, you're saying <there is a default value,
and it is X>.

I'd suggestion:
1. Change 'required' to 'optional'
2. Change the last sentence to "If this field is absent, then it
should be treated as having value 'pending'."