docs(linalg): document SIMD conversion panics

rust/lance-linalg/src/distance/hamming.rs

@@ -512,7 +512,7 @@ unsafe fn hamming_batch_avx512(query: u64, targets: &[u64], results: &mut [u32])
     }
 }
 
-/// AVX2 popcount using lookup table (Harley-Seal / PSHUFB method).
+/// AVX2 popcount using a PSHUFB nibble lookup table.
 ///
 /// The chunk loop reaches only the first `targets.len() / 4 * 4` slots through a
 /// raw pointer, 4 x u32 per chunk with no bounds check; the trailing slots go

rust/lance-linalg/src/simd/f32.rs

@@ -147,6 +147,11 @@ fn gather_scalar_x86(slice: &[f32], indices: &[i32; 8]) -> f32x8 {
 }
 
 impl From<&[f32]> for f32x8 {
+    /// Loads the first 8 values from `value`.
+    ///
+    /// # Panics
+    ///
+    /// Panics if `value` contains fewer than 8 values.
     fn from(value: &[f32]) -> Self {
         assert!(
             value.len() >= 8,
@@ -532,6 +537,11 @@ impl std::fmt::Debug for f32x16 {
 }
 
 impl From<&[f32]> for f32x16 {
+    /// Loads the first 16 values from `value`.
+    ///
+    /// # Panics
+    ///
+    /// Panics if `value` contains fewer than 16 values.
     fn from(value: &[f32]) -> Self {
         assert!(
             value.len() >= 16,

rust/lance-linalg/src/simd/f64.rs

@@ -44,6 +44,11 @@ impl std::fmt::Debug for f64x4 {
 }
 
 impl From<&[f64]> for f64x4 {
+    /// Loads the first 4 values from `value`.
+    ///
+    /// # Panics
+    ///
+    /// Panics if `value` contains fewer than 4 values.
     fn from(value: &[f64]) -> Self {
         assert!(
             value.len() >= 4,
@@ -393,6 +398,11 @@ impl std::fmt::Debug for f64x8 {
 }
 
 impl From<&[f64]> for f64x8 {
+    /// Loads the first 8 values from `value`.
+    ///
+    /// # Panics
+    ///
+    /// Panics if `value` contains fewer than 8 values.
     fn from(value: &[f64]) -> Self {
         assert!(
             value.len() >= 8,

rust/lance-linalg/src/simd/i32.rs

@@ -49,6 +49,11 @@ impl std::fmt::Debug for i32x8 {
 }
 
 impl From<&[i32]> for i32x8 {
+    /// Loads the first 8 values from `value`.
+    ///
+    /// # Panics
+    ///
+    /// Panics if `value` contains fewer than 8 values.
     fn from(value: &[i32]) -> Self {
         assert!(
             value.len() >= 8,

rust/lance-linalg/src/simd/u8.rs

@@ -84,6 +84,11 @@ impl std::fmt::Debug for u8x16 {
 }
 
 impl From<&[u8]> for u8x16 {
+    /// Loads the first 16 values from `value`.
+    ///
+    /// # Panics
+    ///
+    /// Panics if `value` contains fewer than 16 values.
     fn from(value: &[u8]) -> Self {
         assert!(
             value.len() >= 16,