Add more Walkthrough sections, reorganize Walkthroughs

rojvv · rojvv · commit 6e85b2419e77 · 2026-07-21T23:51:13.000+03:00
diff --git a/src/account-auto-deletion.md b/src/account-auto-deletion.md
@@ -3,7 +3,7 @@ title: Account Auto-Deletion
 parent: /#walkthrough
 walkthrough:
   track: user
-  order: 14
+  order: 23
 ---
 
 User clients can control when an inactive account is automatically deleted.
diff --git a/src/archived-chats.md b/src/archived-chats.md
@@ -3,7 +3,7 @@ title: Archived Chats
 parent: /#walkthrough
 walkthrough:
   track: user
-  order: 11
+  order: 4
 ---
 
 User clients can move chats between the main and archived chat lists.
diff --git a/src/authorization-sessions.md b/src/authorization-sessions.md
@@ -3,7 +3,7 @@ title: Authorization Sessions
 parent: /#walkthrough
 walkthrough:
   track: user
-  order: 5
+  order: 21
 ---
 
 User clients can view and remove the account's authorization sessions.
diff --git a/src/birthday.md b/src/birthday.md
@@ -0,0 +1,27 @@
+---
+title: Birthday
+parent: /#walkthrough
+walkthrough:
+  track: user
+  order: 14
+---
+
+User clients can set or remove the account's birthday.
+
+## Setting a Birthday
+
+Use {{ "setBirthday" |> m }} with the day, month, and optionally the year.
+
+```ts
+await client.setBirthday({
+  birthday: { day: 9, month: 9, year: 1995 },
+});
+```
+
+## Removing the Birthday
+
+Call {{ "setBirthday" |> m }} without a birthday.
+
+```ts
+await client.setBirthday();
+```
diff --git a/src/blocked-users.md b/src/blocked-users.md
@@ -3,7 +3,7 @@ title: Blocked Users
 parent: /#walkthrough
 walkthrough:
   track: user
-  order: 6
+  order: 18
 ---
 
 User clients can block users and manage the account's block list.
diff --git a/src/bot-commands.md b/src/bot-commands.md
@@ -3,7 +3,7 @@ title: Bot Commands
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 12
+  order: 2
 ---
 
 Bots can publish a list of commands that Telegram shows to users.
diff --git a/src/bot-profile.md b/src/bot-profile.md
@@ -3,7 +3,7 @@ title: Bot Profile
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 3
+  order: 1
 ---
 
 Bots can manage the name and descriptions Telegram shows to users.
diff --git a/src/bot-write-access.md b/src/bot-write-access.md
@@ -3,7 +3,7 @@ title: Bot Write Access
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 16
+  order: 11
 ---
 
 Bots can detect when a user allows them to send messages.
diff --git a/src/business-connections.md b/src/business-connections.md
@@ -3,7 +3,7 @@ title: Business Connections
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 6
+  order: 12
 ---
 
 Bots can reply on behalf of Telegram Business accounts that connect to them.
diff --git a/src/chat-recommendations.md b/src/chat-recommendations.md
@@ -3,7 +3,7 @@ title: Chat Recommendations
 parent: /#walkthrough
 walkthrough:
   track: user
-  order: 15
+  order: 2
 ---
 
 User clients can get recommended channels and find similar channels or bots.
diff --git a/src/close-friends.md b/src/close-friends.md
@@ -0,0 +1,23 @@
+---
+title: Close Friends
+parent: /#walkthrough
+walkthrough:
+  track: user
+  order: 17
+---
+
+Users can manage the account's close friends list.
+
+## Setting Close Friends
+
+Use {{ "setCloseFriends" |> m }} with the identifiers of the users to include.
+
+```ts
+await client.setCloseFriends([userId1, userId2]);
+```
+
+This replaces the current close friends list. Pass an empty array to clear it.
+
+```ts
+await client.setCloseFriends([]);
+```
diff --git a/src/communities.md b/src/communities.md
@@ -3,7 +3,7 @@ title: Communities
 parent: /#walkthrough
 walkthrough:
   track: user
