Skip to content

gist Development Team Meeting Notes 2021.09.23

Jump to bottom
Rebecca Younes edited this page Sep 23, 2021 · 1 revision

Agenda and Notes

Attending: Rebecca Younes, Boris Pelakh, Borislav Iordanov, Dalia Dahleh, Dan Carey, Doug Beeson, Dylan Abney, Jamie Gulden, Jess Singer, Marc Feickert, Michael Uschold, Peter Winstanley

  • Review action items from previous meeting

    • Peter Winstanley to prepare materials on documentation proposals and schedule a date to discuss at a future meeting. Proposed documentation to include:
      • Reference document based on class and property names and annotations
      • Primer - how to use, design patterns, diagrams
      • Related to this topic: we need to distinguish what goes into the style guide vs the primer. As of now the former mostly contains naming and annotation conventions, but my plan had been to expand it to include design issues as well.

  • Discussion topics

    • Release debrief (Mark Ouska-style): Overall impression, what went well, what could we do better - in terms of both the release itself and the documentation.

      • Jamie: Can we fully automate the release generation in a CI (continuous integration) pipeline?
      • Boris: A release could be triggered by a release tag. Worth experimenting on next version.
      • Boris: Hiccups with onto_tool
      • Rebecca: We didn't open the files to see what was in them
      • Jamie: Sanity check can be part of build or CI pipeline.
      • Borislav: Documentation basically OK, would change documentation of connection between ontologists and developers. Documentation is too verbose. Need to highlight the commands to be run. Don't bury commands in the paragraph.
      • Boris: If we add CD (continuous deployment) that eliminates the gap between ontologists and developers.
      • We already have CI running on gist. For CD, creating a tag will automatically trigger CD.

    • Migration scripts:

      • Jamie: Should use SHACL rather than SPARQL to warn about mismatches between the data and the new ontology.
      • Boris: SHACL is a concise way to express new constraints, such as now only a Person or Organization can have an address. Onto_tool supports SHACL, but there is no standard way to execute SHACL against an endpoint. If I have to use SPARQL for endpoint migration, then I'm going to use it on local files as well.
      • The proposal is that warnings would be done in SHACL, but the updates in SPARQL.
      • Boris: when we start considering migration for 11.0.0 we can consider the use of SHACL for validation warnings.

    • Planning for next release:

      • Major release with new time model? - release 11.0.0

        • Dan: Major release better in November than another one in October.

      • Geo?

        • Dan: Presentation is ready for next meeting. Boris also needs to present GeoSPARQL.
        • Rebecca: What about geoNames?
        • Dan: we could introduce a couple of equivalent class statements.
        • Boris: We should do that outside of gistCore, in an auxiliary ontology that can be imported or not.

      • Units of measure and magnitudes?

      • Other large topics to consider, in addition to incremental changes:

      • Plan:

        • Continue with incremental minor/patch releases and release when we think we have enough changes to warrant a release. Inverses and annotations are not major releases and can go into develop any time.
        • Release 11.0.0 with times and geo when ready

    • rdf-lib defines namespaces

    • Boris: rdf-lib uses defined namespaces for code completion. These include commonly used namespaces such as FOAF, SKOS, DCAT, etc. It is [calling for submission of new namespaces[(https://github.com/RDFLib/rdflib/issues/1415). Boris proposes submitting a PR to add gist. Will try to automate generation of the file.

  • Review issues

Pull Requests Reviewed

None.

Issues Reviewed

New Action Items

  • Rebecca to take a pass at updating the release documentation, then run it by Borislav for review.
  • Boris to submit PR to rdf-lib for adding gist namespace to the set of defined namespaces.

Next Meeting

Thursday, Oct 14, 2021 9:00am MT

Semantic Arts, Inc.

Clone this wiki locally