search

awslabs / aws-encryption-sdk-specification

AWS Encryption SDK Specification
Other
30 stars 27 forks source link

Standardize keyring input language #151

Closed acioc closed 4 years ago

acioc commented 4 years ago

In the AWS KMS keyring, we say "MUST define" and "MAY define". At the very least, "MAY define" should be "MUST optionally define," since it's an optional input.

Other keyrings (RSA and AES) say "the following inputs are REQUIRED". This doesn't say MUST/MAY.

The multi-keyring just says "MUST define".

We should standardize the language used for all keyring inputs.

We likely want "MUST accept _" and "MUST accept an optional " or some variation.

acioc commented 4 years ago

Timebox for half a day for 1.0

acioc commented 4 years ago

This was resolved by https://github.com/awslabs/aws-encryption-sdk-specification/pull/213 closing