Skip to content

Commit ce3079c

Browse files
authored
Update DevelopmentGuidelines.md
Fill in information for Term Migration
1 parent cc3632b commit ce3079c

1 file changed

Lines changed: 14 additions & 5 deletions

File tree

‎docs/DevelopmentGuidelines.md‎

Lines changed: 14 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,22 +8,31 @@ title: Ontology Project Management Guidelines
88
- Term migration
99
- <b>Definition</b>: The transfer of responsibility of term maintenance from one ontology to another.
1010
- <b>Purpose</b>: If a term created by ontology A would have a more suitable home in ontology B, that term can be transferred to the other ontology.
11-
- <b>Mechanism</b>: There are two mechanisms for doing this: (1) <i>Term adoption</i>, whereby the term from ontology A is managed by ontology B while retaining its original identifier; and (2) <i>Term deprecation/recreation</i>, whereby the term is obsoleted in ontology A and recreated in ontology B using the latter's namespace. An overview of the advantages and disadvantages for each of these mechanisms is given in the table below:
11+
- <b>Mechanism</b>: There are two mechanisms for doing this: (1) <i>Term adoption</i>, whereby the term from ontology A is maintained and managed by ontology B while retaining its original identifier; and (2) <i>Term deprecation/recreation</i>, whereby the term is obsoleted in ontology A and recreated in ontology B using the latter's namespace. An overview of the advantages and disadvantages for each of these mechanisms is given in the table below:
1212

1313
| Mechanism | Advantages | Disadvantages |
1414
| --------- | -------- | -------- |
15-
| Term Adoption | <ul><li>is good <li>is also good </ul>| <ul><li>is bad </ul>|
16-
| Term Deprecation/Recreation | <ul><li>is good </ul>| <ul><li>is bad</ul> |
15+
| Term Adoption | <ul><li>Preserves the original identifier/IRI.</ul>| <ul><li>Term IRI will still resolve to original destination. If originating ontology 'A' fails to import the term from managing ontology 'B', the IRI will fail.</ul>|
16+
| Term Deprecation/Recreation | <ul><li>Term IRI will resolve to the managing ontology 'B'. The original IRI from ontology A will still resolve, and that version will indicate the replacement.</ul>| <ul><li>Term identifier/IRI will change, with potential downstream effects.</ul> |
1717

1818
- <b>Implementation</b>: _Term adoption_ involves removing a term from the base (that is, before imports) ontology files (OWL or OBO) for ontology A <b>without deprecating</b> and adding it to the ontology files for ontology B <b>with no changes</b>, except that adopted terms MUST be tagged with rdfs:isDefinedBy as follows:
1919
```
20+
OWL format (RDF/XML):
21+
<rdfs:isDefinedBy rdf:resource="http://purl.obolibrary.org/obo/omrse.owl"/>
22+
2023
OWL format (Turtle serialization):
2124
<http://purl.obolibrary.org/obo/A_123> rdfs:isDefinedBy <http://purl.obolibrary.org/obo/b.owl>
25+
26+
OWL format (OWL Functional Notation):
27+
AnnotationAssertion(rdfs:isDefinedBy obo:OOSTT_00000153 obo:omrse.owl)
28+
2229
OBO format:
23-
property_value: isDefinedBy http://purl.obolibrary.org/obo/b.owl
30+
property_value: isDefinedBy http://purl.obolibrary.org/obo/b.owl
2431
```
2532
_Term Deprecation/Recreation_ involves obsoleting a term in ontology A and remaking the term in ontology B. The term will therefore exist in both ontologies, active in ontology B but deprecated in ontology A. To use this mechanism, the term in ontology A MUST be marked as both obsolete and replaced according to the guidelines given in [Principle 19](https://obofoundry.org/principles/fp-019-term-stability.html) (Stability of Term Meaning).
26-
- <b>Examples</b>
33+
- <b>Examples</b>
34+
- <i>Term adoption</i>: http://purl.obolibrary.org/obo/OOSTT_00000153 (emergency physician role) is managed by OMRSE.
35+
- _Term deprecation/recreation_: http://purl.obolibrary.org/obo/COB_0000022 (organism) was formerly http://purl.obolibrary.org/obo/OBI_0100026.
2736
- <b>Implications</b> (licensing and other considerations)
2837
- Note: Regardless of the license used by the originating ontology, adopted terms will be subject to the stipulations of the license used by the adopting ontology.
2938

0 commit comments

Comments
 (0)