update

Signed-off-by: Joe Isaacs <joe.isaacs@live.co.uk>

Author: joseph-isaacs

docs/specs/editions.md

@@ -4,12 +4,14 @@ Vortex defines an evergrowing set of serializable array encodings, once written
 version of vortex.
 **Editions** are used to keep track of these encodings and talk about groups of encodings.
 
-The edition `core2026.07.0` (coming soon) is the first such edition containing all encodings currently
-enabled by the writer.
+The first edition, `core2025.05.0`, contains the stable encodings that could be written by Vortex
+`0.36.0`. This is the release from which the Vortex file format is considered stable. Later `core`
+editions add stable encodings released after that compatibility boundary.
 Editions are additive so an edition that comes after a previous one contains all the encodings from the previous one
 and more.
-The writer can be configured with a set of different editions (e.g. `core2026.07.0` and `unstable2026.05.0` all stable
-encoding released before July 2026 and all unstable encodings from May 2026).
+The writer can be configured with a set of different editions (for example, `core2026.07.0` and
+`unstable2026.06.0` select stable encodings released through July 2026 and unstable encodings
+released through June 2026).
 
 Editions can be used to constrain your minimum required vortex reader, since latest version over vortex across all
 editions is the earliest version of vortex required to read that file.
@@ -57,4 +59,4 @@ indefinitely, so deprecation never invalidates existing files.
 
 ## Edition registry
 
-Coming soon..
+Coming soon..

vortex-array/src/arrays/decimal/vtable/mod.rs

