WoT Thing Description Single Source of Truth

Ege Korkan

W3C TPAC Breakouts

Web of Things, not a Protocol

2

Narrow Waist Model

Core Specification: Thing Description (TD)

3

Protocols

Domain Knowledge via

Semantic Annotations

JSON-LD Serialization

Effect in the real world

Discovery and

Usage by Clients

Why is the session relevant for WoT

Example of a TD Vocabulary Term

https://w3c.github.io/wot-thing-description/#simple-thing-description-sample

Example of a TD Vocabulary Term

It is not just a string

https://w3c.github.io/wot-thing-description/#security-digest-example

Where are those terms defined?

In many places…

index.html / Human Readable

https://github.com/w3c/wot-thing-description/blob/main/validation/td-validation.ttl#L144

This is used to generate the index.html

But wait! This is not the definition!

Not done

Official JSON Schema

​

https://github.com/w3c/wot-thing-description/blob/main/validation/td-json-schema-validation.json

Test Case for Implementation Report Generation

Based on the official JSON Schema

​

https://github.com/eclipse-thingweb/playground/blob/master/packages/assertions/assertions-td/td-vocab-security--Form.json

Going to published versions

TD Context

https://github.com/w3c/wot-thing-description/blob/main/context/td-context-1.1.jsonld#L168C18-L168C18

Going to published versions

TD Ontology in TTL and HTML

https://github.com/w3c/wot-thing-description/blob/main/ontology/td.ttl#L141

https://www.w3.org/2019/wot/td#hasSecurityConfiguration

Final Thoughts

• This of course applies to all terms defined in TD
• We wish to change only one line of “code” if we ever change “security” to “sec”