Skip to content

Add multiversion support - #26

Merged
dalito merged 4 commits into
nfdi-de:mainfrom
dalito:issue8-isue13-docu-structure
Nov 21, 2025
Merged

Add multiversion support#26
dalito merged 4 commits into
nfdi-de:mainfrom
dalito:issue8-isue13-docu-structure

Conversation

@dalito

@dalito dalito commented Nov 21, 2025

Copy link
Copy Markdown
Collaborator

This pull request introduces several improvements to documentation deployment, schema versioning, and developer experience. The most significant changes include enhanced multi-version documentation support and dynamic schema versioning.

Documentation deployment and multi-version support:

  • Updated .github/workflows/deploy-docs.yaml to deploy documentation on pushes to main, and (new) on version; added versioned deployments using mike.
  • Added mike plugin and configuration to mkdocs.yml for multi-version documentation, including version selector and canonical version support.
  • Improved theme customization in mkdocs.yml and added light/dark mode logo support with corresponding HTML and CSS overrides.

Schema versioning and documentation:

  • Introduced dynamic versioning for the schema using uv-dynamic-versioning and hatch build hooks in pyproject.toml; schema files are now auto-versioned and referenced in documentation.
  • Added a new docs/versioning.md page explaining the SchemaVer scheme and how schema versions are managed and tagged.
  • Updated navigation and references to point to the new elements/overview.md for schema documentation.

Developer experience and testing:

  • Added coverage to development dependencies in pyproject.toml, and configured coverage reporting and source paths.
  • Added a coverage recipe to project.justfile for running tests and generating coverage reports.

Other improvements:

  • Added a README to docs/schema/ explaining the merged model and versioning of schema files.

Closes #20
Closes #13
Closes #9

- adds coverage testing config to pyproject.toml
- adds dynamic versioning to schema
- updates mkdocs config
@dalito

dalito commented Nov 21, 2025

Copy link
Copy Markdown
Collaborator Author

I am going to merge this later today (~8 pm CET).

I will add copying of the dcat_ap_linkml.yaml file to gh-pages in a follow-up PR. This is already big enough.

@dalito
dalito merged commit 65c4657 into nfdi-de:main Nov 21, 2025
7 checks passed
@dalito
dalito deleted the issue8-isue13-docu-structure branch November 21, 2025 19:37
@dalito dalito added this to the Release 0.1.0 milestone Nov 24, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant