information-artifact-ontology / IAO

information artifact ontology
Creative Commons Attribution 4.0 International
70 stars 25 forks source link

Two terms with same alternative term #227

Open zhengj2007 opened 4 years ago

zhengj2007 commented 4 years ago

IAO:0000609 author summary section IAO:0000615 conclusion section Both terms with same alternative term: summary

alanruttenberg commented 4 years ago

Also IAO:0000610 author summary textual entity

I think 9 an 10 look the same. Different from 15. Author summary: A part of a document, distinct from the abstract, that describes the significance and broader context of the document content. The author summary is often written in a non-technical manner and is aimed at both scientists and non-scientist readers.

15 is A part of a document used to summarize the findings discussed in the document. The conclusion section is typically found near the end of a document.

bill-baumgartner commented 4 years ago

For what it's worth, the document section classes were empirically derived from looking at section headings in the PubMed Central Open Access collection. Both author summary section and conclusion section have the alternative term summary because there were instances of these sections in the document collection that use a section heading with the text "Summary".

I agree that there is redundancy in the document part and textual entity hierarchies. When I initially submitted a PR to add the document section classes there was an existing section class (I don't remember which one offhand) in the IAO that suggested sections should be modeled as both document part and textual entity. Happy to revisit this if that would be helpful.

alanruttenberg commented 4 years ago

The author summary vs. conclusion are very clear. The duplication is undesirable - perhaps someone can comment on what the distinction is. It's not a problem that the alternative terms coincide.

zhengj2007 commented 4 years ago

Also IAO:0000610 author summary textual entity

I think 9 an 10 look the same. Different from 15. Author summary: A part of a document, distinct from the abstract, that describes the significance and broader context of the document content. The author summary is often written in a non-technical manner and is aimed at both scientists and non-scientist readers.

Based on the logical definition, 9 and 10 are different. 9 has part some 10. I think 'document part' is different from 'textual entity' that contains more information than 'textual entity'.

zhengj2007 commented 4 years ago

The issue is a warning reported by ROBOT. See: http://obo-dashboard-test.ontodev.com/iao/robot_report.html, row 35 and 36.

If we think it is fine to have duplicated synonym in IAO, I will close the issue.