WIDOCO is a WIzard for DOCumenting Ontologies that guides users through the documentation process of their vocabularies. Given an RDF vocabulary, WIDOCO detects missing vocabulary metadata and creates a documentation with diagrams, human readable descriptions of the ontology terms and a summary of changes with respect to previous versions of the ontology. The documentation consists on a set of linked enriched HTML pages that can be further extended by end users. WIDOCO is open source and builds on well established Semantic Web tools. So far, it has been used to document more than one hundred ontologies in different domains.

1. WIDOCO: A WIzard for DOCumenting Ontologies
Daniel Garijo
Information Sciences Institute, University of Southern California,
@dgarijov
dgarijo@isi.edu
Information
Sciences
Institute
International Semantic Web Conference: Resources Track

2. Congratulations! You created a stable
release of your ontology. However:
WIDOCO: A Wizard for documenting Ontologies. ISWC Resources Track, 2017
Does it have any common pitfalls I am not aware of?
How do I create a human readable version?
(possiby in multiple languages)
How do I create proper visualizations?
How can I publish it in a machine readable and human readable manner?
How can I describe my ontology so
others can use it?
(OWLDoc)
OBO
PROV
For each ontology version!!!

3. Challenges
• Lack of guidelines/best practices on ontology documentation and annotation
• What metadata is missing in current ontology descriptions?
• Lack of an ecosystem for ontology documentation
• Difficult for non programmers to customize and edit the outcome of existing tools
WIDOCO: A Wizard for documenting Ontologies. ISWC Resources Track, 2017

4. WIDOCO: Helping users documenting ontologies
Ontology file/URI
(TTL, RDF/XML, N3)
- Metadata (e.g., creator,
license, date, contributor,
previous version)
- Class definition
- Object property definition
- Data property definition
- Individual definition
Term documentation section
Content
negotiation file
(.htaccess)
Ontology file (N3)
Input Output
Documentation
nexus HTML file
- Ontology metadata
- Visualization
- Term documentation
- Change explanation
- Provenance
- Semantic annotations
(JSON-LD Snippets)
Ontology file (TTL)
Ontology file (RDF/XML)
Visualization overview section
Change explanation section
Provenance page
W
I
Z
A
R
D
https://w3id.org/widoco/bestPractices
WIDOCO: A Wizard for documenting Ontologies. ISWC Resources Track, 2017

5. WIDOCO: Documenting ontologies in 4 steps
(DEMO)
Ontology
Metadata
Term documentation
Visualization
Change explanation
Provenance
Pitfall reports
Content
Negotiation
JSON-LD annotations
Integrated, expanded or adapted tools:
Expanded Adapted Integrated IntegratedExpanded
WIDOCO: A Wizard for documenting Ontologies. ISWC Resources Track, 2017

6. WIDOCO: A Wizard for documenting Ontologies. ISWC Resources Track, 2017
Wizard snapshot
Ontology metadata
(recognized
automatically )
Missing metadata
Language
selection
License
enrichment
https://w3id.org/widoco/bestPractices

7. WIDOCO: A Wizard for documenting Ontologies. ISWC Resources Track, 2017
Community adoption: known usages
• Vocabularies
• Spanish Geographical Institute ontologies (BTN 100) (11)
• Vocab.linkeddata.es: vocabularies developed or contributed to by the Ontology Engineering Group (30+)
• Domains: eScience (Smart Protocols, provenance in workflows, etc.), Licensing, Libraries, Videogames,
Environment modeling, Quality modeling
• Automated Discovery of Scientific Knowledge (2)
• Paleo Climate data and Observations (6)
• Software descriptions (2)
• Tools for facilitating ontology engineering
• OnToology (100+)
• VoCol (10)
http://ontoology.linkeddata.es/

8. WIDOCO: A Wizard for documenting Ontologies. ISWC Resources Track, 2017
Testing WIDOCO
35+ ontologies have been used to test WIDOCO:
• Big sized ontologies (1000+ classes)
• Ontologies in multiple languages
• Ontology versions
• Ontologies with wrong or missing metadata
• Ontologies with missing imports
• Ontologies mixing local and external imports
• Ontologies in different serializations
• Ontologies with individuals
• Regular ontologies
https://w3id.org/widoco/benchmark

9. WIDOCO: A Wizard for documenting Ontologies. ISWC Resources Track, 2017
Conclusions and future work
• Documentation of ontologies may become a tedious task
• Lack of guidelines for documentation/annotation
• Heterogeneous tooling
• Time investment when integrating and editing outcome from existing solutions
• WIDOCO (https://github.com/dgarijo/Widoco/)
• Guides users in the process of documenting their ontologies
• Integrates tools for presenting, versioning, publishing, evaluating and visualizing an ontology
• Flexible structure for editing an ontology documentation
• Metadata guidelines: https://w3id.org/widoco/bestPractices
• Testbed: https://w3id.org/widoco/benchmark
• Examples: https://w3id.org/widoco/gallery
• Have you found any problem? Report it: https://github.com/dgarijo/Widoco/issues
• Future work: Address pending issues, support additional metadata properties

10. Contributors:
WIDOCO: A Wizard for documenting Ontologies. ISWC Resources Track, 2017
Tester and OnToology integration: Ahmad Alobaid
Logo designer: Idafen Santana
Feedback
Olga Ximena Giraldo
María Poveda
Code contributors:
Miguel Angel García
Almudena Ruiz
Oscar Corcho
Martin Scharm
Feedback on publication: Yolanda Gil
GitHub users who opened issues and gave feedback

11. WIDOCO: A Wizard for documenting Ontologies. ISWC Resources Track, 2017
References
• Tools integrated/expanded by WIDOCO
• LODE: http://www.essepuntato.it/lode/
• WebVOWL: http://vowl.visualdataweb.org/webvowl/
• Bubcastis: https://www.ebi.ac.uk/efo/bubastis/
• Licensius: http://licensius.com/
• OOPS!: http://oops.linkeddata.es/

12. WIDOCO: A WIzard for DOCumenting Ontologies
Daniel Garijo
Information Sciences Institute, University of Southern California,
@dgarijov
dgarijo@isi.edu
Information
Sciences
Institute
International Semantic Web Conference: Resources Track