-  order: 9
+  order: 3
 ---
 
 User clients can organize related chats into communities.
diff --git a/src/connected-websites.md b/src/connected-websites.md
@@ -0,0 +1,37 @@
+---
+title: Connected Websites
+parent: /#walkthrough
+walkthrough:
+  track: user
+  order: 22
+---
+
+User clients can view and disconnect websites linked to the account.
+
+## Listing Connected Websites
+
+Use {{ "getConnectedWebsites" |> m }} to get the websites as {{ "ConnectedWebsite" |> t }} objects.
+
+```ts
+const websites = await client.getConnectedWebsites();
+
+for (const website of websites) {
+  console.log(website.domain, website.browser, website.platform);
+}
+```
+
+## Disconnecting a Website
+
+Use {{ "disconnectConnectedWebsite" |> m }} with the website's identifier.
+
+```ts
+await client.disconnectConnectedWebsite(websiteId);
+```
+
+## Disconnecting All Websites
+
+Use {{ "disconnectConnectedWebsites" |> m }} to disconnect every website.
+
+```ts
+await client.disconnectConnectedWebsites();
+```
diff --git a/src/contacts.md b/src/contacts.md
@@ -3,7 +3,7 @@ title: Contacts
 parent: /#walkthrough
 walkthrough:
   track: user
-  order: 4
+  order: 1
 ---
 
 User clients can manage the account's Telegram contacts.
diff --git a/src/editing-inline-messages.md b/src/editing-inline-messages.md
@@ -3,7 +3,7 @@ title: Editing Inline Messages
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 18
+  order: 8
 ---
 
 Bots can edit inline messages after a user selects an inline query result or interacts with an inline keyboard.
diff --git a/src/ephemeral-messages.md b/src/ephemeral-messages.md
@@ -3,7 +3,7 @@ title: Ephemeral Messages
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 8
+  order: 5
 ---
 
 Bots can reply to commands with messages that are visible only to the user who sent the command.
