docs: update sidebar labels and descriptions

Author: styler

docs/chatbot/variables/7tvemotes.md

@@ -1,6 +1,6 @@
 ---
 id: 7tvemotes
-sidebar_label: "7TV Emotes"
+sidebar_label: "$(7tvemotes)"
 description: "Lists active 7TV emotes in a Twitch channel. Learn how to use the $(7tvemotes) variable in StreamElements Chatbot commands."
 tags:
 - chatbot

docs/chatbot/variables/ai.md

@@ -2,12 +2,16 @@
 id: ai
 sidebar_label: "$(ai)"
 description: "Learn how to use the StreamElements AI chatbot variable to generate dynamic responses in your stream chat."
-keywords:
+tags:
+- chatbot
 - ai
+- variables
+keywords:
 - streamelements ai
 - chatbot ai
 - twitch bot
 - stream bot
+- ai variable
 ---
 
 # $(ai) Variable

docs/chatbot/variables/args.md

@@ -1,87 +1,81 @@
 ---
 id: args
+sidebar_label: "$(args)"
+description: "Learn how to use the $(args) variable in StreamElements chatbot commands for dynamic, user-input-based responses."
 tags:
   - chatbot
   - variable
 keywords:
   - args
   - arguments
+  - chatbot commands
+  - user input
+  - dynamic responses
 ---
 
-# $(args)
+# $(args) Variable
+
+## Overview
 
 The `$(args)` variable is a powerful feature in StreamElements chatbot commands that allows you to access and manipulate arguments passed by users. This enables dynamic responses based on user input, enhancing the interactivity of your chatbot.
 
-## Basic Usage
+## Usage
 
-### Syntax
+The basic syntax for using the `$(args)` variable is:
 
 ```
 $(args)
 ```
 
-### Description
+You can access specific arguments using numeric indices, starting from 1:
 
-The `$(args)` variable represents all arguments passed to a command. You can access specific arguments using numeric indices, starting from 1.
+```
+$(1), $(2), $(3), etc.
+```
 
-### Examples
+## Examples
 
-1. Accessing the first argument:
+1. Greeting a user:
    ```
    Command: !greet $(1)
    User input: !greet World
    Output: Hello, World!
    ```
 
-2. Using multiple arguments:
+2. Introducing a user:
    ```
    Command: !introduce $(1) is $(2) years old
    User input: !introduce Alice 25
    Output: Alice is 25 years old
    ```
 
-## Advanced Features
-
-### $(args.emote)
-
-This variant outputs an argument only if it is a valid emote.
-
-#### Syntax
-
-```
-$(n.emote)
-```
-Where `n` is the argument index.
-
-#### Example
+## Parameters
 
-```
-Command: !emote $(1.emote)
-User input: !emote Kappa
-Output: Kappa
+The `$(args)` variable has two special variants:
 
-User input: !emote Hello
-Output: [No output, as "Hello" is not an emote]
-```
+1. `$(n.emote)`: Outputs an argument only if it is a valid emote.
+   ```
+   Command: !emote $(1.emote)
+   User input: !emote Kappa
+   Output: Kappa
+   ```
 
-### $(args.word)
+2. `$(n.word)`: Outputs an argument only if it does not contain symbols.
+   ```
+   Command: !word $(1.word)
+   User input: !word Hello
+   Output: Hello
+   ```
 
-This variant outputs an argument only if it does not contain symbols.
+Where `n` is the argument index in both cases.
 
-#### Syntax
+## Related Variables
 
-```
-$(n.word)
-```
-Where `n` is the argument index.
+- [$(user)](user): Represents the username of the person using the command
+- [$(channel)](channel): Represents the channel name where the command is used
 
-#### Example
+## FAQ
 
-```
-Command: !word $(1.word)
-User input: !word Hello
-Output: Hello
+**Q: What happens if I try to access an argument that wasn't provided?**
 
-User input: !word Hello!
-Output: [No output, as "Hello!" contains a symbol]
-```
+A: If you try to access an argument that wasn't provided (e.g., `$(2)` when only one argument was given), the output will be blank.

docs/chatbot/variables/bttvemotes.md

@@ -1,30 +1,81 @@
 ---
 id: bttvemotes
+sidebar_label: "$(bttvemotes)"
+description: "Learn how to use the $(bttvemotes) variable to display active BetterTTV emotes in your Twitch channel."
 tags:
-  - chatbot
-  - variable
+- chatbot
+- variable
+- emotes
 keywords:
-  - bttv
-  - emotes
-  - betterttv
+- bttv
+- emotes
+- betterttv
+- twitch
+- chat
 ---
 
-# $(bttvemotes)
+# $(bttvemotes) Variable
 
-Lists the active BetterTTV emotes in the channel.
+## Overview
 
-#### Parameters
+The `$(bttvemotes)` variable lists all active BetterTTV (BTTV) emotes in your Twitch channel. This feature allows streamers and viewers to easily see which custom BTTV emotes are available for use in the chat.
 
-This variable does not take any parameters.
+## Usage
 
-#### Example Input
+To use this variable, simply include `$(bttvemotes)` in your chatbot command or message. The variable doesn't require any additional parameters.
 
+## Examples
+
+### Example 1: Displaying BTTV Emotes
+
+**Command:**
+```
+!bttvemotes
+```
+
+**Chatbot Response:**
+```
+The active BTTV emotes in this channel are: $(bttvemotes)
+```
+
+**Output:**
+```
+The active BTTV emotes in this channel are: LULW KEKW 5Head PogU
+```
+
+### Example 2: Creating a Custom Command
+
+**Command:**
 ```
-$(bttvemotes)
+!command add !customemotes Our channel's BTTV emotes: $(bttvemotes)
 ```
 
-#### Example Output
+**Usage:**
+```
+!customemotes
+```
 
+**Chatbot Response:**
 ```
-LULW KEKW 5Head PogU
+Our channel's BTTV emotes: LULW KEKW 5Head PogU
 ```
+
+## Parameters
+
+This variable does not accept any parameters.
+
+## Related Commands
+
+- [$(ffzemotes)](ffzemotes): Lists active FrankerFaceZ (FFZ) emotes in the channel
+- [$(7tvemotes)](7tvemotes): Lists active 7TV emotes in the channel
+
+## FAQ
+
+**Q: How often is the list of BTTV emotes updated?**
+A: The BTTV emote list is cached for 48 hours. To update the list immediately, you can use the command `!emotes reload`.
+
+**Q: Can I use this variable to check BTTV emotes in other channels?**
+A: No, the `$(bttvemotes)` variable only shows BTTV emotes for the channel where the chatbot is active.
+
+**Q: What if there are no BTTV emotes enabled in my channel?**
+A: If no BTTV emotes are enabled, the variable will return an empty result.