openid / openid/OpenID4VCI

Issues with Use Case - Wallet-Initiated Issuance after Installation

Open
#424 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

clarification editorial
Dominant language
No language data
Stars
125
Forks
41
PR merge metrics
No merged PRs in 30d

Description

When almost accidentally reading this section, I noticed some issues with it

The End-User installs a new Wallet and opens it. The Wallet offers the End-User a selection of Credentials that the End-User may obtain from a Credential Issuer, e.g. a national identity Credential, a mobile driving license, or a public transport ticket. The corresponding Credential Issuers (and their URLs) are pre-configured by the Wallet or follow some discovery processes that are out of scope for this specification. By clicking on one of these options corresponding to the Credentials available for issuance, the issuance process starts using a flow supported by the Credential Issuer (Pre-Authorized Code flow or Authorization Code flow).

Wallet Providers may also provide a market place where Issuers can register to be found for Wallet-initiated flows.

  • The language makes this hard to read and understand (e.g. "a selection of Credentials that the End-User may obtain from a Credential Issuer", "the Wallet or follow some discovery processes"
  • The last sentence does not even make sense to me.
  • References a term "Wallet Provider", which is not defined

My suggestion would be to remove this section or rewrite it completely.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the quoted Wallet-Initiated Issuance after Installation section in the issue. Review its wording, the final marketplace sentence, and the use of “Wallet Provider”; done means the section is removed or rewritten clearly and every term it uses is defined or explained.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.