Feburary 2022 Release (1.3.0)
v1.3.0 (24 February 2022)
As always, update your local ODK with docker pull obolibrary/odkfull
.
Breaking change for users of DOSDP in CI (GitHub Actions)
A new tool was introduced for users of DOSDP for better validation. See this comment about updating your CI pipeline.
New features:
- New DOSDP workflow for matching patterns: This is a powerful workflow that "matches" your DOSDP YAML templates against your ontology to actually create TSVs - so the other way around of what we usually do.
- To set this up, you introduce a new "pattern_pipelines_group" called
matches
, which can then be invoked withsh run.sh make dosdp-matches-%
to match all configured DOSDP tempates with the ontology. - Example see here.
- To set this up, you introduce a new "pattern_pipelines_group" called
- Experimental feature-diff feature: When creating a pull request, the ODK can now automatically make a comment to the pull request informing editors of changes to the ontology (issue)
- Adding Relation Graph to ODK (pull request, pull request)
- New QC checks:
- IRIs in labels: Often when using autogenerated labels in DOSDP we do not realise we are accidentally missing labels to for generating class names. We introduced a QC check to protect against that (pull request, issue)
- Ensuring that the range of never_in_taxon:, present_in_taxon: , oboInOwl:inSubset, rdfs:seeAlso, foaf:depicted_by and dcterms:contributor is always IRI (issue, pull request)
- Switched the default Ontology documentation theme from
readthedocs
tomaterial
(pull request) - New DOSDP tools version 0.19.1
Bugfixes:
- Many faulty dependencies in the Makefile that triggered unnecessary re-runs of make were removed (issue)
- Some major refactoring of the main
Makefile
(pull request). This includes, in particular, a smarter way to deal with web-dependencies (mirrors, dosdp-templates, components). - Fixes to documentation (Managing dependencies with base files, Import seed system)
- Some fixes to DOSDP pipeline setup (issue)
- Git
main
branch was hardcoded tomaster
during the seeding process, now uses the ODK config file (pull request, issue) - Making sure the repo seeding process preserves file privileges. This ensures, in particular, that
run.sh
is executable and can be run using./run.sh
instead ofsh run.sh
(issue, pull) - DOSDP Validation now uses python up to date library
- Auto-deployment of ODK docs fixed (ODK internal, pull request), but much of ODK's docs has moved to OBOOK (OBO Academy)
- Fixing some issues with default values when using
robot_report
in your ODK config (pull request)
New commands:
sh run.sh make help
: show frequently used ODK commands and their usage (issue)sh run.sh make TSV=my.tsv validate-tsv
: Experimental TSV validation feature with TSValid (issue)sh run.sh make validate-all-tsv
: Validate all TSV tables configured in repo with TSValid (issue)sh run.sh make dosdp-matches-%
: Run the "matches" pipeline, see above. (issue)sh run.sh make clean
: Clean up some temporary files created by the build. (issue)
Recommendations for ontology maintainers:
- We have overhauled the SPARQL query management to make it more customisable (pull request). We recommend, before updating to the latest ODK, to delete old and potentially stale SPARQL queries like this:
rm ../sparql/owldef-violation.sparql ../sparql/nolabels-violation.sparql ../sparql/def-lacks-xref-violation.sparql ../sparql/obsolete-violation.sparql ../sparql/redundant-subClassOf-violation.sparql
. - You should periodically review the contents of your
src/ontology/custom.Makefile
- if you overwrite a lot of goals, you should review wether the overwrite is still necessary. This ODK release has a lot of revisions to the Makefile, so this should be a good opportunity to check this!