14:23:29 RRSAgent has joined #did 14:23:29 logging to https://www.w3.org/2020/09/08-did-irc 14:23:31 RRSAgent, make logs Public 14:23:32 please title this meeting ("meeting: ..."), ivan 14:24:59 Meeting: DID WG Telco 14:25:29 Date: 2020-09-08 14:57:53 dmitriz has joined #did 14:59:21 brent has joined #did 15:00:08 Chair: Brent 15:00:11 Agenda: https://www.w3.org/mid/000000000000b88d0705aece8a43@google.com 15:00:27 ivan has changed the topic to: meeting agenda 2020-09-08: https://www.w3.org/mid/000000000000b88d0705aece8a43@google.com 15:00:30 phila has joined #did 15:00:33 present+ 15:00:41 present+ 15:00:54 present+ dlongley 15:00:56 markus_sabadello has joined #did 15:01:00 present+ markus_sabadello 15:01:05 present+ manu 15:01:29 present+ brent 15:01:30 present+ 15:01:41 justin_r has joined #did 15:01:45 present+ 15:02:12 present+ 15:02:55 Orie has joined #did 15:03:02 present+ 15:03:21 present+ 15:03:49 present+ 15:03:57 present+ dmitriz 15:04:02 scribe+ 15:04:07 present+ identitywoman 15:04:16 present+ drummond 15:04:23 present+ pam 15:04:27 drummond has joined #did 15:04:30 brent: Any additions to the agenda? 15:04:38 present+ 15:04:45 brent: Anyone want to reintroduce themselves? 15:05:12 jonathan_holt has joined #did 15:05:18 brent: justin_r can you re-introduce yourself? 15:05:20 present+ jonathan_holt 15:05:28 ppresent+ adrian 15:05:36 present+ adrian 15:05:37 justin_r: I'm an independent consultant from the Boston area, involved in security topics 15:05:46 burn has joined #did 15:05:58 justin_r: I am here trying to help the community build something that actually works 15:06:06 Thanks to Justin! 15:06:27 brent: Our next special topic call will be on Thursday noon ET 15:06:46 brent: In Amsterdam we had a resolution to create registries that serve as a point of interoperability 15:07:00 brent: So far, JSON-LD interoperability is great, but other representations need more work 15:07:01 present+ 15:07:07 q+ 15:07:21 brent: On Thursday we will talk about CBOR and what it needs in the registries, in order to be interoperable 15:07:38 jonathan_holt: Was there a request for the CBOR representation to be more interoperable? Is this about the test suite? 15:08:01 ack jonathan_holt 15:08:05 brent: If someone adds a property to the registry, it needs be interoperable across different representations. We will try to address this for CBOR on Thursday 15:08:27 present+ JoeAndrieu 15:08:33 brent: English is the official language of W3C, but we have several non-native English speakers 15:08:51 brent: The use of idioms and colloquialisms can make it more difficult to understand English 15:09:16 brent: During calls, and on Github issues, please refrain from using more "colorful" language and stick with language you learned at school. 15:09:26 brent: We had some requests from the chairs to increase clarity 15:09:33 Topic: Test suite updates 15:09:38 q+ 15:09:41 JoeAndrieu has joined #did 15:09:56 ack Orie 15:09:57 q+ to go through normative statements. 15:10:01 present+ wayne 15:10:03 Orie: At the last F2F we discussed the test suite and some desirable features 15:10:27 Orie: The core issues that were created are: We would like to not have to create Python or specific languages. We want to run tests against a Docker container or web server 15:10:43 Orie: I started building something that can support this. A dockerized Webserver 15:10:59 Orie: You can submit inputs to the container, and it will return test results, based on built-in configuration 15:11:23 Orie: There is a strawman implementation of this, it's currently not covering anything, but at some point it should cover normative statements 15:11:27 present+ Eugeniu_Rusu_Jolocom 15:11:35 Orie: Amy has worked on a list of normative statements 15:12:05 Orie: If you can construct test inputs in JSON, we should be able to cover all the normative statements in the spec. 15:12:06 Eugeniu_Jolocom has joined #did 15:12:15 present+ 15:12:20 pam has joined #did 15:12:35 Orie: The next step is to tell you all about it, hear concerns and then potentially merge the work into the did-test-suite repo 15:12:37 q+ 15:12:42 q- later 15:12:46 Orie: I hope to get some support for this 15:12:53 ack ivan 15:12:53 ivan: Two questions.. 15:13:01 https://github.com/w3c/did-test-suite/issues 15:13:05 ivan: What is a test? What do I have to put into a test? 15:13:18 ivan: And, how can I get the results and how can I generate a report? 15:13:31 this is a test: https://github.com/OR13/did-core-tests/blob/master/packages/did-core-test-server/src/services/scenarios/resolve.js#L3 15:13:32 ivan: Is it done by the implementer, or is there a mechanism that does that? 15:13:54 Orie: You supply JSON to the test suite. You get back a JSON test report of compliance. 15:14:12 Orie: A test is a program written in JavaScript that operates on JSON and evaluate a set of assertions (based on DID spec normative statements) 15:14:33 Orie: I posted an example of a test that covers a normative statement about the "id" property. 15:14:58 Orie: The input is the DID and the DID document. The test is to check if the DID in the DID document matches. 15:15:16 Orie: The painful part of this is writing small JavaScript programs, and encoding inputs in such a way that normative statements can be tested. 15:15:45 Orie: The report that comes out is a series of assertions that are true/false, for every test scenario you submit 15:16:00 Orie: One scenario is DID resolution, this will have multiple assertions. 15:16:12 Orie: The test report has a number of true/false values for assertions. 15:16:29 ivan: We will have to have a client-side script that will convert this into a readable report (that's the easy part) 15:16:43 Orie: We just need to perform surgery on the JSON data and turn it into nice HTML. 15:16:50 brent: Any other questions for Orie? 15:17:22 brent: Even though Orie has done great work to make this happen, but additional resources will be appreciated 15:17:43 https://github.com/w3c/did-core/issues/384 15:18:14 manu: Amy has done fantastic work going through the DID spec document and listing a lot of normative statements. 15:18:38 manu: As a group, we need to go through all normative statements to see what's testable. 15:18:50 manu: There are too many statements to go over on a call, so this is homework for the group. 15:19:19 manu: On the call today, we will go through statements to see what the thought process is. 15:19:34 manu: We may convert this into a Google doc spreadsheet to enable people to do reviews easily. 15:19:47 manu: I think we will end up with a number of changes to the specification 15:19:57 manu: Once we make those changes, we will implement the test suite 15:20:09 manu: It will become more difficult to change normative statements without changing the test suite as well 15:20:21 manu: We will go into CR with a functioning test suite and a number of implementations 15:20:23 q+ 15:20:28 manu: Any questions? 15:20:36 ack manu 15:20:36 manu, you wanted to go through normative statements. 15:20:39 ack jonathan_holt 15:20:53 jonathan_holt: It would be helpful to preface the second column with "if present". This will help a decision tree to see if a certain item must be present. 15:21:09 manu: You mean add a column in front of "testability"? 15:21:43 jonathan_holt: There are attributes that are optional. If we specific "if present" in a column... 15:21:57 manu: We should make these statements in the normative text. 15:22:12 jonathan_holt, got it, I can update that. manu - I think the normative text says it, jonathan_holt just wants scannability in the list? 15:22:30 manu: Example: "If a DID document includes a service property"... 15:23:20 manu: You're correct that the conformance statement needs to state if it's optional. 15:23:38 I removed JSON Schema tests for did registries.. after nobody contributed to them.... if we intend to use JSON Schema... I would like to get a hard commitment in developers hours from folks who want that to be a thing. 15:23:39 manu: Is this enough for the branching logic you are concerned about? 15:23:47 jonathan_holt: I think it should be split out more 15:24:15 manu: I think we will put this in Google doc spreadsheet, then feel free to duplicate the page and lay it out in a way that you think is helpful. 15:24:17 q? 15:24:35 manu: I though we would go over how to read the table, and provide feedback by going over a number of examples. 15:24:48 manu: Starting top-down to show the group what the thought process is 15:25:11 manu: Amy, anything else you want to add to what's been said? 15:25:33 q+ 15:25:48 ack drummond 15:25:53 manu: The first column is the section. The second is the statement itself. The third is testability. The fourth is a proposed changed. The fifth may eventually link to PRs 15:26:22 drummond: In the Conformance section, if you are making normative statements about other normative statements, I think they don't have to be testable? 15:26:30 manu: This is the type of feedback we are looking for. 15:26:42 manu: We may want to keep the statements even if they are not testable. 15:27:05 BrettM has joined #did 15:27:11 manu: Vast majority of statements about DID methods are not automatically testable, only by a human process. 15:27:25 manu: Such statements about DID methods may become a checklist. 15:27:53 manu: There are some things here that are judgement calls. That's why we should go over the statements in the list. 15:28:41 manu: E.g. statement 1 (A conforming DID is any concrete ...) -> This is not directly testable, because we first have to look into Section 3 which is referenced by this statement. 15:28:58 manu: So we could change this normative "MUST" and replace it with "complies". 15:29:14 manu: That would make it non-normative, but still clearly set the expectation. 15:29:33 manu: There are other specifications that make similar normative statements like this. 15:29:39 we could make the test suite aggregate results of other tests in order to test the conformance ones 15:29:46 manu: That's the type of thinking that goes into each one of these statements. 15:29:52 manu: We're suggesting to reword this one 15:30:13 manu: Amy's suggestion may increase test suite complexity 15:30:35 manu: Looking at statement 2, this is not testable by itself but points to other normative statements. 15:30:49 manu: This is the type of statement we're looking for, e.g. propose changed language 15:31:04 I think it's fine to categorize a normative statement as a "aggregation statement" that does not need to be testable by itself because it just aggregates other normative statements. 15:31:15 manu: Looking at statement 3, this is a duplicate of another normative statement. 15:31:29 q+ 15:31:31 manu: Sometimes we say the exact same thing (or something very close) in multiple sections 15:31:31 +1 to removing any duplicate normative statements 15:31:49 -1 to removing "duplicates" just because they seem similar 15:32:01 manu: Looking at statement 4: This is good statement that is directly testable. 15:32:07 ack justin_r 15:32:37 justin_r: I agree that actual duplication can be avoided, but we need to be very careful that we're not removing things from appropriate contexts just because we come to the same conclusion twice. 15:32:58 justin_r: In this case, we're coming to the same conclusion, but saying it in different ways and for different reasons. 15:33:32 justin_r: Statement 3 (about serialization format) is an example of this, I don't agree it's an actual duplicate even though they are similar. 15:33:37 q+ to agree 15:33:40 justin_r: We may end up removing important information 15:34:11 justin_r: From previous conversations, in the Representations sections, there is language about producing and about consuming. They may seem similar but it is vitally important to keep them separate. 15:34:13 ack manu 15:34:13 manu, you wanted to agree 15:34:35 manu: Based on this feedback, we may decide to not remove this but re-word 15:34:46 manu: Solid points, Justin 15:34:55 manu: Anything else on this? 15:35:13 q+ 15:35:15 +1 to normative conformance 15:35:17 drummond: Can we just decide this one question right here, i.e. do we want normative statements in the Conformance section or not? 15:35:19 q+ 15:35:21 ack manu 15:35:24 q+ 15:35:40 manu: It depends on the Working Group, I've seen WGs do both 15:35:53 ack phila 15:36:20 q+ 15:36:35 phila: If you have a section on Conformance and you want to repeat it elsewhere, you can point to it. The Conformance section might have some additional things, but generally you conform to the document itself. 15:36:52 ack brent 15:36:52 brent: Please review the list of statements and add your opinions 15:37:00 q+ to note next steps. 15:37:01 ack ivan 15:37:29 identitywoman has joined #did 15:37:34 present+ 15:37:35 ivan: I was looking at some other specifications that were published lately, and usually the Conformance section does not really contain "MUST" statements in terms of information that is not elsewhere. 15:37:58 ivan: I'm looking now at JSON-LD Conformance statements.. "It is conformant... if it follows the normative statements... " 15:38:05 ivan: In other documents, it's even shorter than that 15:38:32 ack manu 15:38:32 manu, you wanted to note next steps. 15:38:37 ivan: I think it's perfectly fine if the Conformance statements have some general language "You have to be conformant with the MUSTs in the spec, ..." 15:38:37 I'm fine with the Conformance section just pointing to the normative statements elsewhere in the spec. 15:38:50 present+ brett 15:39:15 manu: Next steps are, we will put together a Google doc. Once we get to a certain point, the editors will start putting in PRs to update the document as appropriate. We will notify the WG when we do that. 15:39:25 manu: We would like to do this well before we go into CR 15:39:42 q+ 15:39:58 genaris has joined #did 15:40:04 manu: We need this to get the test suite implemented. We want a high degree of trust that when we enter CR, we have what we need. 15:40:19 manu: We'd like this process to be done by the final week of September. 15:40:20 ack ivan 15:40:54 ivan: I am fine with what you said Manu, but the most important thing when we go to CR is that we settle the question what goes into the Conformance section. 15:41:10 I agree with what Ivan said. 15:41:19 https://github.com/w3c/did-core/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-asc 15:41:23 Topic: Core issues and status check 15:41:54 q+ 15:42:11 brent: https://github.com/w3c/did-core/issues/119 15:42:13 brent: We have the DID Explainer complete, are still waiting for privacy questionnaire 15:42:18 https://github.com/w3c/did-core/issues/174 15:42:20 brent: https://github.com/w3c/did-core/issues/174 15:42:56 ack wayne 15:42:59 wayne: Just a note that the horizontal privacy review (and a lot of the other ones) are contingent on whether we keep service endpoints or not. 15:43:05 q+ 15:44:06 markus_sabadello: I think this had been addressed by PRs, it can be closed and will add a comment 15:44:11 ack markus_sabadello 15:44:13 https://github.com/w3c/did-core/issues/23 15:44:27 brent: Orie, any update? 15:44:37 Orie: Same as last time, I recommend closing this 15:45:09 brent: Anyone opposed to closing this now? 15:45:34 https://github.com/w3c/did-core/issues/318 15:46:09 brent: Dave, any updated on this? 15:46:17 dlongley: No updates, maybe on a special topic call 15:46:35 https://github.com/w3c/did-core/issues/199 15:47:18 brent: Last time we were still waiting on the "representation" property, which has been replaced by the "type" property. There is also a PR about "alsoKnownAs" related to this. We're waiting for PRs, just need to go forward with it 15:47:34 drummond: Brent, you and I need to schedule a call to go over this 15:47:41 https://github.com/w3c/did-core/issues/171 15:48:07 +1 to close 15:48:08 Orie: We did this, merged examples, I recommend closing 15:48:36 Orie: Mike agreed in a comment that a PR fixed this 15:49:42 Orie: This is also in the did-spec-registries, DID Core and the registries need to remove publicKeyPem 15:49:58 brent: Just because Orie is assigned to it, doesn't mean he has to do the work. 15:50:05 https://github.com/w3c/did-core/issues/170 15:50:06 q+ 15:50:38 +1 to close 15:50:41 brent: Good conversation between, Mike, Kyle, Orie, Manu 15:51:07 +1 to Orie's reasoning for close. 15:51:11 Orie: I think we addressed this by supporting different key representations, recommend to close it. We need "id" and "type" because not everybody uses JWK 15:51:23 https://github.com/w3c/did-core/issues/332 15:51:35 +1 to support the change. 15:52:05 brent: I fear this is misguided desire to enact social justice. Changing "master" to "main" may be [...] difficult 15:52:09 you can now publish non-master branches via Github now. 15:52:13 so, not a big deal 15:52:20 https://github.com/w3c/did-core/issues/329 15:52:21 q+ 15:52:30 ack Orie 15:52:36 ack dlongley 15:52:56 dlongley: I left a comment on this one, it depends on the discussion in 382 about service endpoints 15:53:34 brent: It's important to move forward on the privacy questionnaire 15:53:47 https://github.com/w3c/did-core/issues/361 15:54:23 q+ 15:54:33 justin_r: I don't know if any work has been done on this. Haven't seen any PRs 15:54:37 q+ to ask if is this a limitation of INFRA? 15:54:41 brent: We need someone to step forward to raise a PR 15:54:49 ack manu 15:54:59 manu: There is ongoing conversation in the INFRA spec; whatever they come up with will change what we do 15:55:26 manu: Right before CR, we have to make a decision on this. We may have put in explicit formats. 15:55:30 q+ 15:55:33 q+ 15:55:36 manu: We're waiting for the INFRA folks to tell us what they're planning on doing 15:55:40 brent: You're in touch with them? 15:55:45 manu: Only through the issue tracker 15:55:46 ack jonathan_holt 15:55:46 jonathan_holt, you wanted to ask if is this a limitation of INFRA? 15:56:02 ack ivan 15:56:03 jonathan_holt: As far as using INFRA, there is the ordered set that was brought up before 15:56:26 ivan: We have to be consistent. I don't remember the issuer/PR number, but we agreed we would have the date specified for parameters 15:56:27 q+ 15:56:46 ivan: I think we agreed we would use ISO 15:56:50 ack justin_r 15:57:03 Issue mentioned by Ivan assigned to me about date and time format: https://github.com/w3c/did-core/issues/379 15:57:05 q- 15:57:30 justin_r: It would be great if in the future we can align with INFRA and point to it instead of defining them ourselves 15:57:34 +1 to justin_r... lets not build on a hypothetical future that may never come. 15:57:46 That wasn't the suggestion :) 15:57:59 It either goes in the INFRA spec and we can refer to it... or we'll have to do it. 15:58:06 (in the DID Core spec) 15:58:19 justin_r: There is a lot more than just numbers and dates. There are concrete data elements like URIs, etc. We need to comb through all of the properties to say how they are serialized. In many cases this will be obvious, but our job as spec writers is to write down what's obvious 15:58:41 https://github.com/w3c/did-core/issues/85 15:58:43 +1 to Justin's point that we need to "write down the obvious so that everyone does it" 15:58:50 q+ 15:58:54 +1 to justin, too 15:59:16 q- 15:59:30 brent: I'll add a comment to ask to reiterate what needs to be done, and recommend closing. 15:59:43 brent: Thank you everyone for coming, apologies for confusion regarding the agenda. 15:59:56 brent: The agenda thats says 15th September is WRONG 16:00:20 rrsagent, draft minutes 16:00:20 I have made the request to generate https://www.w3.org/2020/09/08-did-minutes.html ivan 16:00:26 zakim, end meeting 16:00:26 As of this point the attendees have been ivan, phila, dlongley, markus_sabadello, manu, brent, justin_r, wayne, Orie, rhiaro, dmitriz, identitywoman, drummond, pam, jonathan_holt, 16:00:29 ... adrian, burn, JoeAndrieu, Eugeniu_Rusu_Jolocom, Eugeniu_Jolocom, brett 16:00:29 RRSAgent, please draft minutes 16:00:29 I have made the request to generate https://www.w3.org/2020/09/08-did-minutes.html Zakim 16:00:31 I am happy to have been of service, ivan; please remember to excuse RRSAgent. Goodbye 16:00:36 Zakim has left #did 16:11:59 dmitriz has joined #did 18:00:17 ivan has joined #did 19:21:08 dmitriz has joined #did