docs: add safety comments for two unsafe functions. added #allow(missing_docs) for two functions (next_in_dim & next_out_dim) in slice.rs

Author: stoutes

src/slice.rs

@@ -676,13 +676,13 @@ pub trait SliceNextDim
     type InDim: Dimension;
     /// Number of dimensions that this slicing argument produces in the output array.
     type OutDim: Dimension;
-
+    #[allow(missing_docs)]
     fn next_in_dim<D>(&self, _: PhantomData<D>) -> PhantomData<<D as DimAdd<Self::InDim>>::Output>
     where D: Dimension + DimAdd<Self::InDim>
     {
         PhantomData
     }
-
+    #[allow(missing_docs)]
     fn next_out_dim<D>(&self, _: PhantomData<D>) -> PhantomData<<D as DimAdd<Self::OutDim>>::Output>
     where D: Dimension + DimAdd<Self::OutDim>
     {

src/zip/ndproducer.rs

@@ -81,9 +81,20 @@ pub trait NdProducer
     }
     /// Returns a pointer to the first element of the data.
     fn as_ptr(&self) -> Self::Ptr;
-    /// Dereferences the pointer to get a reference to the element.
+    /// Dereferences the pointer to get a mutable reference to the element.
+    ///
+    /// # Safety
+    ///
+    /// `ptr` must be a valid pointer obtained from this producer and must point
+    /// to an initialized element within the data's bounds. Additionally, there
+    /// must be no other references (mutable or immutable) to this element.
     unsafe fn as_ref(&self, ptr: Self::Ptr) -> Self::Item;
-    /// Returns a pointer to the element at the given index without bounds checking.
+    /// Dereferences the pointer to get a mutable reference to the element.
+    ///
+    /// # Safety
+    ///
+    /// `ptr` must be a valid, aligned pointer obtained from this producer, pointing
+    /// to an initialized element within the data's bounds with exclusive access.
     unsafe fn uget_ptr(&self, i: &Self::Dim) -> Self::Ptr;
     /// Returns the stride (offset between elements) along the specified axis.
     fn stride_of(&self, axis: Axis) -> <Self::Ptr as Offset>::Stride;