chore: update .env.example to clarify required Discord bot credentials and server configuration

Author: wiktoriavh

.env.example

@@ -1,24 +1,26 @@
-# Local Environment Variables (Secrets)
-# Copy this file to .env and fill in your actual values
-# .env is gitignored and should NEVER be committed
+# Discord Bot Credentials (REQUIRED - Secret values, do not commit!)
+DISCORD_TOKEN=your_discord_bot_token_here
+CLIENT_ID=your_discord_client_id_here
 
-# Discord Bot Token & Application ID (REQUIRED)
-# Get this from: https://discord.com/developers/applications
-DISCORD_TOKEN=your-bot-token-here
-CLIENT_ID=your-bot-application-id
+# Server Configuration (REQUIRED)
+SERVER_ID=your_server_id_here
 
-# Override any public config values for local testing
+# Channel IDs (REQUIRED)
+GUIDES_CHANNEL_ID=your_guides_channel_id_here
+ADVENT_OF_CODE_CHANNEL_ID=your_advent_of_code_forum_channel_id_here
+REPEL_LOG_CHANNEL_ID=your_repel_log_channel_id_here
 
-# Discord Server ID (your dev server)
-SERVER_ID=your-server-id
+# Role IDs (REQUIRED)
+MODERATORS_ROLE_IDS=role_id_1,role_id_2,role_id_3
+REPEL_ROLE_ID=your_repel_role_id_here
 
-# Channel IDs (from your dev server)
-GUIDES_CHANNEL_ID=your-guide-channel-id
-REPEL_LOG_CHANNEL_ID=your-repel-log-channel-id
+# Optional Role IDs
+# ROLE_A_ID=optional_role_a_id
+# ROLE_B_ID=optional_role_b_id
+# ROLE_C_ID=optional_role_c_id
 
-# Role IDs (from your dev server)
-REPEL_ROLE_ID=your-repel-role-id
-MODERATORS_ROLE_IDS=your-moderator-role-id
-
-# Other
-GUIDES_TRACKER_PATH=guides-tracker.json
+# Data Persistence (OPTIONAL)
+# Local development defaults to current directory
+# Docker deployments should use /app/data for persistence
+GUIDES_TRACKER_PATH=guides-tracker.json
+ADVENT_OF_CODE_TRACKER_PATH=advent-of-code-tracker.json