update readmes

GiveawaysBot/README.md

@@ -1,6 +1,37 @@
-# CustomBot
+# GiveawaysBot
 
-Printing giveaways
+A bot that monitors and logs all giveaway lifecycle events in chats.
+
+## Functionality
+
+Listens for Telegram giveaway service messages and logs each event to standard output. No
+interactive commands are provided; the bot is purely an observer/logger for giveaway activity.
+
+## Arguments
+
+| Position | Value | Description |
+|----------|-------|-------------|
+| 1 | `BOT_TOKEN` | Telegram bot token |
+
+Optional arguments (any order after the token):
+
+| Value | Description |
+|-------|-------------|
+| `debug` | Enable verbose debug logging |
+| `testServer` | Connect to the Telegram test server instead of production |
+
+## Bot Commands
+
+None.
+
+## Capabilities
+
+- Detects and logs giveaway creation events (`GiveawayCreated`)
+- Detects and logs giveaway completion events with results (`Giveaway` with results)
+- Detects and logs winner announcement messages (`GiveawayWinners`)
+- Detects content messages that contain giveaway information (`GiveawayPublicResults`)
+- All events are printed to stdout for inspection
+- Runs via long polling
 
 ## Launch