diff --git a/src/guest-queries.md b/src/guest-queries.md
@@ -3,7 +3,7 @@ title: Guest Queries
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 7
+  order: 9
 ---
 
 Bots can receive guest queries and answer them with a single result. Guest queries must first be enabled for the bot through [@BotFather](https://t.me/BotFather).
diff --git a/src/inline-queries.md b/src/inline-queries.md
@@ -3,7 +3,7 @@ title: Inline Queries
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 2
+  order: 7
 ---
 
 Inline mode lets users interact with a bot from any chat by typing its username followed by a query. It must first be enabled for the bot through [@BotFather](https://t.me/BotFather).
diff --git a/src/keyboards-and-callback-queries.md b/src/keyboards-and-callback-queries.md
@@ -3,7 +3,7 @@ title: Keyboards and Callback Queries
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 1
+  order: 3
 ---
 
 Bots can attach a keyboard to a message to give users a set of actions to choose from. An inline keyboard appears directly below the message and can contain buttons that send data back to the bot, open URLs, launch mini apps, and perform other actions.
diff --git a/src/login-buttons.md b/src/login-buttons.md
@@ -3,7 +3,7 @@ title: Login Buttons
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 15
+  order: 10
 ---
 
 Bots can let users sign in to a website with their Telegram account.
diff --git a/src/managed-bots.md b/src/managed-bots.md
@@ -3,7 +3,7 @@ title: Managed Bots
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 11
+  order: 18
 ---
 
 Bots that manage other bots can control their access settings and tokens.
diff --git a/src/message-drafts.md b/src/message-drafts.md
@@ -3,7 +3,7 @@ title: Message Drafts
 parent: /#walkthrough
 walkthrough:
   track: user
-  order: 17
+  order: 6
 ---
 
 User clients can save message drafts and clear all drafts.
diff --git a/src/message-translation.md b/src/message-translation.md
@@ -3,7 +3,7 @@ title: Message Translation
 parent: /#walkthrough
 walkthrough:
   track: user
-  order: 12
+  order: 8
 ---
 
 User clients can translate messages and text into another language.
diff --git a/src/name-and-profile-color.md b/src/name-and-profile-color.md
@@ -3,7 +3,7 @@ title: Name and Profile Color
 parent: /#walkthrough
 walkthrough:
   track: user
-  order: 18
+  order: 13
 ---
 
 User clients can customize their name color and profile color.
diff --git a/src/notification-settings.md b/src/notification-settings.md
@@ -3,7 +3,7 @@ title: Notification Settings
 parent: /#walkthrough
 walkthrough:
   track: user
-  order: 8
+  order: 19
 ---
 
 User clients can control notifications for individual chats.
diff --git a/src/paid-broadcasts.md b/src/paid-broadcasts.md
@@ -3,7 +3,7 @@ title: Paid Broadcasts
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 9
+  order: 16
 ---
 
 Paid broadcasts let bots use Telegram Stars to send messages beyond the free broadcast limit.
diff --git a/src/payments.md b/src/payments.md
@@ -3,7 +3,7 @@ title: Payments
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 4
+  order: 14
 ---
 
 Bots can accept payments by sending invoices and handling checkout updates.
diff --git a/src/personal-channel.md b/src/personal-channel.md
@@ -0,0 +1,25 @@
+---
+title: Personal Channel
+parent: /#walkthrough
+walkthrough:
+  track: user
+  order: 16
+---
+
+User clients can display a channel on the account's profile.
+
+## Setting a Personal Channel
+
+Use {{ "setPersonalChannel" |> m }} with the channel's identifier.
+
+```ts
+await client.setPersonalChannel({ chatId: channelId });
+```
+
+## Removing the Personal Channel
+
+Call {{ "setPersonalChannel" |> m }} without a channel.
+
+```ts
+await client.setPersonalChannel();
+```
diff --git a/src/premium-subscription-gifts.md b/src/premium-subscription-gifts.md
@@ -3,7 +3,7 @@ title: Premium Subscription Gifts
 parent: /#walkthrough
 walkthrough:
   track: bot
-  order: 13
+  order: 17
 ---
 
 Bots can gift Telegram Premium subscriptions to users with Telegram Stars.
diff --git a/src/privacy-settings.md b/src/privacy-settings.md
@@ -3,7 +3,7 @@ title: Privacy Settings
 parent: /#walkthrough
 walkthrough:
   track: user
-  order: 7
+  order: 20
 ---
 
 User clients can control who can see account information and use features such as calls and group invitations.
diff --git a/src/profile-music.md b/src/profile-music.md
@@ -3,7 +3,7 @@ title: Profile Music
 parent: /#walkthrough
 walkthrough:
   track: user
-  order: 10
+  order: 15
 ---
 
 User clients can add music to their profile.
diff --git a/src/profile-photos.md b/src/profile-photos.md
diff --git a/src/requesting-users.md b/src/requesting-users.md
diff --git a/src/saved-messages.md b/src/saved-messages.md
diff --git a/src/scheduled-messages.md b/src/scheduled-messages.md
diff --git a/src/secret-chats.md b/src/secret-chats.md
diff --git a/src/star-and-ton-balance-and-transactions.md b/src/star-and-ton-balance-and-transactions.md
diff --git a/src/star-payment-refunds.md b/src/star-payment-refunds.md
diff --git a/src/stories.md b/src/stories.md
diff --git a/src/streaming-responses.md b/src/streaming-responses.md
diff --git a/src/user-emoji-statuses.md b/src/user-emoji-statuses.md
diff --git a/src/usernames.md b/src/usernames.md
