Improve SplitAt docs

Cargo.toml

@@ -15,7 +15,7 @@
 [package]
 edition = "2021"
 name = "zerocopy"
-version = "0.8.25-alpha.2"
+version = "0.8.25-alpha.3"
 authors = ["Joshua Liebow-Feeser <[email protected]>", "Jack Wrenn <[email protected]>"]
 description = "Zerocopy makes zero-cost memory manipulation effortless. We write \"unsafe\" so you don't have to."
 categories = ["embedded", "encoding", "no-std::no-alloc", "parsing", "rust-patterns"]
@@ -82,13 +82,13 @@ std = ["alloc"]
 __internal_use_only_features_that_work_on_stable = ["alloc", "derive", "simd", "std"]
 
 [dependencies]
-zerocopy-derive = { version = "=0.8.25-alpha.2", path = "zerocopy-derive", optional = true }
+zerocopy-derive = { version = "=0.8.25-alpha.3", path = "zerocopy-derive", optional = true }
 
 # The "associated proc macro pattern" ensures that the versions of zerocopy and
 # zerocopy-derive remain equal, even if the 'derive' feature isn't used.
 # See: https://github.com/matklad/macro-dep-test
 [target.'cfg(any())'.dependencies]
-zerocopy-derive = { version = "=0.8.25-alpha.2", path = "zerocopy-derive" }
+zerocopy-derive = { version = "=0.8.25-alpha.3", path = "zerocopy-derive" }
 
 [dev-dependencies]
 # More recent versions of `either` have an MSRV higher than ours.
@@ -106,4 +106,4 @@ testutil = { path = "testutil" }
 # CI test failures.
 trybuild = { version = "=1.0.89", features = ["diff"] }
 # In tests, unlike in production, zerocopy-derive is not optional
-zerocopy-derive = { version = "=0.8.25-alpha.2", path = "zerocopy-derive" }
+zerocopy-derive = { version = "=0.8.25-alpha.3", path = "zerocopy-derive" }

src/split_at.rs

@@ -12,6 +12,9 @@ use crate::pointer::invariant::{Aligned, Exclusive, Invariants, Shared, Valid};
 
 /// Types that can be split in two.
 ///
+/// This trait generalizes Rust's existing support for splitting slices to
+/// support slices and slice-based dynamically-sized types ("slice DSTs").
+///
 /// # Implementation
 ///
 /// **Do not implement this trait yourself!** Instead, use

zerocopy-derive/Cargo.toml

@@ -9,7 +9,7 @@
 [package]
 edition = "2021"
 name = "zerocopy-derive"
-version = "0.8.25-alpha.2"
+version = "0.8.25-alpha.3"
 authors = ["Joshua Liebow-Feeser <[email protected]>", "Jack Wrenn <[email protected]>"]
 description = "Custom derive for traits from the zerocopy crate"
 license = "BSD-2-Clause OR Apache-2.0 OR MIT"