.

src/extensions/collectible.rs

@@ -141,7 +141,7 @@ pub trait Collectible<Item>: IntoIterator<Item = Item> {
   /// of the original collection.
   ///
   /// Combinations for ordered collections are generated based on element positions, not values.
-  ///
+  /// Therefore, if an ordered collection contains duplicate elements, the resulting combinations will too.
   /// To obtain combinations of unique elements for ordered collections, use `.unique().combinations()`.
   ///
   /// The order of combined values is preserved for ordered collections.
@@ -1023,10 +1023,10 @@ pub trait Collectible<Item>: IntoIterator<Item = Item> {
     (result_left, result_right)
   }
 
-  /// Creates a new collection containing all subsets of the original collection.
+  /// Creates a new collection containing all sub-collections of the original collection.
   ///
   /// Sub-collections for ordered collections are generated based on element positions, not values.
-  ///
+  /// Therefore, if an ordered collection contains duplicate elements, the resulting sub-collections will too.
   /// To obtain combinations of unique elements for ordered collections, use `.unique().powerset()`.
   ///
   /// The order of combined values is preserved for ordered collections.

src/extensions/sequence.rs

@@ -104,14 +104,15 @@ pub trait Sequence<Item> {
   }
 
   // FIXME - fix failing test case
-  /// Creates a new collection containing members of k-fold cartesian product of specified size
+  /// Creates a new collection containing tuples of k-fold cartesian product of specified size
   /// from the elements of the original collection.
   ///
-  /// The order or combined values is preserved.
-  /// Combinations are generated based on element positions, not values.
-  ///
+  /// Members are generated based on element positions, not values.
+  /// Therefore, if this collection contains duplicate elements, the resulting tuples will too.
   /// To obtain cartesian product of unique elements, use `.unique().cartesian_product()`.
   ///
+  /// The order or combined values is preserved.
+  ///
   /// # Example
   ///
   /// ```
@@ -655,11 +656,12 @@ pub trait Sequence<Item> {
   /// Creates a new collection containing combinations with repetition of specified size
   /// from the elements of the original collection.
   ///
-  /// The order or combined values is preserved.
   /// Combinations are generated based on element positions, not values.
-  ///
+  /// Therefore, if this collection contains duplicate elements, the resulting combinations will too.
   /// To obtain combination with repetition of unique elements, use `.unique().multicombinations()`.
   ///
+  /// The order or combined values is preserved.
+  ///
   /// # Example
   ///
   /// ```