more docs

Author: sachaarbonel

packages/stream_feed_flutter_core/lib/src/bloc/feed_bloc.dart

@@ -232,13 +232,23 @@ class GenericFeedBloc<A, Ob, T, Or> {
 
   /* REACTIONS */
 
-  /// Add a new reaction to the feed.
+  /// {@template onAddReaction}
+  /// Add a new reaction to the feed
+  ///  in a reactive way.
+  /// For example to add a comment under a tweet:
+  /// ```dart
+  /// FeedProvider.of(context).bloc.onAddReaction(kind:'comment',
+  /// activity: activities[idx],feedGroup:'user'),
+  /// data: {'text': trimmedText}
+  /// ```
+  /// {@endtemplate}
+
   Future<Reaction> onAddReaction({
-    Map<String, Object>? data,
     required String kind,
     required GenericEnrichedActivity<A, Ob, T, Or> activity,
-    List<FeedId>? targetFeeds,
     required String feedGroup,
+    List<FeedId>? targetFeeds,
+    Map<String, Object>? data,
   }) async {
     final reaction = await client.reactions
         .add(kind, activity.id!, targetFeeds: targetFeeds, data: data);

packages/stream_feed_flutter_core/lib/src/bloc/provider.dart

@@ -4,7 +4,8 @@ import 'package:stream_feed_flutter_core/src/bloc/feed_bloc.dart';
 
 /// The generic version of [FeedProvider]
 ///
-///{@macro feedProvider}
+/// {@macro feedProvider}
+/// {@macro genericParameters}
 class GenericFeedProvider<A, Ob, T, Or> extends InheritedWidget {
   const GenericFeedProvider({
     Key? key,

packages/stream_feed_flutter_core/lib/src/flat_feed_core.dart

@@ -9,8 +9,8 @@ import 'package:stream_feed_flutter_core/stream_feed_flutter_core.dart';
 
 /// The generic version of [FlatFeedCore]
 /// 
-///{@macro flatFeedCore}
-///{@macro genericParameters}
+/// {@macro flatFeedCore}
+/// {@macro genericParameters}
 class GenericFlatFeedCore<A, Ob, T, Or> extends StatefulWidget {
   ///{@macro flatFeedCore}
   const GenericFlatFeedCore({

packages/stream_feed_flutter_core/lib/src/reactions_list_core.dart

@@ -11,8 +11,9 @@ import 'package:stream_feed_flutter_core/stream_feed_flutter_core.dart';
 //TODO: other things to add to core: FollowListCore, UserListCore
 
 /// The generic version of [ReactionListCore]
-/// 
-///{@macro reactionListCore}
+///
+/// {@macro reactionListCore}
+/// {@macro genericParameters}
 class GenericReactionListCore<A, Ob, T, Or> extends StatefulWidget {
   ///{@macro reactionListCore}
   const GenericReactionListCore({

packages/stream_feed_flutter_core/lib/src/typedefs.dart

@@ -146,10 +146,7 @@ typedef FeedProvider = GenericFeedProvider<User, String, String, String>;
 /// ```dart
 /// FeedProvider.of(context).bloc.onRemoveActivity()
 /// ```
-/// - add reactions (comment under a tweet) in a reactive way
-/// ```dart
-/// FeedProvider.of(context).bloc.onAddReaction()
-/// ```
+/// - {@macro onAddReaction}
 /// - remove reacitons (delete a comment under a tweet) in a reactive way
 /// ```dart
 /// FeedProvider.of(context).bloc.onRemoveReaction()
@@ -166,10 +163,10 @@ typedef FeedProvider = GenericFeedProvider<User, String, String, String>;
 /// 
 /// {@template genericParameters}
 /// The generic parameters can be of the following type:
-/// A = [actor] can be an User, or a String
-/// Ob = [object] can a String, or a CollectionEntry
-/// T = [target] can be a String or an Activity
-/// Or = [origin] can be a String or a Reaction or an User
+/// - A : [actor] can be an User, or a String
+/// - Ob : [object] can a String, or a CollectionEntry
+/// - T : [target] can be a String or an Activity
+/// - Or : [origin] can be a String or a Reaction or an User
 ///
 /// To avoid potential runtime errors
 /// make sure they are the same across the app if