clarify call tokens

docusaurus/video/docusaurus/docs/api/_common_/storage.mdx

@@ -106,7 +106,7 @@ When transcribing or recording a call, the storage provider is selected in this
 2. If specified at the call type level, the storage provider designated for that call type will be used.
 3. If neither applies, Stream S3 storage will be used.
 
-Note: All Stream applications have Stream S3 storage enabled by default, which you can refer to as `"stream-s3"` in the configuration.
+> **Note:**  All Stream applications have Stream S3 storage enabled by default, which you can refer to as `"stream-s3"` in the configuration.
 
 <Tabs groupId="examples">
 <TabItem value="js" label="JavaScript">

docusaurus/video/docusaurus/docs/api/basics/authentication.mdx

@@ -372,7 +372,10 @@ You need to provide the generated tokens to the client SDKs. Stream SDKs accept
 
 ## Call tokens
 
-Call tokens contain a list of call IDs. If a user is authenticated with a call token, they can only access the specified calls. They are helpful if you want to limit call access, but you want to avoid managing call members (an example: a pay-pre-view link for livestreams, with hundreds of thousands of expected viewers).
+
+Call tokens contain a list of call IDs. When a user utilizes a call token, they will automatically be assigned the membership role for all the calls specified in the token’s claims. Additionally, the token may optionally include alternative roles, such as admin or moderator.
+
+> **Note:** Call tokens are designed to grant additional access, not restrict it. Most call types let regular users join calls. If all users can access any call, call tokens won't change this. Remove call access from the user role and grant it to specific members instead.
 
 <Tabs groupId="examples">
 <TabItem value="js" label="JavaScript">

docusaurus/video/docusaurus/docs/api/recording/recording_calls.mdx

@@ -13,7 +13,7 @@ Call recording is done by Stream server-side and later stored on AWS S3. There i
 
 By default, calls will be recorded as mp4 video files. You can configure recording to only capture the audio.
 
-Note: by default, recordings contain all tracks mixed in a single file. You can follow the discussion [here](https://github.com/GetStream/protocol/discussions/247) if you are interested in different ways to record calls.
+> **Note:**  by default, recordings contain all tracks mixed in a single file. You can follow the discussion [here](https://github.com/GetStream/protocol/discussions/247) if you are interested in different ways to record calls.
 
 ## Start and stop call recording