update readmes

FSMBot/README.md

@@ -1,10 +1,44 @@
-# FSM
+# FSMBot
 
-This bot contains an example of working with FSM included in project
-[MicroUtils](https://github.com/InsanusMokrassar/MicroUtils)
+FSMBot demonstrates the finite-state-machine (FSM) support provided by
+[MicroUtils](https://github.com/InsanusMokrassar/MicroUtils) and TelegramBotAPI's
+behaviour builder.
 
-## Launch
+## Behaviour
+
+1. Send `/start` to begin a conversation chain for the current chat.
+2. The bot asks for content and waits in the same forum topic/thread in which the
+   chain was started.
+3. Each content message is copied back to the chat, then the bot waits again.
+4. Send `/stop` in that topic/thread to end the chain and receive a confirmation.
+
+FSM state is held in memory, so active chains are lost when the process stops.
+Incoming updates and state-handling errors are printed to standard output.
+
+## Commands
+
+- `/start` — start or restart the content-resending chain.
+- `/stop` — stop the active chain while the bot is waiting for content.
+
+The bot does not register its command menu automatically; commands can be typed
+directly or configured separately with BotFather.
+
+## Requirements and permissions
+
+- A bot token obtained from BotFather.
+- A compatible JDK for the repository's Gradle wrapper.
+- Permission to send messages and the content types being copied in the target chat.
+- No administrator rights are required. For use in groups, disable privacy mode if
+  the bot must receive arbitrary non-command messages rather than only commands and
+  other updates Telegram exposes to privacy-enabled bots.
+
+## Run
+
+From the repository root:
 
 ```bash
-../gradlew run --args="BOT_TOKEN"
+./gradlew :FSMBot:run --args="<BOT_TOKEN>"
 ```
+
+`BOT_TOKEN` is the required first positional argument. The bot uses long polling;
+no webhook or additional configuration is needed.