update readmes

InlineQueriesBot/README.md

@@ -1,9 +1,51 @@
 # InlineQueriesBot
 
-This bot will form the inline queries for you. For that feature you should explicitly enable inline queries in bot settings
+This Kotlin Multiplatform example answers inline queries with generated article results. It uses long polling and can be
+launched on the JVM or as a Kotlin/Native executable.
 
-## Launch
+## Behavior
+
+For every inline query, the bot:
+
+- treats the numeric `offset` as a page number, defaulting to page `0` when the offset is absent or invalid;
+- returns a full page of numbered articles whose message text includes the user's query;
+- disables caching and marks the answer as personal;
+- provides the next numeric offset for pagination; and
+- adds a button that opens a `/start` deep link for the current page. The bot replies with that deep-link parameter.
+
+The bot also prints its own account information at startup, logs received updates, and prints polling exceptions.
+
+## Setup
+
+Create a bot and obtain its token, then enable inline mode for it in BotFather (for example, with `/setinline`). Keep the
+token private.
+
+Both launchers require the bot token as the first command-line argument. Starting either launcher without an argument
+fails immediately; additional arguments are ignored.
+
+## Launch from the repository root
+
+### JVM
 
 ```bash
-../gradlew run --args="BOT_TOKEN"
+./gradlew :InlineQueriesBot:runJvm --args="<BOT_TOKEN>"
 ```
+
+### Kotlin/Native
+
+The shared native configuration supports Linux x64/Arm64 and Windows x64 hosts. Build the debug executable with Gradle,
+then pass the token directly to the produced program:
+
+```bash
+./gradlew :InlineQueriesBot:linkDebugExecutableNative
+./InlineQueriesBot/build/bin/native/debugExecutable/InlineQueriesBot.kexe "<BOT_TOKEN>"
+```
+
+On Windows, run `InlineQueriesBot\build\bin\native\debugExecutable\InlineQueriesBot.exe "<BOT_TOKEN>"` after the same
+Gradle link task.
+
+## Source sets
+
+- `commonMain` contains `doInlineQueriesBot`, including the long-polling behavior and inline-query/deep-link handlers.
+- `jvmMain` provides the suspending JVM entry point.
+- `nativeMain` provides the native entry point and calls the shared suspending function with `runBlocking`.

InlineQueriesBot/src/commonMain/kotlin/Bot.kt

@@ -14,8 +14,7 @@ import dev.inmo.tgbotapi.types.inlineQueryAnswerResultsLimit
 import dev.inmo.tgbotapi.utils.buildEntities
 
 /**
- * Thi bot will create inline query answers. You
- * should enable inline queries in bot settings
+ * Starts the inline-query bot with [token] and suspends until long polling stops.
  */
 suspend fun doInlineQueriesBot(token: String) {
     val bot = telegramBot(token)

InlineQueriesBot/src/jvmMain/kotlin/InlineQueriesBot.kt

@@ -1,3 +1,4 @@
+/** JVM entry point; [args] must contain the bot token as its first element. */
 suspend fun main(args: Array<String>) {
     doInlineQueriesBot(args.first())
 }

InlineQueriesBot/src/nativeMain/kotlin/InlineQueriesBot.kt

@@ -1,5 +1,6 @@
 import kotlinx.coroutines.runBlocking
 
+/** Kotlin/Native entry point; [args] must contain the bot token as its first element. */
 fun main(args: Array<String>) {
     runBlocking {
         doInlineQueriesBot(args.first())