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