update readmes

PollsBot/README.md

@@ -1,11 +1,57 @@
 # PollsBot
 
-This bot will send test poll in the chat where commands will be received. Commands:
+A long-polling showcase for regular polls, quizzes, poll media, targeting, and
+poll-related updates. It registers all nine commands in Telegram's command menu.
 
+## Commands
 
+| Command | Behavior |
+| --- | --- |
+| `/anonymous` | Sends an anonymous poll with ten numbered options. |
+| `/public` | Sends a nonanonymous ten-option poll, allows added options, and hides results until closure. |
+| `/quiz` | Sends a nonanonymous, shuffled quiz with revoting and hidden results; it randomly collects zero to seven distinct correct options and allows multiple answers when needed. |
+| `/media_poll` | Adds location media to the question and venue/location media to options; replying to a sticker adds it as another option. |
+| `/quiz_media` | Asks where the Eiffel Tower is, with location question media, Paris as the answer, and venue explanation media. |
+| `/members_only` | Sends an anonymous Yes/No poll restricted to members. |
+| `/country_codes` | Sends an anonymous poll targeted to `US`, `DE`, and `JP`. |
+| `/single_option` | Sends a nonanonymous poll containing only `Got it`. |
+| `/link_poll` | Sends a nonanonymous poll whose first two options carry link media. |
 
-## Launch
+`/anonymous`, `/public`, and `/quiz` may contain extra text; the first custom-emoji
+entity after the command is copied into the poll's text and options.
+
+## Poll lifecycle and triggers
+
+The bot keeps an in-memory poll-ID-to-chat map for polls it sends. Poll answers
+produce a chat notification naming the answering user or voter chat. Poll updates
+report anonymity, media, member/country restrictions, quiz explanation media, and
+each option's votes and media.
+
+Added or deleted poll-option events produce replies containing the option text. A
+content message associated with a poll-option reply produces `Reply to poll option`
+on that option. Every received update is printed to standard output.
+
+There is no command to close a poll. Restarting the bot clears its routing map, so
+later answers and updates for earlier polls are no longer reported to their chats.
+
+## Setup and permissions
+
+Create a bot, keep its token private, and start it in a private chat or add it to a
+group where it may send messages and polls. No administrator-only methods or webhook
+configuration are used. Some poll targeting or media features require a Telegram
+chat and client that support them.
+
+## Run
+
+The intended command from the repository root is:
 
 ```bash
-../gradlew run --args="BOT_TOKEN"
+./gradlew :PollsBot:run --args="BOT_TOKEN"
 ```
+
+The first argument is the required token. An optional exact `debug` argument in any
+later position enables formatted logging; other arguments are ignored.
+
+Known issue: `build.gradle` currently names `HelloBotKt` as the main class, while
+this source's entry point is `PollsBotKt`; the `run` task cannot start until that
+Gradle setting is corrected.

PollsBot/src/main/kotlin/PollsBot.kt

@@ -44,24 +44,13 @@ import kotlinx.coroutines.sync.withLock
 import kotlin.random.Random
 
 /**
- * This bot demonstrates poll features including the new API additions:
+ * Starts the long-polling poll-feature showcase.
  *
- * * `/anonymous` — anonymous regular poll
- * * `/public` — public regular poll with option adding
- * * `/quiz` — quiz poll with random correct answer
- * * `/media_poll` — poll with [TelegramMediaLocation] as poll media (InputMediaLocation),
- *   and [TelegramMediaVenue] as option media (InputMediaVenue / InputPollOptionMedia)
- * * `/quiz_media` — quiz poll with [TelegramMediaLocation] as `media` and [TelegramMediaVenue]
- *   as `explanationMedia` (new [QuizPoll.explanationMedia] field)
- * * `/members_only` — poll with `membersOnly = true` (new [dev.inmo.tgbotapi.types.polls.Poll.membersOnly] field)
- * * `/country_codes` — poll with `countryCodes` (new [dev.inmo.tgbotapi.types.polls.Poll.countryCodes] field)
- * * `/single_option` — poll with just 1 option (minimum options count decreased from 2 to 1)
- * * `/link_poll` — poll whose options carry a [TelegramMediaLink] (InputMediaLink / Bot API 10.1
- *   [dev.inmo.tgbotapi.types.Link]) as [dev.inmo.tgbotapi.types.media.InputPollOptionMedia]
- *
- * [onPollUpdates] prints [dev.inmo.tgbotapi.types.polls.Poll.media], [dev.inmo.tgbotapi.types.polls.Poll.membersOnly],
- * [dev.inmo.tgbotapi.types.polls.Poll.countryCodes], [QuizPoll.explanationMedia], and
- * [dev.inmo.tgbotapi.types.polls.PollOption.media] for each option.
+ * The first element of [args] must be the bot token. An optional exact `debug`
+ * value in any later position enables diagnostic logging. The registered commands
+ * create regular polls and quizzes with anonymity, media, audience restrictions,
+ * custom emoji, and single-option variants; update handlers report answers, state
+ * changes, option edits, and replies associated with poll options.
  */
 suspend fun main(vararg args: String) {
     val botToken = args.first()