Code improvements

.env.example

@@ -1,36 +1,56 @@
-# Discord Jellyseerr Bot - Environment Variables
+#=====================================================================
+# Discord Jellyseerr Bot - Environment Configuration
+#=====================================================================
 # Copy this file to .env and fill in your values
+# All sensitive information should be kept secure
 
-# Discord Bot Token (required)
+#---------------------------------------------------------------------
+# Discord Bot Settings (REQUIRED)
+#---------------------------------------------------------------------
+# Your Discord Bot Token from the Discord Developer Portal
+# Create one at: https://discord.com/developers/applications
 DISCORD_BOT_TOKEN=your_discord_bot_token_here
 
-# Bot command prefix (default is !)
+# Command prefix for bot commands (default: !)
 BOT_PREFIX=!
 
-# Jellyseerr Configuration (required)
+# Color for embeds in Discord messages (hex format)
+# Default: 0x3498db (Discord blue)
+EMBED_COLOR=0x3498db
+
+#---------------------------------------------------------------------
+# Jellyseerr Connection Settings (REQUIRED)
+#---------------------------------------------------------------------
+# URL of your Jellyseerr instance including protocol and port
+# Example: http://localhost:5055 or https://jellyseerr.yourdomain.com
 JELLYSEERR_URL=http://your-jellyseerr-instance:5055
 
-# Jellyseerr Authentication (using local user account)
+# Authentication Settings (using local Jellyseerr user account)
 JELLYSEERR_EMAIL=your_jellyseerr_email@example.com
 JELLYSEERR_PASSWORD=your_jellyseerr_password
 
 # Set to false if you want to disable local login (not recommended)
+# When disabled, some functionality may be limited
 JELLYSEERR_LOCAL_LOGIN=true
 
 # Number of days until authentication cookie expires (default: 7)
 AUTH_COOKIE_EXPIRY=7
 
+#---------------------------------------------------------------------
 # Notifications
-# Jellyseerr provides webhooks for notifications, which can be configured
-# directly in the Jellyseerr settings. Discord webhooks are recommended
-# instead of using this bot for notifications.
-
-# UI Settings
-EMBED_COLOR=0x3498db
-
-# Debug Settings
-# Set to true to enable verbose logging (useful for troubleshooting)
-DEBUG_MODE=false
+#---------------------------------------------------------------------
+# NOTE: For notifications about media requests and availability,
+# use Jellyseerr's built-in Discord webhook integration.
+# Configure webhooks directly in the Jellyseerr web interface
+# under Settings > Notifications.
 
+#---------------------------------------------------------------------
+# Performance & Debug Settings
+#---------------------------------------------------------------------
 # API request timeout in seconds
-REQUEST_TIMEOUT=30
+# Increase this value if your Jellyseerr instance is slow to respond
+REQUEST_TIMEOUT=30
+
+# Set to true to enable verbose logging (useful for troubleshooting)
+# Warning: Debug mode generates large log files and exposes sensitive data
+DEBUG_MODE=false