Doc improvements

Animate / AnimateList extensions

lib/src/animate.dart

@@ -397,9 +397,11 @@ class _AnimateState extends State<Animate> with SingleTickerProviderStateMixin {
   }
 }
 
+/// Adds [Animate] related extensions to [Widget].
 extension AnimateWidgetExtensions on Widget {
-  /// Wraps the target Widget in an Animate instance. Ex. `myWidget.animate()` is equivalent
-  /// to `Animate(child: myWidget)`.
+  /// Wraps the target [Widget] in an [Animate] instance, and returns
+  /// the instance for chaining calls.
+  /// Ex. `myWidget.animate()` is equivalent to `Animate(child: myWidget)`.
   Animate animate({
     Key? key,
     List<Effect>? effects,

lib/src/animate_list.dart

@@ -106,9 +106,11 @@ class AnimateList<T extends Widget> extends ListBase<Widget>
   }
 }
 
-/// Wraps the target `List<Widget>` in a [AnimateList] instance.
-/// Ex. `[foo, bar].animate()` is equivalent to `AnimateList(children: [foo, bar])`.
+/// Adds [AnimateList] related extensions to `List<Widget>`.
 extension AnimateListExtensions on List<Widget> {
+  /// Wraps the target `List<Widget>` in an [AnimateList] instance, and returns
+  /// the instance for chaining calls.
+  /// Ex. `[foo, bar].animate()` is equivalent to `AnimateList(children: [foo, bar])`.
   AnimateList animate({
     List<Effect>? effects,
     AnimateCallback? onInit,