Merge pull request #508 from GetStream/update-docs

docs: update docs

Author: szuperaz

projects/stream-chat-angular/src/lib/channel.service.ts

@@ -295,7 +295,11 @@ export class ChannelService<
     message: StreamMessage<T>
   ) => StreamMessage<T> | Promise<StreamMessage<T>>;
   /**
-   * By default the SDK uses an offset based pagination, you can change/extend this by providing your own custom paginator method. It will be called with the result of the latest channel query.
+   * By default the SDK uses an offset based pagination, you can change/extend this by providing your own custom paginator method.
+   *
+   * The method will be called with the result of the latest channel query.
+   *
+   * You can return either an offset, or a filter using the [`$lte`/`$gte` operator](https://getstream.io/chat/docs/javascript/query_syntax_operators/). If you return a filter, it will be merged with the filter provided for the `init` method.
    */
   customPaginator?: (channelQueryResult: Channel<T>[]) => NextPageConfiguration;
   private channelsSubject = new BehaviorSubject<Channel<T>[] | undefined>(