Proofread Implementation Considerations

[selfissued]

Correct issues identified while proofreading the Implementation Considerations.

[Sakurann]

I would like to hear others' opinion regarding claim-based vs claims-based. maybe I am just more used to it, but to me the former sounds more accurate.

[paulbastian]

I would like to hear others' opinion regarding claim-based vs claims-based. maybe I am just more used to it, but to me the former sounds more accurate.

Claim-based binding has been used so far in various places and sounds more natural to me, though I'm not a native speaker.

[selfissued]

At https://openid.github.io/OpenID4VCI/openid-4-verifiable-credential-issuance-wg-draft.html#name-claim-based-binding-of-the- , the description of the binding is:

Credentials not cryptographically bound to the identifier of the End-User possessing it (see Section 7.1), should be bound to the End-User possessing the Credential, based on the claims included in that Credential.

If it said "based on a claim included" then "claim-based" (singular) would be correct. But since it says "based on the claims included" (plural), then "claims-based" is correct. The binding is based on a set of included claims - not a single claim.

[jogu]

If it said "based on a claim included" then "claim-based" (singular) would be correct. But since it says "based on the claims included" (plural), then "claims-based" is correct. The binding is based on a set of included claims - not a single claim.

I've been puzzling for some time over why both "claim-based" and "claims-based" sounded fine to me.

I've eventually concluded that the two forms have potentially subtly different meanings because it's not necessarily clear what is meant by "claim" here.

If "claim" is referring explicitly to user attributes in the verifiable credential, then I think 'claims based' is correct as per the point @selfissued makes above.

Where the singular might be appropriate is that a single "claim" might have multiple elements - so for example, "a user that has surname 'x', first name 'y' and date of birth 'z' lives in London" is technically a singular claim). And I think an important element here is that the "surname 'x', first name 'y' and date of birth 'z'" part are not claims that the issuer of this VC is asserting about the user presenting the credential.

Reading the current text in https://openid.github.io/OpenID4VCI/openid-4-verifiable-credential-issuance-wg-draft.html#section-13.1 I think we're describing the former and hence it should be "claims based binding". However I'm not entirely sure the text there reflects the latest thinking.

[tplooker]

If it said "based on a claim included" then "claim-based" (singular) would be correct. But since it says "based on the claims included" (plural), then "claims-based" is correct. The binding is based on a set of included claims - not a single claim.

This intuitively makes the most sense to me.

[awoie]

looks great, just one nit

personally not convinced, but wont block if others think claims-based makes more sense