10:05:46 RRSAgent has joined #wot-arch 10:05:46 logging to https://www.w3.org/2021/12/02-wot-arch-irc 10:05:52 meeting: WoT Architecture 10:05:59 chair: Lagally 10:06:26 present+ Kaz_Ashimura, Ben_Francis, Kunihiko_Toumura, Michael_Lagally, Michael_McCool 10:07:38 Agenda: https://www.w3.org/WoT/IG/wiki/WG_WoT_Architecture_WebConf#Dec_2nd.2C_2021 10:08:23 ryuichi has joined #wot-arch 10:11:06 present+ Ryuichi_Matsukura 10:13:11 present+ Sebastian_Kaebisch 10:13:52 scribenick: benfrancis 10:14:14 topic: Minutes 10:14:20 -> https://www.w3.org/2021/11/25-wot-arch-minutes.html Nov-25 10:14:24 topic: Minutes from Last Meeting 10:15:12 s/topic: Minutes// 10:15:19 s|-> https://www.w3.org/2021/11/25-wot-arch-minutes.html Nov-25|| 10:15:22 -> https://www.w3.org/2021/11/25-wot-arch-minutes.html Nov-25 10:15:25 Mizushima has joined #wot-arch 10:15:35 present+ Tomoaki_Mizushima 10:20:08 subtopic: Canonicalization 10:20:33 Removed canonicalization from Thing Description, still needs removing from Architecture 10:21:13 mlagally: Doesn't appear to be mentioned in Architecture 10:21:38 Any objections? 10:21:42 No, minutes approved. 10:22:01 topic: New Time Slot 10:22:22 -> https://doodle.com/poll/a6ibrh5cg6e9s2yx previous doodle poll 10:23:05 mlagally: Everyone except Sebastian suggested new Doodle poll 10:23:17 Many people also OK with the current slot 10:23:25 But some unhappy 10:23:30 McCool: Yes, unhappy 10:24:10 q+ 10:24:25 There are no fully green columns on the original Doodle poll 10:25:26 We need a two hour time slot 10:25:52 One hour on different days perhaps? 10:28:47 benfrancis: May be easier to find 1 hour time slots for architecture and profiles 10:29:13 McCool: I suggest for next week we keep the current slot, then have a new Doodle poll for separate slots 10:29:43 mlagally: I thought about that too, the only disadvantage is that we have to stick to the schedule 10:30:04 mlagally: Let's do what McCool suggested. Stick to current time slot next week, then separate Doodle polls for after that 10:30:37 McCool: Suggest adding links to the wiki 10:30:48 mlagally: I suggest I create Doodle polls and kaz adds them to wiki 10:31:01 ->https://www.w3.org/WoT/IG/wiki/Main_WoT_WebConf#Under_Discussion main wiki's "Under Discussion" section 10:31:05 topic: Architecture 10:31:33 subtopic: PR 615 - Address Binding Templates related issues 10:31:46 https://github.com/w3c/wot-architecture/pull/615 10:32:02 mlagally: Does anyone suggest any changes? 10:33:08 mlagally: Adds link to new W3C process document, any problems with that? 10:33:38 McCool: The formal process is AC review, opportunity to complain 10:33:58 q+ 10:34:01 mlagally: Seems sensible and well written 10:35:37 benfrancis: Term "blueprint" may create some confusion regarding templates vs. profiles. I will file an issue. 10:35:44 Happy to merge 10:36:53 kaz: During this charter period we use the old patent policy. On the other hand the process document has been updated but referring to the process document is OK from a procedure viewpoint. 10:37:01 mlagally: So you don't have concerns? 10:38:17 Resolution: Merge. 10:38:34 s/updated but/updated, so/ 10:38:35 subtopic: PR 644 Move common terms from Discovery to Architecture 10:38:52 s/to the process document/to the latest process document/ 10:39:29 McCool: Some comments on the "discoverer" term, still under discussion 10:39:44 I propose merging this and change later if needed 10:40:07 s/McCool: Some comments on the "discoverer" term, still under discussion/mlagally: Some comments on the "discoverer" term, still under discussion 10:40:16 Any concerns? 10:40:20 i/Merge/kaz: right. the more important point here is we continue to refer to the 2017 Patent Policy for the current Charter period./ 10:40:25 Resolution: Merge 10:40:54 i/the more/scribenick: kaz/ 10:41:05 i/Some comments/scribenick: benfrancis/ 10:41:11 rrsagent, make log public 10:41:15 rrsagent, draft minutes 10:41:15 I have made the request to generate https://www.w3.org/2021/12/02-wot-arch-minutes.html kaz 10:41:19 McCool: We moved terms over but had one term remaining. Still some discussion on Discoverer/Registerer but haven't reached a resolution, will do this at the same time. 10:41:47 q? 10:41:53 ack ben 10:41:54 ack k 10:42:30 McCool: Suggest merging. Generally suggest keeping all definitions in Architecture. 10:42:45 Merged. 10:42:59 i|Some comments on|https://github.com/w3c/wot-architecture/pull/644| 10:43:48 subtopic: PR 645 - Improve description of device categories 10:43:52 https://github.com/w3c/wot-architecture/pull/645 10:43:53 https://github.com/w3c/wot-architecture/pull/645 10:44:45 s|https://github.com/w3c/wot-architecture/pull/645|| 10:44:52 rrsagent, draft minutes 10:44:52 I have made the request to generate https://www.w3.org/2021/12/02-wot-arch-minutes.html kaz 10:45:48 q+ 10:46:07 q+ 10:46:10 McCool: I'm glad you did this. Suggest changing some sections as a follow-up as part of hub work. Fine with merging this, it is a step forward. 10:46:24 sebastian: Is this your work or from IETF? It would be cool if this was aligned. 10:46:32 mlagally: It is aligned. 10:46:42 McCool: The lower ones are the same, we extrapolated from there. 10:47:03 kaz: OK with content, but maybe the style for the table could be improved. E.g. background colour to identify the lines. 10:47:10 ack k 10:47:13 McCool: We did this for other tables, that could be cleanup, re-use CSS 10:47:34 mlagally: Any volunteers? 10:47:51 McCool: I think we can leave it until the end when we do bugfixes 10:48:03 McCool: An issue for cleanup, with this as a checkbox. 10:49:13 Resolution: Merge. 10:50:04 subtopic: Issue 646 - Section structure, assertions, and issues 10:50:22 ktoumura: A clarification about which sections are normative 10:50:37 https://github.com/w3c/wot-architecture/issues/646 10:51:01 mlagally: What do the question marks mean? 10:51:53 ktoumura: Asks to clarify whether this section is normative or not 10:52:47 McCool: Categories should be informative like terminology 10:53:07 mlagally: I guess System Integration section should also be informative 10:53:51 mlagally: A good example of the question of approval 10:54:09 mlagally: Can we pre-approve that? 10:54:19 q? 10:54:32 sebastian: Yes, OK 10:54:36 mlagally: Do we agree? 10:54:40 (No objections) 10:55:17 Filed issue https://github.com/w3c/wot-architecture/issues/647 10:55:51 And https://github.com/w3c/wot-architecture/issues/648 10:57:05 There are normative parts relating to Thing Description and Discovery 10:57:18 Two main sections which are normative, section 8 and the conformance section 10:57:23 And section 9 10:58:08 mlagally: Do we have issues about the normative statements? 10:58:24 McCool: I think the discovery assertions are appropriate since they are requirements. 10:58:40 McCool: They're really requirements on other specifications. 10:58:41 q+ 10:59:10 mlagally: It looks to me like they should be preserved 10:59:22 McCool: Negative things are hard to test for, but more design questions 10:59:28 Don't have to worry about having test cases for everything 10:59:50 mlagally: Shouldn't go into details here, but this is a good summary 11:00:11 McCool: Should decide what is an appropriate level of detail for WoT Architecture 11:00:30 Not a problem if requirements aren't testable 11:00:54 q+ 11:01:24 ack s 11:01:26 ack b 11:01:49 q++ ben 11:01:57 q- ben 11:01:59 q- + 11:02:21 benfrancis: Should requirements not be in use cases and requirements document 11:02:45 For the record I think all sections of WoT Architecture should be non-normative and normative assertions should be moved to other specifications 11:03:21 mlagally: We should not take the word requirements to mean the same thing across all documents. Use Cases & Requirements is written by a different set of people. 11:03:54 mlagally: Does that answer your question benfrancis? 11:04:11 benfrancis: My point still remains, but I don't expect any action 11:04:42 kaz: Thank you to ktoumura. This is exactly the kind of thing I have been asking editors to do, with this kind of structure. 11:05:19 Regarding benfrancis' point, after some discussion we can define which assertions should be in the architecture document and tested for the architecture specification and which features should be defined and tested by the other specifications. 11:05:45 There is the possibility that WoT Architecture should define abstract design and other specifications should define features 11:06:23 q? 11:06:24 ack k 11:07:55 subtopic: Spec Alignment and Publication Blockers 11:07:59 https://github.com/w3c/wot-architecture/issues?q=is%3Aissue+is%3Aopen+label%3A%22blocks+publication%22+no%3Aassignee 11:08:06 sebastian: I can take all issues related to the Thing Description 11:10:08 topic: common data model and constraints in profiles 11:10:22 q+ 11:10:37 ml: put together a presentation to collect the discussion on this 11:11:20 ... has been a lot of discussion around this 11:11:53 ... original profile doc was a strawman, done over a couple of days two years ago 11:12:11 ... we focused on considerations for small devices at first 11:12:41 ... and wanted to help with adoption, and small devices had the most constraints 11:13:40 ... generic consumer of a TD is not implementable; too open and extensible, TD permits too many things, too few guarantees 11:13:54 ... even if we just limit ourselves to HTTP 11:14:53 i/put together/@@@slides tbd/ 11:15:03 ack m 11:15:06 ... includes an example consumer scenario for a weather station, also maps, predict weather conditions... 11:17:01 mm: btw, I have a system that pretty much does everything listed, including a web api: the Tempest weather station 11:17:09 ... from WeatherFlow 11:19:42 q+ 11:20:25 ml: sensor on maps also needed human readable names, etc. 11:20:42 mm: to summarize, key interop issue here is data interpretation 11:21:06 mm: in general, we want to focus on interop 11:21:45 seb: the elements of human readability opens a large number of complex questions, eg. about internationalization, target audience, etc. 11:22:07 ... also location is a very complex topic (indoor vs. outdoor locations) 11:22:12 ack s 11:22:15 q+ 11:23:46 q+ 11:23:52 ack m 11:24:08 ack m 11:24:34 mm: agree that geolocation is very complex and will probably have to be deferred 11:24:46 ... but units are something we may be able to deal with 11:25:17 ml: also want to address both sensors and gateways 11:26:11 ... gateways may need to aggregate data (for example, computing averages, min/max, smoothing, extrapolation, etc) 11:26:52 kaz: to clarify, this is for issue 125? How many slides? Should we wait for the last page... 11:26:54 ack k 11:26:58 ml: five more slides 11:27:13 ... common data model and operation semantics are important 11:27:38 ... common payload format, common data model and operation semantics 11:28:21 ... for example, properties should be consistent, error formats should be consistent, etc. 11:28:56 ... want event models to also have consistent behavior 11:28:58 q+ 11:29:43 ml: also define a minimum sensor, which is actually a *client*, supporting only push events 11:30:22 ml: home gateway would have more: a server, can read and write properties, and actions 11:30:39 ... industrial gateway would in addition have a scalable event system 11:31:11 ... needs a different event model, but still has common datamodels and operation semantics 11:31:37 q+ 11:32:21 ml: so today we are focused on one protocol and this narrow view may not get us to something that addresses these broader use cases 11:32:43 ... in particular this is the motivation for including webhooks, etc. 11:32:44 q+ to ask which part the Core Profile is within this diagram 11:33:25 ml: in summary, I think the current profile does not address industrial use cases, so should not call it the "core" profile 11:33:51 ... so we could define different profiles for each of these scenarios 11:34:31 ... and then based on what each profile does we should pick an appropriate name 11:34:52 q? 11:34:58 ack m 11:35:29 q+ 11:40:58 ack s 11:47:19 ack k 11:47:19 kaz, you wanted to ask which part the Core Profile is within this diagram 11:47:32 kaz: thanks for detailed description 11:47:52 ... two points; where and which part should be described as a core profile 11:48:21 ... (note that mm stopped taking notes, but ml was capturing some in the presentation...) 11:48:36 kaz: what is the core profile? 11:48:46 ml: this is the green parts in the diagrams 11:49:05 kaz: tend to agree with concrete use cases and requirements and bottom-up approach 11:49:25 ... but in that case looking at particular IoT standards such as OPC-UA and ECHONET 11:49:34 ... these also have a set of basic data models, etc. 11:49:43 ... and event handling mechanisms 11:50:02 ... at some point we need to consider how to bind these, eg. for BIM systems 11:51:54 q? 11:51:58 ack b 11:52:02 mm: however, the HTTP focus is still appropriate if what we are looking at the output of HTTP web proxies/APIs 11:52:24 bf: want to agree with mm and seb about difficulty of defining constraints that apply to everything 11:52:42 ... however, there are some constraints that would be useful, like units, but even that is hard 11:52:45 i/thanks for/scribenick: McCool/ 11:52:52 ... agree with a bottom-up process 11:53:10 ... disagree that the current profile is only good for home gateways 11:53:24 ... but constrained devices may need another profile 11:53:41 ... am a little concerned about not enabling inter-domain applications 11:54:11 ... discussion of events perhaps misses the point, the issue is really TCP which is not efficient for this purpose 11:54:23 ... and do we want interop within profiles or between profiles? 11:54:42 ... regarding my PR that removes data model and moves things around 11:54:44 i/you wanted to ask/@@@McCool's points and Sebastian's points recorded on Lagally's slides directly/ 11:54:49 ... would like to discuss scope, etc. 11:55:19 ... we agreed a while back to focus only on interop, and remove others (human and constrained) 11:55:44 ... also, there was a large amount of initial text that was never reviewed 11:56:04 ... and we need to review each assertion and see if it supports the goals we have agreed to 11:56:06 ml: 11:56:47 ml: object that proposal has not been properly reviewed; did agree to start with strawmen; there were many opportunities for review 11:57:38 ... regarding the two goals: small devices, no problem 11:57:49 s/ml: object/Lagally: object/ 11:57:53 s/ml:// 11:57:53 ... but human readability not being a primary concern I have a problem with 11:58:14 ... if TD does not allow you to build a UI, it is useless for many purposes 11:58:23 ... only supports M2M use cases 11:58:26 q+ 11:58:56 ack m 12:00:21 sorry, I need to go another meeting 12:00:37 s/sorry, I need to go another meeting// 12:00:52 q+ 12:00:53 mm: so what I'm hearing is that *some* human readability issues are interop issues, such as "interop with a dashboard". But we need to clearly and narrowly define these 12:01:27 ... in particular, making titles and descriptions mandatory may not be the right solution; semantic tagging might be better (since they can be mapped into local langauges more easily) 12:01:48 q+ 12:02:23 ml: regarding PR 125, I feel it does too many things at once, so it is too hard to come to a conclusion 12:02:37 kaz: we are overtime; but I felt the discussion was useful 12:03:04 ack k 12:03:06 ack m 12:03:39 ... but I think we may need an even deeper restructuring 12:04:01 mm: perhaps we archive the current doc and start again from an outline, bring things in? 12:04:13 bf: we already did that, and this PR is part of that 12:05:24 My proposed outline https://github.com/w3c/wot-profile/issues/73#issuecomment-804252286 12:06:05 ... and why there are multiple changes in one PR is that removing things required changing references 12:07:30 ml: like idea of starting from a fresh outline and pulling things in 12:08:09 q? 12:08:16 bf: good, ok with that 12:08:38 s/... and/bf: and/ 12:08:46 rrsagent, draft minutes 12:08:46 I have made the request to generate https://www.w3.org/2021/12/02-wot-arch-minutes.html kaz 12:09:47 mm: suggest creating an issue to create a new outline, and an MR to do the archival 12:10:08 ml: let's start with the issue, can do the MR later 12:10:15 ml: creates issue 152 12:11:35 -> https://github.com/w3c/wot-profile/issues/152 Issue 152 12:11:38 [adjourned] 12:11:43 rrsagent, draft minutes 12:11:43 I have made the request to generate https://www.w3.org/2021/12/02-wot-arch-minutes.html kaz