BytesCData: Adjust escaped() fn docs

src/events/mod.rs

@@ -710,6 +710,10 @@ impl<'a> BytesCData<'a> {
 
     /// Creates an iterator of `BytesCData` from a string.
     ///
+    /// If a string contains `]]>`, it needs to be split into multiple `CDATA`
+    /// sections, splitting the `]]` and `>` characters. This iterator yields
+    /// a `BytesCData` instance for each of those sections.
+    ///
     /// # Examples
     ///
     /// ```
@@ -874,10 +878,6 @@ impl<'a> arbitrary::Arbitrary<'a> for BytesCData<'a> {
 /// Iterator over `CDATA` sections in a string.
 ///
 /// This iterator is created by the [`BytesCData::escaped`] method.
-///
-/// If a string contains `]]>`, it needs to be split into multiple `CDATA`
-/// sections, splitting the `]]` and `>` characters. This iterator yields
-/// each of those sections.
 #[derive(Clone, Debug)]
 pub struct CDataIterator<'a> {
     content: &'a str,