docs: add poll state overview docs

Author: isekovanic

docusaurus/docs/reactnative/state-and-offline-support/state-overview.mdx

@@ -248,12 +248,12 @@ To disconnect a user you can call `disconnect` on the client.
 await client.disconnectUser();
 ```
 
-## Thread and ThreadManager
+## POJO
 
-With the new [threads feature](../guides/custom-thread-list.mdx) we've decided to refresh our state management and moved to a subscribable POJO with selector based system to make developer experience better when it came to rendering information provided by our `StreamChat` client.
+With a few of our new features, we've decided to refresh our state management and moved to a subscribable POJO with selector based system to make developer experience better when it came to rendering information provided by our `StreamChat` client.
 
 :::note
-This change is currently only available within `StreamChat.threads` but will be reused across the whole SDK later on.
+This change is currently only available within `StreamChat.threads`, `StreamChat.poll` and `StreamChat.polls` but will be reused across the whole SDK later on.
 :::
 
 ### Why POJO (State Object)
@@ -349,7 +349,7 @@ thread?.state.getLatestValue(/*...*/);
 
 #### useStateStore Hook
 
-For the ease of use - the React SDK comes with the appropriate state access hook which wraps `StateStore.subscribeWithSelector` API for the React-based applications.
+For the ease of use - the React Native SDK comes with the appropriate state access hook which wraps `StateStore.subscribeWithSelector` API for the React-based applications.
 
 ```tsx
 import { useStateStore } from 'stream-chat-react-native';
@@ -370,3 +370,69 @@ const CustomThreadList = () => {
   );
 };
 ```
+
+## Thread and ThreadManager
+
+One of the feature that follows the new POJO style of state management is the [threads feature](../guides/custom-thread-list.mdx).
+
+It provides a reactive state for both a single `Thread` (through a reactive `threadInstance`) and a list of threads (through `StreamChat.threads`).
+
+Both states can be accessed through `selector`s as outlined in the examples above.
+
+## Poll and PollManager
+
+Our new polls feature also follows the new POJO style of state management. A `poll` in itself is something that needs to be linked to a `message` in order for it to work. When a poll is created, the only way to make it visible to the users is to send it as a message. This `message` needs to have a `poll_id` attached to it and preferably no text.
+
+You can access each `poll`'s reactive state by getting it by ID using `StreamChat.polls.fromState(<poll-id>)`.
+
+:::note
+Please keep in mind that `message.poll` is not going to be reactive, but will rather contain the raw `poll` data as returned by our backend.
+:::
+
+### Utility hooks
+
+The React Native SDK provides 2 utility hooks to help with consuming the `poll` state. They can be found listed below:
+
+- [`usePollStateStore`](./hooks/poll/use-poll-state-store.mdx)
+- [`usePollState`](./hooks/poll/use-poll-state.mdx)
+
+Similarly to the `threads` feature, one can also directly use `useStateStore` and access `StreamChat.polls.fromState(<poll-id>).state` through custom `selector`s.
+
+:::note
+Both `usePollStateStore` and `usePollState` can only be used in children of a [`PollContext`](./contexts/poll-context.mdx). This impediment does not exist however on `useStateStore`.
+:::
+
+Due to this, all `poll` related components within the SDK are self-wrapped within a `PollContext` and require `message` and `poll` as mandatory props.
+
+#### Example
+
+```tsx
+import { usePollState } from 'stream-chat-react-native';
+
+const CustomPollComponent = () => {
+  const { name, options } = usePollState();
+
+  return (
+    <View>
+      <Text>{name}</Text>
+      {options.map(option => (
+        <Text key={option.id}>{option.text}</Text>
+      ))}
+    </View>
+  );
+};
+
+const PollMessage = ({ message }) => {
+  const { client } = useChatContext();
+  const pollInstance = client.polls.fromState(message?.poll_id);
+  return (
+    <PollContextProvider value={{ message, poll: pollInstance }}>
+      <CustomPollComponent />
+    </PollContextProvider>
+  )
+}
+```
+
+
+
+