w3c / w3c/process

Require registries to include "enough" standardized entries

Open
#597 3 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Needs proposed PR Type: Enhancement
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

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 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.