From bbf4f26c1d9f9d0409885674ce81602ed40b775f Mon Sep 17 00:00:00 2001
From: Deven Joshi <deven9852@gmail.com>
Date: Mon, 5 Jul 2021 20:59:28 +0530
Subject: [PATCH] feat: Added new docs

---
 .../docs/Flutter/basics/introduction.mdx      |  2 +-
 .../stream_chat_flutter/channel_list_view.mdx |  9 ++-
 .../stream_chat_flutter/message_list_view.mdx | 70 +++++++++++++++++--
 3 files changed, 74 insertions(+), 7 deletions(-)

diff --git a/docusaurus/docs/Flutter/basics/introduction.mdx b/docusaurus/docs/Flutter/basics/introduction.mdx
index e39f82cc..457fd5e6 100644
--- a/docusaurus/docs/Flutter/basics/introduction.mdx
+++ b/docusaurus/docs/Flutter/basics/introduction.mdx
@@ -2,7 +2,7 @@
 slug: /
 id: introduction
 sidebar_position: 1
-title: Introduction To Stream Chat For Flutter
+title: About The Flutter SDK
 ---
 Exploring The Basics Of Stream Chat
 
diff --git a/docusaurus/docs/Flutter/stream_chat_flutter/channel_list_view.mdx b/docusaurus/docs/Flutter/stream_chat_flutter/channel_list_view.mdx
index 379b3a2a..f513d00a 100644
--- a/docusaurus/docs/Flutter/stream_chat_flutter/channel_list_view.mdx
+++ b/docusaurus/docs/Flutter/stream_chat_flutter/channel_list_view.mdx
@@ -92,7 +92,14 @@ ChannelListView(
   ...
   swipeToAction: true,
   swipeActions: [
-    // Your action widgets here
+    SwipeAction(
+        color: Colors.blue,
+        iconWidget: Icon(Icons.add),
+        onTap: (channel) {
+            // Things to do on icon tap
+        },
+    ),
+    // Other actions here
   ]
 ),
 ```
diff --git a/docusaurus/docs/Flutter/stream_chat_flutter/message_list_view.mdx b/docusaurus/docs/Flutter/stream_chat_flutter/message_list_view.mdx
index c3a3efc2..1b57cd97 100644
--- a/docusaurus/docs/Flutter/stream_chat_flutter/message_list_view.mdx
+++ b/docusaurus/docs/Flutter/stream_chat_flutter/message_list_view.mdx
@@ -4,6 +4,20 @@ sidebar_position: 5
 title: MessageListView
 ---
 
+A Widget For Displaying A List Of Messages
+
+Find the pub.dev documentation [here](https://pub.dev/documentation/stream_chat_flutter/latest/stream_chat_flutter/MessageListView-class.html)
+
+### Background
+
+Every channel can contain a list of messages sent by users inside it. The `MessageListView` widget
+displays the list of messages inside a particular channel along with possible attachments and
+other message attributes (if the message is pinned for example). This sets it apart from the `MessageSearchListView`
+which may not contain messages only from a single channel and is used to search for messages across
+many.
+
+### Basic Example
+
 The `MessageListView` shows the list of messages of the current channel. It has inbuilt support for
 common messaging functionality: displaying and editing messages, adding / modifying reactions, support
 for quoting messages, pinning messages, and more.
@@ -39,9 +53,55 @@ class ChannelPage extends StatelessWidget {
 }
 ```
 
-Make sure to have a [StreamChannel] ancestor in order to
-provide the information about the channels.
-The widget uses a [ListView.custom] to render the list of channels.
+### Enable Threads
 
-The widget components render the ui based on the first
-ancestor of type [StreamChatTheme].
\ No newline at end of file
+Threads are made of a parent message and replies linked to it. To enable threading, the SDK requires you
+to supply a `threadBuilder` which will supply the page when the thread is clicked.
+
+```dart
+MessageListView(
+    threadBuilder: (_, parentMessage) {
+        return ThreadPage(
+            parent: parentMessage,
+        );
+    },
+),
+```
+
+The `MessageListView` itself can render the thread by supplying the `parentMessage` parameter.
+
+```dart
+MessageListView(
+    parentMessage: parent,
+),
+```
+
+### Building Custom Messages
+
+You can also supply your own implementation for displaying messages using the `messageBuilder` parameter.
+
+Note: To customize the existing implementation, look at the `MessageWidget` documentation instead.
+
+```dart
+MessageListView(
+    messageBuilder: (context, details, messageList, defaultImpl) {
+        // Your implementation of the message here
+        // E.g: return Text(details.message.text);
+    },
+),
+```
+
+### Enabling Message Pinning
+
+Message pins save and highlight the message in the `MessageListView`. To enable users to pin the message,
+make sure the pin permissions are granted for different types of users on the dashboard. After confirming
+the appropriate users have permissions, add the user types in the `pinPermissions` parameter.
+
+```dart
+MessageListView(
+    //...
+    pinPermissions: ['admin', 'userType1', 'userType2'],
+),
+```
+
+This will allow these user types to pin messages through the message actions modal.
\ No newline at end of file