You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs(migration): state the target versions — migrate 0.x straight to latest 2.x
The migration guide framed the target only as '2.0'. Clarify that a legacy (0.x)
pipeline migrates directly to the latest 2.x release (currently 2.3) in a single
upgrade — no stepping through 2.0 -> 2.1 -> 2.2 -> 2.3. '2.0' in the guide is the
migration surface (type system, codecs, unified stores); 2.1-2.3 build on it with
no extra migration steps. Retitle to 'Migrate to DataJoint 2.x' (H1 + nav).
Copy file name to clipboardExpand all lines: src/how-to/migrate-to-v20.md
+19-2Lines changed: 19 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,27 @@
1
-
# Migrate to DataJoint 2.0
1
+
# Migrate to DataJoint 2.x
2
2
3
-
Upgrade existing pipelines from legacy DataJoint (pre-2.0) to DataJoint 2.0+.
3
+
Upgrade existing pipelines from legacy DataJoint (the pre-2.0 `0.x` series)
4
+
directly to the latest DataJoint 2.x — currently **2.3**.
4
5
5
6
> **This guide is optimized for AI coding assistants.** Point your AI agent at this
6
7
> document and it will execute the migration with your oversight.
7
8
9
+
!!! tip "Which version do I migrate to?"
10
+
11
+
Migrate **straight to the latest 2.x release** (currently 2.3) — there is no
12
+
need to step through 2.0 → 2.1 → 2.2 → 2.3. A single upgrade takes a `0.x`
13
+
pipeline all the way to 2.3.
14
+
15
+
Everything this guide calls "2.0" is the **migration surface** — the type
16
+
system, explicit codecs, and unified `stores` introduced in 2.0. Later
17
+
releases build on it without adding migration steps: **2.1** added the
18
+
PostgreSQL backend and configurable diagram layout, **2.2** added the jobs
19
+
layer and diagram operations, and **2.3** added the upstream/provenance API.
20
+
Installing the latest release gives you all of them.
21
+
22
+
Complete the migration while on **2.3 or earlier**: the `datajoint.migrate`
23
+
helper is scheduled for removal in 2.4/2.5.
24
+
8
25
!!! warning "Temporary module"
9
26
10
27
The `datajoint.migrate` module is provided temporarily to assist with migration and is scheduled for removal in DataJoint 2.4 or 2.5. We recommend completing your migration while on DataJoint 2.3 or earlier.
0 commit comments