Overview

The abridged version of the development process specifies the steps necessary to create ontologies based on an agile, iterative process. The process begins with collecting epics from working groups, users, and domain experts to guide development.

The initial draft of this document focuses on the first phases of the development process.

Roles

Technical Oversight Board

image-20240425-162259.png

Epics

Working groups create or add Epics to the TOB and MAY add an Epic to the Working Group to organize user scenarios for each area of concern. The TOB checks cross-cutting concerns with each working group. The working group WG MUST link Epics to the TOB Epics.

Epics MUST have the following roles:

Creating an Epic

An Epic is a significant development initiative that may span multiple releases and working groups. It aligns with the industry's high-level need to provide some capability in the standard. It must also align with business objectives and provide value or solve problems requiring an ontological approach.

The Epic may also span multiple working groups in parallel or serially, depending on the nature of the work. Epics are created in Jira for IOF as the top-level issue in the timeline for tracking all related parts. An Epic has multiple User Scenarios. In addition, an Epic requires multiple constructs to satisfy the domain concerns.

The Epic must also have the following information:

Examples

Prioritizing Epics 

The TOB reviews the Epics in the backlog and decides, through deliberation, the priority of each Epic and the availability of resources to perform the work. When considering scheduling, the TOB must consider the Epic's dependencies and complexity.

Since Epics can span multiple working groups and releases, a preliminary decomposition may be necessary to evaluate whether Working Groups can develop a valuable subset of constructs to satisfy the epic's needs.

Activities of the Working Groups



image-20240424-193337.png

Creating a Usage Scenario

A usage scenario is a narrative providing a business need statement in the domain expert's language with additional context. All use scenarios in the issue repository are related as sub-issues of the Epic.

A domain expert must be part of the team to derive Usage Scenarios. The domain expert is assumed to have little knowledge of ontologies or ontological development. Domain experts can be invited as guests where what they provide is considered open IP usable by IOF. Any content that is copyright or protected must be disclosed by the domain expert to the IOF and will not be used unless licensed to the IOF.

Break them down from the domain expert scenarios to a level that we can address. Usage Scenarios can have sub-Scenarios that are more focused on specific areas of the ontology. The solutions must address the business needs for the domain experts.

For stakeholders to avoid purely academic activities, all usage scenarios must reference a business-related need statement. A business value statement indicates how addressing the use case will increase profit, reduce pain points, and improve efficiency, safety, or security.

A scenario is typically a paragraph or two describing a situation in which a user intends to use the ontology to answer some questions. It provides additional context to augment the ontology and achieve the stated goals. Every usage scenario may, however, encompass one or more traditional user stories and should enable the development of at least one, but typically several, competency questions.

Examples

Competency Questions

A competency question is associated with one usage scenarios with one or more sample answers and a description of how you expect to get that answer, including but not limited to the relevant resources. The details provided for any competency question should describe at least one way you expect to use the semantics and/or provenance to propose an answer to the questions. Include an initial description of why the semantics and/or provenance representation and reasoning provide an advantage over other obvious approaches to the problem. (optional–depending on the use case and need for supporting business case).

If competency question maps to more than one usage scenario, then the usage scenario has not been correctly factored and the usage scenarios should be separated.

A competency question is a statement that can be translated into SPARQL to validate that the
resulting ontology can satisfy the usage scenario. The competency question must have associated
data to validate it. The data should come from real data sources identified by the domain experts.
Simulated data may be used but is of lesser quality since it will be made to fit the requirements
of the ontology.

A competency question without data will be considered non-viable.

Ontologies: Principles, Methods, and Applications

Scoping Requirements

This provides scope for developing the user scenarios, focusing on what part of the Epic we are addressing in the current development cycle and any constraints on the development process that may need to be considered when selecting the terms and ontological constructs. The requirements will not replace user scenarios or competency questions.

The scope provides the context and the rational for what we will be addressing.

Examples

Process for drilling down to scoping requirements.

We need to clearly differentiate competency questions from requirements. We should not use requirements as a replacement for competency questions.

Capture decisions made by the working group to scope and slice the ontology.

Specification of developing constructs. Functional and non-functional requirements regarding the development of the ontology.

Terminology Development

Construct Excerption

Extraction of keywords and key phrases from the vocabularies, glossaries, policies, procedures, process, and business architecture artifacts, standards, best practices, and other documentation available to create a preliminary term list, with preliminary definitions and other annotations. Note that natural language processing tools can extract key terms from a corpus of documents. Terms are also solicited from domain experts.

It is of the utmost importance to record the source and context for every term to support provenance, traceability, and explanation generation. Traceability from the original source for a term, as well as for the source of the definition of that term, in the form of annotations, is essential to the ontology development process.

Note: If the source of the data is a working group activity, the source of the data must be stated as the working group.

Domain Expert Definitions

From the initial phase collecting usage scenarios and reviewing terminology from domain experts and subject matter experts using the domain language vocabulary.

In the second phase, the terms are further refined using rules from ISO 704 and related standards (e.g., ISO 1087) to present a curated set of vetted definitions.

Constructs in Jira

The WG groups the constructs into Jira issues based on relations and dependencies. The Jira issues are assigned to the ontology developers to begin creating OWL ontology and SPARQL queries.

Ontology Development

Issue and GitHub Workflow

Development Process

Concept Diagram