[Take 2] Remove YAML; add disclosures to SD-JWT examples; add protected headers

[decentralgabe]

Fix #269 and replaces #270
Fix #271
Fix #264

---

Preview | Diff

[decentralgabe]

have fixed rendering and believe it to be correct. please review cc: @bc-pi @selfissued

[bc-pi]

one thing that seems like it cannot be correct or intended:

[decentralgabe]

updated to add tabs for readability

[decentralgabe]

@bc-pi unfortunately...that is correct given the usage of the Enveloped type

this was a ... compromise to include vc-jose-cose secured credentials in presentations. see relevant discussion:

• EnvelopedVerifiablePresentation missing in data model vc-data-model#1431
• Add mechanism to embed externally secured VCs in a VP vc-data-model#1352

I agree it's ugly. I'd like to see us continue to discuss improving the envelope types in a follow-up issue. I hope this PR at least makes the examples clearer.

[decentralgabe]

merging as this just fixes examples and is purely editorial
open to continuing discussion on how we could improve VPs

[bc-pi]

The tabs do help, thanks.

However, (and limiting the commentary to just the scope of this now merged PR) the listing of the value of the claim after "Claim:" under the "Issuer Disclosures" tab rather than the claim name seems incorrect and unhelpful. And makes the aforementioned ugliness more prominent than need be.

[decentralgabe]

thank you @bc-pi I agree that it's confusing. I fixed this in #274 - which you should now see reflected here https://w3c.github.io/vc-jose-cose/#securing-json-ld-verifiable-credentials-with-sd-jwt

[bc-pi]

Thanks @decentralgabe !