This document discusses a semantic web based approach to generating context-adaptable and product-specific documentation. It aims to integrate data from various sources and generate up-to-date documentation customized for the user's context. This is achieved through a smart template system that queries models and context data to output tailored documentation. The approach leverages trends in IoT and semantic web technologies to help users with installation, usage and maintenance of complex systems.

1. Technology for
Pervasive Computing
Semantic Web Based Context-Adaptable Generation
of Product Specific Documentation
Web of Things Workshop
Andrei Miclaus Till Riedel Jack Unseld Michael Beigl
THINGS
Contextual Documentation
Users
Developers
KIT – University of the State of Baden-Wuerttemberg and
National Research Center of the Helmholtz Association www.kit.edu

2. 2 17/10/14 Technology for
Pervasive Computing
Why Appropriate Help is Important
[Beckmann et.al. 2004]
Andrei Miclaus –
Semantic Web Based Context-Adaptable Generation of Product Specific
Documentation

3. 3 17/10/14 Technology for
Pervasive Computing
Our Approach – Generated documentation
! Fusion of context and system models
! Optimized documentation
System
Models
Context
User
Information
Context adapted, up-to-date
Information
Andrei Miclaus –
Semantic Web Based Context-Adaptable Generation of Product Specific
Documentation

4. 4 17/10/14 Technology for
Pervasive Computing
Motivating Factors
! Increasing complexity in the industrial processes
! Supporting a user is an important factor
! The need to use existing data sources without migrating to other
formats
! Especially industry relevant
! Web of things becoming a reality
! Ever increasing number of smart IoT devices
! More and more devices offer high level APIs
Andrei Miclaus –
Semantic Web Based Context-Adaptable Generation of Product Specific
Documentation

5. Context'Model' Text'
5 17/10/14 Technology for
Pervasive Computing
Unified Querying
THINGS
Gear%
Rims%
Fram
e%
Bike%
Descrip2ons'
System models
Andrei Miclaus –
Semantic Web Based Context-Adaptable Generation of Product Specific
Documentation

6. 6 17/10/14 Technology for
Pervasive Computing
How do you stitch all that data
together?

7. Context'Model' Text'
User
THINGS
Gear%
Rims%
Fram
e%
Bike%
Semantic Change Web Membrane (Adapter)
Notifications
Documents
Instant'
Help'
7 17/10/14 Technology for
Pervasive Computing
Data Resource Mashup
Configuration
Feedback
Developer
Smart'Template'
Descrip2ons'
Context'adapted,'up8to8date'
Informa2on'

8. 8 17/10/14 Technology for
Pervasive Computing
Smart Template
Product Layer
Adapter Layer
Live Document
Layer
Configuration Layer
Context'
Model'
Query'Module'
Engine'
Reasoner'
Document'Template'
Listener'
Queries
Configura2on'Wizard'
Base'
Template' Document Engineer
THINGS
Notifications

9. 9 17/10/14 Technology for
Pervasive Computing
Template Example
var entities = getAll(“http://kit.edu/entity/item”)
var greeting = get(“CustomerGreeting”)
p greeting.Text
for item in entities
h2 item.name.Text
item.get(“description”).Text

10. 10 17/10/14 Technology for
Pervasive Computing
Example Documentation
Andrei Miclaus –
Semantic Web Based Context-Adaptable Generation of Product Specific
Documentation

11. Home
Automation
App Store
Text'
Store'
11 17/10/14 Technology for
Pervasive Computing
Document
Generation
Model
Augmentation
Instant Help
Contextual Documentation
Device
Bindings
Text'
Store'
Template
Code%
Model%
User
Developer
Manufacturer
Template

12. rdflib, rdflib-jsonld
Query parser
In json-ld
watches
12 17/10/14 Technology for
Pervasive Computing
Implementation
Xtext project
.ecore
Spreadsheets:
.xls
.csv
DSL-file:
.items
Source files
Model
Xlwrap
java library
emf4sw
java library
Rdf Converters
Using .trig
mapping
Semantic Web Description Image Links Model Metamodel
SPARQL
/description /imageLinks /model /metamodel
endpoints
Live Template
File monitor
notifies

13. 13 17/10/14 Technology for
Pervasive Computing
Conclusion
! Product specific documentation generation approach
! Semantic web for data integration
! Leveraging the IoT and WoT trends
! We enable contextual documentation generation
! For aiding users in the installation, usage and maintenance of systems
Future Work
! Industrial application and user studies
! Gather experience on the authoring process and system adoption
chance
Andrei Miclaus –
Semantic Web Based Context-Adaptable Generation of Product Specific
Documentation

14. Contact: miclaus@teco.edu
14 17/10/14 Technology for
Pervasive Computing
Thank You for Your Attention!
In cooperation with
Andrei Miclaus –
Semantic Web Based Context-Adaptable Generation of Product Specific
Documentation

15. 15 17/10/14 Technology for
Pervasive Computing
References
! Beckmann, C., Consolvo, S., & LaMarca, A. (2004). Some Assembly
Required: Supporting End-User Sensor Installation in Domestic
Ubiquitous Computing Environments. In UbiComp 2004: Ubiquitous
Computing SE - 7 (Vol. 3205, pp. 107–124). Springer Berlin
Heidelberg. doi:10.1007/978-3-540-30119-6_7
! Harrison, N. (2005). The Darwin Information Typing Architecture
(DITA): Applications for globalization. Professional Communication
Conference, 2005
! Guinard, D., Trifa, V. M., & Wilde, E. (2009). Architecting a mashable
open world wide web of things. ETH, Department of Computer Science.
! Miclaus, A., Riedel, T., & Beigl, M. (2014). End-User Installation of
Heterogeneous Home Automation Systems Using Pen and Paper
Interfaces and Dynamically Generated Documentation. The 4th
International Conference on the Internet of Things (IoT 2014).
Please see more in the paper
Andrei Miclaus –
Semantic Web Based Context-Adaptable Generation of Product Specific
Documentation