openid / openid/OpenID4VC-HAIP
enhancement on the 3. Scope section and its sub-sections
Nobody has claimed this yet.
- Dominant language
- Makefile
- Stars
- 57
- Forks
- 17
- PR merge metrics
- No merged PRs in 30d
Description
A scope in a document typically is for to define the aspects covered by the document.
Although, there are some imperatives in the section 3. Scope (e.g., requiring the implementers to be compliant to the requirements of the flows and support at least either SD-JWT VC or ISO mdocs), and it would be easier for the readers to properly implement having such texts in the later sections that describe requirements and recommendations per each flow.
Besides, the latter half of the section 3 (describing the profiles of OID4VCI, IETF SD-JWT VC, and either remote or in-person can be used for OID4VP), 3.1 Assumptions, and 3.3 Standards Requirements are informative texts which are not defining the aspects covered by the document. It may be better to move such parts to either introduction or later sections.
By the way, is "offline use-cases, e.g. over BLE" written in the end of the 3.4. Out of Scope section meaning proximity?
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading section 3, including 3.1 Assumptions, 3.3 Standards Requirements, and 3.4 Out of Scope, in the document. Review which passages define scope versus requirements or informative context, then reorganize them as proposed and clarify whether “offline use-cases, e.g. over BLE” means proximity use cases.
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