WG WoT Thing Description WebConf
The WoT Thing Description task force is responsible for defining the information model for WoT Thing metadata, its interpretation, and its common representation. In addition, the task force covers WoT Binding Templates topics to define the mapping from the abstract interaction model used in the Thing Description metadata to concrete IoT protocols and payload encodings.
WebConf Information
Wednesdays at 7am US Pacific / 10am US Eastern / 4pm Europe / 10pm China / Midnight Korea & Japan
This is a WoT WG WebConf and underlies the W3C Patent Policy
Call Moderation
The TF is moderated together by Ege Korkan and Michael Koster
- Koster: Basic architectural design, document structure, etc. Project management (keep people informed on the process)
- Ege: concrete description based on the design (constructing the statements for normative/informative style for implementability and testability), call moderation
- Together: Work on how to improve the spec collaboratively, e.g., schedule of the deliverables, and keeping up with the deadlines.
- We join the calls together unless there is a conflict.
- Responsibility is not split, it is shared. If someone asks a question, both should be able to answer it.
- Feedback from the TF:
- Cris: Testability should be assured
- Kaz and Koster: TD still does the governance of testing, we are responsible. To be further discussed and the relationship to testing TF clarified.
Zoom
IRC
- IRC #wot-td channel
- Custom clients: irc.w3.org, port 6667
The IRC is used for the minutes, speaker queue, and sharing links etc.
Scribe List
If an attendee joins after a break, do not give them the scribe role immediately. The one at the top scribes next time they join. Move people to the bottom once they scribe.
- Kaz Ashimura
- Luca Barbato
- Cristiano Aguzzi
- Daniel Peintner
- Jan Romann
- Mahda Noura
- Michael Koster
- Ege Korkan
Agenda
Cancellations: See https://www.w3.org/WoT/IG/wiki/Main_WoT_WebConf#Cancellations_and_Schedule_Updates
Note: Wednesdays start with TD topics and Thursdays start with Binding Templates topics. The other topics will be allocated dynamically based on time left. We will strikethrough discussed topics.
Backlog
For all members, you can edit this header before the meeting and add your points. Please do not insert your topics directly into one of the other headers. TF Moderators will adjust the agenda accordingly.
- Example Item 1: Discussing topic ABC (Ege Korkan)
- Historical Data Analysis: https://github.com/w3c/wot/blob/main/planning/ThingDescription/analysis-historical-data-work-item.md
- Needed by other TF label: https://github.com/w3c/wot-thing-description/issues/1980
- Reviews of the individual bindings to extract use cases
- Waiting for UC Pipeline to be defined
- Extracting missing mechanisms and documenting them
- Missing op mappings that are possible
- Missing protocol mechanisms (e.g. can we do message pattern X of protocol Y in the binding Y?)
- Asking for more input from experts can help
- CA: An example would be the request-response pattern in MQTT. If we can not do it, it should be a use case. If we can, it is a lack of documentation, thus a simple issue.
- MQTT: HiveMQ
- CoAP: Jan Romann knows people. We can also ask Klaus Hartke from Siemens
- HTTP: Needs people but the WG is quite knowledgeable in general
- Websocket: Needs people
- SSE: Needs people
- Modbus: We got a lot of input already but can be double-checked
- BACnet: Quite recent, needs more time
April 24 and 25 2024
Chairs: Michael Koster, Ege Korkan
Organizational
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
- https://www.w3.org/2024/04/18-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets:
- Quick Schedule:
- Wednesday: Ontology Errata, Project Management, if time left Toolchain Updates,
- Thursday: Refactoring (Binding to TD), Small PRs, if time left: Resource Management and Registry Requirements
TD
- News: We reached Issue/PR 2000!
- Ontology errata:
- Toolchain Discussion:
- Initial Work from Mahda: New Repo at https://github.com/w3c/wot-thing-description-toolchain-tmp
- Requirements: https://github.com/w3c/wot-thing-description/blob/main/toolchain/requirements.md
- Alternatives: https://github.com/w3c/wot-thing-description/blob/main/toolchain/tool-analysis.md
- High-level overview of the work: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
Binding Templates
- Registry
- Analysis Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- Requirements PR: https://github.com/w3c/wot/pull/1183
- Refactoring and moving the binding mechanism document to the TD spec
- Issue for discussion: https://github.com/w3c/wot-thing-description/issues/1987
- Small PR for Binding Templates: https://github.com/w3c/wot-binding-templates/pull/360
- BIG PR for TD: https://github.com/w3c/wot-thing-description/pull/2000
- Small PRs
Resource Management
- PR: https://github.com/w3c/wot-thing-description/pull/1969
- Goal: develop a consensus recommendation for the WG
- Discussion on merge or squash commits in general
Project Management
- Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Workflow:
- Description: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
- GitHub Project: https://github.com/orgs/w3c/projects/80 . The idea is to use columns as states. We should have all issues on the left now
- Ege has prepared draft issues in the project to show an example flow
- We need to discuss prioritization
- What can be done without use cases will be anything without the use case label:
- TD Repo: https://github.com/w3c/wot-thing-description/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- Binding Repo: https://github.com/w3c/wot-binding-templates/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- We still have 160 issues in total...
- Adopt the management proposal above and start the issues
April 18, 2024
Chairs: Michael Koster, Ege Korkan
Organizational
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
- https://www.w3.org/2024/04/11-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets: Daniel
- Quick Schedule:
- Thursday: TTWG Binding Registry Analysis, Toolchain Updates, Ontology Errata, Refactoring (Binding to TD)
TD
- News: We reached Issue/PR 2000!
- Ontology erratas:
- Toolchain Discussion:
- Initial Work from Mahda: https://github.com/mahdanoura/thing-description-schema/tree/master
- Question: How should we move forward? Specific folder or branch in TD repo that is replacing the work?
- Luca: A separate branch and then replace everything by deleting the root and getting a clean slate.
- Cris: Agree on a separate branch and we can configure the renderer to use that branch. Don't switch to main until that branch is "ready"
- Kaz: Temporary separate repo
- Requirements: https://github.com/w3c/wot-thing-description/blob/main/toolchain/requirements.md
- Alternatives: https://github.com/w3c/wot-thing-description/blob/main/toolchain/tool-analysis.md
- High-level overview of the work: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
Binding Templates
- Registry
- Analyzing TTWG Work and incorporating to our analysis:
- Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- Issue: https://github.com/w3c/wot/issues/1177
- Requirements PR: https://github.com/w3c/wot/pull/1183
- Refactoring and moving the binding mechanism document to the TD spec
- Issue for discussion: https://github.com/w3c/wot-thing-description/issues/1987
- Small PR for Binding Templates: https://github.com/w3c/wot-binding-templates/pull/360
- BIG PR for TD: https://github.com/w3c/wot-thing-description/pull/2000
- Small PRs
Resource Management
- PR: https://github.com/w3c/wot-thing-description/pull/1969
- Goal: develop a consensus recommendation for the WG
- Discussion on merge or squash commits in general
Project Management
- Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Project Management Proposal: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
- We need to discuss prioritization
- What can be done without use cases will be anything without the use case label:
- TD Repo: https://github.com/w3c/wot-thing-description/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- Binding Repo: https://github.com/w3c/wot-binding-templates/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- We still have 160 issues in total...
- Adopt the management proposal above and start the issues
April 11, 2024
Chairs: Michael Koster, Ege Korkan
Organizational
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
- https://www.w3.org/2024/04/03-wot-td-minutes.html (to be reviewed on Thursday)
- https://www.w3.org/2024/04/04-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets:
- Quick Schedule:
- Thursday: TD Next and Binding Registry. If time is left and there are PRs, toolchain
TD
- TD Next Editor's Draft: https://github.com/w3c/wot-thing-description/pull/1997
- Toolchain Discussion:
- Requirements: https://github.com/w3c/wot-thing-description/blob/main/toolchain/requirements.md
- High-level Diagram and documentation of the features of the TD spec in addition to output resources since they are requirements for tools to support (e.g. unknown object keys). These would be an extended version of the leftmost column of the https://github.com/w3c/wot-thing-description/blob/main/toolchain/tool-analysis.md
# High-level overview of the work: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
Binding Templates
- Small but important Modbus Changes: https://github.com/w3c/wot-binding-templates/pull/359
- Registry
- Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- Issue: https://github.com/w3c/wot/issues/1177
- Requirements PR: https://github.com/w3c/wot/pull/1183
- Breakout Results: A section in /Guide for registry best practices. Input from Media WG is important.
- Analyzing TTWG Work and incorporating to our analysis: https://github.com/w3c/wot/issues/1188
# Refactoring and moving the binding mechanism document to the TD spec
- Initial discussion on the overall plan. Gathering opinions. Pull Request(s) to be done asynchronously.
- Issue for discussion: https://github.com/w3c/wot-thing-description/issues/1987
==== Resource Management ====
- PR: https://github.com/w3c/wot-thing-description/pull/1969
- Goal: develop a consensus recommendation for the WG
- Discussion on merge or squash commits in general
Project Management
- Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Project Management Proposal: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
- We need to discuss prioritization
- https://github.com/w3c/wot-thing-description/pull/1990
- What can be done without use cases will be anything without the use case label:
- TD Repo: https://github.com/w3c/wot-thing-description/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- Binding Repo: https://github.com/w3c/wot-binding-templates/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- We still have 160 issues in total...
- Adopt the management proposal above and start the issues
April 3 and 4, 2024
Chairs: Michael Koster, Ege Korkan
Organizational
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
- https://www.w3.org/2024/03/27-wot-td-minutes.html (to be reviewed on Wednesday)
- https://www.w3.org/2024/03/28-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets:
- Any volunteers for TTWG registry analysis? https://github.com/w3c/wot/issues/1188
- Quick Schedule:
- Wednesday: Small TD stuff, Toolchain and then Refactoring
- Thursday: Resource Management Joint Discussion
- If time left: Project Management Proposal
TD
- Prettier https://github.com/w3c/wot-thing-description/pull/1970 -> Merged
- Small follow up PR: https://github.com/w3c/wot-thing-description/pull/1992
- Small PR on respec errors: https://github.com/w3c/wot-thing-description/pull/1993
- Toolchain Discussion:
- Requirements: https://github.com/w3c/wot-thing-description/blob/main/toolchain/requirements.md
- High-level Diagram and documentation of the features of the TD spec in addition to output resources since they are requirements for tools to support (e.g. unknown object keys). These would be an extended version of the leftmost column of the https://github.com/w3c/wot-thing-description/blob/main/toolchain/tool-analysis.md
- High-level overview of the work: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
Binding Templates
- Refactoring and moving the binding mechanism document to the TD spec
- Initial discussion on the overall plan. Gathering opinions. Pull Request(s) to be done asynchronously.
- Issue for discussion: https://github.com/w3c/wot-thing-description/issues/1987
Resource Management
- Thursday: Joint Resource Management Discussion with a focus on versioning
- PR: https://github.com/w3c/wot-thing-description/pull/1969
- Goal: develop a consensus recommendation for the WG
- Discussion on merge or squash commits in general
Project Management
- Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Project Management Proposal: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
- We need to discuss prioritization
- https://github.com/w3c/wot-thing-description/pull/1990
- What can be done without use cases will be anything without the use case label:
- TD Repo: https://github.com/w3c/wot-thing-description/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- Binding Repo: https://github.com/w3c/wot-binding-templates/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- We still have 160 issues in total...
- Adopt the management proposal above and start the issues
March 27 and 28, 2024
Chairs: Michael Koster, Ege Korkan
Organizational
- New IRC Web Client: Same functionality, new UI
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
- https://www.w3.org/2024/03/13-wot-td-minutes.html (to be reviewed on Wednesday)
- https://www.w3.org/2024/03/14-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets: Mahda
- Quick Schedule:
- Wednesday: Toolchain and TTWG Registry analysis
- Thursday: Resource Management Joint Discussion
TD
- Toolchain Discussion:
- Requirements: https://github.com/w3c/wot-thing-description/blob/main/toolchain/requirements.md
- Documenting the features of the TD spec in addition to output resources since they are requirements for tools to support (e.g. unknown object keys). These would be an extended version of the leftmost column of the https://github.com/w3c/wot-thing-description/blob/main/toolchain/tool-analysis.md
- Higher-level diagram discussion: https://github.com/w3c/wot-thing-description/issues/1958
- High-level overview of the work: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Prettier https://github.com/w3c/wot-thing-description/pull/1970
Binding Templates
- Registry
- Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- Issue: https://github.com/w3c/wot/issues/1177
- Requirements PR: https://github.com/w3c/wot/pull/1183
- Breakout Results: A section in /Guide for registry best practices. Input from Media WG is important. We can append our analysis/survey as well.
- Analyzing TTWG Work
- Discussion: https://github.com/w3c/ttwg/discussions/241
- Boilerplate: https://github.com/w3c/ttwg/tree/main/boilerplate/registry
- Refactoring and moving the binding mechanism document to the TD spec
- We do not move the individual bindings, only the core document
- Table of Contents review. Which section goes where?
- Appendix A of TD overlaps with Bindings section 5
- 7.2 and 7.3 have overlaps with binding mechanism.
- 8.3 overlaps with HTTP binding -> We can remove 8.3 carefully by making sure that there is no information loss.
- Anything that mentions the forms container need to be checked. E.g. 6.3.9 and 5.3.4.
- Otherwise, we can move the whole binding document as a new section. Between section 7 and 8.
Resource Management
- Thursday: Joint Resource Management Discussion with a focus on versioning
- PR: https://github.com/w3c/wot-thing-description/pull/1969
- Goal: develop a consensus recommendation for the WG
- Timeline: TD Call on the 28 of March to present the solution. Ege will beautify the PR above.
Project Management
- Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Project Management Proposal: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
- We need to discuss prioritization
- https://github.com/w3c/wot-thing-description/pull/1990
- What can be done without use cases will be anything without the use case label:
- TD Repo: https://github.com/w3c/wot-thing-description/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- Binding Repo: https://github.com/w3c/wot-binding-templates/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- We still have 160 issues in total...
- Adopt the management proposal above and start the issues
March 20 and 21, 2024
Cancelled
March 13 and 14, 2024
Chairs: Michael Koster, Ege Korkan
Organizational
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
- https://www.w3.org/2024/03/06-wot-td-minutes.html (to be reviewed on Wednesday)
- https://www.w3.org/2024/03/07-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets: Mahda
- Breakouts Debriefing
- TD cancelled for next Wednesday
TD
- Toolchain Discussion:
- Merged PR: https://github.com/w3c/wot-thing-description/pull/1983
- Requirements: https://github.com/w3c/wot-thing-description/pull/1975
- Agreeing on the requirements: https://github.com/w3c/wot-thing-description/blob/egekorkan-patch-3/toolchain/requirements.md
- Higher-level diagram discussion: https://github.com/w3c/wot-thing-description/issues/1958
- High-level overview of the work: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Versioning Discussion (FYI, discussion done separately)
- Requirements are discussed and ready in the PR below.
- PR: https://github.com/w3c/wot-thing-description/pull/1969
- Goal: develop a consensus recommendation for the WG
- Timeline: Main Call 13 March, present the current state. TD Call on 28 March to agree on the solution.
- Prettier https://github.com/w3c/wot-thing-description/pull/1970
Binding Templates
- CoAP: https://github.com/w3c/wot-binding-templates/pull/352
- Registry Requirements
- Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- Issue: https://github.com/w3c/wot/issues/1177
- PR: https://github.com/w3c/wot/pull/1183
- Refactoring and moving the binding mechanism document to the TD spec
- We do not move the individual bindings, only the core document
- Table of Contents review. Which section goes where?
- Appendix A of TD overlaps with Bindings section 5
- 7.2 and 7.3 have overlaps with binding mechanism.
- 8.3 overlaps with HTTP binding -> We can remove 8.3 carefully by making sure that there is no information loss.
- Anything that mentions the forms container need to be checked. E.g. 6.3.9 and 5.3.4.
- Otherwise, we can move the whole binding document as a new section. Between section 7 and 8.
Management
- Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Project Management Proposal: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
- https://github.com/w3c/wot-thing-description/pull/1977
- We need to discuss prioritization
- What can be done without use cases will be anything without the use case label:
- TD Repo: https://github.com/w3c/wot-thing-description/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- Binding Repo: https://github.com/w3c/wot-binding-templates/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- We still have 160 issues in total...
- Adopt the management proposal above and start the issues
Use Case Discussion
- What to do here, what to do in Use Cases TF:
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Any questions on the process?
- Any questions on the issues you have dealt with?
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Also see https://github.com/w3c/wot-usecases/issues/261
- Expectations of stakeholders from the use case TF and the use case process: https://github.com/w3c/wot-usecases/issues/272
- Geolocation Requirements: (links below are sent by Daniel and Michael Lagally)
March 06 and 07, 2024
Chairs: Michael Koster, Ege Korkan
Organizational
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
- Informal Meeting on Wednesday, Feb 28 - no minutes
- https://www.w3.org/2024/02/29-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets:
- Breakouts next week
TD
- High-level overview of the work: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Versioning Discussion
- PR: https://github.com/w3c/wot-thing-description/pull/1969
- Goal: develop a consensus recommendation for the WG
- In TD call: discuss requirements
- Timeline: Main Call 13 March, present the proposal. TD Call on 28 March to agree on the solution.
- Toolchain Discussion:
- Requirements: https://github.com/w3c/wot-thing-description/pull/1975
- Discuss issues with the rendering script
Binding Templates
- CoAP: https://github.com/w3c/wot-binding-templates/pull/352
- Registry Requirements
- Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- Issue: https://github.com/w3c/wot/issues/1177
- PR: https://github.com/w3c/wot/pull/1183
- Refactoring and Moving the core document to TD spec
Management
- Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Project Management Proposal: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
- https://github.com/w3c/wot-thing-description/pull/1977
- We need to discuss prioritization
- What can be done without use cases will be anything without the use case label:
- TD Repo: https://github.com/w3c/wot-thing-description/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- Binding Repo: https://github.com/w3c/wot-binding-templates/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- We still have 160 issues in total...
- Adopt the management proposal above and start the issues
Use Case Discussion
- What to do here, what to do in Use Cases TF:
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Any questions on the process?
- Any questions on the issues you have dealt with?
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Also see https://github.com/w3c/wot-usecases/issues/261
- Expectations of stakeholders from the use case TF and the use case process: https://github.com/w3c/wot-usecases/issues/272
- Geolocation Requirements: (links below are sent by Daniel and Michael Lagally)
February 28 and February 29, 2024
Chairs: Michael Koster, Ege Korkan
Organizational
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
- https://www.w3.org/2024/02/21-wot-td-minutes.html (to be reviewed on Wednesday)
- https://www.w3.org/2024/02/22-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets: Ege, Mahda
- Review discussion from February 28
TD
- Discuss semantic versioning, develop a consensus recommendation for the WG
- Discuss issues with the rendering script
- Brainstorming on high level processes for Toolchain, Ontology, and Registry analysis
- Toolchain Requirements: https://github.com/w3c/wot-thing-description/pull/1975/files
Binding Templates
- CoAP: https://github.com/w3c/wot-binding-templates/pull/352
- Registry Analysis
- Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- Requirements: https://github.com/w3c/wot/issues/1177
Management
- Reorganization of Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- We need to wait for the use cases TF for anything UC-relevant. Should we start this for other items, e.g. tooling, binding mechanism moving to TD etc.?
- Backlog Cleanup about Scripting API issues
- Project Management Proposal: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
- New tables for non UC work items or integrate to first table with new categories. Ege to come with a proposal
- What can be done without use cases will be anything without the use case label:
- TD Repo: https://github.com/w3c/wot-thing-description/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- Binding Repo: https://github.com/w3c/wot-binding-templates/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- I went through all of them (via titles) and added use case label to a couple of them. In those links, if you find issues that can be use cases, please add labels.
- We still have 160 issues in total...
- https://github.com/w3c/wot-thing-description/pull/1977
Use Case Discussion
- What to do here, what to do in Use Cases TF:
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Any questions on the process?
- Any questions on the issues you have dealt with?
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Also see https://github.com/w3c/wot-usecases/issues/261
- Expectations of stakeholders from the use case TF and the use case process: https://github.com/w3c/wot-usecases/issues/272
- Geolocation Requirements: (links below are sent by Daniel and Michael Lagally)
February 21 and February 22, 2024
Chairs: Michael Koster, Ege Korkan
Organizational
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
- DONE https://www.w3.org/2024/02/14-wot-td-minutes.html (to be reviewed on Wednesday)
- https://www.w3.org/2024/02/15-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets: TBD
- Ege may not be available on 28 and 29 of Feb, definitely not available March 20-21.
TD
- TM Namespace: https://github.com/w3c/wot-thing-description/issues/1807
- DONE Toolchain Requirements: https://github.com/w3c/wot-thing-description/pull/1975/files
Binding Templates
- Merged Editorial PRs: https://github.com/w3c/wot-binding-templates/pulls?q=is%3Apr+is%3Aclosed+label%3AEditorial+sort%3Aupdated-desc
- CoAP: https://github.com/w3c/wot-binding-templates/pull/352
- Registry Analysis
- Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- Requirements: https://github.com/w3c/wot/issues/1177
Management
- Reorganization of Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- We need to wait for the use cases TF for anything UC-relevant. Should we start this for other items, e.g. tooling, binding mechanism moving to TD etc.?
- Backlog Cleanup about Scripting API issues
- Project Management Proposal: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
- New tables for non UC work items or integrate to first table with new categories. Ege to come with a proposal
- What can be done without use cases will be anything without the use case label:
- TD Repo: https://github.com/w3c/wot-thing-description/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- Binding Repo: https://github.com/w3c/wot-binding-templates/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- I went through all of them (via titles) and added use case label to a couple of them. In those links, if you find issues that can be use cases, please add labels.
- We still have 160 issues in total...
- https://github.com/w3c/wot-thing-description/pull/1977
Use Case Discussion
- What to do here, what to do in Use Cases TF:
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Any questions on the process?
- Any questions on the issues you have dealt with?
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Also see https://github.com/w3c/wot-usecases/issues/261
- Expectations of stakeholders from the use case TF and the use case process: https://github.com/w3c/wot-usecases/issues/272
- Geolocation Requirements: (links below are sent by Daniel and Michael Lagally)
February 14 and February 15, 2024
Chairs: Michael Koster, Ege Korkan
Organizational
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
- DONE https://www.w3.org/2024/02/07-wot-td-minutes.html (to be reviewed on Wednesday)
- https://www.w3.org/2024/02/08-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets: TBD
- Ege may not be available on 28 and 29 of Feb, definitely not available March 20-21.
Bindings, Profiles, Design
DONE EXCEPT LAST POINT
- Ben Francis will be there on Wednesday to talk about this topic.
- Relevant discussions:
- Email with strawman proposals: https://lists.w3.org/Archives/Public/public-wot-wg/2024Feb/0000.html
- Where to specify the mechanism: https://github.com/w3c/wot-profile/issues/372
- Profile 2.0 mechanism: https://github.com/w3c/wot-profile/issues/285
- Definition discussion: https://github.com/w3c/wot-charter-drafts/issues/14
- Where should the discussion continue? -> Let's not let the results of yesterday go cold!
TD
- TM Namespace: https://github.com/w3c/wot-thing-description/issues/1807
- Addressed by: https://github.com/w3c/wot-resources/pull/20
DONE
- Versioning Discussion: Ege, Luca, Mahda and Klaus H. met separately.
- Short update (2mins): https://github.com/w3c/wot-thing-description/pull/1969
- Let us know if you are interested in upcoming meetings.
Binding Templates
- Merged Editorial PRs: https://github.com/w3c/wot-binding-templates/pulls?q=is%3Apr+is%3Aclosed+label%3AEditorial+sort%3Aupdated-desc
- Profinet Binding: https://github.com/w3c/wot-binding-templates/pull/351
- Only FYI and initial feedback at the moment.
- Registry Analysis
- Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- Requirements: https://github.com/w3c/wot/issues/1177
Management
- Reorganization of Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- We need to wait for the use cases TF for anything UC-relevant. Should we start this for other items, e.g. tooling, binding mechanism moving to TD etc.?
- Project Management Proposal: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
- New tables for non UC work items or integrate to first table with new categories. Ege to come with a proposal
Use Case Discussion
- What to do here, what to do in Use Cases TF:
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Any questions on the process?
- Any questions on the issues you have dealt with?
- Labeling has finished! -> Scripting API issues can be created in TD.
- What can be done without use cases will be anything without the use case label:
- TD Repo: https://github.com/w3c/wot-thing-description/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- Binding Repo: https://github.com/w3c/wot-binding-templates/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- I went through all of them (via titles) and added use case label to a couple of them. In those links, if you find issues that can be use cases, please add labels.
- We still have 160 issues in total...
- Ege will prepare a project management proposal together with Koster?
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Also see https://github.com/w3c/wot-usecases/issues/261
- Expectations of stakeholders from the use case TF and the use case process:
- Let's create an issue in the UC repo after the call with the information below
- TD TF Participants (first priority)
- Ege:
- 1. An issue created in the TD repository that has all the information needed to start working on the discussions to design the feature. This means that the TD TF is not required to contact the people involved in the creation of the use case and requirement and that no other document but the issue is required to create the feature
- 2. The person to contact who is interested in implementing it in a WoT implementation (Thing or Consumer). If the feature is needed by TD TF participants, this can be omitted by putting the TF participant as the contact. This is important so that we do not work on features that no one is interested in implementing, ending up removed after testing for the implementation report. (+1 from Cris)
- Luca:
- 1. So that we do not lose something. E.g. there is a whole application area due to a missing feature.
- 2. From a Marketing POV: People who are looking for a problem can find the solution to their problem. -> That implies that from use cases and requirements we point to the features (UC -> req -> feature)
- Cris:
- 1. Something actionable that we can discuss in the TD TF and implement into the spec.
- Ege:
- Users or Implementors of TD (and WoT)
- This stakeholder group should be clarified. E.g. do we mean developers, architects, end user (non technical person), etc.
- Ege: Identify a similar use case to theirs and get more context about a specific feature.
- Luca: There should be no need to go to use cases document to understand something. If that happens, our spec is not clear enough. For a more advanced user, we can show a way to submit a UC if they find a gap in the respective chapter of the spec. This will help us get more specific input. This can be guided via an issue template.
- Cris: It would help to know if they are in "uncharted" territories. In that case, we can say that "you may have issues since we did not explore this area yet". If it already exists, then they can refer to the existing work and even contact the people (including WG/IG people) who were involved in that use case.
- Geolocation Requirements: Needs input from Michael Lagally
February 7 and February 8, 2024
Chairs: Michael Koster, Ege Korkan
Organizational
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
- https://www.w3.org/2024/01/31-wot-td-minutes.html (to be reviewed on Wednesday)
- https://www.w3.org/2024/02/01-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets: TBD
- DONE: Goal of Wednesday: Clean the agenda! Talk about management and use case topics.
- What to do with the previous slot taking too long. We lose a relatively long part of the session.
TD
- DONE: Wrong SHACL errors: PR: https://github.com/w3c/wot-thing-description/pull/1966
- Toolchain improvement analysis: https://github.com/w3c/wot-thing-description/pull/1967
- Versioning Discussion (to be done Thursday 08 Feb with McCool)
- PR for the organization: https://github.com/w3c/wot-thing-description/pull/1965
Binding Templates
- Merged Editorial PRs: https://github.com/w3c/wot-binding-templates/pulls?q=is%3Apr+is%3Aclosed+label%3AEditorial+sort%3Aupdated-desc
- Registry Analysis
- Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- Issue tracker: https://github.com/w3c/wot/issues/1177
Management
- Reorganization of Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- We need to wait for the use cases TF for anything UC-relevant. Should we start this for other items, e.g. tooling, binding mechanism moving to TD etc.?
- DONE: https://github.com/w3c/wot/pull/1176
- DONE: Project Management Proposal: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
- New tables for non UC work items or integrate to first table with new categories. Ege to come with a proposal
Use Case Discussion
- What to do here, what to do in Use Cases TF:
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Labels: https://github.com/w3c/wot/pull/1175
- To be proposed in the main call as well
- Any questions on the process?
- Any questions on the issues you have dealt with?
- To be forwarded to member-wg as FYI
- Labels: https://github.com/w3c/wot/pull/1175
- What can be done without use cases will be anything without the use case label:
- TD Repo: https://github.com/w3c/wot-thing-description/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- Binding Repo: https://github.com/w3c/wot-binding-templates/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- This can be an "Issue to UC" policy. Let's present it in use cases tf next week for other TFs to also apply. If there is good feedback, let's make it a WG policy. The TD TF can start the job already.
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Also see https://github.com/w3c/wot-usecases/issues/261
- Expectations of stakeholders from the use case TF and the use case process:
- TD TF Participants (first priority)
- Ege:
- 1. An issue created in the TD repository that has all the information needed to start working on the discussions to design the feature. This means that the TD TF is not required to contact the people involved in the creation of the use case and requirement and that no other document but the issue is required to create the feature
- 2. The person to contact who is interested in implementing it in a WoT implementation (Thing or Consumer). If the feature is needed by TD TF participants, this can be omitted by putting the TF participant as the contact. This is important so that we do not work on features that no one is interested in implementing, ending up removed after testing for the implementation report. (+1 from Cris)
- Luca:
- 1. So that we do not lose something. E.g. there is a whole application area due to a missing feature.
- 2. From a Marketing POV: People who are looking for a problem can find the solution to their problem. -> That implies that from use cases and requirements we point to the features (UC -> req -> feature)
- Ege:
- Users or Implementors of TD (and WoT)
- This stakeholder group should be clarified. E.g. do we mean developers, architects, end user (non technical person), etc.
- Ege: Identify a similar use case to theirs and get more context about a specific feature.
- Luca: There should be no need to go to use cases document to understand something. If that happens, our spec is not clear enough. For a more advanced user, we can show a way to submit a UC if they find a gap in the respective chapter of the spec. This will help us get more specific input. This can be guided via an issue template.
- TD TF Participants (first priority)
- Geolocation Requirements: Needs input from Michael Lagally
January 31 and February 1, 2024
Chairs: Michael Koster, Ege Korkan
Organizational
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
- DONE: https://www.w3.org/2024/01/24-wot-td-minutes.html (to be reviewed on Wednesday)
- https://www.w3.org/2024/01/25-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets: TBD
TD
- Versioning Discussion (to be done Thursday 08 Feb with McCool)
- PR for organization: https://github.com/w3c/wot-thing-description/pull/1965
- DONE: Toolchain improvements. Small presentation from Mahda with initial analysis results.
- Scripting API issues that are dependent on TD: https://github.com/w3c/wot-scripting-api/issues?q=is%3Aopen+is%3Aissue+label%3Await-for-td
- High-priority issues seem to be about meta operations (and operations in general). -> Meta operation work item needs to be detailed with these issues and start work
- There is one dependency on the validation work item: https://github.com/w3c/wot-scripting-api/issues/238
- No priority set: https://github.com/w3c/wot-scripting-api/issues?q=is%3Aopen+is%3Aissue+label%3Await-for-td+-label%3A%22priority%3A+high%22+-label%3A%22priority%3A+low%22
- Depends on the versioning discussion: https://github.com/w3c/wot-scripting-api/issues/488
- More priority for https://github.com/w3c/wot-scripting-api/issues/351 since it a bit of a design issue or editorial (if we add a warning)
- Ege's opinion: Let's wait for the issue sorting to be over and create corresponding issues for those if they already don't exist. Then, we link to those issues from Scripting API.
- Wrong SHACL errors: https://github.com/w3c/wot-thing-description/issues/1345
Binding Templates
- Merged Editorial PRs: https://github.com/w3c/wot-binding-templates/pulls?q=is%3Apr+is%3Aclosed+label%3AEditorial+sort%3Aupdated-desc
- Registry Analysis
- Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- IANA Registries PR: https://github.com/w3c/wot/pull/1161
- TO BE TRACKED VIA USE CASES TF: Reviews of the individual bindings to extract use cases
- Extracting missing mechanisms and documenting them
- Missing op mappings that are possible
- Missing protocol mechanisms (e.g. can we do message pattern X of protocol Y in the binding Y?)
- Asking for more input from experts can help
- CA: An example would be the request-response pattern in MQTT. If we can not do it, it should be a use case. If we can, it is a lack of documentation, thus a simple issue.
- MQTT: HiveMQ
- CoAP: Jan Romann knows people. We can also ask Klaus Hartke from Siemens
- HTTP: Needs people but the WG is quite knowledgeable in general
- Websocket: Needs people
- SSE: Needs people
- Modbus: We got a lot of input already but can be double-checked
- BACnet: Quite recent, needs more time
- Extracting missing mechanisms and documenting them
Management
- Reorganization of Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Project Management Proposal: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
- We need to wait for the use cases TF for anything UC-relevant. Should we start this for other items, e.g. tooling, binding mechanism moving to TD etc.?
- This relates to the reorganization item above since we need to put work items into order
- We need to wait for the use cases TF for anything UC-relevant. Should we start this for other items, e.g. tooling, binding mechanism moving to TD etc.?
Use Case Discussion
- What to do here, what to do in Use Cases TF:
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Labels: https://github.com/w3c/wot/pull/1175
- To be proposed in the main call as well
- Any questions on the process?
- Any questions on the issues you have dealt with?
- Labels: https://github.com/w3c/wot/pull/1175
- What can be done without use cases will be anything without the use case label:
- TD Repo: https://github.com/w3c/wot-thing-description/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- Binding Repo: https://github.com/w3c/wot-binding-templates/issues?q=is%3Aopen+is%3Aissue+-label%3A%22Has+Use+Case+Potential%22+-label%3A%22Selected+for+Use+Case%22
- This can be an "Issue to UC" policy. Let's present it in use cases tf next week for other TFs to also apply. If there is good feedback, let's make it a WG policy. The TD TF can start the job already.
- We do issue labeling here first. See https://github.com/w3c/wot-usecases/blob/egekorkan-issue-process/tf-issue-process.md . An email is sent to participants from Jan 24.
- Also see https://github.com/w3c/wot-usecases/issues/261
- Expectations of stakeholders from the use case TF and the use case process:
- TD TF Participants (first priority)
- Ege:
- 1. An issue created in the TD repository that has all the information needed to start working on the discussions to design the feature. This means that the TD TF is not required to contact the people involved in the creation of the use case and requirement and that no other document but the issue is required to create the feature
- 2. The person to contact who is interested in implementing it in a WoT implementation (Thing or Consumer). If the feature is needed by TD TF participants, this can be omitted by putting the TF participant as the contact. This is important so that we do not work on features that no one is interested in implementing, ending up removed after testing for the implementation report. (+1 from Cris)
- Ege:
- Users of TD (and WoT)
- Ege: Identify similar use case to theirs and get more context about a specific feature.
- TD TF Participants (first priority)
- DONE: Ege to create labels that match the work item categories
January 24 and 25, 2024
Chairs: Michael Koster, Ege Korkan
Note: Wednesdays start with TD topics and Thursdays start with Binding Templates topics. The other topics will be allocated dynamically based on time left. We will strikethrough discussed topics.
Organizational
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
https://www.w3.org/2024/01/17-wot-td-minutes.html (to be reviewed on Wednesday)- https://www.w3.org/2024/01/18-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets: TBD
WoT Resources and TD 1.1
TD
Data Mapping: https://github.com/w3c/wot/pull/1165Formatting before starting work: https://github.com/w3c/wot-thing-description/issues/1926- Versioning Discussion (to be done Thursday with McCool): https://github.com/w3c/wot/issues/1166
Binding Templates
- Merged Editorial PRs: https://github.com/w3c/wot-binding-templates/pulls?q=is%3Apr+is%3Aclosed+label%3AEditorial+sort%3Aupdated-desc
- Registry Analysis
- Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- IANA Registries PR: https://github.com/w3c/wot/pull/1161
- Starting to write our requirements for our registry mechanism: https://github.com/w3c/wot/tree/main/registry-analysis#wot-requirements-and-expectations-for-a-potential-registry
- Reviews of the individual bindings,
- Extracting missing mechanisms and documenting them
- Missing op mappings that are possible
- Missing protocol mechanisms (e.g. can we do message pattern X of protocol Y in the binding Y?)
- Asking for more input from experts can help
- CA: An example would be the request-response pattern in MQTT. If we can not do it, it should be a use case. If we can, it is a lack of documentation, thus a simple issue.
- MQTT: HiveMQ
- CoAP: Jan Romann knows people. We can also ask Klaus Hartke from Siemens
- HTTP: Needs people but the WG is quite knowledgeable in general
- Websocket: Needs people
- SSE: Needs people
- Modbus: We got a lot of input already but can be double-checked
- BACnet: Quite recent, needs more time
- Extracting missing mechanisms and documenting them
Management
- Reorganization of Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Project Management Proposal: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
Use Case Discussion
- What to do here, what to do in Use Cases TF:
- We do issue labeling here first.
- Also see https://github.com/w3c/wot-usecases/issues/261
- Splitting issues to find "promising use cases"?
- They label issues that have use case like content with "Needs use case" label. The issues that do not get the label are probably one of the following:
- Tooling: probably already has Tooling label, please add it otherwise.
- Internal work: Example 1, Example 2. You should use the appropriate label or note the issue number for a quick discussion in the next calls.
- Fixing something simple: Example 1, Example 2. You should use the appropriate label or note the issue number for a quick discussion in the next calls.
- Unclear issues: In this case, use "Not Clear" label.
- They evaluate the relevance of the issue to the charter. E.g. use cases that are more theoretical are lower prioritized, use cases with real application behind are higher prioritized.
- First of all, "Needs use case" label should be present.
- If another TF has raised it, use "Needed by other TF" label.
- If you are not sure about the relevance to the charter, use "Relevance Unclear" label. If the group agrees, we will remove the "Defer to TD 2.0" label.
- If you think they are relevant for the charter, make sure that they have "Defer to TD 2.0" label.
- In the end, we will provide Use Case or User Story descriptions for the issues that have "Needs use case" and "Defer to TD 2.0" label.
- Call participants on the 24.01 are to be considered.
- We should look into Binding and TD repositories.
- Together there are 268 issues. We are about 9 or 10 participants
- We can give about 25 issues per TF participant. We should ask if they prefer TD or Binding issues first of all. Then split:
- We cannot say issues with number 25 to 50 belongs to person X. There may be no issue 26 since that can be a PR or it is an already closed issue.
- There are, luckily, 25 issues per page, except for the last page. So one page per participant makes sense but we should note down the issue range since a new issue will push all other issues by one.
- They label issues that have use case like content with "Needs use case" label. The issues that do not get the label are probably one of the following:
January 17 and 18, 2024
Chairs: Michael Koster, Ege Korkan
Note: Wednesdays start with TD topics and Thursdays start with Binding Templates topics. The other topics will be allocated dynamically based on time left.
Organizational
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week:
https://www.w3.org/2024/01/10-wot-td-minutes.html (to be reviewed on Wednesday)- https://www.w3.org/2024/01/11-wot-td-minutes.html (to be reviewed on Thursday)
- Regrets: TBD
Should we cancel February 14 and 15 meetings? TF: No need to cancel so far.
WoT Resources and TD 1.1
Static Ontology files: https://github.com/w3c/wot-thing-description/issues/1940 related to ontology fixes: https://github.com/w3c/wot-thing-description/pull/1952Tooling Description: https://github.com/w3c/wot-thing-description/pull/1933
TD
Assertion ID Alignment: https://github.com/w3c/wot-thing-description/pull/1945- Data Mapping: https://github.com/w3c/wot/pull/1165
- Formatting before starting work: https://github.com/w3c/wot-thing-description/issues/1926
Binding Templates
- Merged Editorial PRs: https://github.com/w3c/wot-binding-templates/pulls?q=is%3Apr+is%3Aclosed+label%3AEditorial+sort%3Aupdated-desc
- Registry Analysis
- Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- IANA Registries PR: https://github.com/w3c/wot/pull/1161
- Starting to write our requirements for our registry mechanism: https://github.com/w3c/wot/tree/main/registry-analysis#wot-requirements-and-expectations-for-a-potential-registry
- Reviews of the individual bindings,
- Extracting missing mechanisms and documenting them
- Missing op mappings that are possible
- Missing protocol mechanisms (e.g. can we do message pattern X of protocol Y in the binding Y?)
- Asking for more input from experts can help
- CA: An example would be the request response pattern in MQTT. If we can not do it, it should be a use case. If we can, it is a lack of documentation, thus a simple issue.
- MQTT: HiveMQ
- CoAP: Jan Romann knows people. We can also ask Klaus Hartke from Siemens
- HTTP: Needs people but the WG is quite knowledgable in general
- Websocket: Needs people
- SSE: Needs people
- Modbus: We got a lot of input already but can be double checked
- BACnet: Quite recent, needs more time
- Extracting missing mechanisms and documenting them
Management
- Reorganization of Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Project Management Proposal: https://github.com/w3c/wot-thing-description/blob/main/proposals/project-management/project-management.md
- Small extension: https://github.com/w3c/wot-thing-description/pull/1954
Use Case Discussion
- What to do here, what to do in Use Cases TF
- Data Mapping
- Issues/Discussion in BACnet, Modbus, recently Profinet. Relevant discussions before in LWM2M or Philips Hue.
- Proposal: Start work on this by gathering all the relevant existing inputs into the https://github.com/w3c/wot/blob/main/planning/ThingDescription/td-next-work-items/usability-and-design.md#data-schema-mapping and then move it to the new use cases workflow.
- Notes:
- Analyze PACK (or similar) mechanisms found in programming languages such as Python.
- We need to differentiate serialization with concrete packing mechanisms and those that dont. So paying attention to contentType and contentCoding is needed.
- Luca B. will do the first PR on this (not to TD spec but to wot repo) and people can comment with any missing discussion so far.
- There can be proposals but no PRs to change spec at this point
- Use Case Analysis and Requirement Extraction Workflow
- We have to look at the other work listed below:
- Security "Dimensions": https://github.com/w3c/wot-usecases/blob/main/USE-CASES/security-categories.csv where the columns are filled over time per individual use case analysis
- Discovery Requirements with their associated Use Cases: https://w3c.github.io/wot-usecases/#discovery . This assumes that there is a list of requirements for Discovery
- Coverage Table: https://github.com/w3c/wot-usecases/blob/main/USE-CASES/coverage.csv This has a small requirement extracted from all use cases for TD and Binding.
- Use Cases should be iterated to extract the information we need.
- Relates to https://github.com/w3c/wot-usecases/issues/192 but also mentioned by JR.
- New use cases should at least have that information if we cannot iterate through use cases. Or we filter out current use cases if they cannot fulfill the template requirements.
- Pick Use Cases that are of importance
- CA: Extracting User Stories from Use Cases. What the user (developer) wants to do with WoT (TDs), are they able to do it (if they are submitting the US, they are not able to).
- We have to look at the other work listed below:
- Backtracking some additions in TD 1.1 and 1.0:
- User Story is something written like a user.
- As User X, I want to ABC so I can achieve XYZ
- It should be specific to WoT (e.g. I want to monitor my trucks so I can have less maintenance costs is not good)
- We can specify types of users (personas)
- Thing Models
- Use Case: Managing/Representing a set of instantiations of the same model of a device. Correlating (search) in a collection of TDs that represent the same model of the device.
- User Story: TBD
- Requirement: One file to represent a model of the device
- Feature: Thing Model mechanism
- Extension/Submodel in Thing Models
- Use Case: Reusability. Consistent affordance definition for reuse, e.g. of temperature.
- Requirement: Reuse of existing definitions found in Thing Models
- Feature: tm:submodel, tm:extends etc.
- synchronous word in actions
- Use Case: Interacting with two robots that behave slightly differently (one replying rightaway and moving, other moving and then replying)
- User Story: TBD
- Requirement: A keyword should indicate this behavior
- Feature: "synchronous" keyword with boolean type
- User Story is something written like a user.
January 11, 2024
Chairs: Michael Koster, Ege Korkan
Organizational (5 mins)
- Scribe: Pick a scribe from the list above.
- Agenda Review
- Draft minutes of last week: None
- Regrets: TBD
- Should we cancel February 14 and 15 meetings? TF: No need to cancel so far.
Binding Templates
- Merged Editorial PRs: https://github.com/w3c/wot-binding-templates/pulls?q=is%3Apr+is%3Aclosed+label%3AEditorial+sort%3Aupdated-desc
- Starting with Data Mapping topic by gathering use cases from protocols?
- Issues/Discussion in BACnet, Modbus, recently Profinet. Relevant discussions before in LWM2M or Philips Hue.
- Proposal: Start work on this by gathering all the relevant existing inputs into the https://github.com/w3c/wot/blob/main/planning/ThingDescription/td-next-work-items/usability-and-design.md#data-schema-mapping and then move it to the new use cases workflow.
- Notes:
- Analyze PACK (or similar) mechanisms found in programming languages such as Python.
- We need to differentiate serialization with concrete packing mechanisms and those that dont. So paying attention to contentType and contentCoding is needed.
- Luca B. will do the first PR on this (not to TD spec but to wot repo) and people can comment with any missing discussion so far.
- Registry Analysis: Work is documented at https://github.com/w3c/wot/blob/main/registry-analysis/Readme.md
- W3C Custom Mechanisms (merged): https://github.com/w3c/wot/pull/1150
- IANA Registries PR: https://github.com/w3c/wot/pull/1161
- Official W3C Registries: https://github.com/w3c/wot/pull/1164
TD
- TM.html and .svg: https://github.com/w3c/wot-thing-description/pull/1935
- Deleting td.js: https://github.com/w3c/wot-thing-description/pull/1949
- Updating robots.txt: https://github.com/w3c/wot-thing-description/pull/1950
- Deleting tag review and documenting it: https://github.com/w3c/wot-thing-description/pull/1953
- Formatting before starting work: https://github.com/w3c/wot-thing-description/issues/1926
- Assertion ID Alignment: https://github.com/w3c/wot-thing-description/pull/1945
- Reporting on WebAgents CG on Manageable Affordances
January 10, 2024
Chairs: Michael Koster, Ege Korkan
Organizational
- Scribe: Pick a scribe from the list above
- Agenda Review
- Draft minutes of last week: https://www.w3.org/2023/12/20-wot-td-minutes.html (reviewed by Ege and Koster)
- New TD Call Slot:
- Please remove the old entries from your calendars.
- Wednesday 10 am EST (see https://www.w3.org/events/meetings/d36cf33e-0359-45f8-be6c-5c93a9ef3cb1/20240110T100000/)
- Thursday 9 am EST (see https://www.w3.org/events/meetings/a9562124-2c66-4383-b374-af368be911a8/20240111T090000/)
- TD Coordination slot: Wednesday 7 am EST, 1 pm CET) (Only FYI, only for Ege, Koster and Kaz)
- Splitting of the topics: We fix the topic that starts the meeting. Wednesdays we start with TD.next, Thursday with Specific Bindings. This method can be revised when we learn more about how we work.
- Wiki Organization: Archived everything from 2023 and older.
- Regrets: TBD
WoT Resources and TD 1.1
- TM.html and .svg: https://github.com/w3c/wot-thing-description/pull/1935
- Versioning: https://github.com/w3c/wot-thing-description/pull/1951
- Static dates: https://github.com/w3c/wot-thing-description/issues/1940 related to ontology fixes: https://github.com/w3c/wot-thing-description/pull/1952
TD
- What to do with https://github.com/w3c/wot-thing-description/blob/main/tag-review.html ? -> Add a mention in Readme and delete it. Provide link to a git version
- PLANNING.md deletion: https://github.com/w3c/wot/pull/1163 together with https://github.com/w3c/wot-thing-description/pull/1948
- Management
- Reorganization of Work Items: https://github.com/w3c/wot/blob/main/planning/ThingDescription/work-items.md
- Project Management: TBD
- Tooling and under-the-hood work
- Tooling Description: https://github.com/w3c/wot-thing-description/pull/1933
- Analyses:
- Historical Data Analysis: https://github.com/w3c/wot/blob/main/planning/ThingDescription/analysis-historical-data-work-item.md
- Use Case Analysis and Requirement Extraction
- We have to look at the other work listed below:
- Security "Dimensions": https://github.com/w3c/wot-usecases/blob/main/USE-CASES/security-categories.csv where the columns are filled over time per individual use case analysis
- Discovery Requirements with their associated Use Cases: https://w3c.github.io/wot-usecases/#discovery . This assumes that there is a list of requirements for Discovery
- Coverage Table: https://github.com/w3c/wot-usecases/blob/main/USE-CASES/coverage.csv This has a small requirement extracted from all use cases for TD and Binding.
- Use Cases should be iterated to extract the information we need.
- Relates to https://github.com/w3c/wot-usecases/issues/192 but also mentioned by JR.
- New use cases should at least have that information if we cannot iterate through use cases. Or we filter out current use cases if they cannot fulfill the template requirements.
- Pick Use Cases that are of importance
- CA: Extracting User Stories from Use Cases. What the user (developer) wants to do with WoT (TDs), are they able to do it (if they are submitting the US, they are not able to).
- We have to look at the other work listed below:
- Backtracking some additions in TD 1.1:
- User Story is something written like a user.
- As User X, I want to ABC so I can achieve XYZ
- It should be specific to WoT (e.g. I want to monitor my trucks so I can have less maintenance costs is not good)
- We can specify types of users (personas)
- Thing Models
- Use Case: Managing/Representing a set of instantiations of the same model of a device. Correlating (search) in a collection of TDs that represent the same model of the device.
- User Story: TBD
- Requirement: One file to represent a model of the device
- Feature: Thing Model mechanism
- Extension/Submodel in Thing Models
- Use Case: Reusability. Consistent affordance definition for reuse, e.g. of temperature.
- Requirement: Reuse of existing definitions found in Thing Models
- Feature: tm:submodel, tm:extends etc.
- synchronous word in actions
- Use Case: Interacting with two robots that behave slightly differently (one replying rightaway and moving, other moving and then replying)
- User Story: TBD
- Requirement: A keyword should indicate this behavior
- Feature: "synchronous" keyword with boolean type
- User Story is something written like a user.
Agenda Archives
- 2023: https://www.w3.org/WoT/IG/wiki/WG_WoT_Thing_Description_WebConf/2023
- 2022: https://www.w3.org/WoT/IG/wiki/WG_WoT_Thing_Description_WebConf/2022
- 2021: https://www.w3.org/WoT/IG/wiki/WG_WoT_Thing_Description_WebConf/2021
- 2020: https://www.w3.org/WoT/IG/wiki/WG_WoT_Thing_Description_WebConf/2020
- 2019: https://www.w3.org/WoT/IG/wiki/WG_WoT_Thing_Description_WebConf/2019