sem-prov-ontologies icon indicating copy to clipboard operation
sem-prov-ontologies copied to clipboard

Release ECSO 0.10

Open stevenchong opened this issue 5 years ago • 11 comments

We can use this issue to keep track of the steps needed to proceed towards the upcoming ECSO release. I'm assuming we shouldn't do any major edits until after the first release, so I'll keep track of any needed future changes as Github issues.

  • [ ] Codify ECSO naming patterns in README
  • [ ] Triage existing issues. Close, complete, or move any open issues to a future milestone
  • [ ] Clean up git branches and duplicated ECSO OWL files. This can be done at release time. master should hold the stable release.
  • [ ] Issue a tag and GH release for the new release
  • [ ] Release to BioPortal
  • [ ] File relevant issues on affected software projects (DataONE indexing stack, Metacat) to update registered copies of ECSO
  • [ ] Verify the Ontology IRI and filename is ECSO.owl and not ECSO8.owl or whatever

stevenchong avatar Oct 04 '19 04:10 stevenchong

Hey @stevenchong, what kind of release are we thinking of targeting? ECSO release management has been pretty ad-hoc so far, it appears. Informally, ECSO is currently at 0.9, though that's not exactly codified anywhere. If this release is iterative, we could do a 0.10.

Or do you know if the goal is to get to a 1.0 (first) release state with this effort?

amoeba avatar Oct 10 '19 01:10 amoeba

Added a few items as a checklist to the OP.

amoeba avatar Oct 10 '19 01:10 amoeba

What version of ECSO are we using for the already production semantics release? I assume that was well-versioned? It seems to be 0.9 (http://bioportal.bioontology.org/ontologies/ECSO/?p=summary) but it also looks like there are different versions on bioportal all with the 0.9 label version number. Whatever we decide to do, I'd like to be sure that each release version has one and only one definitive owl file associated with it.

mbjones avatar Oct 10 '19 01:10 mbjones

Yeah, it's "0.9". BioPortal handles releases a little wonky so there are unintended duplicates there. 0.9 wasn't released in the proper way since we couldn't get things merged to master in time (and we're still working on that).

I'd like to be sure that each release version has one and only one definitive owl file associated with it.

Me too. This will fall out of the above process.

amoeba avatar Oct 10 '19 01:10 amoeba

what kind of release are we thinking of targeting?

Good question. I know there are some term reorganization and label issues that we would like to resolve. A 1.0 release will require a thorough review of ECSO by @mpsaloha , which probably won't happen for a while. I think minor improvement updates are okay until that happens. Eventually we will want to add more relationships (axioms) to terms, which seems like a significant update to me.

stevenchong avatar Oct 10 '19 07:10 stevenchong

Sounds like a 0.10 is in order. Thanks @stevenchong. What do you think about making our next semantics call a time to talk over checklist item 2 (triage)?

amoeba avatar Oct 10 '19 19:10 amoeba

Sounds good to me

stevenchong avatar Oct 10 '19 20:10 stevenchong

@amoeba Let's be sure to capture the current 0.9 release of ECSO in the repo and tag it. I will create a branch for this new ecso 0.10 feature work.

mbjones avatar Jul 09 '21 06:07 mbjones

To follow the new contributing guidelines in #89, I created a new branch feature_41_ecso_0.10 to contain the work on the ECSO 0.10 release under this ticket. This new branch was cloned from the branch ECSO8-add_non-carbon_measurements to get what I think is the current checked in version of ECSO8.owl, and then changes were merged into it from develop to catch it up with housekeeping changes. Finally, I renamed the observation directory to ecso to make it clear which ontology is contained within. All work to resolve issues for the ECSO 0.10 should happen on this new feature_41_ecso_0.10 branch. We should also git rm any old copies of the ECSO file that are around in this branch (e.g., ECSO4.owl, ECSO8.owl) in favor of a standard ECSO.owl filename that would reflect the merged consensus for the release. Having multiple copies under various names is confusing -- I hope we can use git to handle the versioning, not filesystem copies.

@amoeba please review if I got the correct versions from the historical branches to start from. Thanks.

mbjones avatar Jul 09 '21 07:07 mbjones

Hey @mbjones, thanks for going through the branches. That all matches my memory so I think we're good. The next release of ECSO was waiting on @mpsaloha for a set of eyes so we might touch base with him to see if he has any changes or if we can cut a release here. I'll put it on the agenda for this week's salmantics call.

amoeba avatar Jul 13 '21 20:07 amoeba

As a note, we did have a conversation about the numerous branches and that thread is at https://github.com/DataONEorg/sem-prov-ontologies/issues/85. Looks like the conclusion is that we're on the right track and ECSO8-add_non-carbon_measurements is the latest.

amoeba avatar Jul 14 '21 00:07 amoeba