Add free availability as a requirement for normative references #431 - #444
Add free availability as a requirement for normative references #431#444svgeesus wants to merge 10 commits into
Conversation
…of Normative References to ISO/IEC 18013-7 Annex C in the Digital Credentials API specification, add free availability as a requirement for normative references
There was a problem hiding this comment.
I suggest defining "freely available" somehow, or explaining what is meant by it. There are at least two potential ways that "freely" could be understood:
- at no financial cost (e.g. a W3C specification)
- easy to obtain (e.g. milk)
Of course it might also mean both things together, too.
I note that the referenced Council Report also is ambiguous about which meaning is intended, though in summarising the objection the Council was considering it uses the phrase "fee-gated" and proposes alignment with OpenStand, "at no cost and without limitation".
However OpenStand Principle 4 actually talks about fair terms (for implementation) and explicitly mentions FRAND, with the clear implication being that it might be reasonable for there to be a cost associated with implementing (and therefore by extension, potentially obtaining) a specification.
Given that it isn't really clear what "freely available" means, it's hard to see how TiLT can make an assessment of future similar references based on this phrasing.
For what it's worth, I have a strong preference that specifications referenced by W3C Recommendation track documents are "freely available" in the sense of both "at no financial cost" and "easy to obtain", although I can see that there might be exceptions occasionally.
tidoust
left a comment
There was a problem hiding this comment.
Thanks @svgeesus! That looks good to me.
@nigelmegitt, I note that the text narrows down the notion of "freely available" through "Specifications which are only available to members of some organization, only available by signing a legal agreement, or only available by paying a fee, are not considered freely available".
I think this takes care of the "at no financial cost" part. I'd be fine expanding the sentence to cover "easy to obtain" but has that been a problem in the past few years? If not, I would not worry about that.
(Note: we should share the PR with the AB for review before merging)
Co-authored-by: Sarven Capadisli <info@csarven.ca>
Is there an AB github account or should I just at-mention a few key people? |
@nigelmegitt I'm trying to imagine a form of "hard to obtain" that is not covered by "buy it using swiss francs" (ISO) or "only available in printed form from this publisher who only ships to the US" (MIDI spec, a decade or so ago), both of which involve paying money. Or "must sign an NDA first" (MIDI specs in development but not released in final form). I understand your point in the abstract, just trying to clarify what it would amount to in practice. |
It does, but that aspect was already covered in the existing document, under Licensing. |
Sorry I buried my point a bit: the issue is that OpenStand principle text can be considered to include not just implementing but also obtaining the specification. That's different from Licensing. |
Those are the kinds of thing I meant, and they don't necessarily involve paying money directly for the specification - there can be indirect costs instead, like for postage or travel. This Douglas Adams quote comes to mind:
|
Thanks @tidoust for highlighting this. On re-reading, I realise that the key term is not "freely available" but "not freely available" (apologies screen reader users, that almost certainly sounds the same - I am suggesting that the word "not" is included within the term). Edit suggestions incoming. |
nigelmegitt
left a comment
There was a problem hiding this comment.
Some proposals for addressing the discussion comments about "not freely available".
Co-authored-by: Nigel Megitt <nigel.megitt@bbc.co.uk>
Co-authored-by: Nigel Megitt <nigel.megitt@bbc.co.uk>
Co-authored-by: Nigel Megitt <nigel.megitt@bbc.co.uk>
Co-authored-by: Nigel Megitt <nigel.megitt@bbc.co.uk>
Co-authored-by: Nigel Megitt <nigel.megitt@bbc.co.uk>
Co-authored-by: Philippe Le Hegaret <plh@w3.org>
|
Thanks for the helpful review comments so far. @tidoust wrote:
I asked for review from @torgo and @brentzundel |
Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com>
Co-authored-by: Ted Thibodeau Jr <tthibodeau@openlinksw.com>
We called for review two weeks ago, should we wait some more? |
There was a problem hiding this comment.
r+ with nit that weakens the new requirement somewhat, and noting that the PR appears to be a draft.
Re: weakening the requirement, the rest of the text makes it abundantly clear that those attempting to include such a normative reference have homework to do.
|
|
||
| ### 5.1 Requirements | ||
|
|
||
| In general, and consistent with the Modern Paradigm for Standards ([OpenStand principles](https://open-stand.org/about-us/principles/)), W3C does not allow standards-track specifications to make normative references to specifications which are **not freely available**. |
There was a problem hiding this comment.
| In general, and consistent with the Modern Paradigm for Standards ([OpenStand principles](https://open-stand.org/about-us/principles/)), W3C does not allow standards-track specifications to make normative references to specifications which are **not freely available**. | |
| In general, and consistent with the Modern Paradigm for Standards ([OpenStand principles](https://open-stand.org/about-us/principles/)), W3C prefers standards-track specifications to refrain from making normative references to specifications which are **not freely available**. |
There was a problem hiding this comment.
"prefers", or similar language, isn't compatible under the "Requirements" section, and it also undercuts the following paragraph. The current text is consistent and logically necessary for the guidance that follows, so it seems accurate to me.
Following the advice in the W3C Council Report on the Formal Objection to the use of Normative References to ISO/IEC 18013-7 Annex C in the Digital Credentials API specification.