Update src/raw/array.rs

Co-authored-by: Isabel Atkinson <[email protected]>

Author: abr-egn

src/raw/array.rs

@@ -222,7 +222,16 @@ impl RawArray {
         self.doc.is_empty()
     }
 
-    /// Returns an iterator over the `RawElement`s in the array.
+    /// Gets an iterator over the elements in the [`RawArray`],
+    /// which yields `Result<RawElement<'_>>` values. These hold a
+    /// reference to the underlying array but do not explicitly
+    /// resolve the values.
+    ///
+    /// This iterator, which underpins the implementation of the
+    /// default iterator, produces `RawElement` objects that hold a
+    /// view onto the array but do not parse out or construct
+    /// values until the `.value()` or `.try_into()` methods are
+    /// called.
     pub fn iter_elements(&self) -> RawIter {
         RawIter::new(&self.doc)
     }