💄 Polish changelog for 1.2.0 (#218)

* 💄 Polish changelog for 1.2.0

* 💚 Fix

Author: falexwolf

docs/changelog/2025.md

@@ -16,18 +16,50 @@
 
 ## 2025-03-09 {small}`db 1.2.0`
 
-- ✨ Introduce `Artifact.from_spatialdata()` and re-factor validation of `spatialdata` stores [PR](https://github.com/laminlabs/lamindb/pull/2461) [@Zethson](https://github.com/Zethson)
-- ✨ Enable `ln.track(project="My project")` to auto-link entities to projects [PR](https://github.com/laminlabs/lamindb/pull/2529) [@falexwolf](https://github.com/falexwolf)
-- ✨ Add `.load()` for artifacts holding `SpatialData` objects [PR](https://github.com/laminlabs/lamindb/pull/2532) [@Zethson](https://github.com/Zethson)
-- 🎨 When re-creating an `Artifact`, link subsequent runs instead of updating `.run` and linking previous runs [PR](https://github.com/laminlabs/lamindb/pull/2515) [@falexwolf](https://github.com/falexwolf)
-- 🚸 Introduce `.slots` in `Schema`, `Curator`, and `FeatureManager` to access schemas and curators by dataset slot [PR](https://github.com/laminlabs/lamindb/pull/2530) [@sunnyosun](https://github.com/sunnyosun)
-- 🏗️ Re-structure internal API away from monkey-patching Django models [PR](https://github.com/laminlabs/lamindb/pull/2516) [@falexwolf](https://github.com/falexwolf)
-- 🐛 Fix passing a path manually when no path found by `nbproject` [PR](https://github.com/laminlabs/lamindb/pull/2537) [@Koncopd](https://github.com/Koncopd)
-- 🩹 Do not overwrite `._state_db` of models when the current instance is passed to `.using` [PR](https://github.com/laminlabs/lamindb/pull/2534) [@Koncopd](https://github.com/Koncopd)
-- 🔊 Do not show track warning for read-only connections [PR](https://github.com/laminlabs/lamindb/pull/2527) [@Koncopd](https://github.com/Koncopd)
-- 🚸 Raise `NotImplementedError` in `Artifact.load()` if there is no loader [PR](https://github.com/laminlabs/lamindb/pull/2514) [@Koncopd](https://github.com/Koncopd)
+✨ Enable to auto-link entities to projects. [Guide](/track.ipynb#track-projects) [PR](https://github.com/laminlabs/lamindb/pull/2529) [@falexwolf](https://github.com/falexwolf)
+
+```python
+ln.track(project="My project")
+```
+
+🚸 Better support for `spatialdata` with `Artifact.from_spatialdata()` and `artifact.load()`. [PR1](https://github.com/laminlabs/lamindb/pull/2461) [PR2](https://github.com/laminlabs/lamindb/pull/2532) [@Zethson](https://github.com/Zethson)
+
+🚸 Introduce `.slots` in `Schema`, `Curator`, and `artifact.features` to access schemas and curators by dataset slot. [PR](https://github.com/laminlabs/lamindb/pull/2530) [@sunnyosun](https://github.com/sunnyosun)
+
+```python
+schema.slots["obs"] -> Schema for .obs slot of AnnData
+curator.slots["obs"] -> Curator for .obs slot of AnnData
+artifact.features["obs"] -> Feature sets for .obs slot of AnnData
+```
+
+🏗️ Re-structured the internal API away from monkey-patching Django models. [PR](https://github.com/laminlabs/lamindb/pull/2516) [@falexwolf](https://github.com/falexwolf)
+
+```{dropdown} ⚠️ Use of internal API
+
+If you used the internal API, you might experience a breaking change. The most drastic change is that all internal registry-related functionality is now re-exported under `lamindb.models`.
+```
+
+🚸 When re-creating an `Artifact`, link subsequent runs instead of updating `.run` and linking previous runs. [PR](https://github.com/laminlabs/lamindb/pull/2515) [@falexwolf](https://github.com/falexwolf)
+
+```{dropdown} On the hub.
+
+More details [here](https://github.com/laminlabs/laminhub-public/pull/40). [@chaichontat](https://github.com/chaichontat)
+
+Before | After
+--- | ---
+An artifact is only shown as an output for the _latest run_ that created the artifact. _Previous_ runs don't show it. | All runs that (re-)create an artifact show it as an output.
+<img width="1004" alt="image" src="https://github.com/user-attachments/assets/447754ff-81db-4c29-9e41-bb1c7ac82dc9" /> | <img width="978" alt="image" src="https://github.com/user-attachments/assets/8c2a8e64-0e0b-401d-95de-0c45ddb1aefd" />
+
+```
+
+More changes:
+
 - ✨ Support R2 [PR](https://github.com/laminlabs/lamindb-setup/pull/979) [@Koncopd](https://github.com/Koncopd)
 - ✨ Allow to use `Artifact.open()` and `Artifact.load()` for `.gz` files [PR](https://github.com/laminlabs/lamindb/pull/2506) [@Koncopd](https://github.com/Koncopd)
+- 🐛 Fix passing a path to `ln.track()` when no path found by `nbproject` [PR](https://github.com/laminlabs/lamindb/pull/2537) [@Koncopd](https://github.com/Koncopd)
+- 🐛 Do not overwrite `._state_db` of records when the current instance is passed to `.using` [PR](https://github.com/laminlabs/lamindb/pull/2534) [@Koncopd](https://github.com/Koncopd)
+- 🚸 Do not show track warning for read-only connections [PR](https://github.com/laminlabs/lamindb/pull/2527) [@Koncopd](https://github.com/Koncopd)
+- 🚸 Raise `NotImplementedError` in `Artifact.load()` if there is no loader [PR](https://github.com/laminlabs/lamindb/pull/2514) [@Koncopd](https://github.com/Koncopd)
 
 ## 2025-02-27 {small}`db 1.1.1`
 

docs/includes/features-lamindb.md

@@ -12,7 +12,7 @@ The following detailed specs are for the Python package `lamindb`. For the analo
 - Manage features & labels: {class}`~lamindb.Feature`, {class}`~lamindb.Schema`, {class}`~lamindb.ULabel`
 - Use array formats in memory & storage: [DataFrame](/tutorial), [AnnData](/arrays), [MuData](multimodal), [tiledbsoma](cellxgene), ... backed by [parquet](/tutorial), [zarr](/arrays), [tiledb](cellxgene), [HDF5](/arrays), [h5ad](/arrays), [DuckDB](rxrx), ...
 - Create iterable & queryable collections of artifacts with data loaders: {class}`~lamindb.Collection`
-- Version artifacts, collections & transforms: {class}`~lamindb.core.IsVersioned`
+- Version artifacts, collections & transforms: {class}`~lamindb.models.IsVersioned`
 
 **Track data lineage across notebooks, scripts, pipelines & UI.**
 

docs/tutorial.ipynb

@@ -608,7 +608,7 @@
     "\n",
     "You can look up, filter & search any registry ({class}`~lamindb.models.Record`).\n",
     "\n",
-    "You can chain {meth}`~lamindb.models.Record.filter` statements and {meth}`~lamindb.core.QuerySet.search`: `ln.Artifact.filter(suffix=\".jpg\").search(\"my image\")`\n",
+    "You can chain {meth}`~lamindb.models.Record.filter` statements and {meth}`~lamindb.models.QuerySet.search`: `ln.Artifact.filter(suffix=\".jpg\").search(\"my image\")`\n",
     "\n",
     "An empty filter returns the entire registry: `ln.Artifact.filter()`\n",
     "```"