update readmes

DeepLinksBot/README.md

@@ -1,9 +1,37 @@
 # DeepLinksBot
 
-This bot will send you deeplink to this bot when you send some text message and react on the `start` button
+An example long-polling bot that creates deep links to itself and demonstrates two
+ways to consume their payloads with the TelegramBotAPI behaviour builder.
 
-## Launch
+## Behavior
+
+- On startup, the bot fetches and prints its own account details. It stops if the
+  account has no username, because a username is required to build a deep link.
+- `/start` without arguments returns a short usage hint.
+- A text message containing no bot-command entity is used as the payload of a new
+  deep link, which the bot returns to the sender.
+- A `/start <payload>` deep link is observed by both an `onDeepLink` trigger and a
+  `waitDeepLinks` waiter. Their replies identify which API received the payload.
+- The waiter also prints the registered command handlers for demonstration and
+  debugging purposes.
+
+Messages containing a bot command are excluded from link generation. The bot has
+no persistence and runs until the process is stopped.
+
+## Requirements
+
+- A Telegram bot token supplied as the first command-line argument.
+- A username configured for the bot account.
+- No special administrator permissions; the bot only needs to receive messages
+  and send replies in the chat where it is used.
+
+## Run
+
+From the repository root:
 
 ```bash
-../gradlew run --args="BOT_TOKEN"
+./gradlew :DeepLinksBot:run --args="BOT_TOKEN"
 ```
+
+Replace `BOT_TOKEN` with the token for the bot. Additional command-line arguments
+are ignored. Omitting the token causes startup to fail before polling begins.