doc: update documentation of catalog.list method

01.workspace/heave/src/imp/catalog_list.rs

@@ -9,12 +9,9 @@ impl Catalog {
     ///
     /// # Returns
     ///
-    /// A `Result` containing a `Vec` of `Result<T, FailedTo>>`. Each inner `Result`
+    /// A `Result` containing a `Vec<T>` of entities that were successfully
-    /// represents the outcome of converting an entity to type `T`.
+    /// converted to type `T`. Entities that fail conversion are silently
-    ///
+    /// skipped and not included in the returned vector.
-    /// - `Ok(Vec<Ok(T)>)`: A vector of successfully converted entities.
-    /// - `Ok(Vec<Err(FailedTo::ConvertEntity)>)`: If an entity of the correct class
-    ///   could not be converted to type `T`.
     ///
     /// # Errors
     ///