oauth-wg / oauth-selective-disclosure-jwt

https://datatracker.ietf.org/doc/draft-ietf-oauth-selective-disclosure-jwt/
Other
57 stars 31 forks source link

Difference between "a format extending the JWS Compact Serialization" and "an alternate format extending the JWS JSON Serialization" ? #487

Closed Denisthemalice closed 2 weeks ago

Denisthemalice commented 3 weeks ago

Item 1 from Section 1.1. (Feature Summary) states:

1.1. Feature Summary

This specification defines two primary data formats:

  1. SD-JWT is a composite structure enabling selective disclosure of its contents. It comprises the following:

    • (...)
    • (...)
    • A format extending the JWS Compact Serialization, allowing for the combined transport of the Issuer-signed JSON data structure and the disclosable data items
    • An alternate format extending the JWS JSON Serialization, also allowing for transport of the Issuer-signed JSON data structure and disclosure data

At the time of reading these two sentences, they are not understandable. These sentences should be rephrased so that that the motivations behind them can become understandable