@@ -164,7 +164,6 @@ impl VTable for Decimal {
         dtype: &DType,
         len: usize,
         metadata: &[u8],
-
         buffers: &[BufferHandle],
         children: &dyn ArrayChildren,
         _session: &VortexSession,

vortex/src/editions/core/mod.rs

@@ -6,8 +6,12 @@
 //! One module per edition, each declaring the edition and the encodings that join the
 //! family at it; members of earlier editions are inherited and never restated.
 
-pub mod v2026_01;
+pub mod v2025_05;
+pub mod v2025_06;
+pub mod v2025_10;
 pub mod v2026_07;
 
-pub use v2026_01::CORE_2026_01_0;
+pub use v2025_05::CORE_2025_05_0;
+pub use v2025_06::CORE_2025_06_0;
+pub use v2025_10::CORE_2025_10_0;
 pub use v2026_07::CORE_2026_07_0;

vortex/src/editions/core/v2025_05.rs

@@ -0,0 +1,44 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright the Vortex contributors
+
+//! The baseline `core` edition: stable encodings writable by Vortex 0.36.0.
+
+use vortex_edition::Edition;
+use vortex_edition::EditionDeclaration;
+use vortex_edition::EditionId;
+
+/// The first edition of the `core` family, matching the first stable Vortex file release.
+pub const CORE_2025_05_0: EditionId = EditionId::new("core", 2025, 5, 0);
+
+/// The declaration of [`CORE_2025_05_0`] and the encodings that join the family at it.
+pub static DECLARATION: EditionDeclaration = EditionDeclaration {
+    edition: Edition {
+        id: CORE_2025_05_0,
+        min_vortex_version: Some("0.36.0"),
+    },
+    added: &[
+        &"fastlanes.bitpacked",
+        &"fastlanes.for",
+        &"vortex.alp",
+        &"vortex.alprd",
+        &"vortex.bool",
+        &"vortex.bytebool",
+        &"vortex.chunked",
+        &"vortex.constant",
+        &"vortex.datetimeparts",
+        &"vortex.decimal",
+        &"vortex.decimal_byte_parts",
+        &"vortex.dict",
+        &"vortex.ext",
+        &"vortex.fsst",
+        &"vortex.list",
+        &"vortex.null",
+        &"vortex.primitive",
+        &"vortex.runend",
+        &"vortex.sparse",
+        &"vortex.struct",
+        &"vortex.varbin",
+        &"vortex.varbinview",
+        &"vortex.zigzag",
+    ],
+};

vortex/src/editions/core/v2025_06.rs

@@ -0,0 +1,20 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright the Vortex contributors
+
+//! The `core` edition adding stable encodings released through June 2025.
+
+use vortex_edition::Edition;
+use vortex_edition::EditionDeclaration;
+use vortex_edition::EditionId;
+
+/// The June 2025 edition of the `core` family.
+pub const CORE_2025_06_0: EditionId = EditionId::new("core", 2025, 6, 0);
+
+/// The declaration of [`CORE_2025_06_0`] and the encodings that join the family at it.
+pub static DECLARATION: EditionDeclaration = EditionDeclaration {
+    edition: Edition {
+        id: CORE_2025_06_0,
+        min_vortex_version: Some("0.40.0"),
+    },
+    added: &[&"vortex.pco", &"vortex.sequence", &"vortex.zstd"],
+};

vortex/src/editions/core/v2025_10.rs

@@ -0,0 +1,25 @@
+// SPDX-License-Identifier: Apache-2.0
+// SPDX-FileCopyrightText: Copyright the Vortex contributors
+
+//! The `core` edition adding stable encodings released through October 2025.
+
+use vortex_edition::Edition;
+use vortex_edition::EditionDeclaration;
+use vortex_edition::EditionId;
+
+/// The October 2025 edition of the `core` family.
+pub const CORE_2025_10_0: EditionId = EditionId::new("core", 2025, 10, 0);
+
+/// The declaration of [`CORE_2025_10_0`] and the encodings that join the family at it.
+pub static DECLARATION: EditionDeclaration = EditionDeclaration {
+    edition: Edition {
+        id: CORE_2025_10_0,
+        min_vortex_version: Some("0.54.0"),
+    },
+    added: &[
+        &"fastlanes.rle",
+        &"vortex.fixed_size_list",
+        &"vortex.listview",
+        &"vortex.masked",
+    ],
+};

vortex/src/editions/core/v2026_01.rs

@@ -1,58 +1,20 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: Copyright the Vortex contributors
 
-//! The second `core` edition: the container and compressed encodings.
+//! The `core` edition adding stable encodings released through July 2026.
 
 use vortex_edition::Edition;
 use vortex_edition::EditionDeclaration;
 use vortex_edition::EditionId;
 
-/// The second `core` edition: inherits everything in
-/// [`CORE_2026_01_0`](super::v2026_01::CORE_2026_01_0) and adds the container and
-/// compressed encodings the default file writer emits. A draft until the release shipping
-/// it is published and its version is recorded.
+/// The July 2026 edition of the `core` family.
 pub const CORE_2026_07_0: EditionId = EditionId::new("core", 2026, 7, 0);
 
 /// The declaration of [`CORE_2026_07_0`] and the encodings that join the family at it.
 pub static DECLARATION: EditionDeclaration = EditionDeclaration {
     edition: Edition {
         id: CORE_2026_07_0,
-        min_vortex_version: None,
+        min_vortex_version: Some("0.65.0"),
     },
-    added: &[
-        &"vortex.chunked",
-        &"vortex.constant",
-        &"vortex.dict",
-        &"vortex.masked",
-        &"vortex.sparse",
-        &"vortex.alp",
-        &"vortex.alprd",
-        &"vortex.bytebool",
-        &"vortex.datetimeparts",
-        &"vortex.decimal_byte_parts",
-        &"vortex.fsst",
-        &"vortex.pco",
-        &"vortex.runend",
-        &"vortex.sequence",
-        &"vortex.zigzag",
-        &"vortex.zstd",
-        &"fastlanes.bitpacked",
-        &"fastlanes.delta",
-        &"fastlanes.for",
-        &"fastlanes.rle",
-    ],
+    added: &[&"vortex.variant"],
 };
-
-#[cfg(test)]
-mod tests {
-    use vortex_edition::EditionError;
-    use vortex_edition::test_harness::validate_edition;
-
-    use super::CORE_2026_07_0;
-    use crate::editions::edition_session;
-
-    #[test]
-    fn edition_is_valid() -> Result<(), EditionError> {
-        validate_edition(&edition_session(), &CORE_2026_07_0)
-    }
-}