Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 7 additions & 5 deletions docs/howtos/collaborative-development.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,18 +49,20 @@ but an insertion can renumber existing nodes and obscure the actual schema edit.

The optional `--diff-stable` flag uses
[diffable-rdf](https://github.com/ASCS-eV/diffable-rdf) to reduce this label churn.
In a uv project containing your schema, install LinkML with the extra and generate
SHACL as follows (using a release that includes this option):
The library is installed with LinkML. In a uv project containing your schema,
install LinkML and generate SHACL as follows (using a release that includes this option):

```bash
uv add 'linkml[diff-stable]'
uv add linkml
uv run gen-shacl --diff-stable schema.yaml > schema.shacl.ttl
```

The flag also works with `gen-owl`, `gen-rdf`, and `gen-shex --format rdf`.
Python callers of `canonicalize_rdf_graph(..., diff_stable=True)` can install
`linkml-runtime[diff-stable]`. The feature is disabled by default; enabling it
changes existing labels once, so keep that regeneration separate from schema edits.
`linkml-runtime`. The `linkml[diff-stable]` and `linkml-runtime[diff-stable]` extras
remain available for compatibility with earlier installation instructions.
The feature is disabled by default; enabling it changes existing labels once,
so keep that regeneration separate from schema edits.

Labels depend on blank-node neighborhoods. Edits within connected structures or
among symmetric nodes can still affect other labels; minimum diffs are not
Expand Down
1 change: 1 addition & 0 deletions packages/linkml_runtime/pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,7 @@ dependencies = [
"prefixmaps >=0.1.4",
"curies>=0.14.6",
"pyoxigraph>=0.5.11",
"diffable-rdf>=0.4.0",
"pydantic>=2.14.1,<3.0.0",
"isodate >=0.7.2, <1.0.0; python_version < '3.11'",
]
Expand Down
Loading
Loading