Require registries to include "enough" standardized entries
Nobody has claimed this yet.
- Dominant language
- HTML
- Stars
- 262
- Forks
- 194
- PR merge metrics
- No merged PRs in 30d
Description
The Verifiable Credentials 1.0 Recommendation defines several fields (e.g. "proof") by referring to CG draft reports from within notes. The VC WG is currently rechartering to, as I understand it, fix that by replacing those non-normative field definitions with normative references to some Registries whose entries will define the meaning of those fields' contents. Discussion in https://github.com/w3c/vc-wg-charter/issues/67 indicates that some members of the WG are opposed to including any entries for those registries in the REC-track deliverables for the WG. That means that by indirecting through a Registry, the WG would avoid the requirement in https://www.w3.org/2013/09/normative-references that Recommendations' normative references be to similar-maturity documents.
I don't see anything in the Process or the normative references guide that discusses how to tell if a registry's contents are mature enough to reference normatively, and I think there should be such guidance.
I don't want to claim that normatively-referenced registries can only have REC-level entries: it's appropriate to allow non-standardized terms to be registered early and easily, so that implementers can experiment with and incubate extensions.
However, a REC should be sufficient to produce interoperable implementations, and one that refers critically to names defined in an empty Registry isn't sufficient for that. Similarly, if the REC looks up a name in a registry in order to find an algorithm associated with it, and none of the possible resulting algorithms are REC-level, that's again not sufficient to produce interoperable implementations.
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 with the W3C Process Document, its normative references guidance, and the registries section, then review the linked VC WG charter discussion. Done means the Process guidance explains when registry contents are mature enough for normative reference while still allowing early registration of experimental extensions.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 25/100