chore: update documentation

Author: appflowy

frontend/app_flowy/lib/plugins/board/application/board_bloc.dart

@@ -22,7 +22,7 @@ part 'board_bloc.freezed.dart';
 
 class BoardBloc extends Bloc<BoardEvent, BoardState> {
   final BoardDataController _gridDataController;
-  late final AFBoardDataController boardController;
+  late final AppFlowyBoardDataController boardController;
   final MoveRowFFIService _rowService;
   LinkedHashMap<String, GroupController> groupControllers = LinkedHashMap();
 
@@ -34,16 +34,16 @@ class BoardBloc extends Bloc<BoardEvent, BoardState> {
       : _rowService = MoveRowFFIService(gridId: view.id),
         _gridDataController = BoardDataController(view: view),
         super(BoardState.initial(view.id)) {
-    boardController = AFBoardDataController(
-      onMoveColumn: (
+    boardController = AppFlowyBoardDataController(
+      onMoveGroup: (
         fromColumnId,
         fromIndex,
         toColumnId,
         toIndex,
       ) {
         _moveGroup(fromColumnId, toColumnId);
       },
-      onMoveColumnItem: (
+      onMoveGroupItem: (
         columnId,
         fromIndex,
         toIndex,
@@ -52,15 +52,15 @@ class BoardBloc extends Bloc<BoardEvent, BoardState> {
         final toRow = groupControllers[columnId]?.rowAtIndex(toIndex);
         _moveRow(fromRow, columnId, toRow);
       },
-      onMoveColumnItemToColumn: (
-        fromColumnId,
+      onMoveGroupItemToGroup: (
+        fromGroupId,
         fromIndex,
-        toColumnId,
+        toGroupId,
         toIndex,
       ) {
-        final fromRow = groupControllers[fromColumnId]?.rowAtIndex(fromIndex);
-        final toRow = groupControllers[toColumnId]?.rowAtIndex(toIndex);
-        _moveRow(fromRow, toColumnId, toRow);
+        final fromRow = groupControllers[fromGroupId]?.rowAtIndex(fromIndex);
+        final toRow = groupControllers[toGroupId]?.rowAtIndex(toIndex);
+        _moveRow(fromRow, toGroupId, toRow);
       },
     );
 
@@ -165,10 +165,10 @@ class BoardBloc extends Bloc<BoardEvent, BoardState> {
     boardController.clear();
 
     //
-    List<AFBoardColumnData> columns = groups
+    List<AppFlowyBoardGroupData> columns = groups
         .where((group) => fieldController.getField(group.fieldId) != null)
         .map((group) {
-      return AFBoardColumnData(
+      return AppFlowyBoardGroupData(
         id: group.groupId,
         name: group.desc,
         items: _buildRows(group),
@@ -178,7 +178,7 @@ class BoardBloc extends Bloc<BoardEvent, BoardState> {
         ),
       );
     }).toList();
-    boardController.addColumns(columns);
+    boardController.addGroups(columns);
 
     for (final group in groups) {
       final delegate = GroupControllerDelegateImpl(
@@ -227,8 +227,8 @@ class BoardBloc extends Bloc<BoardEvent, BoardState> {
         if (isClosed) return;
         for (final group in updatedGroups) {
           final columnController =
-              boardController.getColumnController(group.groupId);
-          columnController?.updateColumnName(group.desc);
+              boardController.getGroupController(group.groupId);
+          columnController?.updateGroupName(group.desc);
         }
       },
       onError: (err) {
@@ -243,13 +243,13 @@ class BoardBloc extends Bloc<BoardEvent, BoardState> {
     );
   }
 
-  List<AFColumnItem> _buildRows(GroupPB group) {
+  List<AppFlowyGroupItem> _buildRows(GroupPB group) {
     final items = group.rows.map((row) {
       final fieldContext = fieldController.getField(group.fieldId);
       return BoardColumnItem(row: row, fieldContext: fieldContext!);
     }).toList();
 
-    return <AFColumnItem>[...items];
+    return <AppFlowyGroupItem>[...items];
   }
 
   Future<void> _loadGrid(Emitter<BoardState> emit) async {
@@ -335,7 +335,7 @@ class GridFieldEquatable extends Equatable {
   UnmodifiableListView<FieldPB> get value => UnmodifiableListView(_fields);
 }
 
-class BoardColumnItem extends AFColumnItem {
+class BoardColumnItem extends AppFlowyGroupItem {
   final RowPB row;
   final GridFieldContext fieldContext;
 
@@ -350,7 +350,7 @@ class BoardColumnItem extends AFColumnItem {
 
 class GroupControllerDelegateImpl extends GroupControllerDelegate {
   final GridFieldController fieldController;
-  final AFBoardDataController controller;
+  final AppFlowyBoardDataController controller;
   final void Function(String, RowPB, int?) onNewColumnItem;
 
   GroupControllerDelegateImpl({
@@ -369,16 +369,16 @@ class GroupControllerDelegateImpl extends GroupControllerDelegate {
 
     if (index != null) {
       final item = BoardColumnItem(row: row, fieldContext: fieldContext);
-      controller.insertColumnItem(group.groupId, index, item);
+      controller.insertGroupItem(group.groupId, index, item);
     } else {
       final item = BoardColumnItem(row: row, fieldContext: fieldContext);
-      controller.addColumnItem(group.groupId, item);
+      controller.addGroupItem(group.groupId, item);
     }
   }
 
   @override
   void removeRow(GroupPB group, String rowId) {
-    controller.removeColumnItem(group.groupId, rowId);
+    controller.removeGroupItem(group.groupId, rowId);
   }
 
   @override
@@ -388,7 +388,7 @@ class GroupControllerDelegateImpl extends GroupControllerDelegate {
       Log.warn("FieldContext should not be null");
       return;
     }
-    controller.updateColumnItem(
+    controller.updateGroupItem(
       group.groupId,
       BoardColumnItem(row: row, fieldContext: fieldContext),
     );
@@ -404,9 +404,9 @@ class GroupControllerDelegateImpl extends GroupControllerDelegate {
     final item = BoardColumnItem(row: row, fieldContext: fieldContext);
 
     if (index != null) {
-      controller.insertColumnItem(group.groupId, index, item);
+      controller.insertGroupItem(group.groupId, index, item);
     } else {
-      controller.addColumnItem(group.groupId, item);
+      controller.addGroupItem(group.groupId, item);
     }
     onNewColumnItem(group.groupId, row, index);
   }

frontend/app_flowy/lib/plugins/board/presentation/board_page.dart

@@ -65,8 +65,8 @@ class _BoardContentState extends State<BoardContent> {
   late ScrollController scrollController;
   late AFBoardScrollManager scrollManager;
 
-  final config = AFBoardConfig(
-    columnBackgroundColor: HexColor.fromHex('#F7F8FC'),
+  final config = AppFlowyBoardConfig(
+    groupBackgroundColor: HexColor.fromHex('#F7F8FC'),
   );
 
   @override
@@ -101,7 +101,7 @@ class _BoardContentState extends State<BoardContent> {
 
   Expanded _buildBoard(BuildContext context) {
     return Expanded(
-      child: AFBoard(
+      child: AppFlowyBoard(
         scrollManager: scrollManager,
         scrollController: scrollController,
         dataController: context.read<BoardBloc>().boardController,
@@ -112,9 +112,9 @@ class _BoardContentState extends State<BoardContent> {
           column,
           columnItem,
         ),
-        columnConstraints: const BoxConstraints.tightFor(width: 300),
-        config: AFBoardConfig(
-          columnBackgroundColor: HexColor.fromHex('#F7F8FC'),
+        groupConstraints: const BoxConstraints.tightFor(width: 300),
+        config: AppFlowyBoardConfig(
+          groupBackgroundColor: HexColor.fromHex('#F7F8FC'),
         ),
       ),
     );
@@ -149,14 +149,14 @@ class _BoardContentState extends State<BoardContent> {
 
   Widget _buildHeader(
     BuildContext context,
-    AFBoardColumnData columnData,
+    AppFlowyBoardGroupData columnData,
   ) {
     final boardCustomData = columnData.customData as BoardCustomData;
-    return AppFlowyColumnHeader(
+    return AppFlowyGroupHeader(
       title: Flexible(
         fit: FlexFit.tight,
         child: FlowyText.medium(
-          columnData.headerData.columnName,
+          columnData.headerData.groupName,
           fontSize: 14,
           overflow: TextOverflow.clip,
           color: context.read<AppTheme>().textColor,
@@ -181,14 +181,14 @@ class _BoardContentState extends State<BoardContent> {
     );
   }
 
-  Widget _buildFooter(BuildContext context, AFBoardColumnData columnData) {
+  Widget _buildFooter(BuildContext context, AppFlowyBoardGroupData columnData) {
     final boardCustomData = columnData.customData as BoardCustomData;
     final group = boardCustomData.group;
 
     if (group.isDefault) {
       return const SizedBox();
     } else {
-      return AppFlowyColumnFooter(
+      return AppFlowyGroupFooter(
         icon: SizedBox(
           height: 20,
           width: 20,
@@ -215,8 +215,8 @@ class _BoardContentState extends State<BoardContent> {
 
   Widget _buildCard(
     BuildContext context,
-    AFBoardColumnData column,
-    AFColumnItem columnItem,
+    AppFlowyBoardGroupData column,
+    AppFlowyGroupItem columnItem,
   ) {
     final boardColumnItem = columnItem as BoardColumnItem;
     final rowPB = boardColumnItem.row;
@@ -242,7 +242,7 @@ class _BoardContentState extends State<BoardContent> {
       },
     );
 
-    return AppFlowyColumnItemCard(
+    return AppFlowyGroupItemCard(
       key: ValueKey(columnItem.id),
       margin: config.cardPadding,
       decoration: _makeBoxDecoration(context),

frontend/app_flowy/packages/appflowy_board/README.md

@@ -9,6 +9,7 @@
     <a href="https://twitter.com/appflowy"><b>Twitter</b></a>
 </p>
 
+
 <p align="center">
 <img src="https://github.com/AppFlowy-IO/AppFlowy/blob/main/frontend/app_flowy/packages/appflowy_board/example/gifs/appflowy_board_video_1.gif?raw=true" width="680" title="AppFlowyBoard">
 </p>
@@ -30,6 +31,7 @@ Add the AppFlowy Board [Flutter package](https://docs.flutter.dev/development/pa
 With Flutter:
 ```dart
 flutter pub add appflowy_board
+flutter pub get
 ```
 
 This will add a line like this to your package's pubspec.yaml (and run an implicit flutter pub get):
@@ -38,6 +40,8 @@ dependencies:
   appflowy_board: ^0.0.6
 ```
 
+## Create board
+
 Import the package in your Dart file:
 ```dart
 import 'package:appflowy_board/appflowy_board.dart';
@@ -47,14 +51,18 @@ import 'package:appflowy_board/appflowy_board.dart';
 To quickly grasp how it can be used, look at the /example/lib folder.
 First, run main.dart to play with the demo.
 
+
 Second, let's delve into multi_board_list_example.dart to understand a few key components:
 * A Board widget is created via instantiating an AFBoard() object. 
 * In the AFBoard() object, you can find:
   * AFBoardDataController, which is defined in board_data.dart, is feeded with prepopulated mock data. It also contains callback functions to materialize future user data.
   * Three builders: AppFlowyColumnHeader, AppFlowyColumnFooter, AppFlowyColumnItemCard. See below image for what they are used for.
-<p>
+
+
+
+<!-- <p>
 <img src="https://github.com/AppFlowy-IO/AppFlowy/blob/main/frontend/app_flowy/packages/appflowy_board/example/gifs/appflowy_board_builders.jpg?raw=true" width="100%" title="AppFlowyBoard">
-</p>
+</p> -->
 
 ## Glossary
 Please refer to the API documentation.
@@ -68,4 +76,4 @@ Please look at [CONTRIBUTING.md](https://appflowy.gitbook.io/docs/essential-docu
 Distributed under the AGPLv3 License. See [LICENSE](https://github.com/AppFlowy-IO/AppFlowy-Docs/blob/main/LICENSE) for more information.
 
 
-
+d