15:11:54 RRSAgent has joined #wot-td 15:11:54 logging to https://www.w3.org/2022/11/23-wot-td-irc 15:12:00 meeting: WoT-WG - TD-TF 15:12:46 present+ Kaz_Ashimura, Daniel_Peintner, Ege_Korkan, Klaus_Hartke 15:13:21 agenda: https://www.w3.org/WoT/IG/wiki/WG_WoT_Thing_Description_WebConf#November_23.2C_2022 15:14:33 scribenick: kaz 15:15:46 present+ Jan_Romann 15:16:00 JKRhb has joined #wot-td 15:16:09 topic: Minutes 15:16:14 -> https://www.w3.org/2022/11/16-wot-td-minutes.html Nov-16 15:16:45 ek: (goes through the minutes) 15:16:55 present+ Tomoaki_Mizushima 15:18:49 ... another subtopic for PR 193 to be added between "... I will tag ..." and "Jan: had discussion" 15:23:27 kaz: updated 15:23:30 approved 15:23:41 topic: Binding Templates 15:24:03 subtopic: PR 198 15:24:22 -> https://github.com/w3c/wot-binding-templates/pull/198 PR 198 - Overview of the binding templates documents and relationship with others 15:24:29 ek: already mentioned last week 15:24:34 q+ 15:26:11 kaz: would be better to have two diagrams separately 15:27:20 ... one for relationship among WoT specs within one of the earlier sections 15:27:28 ... and the internal relationship here within section 4 15:27:44 ... maybe I should have been clear about that point last week 15:27:46 ek: ok 15:28:17 ... btw, Mizushima-san, have you had discussion with the JP developers about the structure of the Binding Templates spec? 15:28:32 present+ Sebastian_Kaebisch, Tomoaki_Mizushima 15:29:05 kaz: he's planning to have an event next year 15:29:10 ... so no concrete response yet 15:29:12 ek: ok 15:29:26 ... (adds comments based on today's discussion) 15:29:47 present+ Matthias_Kovatsch 15:30:19 sebastian_ has joined #wot-td 15:30:37 mk: originally we wanted to have an independent document for "Binding Templates" 15:31:05 ... but this document doesn't really describe the templates themselves 15:31:20 ek: actual binding is described by the Thing Description 15:31:41 mk: for example, Siemens has some specific binding 15:31:52 q? 15:31:54 ack k 15:32:01 kh: agree with Matthias 15:32:38 ... the current document doesn't match what people have been talking about 15:32:41 ek: ok 15:32:51 ... I'll open another issue on that 15:32:53 q? 15:32:55 q+ 15:33:12 ack k 15:33:26 zakim, who is on the call? 15:33:26 Present: Kaz_Ashimura, Daniel_Peintner, Ege_Korkan, Klaus_Hartke, Jan_Romann, Tomoaki_Mizushima, Sebastian_Kaebisch, Matthias_Kovatsch 15:33:53 ek: we can reopen Issue 143 15:34:02 ... actually, it's still open 15:34:35 -> https://github.com/w3c/wot-binding-templates/issues/143 Issue 143 - "Protocol Binding" vs. "Binding Template" 15:35:10 kh: our expectation is having a specific document named "Binding Templates" which describes the Binding Templates 15:35:28 ek: ok 15:35:36 q+ 15:36:29 kh: the core Binding Templates document should describe the mechanism of the WoT Binding Templates 15:36:36 ek: ok 15:36:45 q? 15:36:53 q+ 15:37:33 ack k 15:37:47 kaz: agree with Matthias and Klaus 15:38:12 ... the core Binding Templates document should have clearer description on the mechanism of "Binding Templates" 15:38:18 ... and how to generate them 15:38:28 ... Mizushima-san's point should be also similar 15:38:56 +1 I agree with Matthias and Klaus, too. 15:39:13 dp: good to align the terminology with WoT Architecture as well 15:39:15 ack k 15:39:16 ack d 15:39:31 mk: multiple aspects to be considered 15:39:49 ... so we use "Binding Templates" as plural 15:40:33 ... both the concept of the Binding Templates and protocol-specific templates to be described 15:40:51 ek: ok 15:41:07 ... think the Terminology of the WoT Architecture specification is flexible enough 15:41:57 -> https://w3c.github.io/wot-architecture/#terminology WoT Architecture 1.1 - 3. Terminology 15:43:35 [[ 15:43:36 Binding Templates 15:43:36 A re-usable collection of blueprints that enable a Thing Description to be used with a specific protocol, data payload format or an IoT platform that combine both of them in specific ways. This is done through additional descriptive vocabularies, Thing Models and examples that aim to guide the implementers of Things and Consumers alike. 15:43:38 ]] 15:43:52 rrsagent, make log public 15:43:56 rrsagent, draft minutes 15:43:56 I have made the request to generate https://www.w3.org/2022/11/23-wot-td-minutes.html kaz 15:44:57 ek: the description of the Binding Templates Note should be inline with the above terminology definition 15:45:13 subtopic: PR 188 and PR 193 15:45:40 -> https://github.com/w3c/wot-binding-templates/pull/188 PR 188 - Define CoAP Content Negotiation 15:45:58 -> @@@ 15:46:10 kh: let's look at the detail here 15:46:35 s|@@@|https://github.com/w3c/wot-binding-templates/pull/193 PR 193 - Alternative proprosal for handling CoAP Content-Formats| 15:46:44 ek: (shows the preview for PR 193) 15:47:06 -> https://deploy-preview-193--wot-binding-templates.netlify.app/bindings/protocols/coap/ Preview 15:47:07 q+ 15:47:29 -> https://deploy-preview-193--wot-binding-templates.netlify.app/bindings/protocols/coap/#example-request-contentFormat specifically Example 3 15:47:44 kh: contentFormat 60 is used as a hint 15:48:11 q? 15:48:15 ... the question is if we need another member to show the expectation explicitly 15:48:40 sk: TD brought the contentType as mandatory feature 15:48:55 ... what is our assumption here? 15:48:57 ack s 15:49:08 ... you can skip it if needed 15:49:30 ... in that case, the default is application/json 15:50:04 kh: application/json to be 50 15:51:15 q+ 15:51:18 q+ 15:51:36 ... should we even more explicit? 15:52:08 ek: accept to be included also 15:52:21 kh: what content option to be included here? 15:52:34 ... must we put the information explicitly? 15:53:00 mk: my argument within the issue as well 15:53:29 ... if you need to set the accept option, additional term on what would be accept to be specified 15:53:35 ... there two different cases 15:53:38 q? 15:54:32 kaz: what is really needed for binding? 15:54:34 ack k 15:54:51 ek: the way to give hints itself might not be necessary 15:56:20 kaz: it's kind of redundant to have both contentType application/cbor and contentFormat 60 15:56:24 mk: right 15:56:51 ... should be processed outside of the object 15:57:04 zakim, who is on the call? 15:57:04 Present: Kaz_Ashimura, Daniel_Peintner, Ege_Korkan, Klaus_Hartke, Jan_Romann, Tomoaki_Mizushima, Sebastian_Kaebisch, Matthias_Kovatsch 15:57:38 kh: may need it for compatibility purposes 15:57:41 mk: ok 15:57:53 jr: regarding the set of options 15:58:14 ... my understanding is around multiple forms 15:58:33 ... if we have another form object 15:58:40 ... you could select the form 15:58:49 ... by providing a set of options 15:59:29 mk: you wouldn't need to use CoAP-specific term for that purpose 15:59:48 ... can be handled by an upper-level process of the application 16:00:07 ... setting an acceptable option 16:00:11 s/set/by set/ 16:00:13 q? 16:00:16 ack j 16:00:31 q? 16:00:33 q+ 16:00:57 kaz: time check 16:01:05 ... we're at the top of the hour 16:01:15 ... but will we continue this discussion? 16:01:20 ek: yes, 15 more minutes 16:01:36 jr: consumer to select the option 16:01:47 scribenick: dape 16:02:14 MK: 2 forms with 2 options JSON/CBOR 16:02:27 ... we need to set Accept option 16:02:56 EK: Jans proposal seems fine then 16:03:03 q? 16:03:05 ack k 16:03:09 ... we might need to add such a 2 form example 16:03:24 KH: +1, looks good with this new example 16:03:37 JR: what about HTTP? 16:03:53 ... accept header needed there as well? 16:04:08 KH: Yes, exactly the same thing 16:04:18 JR: makes sense 16:05:34 EK: in the case contentType is not describable one must put accept 16:06:02 ... e.g, PDF under same resource ...no dataSchema possible for it 16:09:03 KH: w.r.t. HTTP protocol binding 16:09:11 ... should we have similar example ? 16:09:31 EK: Yes, agree 16:10:14 JR: will update PR 193 16:10:53 mjk has joined #wot-td 16:11:37 SUBTOPIC: PR#204 16:12:19 EK: decision, move ontology to archive folder 16:12:27 i|decision|-> https://github.com/w3c/wot-binding-templates/pull/204 PR 204 - Move Coap Ontology| 16:12:35 .... Klaus approved PR 16:13:03 ... merging 16:13:04 q+ 16:13:52 Kaz: if we remove this notation ... how to deal with vocabulary? 16:14:08 ... issue #97 tracks this issue 16:14:31 s/... issue #97 /EK: issue #97 16:14:54 Kaz: what would document describe ? 16:15:07 EK: explain how to use... default mapping 16:16:32 Kaz: It would be easier explaining the binding in core document 16:17:01 EK: I think we would loose people 16:17:23 Kaz: I suggest to include content in core document 16:17:52 EK: issue#191 ? 16:18:11 q+ 16:18:11 ... we are looking for additional arguments 16:18:20 ... need people's opinion 16:18:52 Kaz: Not about single vs. multiple documents 16:19:25 ... need to think about machine and human readable part 16:19:26 ack k 16:19:35 SK: I prefer splitting the documents 16:19:46 ... core should explain basic concepts 16:20:05 ... details about protocol binding should be in its own document 16:20:13 ... makes it also independent 16:20:29 s/machine and human readable/machine-readable and human-readable/ 16:20:39 q+ 16:20:46 ack s 16:21:11 ... new protocol would require to touch core document 16:21:30 ... DID takes similar approach.. core and link is provided 16:22:32 Kaz: My core point is: we need to clarify how to bind protocol 16:22:48 ... w.r.t. DID: DID is different 16:23:27 ... would mean binding needs to change to registry 16:24:23 ... structure/description of binding mechanism is the problem 16:25:04 ... the concept needs to be properly described 16:25:10 EK: I think I understand 16:25:53 Kaz: Issue should #97 should change name 16:26:01 EK: will create a new issue 16:26:27 s/change name/change the title and the content/ 16:27:01 Kaz: I will create a new issue 16:27:11 present+ Michael_Koster 16:27:20 q? 16:27:22 ack k 16:27:25 ... should clarify other questions as well 16:28:45 TOPIC: TD 16:29:04 SUBTOPIC: status of the TD wide review for CR transition 16:29:26 SK: I am still waiting for feedback 16:30:07 ... some horizontal issues are solved 16:30:48 ... a problem that makes it show up "needs resolution" might be a GitHub label issue 16:31:21 SK: Not sure if this actually an issue 16:31:40 ... Ralph just asked for exit criteria.. which we provided 16:31:49 ... maybe Kaz can ping W3C 16:32:07 s/ping W3C/ping Ralph and PLH/ 16:32:14 q_ 16:32:15 q+ 16:33:39 Kaz: will try to talk to them if we don't get any response 16:33:39 s/q_// 16:34:05 SK: Thanks 16:34:39 ... would be just good to know if we missed anything 16:35:11 SUBTOPIC: Missing Implementations 16:35:32 SK: We should start implementing at risk features 16:35:47 ... I think Ege has some good news 16:36:09 EK: played with multilanguages 16:36:31 ... since playground is in browser it works out of the box 16:36:42 ... a single assertion is still misisng 16:36:51 ... editdor supports the same 16:37:16 ... McCool run tools to generate report 16:37:44 ... we might need to wait for new implementation report 16:37:54 SK: Anyhow, good news 16:38:19 ... 2 assertions are fixed 16:38:28 EK: I think even 3 of them.. 16:38:36 ack kaz 16:38:58 SK: PlugFest planned from 12-16 16:39:15 ... since Kaz is not available on 16 we will stop Dec 15 16:39:28 s/will try/as mentioned during the Chairs call 5 hours ago, I'd suggest you ask PLH for help. I'll try/ 16:39:42 EK: I will check oauth from sayWOT 16:40:01 s/oauth/OAuth/ 16:40:03 SUBTOPIC: PRs 16:40:06 q? 16:40:10 ... same set as last time 16:40:26 ... I suggest to wait till we have released CR 16:40:51 ... to avoid confusions 16:41:05 s/multilanguages/td-multi-languages/ 16:41:23 SUBTOPIC: Issue#1747 16:41:35 EK: about member submission 16:41:55 ... googling brings up out-dated documents 16:42:00 i|We should start|-> https://w3c.github.io/wot-thing-description/testing/report11.html draft implementation report| 16:42:14 ... people look at it and see W3C.. looks official 16:42:21 ... what can we do about 16:42:27 s/td-multi-languages/multilanguages/ 16:43:44 SK: Web thing model shows older date 16:43:47 q+ 16:44:19 ... Agree it is confusing to see this document on Google being a sub-document 16:44:22 i|about mem|-> https://github.com/w3c/wot-thing-description/issues/1747 Issue 1747 - Add a warning about the "other" Thing Model specification| 16:45:06 q? 16:45:23 Kaz: I suggest we ignore Google results 16:45:43 ... member submission is just a member submission 16:45:51 ... not part of W3C 16:47:06 s/W3C/W3C Recommendation/ 16:47:07 EK: We can not do anything? 16:47:28 SK: Can we ask W3C system people to lower rank certain entries 16:47:44 ... we cannot influence Google 16:48:11 Kaz: Like confusion W3C and w3cschool 16:48:16 ... we cannot avoid this 16:48:51 s/Kaz: Like confusion W3C and w3cschool// 16:48:59 SK: Maybe system folks have ideas 16:49:05 EK: I can try to ask 16:49:18 ... btw, do member submission expire ? 16:49:40 Kaz: all documents will remain. This is W3C policy 16:49:58 EK: member submission changed? 16:50:10 Kaz: Yes, it can be updated 16:50:39 ... work stems from 2015, before WoT started 16:50:47 s/... we cannot avoid this/Kaz: we cannot avoid this kind of similar entry to be searched/ 16:51:01 SUBTOPIC: Issue#915 16:51:24 SK: old issue about RDF 16:51:27 s/stems/items/ 16:51:39 ... I think we solved it 16:52:04 ... Hence, I suggest to close it 16:52:54 ... -> closing 16:53:03 SUBTOPIC: Issue#998 16:53:12 SK: security-based issue 16:53:29 i|old issue|-> https://github.com/w3c/wot-thing-description/issues/915 Issue 915 - Vocabulary term "scheme" not defined when used inside securityDefinitions| 16:53:41 ... McCool mentions and proposes closing label 16:54:18 ... -> closing 16:54:18 i|security-based|-> https://github.com/w3c/wot-thing-description/issues/998 Issue 998 - [security] API key and PSK security schemes are not referenced or explained| 16:54:55 SUBTOPIC: Issue#1053 16:55:02 SK: Ege put propose closing 16:55:17 ... Ben added defer 2.0 16:55:41 i|Ege put|-> https://github.com/w3c/wot-thing-description/issues/1053 Issue 1053 - Consider adding DataSchema to response and additionalResponses| 16:55:47 ... Ben asks for schema for response container 16:56:16 EK: I don't remember closing it.. it doesn't make sense 16:57:09 ... it relates to query action in Profile 16:58:09 SK: Shall we close this issue? Or revisit it in TD2.0? 16:58:23 EK: I suggest to close it 16:58:45 SK: discussed in query action topic? 16:58:47 EK: Agree 16:58:59 MK: Bigger question 16:59:26 ... what if we have data schema ... in abstract fashion 16:59:41 ... suggest we close.. if something remains we should open other issues 17:00:19 [adjourned] 17:01:45 rrsagent, draft minutes 17:01:45 I have made the request to generate https://www.w3.org/2022/11/23-wot-td-minutes.html kaz 17:02:59 chair: Ege/Sebastian 17:03:00 rrsagent, draft minutes 17:03:00 I have made the request to generate https://www.w3.org/2022/11/23-wot-td-minutes.html kaz 17:03:59 s/MK:/MJK:/ 17:04:01 rrsagent, draft minutes 17:04:01 I have made the request to generate https://www.w3.org/2022/11/23-wot-td-minutes.html kaz