Skip to content

Commit 9c36e16

Browse files
authored
Update DevelopmentGuidelines.md
1 parent 84b0345 commit 9c36e16

1 file changed

Lines changed: 6 additions & 15 deletions

File tree

docs/DevelopmentGuidelines.md

Lines changed: 6 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,9 @@ technical:
3030
- Use standard synonym types [#2450](https://github.com/OBOFoundry/OBOFoundry.github.io/issues/2450)
3131
- Modeling metaclasses [#2454](https://github.com/OBOFoundry/OBOFoundry.github.io/issues/2454)
3232
- Ontology merging metadata [#1548](https://github.com/OBOFoundry/OBOFoundry.github.io/issues/1548)
33-
- Ontology metadata requirements [#1365](https://github.com/OBOFoundry/OBOFoundry.github.io/issues/1365)
33+
- ***MORE DISCUSSION NEEDED*** Ontology metadata requirements [#1365](https://github.com/OBOFoundry/OBOFoundry.github.io/issues/1365)
34+
- DECISION: leave Optional field off from the table. Discussion to be continued about the use of dcterms:date. Will make 2 tables: 1 with MUST and SHOULD, the other with other potential fields (including those NOT to use) with guidelines indicated (would include the list items given in the file, below the table). We should also push for recommended format for optional fields (ex. ORCID for creator/contributor).
35+
3436
- ***MORE DISCUSSION NEEDED*** Language tags [#479](https://github.com/OBOFoundry/OBOFoundry.github.io/issues/479)
3537
- For rdfs:label and IAO:0000115 annotation assertions, we discourage the use of datatype declarations such as `xsd:string`. It is important to note that `xsd:string` is essentially redundant in OWL/RDF, so "assay" and "assay"^^xsd:string should be the exact same thing. However, a lot of tooling may be confused by the difference, xsd:string datatype assertion SHOULD be omitted in general for all annotations, but MUST be omitted for rdfs:label and IAO:0000115.
3638
- To designate rdfs:label, and IAO:0000115 annotations in a language different from English, a [valid RDF language tag](https://www.w3.org/TR/rdf11-concepts/#section-Graph-Literal) MUST be specified, for example, "Krankheit"@de.
@@ -44,7 +46,7 @@ content:
4446

4547
communication:
4648

47-
- Ontology subsets documentation [#466](https://github.com/OBOFoundry/OBOFoundry.github.io/issues/466)
49+
- Ontology subsets documentation [#466](https://github.com/OBOFoundry/OBOFoundry.github.io/issues/466)
4850
- domain metadata tag [#2779](https://github.com/OBOFoundry/OBOFoundry.github.io/issues/2779)
4951

5052

@@ -53,20 +55,9 @@ Q: The newly-accepted guideline recommends against importing terms from a third
5355
Q: What about when importing from the original source ontology? Principle 1 for term import says to “include any annotations for term or definition editors from the original ontology”. Should that be revisited?
5456
James: There’s nothing special about definitions – any annotation or axiom could get out of sync, and any could be important to someone. Recommend against stripping this recommendation.
5557
CONCLUSION: keep all information.
56-
imports: recommend that imported terms be tagged with the ontology from which they were *directly* imported? (no issue)
57-
Terms can be imported from the ‘source’ ontology or a third party ontology; this recommendation would provide useful tracking information should things go wrong.
58-
P1 says ‘imported from’ (IAO:0000412) should be used “to link back to the group (i.e. ontology) maintaining it”
59-
Which method (annotating the direct import source vs annotating the maintaining ontology) would provide the most benefit to end users? To term re-users?
60-
Q: Should we only recommend this tag when from a third party, or always?
61-
If using OntoFox, it will indicate the direct import. ROBOT does it *only when asked*
62-
James O: would not recommend using ‘imported from’ in guideline.
63-
CONCLUSION: leave out of guidelines
58+
6459
ACTION (DN): make issue regarding P1 inclusion of ‘imported from’
65-
imports: standardize how imported ontologies are noted (#424)
66-
For individual terms there is ‘imported from’ (IAO:0000412), recommended as part of P1. (Note: the above discussion might change what is said there.)
67-
Q: regardless of how it could be indicated (for example, using a yet-to-be-minted metadata tag such as ‘imports’ or ‘has import’--not to be confused with the directive ‘owl:imports’), do we want to make a recommendation to this effect? The context is within an already-merged ontology (which would not have any import statements).
68-
James O: this consideration is very semweb-focused but might not be very useful
69-
CONCLUSION: Don’t bother with this.
60+
7061

7162

7263

0 commit comments

Comments
 (0)