From b2596c483da0eaf0e08273205f7a596b9b1b3ea5 Mon Sep 17 00:00:00 2001 From: Daniil Gentili Date: Fri, 27 Dec 2019 17:43:29 +0100 Subject: [PATCH] Refactor docs --- .gitignore | 1 + README.md | 594 +- src/danog/MadelineProto/DocsBuilder.php | 11 +- .../DocsBuilder/Constructors.php | 2 +- .../MadelineProto/DocsBuilder/Methods.php | 4 +- src/danog/MadelineProto/InternalDoc.php | 1673 +- src/danog/MadelineProto/Lang.php | 13658 ++++++++-------- src/danog/MadelineProto/TON/InternalDoc.php | 27 + tools/build_docs.php | 4 +- tools/merge.php | 16 + tools/translator.php | 5 +- 11 files changed, 8411 insertions(+), 7584 deletions(-) create mode 100644 tools/merge.php diff --git a/.gitignore b/.gitignore index b71ad487..c4b4ca4b 100644 --- a/.gitignore +++ b/.gitignore @@ -122,3 +122,4 @@ vendor .php_cs.cache coverage tempConv +extracted.json diff --git a/README.md b/README.md index 21f1e391..7a34f0c8 100644 --- a/README.md +++ b/README.md @@ -168,7 +168,7 @@ Tip: if you receive an error (or nothing), [send us](https://t.me/pwrtelegramgro * [FULL API Documentation with descriptions](https://docs.madelineproto.xyz/API_docs/methods/) * [Logout](https://docs.madelineproto.xyz/logout.html) * [Login](https://docs.madelineproto.xyz/docs/LOGIN.html) - * [Change 2FA password](https://docs.madelineproto.xyz/update_2fa.html) + * [Change 2FA password](https://docs.madelineproto.xyz/update2fa.html) * [Get all chats, broadcast a message to all chats](https://docs.madelineproto.xyz/docs/DIALOGS.html) * [Get the full participant list of a channel/group/supergroup](https://docs.madelineproto.xyz/getPwrChat.html) * [Get full info about a user/chat/supergroup/channel](https://docs.madelineproto.xyz/getFullInfo.html) @@ -177,324 +177,324 @@ Tip: if you receive an error (or nothing), [send us](https://t.me/pwrtelegramgro * [Upload or download files up to 1.5 GB](https://docs.madelineproto.xyz/docs/FILES.html) * [Make a phone call and play a song](https://docs.madelineproto.xyz/docs/CALLS.html) * [Create a secret chat bot](https://docs.madelineproto.xyz/docs/SECRET_CHATS.html) - * Accept URL authorization: messages.acceptUrlAuth - * Accept contact: contacts.acceptContact - * Accept telegram passport authorization: account.acceptAuthorization - * Accept telegram's TOS: help.acceptTermsOfService - * Add a sticker set: messages.installStickerSet - * Add a sticker to favorites: messages.faveSticker - * Add a sticker to recent stickers: messages.saveRecentSticker - * Add a user to a normal chat (use channels->inviteToChannel for supergroups): messages.addChatUser - * Add contact: contacts.addContact - * Add phone number as contact: contacts.importContacts - * Add sticker to stickerset: stickers.addStickerToSet - * Add users to channel/supergroup: channels.inviteToChannel - * Block a user: contacts.block - * Bots only: get telegram passport authorization form: account.getAuthorizationForm - * Bots only: send payment form: payments.sendPaymentForm - * Bots only: set precheckout results: messages.setBotPrecheckoutResults - * Bots only: set shipping results: messages.setBotShippingResults - * Bots only: set the callback answer (after a button was clicked): messages.setBotCallbackAnswer - * Bots only: set the results of an inline query: messages.setInlineBotResults - * Call inline bot: messages.getInlineBotResults - * Cancel password recovery email: account.cancelPasswordEmail - * Change notification settings: account.updateNotifySettings - * Change sticker position in photo: stickers.changeStickerPosition - * Change the phone number associated to this account: account.changePhone - * Change the phone number: account.sendChangePhoneCode - * Change the profile photo: photos.updateProfilePhoto - * Change typing status: messages.setTyping - * Check if about to edit a message or a media caption: messages.getMessageEditData - * Check if an invitation link is valid: messages.checkChatInvite - * Check if this username is available: account.checkUsername - * Check if this username is free and can be assigned to a channel/supergroup: channels.checkUsername - * Clear all drafts: messages.clearAllDrafts - * Clear all recent stickers: messages.clearRecentStickers - * Clear saved payments info: payments.clearSavedInfo - * Confirm password recovery using email: account.confirmPasswordEmail - * Confirm this phone number is associated to this account, obtain phone_code_hash from sendConfirmPhoneCode: account.confirmPhone - * Contact signup notification setting value: account.getContactSignUpNotification - * Convert chat to supergroup: messages.migrateChat - * Create a chat (not supergroup): messages.createChat + * Accept incoming call: phone.acceptCall + * Accept the new terms of service: help.acceptTermsOfService + * Add GIF to saved gifs list: messages.saveGif + * Add a sticker to a stickerset, bots only. The sticker set must have been created by the bot.: stickers.addStickerToSet + * Add an existing telegram user as contact: contacts.addContact + * Add/remove sticker from recent stickers list: messages.saveRecentSticker + * Adds a user to a chat and sends a service message on it.: messages.addChatUser + * Adds the user to the blacklist.: contacts.block + * Answer an inline query, for bots only: messages.setInlineBotResults + * Answers a custom query; for bots only: bots.answerWebhookJSONQuery + * Associate a group to a channel as [discussion group](https://telegram.org/blog/privacy-discussions-web-bots) for that channel: channels.setDiscussionGroup + * Associate a stickerset to the supergroup: channels.setStickers + * Ban/unban/kick a user in a [supergroup/channel](https://core.telegram.org/api/channel).: channels.editBanned + * Binds a temporary authorization key `temp_auth_key_id` to the permanent authorization key `perm_auth_key_id`. Each permanent key may only be bound to one temporary key at a time, binding a new temporary key overwrites the previous one. + * Cancel the code that was sent to verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp).: account.cancelPasswordEmail + * Cancel the login verification code: auth.cancelCode + * Cancels a request for creation and/or delete info on secret chat.: messages.discardEncryption + * Chanages chat name and sends a service message on it.: messages.editChatTitle + * Change media autodownload settings: account.saveAutoDownloadSettings + * Change privacy settings of current account: account.setPrivacy + * Change the phone number of the current account: account.changePhone + * Change the photo of a [channel/supergroup](https://core.telegram.org/api/channel): channels.editPhoto + * Change the username of a supergroup/channel: channels.updateUsername + * Changes chat photo and sends a service message on it: messages.editChatPhoto + * Changes the absolute position of a sticker in the set to which it belongs; for bots only. The sticker set must have been created by the bot: stickers.changeStickerPosition + * Changes username for the current user.: account.updateUsername + * Check if a username is free and can be assigned to a channel/supergroup: channels.checkUsername + * Check the validity of a chat invite link and get basic info about it: messages.checkChatInvite + * Clear all [drafts](https://core.telegram.org/api/drafts).: messages.clearAllDrafts + * Clear recent stickers: messages.clearRecentStickers + * Clear saved payment information: payments.clearSavedInfo + * Confirm a phone number to cancel account deletion, for more info [click here »](https://core.telegram.org/api/account-deletion): account.confirmPhone + * Confirms creation of a secret chat: messages.acceptEncryption + * Confirms receipt of messages by a client, cancels PUSH-notification sending.: messages.receivedMessages + * Confirms receipt of messages in a secret chat by client, cancels push notifications.: messages.receivedQueue + * Create a [supergroup/channel](https://core.telegram.org/api/channel).: channels.createChannel + * Create a stickerset, bots only.: stickers.createStickerSet * Create a theme: account.createTheme - * Create channel/supergroup: channels.createChannel - * Create stickerset: stickers.createStickerSet - * Delete a certain session: account.resetAuthorization - * Delete a certain telegram web login authorization: account.resetWebAuthorization - * Delete a channel/supergroup: channels.deleteChannel - * Delete a user from a chat (not supergroup): messages.deleteChatUser - * Delete all logged-in sessions.: auth.resetAuthorizations - * Delete all messages of a user in a channel/supergroup: channels.deleteUserHistory - * Delete all temporary authorization keys except the ones provided: auth.dropTempAuthKeys - * Delete channel/supergroup messages: channels.deleteMessages - * Delete chat history: messages.deleteHistory - * Delete contacts by phones: contacts.deleteByPhones - * Delete folder: folders.deleteFolder - * Delete messages: messages.deleteMessages - * Delete multiple contacts: contacts.deleteContacts - * Delete profile photos: photos.deletePhotos + * Create and upload a new wallpaper: account.uploadWallPaper + * Creates a new chat.: messages.createChat + * Delete a [channel/supergroup](https://core.telegram.org/api/channel): channels.deleteChannel + * Delete a folder: folders.deleteFolder + * Delete all messages sent by a certain user in a [supergroup](https://core.telegram.org/api/channel): channels.deleteUserHistory + * Delete all temporary authorization keys **except for** the ones specified: auth.dropTempAuthKeys + * Delete contacts by phone number: contacts.deleteByPhones + * Delete installed wallpapers: account.resetWallPapers + * Delete messages in a [channel/supergroup](https://core.telegram.org/api/channel): channels.deleteMessages + * Delete saved contacts: contacts.resetSaved * Delete scheduled messages: messages.deleteScheduledMessages - * Delete secure telegram passport value: account.deleteSecureValue - * Delete the history of a supergroup/channel: channels.deleteHistory - * Delete this account: account.deleteAccount - * Disable all notifications for a certain period: account.updateDeviceLocked - * Download a file through telegram: upload.getWebFile - * Edit a message: messages.editMessage - * Edit a sent inline message: messages.editInlineBotMessage - * Edit admin permissions of a user in a channel/supergroup: channels.editAdmin - * Edit admin permissions: messages.editChatAdmin - * Edit chat info: messages.editChatAbout - * Edit creator of channel: channels.editCreator - * Edit default rights of chat: messages.editChatDefaultBannedRights - * Edit folder: folders.editPeerFolders - * Edit location (geochats): channels.editLocation - * Edit the photo of a normal chat (not supergroup): messages.editChatPhoto - * Edit the photo of a supergroup/channel: channels.editPhoto - * Edit the title of a normal chat (not supergroup): messages.editChatTitle - * Edit the title of a supergroup/channel: channels.editTitle - * Edit user info: help.editUserInfo - * Enable or disable hidden history for new channel/supergroup users: channels.togglePreHistoryHidden - * Export chat invite : messages.exportChatInvite - * Find a sticker set: messages.searchStickerSets - * Finish account exporting session: account.finishTakeoutSession - * Forward messages: messages.forwardMessages - * Get CDN configuration: help.getCdnConfig - * Get a stickerset: messages.getStickerSet - * Get account TTL: account.getAccountTTL - * Get admin log of a channel/supergroup: channels.getAdminLog + * Delete stored [Telegram Passport](https://core.telegram.org/passport) documents, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption): account.deleteSecureValue + * Delete the history of a [supergroup](https://core.telegram.org/api/channel): channels.deleteHistory + * Delete the user's account from the telegram servers. Can be used, for example, to delete the account of a user that provided the login code, but forgot the [2FA password and no recovery method is configured](https://core.telegram.org/api/srp).: account.deleteAccount + * Deletes a device by its token, stops sending PUSH-notifications to it.: account.unregisterDevice + * Deletes a user from a chat and sends a service message on it.: messages.deleteChatUser + * Deletes communication history.: messages.deleteHistory + * Deletes messages by their identifiers.: messages.deleteMessages + * Deletes profile photos.: photos.deletePhotos + * Deletes several contacts from the list.: contacts.deleteContacts + * Deletes the user from the blacklist.: contacts.unblock + * Download a [CDN](https://core.telegram.org/cdn) file.: upload.getCdnFile + * Edit an inline bot message: messages.editInlineBotMessage + * Edit location of geogroup: channels.editLocation + * Edit message: messages.editMessage + * Edit peers in folder: folders.editPeerFolders + * Edit the default banned rights of a [channel/supergroup/group](https://core.telegram.org/api/channel).: messages.editChatDefaultBannedRights + * Edit the description of a [group/supergroup/channel](https://core.telegram.org/api/channel).: messages.editChatAbout + * Edit the name of a [channel/supergroup](https://core.telegram.org/api/channel): channels.editTitle + * Edits notification settings from a given user/group, from all users/all groups.: account.updateNotifySettings + * Enable/disable [top peers](https://core.telegram.org/api/top-rating): contacts.toggleTopPeers + * Enable/disable message signatures in channels: channels.toggleSignatures + * Export an invite link for a chat: messages.exportChatInvite + * Find out if a media message's caption can be edited: messages.getMessageEditData + * Finish account takeout session: account.finishTakeoutSession + * Forwards messages by their IDs.: messages.forwardMessages + * Get SHA256 hashes for verifying downloaded [CDN](https://core.telegram.org/cdn) files: upload.getCdnFileHashes + * Get SHA256 hashes for verifying downloaded files: upload.getFileHashes + * Get [channel/supergroup](https://core.telegram.org/api/channel) messages: channels.getMessages + * Get [channels/supergroups/geogroups](https://core.telegram.org/api/channel) we're admin in. Usually called when the user exceeds the [limit](../constructors/config.md) for owned public [channels/supergroups/geogroups](https://core.telegram.org/api/channel), and the user is given the choice to remove one of his channels/supergroups/geogroups.: channels.getAdminedPublicChannels + * Get [instant view](https://instantview.telegram.org) page: messages.getWebPage + * Get [passport](https://core.telegram.org/passport) configuration: help.getPassportConfig + * Get a document by its SHA256 hash, mainly used for gifs: messages.getDocumentByHash + * Get a list of [channels/supergroups](https://core.telegram.org/api/channel) we left: channels.getLeftChannels + * Get a payment form: payments.getPaymentForm * Get all archived stickers: messages.getArchivedStickers - * Get all channels you left: channels.getLeftChannels - * Get all chats (not supergroups or channels): messages.getAllChats - * Get all contacts: contacts.getContacts - * Get all logged-in authorizations: account.getAuthorizations - * Get all message drafts: messages.getAllDrafts - * Get all secure telegram passport values: account.getAllSecureValues - * Get all stickerpacks: messages.getAllStickers - * Get all supergroups/channels where you're admin: channels.getAdminedPublicChannels - * Get and increase message views: messages.getMessagesViews - * Get app config: help.getAppConfig - * Get autodownload settings: account.getAutoDownloadSettings - * Get available languages: langpack.getLanguages - * Get blocked users: contacts.getBlocked - * Get call configuration: phone.getCallConfig - * Get channel/supergroup messages: channels.getMessages - * Get channel/supergroup participants (you should use `$MadelineProto->getPwrChat($id)` instead): channels.getParticipants + * Get all chats, channels and supergroups: messages.getAllChats + * Get all contacts: contacts.getSaved + * Get all groups that can be used as [discussion groups](https://telegram.org/blog/privacy-discussions-web-bots): channels.getGroupsForDiscussion + * Get all installed stickers: messages.getAllStickers + * Get all saved [Telegram Passport](https://core.telegram.org/passport) documents, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption): account.getAllSecureValues + * Get and increase the view counter of a message sent or forwarded from a [channel](https://core.telegram.org/api/channel): messages.getMessagesViews + * Get app-specific configuration: help.getAppConfig + * Get changed emoji keywords: messages.getEmojiKeywordsDifference + * Get changelog of current app: help.getAppChangelog * Get chats in common with a user: messages.getCommonChats - * Get contacts by IDs: contacts.getContactIDs - * Get deep link info: help.getDeepLinkInfo - * Get dialog info of peers: messages.getPeerDialogs - * Get dialogs marked as unread manually: messages.getDialogUnreadMarks - * Get document by SHA256 hash: messages.getDocumentByHash - * Get emoji URL: messages.getEmojiURL - * Get emoji keyword difference: messages.getEmojiKeywordsDifference - * Get emoji keyword languages: messages.getEmojiKeywordsLanguages - * Get emoji keywords: messages.getEmojiKeywords - * Get favorite stickers: messages.getFavedStickers + * Get configuration for [CDN](https://core.telegram.org/cdn) file downloads.: help.getCdnConfig + * Get contact by telegram IDs: contacts.getContactIDs + * Get contacts near you: contacts.getLocated + * Get count of online users in a chat: messages.getOnlines + * Get days to live of account: account.getAccountTTL + * Get dialog info of specified peers: messages.getPeerDialogs + * Get dialogs manually marked as unread: messages.getDialogUnreadMarks + * Get faved stickers: messages.getFavedStickers * Get featured stickers: messages.getFeaturedStickers - * Get file hashes: upload.getFileHashes - * Get groups for discussion: channels.getGroupsForDiscussion - * Get high scores of a game sent in an inline message: messages.getInlineGameHighScores - * Get high scores of a game: messages.getGameHighScores - * Get info about a certain channel/supergroup participant: channels.getParticipant - * Get info about app updates: help.getAppUpdate - * Get info about chats: messages.getChats - * Get info about multiple channels/supergroups: channels.getChannels - * Get info about users: users.getUsers - * Get info of support user: help.getSupport - * Get information about the current proxy: help.getProxyData + * Get full info about a channel: channels.getFullChannel + * Get highscores of a game sent using an inline bot: messages.getInlineGameHighScores + * Get highscores of a game: messages.getGameHighScores + * Get info about [channels/supergroups](https://core.telegram.org/api/channel): channels.getChannels + * Get info about a [channel/supergroup](https://core.telegram.org/api/channel) participant: channels.getParticipant + * Get info about a `t.me` link: help.getDeepLinkInfo + * Get info about a certain wallpaper: account.getWallPaper + * Get info about a stickerset: messages.getStickerSet + * Get info about an emoji keyword localization: messages.getEmojiKeywordsLanguages + * Get information about a language in a localization pack: langpack.getLanguage + * Get information about all languages in a localization pack: langpack.getLanguages + * Get installed mask stickers: messages.getMaskStickers * Get installed themes: account.getThemes - * Get invitation text: help.getInviteText - * Get language pack strings: langpack.getStrings - * Get language pack updates: langpack.getDifference - * Get language pack: langpack.getLangPack - * Get language: langpack.getLanguage - * Get masks: messages.getMaskStickers - * Get message ranges to fetch: messages.getSplitRanges - * Get messages: messages.getMessages - * Get most used chats: contacts.getTopPeers - * Get nearest datacenter: help.getNearestDc - * Get notification exceptions: account.getNotifyExceptions - * Get notification settings: account.getNotifySettings - * Get online status of all users: contacts.getStatuses - * Get online users: messages.getOnlines - * Get passport config: help.getPassportConfig - * Get payment form: payments.getPaymentForm + * Get link and embed info of a message in a [channel/supergroup](https://core.telegram.org/api/channel): channels.exportMessageLink + * Get live location history of a certain user: messages.getRecentLocations + * Get localization pack strings: langpack.getLangPack + * Get localized emoji keywords: messages.getEmojiKeywords + * Get localized name of the telegram support user: help.getSupportName + * Get logged-in sessions: account.getAuthorizations + * Get media autodownload settings: account.getAutoDownloadSettings + * Get message ranges for saving the user's chat history: messages.getSplitRanges + * Get more info about a Seamless Telegram Login authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization): messages.requestUrlAuth + * Get most used peers: contacts.getTopPeers + * Get new [updates](https://core.telegram.org/api/updates).: updates.getDifference + * Get new strings in languagepack: langpack.getDifference * Get payment receipt: payments.getPaymentReceipt - * Get people nearby (geochats): contacts.getLocated + * Get peer settings: messages.getPeerSettings + * Get phone call configuration to be passed to libtgvoip's shared config: phone.getCallConfig * Get pinned dialogs: messages.getPinnedDialogs * Get poll results: messages.getPollResults - * Get previous messages of a group: messages.getHistory - * Get privacy settings: account.getPrivacy - * Get recent locations: messages.getRecentLocations + * Get preview of webpage: messages.getWebPagePreview + * Get privacy settings of current account: account.getPrivacy + * Get private info associated to the password info (recovery email, telegram [passport](https://core.telegram.org/passport) info & so on): account.getPasswordSettings + * Get promotion info of the currently-used MTProxy: help.getProxyData * Get recent stickers: messages.getRecentStickers - * Get recent t.me URLs: help.getRecentMeUrls - * Get saved contacts: contacts.getSaved - * Get saved gifs: messages.getSavedGifs - * Get saved payments info: payments.getSavedInfo - * Get scheduled history: messages.getScheduledHistory + * Get recently used `t.me` links: help.getRecentMeUrls + * Get saved GIFs: messages.getSavedGifs + * Get saved [Telegram Passport](https://core.telegram.org/passport) document, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption): account.getSecureValue + * Get saved payment information: payments.getSavedInfo + * Get scheduled messages: messages.getScheduledHistory * Get scheduled messages: messages.getScheduledMessages - * Get search counter: messages.getSearchCounters - * Get secure value for telegram passport: account.getSecureValue - * Get server configuration: help.getConfig - * Get stats URL: messages.getStatsURL - * Get stickers attachable to images: messages.getAttachedStickers - * Get stickers: messages.getStickers - * Get support name: help.getSupportName - * Get telegram web login authorizations: account.getWebAuthorizations - * Get temporary password for buying products through bots: account.getTmpPassword - * Get the callback answer of a bot (after clicking a button): messages.getBotCallbackAnswer - * Get the changelog of this app: help.getAppChangelog - * Get the current 2FA settings: account.getPasswordSettings - * Get the current password: account.getPassword - * Get the link of a message in a channel: channels.exportMessageLink - * Get the profile photos of a user: photos.getUserPhotos - * Get the settings of apeer: messages.getPeerSettings + * Get stickers attached to a photo or video: messages.getAttachedStickers + * Get stickers by emoji: messages.getStickers + * Get strings from a language pack: langpack.getStrings + * Get temporary payment password: account.getTmpPassword + * Get the admin log of a [channel/supergroup](https://core.telegram.org/api/channel): channels.getAdminLog + * Get the number of results that would be found by a [messages.search](../methods/messages.search.md) call with the same parameters: messages.getSearchCounters + * Get the participants of a channel: channels.getParticipants * Get theme information: account.getTheme - * Get unread mentions: messages.getUnreadMentions - * Get updated TOS: help.getTermsOfServiceUpdate - * Get user info: help.getUserInfo - * Get wallpaper info: account.getWallPaper - * Get webpage preview: messages.getWebPage - * Get webpage preview: messages.getWebPagePreview - * Gets list of chats: you should use $MadelineProto->getDialogs() instead: https://docs.madelineproto.xyz/docs/DIALOGS.html: messages.getDialogs - * Global message search: messages.searchGlobal - * Hide peer settings bar: messages.hidePeerSettingsBar - * Import chat invite: messages.importChatInvite - * Initializes connection and save information on the user's device and application.: initConnection - * Install theme: account.installTheme + * Get unread messages where we were mentioned: messages.getUnreadMentions + * Get web [login widget](https://core.telegram.org/widgets/login) authorizations: account.getWebAuthorizations + * Gets back found messages: messages.search + * Gets back the conversation history with one interlocutor / within a chat: messages.getHistory + * Gets current notification settings for a given user/group, from all users/all groups.: account.getNotifySettings + * Hide/unhide message history for new channel/supergroup users: channels.togglePreHistoryHidden + * If the [peer settings](../constructors/peerSettings.md) of a new user allow us to add him as contact, add that user as contact: contacts.acceptContact + * If you sent an invoice requesting a shipping address and the parameter is\_flexible was specified, the bot will receive an [updateBotShippingQuery](../constructors/updateBotShippingQuery.md) update. Use this method to reply to shipping queries.: messages.setBotShippingResults + * Import a chat invite and join a private chat/supergroup/channel: messages.importChatInvite + * Imports contacts: saves a full list on the server, adds already registered contacts to the contact list, returns added contacts and their info.: contacts.importContacts + * Informs the server about the number of pending bot updates if they haven't been processed for a long time; for bots only: help.setBotUpdatesStatus + * Initialize connection: initConnection + * Install a stickerset: messages.installStickerSet + * Install a theme: account.installTheme * Install wallpaper: account.installWallPaper - * Invalidate sent phone code: auth.cancelCode - * Invoke method from takeout session: invokeWithTakeout - * Invoke this method with layer X: invokeWithLayer - * Invoke with messages range: invokeWithMessagesRange - * Invoke with method without returning updates in the socket: invokeWithoutUpdates + * Install/uninstall wallpaper: account.saveWallPaper + * Installs a previously uploaded photo as a profile photo.: photos.updateProfilePhoto + * Internal use: help.editUserInfo + * Internal use: help.getUserInfo + * Intialize account takeout session: account.initTakeoutSession + * Invite users to a channel/supergroup: channels.inviteToChannel + * Invoke a method within a takeout session: invokeWithTakeout + * Invoke a request without subscribing the used connection for [updates](https://core.telegram.org/api/updates) (this is enabled by default for [file queries](https://core.telegram.org/api/files)).: invokeWithoutUpdates + * Invoke the specified query using the specified API [layer](https://core.telegram.org/api/invoking#layers): invokeWithLayer + * Invoke with the given message range: invokeWithMessagesRange + * Invokes a query after a successfull completion of previous queries: invokeAfterMsgs * Invokes a query after successfull completion of one of the previous queries.: invokeAfterMsg * Join a channel/supergroup: channels.joinChannel - * Kick or ban a user from a channel/supergroup: channels.editBanned - * Leave a channel/supergroup: channels.leaveChannel - * Log data for developer of this app: help.saveAppLog - * Mark channel/supergroup history as read: channels.readHistory - * Mark channel/supergroup messages as read: channels.readMessageContents - * Mark dialog as unread : messages.markDialogUnread + * Leave a [channel/supergroup](https://core.telegram.org/api/channel): channels.leaveChannel + * Log out an active [authorized session](https://core.telegram.org/api/auth) by its hash: account.resetAuthorization + * Log out an active web [telegram login](https://core.telegram.org/widgets/login) session: account.resetWebAuthorization + * Login as a bot: auth.importBotAuthorization + * Logs in a user using a key transmitted from his native data-centre.: auth.importAuthorization + * Logs out the user.: auth.logOut + * Look for updates of telegram's terms of service: help.getTermsOfServiceUpdate + * Make a user admin in a [legacy group](https://core.telegram.org/api/channel).: messages.editChatAdmin + * Manually mark dialog as unread: messages.markDialogUnread + * Mark [channel/supergroup](https://core.telegram.org/api/channel) history as read: channels.readHistory + * Mark [channel/supergroup](https://core.telegram.org/api/channel) message contents as read: channels.readMessageContents + * Mark a sticker as favorite: messages.faveSticker * Mark mentions as read: messages.readMentions - * Mark message as read: messages.readMessageContents - * Mark messages as read in secret chats: messages.readEncryptedHistory - * Mark messages as read: messages.readHistory - * Mark messages as read: messages.receivedMessages * Mark new featured stickers as read: messages.readFeaturedStickers - * Notify server that you received a call (server will refuse all incoming calls until the current call is over): phone.receivedCall - * Pin or unpin dialog: messages.toggleDialogPin - * Register device for push notifications: account.registerDevice - * Remove a sticker set: messages.uninstallStickerSet - * Remove sticker from stickerset: stickers.removeStickerFromSet + * Marks message history as read.: messages.readHistory + * Marks message history within a secret chat as read.: messages.readEncryptedHistory + * Modify the admin rights of a user in a [supergroup/channel](https://core.telegram.org/api/channel).: channels.editAdmin + * Notifies the sender about the recipient having listened a voice message or watched a video.: messages.readMessageContents + * Notify the other user in a private chat that a screenshot of the chat was taken: messages.sendScreenshotNotification + * Notify the user that the sent [passport](https://core.telegram.org/passport) data contains some errors The user will not be able to re-submit their Passport data to you until the errors are fixed (the contents of the field for which you returned the error must change). + * Obtain configuration for two-factor authorization with password: account.getPassword + * Once the user has confirmed their payment and shipping details, the bot receives an [updateBotPrecheckoutQuery](../constructors/updateBotPrecheckoutQuery.md) update. + * Optional: notify the server that the user is currently busy in a call: this will automatically refuse all incoming phone calls until the current phone call is ended.: phone.receivedCall + * Pin a message: messages.updatePinnedMessage + * Pin/unpin a dialog: messages.toggleDialogPin + * Press an inline callback button and get a callback answer from the bot: messages.getBotCallbackAnswer + * Query an inline bot: messages.getInlineBotResults + * Rate a call: phone.setCallRating + * Refuse or end running call: phone.discardCall + * Register device to receive [PUSH notifications](https://core.telegram.org/api/push-updates): account.registerDevice + * Registers a validated phone number in the system.: auth.signUp + * Remove a sticker from the set where it belongs, bots only. The sticker set must have been created by the bot.: stickers.removeStickerFromSet + * Reorder installed stickersets: messages.reorderStickerSets * Reorder pinned dialogs: messages.reorderPinnedDialogs - * Reorder sticker sets: messages.reorderStickerSets - * Report a message in a supergroup/channel for spam: channels.reportSpam - * Report a message: messages.report - * Report a peer for spam: messages.reportSpam - * Report for spam a secret chat: messages.reportEncryptedSpam - * Report for spam: account.reportPeer - * Request URL authorization: messages.requestUrlAuth - * Resend password recovery email: account.resendPasswordEmail - * Resend the SMS verification code: auth.resendCode - * Reset all notification settings: account.resetNotifySettings - * Reset all telegram web login authorizations: account.resetWebAuthorizations - * Reset saved contacts: contacts.resetSaved - * Reset top peer rating for a certain category/peer: contacts.resetTopPeerRating - * Reset wallpapers: account.resetWallPapers - * Result type returned by a current query.: invokeAfterMsgs + * Report a message in a chat for violation of telegram's Terms of Service: messages.report + * Report a new incoming chat for spam, if the [peer settings](../constructors/peerSettings.md) of the chat allow us to do that: messages.reportSpam + * Report a peer for violation of telegram's Terms of Service: account.reportPeer + * Report a secret chat for spam: messages.reportEncryptedSpam + * Reports some messages from a user in a supergroup as spam; requires administrator rights in the supergroup: channels.reportSpam + * Request a reupload of a certain file to a [CDN DC](https://core.telegram.org/cdn).: upload.reuploadCdnFile + * Request recovery code of a [2FA password](https://core.telegram.org/api/srp), only for accounts with a [recovery email configured](https://core.telegram.org/api/srp#email-verification).: auth.requestPasswordRecovery + * Resend the code to verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp).: account.resendPasswordEmail + * Resend the login code via another medium, the phone code type is determined by the return value of the previous auth.sendCode/auth.resendCode: see [login](https://core.telegram.org/api/auth) for more info.: auth.resendCode + * Reset [rating](https://core.telegram.org/api/top-rating) of top peer: contacts.resetTopPeerRating + * Reset all active web [telegram login](https://core.telegram.org/widgets/login) sessions: account.resetWebAuthorizations + * Reset the [2FA password](https://core.telegram.org/api/srp) using the recovery code sent using [auth.requestPasswordRecovery](../methods/auth.requestPasswordRecovery.md).: auth.recoverPassword + * Resets all notification settings from users and groups.: account.resetNotifySettings + * Resolve a @username to get peer info: contacts.resolveUsername + * Returns URL with the chat statistics. Currently this method can be used only for channels: messages.getStatsURL + * Returns a Telegram Passport authorization form for sharing data with a service: account.getAuthorizationForm + * Returns a current state of updates.: updates.getState * Returns a list of available wallpapers.: account.getWallPapers - * Save a GIF: messages.saveGif - * Save a message draft: messages.saveDraft - * Save autodownload settings: account.saveAutoDownloadSettings - * Save call debugging info: phone.saveCallDebug - * Save telegram passport secure value: account.saveSecureValue - * Save theme: account.saveTheme - * Save wallpaper: account.saveWallPaper - * Search contacts: contacts.search - * Search gifs: messages.searchGifs - * Search peers or messages: messages.search - * Send a custom request to the bot API: bots.sendCustomRequest - * Send a file to a secret chat: messages.sendEncryptedFile + * Returns an HTTP URL which can be used to automatically log in into translation platform and suggest new emoji replacements. The URL will be valid for 30 seconds after generation: messages.getEmojiURL + * Returns basic user info according to their identifiers.: users.getUsers + * Returns chat basic info on their IDs.: messages.getChats + * Returns configuration parameters for Diffie-Hellman key generation. Can also return a random sequence of bytes of required length.: messages.getDhConfig + * Returns content of a whole file or its part.: upload.getFile + * Returns content of an HTTP file or a part, by proxying the request through telegram.: upload.getWebFile + * Returns current configuration, icluding data center configuration.: help.getConfig + * Returns data for copying authorization to another data-centre.: auth.exportAuthorization + * Returns extended user info by ID.: users.getFullUser + * Returns full chat info according to its ID.: messages.getFullChat + * Returns info on data centre nearest to the user.: help.getNearestDc + * Returns information on update availability for the current application.: help.getAppUpdate + * Returns list of chats with non-default notification settings: account.getNotifyExceptions + * Returns text of a text message with an invitation.: help.getInviteText + * Returns the current user dialog list.: messages.getDialogs + * Returns the current user's contact list.: contacts.getContacts + * Returns the difference between the current state of updates of a certain channel and transmitted.: updates.getChannelDifference + * Returns the list of blocked users.: contacts.getBlocked + * Returns the list of contact statuses.: contacts.getStatuses + * Returns the list of messages by their IDs.: messages.getMessages + * Returns the list of user photos.: photos.getUserPhotos + * Returns the support user for the 'ask a question' feature.: help.getSupport + * Returns users found by username substring.: contacts.search + * Save a message [draft](https://core.telegram.org/api/drafts) associated to a chat.: messages.saveDraft + * Save a theme: account.saveTheme + * Save get all message [drafts](https://core.telegram.org/api/drafts).: messages.getAllDrafts + * Saves a part of a large file (over 10Mb in size) to be later passed to one of the methods.: upload.saveBigFilePart + * Saves a part of file for futher sending to one of the methods.: upload.saveFilePart + * Saves logs of application on the server.: help.saveAppLog + * Search for GIFs: messages.searchGifs + * Search for messages and peers globally: messages.searchGlobal + * Search for stickersets: messages.searchStickerSets + * Securely save [Telegram Passport](https://core.telegram.org/passport) document, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption): account.saveSecureValue * Send a media: messages.sendMedia - * Send a message: messages.sendMessage - * Send a service message to a secret chat: messages.sendEncryptedService - * Send an album: messages.sendMultiMedia - * Send an email to recover the 2FA password: auth.requestPasswordRecovery - * Send confirmation phone code: account.sendConfirmPhoneCode - * Send email verification code: account.sendVerifyEmailCode - * Send inline bot result obtained with messages.getInlineBotResults to the chat: messages.sendInlineBotResult - * Send message to secret chat: messages.sendEncrypted - * Send phone verification code: account.sendVerifyPhoneCode - * Send scheduled messages: messages.sendScheduledMessages - * Send screenshot notification: messages.sendScreenshotNotification - * Send typing notification to secret chat: messages.setEncryptedTyping - * Send vote: messages.sendVote - * Send webhook request via bot API: bots.answerWebhookJSONQuery - * Set account TTL: account.setAccountTTL - * Set contact sign up notification: account.setContactSignUpNotification - * Set discussion group of channel: channels.setDiscussionGroup - * Set phone call rating: phone.setCallRating - * Set privacy settings: account.setPrivacy - * Set secure value error for telegram passport: users.setSecureValueErrors - * Set the game score of an inline message: messages.setInlineGameScore - * Set the game score: messages.setGameScore - * Set the supergroup/channel stickerpack: channels.setStickers - * Set the update status of webhook: help.setBotUpdatesStatus - * Start a bot: messages.startBot - * Start account exporting session: account.initTakeoutSession - * Stop sending PUSH notifications to app: account.unregisterDevice - * Toggle channel signatures: channels.toggleSignatures - * Toggle slow mode: channels.toggleSlowMode - * Toggle top peers: contacts.toggleTopPeers - * Unblock a user: contacts.unblock - * Update online status: account.updateStatus - * Update pinned message: messages.updatePinnedMessage - * Update profile info: account.updateProfile - * Update the username of a supergroup/channel: channels.updateUsername + * Send a result obtained using [messages.getInlineBotResults](../methods/messages.getInlineBotResults.md).: messages.sendInlineBotResult + * Send an album of media: messages.sendMultiMedia + * Send compiled payment form: payments.sendPaymentForm + * Send confirmation code to cancel account deletion, for more info [click here »](https://core.telegram.org/api/account-deletion): account.sendConfirmPhoneCode + * Send phone call debug data to server: phone.saveCallDebug + * Send scheduled messages right away: messages.sendScheduledMessages + * Send the verification code for login: auth.sendCode + * Send the verification email code for telegram [passport](https://core.telegram.org/passport).: account.sendVerifyEmailCode + * Send the verification phone code for telegram [passport](https://core.telegram.org/passport).: account.sendVerifyPhoneCode + * Send typing event by the current user to a secret chat.: messages.setEncryptedTyping + * Sends a Telegram Passport authorization form, effectively sharing data with the service: account.acceptAuthorization + * Sends a current user typing event (see [SendMessageAction](../types/SendMessageAction.md) for all event types) to a conversation partner or group.: messages.setTyping + * Sends a custom request; for bots only: bots.sendCustomRequest + * Sends a message to a chat: messages.sendMessage + * Sends a message with a file attachment to a secret chat: messages.sendEncryptedFile + * Sends a request to start a secret chat to the user.: messages.requestEncryption + * Sends a service message to a secret chat.: messages.sendEncryptedService + * Sends a text message to a secret chat.: messages.sendEncrypted + * Set a new 2FA password: account.updatePasswordSettings + * Set account self-destruction period: account.setAccountTTL + * Set the callback answer to a user button press (bots only): messages.setBotCallbackAnswer + * Should be called after the user hides the report spam/add as contact bar of a new chat, effectively prevents the user from executing the actions specified in the [peer's settings](../constructors/peerSettings.md).: messages.hidePeerSettingsBar + * Signs in a user with a validated phone number.: auth.signIn + * Start a conversation with a bot using a [deep linking parameter](https://core.telegram.org/bots#deep-linking): messages.startBot + * Start a telegram phone call: phone.requestCall + * Submit requested order information for validation: payments.validateRequestedInfo + * Terminates all user's authorized sessions except for the current one. + * Toggle contact sign up notifications: account.setContactSignUpNotification + * Toggle supergroup slow mode: if enabled, users will only be able to send one message every `seconds` seconds: channels.toggleSlowMode + * Transfer channel ownership: channels.editCreator + * Try logging to an account protected by a [2FA password](https://core.telegram.org/api/srp).: auth.checkPassword + * Turn a [legacy group into a supergroup](https://core.telegram.org/api/channel): messages.migrateChat + * Uninstall a stickerset: messages.uninstallStickerSet * Update theme: account.updateTheme - * Update this user's username: account.updateUsername - * Upload a file without sending it to anyone: messages.uploadMedia - * Upload a secret chat file without sending it to anyone: messages.uploadEncryptedFile - * Upload profile photo: photos.uploadProfilePhoto + * Updates current user profile photo.: photos.uploadProfilePhoto + * Updates online user status.: account.updateStatus + * Updates user profile.: account.updateProfile + * Upload a file and associate it to a chat (without actually sending it to the chat): messages.uploadMedia + * Upload encrypted file and associate it to a secret chat: messages.uploadEncryptedFile * Upload theme: account.uploadTheme - * Upload wallpaper: account.uploadWallPaper - * Use phoneLogin instead: auth.sendCode - * Use the code that was emailed to you after running $MadelineProto->auth->requestPasswordRecovery to login to your account: auth.recoverPassword - * Validate requested payment info: payments.validateRequestedInfo - * Verify email address: account.verifyEmail - * Verify phone number: account.verifyPhone - * You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info: auth.bindTempAuthKey - * You cannot use this method directly, instead use $MadelineProto->getDhConfig();: messages.getDhConfig - * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats: messages.acceptEncryption - * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats: messages.discardEncryption - * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats: messages.requestEncryption - * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates: updates.getChannelDifference - * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates: updates.getDifference - * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates: updates.getState - * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls: phone.acceptCall - * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls: phone.confirmCall - * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls: phone.discardCall - * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls: phone.requestCall - * You cannot use this method directly, use $MadelineProto->exportAuthorization() instead, see https://docs.madelineproto.xyz/docs/LOGIN.html: auth.exportAuthorization - * You cannot use this method directly, use $MadelineProto->importAuthorization($authorization) instead, see https://docs.madelineproto.xyz/docs/LOGIN.html: auth.importAuthorization - * You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info): auth.importBotAuthorization - * You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info): auth.signIn - * You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info): auth.signUp - * You cannot use this method directly, use the complete_2fa_login method instead (see https://docs.madelineproto.xyz for more info): auth.checkPassword - * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info): channels.getFullChannel - * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info): messages.getFullChat - * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info): users.getFullUser - * You cannot use this method directly, use the logout method instead (see https://docs.madelineproto.xyz for more info): auth.logOut - * You cannot use this method directly, use the resolveUsername, getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info): contacts.resolveUsername - * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info: upload.getCdnFile - * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info: upload.getCdnFileHashes - * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info: upload.getFile - * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info: upload.reuploadCdnFile - * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info: upload.saveBigFilePart - * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info: upload.saveFilePart - * You cannot use this method directly: messages.receivedQueue - * You cannot use this method directly; use $MadelineProto->update_2fa($params), instead (see https://docs.madelineproto.xyz for more info): account.updatePasswordSettings + * Use this method to set the score of the specified user in a game sent as a normal message (bots only).: messages.setGameScore + * Use this method to set the score of the specified user in a game sent as an inline message (bots only).: messages.setInlineGameScore + * Use this to accept a Seamless Telegram Login authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization): messages.acceptUrlAuth + * Validates a username and checks availability.: account.checkUsername + * Verify a new phone number to associate to the current account: account.sendChangePhoneCode + * Verify a phone number for telegram [passport](https://core.telegram.org/passport).: account.verifyPhone + * Verify an email address for telegram [passport](https://core.telegram.org/passport).: account.verifyEmail + * Verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp).: account.confirmPasswordEmail + * Vote in a [poll](../constructors/poll.md): messages.sendVote + * When client-side passcode lock feature is enabled, will not show message texts in incoming [PUSH notifications](https://core.telegram.org/api/push-updates).: account.updateDeviceLocked + * Whether the user will receive notifications when contacts sign up: account.getContactSignUpNotification + * [Complete phone call E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls): phone.confirmCall * [Peers](https://docs.madelineproto.xyz/docs/USING_METHODS.html#peers) * [Files](https://docs.madelineproto.xyz/docs/FILES.html) * [Secret chats](https://docs.madelineproto.xyz/docs/USING_METHODS.html#secret-chats) diff --git a/src/danog/MadelineProto/DocsBuilder.php b/src/danog/MadelineProto/DocsBuilder.php index 3ca83703..dce01a85 100644 --- a/src/danog/MadelineProto/DocsBuilder.php +++ b/src/danog/MadelineProto/DocsBuilder.php @@ -602,7 +602,7 @@ Any json-encodable data. \danog\MadelineProto\Logger::log('Done!', \danog\MadelineProto\Logger::NOTICE); } - public $template = 'template, \var_export(\danog\MadelineProto\Lang::$lang, true), \var_export(\danog\MadelineProto\Lang::$lang['en'], true))); + if (!isset(\danog\MadelineProto\Lang::$lang['en'][$key]) || $force) { + \var_dump("Adding $key"); + \danog\MadelineProto\Lang::$lang['en'][$key] = $value; + \file_put_contents(__DIR__.'/Lang.php', \sprintf(self::$template, \var_export(\danog\MadelineProto\Lang::$lang, true), \var_export(\danog\MadelineProto\Lang::$lang['en'], true))); } } } diff --git a/src/danog/MadelineProto/DocsBuilder/Constructors.php b/src/danog/MadelineProto/DocsBuilder/Constructors.php index 6d0e2f23..62eb6ef2 100644 --- a/src/danog/MadelineProto/DocsBuilder/Constructors.php +++ b/src/danog/MadelineProto/DocsBuilder/Constructors.php @@ -67,7 +67,7 @@ trait Constructors } $type_or_subtype = isset($param['subtype']) ? 'subtype' : 'type'; $type_or_bare_type = \ctype_upper(Tools::end(\explode('.', $param[$type_or_subtype]))[0]) || \in_array($param[$type_or_subtype], ['!X', 'X', 'bytes', 'true', 'false', 'double', 'string', 'Bool', 'int53', 'int', 'long', 'int128', 'int256', 'int512']) ? 'types' : 'constructors'; - $param[$type_or_subtype] = \str_replace(['.', 'true', 'false'], ['_', 'Bool', 'Bool'], $param[$type_or_subtype]); + $param[$type_or_subtype] = \str_replace(['.', 'true', 'false'], ['.', 'Bool', 'Bool'], $param[$type_or_subtype]); if (\preg_match('/%/', $param[$type_or_subtype])) { $param[$type_or_subtype] = $this->TL->getConstructors($this->td)->findByType(\str_replace('%', '', $param[$type_or_subtype]))['predicate']; } diff --git a/src/danog/MadelineProto/DocsBuilder/Methods.php b/src/danog/MadelineProto/DocsBuilder/Methods.php index 953f2581..e29e20c7 100644 --- a/src/danog/MadelineProto/DocsBuilder/Methods.php +++ b/src/danog/MadelineProto/DocsBuilder/Methods.php @@ -357,7 +357,7 @@ $MadelineProto->[phoneLogin](https://docs.madelineproto.xyz/phoneLogin.html)($nu $MadelineProto->[completePhoneLogin](https://docs.madelineproto.xyz/completePhoneLogin.html)($code); -$MadelineProto->[complete_2FA_login](https://docs.madelineproto.xyz/complete_2FA_login.html)($password); +$MadelineProto->[complete2FALogin](https://docs.madelineproto.xyz/complete2FAlogin.html)($password); $MadelineProto->[botLogin](https://docs.madelineproto.xyz/botLogin.html)($token); @@ -393,7 +393,7 @@ image: https://docs.madelineproto.xyz/favicons/android-chrome-256x256.png * [Login](https://docs.madelineproto.xyz/docs/LOGIN.html) -* [Change 2FA password](https://docs.madelineproto.xyz/update_2fa.html) +* [Change 2FA password](https://docs.madelineproto.xyz/update2fa.html) * [Get all chats, broadcast a message to all chats](https://docs.madelineproto.xyz/docs/DIALOGS.html) diff --git a/src/danog/MadelineProto/InternalDoc.php b/src/danog/MadelineProto/InternalDoc.php index eb79edb7..281b4b24 100644 --- a/src/danog/MadelineProto/InternalDoc.php +++ b/src/danog/MadelineProto/InternalDoc.php @@ -10,13 +10,13 @@ namespace danog\MadelineProto; interface auth { /** - * Use phoneLogin instead. + * Send the verification code for login. * * Parameters: - * * `string` **phone_number** - Use phoneLogin instead - * * `int` **api_id** - Use phoneLogin instead - * * `string` **api_hash** - Use phoneLogin instead - * * `CodeSettings` **settings** - You cannot use this method directly, use the phoneLogin method instead (see https://docs.madelineproto.xyz for more info) + * * `string` **phone_number** - Phone number in international format + * * `int` **api_id** - Application identifier (see [App configuration](https://core.telegram.org/myapp)) + * * `string` **api_hash** - Application secret hash (see [App configuration](https://core.telegram.org/myapp)) + * * `CodeSettings` **settings** - Settings for the code type to send * * @param array $params Parameters * @@ -25,13 +25,13 @@ interface auth public function sendCode($params); /** - * You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info). + * Registers a validated phone number in the system. * * Parameters: - * * `string` **phone_number** - You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info) - * * `string` **phone_code_hash** - You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info) - * * `string` **first_name** - You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info) - * * `string` **last_name** - You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info) + * * `string` **phone_number** - Phone number in the international format + * * `string` **phone_code_hash** - SMS-message ID + * * `string` **first_name** - New user first name + * * `string` **last_name** - New user last name * * @param array $params Parameters * @@ -40,12 +40,12 @@ interface auth public function signUp($params); /** - * You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info). + * Signs in a user with a validated phone number. * * Parameters: - * * `string` **phone_number** - You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info) - * * `string` **phone_code_hash** - You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info) - * * `string` **phone_code** - You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info) + * * `string` **phone_number** - Phone number in the international format + * * `string` **phone_code_hash** - SMS-message ID, obtained from [auth.sendCode](../methods/auth.sendCode.md) + * * `string` **phone_code** - Valid numerical code from the SMS-message * * @param array $params Parameters * @@ -54,24 +54,26 @@ interface auth public function signIn($params); /** - * You cannot use this method directly, use the logout method instead (see https://docs.madelineproto.xyz for more info). + * Logs out the user. * * @return bool */ public function logOut(); /** - * Delete all logged-in sessions. + * Terminates all user's authorized sessions except for the current one. + +After calling this method it is necessary to reregister the current device using the method [account.registerDevice](../methods/account.registerDevice.md) * * @return bool */ public function resetAuthorizations(); /** - * You cannot use this method directly, use $MadelineProto->exportAuthorization() instead, see https://docs.madelineproto.xyz/docs/LOGIN.html. + * Returns data for copying authorization to another data-centre. * * Parameters: - * * `int` **dc_id** - You cannot use this method directly, use $MadelineProto->exportAuthorization() instead, see https://docs.madelineproto.xyz/docs/LOGIN.html + * * `int` **dc_id** - Number of a target data-centre * * @param array $params Parameters * @@ -80,11 +82,11 @@ interface auth public function exportAuthorization($params); /** - * You cannot use this method directly, use $MadelineProto->importAuthorization($authorization) instead, see https://docs.madelineproto.xyz/docs/LOGIN.html. + * Logs in a user using a key transmitted from his native data-centre. * * Parameters: - * * `int` **id** - You cannot use this method directly, use $MadelineProto->importAuthorization($authorization) instead, see https://docs.madelineproto.xyz/docs/LOGIN.html - * * `bytes` **bytes** - You cannot use this method directly, use $MadelineProto->importAuthorization($authorization) instead, see https://docs.madelineproto.xyz/docs/LOGIN.html + * * `int` **id** - User ID + * * `bytes` **bytes** - Authorization key * * @param array $params Parameters * @@ -93,13 +95,15 @@ interface auth public function importAuthorization($params); /** - * You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info. + * Binds a temporary authorization key `temp_auth_key_id` to the permanent authorization key `perm_auth_key_id`. Each permanent key may only be bound to one temporary key at a time, binding a new temporary key overwrites the previous one. + +For more information, see [Perfect Forward Secrecy](https://core.telegram.org/api/pfs). * * Parameters: - * * `long` **perm_auth_key_id** - You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info - * * `long` **nonce** - You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info - * * `int` **expires_at** - You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info - * * `bytes` **encrypted_message** - You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info + * * `long` **perm_auth_key_id** - Permanent auth\_key\_id to bind to + * * `long` **nonce** - Random long from [Binding message contents](#binding-message-contents) + * * `int` **expires_at** - Unix timestamp to invalidate temporary key, see [Binding message contents](#binding-message-contents) + * * `bytes` **encrypted_message** - See [Generating encrypted\_message](#generating-encrypted-message) * * @param array $params Parameters * @@ -108,12 +112,12 @@ interface auth public function bindTempAuthKey($params); /** - * You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info). + * Login as a bot. * * Parameters: - * * `int` **api_id** - You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info) - * * `string` **api_hash** - You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info) - * * `string` **bot_auth_token** - You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info) + * * `int` **api_id** - Application identifier (see. [App configuration](https://core.telegram.org/myapp)) + * * `string` **api_hash** - Application identifier hash (see. [App configuration](https://core.telegram.org/myapp)) + * * `string` **bot_auth_token** - Bot token (see [bots](https://core.telegram.org/bots)) * * @param array $params Parameters * @@ -122,10 +126,10 @@ interface auth public function importBotAuthorization($params); /** - * You cannot use this method directly, use the complete_2fa_login method instead (see https://docs.madelineproto.xyz for more info). + * Try logging to an account protected by a [2FA password](https://core.telegram.org/api/srp). * * Parameters: - * * `InputCheckPasswordSRP` **password** - You cannot use this method directly, use the complete_2fa_login method instead (see https://docs.madelineproto.xyz for more info) + * * `InputCheckPasswordSRP` **password** - The account's password (see [SRP](https://core.telegram.org/api/srp)) * * @param array $params Parameters * @@ -134,17 +138,17 @@ interface auth public function checkPassword($params); /** - * Send an email to recover the 2FA password. + * Request recovery code of a [2FA password](https://core.telegram.org/api/srp), only for accounts with a [recovery email configured](https://core.telegram.org/api/srp#email-verification). * * @return auth.PasswordRecovery */ public function requestPasswordRecovery(); /** - * Use the code that was emailed to you after running $MadelineProto->auth->requestPasswordRecovery to login to your account. + * Reset the [2FA password](https://core.telegram.org/api/srp) using the recovery code sent using [auth.requestPasswordRecovery](../methods/auth.requestPasswordRecovery.md). * * Parameters: - * * `string` **code** - The code that was emailed to you + * * `string` **code** - Code received via email * * @param array $params Parameters * @@ -153,11 +157,11 @@ interface auth public function recoverPassword($params); /** - * Resend the SMS verification code. + * Resend the login code via another medium, the phone code type is determined by the return value of the previous auth.sendCode/auth.resendCode: see [login](https://core.telegram.org/api/auth) for more info. * * Parameters: * * `string` **phone_number** - The phone number - * * `string` **phone_code_hash** - The phone code hash + * * `string` **phone_code_hash** - The phone code hash obtained from [auth.sendCode](../methods/auth.sendCode.md) * * @param array $params Parameters * @@ -166,11 +170,11 @@ interface auth public function resendCode($params); /** - * Invalidate sent phone code. + * Cancel the login verification code. * * Parameters: * * `string` **phone_number** - Phone number - * * `string` **phone_code_hash** - Phone code hash + * * `string` **phone_code_hash** - Phone code hash from [auth.sendCode](../methods/auth.sendCode.md) * * @param array $params Parameters * @@ -179,7 +183,7 @@ interface auth public function cancelCode($params); /** - * Delete all temporary authorization keys except the ones provided. + * Delete all temporary authorization keys **except for** the ones specified. * * Parameters: * * `[long]` **except_auth_keys** - The temporary authorization keys to keep @@ -194,14 +198,14 @@ interface auth interface account { /** - * Register device for push notifications. + * Register device to receive [PUSH notifications](https://core.telegram.org/api/push-updates). * * Parameters: - * * `boolean` **no_muted** - Optional: Idk yet - * * `int` **token_type** - Device token type. Possible values: 1 - APNS, 2 - GCM, 3 - MPNS, 4 - Simple Push, 5 - Ubuntu Phone, 6 - Blackberry, and other, see source code of official apps for more info - * * `string` **token** - Device token type. Possible values: 1 - APNS, 2 - GCM, 3 - MPNS, 4 - Simple Push, 5 - Ubuntu Phone,6 - Blackberry, and other, see source code of official apps for more info - * * `Bool` **app_sandbox** - Should the app run in a sandbox? - * * `bytes` **secret** - Secret + * * `boolean` **no_muted** - Optional: Avoid receiving (silent and invisible background) notifications. Useful to save battery. + * * `int` **token_type** - Device token type.
**Possible values**:
`1` \- APNS (device token for apple push)
`2` \- FCM (firebase token for google firebase)
`3` \- MPNS (channel URI for microsoft push)
`4` \- Simple push (endpoint for firefox's simple push API)
`5` \- Ubuntu phone (token for ubuntu push)
`6` \- Blackberry (token for blackberry push)
`7` \- Unused
`8` \- WNS (windows push)
`9` \- APNS VoIP (token for apple push VoIP)
`10` \- Web push (web push, see below)
`11` \- MPNS VoIP (token for microsoft push VoIP)
`12` \- Tizen (token for tizen push)

For `10` web push, the token must be a JSON-encoded object containing the keys described in [PUSH updates](https://core.telegram.org/api/push-updates) + * * `string` **token** - Device token + * * `Bool` **app_sandbox** - If [(boolTrue)](../constructors/boolTrue.md) is transmitted, a sandbox-certificate will be used during transmission. + * * `bytes` **secret** - For FCM and APNS VoIP, optional encryption key used to encrypt push notifications * * `[int]` **other_uids** - Other UIDs * * @param array $params Parameters @@ -211,11 +215,11 @@ interface account public function registerDevice($params); /** - * Stop sending PUSH notifications to app. + * Deletes a device by its token, stops sending PUSH-notifications to it. * * Parameters: - * * `int` **token_type** - Device token type. Possible values: 1 - APNS, 2 - GCM, 3 - MPNS, 4 - Simple Push, 5 - Ubuntu Phone,6 - Blackberry, and other, see source code of official apps for more info - * * `string` **token** - Device token type. Possible values: 1 - APNS, 2 - GCM, 3 - MPNS, 4 - Simple Push, 5 - Ubuntu Phone,6 - Blackberry, and other, see source code of official apps for more info + * * `int` **token_type** - Device token type.
**Possible values**:
`1` \- APNS (device token for apple push)
`2` \- FCM (firebase token for google firebase)
`3` \- MPNS (channel URI for microsoft push)
`4` \- Simple push (endpoint for firefox's simple push API)
`5` \- Ubuntu phone (token for ubuntu push)
`6` \- Blackberry (token for blackberry push)
`7` \- Unused
`8` \- WNS (windows push)
`9` \- APNS VoIP (token for apple push VoIP)
`10` \- Web push (web push, see below)
`11` \- MPNS VoIP (token for microsoft push VoIP)
`12` \- Tizen (token for tizen push)

For `10` web push, the token must be a JSON-encoded object containing the keys described in [PUSH updates](https://core.telegram.org/api/push-updates) + * * `string` **token** - Device token * * `[int]` **other_uids** - Other UIDs * * @param array $params Parameters @@ -225,10 +229,10 @@ interface account public function unregisterDevice($params); /** - * Change notification settings. + * Edits notification settings from a given user/group, from all users/all groups. * * Parameters: - * * `InputNotifyPeer` **peer** - The peers to which the notification settings should be applied + * * `InputNotifyPeer` **peer** - Notification source * * `InputPeerNotifySettings` **settings** - Notification settings * * @param array $params Parameters @@ -238,7 +242,7 @@ interface account public function updateNotifySettings($params); /** - * Get notification settings. + * Gets current notification settings for a given user/group, from all users/all groups. * * Parameters: * * `InputNotifyPeer` **peer** - Notification source @@ -250,19 +254,19 @@ interface account public function getNotifySettings($params); /** - * Reset all notification settings. + * Resets all notification settings from users and groups. * * @return bool */ public function resetNotifySettings(); /** - * Update profile info. + * Updates user profile. * * Parameters: - * * `string` **first_name** - Optional: The first name - * * `string` **last_name** - Optional: The last name - * * `string` **about** - Optional: The bio/about field + * * `string` **first_name** - Optional: New user first name + * * `string` **last_name** - Optional: New user last name + * * `string` **about** - Optional: New bio * * @param array $params Parameters * @@ -271,10 +275,10 @@ interface account public function updateProfile($params); /** - * Update online status. + * Updates online user status. * * Parameters: - * * `Bool` **offline** - True to set the status to offline + * * `Bool` **offline** - If [(boolTrue)](../constructors/boolTrue.md) is transmitted, user status will change to [(userStatusOffline)](../constructors/userStatusOffline.md). * * @param array $params Parameters * @@ -295,11 +299,11 @@ interface account public function getWallPapers($params); /** - * Report for spam. + * Report a peer for violation of telegram's Terms of Service. * * Parameters: * * `InputPeer` **peer** - The peer to report - * * `ReportReason` **reason** - Why are you reporting this peer + * * `ReportReason` **reason** - The reason why this peer is being reported * * @param array $params Parameters * @@ -308,10 +312,10 @@ interface account public function reportPeer($params); /** - * Check if this username is available. + * Validates a username and checks availability. * * Parameters: - * * `string` **username** - The username to check + * * `string` **username** - username
Accepted characters: A-z (case-insensitive), 0-9 and underscores.
Length: 5-32 characters. * * @param array $params Parameters * @@ -320,10 +324,10 @@ interface account public function checkUsername($params); /** - * Update this user's username. + * Changes username for the current user. * * Parameters: - * * `string` **username** - The new username + * * `string` **username** - username or empty string if username is to be removed
Accepted characters: a-z (case-insensitive), 0-9 and underscores.
Length: 5-32 characters. * * @param array $params Parameters * @@ -332,10 +336,10 @@ interface account public function updateUsername($params); /** - * Get privacy settings. + * Get privacy settings of current account. * * Parameters: - * * `InputPrivacyKey` **key** - Privacy setting key + * * `InputPrivacyKey` **key** - Peer category whose privacy settings should be fetched * * @param array $params Parameters * @@ -344,10 +348,10 @@ interface account public function getPrivacy($params); /** - * Set privacy settings. + * Change privacy settings of current account. * * Parameters: - * * `InputPrivacyKey` **key** - Privacy setting + * * `InputPrivacyKey` **key** - Peers to which the privacy rules apply * * `[InputPrivacyRule]` **rules** - Privacy settings * * @param array $params Parameters @@ -357,10 +361,10 @@ interface account public function setPrivacy($params); /** - * Delete this account. + * Delete the user's account from the telegram servers. Can be used, for example, to delete the account of a user that provided the login code, but forgot the [2FA password and no recovery method is configured](https://core.telegram.org/api/srp). * * Parameters: - * * `string` **reason** - Why are you going away? :( + * * `string` **reason** - Why is the account being deleted, can be empty * * @param array $params Parameters * @@ -369,17 +373,17 @@ interface account public function deleteAccount($params); /** - * Get account TTL. + * Get days to live of account. * * @return AccountDaysTTL */ public function getAccountTTL(); /** - * Set account TTL. + * Set account self-destruction period. * * Parameters: - * * `AccountDaysTTL` **ttl** - Time To Live of account + * * `AccountDaysTTL` **ttl** - Time to live in days * * @param array $params Parameters * @@ -388,11 +392,11 @@ interface account public function setAccountTTL($params); /** - * Change the phone number. + * Verify a new phone number to associate to the current account. * * Parameters: * * `string` **phone_number** - New phone number - * * `CodeSettings` **settings** - Code settings + * * `CodeSettings` **settings** - Phone code settings * * @param array $params Parameters * @@ -401,12 +405,12 @@ interface account public function sendChangePhoneCode($params); /** - * Change the phone number associated to this account. + * Change the phone number of the current account. * * Parameters: - * * `string` **phone_number** - Phone number - * * `string` **phone_code_hash** - Phone code hash returned by account.sendChangePhoneCode - * * `string` **phone_code** - The phone code sent by account.sendChangePhoneCode + * * `string` **phone_number** - New phone number + * * `string` **phone_code_hash** - Phone code hash received when calling [account.sendChangePhoneCode](../methods/account.sendChangePhoneCode.md) + * * `string` **phone_code** - Phone code received when calling [account.sendChangePhoneCode](../methods/account.sendChangePhoneCode.md) * * @param array $params Parameters * @@ -415,10 +419,10 @@ interface account public function changePhone($params); /** - * Disable all notifications for a certain period. + * When client-side passcode lock feature is enabled, will not show message texts in incoming [PUSH notifications](https://core.telegram.org/api/push-updates). * * Parameters: - * * `int` **period** - For how long should notifications be disabled + * * `int` **period** - Inactivity period after which to start hiding message texts in [PUSH notifications](https://core.telegram.org/api/push-updates). * * @param array $params Parameters * @@ -427,17 +431,17 @@ interface account public function updateDeviceLocked($params); /** - * Get all logged-in authorizations. + * Get logged-in sessions. * * @return account.Authorizations */ public function getAuthorizations(); /** - * Delete a certain session. + * Log out an active [authorized session](https://core.telegram.org/api/auth) by its hash. * * Parameters: - * * `long` **hash** - The session hash, obtained from $MadelineProto->account->getAuthorizations + * * `long` **hash** - Session hash * * @param array $params Parameters * @@ -446,17 +450,17 @@ interface account public function resetAuthorization($params); /** - * Get the current password. + * Obtain configuration for two-factor authorization with password. * * @return account.Password */ public function getPassword(); /** - * Get the current 2FA settings. + * Get private info associated to the password info (recovery email, telegram [passport](https://core.telegram.org/passport) info & so on). * * Parameters: - * * `InputCheckPasswordSRP` **password** - You cannot use this method directly; use $MadelineProto->update_2fa($params), instead (see https://docs.madelineproto.xyz for more info) + * * `InputCheckPasswordSRP` **password** - The password (see [SRP](https://core.telegram.org/api/srp)) * * @param array $params Parameters * @@ -465,11 +469,11 @@ interface account public function getPasswordSettings($params); /** - * You cannot use this method directly; use $MadelineProto->update_2fa($params), instead (see https://docs.madelineproto.xyz for more info). + * Set a new 2FA password. * * Parameters: - * * `InputCheckPasswordSRP` **password** - You cannot use this method directly; use $MadelineProto->update_2fa($params), instead (see https://docs.madelineproto.xyz for more info) - * * `account.PasswordInputSettings` **new_settings** - New 2FA settings + * * `InputCheckPasswordSRP` **password** - The old password (see [SRP](https://core.telegram.org/api/srp)) + * * `account.PasswordInputSettings` **new_settings** - The new password (see [SRP](https://core.telegram.org/api/srp)) * * @param array $params Parameters * @@ -478,11 +482,11 @@ interface account public function updatePasswordSettings($params); /** - * Send confirmation phone code. + * Send confirmation code to cancel account deletion, for more info [click here »](https://core.telegram.org/api/account-deletion). * * Parameters: - * * `string` **hash** - The hash - * * `CodeSettings` **settings** - Code settings + * * `string` **hash** - The hash from the service notification, for more info [click here »](https://core.telegram.org/api/account-deletion) + * * `CodeSettings` **settings** - Phone code settings * * @param array $params Parameters * @@ -491,11 +495,11 @@ interface account public function sendConfirmPhoneCode($params); /** - * Confirm this phone number is associated to this account, obtain phone_code_hash from sendConfirmPhoneCode. + * Confirm a phone number to cancel account deletion, for more info [click here »](https://core.telegram.org/api/account-deletion). * * Parameters: - * * `string` **phone_code_hash** - Obtain phone_code_hash from sendConfirmPhoneCode - * * `string` **phone_code** - The code sent by sendConfirmPhoneCode + * * `string` **phone_code_hash** - Phone code hash, for more info [click here »](https://core.telegram.org/api/account-deletion) + * * `string` **phone_code** - SMS code, for more info [click here »](https://core.telegram.org/api/account-deletion) * * @param array $params Parameters * @@ -504,11 +508,11 @@ interface account public function confirmPhone($params); /** - * Get temporary password for buying products through bots. + * Get temporary payment password. * * Parameters: - * * `InputCheckPasswordSRP` **password** - Password - * * `int` **period** - The validity period + * * `InputCheckPasswordSRP` **password** - SRP password parameters + * * `int` **period** - Time during which the temporary password will be valid, in seconds; should be between 60 and 86400 * * @param array $params Parameters * @@ -517,17 +521,17 @@ interface account public function getTmpPassword($params); /** - * Get telegram web login authorizations. + * Get web [login widget](https://core.telegram.org/widgets/login) authorizations. * * @return account.WebAuthorizations */ public function getWebAuthorizations(); /** - * Delete a certain telegram web login authorization. + * Log out an active web [telegram login](https://core.telegram.org/widgets/login) session. * * Parameters: - * * `long` **hash** - The authorization's hash + * * `long` **hash** - [Session](../constructors/webAuthorization.md) hash * * @param array $params Parameters * @@ -536,21 +540,21 @@ interface account public function resetWebAuthorization($params); /** - * Reset all telegram web login authorizations. + * Reset all active web [telegram login](https://core.telegram.org/widgets/login) sessions. * * @return bool */ public function resetWebAuthorizations(); /** - * Get all secure telegram passport values. + * Get all saved [Telegram Passport](https://core.telegram.org/passport) documents, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption). * * @return of SecureValue[] */ public function getAllSecureValues(); /** - * Get secure value for telegram passport. + * Get saved [Telegram Passport](https://core.telegram.org/passport) document, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption). * * Parameters: * * `[SecureValueType]` **types** - Get telegram passport secure parameters @@ -562,11 +566,11 @@ interface account public function getSecureValue($params); /** - * Save telegram passport secure value. + * Securely save [Telegram Passport](https://core.telegram.org/passport) document, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption). * * Parameters: - * * `InputSecureValue` **value** - Encrypted value - * * `long` **secure_secret_id** - Secret + * * `InputSecureValue` **value** - Secure value, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption) + * * `long` **secure_secret_id** - Passport secret hash, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption) * * @param array $params Parameters * @@ -575,7 +579,7 @@ interface account public function saveSecureValue($params); /** - * Delete secure telegram passport value. + * Delete stored [Telegram Passport](https://core.telegram.org/passport) documents, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption). * * Parameters: * * `[SecureValueType]` **types** - The values to delete @@ -587,12 +591,12 @@ interface account public function deleteSecureValue($params); /** - * Bots only: get telegram passport authorization form. + * Returns a Telegram Passport authorization form for sharing data with a service. * * Parameters: - * * `int` **bot_id** - Bot ID - * * `string` **scope** - Scope - * * `string` **public_key** - Bot's public key + * * `int` **bot_id** - User identifier of the service's bot + * * `string` **scope** - Telegram Passport element types requested by the service + * * `string` **public_key** - Service's public key * * @param array $params Parameters * @@ -601,14 +605,14 @@ interface account public function getAuthorizationForm($params); /** - * Accept telegram passport authorization. + * Sends a Telegram Passport authorization form, effectively sharing data with the service. * * Parameters: * * `int` **bot_id** - Bot ID - * * `string` **scope** - Scope - * * `string` **public_key** - The bot's RSA public key + * * `string` **scope** - Telegram Passport element types requested by the service + * * `string` **public_key** - Service's public key * * `[SecureValueHash]` **value_hashes** - Hashes of the encrypted credentials - * * `SecureCredentialsEncrypted` **credentials** - Encrypted secure credentials + * * `SecureCredentialsEncrypted` **credentials** - Encrypted values * * @param array $params Parameters * @@ -617,11 +621,11 @@ interface account public function acceptAuthorization($params); /** - * Send phone verification code. + * Send the verification phone code for telegram [passport](https://core.telegram.org/passport). * * Parameters: - * * `string` **phone_number** - The phone number - * * `CodeSettings` **settings** - Code settings + * * `string` **phone_number** - The phone number to verify + * * `CodeSettings` **settings** - Phone code settings * * @param array $params Parameters * @@ -630,12 +634,12 @@ interface account public function sendVerifyPhoneCode($params); /** - * Verify phone number. + * Verify a phone number for telegram [passport](https://core.telegram.org/passport). * * Parameters: - * * `string` **phone_number** - The phone number - * * `string` **phone_code_hash** - The phone code hash returned by account.sendVerifyPhoneCode - * * `string` **phone_code** - The phone code type returned by account.sendVerifyPhoneCode + * * `string` **phone_number** - Phone number + * * `string` **phone_code_hash** - Phone code hash received from the call to [account.sendVerifyPhoneCode](../methods/account.sendVerifyPhoneCode.md) + * * `string` **phone_code** - Code received after the call to [account.sendVerifyPhoneCode](../methods/account.sendVerifyPhoneCode.md) * * @param array $params Parameters * @@ -644,10 +648,10 @@ interface account public function verifyPhone($params); /** - * Send email verification code. + * Send the verification email code for telegram [passport](https://core.telegram.org/passport). * * Parameters: - * * `string` **email** - Email + * * `string` **email** - The email where to send the code * * @param array $params Parameters * @@ -656,11 +660,11 @@ interface account public function sendVerifyEmailCode($params); /** - * Verify email address. + * Verify an email address for telegram [passport](https://core.telegram.org/passport). * * Parameters: - * * `string` **email** - The email address - * * `string` **code** - The received code + * * `string` **email** - The email to verify + * * `string` **code** - The verification code that was received * * @param array $params Parameters * @@ -669,16 +673,16 @@ interface account public function verifyEmail($params); /** - * Start account exporting session. + * Intialize account takeout session. * * Parameters: - * * `boolean` **contacts** - Optional: Export contacts? - * * `boolean` **message_users** - Optional: Export users? - * * `boolean` **message_chats** - Optional: Export chats? - * * `boolean` **message_megagroups** - Optional: Export supergroups? - * * `boolean` **message_channels** - Optional: Export channel messages? - * * `boolean` **files** - Optional: Export files? - * * `int` **file_max_size** - Optional: Export only files smaller than this size + * * `boolean` **contacts** - Optional: Whether to export contacts + * * `boolean` **message_users** - Optional: Whether to export messages in private chats + * * `boolean` **message_chats** - Optional: Whether to export messages in [legacy groups](https://core.telegram.org/api/channel) + * * `boolean` **message_megagroups** - Optional: Whether to export messages in [supergroups](https://core.telegram.org/api/channel) + * * `boolean` **message_channels** - Optional: Whether to export messages in [channels](https://core.telegram.org/api/channel) + * * `boolean` **files** - Optional: Whether to export files + * * `int` **file_max_size** - Optional: Maximum size of files to export * * @param array $params Parameters * @@ -687,10 +691,10 @@ interface account public function initTakeoutSession($params); /** - * Finish account exporting session. + * Finish account takeout session. * * Parameters: - * * `boolean` **success** - Optional: Did the data export succeed? + * * `boolean` **success** - Optional: Data exported successfully * * @param array $params Parameters * @@ -699,10 +703,10 @@ interface account public function finishTakeoutSession($params); /** - * Confirm password recovery using email. + * Verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp). * * Parameters: - * * `string` **code** - Code + * * `string` **code** - The phone code that was received after [setting a recovery email](https://core.telegram.org/api/srp#email-verification) * * @param array $params Parameters * @@ -711,31 +715,31 @@ interface account public function confirmPasswordEmail($params); /** - * Resend password recovery email. + * Resend the code to verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp). * * @return bool */ public function resendPasswordEmail(); /** - * Cancel password recovery email. + * Cancel the code that was sent to verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp). * * @return bool */ public function cancelPasswordEmail(); /** - * Contact signup notification setting value. + * Whether the user will receive notifications when contacts sign up. * * @return bool */ public function getContactSignUpNotification(); /** - * Set contact sign up notification. + * Toggle contact sign up notifications. * * Parameters: - * * `Bool` **silent** - Silent? + * * `Bool` **silent** - Whether to disable contact sign up notifications * * @param array $params Parameters * @@ -744,11 +748,11 @@ interface account public function setContactSignUpNotification($params); /** - * Get notification exceptions. + * Returns list of chats with non-default notification settings. * * Parameters: - * * `boolean` **compare_sound** - Optional: Compare sound? - * * `InputNotifyPeer` **peer** - Optional: Peer + * * `boolean` **compare_sound** - Optional: If true, chats with non-default sound will also be returned + * * `InputNotifyPeer` **peer** - Optional: If specified, only chats of the specified category will be returned * * @param array $params Parameters * @@ -757,10 +761,10 @@ interface account public function getNotifyExceptions($params); /** - * Get wallpaper info. + * Get info about a certain wallpaper. * * Parameters: - * * `InputWallPaper` **wallpaper** - Wallpaper + * * `InputWallPaper` **wallpaper** - The wallpaper to get info about * * @param array $params Parameters * @@ -769,11 +773,11 @@ interface account public function getWallPaper($params); /** - * Upload wallpaper. + * Create and upload a new wallpaper. * * Parameters: - * * `InputFile` **file** - Image - * * `string` **mime_type** - Mime type + * * `InputFile` **file** - The JPG/PNG wallpaper + * * `string` **mime_type** - MIME type of uploaded wallpaper * * `WallPaperSettings` **settings** - Wallpaper settings * * @param array $params Parameters @@ -783,12 +787,12 @@ interface account public function uploadWallPaper($params); /** - * Save wallpaper. + * Install/uninstall wallpaper. * * Parameters: - * * `InputWallPaper` **wallpaper** - The wallpaper to save - * * `Bool` **unsave** - Delete saved wallpaper - * * `WallPaperSettings` **settings** - The wallpaper to save + * * `InputWallPaper` **wallpaper** - Wallpaper to save + * * `Bool` **unsave** - Uninstall wallpaper? + * * `WallPaperSettings` **settings** - Wallpaper settings * * @param array $params Parameters * @@ -810,26 +814,26 @@ interface account public function installWallPaper($params); /** - * Reset wallpapers. + * Delete installed wallpapers. * * @return bool */ public function resetWallPapers(); /** - * Get autodownload settings. + * Get media autodownload settings. * * @return account.AutoDownloadSettings */ public function getAutoDownloadSettings(); /** - * Save autodownload settings. + * Change media autodownload settings. * * Parameters: - * * `boolean` **low** - Optional: Low preset - * * `boolean` **high** - Optional: High preset - * * `AutoDownloadSettings` **settings** - Autodownload settings + * * `boolean` **low** - Optional: Whether to save settings in the low data usage preset + * * `boolean` **high** - Optional: Whether to save settings in the high data usage preset + * * `AutoDownloadSettings` **settings** - Media autodownload settings * * @param array $params Parameters * @@ -841,10 +845,10 @@ interface account * Upload theme. * * Parameters: - * * `InputFile` **file** - File - * * `InputFile` **thumb** - Optional: Thumb + * * `InputFile` **file** - Theme file uploaded as described in [files »](https://core.telegram.org/api/files) + * * `InputFile` **thumb** - Optional: Thumbnail * * `string` **file_name** - File name - * * `string` **mime_type** - Mime type + * * `string` **mime_type** - MIME type, must be `application/x-tgtheme-{format}`, where `format` depends on the client * * @param array $params Parameters * @@ -883,7 +887,7 @@ interface account public function updateTheme($params); /** - * Save theme. + * Save a theme. * * Parameters: * * `InputTheme` **theme** - Theme to save @@ -896,11 +900,11 @@ interface account public function saveTheme($params); /** - * Install theme. + * Install a theme. * * Parameters: * * `boolean` **dark** - Optional: Whether to install the dark version - * * `string` **format** - Optional: Format + * * `string` **format** - Optional: Theme format, a string that identifies the theming engines supported by the client * * `InputTheme` **theme** - Optional: Theme to install * * @param array $params Parameters @@ -940,7 +944,7 @@ interface account interface users { /** - * Get info about users. + * Returns basic user info according to their identifiers. * * Parameters: * * `[InputUser]` **id** - The ids of the users @@ -952,10 +956,10 @@ interface users public function getUsers($params); /** - * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info). + * Returns extended user info by ID. * * Parameters: - * * `InputUser` **id** - You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info) + * * `InputUser` **id** - User ID * * @param array $params Parameters * @@ -964,10 +968,12 @@ interface users public function getFullUser($params); /** - * Set secure value error for telegram passport. + * Notify the user that the sent [passport](https://core.telegram.org/passport) data contains some errors The user will not be able to re-submit their Passport data to you until the errors are fixed (the contents of the field for which you returned the error must change). + +Use this if the data submitted by the user doesn't satisfy the standards your service requires for any reason. For example, if a birthday date seems invalid, a submitted document is blurry, a scan shows evidence of tampering, etc. Supply some details in the error message to make sure the user knows how to correct the issues. * * Parameters: - * * `InputUser` **id** - The user ID + * * `InputUser` **id** - The user * * `[SecureValueError]` **errors** - The errors * * @param array $params Parameters @@ -980,7 +986,7 @@ interface users interface contacts { /** - * Get contacts by IDs. + * Get contact by telegram IDs. * * Parameters: * * `[int]` **hash** - Optional: Previously fetched IDs @@ -992,14 +998,14 @@ interface contacts public function getContactIDs($params); /** - * Get online status of all users. + * Returns the list of contact statuses. * * @return of ContactStatus[] */ public function getStatuses(); /** - * Get all contacts. + * Returns the current user's contact list. * * Parameters: * * `[int]` **hash** - Optional: User IDs of previously cached contacts @@ -1011,7 +1017,7 @@ interface contacts public function getContacts($params); /** - * Add phone number as contact. + * Imports contacts: saves a full list on the server, adds already registered contacts to the contact list, returns added contacts and their info. * * Parameters: * * `[InputContact]` **contacts** - The numbers to import @@ -1023,7 +1029,7 @@ interface contacts public function importContacts($params); /** - * Delete multiple contacts. + * Deletes several contacts from the list. * * Parameters: * * `[InputUser]` **id** - The contacts to delete @@ -1035,7 +1041,7 @@ interface contacts public function deleteContacts($params); /** - * Delete contacts by phones. + * Delete contacts by phone number. * * Parameters: * * `[string]` **phones** - Phones @@ -1047,10 +1053,10 @@ interface contacts public function deleteByPhones($params); /** - * Block a user. + * Adds the user to the blacklist. * * Parameters: - * * `InputUser` **id** - The user to block + * * `InputUser` **id** - User ID * * @param array $params Parameters * @@ -1059,10 +1065,10 @@ interface contacts public function block($params); /** - * Unblock a user. + * Deletes the user from the blacklist. * * Parameters: - * * `InputUser` **id** - The user to unblock + * * `InputUser` **id** - User ID * * @param array $params Parameters * @@ -1071,11 +1077,11 @@ interface contacts public function unblock($params); /** - * Get blocked users. + * Returns the list of blocked users. * * Parameters: - * * `int` **offset** - Initially 0, then set to the number of blocked contacts previously fetched - * * `int` **limit** - How many blocked contacts to fetch + * * `int` **offset** - The number of list elements to be skipped + * * `int` **limit** - The number of list elements to be returned * * @param array $params Parameters * @@ -1084,11 +1090,11 @@ interface contacts public function getBlocked($params); /** - * Search contacts. + * Returns users found by username substring. * * Parameters: - * * `string` **q** - The search query - * * `int` **limit** - How many results should be returned + * * `string` **q** - Target substring + * * `int` **limit** - Maximum number of users to be returned * * @param array $params Parameters * @@ -1097,10 +1103,10 @@ interface contacts public function search($params); /** - * You cannot use this method directly, use the resolveUsername, getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info). + * Resolve a @username to get peer info. * * Parameters: - * * `string` **username** - You cannot use this method directly, use the resolveUsername, getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info) + * * `string` **username** - @username to resolve * * @param array $params Parameters * @@ -1109,19 +1115,19 @@ interface contacts public function resolveUsername($params); /** - * Get most used chats. + * Get most used peers. * * Parameters: - * * `boolean` **correspondents** - Optional: Fetch users? - * * `boolean` **bots_pm** - Optional: Fetch bots? - * * `boolean` **bots_inline** - Optional: Fetch inline bots? - * * `boolean` **phone_calls** - Optional: Fetch phone calls? - * * `boolean` **forward_users** - Optional: Forward users? - * * `boolean` **forward_chats** - Optional: Forward chats? - * * `boolean` **groups** - Optional: Fetch groups? - * * `boolean` **channels** - Optional: Fetch channels and supergroups? - * * `int` **offset** - Initially 0, then `$offset += $contacts_TopPeers['categories']['count'];` - * * `int` **limit** - How many results to fetch + * * `boolean` **correspondents** - Optional: Users we've chatted most frequently with + * * `boolean` **bots_pm** - Optional: Most used bots + * * `boolean` **bots_inline** - Optional: Most used inline bots + * * `boolean` **phone_calls** - Optional: Most frequently called users + * * `boolean` **forward_users** - Optional: Users to which the users often forwards messages to + * * `boolean` **forward_chats** - Optional: Chats to which the users often forwards messages to + * * `boolean` **groups** - Optional: Often-opened groups and supergroups + * * `boolean` **channels** - Optional: Most frequently visited channels + * * `int` **offset** - Offset for [pagination](https://core.telegram.org/api/offsets) + * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * `[int]` **hash** - Optional: Peer IDs of previously cached peers * * @param array $params Parameters @@ -1131,11 +1137,11 @@ interface contacts public function getTopPeers($params); /** - * Reset top peer rating for a certain category/peer. + * Reset [rating](https://core.telegram.org/api/top-rating) of top peer. * * Parameters: - * * `TopPeerCategory` **category** - The category - * * `InputPeer` **peer** - The peer + * * `TopPeerCategory` **category** - Top peer category + * * `InputPeer` **peer** - Peer whose rating should be reset * * @param array $params Parameters * @@ -1144,24 +1150,24 @@ interface contacts public function resetTopPeerRating($params); /** - * Reset saved contacts. + * Delete saved contacts. * * @return bool */ public function resetSaved(); /** - * Get saved contacts. + * Get all contacts. * * @return of SavedContact[] */ public function getSaved(); /** - * Toggle top peers. + * Enable/disable [top peers](https://core.telegram.org/api/top-rating). * * Parameters: - * * `Bool` **enabled** - Enable or disable top peer + * * `Bool` **enabled** - Enable/disable * * @param array $params Parameters * @@ -1170,14 +1176,14 @@ interface contacts public function toggleTopPeers($params); /** - * Add contact. + * Add an existing telegram user as contact. * * Parameters: - * * `boolean` **add_phone_privacy_exception** - Optional: Phone privacy exception? - * * `InputUser` **id** - ID + * * `boolean` **add_phone_privacy_exception** - Optional: Allow the other user to see our phone number? + * * `InputUser` **id** - Telegram ID of the other user * * `string` **first_name** - First name * * `string` **last_name** - Last name - * * `string` **phone** - Phone number + * * `string` **phone** - User's phone number * * @param array $params Parameters * @@ -1186,10 +1192,10 @@ interface contacts public function addContact($params); /** - * Accept contact. + * If the [peer settings](../constructors/peerSettings.md) of a new user allow us to add him as contact, add that user as contact. * * Parameters: - * * `InputUser` **id** - ID + * * `InputUser` **id** - The user to add as contact * * @param array $params Parameters * @@ -1198,10 +1204,10 @@ interface contacts public function acceptContact($params); /** - * Get people nearby (geochats). + * Get contacts near you. * * Parameters: - * * `InputGeoPoint` **geo_point** - Current location + * * `InputGeoPoint` **geo_point** - Geolocation * * @param array $params Parameters * @@ -1213,7 +1219,7 @@ interface contacts interface messages { /** - * Get messages. + * Returns the list of messages by their IDs. * * Parameters: * * `[InputMessage]` **id** - The IDs of messages to fetch (only for users and normal groups) @@ -1225,15 +1231,15 @@ interface messages public function getMessages($params); /** - * Gets list of chats: you should use $MadelineProto->getDialogs() instead: https://docs.madelineproto.xyz/docs/DIALOGS.html. + * Returns the current user dialog list. * * Parameters: - * * `boolean` **exclude_pinned** - Optional: Do not fetch pinned chats + * * `boolean` **exclude_pinned** - Optional: Exclude pinned dialogs * * `int` **folder_id** - Optional: Folder ID - * * `int` **offset_date** - End($res['messages'])['date']; - * * `int` **offset_id** - End($res['messages'])['id']; - * * `InputPeer` **offset_peer** - End($res['dialogs'])['peer']; - * * `int` **limit** - Number of dialogs to fetch + * * `int` **offset_date** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) + * * `int` **offset_id** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) + * * `InputPeer` **offset_peer** - [Offset peer for pagination](https://core.telegram.org/api/offsets) + * * `int` **limit** - Number of list elements to be returned * * `[int]` **hash** - Optional: IDs of previously fetched dialogs * * @param array $params Parameters @@ -1243,16 +1249,16 @@ interface messages public function getDialogs($params); /** - * Get previous messages of a group. + * Gets back the conversation history with one interlocutor / within a chat. * * Parameters: - * * `InputPeer` **peer** - The chat - * * `int` **offset_id** - The last fetched message ID, initially 0 - * * `int` **offset_date** - The date of the last previously fetched message, initially 0 - * * `int` **add_offset** - Additional offset, can be 0 - * * `int` **limit** - Number of messages to fetch - * * `int` **max_id** - Maximum message ID to fetch - * * `int` **min_id** - Minumum message ID to fetch + * * `InputPeer` **peer** - Target peer + * * `int` **offset_id** - Only return messages starting from the specified message ID + * * `int` **offset_date** - Only return messages sent after the specified date + * * `int` **add_offset** - Number of list elements to be skipped, negative values are also accepted. + * * `int` **limit** - Number of results to return + * * `int` **max_id** - If a positive value was transferred, the method will return only messages with IDs less than **max\_id** + * * `int` **min_id** - If a positive value was transferred, the method will return only messages with IDs more than **min\_id** * * `[int]` **hash** - Optional: IDs of messages you already fetched * * @param array $params Parameters @@ -1262,20 +1268,20 @@ interface messages public function getHistory($params); /** - * Search peers or messages. + * Gets back found messages. * * Parameters: - * * `InputPeer` **peer** - Where to search - * * `string` **q** - What to search - * * `InputUser` **from_id** - Optional: Show only messages from a certain user? - * * `MessagesFilter` **filter** - Message filter - * * `int` **min_date** - Minumum date of results to fetch - * * `int` **max_date** - Maximum date of results to fetch - * * `int` **offset_id** - Message ID offset - * * `int` **add_offset** - Additional offset, can be 0 - * * `int` **limit** - Number of results to return - * * `int` **max_id** - Maximum message id to return - * * `int` **min_id** - Minumum message id to return + * * `InputPeer` **peer** - User or chat, histories with which are searched, or [(inputPeerEmpty)](../constructors/inputPeerEmpty.md) constructor for global search + * * `string` **q** - Text search request + * * `InputUser` **from_id** - Optional: Only return messages sent by the specified user ID + * * `MessagesFilter` **filter** - Filter to return only specified message types + * * `int` **min_date** - If a positive value was transferred, only messages with a sending date bigger than the transferred one will be returned + * * `int` **max_date** - If a positive value was transferred, only messages with a sending date smaller than the transferred one will be returned + * * `int` **offset_id** - Only return messages starting from the specified message ID + * * `int` **add_offset** - [Additional offset](https://core.telegram.org/api/offsets) + * * `int` **limit** - [Number of results to return](https://core.telegram.org/api/offsets) + * * `int` **max_id** - [Maximum message ID to return](https://core.telegram.org/api/offsets) + * * `int` **min_id** - [Minimum message ID to return](https://core.telegram.org/api/offsets) * * `[int]` **hash** - Optional: The IDs of messages you already fetched * * @param array $params Parameters @@ -1285,11 +1291,11 @@ interface messages public function search($params); /** - * Mark messages as read. + * Marks message history as read. * * Parameters: - * * `InputPeer` **peer** - Where to mark messages as read - * * `int` **max_id** - Maximum message ID to mark as read + * * `InputPeer` **peer** - Target user or group + * * `int` **max_id** - If a positive value is passed, only messages with identifiers less or equal than the given one will be read * * @param array $params Parameters * @@ -1298,13 +1304,13 @@ interface messages public function readHistory($params); /** - * Delete chat history. + * Deletes communication history. * * Parameters: - * * `boolean` **just_clear** - Optional: Only clear it from your side - * * `boolean` **revoke** - Optional: Delete messages for the other user - * * `InputPeer` **peer** - Where to clear it - * * `int` **max_id** - Maximum message id of messages to delete + * * `boolean` **just_clear** - Optional: Just clear history for the current user, without actually removing messages for every chat user + * * `boolean` **revoke** - Optional: Whether to delete the message history for all chat participants + * * `InputPeer` **peer** - User or chat, communication history of which will be deleted + * * `int` **max_id** - Maximum ID of message to delete * * @param array $params Parameters * @@ -1313,10 +1319,10 @@ interface messages public function deleteHistory($params); /** - * Delete messages. + * Deletes messages by their identifiers. * * Parameters: - * * `boolean` **revoke** - Optional: Delete the messages for everyone? + * * `boolean` **revoke** - Optional: Whether to delete messages for all participants of the chat * * `[int]` **id** - IDs of messages to delete, use channels->deleteMessages for supergroups * * @param array $params Parameters @@ -1326,10 +1332,10 @@ interface messages public function deleteMessages($params); /** - * Mark messages as read. + * Confirms receipt of messages by a client, cancels PUSH-notification sending. * * Parameters: - * * `int` **max_id** - Maximum message id of messages to mark as read + * * `int` **max_id** - Maximum message ID available in a client. * * @param array $params Parameters * @@ -1338,11 +1344,11 @@ interface messages public function receivedMessages($params); /** - * Change typing status. + * Sends a current user typing event (see [SendMessageAction](../types/SendMessageAction.md) for all event types) to a conversation partner or group. * * Parameters: - * * `InputPeer` **peer** - Where to change typing status - * * `SendMessageAction` **action** - Typing status + * * `InputPeer` **peer** - Target user or group + * * `SendMessageAction` **action** - Type of action
Parameter added in [Layer 17](https://core.telegram.org/api/layers#layer-17). * * @param array $params Parameters * @@ -1351,19 +1357,19 @@ interface messages public function setTyping($params); /** - * Send a message. + * Sends a message to a chat. * * Parameters: - * * `boolean` **no_webpage** - Optional: Disable webpage preview? - * * `boolean` **silent** - Optional: Disable notifications? - * * `boolean` **background** - Optional: Disable background notifications? - * * `boolean` **clear_draft** - Optional: Clear the message draft of this chat? - * * `InputPeer` **peer** - The chat where to send this message - * * `int` **reply_to_msg_id** - Optional: Reply to message by ID - * * `string` **message** - The message to send - * * `ReplyMarkup` **reply_markup** - Optional: Keyboards to send + * * `boolean` **no_webpage** - Optional: Set this flag to disable generation of the webpage preview + * * `boolean` **silent** - Optional: Send this message silently (no notifications for the receivers) + * * `boolean` **background** - Optional: Send this message as background message + * * `boolean` **clear_draft** - Optional: Clear the draft field + * * `InputPeer` **peer** - The destination where the message will be sent + * * `int` **reply_to_msg_id** - Optional: The message ID to which this message will reply to + * * `string` **message** - The message + * * `ReplyMarkup` **reply_markup** - Optional: Reply markup for sending bot buttons * * `[MessageEntity]` **entities** - Optional: Entities to send (for styled text) - * * `int` **schedule_date** - Optional: Schedule date + * * `int` **schedule_date** - Optional: Scheduled message date for scheduled messages * * @param array $params Parameters * @@ -1375,16 +1381,16 @@ interface messages * Send a media. * * Parameters: - * * `boolean` **silent** - Optional: Disable notifications? - * * `boolean` **background** - Optional: Disable background notifications? - * * `boolean` **clear_draft** - Optional: Clear the message draft of this chat? - * * `InputPeer` **peer** - Where to send the media - * * `int` **reply_to_msg_id** - Optional: Reply to message by ID - * * `InputMedia` **media** - The media to send - * * `string` **message** - The caption - * * `ReplyMarkup` **reply_markup** - Optional: Keyboards to send + * * `boolean` **silent** - Optional: Send message silently (no notification should be triggered) + * * `boolean` **background** - Optional: Send message in background + * * `boolean` **clear_draft** - Optional: Clear the draft + * * `InputPeer` **peer** - Destination + * * `int` **reply_to_msg_id** - Optional: Message ID to which this message should reply to + * * `InputMedia` **media** - Attached media + * * `string` **message** - Caption + * * `ReplyMarkup` **reply_markup** - Optional: Reply markup for bot keyboards * * `[MessageEntity]` **entities** - Optional: Entities for styled text - * * `int` **schedule_date** - Optional: Schedule date + * * `int` **schedule_date** - Optional: Scheduled message date for scheduled messages * * @param array $params Parameters * @@ -1393,17 +1399,17 @@ interface messages public function sendMedia($params); /** - * Forward messages. + * Forwards messages by their IDs. * * Parameters: - * * `boolean` **silent** - Optional: Disable notifications - * * `boolean` **background** - Optional: Disable background notifications - * * `boolean` **with_my_score** - Optional: If forwarding a game, forward your score, too - * * `boolean` **grouped** - Optional: Set to true if forwarding albums - * * `InputPeer` **from_peer** - From where to forward the messages + * * `boolean` **silent** - Optional: Whether to send messages silently (no notification will be triggered on the destination clients) + * * `boolean` **background** - Optional: Whether to send the message in background + * * `boolean` **with_my_score** - Optional: When forwarding games, whether to include your score in the game + * * `boolean` **grouped** - Optional: Whether the specified messages represent an album (grouped media) + * * `InputPeer` **from_peer** - Source of messages * * `[int]` **id** - The message IDs - * * `InputPeer` **to_peer** - Where to forward the messages - * * `int` **schedule_date** - Optional: Schedule date + * * `InputPeer` **to_peer** - Destination peer + * * `int` **schedule_date** - Optional: Scheduled message date for scheduled messages * * @param array $params Parameters * @@ -1412,10 +1418,10 @@ interface messages public function forwardMessages($params); /** - * Report a peer for spam. + * Report a new incoming chat for spam, if the [peer settings](../constructors/peerSettings.md) of the chat allow us to do that. * * Parameters: - * * `InputPeer` **peer** - The peer to report + * * `InputPeer` **peer** - Peer to report * * @param array $params Parameters * @@ -1424,7 +1430,7 @@ interface messages public function reportSpam($params); /** - * Get the settings of apeer. + * Get peer settings. * * Parameters: * * `InputPeer` **peer** - The peer @@ -1436,12 +1442,12 @@ interface messages public function getPeerSettings($params); /** - * Report a message. + * Report a message in a chat for violation of telegram's Terms of Service. * * Parameters: - * * `InputPeer` **peer** - The user that sent the messages + * * `InputPeer` **peer** - Peer * * `[int]` **id** - The messages to report - * * `ReportReason` **reason** - The reason why you're sending this report + * * `ReportReason` **reason** - Why are these messages being reported * * @param array $params Parameters * @@ -1450,7 +1456,7 @@ interface messages public function report($params); /** - * Get info about chats. + * Returns chat basic info on their IDs. * * Parameters: * * `[int]` **id** - The MTProto IDs of chats to fetch info about @@ -1462,7 +1468,7 @@ interface messages public function getChats($params); /** - * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info). + * Returns full chat info according to its ID. * * Parameters: * * `InputPeer` **chat_id** - You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info) @@ -1474,11 +1480,11 @@ interface messages public function getFullChat($params); /** - * Edit the title of a normal chat (not supergroup). + * Chanages chat name and sends a service message on it. * * Parameters: * * `InputPeer` **chat_id** - The ID of the chat - * * `string` **title** - The new title + * * `string` **title** - New chat name, different from the old one * * @param array $params Parameters * @@ -1487,11 +1493,11 @@ interface messages public function editChatTitle($params); /** - * Edit the photo of a normal chat (not supergroup). + * Changes chat photo and sends a service message on it. * * Parameters: * * `InputPeer` **chat_id** - The ID of the chat - * * `InputChatPhoto` **photo** - The new phto + * * `InputChatPhoto` **photo** - Photo to be set * * @param array $params Parameters * @@ -1500,12 +1506,12 @@ interface messages public function editChatPhoto($params); /** - * Add a user to a normal chat (use channels->inviteToChannel for supergroups). + * Adds a user to a chat and sends a service message on it. * * Parameters: * * `InputPeer` **chat_id** - The chat where to invite users - * * `InputUser` **user_id** - The user to invite - * * `int` **fwd_limit** - Number of old messages the user will see + * * `InputUser` **user_id** - User ID to be added + * * `int` **fwd_limit** - Number of last messages to be forwarded * * @param array $params Parameters * @@ -1514,11 +1520,11 @@ interface messages public function addChatUser($params); /** - * Delete a user from a chat (not supergroup). + * Deletes a user from a chat and sends a service message on it. * * Parameters: * * `InputPeer` **chat_id** - The ID of the chat - * * `InputUser` **user_id** - The user to delete (pass @me to leave the chat) + * * `InputUser` **user_id** - User ID to be deleted * * @param array $params Parameters * @@ -1527,11 +1533,11 @@ interface messages public function deleteChatUser($params); /** - * Create a chat (not supergroup). + * Creates a new chat. * * Parameters: * * `[InputUser]` **users** - The users to add to the chat - * * `string` **title** - The new chat's title + * * `string` **title** - Chat name * * @param array $params Parameters * @@ -1540,11 +1546,11 @@ interface messages public function createChat($params); /** - * You cannot use this method directly, instead use $MadelineProto->getDhConfig();. + * Returns configuration parameters for Diffie-Hellman key generation. Can also return a random sequence of bytes of required length. * * Parameters: - * * `int` **version** - You cannot use this method directly, instead use $MadelineProto->getDhConfig(); - * * `int` **random_length** - You cannot use this method directly, instead use $MadelineProto->getDhConfig(); + * * `int` **version** - Value of the **version** parameter from [messages.dhConfig](../constructors/messages.dhConfig.md), avialable at the client + * * `int` **random_length** - Length of the required random sequence * * @param array $params Parameters * @@ -1553,11 +1559,11 @@ interface messages public function getDhConfig($params); /** - * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats. + * Sends a request to start a secret chat to the user. * * Parameters: - * * `InputUser` **user_id** - You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats - * * `bytes` **g_a** - You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats + * * `InputUser` **user_id** - User ID + * * `bytes` **g_a** - `A = g ^ a mod p`, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange) * * @param array $params Parameters * @@ -1566,12 +1572,12 @@ interface messages public function requestEncryption($params); /** - * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats. + * Confirms creation of a secret chat. * * Parameters: - * * `InputEncryptedChat` **peer** - You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats - * * `bytes` **g_b** - You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats - * * `long` **key_fingerprint** - You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats + * * `InputEncryptedChat` **peer** - Secret chat ID + * * `bytes` **g_b** - `B = g ^ b mod p`, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange) + * * `long` **key_fingerprint** - 64-bit fingerprint of the received key * * @param array $params Parameters * @@ -1580,10 +1586,10 @@ interface messages public function acceptEncryption($params); /** - * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats. + * Cancels a request for creation and/or delete info on secret chat. * * Parameters: - * * `int` **chat_id** - You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats + * * `int` **chat_id** - Secret chat ID * * @param array $params Parameters * @@ -1592,11 +1598,11 @@ interface messages public function discardEncryption($params); /** - * Send typing notification to secret chat. + * Send typing event by the current user to a secret chat. * * Parameters: - * * `InputEncryptedChat` **peer** - The secret chat where to send the notification - * * `Bool` **typing** - Set to true to enable the notification, false to disable it + * * `InputEncryptedChat` **peer** - Secret chat ID + * * `Bool` **typing** - Typing.
**Possible values**:
[(boolTrue)](../constructors/boolTrue.md), if the user started typing and more than **5 seconds** have passed since the last request
[(boolFalse)](../constructors/boolFalse.md), if the user stopped typing * * @param array $params Parameters * @@ -1605,11 +1611,11 @@ interface messages public function setEncryptedTyping($params); /** - * Mark messages as read in secret chats. + * Marks message history within a secret chat as read. * * Parameters: - * * `InputEncryptedChat` **peer** - The secret chat where to mark messages as read - * * `int` **max_date** - Maximum date of messages to mark + * * `InputEncryptedChat` **peer** - Secret chat ID + * * `int` **max_date** - Maximum date value for received messages in history * * @param array $params Parameters * @@ -1618,10 +1624,10 @@ interface messages public function readEncryptedHistory($params); /** - * Send message to secret chat. + * Sends a text message to a secret chat. * * Parameters: - * * `InputEncryptedChat` **peer** - The chat where to send the message + * * `InputEncryptedChat` **peer** - Secret chat ID * * `DecryptedMessage` **message** - The message to send * * @param array $params Parameters @@ -1631,12 +1637,12 @@ interface messages public function sendEncrypted($params); /** - * Send a file to a secret chat. + * Sends a message with a file attachment to a secret chat. * * Parameters: - * * `InputEncryptedChat` **peer** - The chat where to send the file + * * `InputEncryptedChat` **peer** - Secret chat ID * * `DecryptedMessage` **message** - The message with the file - * * `InputEncryptedFile` **file** - The file (optional) + * * `InputEncryptedFile` **file** - File attachment for the secret chat * * @param array $params Parameters * @@ -1645,10 +1651,10 @@ interface messages public function sendEncryptedFile($params); /** - * Send a service message to a secret chat. + * Sends a service message to a secret chat. * * Parameters: - * * `InputEncryptedChat` **peer** - The chat where to send the service message + * * `InputEncryptedChat` **peer** - Secret chat ID * * `DecryptedMessage` **message** - The service message * * @param array $params Parameters @@ -1658,10 +1664,10 @@ interface messages public function sendEncryptedService($params); /** - * You cannot use this method directly. + * Confirms receipt of messages in a secret chat by client, cancels push notifications. * * Parameters: - * * `int` **max_qts** - You cannot use this method directly + * * `int` **max_qts** - Maximum qts value available at the client * * @param array $params Parameters * @@ -1670,10 +1676,10 @@ interface messages public function receivedQueue($params); /** - * Report for spam a secret chat. + * Report a secret chat for spam. * * Parameters: - * * `InputEncryptedChat` **peer** - The chat to report + * * `InputEncryptedChat` **peer** - The secret chat to report * * @param array $params Parameters * @@ -1682,7 +1688,7 @@ interface messages public function reportEncryptedSpam($params); /** - * Mark message as read. + * Notifies the sender about the recipient having listened a voice message or watched a video. * * Parameters: * * `[int]` **id** - The messages to mark as read (only users and normal chats, not supergroups) @@ -1694,10 +1700,10 @@ interface messages public function readMessageContents($params); /** - * Get stickers. + * Get stickers by emoji. * * Parameters: - * * `string` **emoticon** - Search by emoji + * * `string` **emoticon** - The emoji * * `[int]` **hash** - Optional: the hash parameter of the previous result of this method * * @param array $params Parameters @@ -1707,7 +1713,7 @@ interface messages public function getStickers($params); /** - * Get all stickerpacks. + * Get all installed stickers. * * Parameters: * * `[int]` **hash** - Optional: The hash parameter of the previous result of this method @@ -1719,10 +1725,10 @@ interface messages public function getAllStickers($params); /** - * Get webpage preview. + * Get preview of webpage. * * Parameters: - * * `string` **message** - Extract preview from this message + * * `string` **message** - Message from which to extract the preview * * `[MessageEntity]` **entities** - Optional: Entities for styled text * * @param array $params Parameters @@ -1732,10 +1738,10 @@ interface messages public function getWebPagePreview($params); /** - * Export chat invite. + * Export an invite link for a chat. * * Parameters: - * * `InputPeer` **peer** - Export invite only for this user + * * `InputPeer` **peer** - Chat * * @param array $params Parameters * @@ -1744,10 +1750,10 @@ interface messages public function exportChatInvite($params); /** - * Check if an invitation link is valid. + * Check the validity of a chat invite link and get basic info about it. * * Parameters: - * * `string` **hash** - The invite link in t.me/joinchat/aflakf format + * * `string` **hash** - Invite hash in `t.me/joinchat/hash` * * @param array $params Parameters * @@ -1756,10 +1762,10 @@ interface messages public function checkChatInvite($params); /** - * Import chat invite. + * Import a chat invite and join a private chat/supergroup/channel. * * Parameters: - * * `string` **hash** - The invite link in t.me/joinchat/aflakf format + * * `string` **hash** - `hash` from `t.me/joinchat/hash` * * @param array $params Parameters * @@ -1768,10 +1774,10 @@ interface messages public function importChatInvite($params); /** - * Get a stickerset. + * Get info about a stickerset. * * Parameters: - * * `InputStickerSet` **stickerset** - The stickerset to get + * * `InputStickerSet` **stickerset** - Stickerset * * @param array $params Parameters * @@ -1780,11 +1786,11 @@ interface messages public function getStickerSet($params); /** - * Add a sticker set. + * Install a stickerset. * * Parameters: - * * `InputStickerSet` **stickerset** - The sticker set to add - * * `Bool` **archived** - Archive this set? + * * `InputStickerSet` **stickerset** - Stickerset to install + * * `Bool` **archived** - Whether to archive stickerset * * @param array $params Parameters * @@ -1793,10 +1799,10 @@ interface messages public function installStickerSet($params); /** - * Remove a sticker set. + * Uninstall a stickerset. * * Parameters: - * * `InputStickerSet` **stickerset** - The sticker set to remove + * * `InputStickerSet` **stickerset** - The stickerset to uninstall * * @param array $params Parameters * @@ -1805,12 +1811,12 @@ interface messages public function uninstallStickerSet($params); /** - * Start a bot. + * Start a conversation with a bot using a [deep linking parameter](https://core.telegram.org/bots#deep-linking). * * Parameters: - * * `InputUser` **bot** - The bot's ID or username - * * `InputPeer` **peer** - Where to start the bot (@me or group ID/username) - * * `string` **start_param** - The bot's start parameter + * * `InputUser` **bot** - The bot + * * `InputPeer` **peer** - The chat where to start the bot, can be the bot's private chat or a group + * * `string` **start_param** - [Deep linking parameter](https://core.telegram.org/bots#deep-linking) * * @param array $params Parameters * @@ -1819,12 +1825,12 @@ interface messages public function startBot($params); /** - * Get and increase message views. + * Get and increase the view counter of a message sent or forwarded from a [channel](https://core.telegram.org/api/channel). * * Parameters: - * * `InputPeer` **peer** - The chat where the message is located + * * `InputPeer` **peer** - Peer where the message was found * * `[int]` **id** - The IDs messages to get - * * `Bool` **increment** - Increase message views? + * * `Bool` **increment** - Whether to mark the message as viewed and increment the view counter * * @param array $params Parameters * @@ -1833,12 +1839,12 @@ interface messages public function getMessagesViews($params); /** - * Edit admin permissions. + * Make a user admin in a [legacy group](https://core.telegram.org/api/channel). * * Parameters: * * `InputPeer` **chat_id** - The chat ID (no supergroups) - * * `InputUser` **user_id** - The user ID - * * `Bool` **is_admin** - Should the user be admin? + * * `InputUser` **user_id** - The user to make admin + * * `Bool` **is_admin** - Whether to make him admin * * @param array $params Parameters * @@ -1847,7 +1853,7 @@ interface messages public function editChatAdmin($params); /** - * Convert chat to supergroup. + * Turn a [legacy group into a supergroup](https://core.telegram.org/api/channel). * * Parameters: * * `InputPeer` **chat_id** - The chat to convert @@ -1859,15 +1865,15 @@ interface messages public function migrateChat($params); /** - * Global message search. + * Search for messages and peers globally. * * Parameters: - * * `int` **folder_id** - Optional: Folder ID - * * `string` **q** - The query - * * `int` **offset_rate** - Offset rate - * * `InputPeer` **offset_peer** - 0 or the peer offset - * * `int` **offset_id** - 0 or the message ID offset - * * `int` **limit** - The number of results to return + * * `int` **folder_id** - Optional: Folder where to search + * * `string` **q** - Query + * * `int` **offset_rate** - Initially 0, then set to the [`next_rate` parameter of messages.messagesSlice](../constructors/messages.messagesSlice.md) + * * `InputPeer` **offset_peer** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) + * * `int` **offset_id** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) + * * `int` **limit** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) * * @param array $params Parameters * @@ -1876,10 +1882,10 @@ interface messages public function searchGlobal($params); /** - * Reorder sticker sets. + * Reorder installed stickersets. * * Parameters: - * * `boolean` **masks** - Optional: Reorder masks? + * * `boolean` **masks** - Optional: Reorder mask stickersets * * `[long]` **order** - The order * * @param array $params Parameters @@ -1889,12 +1895,12 @@ interface messages public function reorderStickerSets($params); /** - * Get document by SHA256 hash. + * Get a document by its SHA256 hash, mainly used for gifs. * * Parameters: - * * `bytes` **sha256** - `hash('sha256', $filename, true);` - * * `int` **size** - The file size - * * `string` **mime_type** - The mime type of the file + * * `bytes` **sha256** - SHA256 of file + * * `int` **size** - Size of the file in bytes + * * `string` **mime_type** - Mime type * * @param array $params Parameters * @@ -1903,11 +1909,11 @@ interface messages public function getDocumentByHash($params); /** - * Search gifs. + * Search for GIFs. * * Parameters: - * * `string` **q** - The search query - * * `int` **offset** - The offset + * * `string` **q** - Text query + * * `int` **offset** - Offset for [pagination »](https://core.telegram.org/api/offsets) * * @param array $params Parameters * @@ -1916,7 +1922,7 @@ interface messages public function searchGifs($params); /** - * Get saved gifs. + * Get saved GIFs. * * Parameters: * * `[int]` **hash** - Optional: the hash parameter of the previous result of this method @@ -1928,11 +1934,11 @@ interface messages public function getSavedGifs($params); /** - * Save a GIF. + * Add GIF to saved gifs list. * * Parameters: - * * `InputDocument` **id** - The GIF to save - * * `Bool` **unsave** - Remove the gif? + * * `InputDocument` **id** - GIF to save + * * `Bool` **unsave** - Whether to remove GIF from saved gifs list * * @param array $params Parameters * @@ -1941,14 +1947,14 @@ interface messages public function saveGif($params); /** - * Call inline bot. + * Query an inline bot. * * Parameters: - * * `InputUser` **bot** - The bot to call - * * `InputPeer` **peer** - The chat where to call the bot - * * `InputGeoPoint` **geo_point** - Optional: The current location - * * `string` **query** - The query to send to the bot - * * `string` **offset** - The offset to send to the bot + * * `InputUser` **bot** - The bot to query + * * `InputPeer` **peer** - The currently opened chat + * * `InputGeoPoint` **geo_point** - Optional: The geolocation, if requested + * * `string` **query** - The query + * * `string` **offset** - The offset within the results, will be passed directly as-is to the bot. * * @param array $params Parameters * @@ -1957,16 +1963,16 @@ interface messages public function getInlineBotResults($params); /** - * Bots only: set the results of an inline query. + * Answer an inline query, for bots only. * * Parameters: - * * `boolean` **gallery** - Optional: Is this a gallery? - * * `boolean` **private** - Optional: Is this result private (not cached)? - * * `long` **query_id** - Query ID + * * `boolean` **gallery** - Optional: Set this flag if the results are composed of media files + * * `boolean` **private** - Optional: Set this flag if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query + * * `long` **query_id** - Unique identifier for the answered query * * `[InputBotInlineResult]` **results** - Results - * * `int` **cache_time** - Cache time - * * `string` **next_offset** - Optional: The next offset - * * `InlineBotSwitchPM` **switch_pm** - Optional: Switch to PM? + * * `int` **cache_time** - The maximum amount of time in seconds that the result of the inline query may be cached on the server. Defaults to 300. + * * `string` **next_offset** - Optional: Pass the offset that a client should send in the next query with the same text to receive more results. Pass an empty string if there are no more results or if you don‘t support pagination. Offset length can’t exceed 64 bytes. + * * `InlineBotSwitchPM` **switch_pm** - Optional: If passed, clients will display a button with specified text that switches the user to a private chat with the bot and sends the bot a start message with a certain parameter. * * @param array $params Parameters * @@ -1975,18 +1981,18 @@ interface messages public function setInlineBotResults($params); /** - * Send inline bot result obtained with messages.getInlineBotResults to the chat. + * Send a result obtained using [messages.getInlineBotResults](../methods/messages.getInlineBotResults.md). * * Parameters: - * * `boolean` **silent** - Optional: Disable notifications? - * * `boolean` **background** - Optional: Disable background notifications? - * * `boolean` **clear_draft** - Optional: Clear the message draft? - * * `boolean` **hide_via** - Optional: Hide "via @bot" - * * `InputPeer` **peer** - Where to send the message - * * `int` **reply_to_msg_id** - Optional: Reply to message by ID - * * `long` **query_id** - The inline query ID - * * `string` **id** - The ID of one of the inline results - * * `int` **schedule_date** - Optional: Schedule date + * * `boolean` **silent** - Optional: Whether to send the message silently (no notification will be triggered on the other client) + * * `boolean` **background** - Optional: Whether to send the message in background + * * `boolean` **clear_draft** - Optional: Whether to clear the [draft](https://core.telegram.org/api/drafts) + * * `boolean` **hide_via** - Optional: Whether to hide the `via @botname` in the resulting message (only for bot usernames encountered in the [config](../constructors/config.md)) + * * `InputPeer` **peer** - Destination + * * `int` **reply_to_msg_id** - Optional: ID of the message this message should reply to + * * `long` **query_id** - Query ID from [messages.getInlineBotResults](../methods/messages.getInlineBotResults.md) + * * `string` **id** - Result ID from [messages.getInlineBotResults](../methods/messages.getInlineBotResults.md) + * * `int` **schedule_date** - Optional: Scheduled message date for scheduled messages * * @param array $params Parameters * @@ -1995,11 +2001,11 @@ interface messages public function sendInlineBotResult($params); /** - * Check if about to edit a message or a media caption. + * Find out if a media message's caption can be edited. * * Parameters: - * * `InputPeer` **peer** - The chat - * * `int` **id** - The message ID + * * `InputPeer` **peer** - Peer where the media was sent + * * `int` **id** - ID of message * * @param array $params Parameters * @@ -2008,17 +2014,17 @@ interface messages public function getMessageEditData($params); /** - * Edit a message. + * Edit message. * * Parameters: * * `boolean` **no_webpage** - Optional: Disable webpage preview - * * `InputPeer` **peer** - The chat - * * `int` **id** - The message ID - * * `string` **message** - Optional: The new message - * * `InputMedia` **media** - Optional: The media to substitute - * * `ReplyMarkup` **reply_markup** - Optional: The new keyboard + * * `InputPeer` **peer** - Where was the message sent + * * `int` **id** - ID of the message to edit + * * `string` **message** - Optional: New message + * * `InputMedia` **media** - Optional: New attached media + * * `ReplyMarkup` **reply_markup** - Optional: Reply markup for inline keyboards * * `[MessageEntity]` **entities** - Optional: The new entities (for styled text) - * * `int` **schedule_date** - Optional: Schedule date + * * `int` **schedule_date** - Optional: Scheduled message date for scheduled messages * * @param array $params Parameters * @@ -2027,14 +2033,14 @@ interface messages public function editMessage($params); /** - * Edit a sent inline message. + * Edit an inline bot message. * * Parameters: * * `boolean` **no_webpage** - Optional: Disable webpage preview - * * `InputBotInlineMessageID` **id** - The message ID - * * `string` **message** - Optional: The new message - * * `InputMedia` **media** - Optional: The media to substitute - * * `ReplyMarkup` **reply_markup** - Optional: The new keyboard + * * `InputBotInlineMessageID` **id** - Sent inline message ID + * * `string` **message** - Optional: Message + * * `InputMedia` **media** - Optional: Media + * * `ReplyMarkup` **reply_markup** - Optional: Reply markup for inline keyboards * * `[MessageEntity]` **entities** - Optional: The new entities (for styled text) * * @param array $params Parameters @@ -2044,13 +2050,13 @@ interface messages public function editInlineBotMessage($params); /** - * Get the callback answer of a bot (after clicking a button). + * Press an inline callback button and get a callback answer from the bot. * * Parameters: - * * `boolean` **game** - Optional: Is this a game? - * * `InputPeer` **peer** - The chat - * * `int` **msg_id** - The message ID - * * `bytes` **data** - Optional: The data to send to the bot + * * `boolean` **game** - Optional: Whether this is a "play game" button + * * `InputPeer` **peer** - Where was the inline keyboard sent + * * `int` **msg_id** - ID of the Message with the inline keyboard + * * `bytes` **data** - Optional: Callback data * * @param array $params Parameters * @@ -2059,14 +2065,14 @@ interface messages public function getBotCallbackAnswer($params); /** - * Bots only: set the callback answer (after a button was clicked). + * Set the callback answer to a user button press (bots only). * * Parameters: - * * `boolean` **alert** - Optional: Is this an alert? - * * `long` **query_id** - The query ID - * * `string` **message** - Optional: The message - * * `string` **url** - Optional: The URL - * * `int` **cache_time** - Cache time + * * `boolean` **alert** - Optional: Whether to show the message as a popup instead of a toast notification + * * `long` **query_id** - Query ID + * * `string` **message** - Optional: Popup to show + * * `string` **url** - Optional: URL to open + * * `int` **cache_time** - Cache validity * * @param array $params Parameters * @@ -2075,7 +2081,7 @@ interface messages public function setBotCallbackAnswer($params); /** - * Get dialog info of peers. + * Get dialog info of specified peers. * * Parameters: * * `[InputDialogPeer]` **peers** - The peers @@ -2087,13 +2093,13 @@ interface messages public function getPeerDialogs($params); /** - * Save a message draft. + * Save a message [draft](https://core.telegram.org/api/drafts) associated to a chat. * * Parameters: - * * `boolean` **no_webpage** - Optional: Disable webpage preview - * * `int` **reply_to_msg_id** - Optional: Reply to message by ID - * * `InputPeer` **peer** - The chat - * * `string` **message** - The message + * * `boolean` **no_webpage** - Optional: Disable generation of the webpage preview + * * `int` **reply_to_msg_id** - Optional: Message ID the message should reply to + * * `InputPeer` **peer** - Destination of the message that should be sent + * * `string` **message** - The draft * * `[MessageEntity]` **entities** - Optional: The entities (for styled text) * * @param array $params Parameters @@ -2103,7 +2109,7 @@ interface messages public function saveDraft($params); /** - * Get all message drafts. + * Save get all message [drafts](https://core.telegram.org/api/drafts). * * @return Updates */ @@ -2137,7 +2143,7 @@ interface messages * Get recent stickers. * * Parameters: - * * `boolean` **attached** - Optional: Get stickers attached to image? + * * `boolean` **attached** - Optional: Get stickers recently attached to photo or video files * * `[int]` **hash** - Optional: IDs the hash parameter of the previous result of this method * * @param array $params Parameters @@ -2147,12 +2153,12 @@ interface messages public function getRecentStickers($params); /** - * Add a sticker to recent stickers. + * Add/remove sticker from recent stickers list. * * Parameters: - * * `boolean` **attached** - Optional: Get stickers attached to image? - * * `InputDocument` **id** - The sticker - * * `Bool` **unsave** - Remove the sticker from recent stickers? + * * `boolean` **attached** - Optional: Whether to add/remove stickers recently attached to photo or video files + * * `InputDocument` **id** - Sticker + * * `Bool` **unsave** - Whether to save or unsave the sticker * * @param array $params Parameters * @@ -2161,10 +2167,10 @@ interface messages public function saveRecentSticker($params); /** - * Clear all recent stickers. + * Clear recent stickers. * * Parameters: - * * `boolean` **attached** - Optional: Clear recent stickers attached to images? + * * `boolean` **attached** - Optional: Set this flag to clear the list of stickers recently attached to photo or video files * * @param array $params Parameters * @@ -2176,9 +2182,9 @@ interface messages * Get all archived stickers. * * Parameters: - * * `boolean` **masks** - Optional: Get masks? - * * `long` **offset_id** - Sticker ID offset - * * `int` **limit** - Number of stickers to fetch + * * `boolean` **masks** - Optional: Get mask stickers + * * `long` **offset_id** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) + * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * @@ -2187,7 +2193,7 @@ interface messages public function getArchivedStickers($params); /** - * Get masks. + * Get installed mask stickers. * * Parameters: * * `[int]` **hash** - Optional: the hash parameter of the previous result of this method @@ -2199,10 +2205,10 @@ interface messages public function getMaskStickers($params); /** - * Get stickers attachable to images. + * Get stickers attached to a photo or video. * * Parameters: - * * `InputStickeredMedia` **media** - The stickered media + * * `InputStickeredMedia` **media** - Stickered media * * @param array $params Parameters * @@ -2211,15 +2217,15 @@ interface messages public function getAttachedStickers($params); /** - * Set the game score. + * Use this method to set the score of the specified user in a game sent as a normal message (bots only). * * Parameters: - * * `boolean` **edit_message** - Optional: Should the message with the game be edited? - * * `boolean` **force** - Optional: Force setting the game score - * * `InputPeer` **peer** - The chat where the game was sent - * * `int` **id** - The message ID - * * `InputUser` **user_id** - The user that set the score - * * `int` **score** - The score + * * `boolean` **edit_message** - Optional: Set this flag if the game message should be automatically edited to include the current scoreboard + * * `boolean` **force** - Optional: Set this flag if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters + * * `InputPeer` **peer** - Unique identifier of target chat + * * `int` **id** - Identifier of the sent message + * * `InputUser` **user_id** - User identifier + * * `int` **score** - New score * * @param array $params Parameters * @@ -2228,14 +2234,14 @@ interface messages public function setGameScore($params); /** - * Set the game score of an inline message. + * Use this method to set the score of the specified user in a game sent as an inline message (bots only). * * Parameters: - * * `boolean` **edit_message** - Optional: Should the message with the game be edited? - * * `boolean` **force** - Optional: Force setting the game score - * * `InputBotInlineMessageID` **id** - The ID of the inline message - * * `InputUser` **user_id** - The user that set the score - * * `int` **score** - The score + * * `boolean` **edit_message** - Optional: Set this flag if the game message should be automatically edited to include the current scoreboard + * * `boolean` **force** - Optional: Set this flag if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters + * * `InputBotInlineMessageID` **id** - ID of the inline message + * * `InputUser` **user_id** - User identifier + * * `int` **score** - New score * * @param array $params Parameters * @@ -2244,12 +2250,12 @@ interface messages public function setInlineGameScore($params); /** - * Get high scores of a game. + * Get highscores of a game. * * Parameters: - * * `InputPeer` **peer** - The chat - * * `int` **id** - The message ID - * * `InputUser` **user_id** - The user that set the high scores + * * `InputPeer` **peer** - Where was the game sent + * * `int` **id** - ID of message with game media attachment + * * `InputUser` **user_id** - Get high scores made by a certain user * * @param array $params Parameters * @@ -2258,11 +2264,11 @@ interface messages public function getGameHighScores($params); /** - * Get high scores of a game sent in an inline message. + * Get highscores of a game sent using an inline bot. * * Parameters: - * * `InputBotInlineMessageID` **id** - The inline message - * * `InputUser` **user_id** - The user that set the high scores + * * `InputBotInlineMessageID` **id** - ID of inline message + * * `InputUser` **user_id** - Get high scores of a certain user * * @param array $params Parameters * @@ -2274,9 +2280,9 @@ interface messages * Get chats in common with a user. * * Parameters: - * * `InputUser` **user_id** - The user - * * `int` **max_id** - The maximum chat ID to fetch - * * `int` **limit** - Number of results to fetch + * * `InputUser` **user_id** - User ID + * * `int` **max_id** - Maximum ID of chat to return (see [pagination](https://core.telegram.org/api/offsets)) + * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * @@ -2285,7 +2291,7 @@ interface messages public function getCommonChats($params); /** - * Get all chats (not supergroups or channels). + * Get all chats, channels and supergroups. * * Parameters: * * `[int]` **except_ids** - Do not fetch these chats (MTProto id) @@ -2297,10 +2303,10 @@ interface messages public function getAllChats($params); /** - * Get webpage preview. + * Get [instant view](https://instantview.telegram.org) page. * * Parameters: - * * `string` **url** - URL + * * `string` **url** - URL of IV page to fetch * * `[int]` **hash** - Optional: the hash parameter of the previous result of this method * * @param array $params Parameters @@ -2310,10 +2316,10 @@ interface messages public function getWebPage($params); /** - * Pin or unpin dialog. + * Pin/unpin a dialog. * * Parameters: - * * `boolean` **pinned** - Optional: Pin or unpin the dialog? + * * `boolean` **pinned** - Optional: Whether to pin or unpin the dialog * * `InputDialogPeer` **peer** - The dialog to pin * * @param array $params Parameters @@ -2326,7 +2332,7 @@ interface messages * Reorder pinned dialogs. * * Parameters: - * * `boolean` **force** - Optional: Force reordering + * * `boolean` **force** - Optional: If set, dialogs pinned server-side but not present in the `order` field will be unpinned. * * `int` **folder_id** - Folder ID * * `[InputDialogPeer]` **order** - New order * @@ -2349,11 +2355,11 @@ interface messages public function getPinnedDialogs($params); /** - * Bots only: set shipping results. + * If you sent an invoice requesting a shipping address and the parameter is\_flexible was specified, the bot will receive an [updateBotShippingQuery](../constructors/updateBotShippingQuery.md) update. Use this method to reply to shipping queries. * * Parameters: - * * `long` **query_id** - Query ID - * * `string` **error** - Optional: Error + * * `long` **query_id** - Unique identifier for the query to be answered + * * `string` **error** - Optional: Error message in human readable form that explains why it is impossible to complete the order (e.g. "Sorry, delivery to your desired address is unavailable'). Telegram will display this message to the user. * * `[ShippingOption]` **shipping_options** - Optional: Shipping options * * @param array $params Parameters @@ -2363,12 +2369,14 @@ interface messages public function setBotShippingResults($params); /** - * Bots only: set precheckout results. + * Once the user has confirmed their payment and shipping details, the bot receives an [updateBotPrecheckoutQuery](../constructors/updateBotPrecheckoutQuery.md) update. +Use this method to respond to such pre-checkout queries. +**Note**: Telegram must receive an answer within 10 seconds after the pre-checkout query was sent. * * Parameters: - * * `boolean` **success** - Optional: Success? - * * `long` **query_id** - Query ID - * * `string` **error** - Optional: Error + * * `boolean` **success** - Optional: Set this flag if everything is alright (goods are available, etc.) and the bot is ready to proceed with the order, otherwise do not set it, and set the `error` field, instead + * * `long` **query_id** - Unique identifier for the query to be answered + * * `string` **error** - Optional: Required if the `success` isn't set. Error message in human readable form that explains the reason for failure to proceed with the checkout (e.g. "Sorry, somebody just bought the last of our amazing black T-shirts while you were busy filling out your payment details. Please choose a different color or garment!"). Telegram will display this message to the user. * * @param array $params Parameters * @@ -2377,11 +2385,11 @@ interface messages public function setBotPrecheckoutResults($params); /** - * Upload a file without sending it to anyone. + * Upload a file and associate it to a chat (without actually sending it to the chat). * * Parameters: - * * `InputPeer` **peer** - Nothing - * * `InputMedia` **media** - The media to upload + * * `InputPeer` **peer** - The chat, can be an [inputPeerEmpty](../constructors/inputPeerEmpty.md) for bots + * * `InputMedia` **media** - File uploaded in chunks as described in [files »](https://core.telegram.org/api/files) * * @param array $params Parameters * @@ -2390,11 +2398,11 @@ interface messages public function uploadMedia($params); /** - * Send screenshot notification. + * Notify the other user in a private chat that a screenshot of the chat was taken. * * Parameters: - * * `InputPeer` **peer** - Where to send the notification - * * `int` **reply_to_msg_id** - Reply to message by ID + * * `InputPeer` **peer** - Other user + * * `int` **reply_to_msg_id** - ID of message that was screenshotted, can be 0 * * @param array $params Parameters * @@ -2403,7 +2411,7 @@ interface messages public function sendScreenshotNotification($params); /** - * Get favorite stickers. + * Get faved stickers. * * Parameters: * * `[int]` **hash** - Optional: the hash parameter of the previous result of this method @@ -2415,11 +2423,11 @@ interface messages public function getFavedStickers($params); /** - * Add a sticker to favorites. + * Mark a sticker as favorite. * * Parameters: - * * `InputDocument` **id** - The sticker to add to favorites - * * `Bool` **unfave** - Remove it from favorites? + * * `InputDocument` **id** - Sticker to mark as favorite + * * `Bool` **unfave** - Unfavorite * * @param array $params Parameters * @@ -2428,15 +2436,15 @@ interface messages public function faveSticker($params); /** - * Get unread mentions. + * Get unread messages where we were mentioned. * * Parameters: - * * `InputPeer` **peer** - The chat where to get unread mentions - * * `int` **offset_id** - The offset - * * `int` **add_offset** - The additional offset - * * `int` **limit** - The number of results to fetch - * * `int` **max_id** - The maximum message ID to fetch - * * `int` **min_id** - The minumum message ID to fetch + * * `InputPeer` **peer** - Peer where to look for mentions + * * `int` **offset_id** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) + * * `int` **add_offset** - [Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets) + * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) + * * `int` **max_id** - Maximum message ID to return, [see pagination](https://core.telegram.org/api/offsets) + * * `int` **min_id** - Minimum message ID to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * @@ -2448,7 +2456,7 @@ interface messages * Mark mentions as read. * * Parameters: - * * `InputPeer` **peer** - The chat + * * `InputPeer` **peer** - Dialog * * @param array $params Parameters * @@ -2457,11 +2465,11 @@ interface messages public function readMentions($params); /** - * Get recent locations. + * Get live location history of a certain user. * * Parameters: - * * `InputPeer` **peer** - The chat where to search locations - * * `int` **limit** - Number of results to return + * * `InputPeer` **peer** - User + * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * `[int]` **hash** - Optional: IDs of locations you already fetched * * @param array $params Parameters @@ -2471,16 +2479,16 @@ interface messages public function getRecentLocations($params); /** - * Send an album. + * Send an album of media. * * Parameters: - * * `boolean` **silent** - Optional: Disable notifications? - * * `boolean` **background** - Optional: Disable background notification? - * * `boolean` **clear_draft** - Optional: Clear draft? - * * `InputPeer` **peer** - Where to send the album - * * `int` **reply_to_msg_id** - Optional: Reply to message by ID + * * `boolean` **silent** - Optional: Whether to send the album silently (no notification triggered) + * * `boolean` **background** - Optional: Send in background? + * * `boolean` **clear_draft** - Optional: Whether to clear [drafts](https://core.telegram.org/api/drafts) + * * `InputPeer` **peer** - The destination chat + * * `int` **reply_to_msg_id** - Optional: The message to reply to * * `[InputSingleMedia]` **multi_media** - The album - * * `int` **schedule_date** - Optional: Schedule date + * * `int` **schedule_date** - Optional: Scheduled message date for scheduled messages * * @param array $params Parameters * @@ -2489,10 +2497,10 @@ interface messages public function sendMultiMedia($params); /** - * Upload a secret chat file without sending it to anyone. + * Upload encrypted file and associate it to a secret chat. * * Parameters: - * * `InputEncryptedChat` **peer** - The chat where to upload the media + * * `InputEncryptedChat` **peer** - The secret chat to associate the file to * * `InputEncryptedFile` **file** - The file * * @param array $params Parameters @@ -2502,11 +2510,11 @@ interface messages public function uploadEncryptedFile($params); /** - * Find a sticker set. + * Search for stickersets. * * Parameters: - * * `boolean` **exclude_featured** - Optional: Exclude featured sticker sets from the search? - * * `string` **q** - The search query + * * `boolean` **exclude_featured** - Optional: Exclude featured stickersets from results + * * `string` **q** - Query string * * `[int]` **hash** - Optional: The IDs of stickersets you already fetched * * @param array $params Parameters @@ -2516,18 +2524,18 @@ interface messages public function searchStickerSets($params); /** - * Get message ranges to fetch. + * Get message ranges for saving the user's chat history. * * @return of MessageRange[] */ public function getSplitRanges(); /** - * Mark dialog as unread. + * Manually mark dialog as unread. * * Parameters: - * * `boolean` **unread** - Optional: Should it be marked or unmarked as read - * * `InputDialogPeer` **peer** - The dialog to mark as unread + * * `boolean` **unread** - Optional: Mark as unread/read + * * `InputDialogPeer` **peer** - Dialog * * @param array $params Parameters * @@ -2536,26 +2544,26 @@ interface messages public function markDialogUnread($params); /** - * Get dialogs marked as unread manually. + * Get dialogs manually marked as unread. * * @return of DialogPeer[] */ public function getDialogUnreadMarks(); /** - * Clear all drafts. + * Clear all [drafts](https://core.telegram.org/api/drafts). * * @return bool */ public function clearAllDrafts(); /** - * Update pinned message. + * Pin a message. * * Parameters: - * * `boolean` **silent** - Optional: Silent? - * * `InputPeer` **peer** - Peer - * * `int` **id** - Message ID + * * `boolean` **silent** - Optional: Pin the message silently, without triggering a notification + * * `InputPeer` **peer** - The peer where to pin the message + * * `int` **id** - The message to pin, can be 0 to unpin any currently pinned messages * * @param array $params Parameters * @@ -2564,11 +2572,11 @@ interface messages public function updatePinnedMessage($params); /** - * Send vote. + * Vote in a [poll](../constructors/poll.md). * * Parameters: - * * `InputPeer` **peer** - Peer - * * `int` **msg_id** - Message ID + * * `InputPeer` **peer** - The chat where the poll was sent + * * `int` **msg_id** - The message ID of the poll * * `[bytes]` **options** - Options * * @param array $params Parameters @@ -2581,8 +2589,8 @@ interface messages * Get poll results. * * Parameters: - * * `InputPeer` **peer** - Peer - * * `int` **msg_id** - Message ID + * * `InputPeer` **peer** - Peer where the poll was found + * * `int` **msg_id** - Message ID of poll message * * @param array $params Parameters * @@ -2591,10 +2599,10 @@ interface messages public function getPollResults($params); /** - * Get online users. + * Get count of online users in a chat. * * Parameters: - * * `InputPeer` **peer** - Peer + * * `InputPeer` **peer** - The chat * * @param array $params Parameters * @@ -2603,12 +2611,12 @@ interface messages public function getOnlines($params); /** - * Get stats URL. + * Returns URL with the chat statistics. Currently this method can be used only for channels. * * Parameters: - * * `boolean` **dark** - Optional: Dark? - * * `InputPeer` **peer** - Peer - * * `string` **params** - Params + * * `boolean` **dark** - Optional: Pass true if a URL with the dark theme must be returned + * * `InputPeer` **peer** - Chat identifier + * * `string` **params** - Parameters from `tg://statsrefresh?params=******` link * * @param array $params Parameters * @@ -2617,11 +2625,11 @@ interface messages public function getStatsURL($params); /** - * Edit chat info. + * Edit the description of a [group/supergroup/channel](https://core.telegram.org/api/channel). * * Parameters: - * * `InputPeer` **peer** - Chat - * * `string` **about** - Info + * * `InputPeer` **peer** - The [group/supergroup/channel](https://core.telegram.org/api/channel). + * * `string` **about** - The new description * * @param array $params Parameters * @@ -2630,11 +2638,11 @@ interface messages public function editChatAbout($params); /** - * Edit default rights of chat. + * Edit the default banned rights of a [channel/supergroup/group](https://core.telegram.org/api/channel). * * Parameters: - * * `InputPeer` **peer** - Chat - * * `ChatBannedRights` **banned_rights** - Global chat rights + * * `InputPeer` **peer** - The peer + * * `ChatBannedRights` **banned_rights** - The new global rights * * @param array $params Parameters * @@ -2643,7 +2651,7 @@ interface messages public function editChatDefaultBannedRights($params); /** - * Get emoji keywords. + * Get localized emoji keywords. * * Parameters: * * `string` **lang_code** - Language code @@ -2655,11 +2663,11 @@ interface messages public function getEmojiKeywords($params); /** - * Get emoji keyword difference. + * Get changed emoji keywords. * * Parameters: * * `string` **lang_code** - Language code - * * `int` **from_version** - From version + * * `int` **from_version** - Previous emoji keyword localization version * * @param array $params Parameters * @@ -2668,7 +2676,7 @@ interface messages public function getEmojiKeywordsDifference($params); /** - * Get emoji keyword languages. + * Get info about an emoji keyword localization. * * Parameters: * * `[string]` **lang_codes** - Language codes @@ -2680,10 +2688,10 @@ interface messages public function getEmojiKeywordsLanguages($params); /** - * Get emoji URL. + * Returns an HTTP URL which can be used to automatically log in into translation platform and suggest new emoji replacements. The URL will be valid for 30 seconds after generation. * * Parameters: - * * `string` **lang_code** - Language code + * * `string` **lang_code** - Language code for which the emoji replacements will be suggested * * @param array $params Parameters * @@ -2692,10 +2700,10 @@ interface messages public function getEmojiURL($params); /** - * Get search counter. + * Get the number of results that would be found by a [messages.search](../methods/messages.search.md) call with the same parameters. * * Parameters: - * * `InputPeer` **peer** - Peer + * * `InputPeer` **peer** - Peer where to search * * `[MessagesFilter]` **filters** - Filters * * @param array $params Parameters @@ -2705,12 +2713,12 @@ interface messages public function getSearchCounters($params); /** - * Request URL authorization. + * Get more info about a Seamless Telegram Login authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization). * * Parameters: - * * `InputPeer` **peer** - Peer - * * `int` **msg_id** - Message ID - * * `int` **button_id** - Button ID + * * `InputPeer` **peer** - Peer where the message is located + * * `int` **msg_id** - The message + * * `int` **button_id** - The ID of the button with the authorization request * * @param array $params Parameters * @@ -2719,13 +2727,13 @@ interface messages public function requestUrlAuth($params); /** - * Accept URL authorization. + * Use this to accept a Seamless Telegram Login authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization). * * Parameters: - * * `boolean` **write_allowed** - Optional: Write allowed? - * * `InputPeer` **peer** - Peer - * * `int` **msg_id** - Message ID - * * `int` **button_id** - Button ID + * * `boolean` **write_allowed** - Optional: Set this flag to allow the bot to send messages to you (if requested) + * * `InputPeer` **peer** - The location of the message + * * `int` **msg_id** - Message ID of the message with the login button + * * `int` **button_id** - ID of the login button * * @param array $params Parameters * @@ -2734,7 +2742,7 @@ interface messages public function acceptUrlAuth($params); /** - * Hide peer settings bar. + * Should be called after the user hides the report spam/add as contact bar of a new chat, effectively prevents the user from executing the actions specified in the [peer's settings](../constructors/peerSettings.md). * * Parameters: * * `InputPeer` **peer** - Peer @@ -2746,7 +2754,7 @@ interface messages public function hidePeerSettingsBar($params); /** - * Get scheduled history. + * Get scheduled messages. * * Parameters: * * `InputPeer` **peer** - Peer @@ -2772,7 +2780,7 @@ interface messages public function getScheduledMessages($params); /** - * Send scheduled messages. + * Send scheduled messages right away. * * Parameters: * * `InputPeer` **peer** - Peer @@ -2801,20 +2809,20 @@ interface messages interface updates { /** - * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates. + * Returns a current state of updates. * * @return updates.State */ public function getState(); /** - * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates. + * Get new [updates](https://core.telegram.org/api/updates). * * Parameters: - * * `int` **pts** - You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates - * * `int` **pts_total_limit** - Optional: You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates - * * `int` **date** - You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates - * * `int` **qts** - You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates + * * `int` **pts** - PTS, see [updates](https://core.telegram.org/api/updates). + * * `int` **pts_total_limit** - Optional: For fast updating: if provided and `pts + pts_total_limit < remote pts`, [updates.differenceTooLong](../constructors/updates.differenceTooLong.md) will be returned.
Simply tells the server to not return the difference if it is bigger than `pts_total_limit`
If the remote pts is too big (> ~4000000), this field will default to 1000000 + * * `int` **date** - date, see [updates](https://core.telegram.org/api/updates). + * * `int` **qts** - QTS, see [updates](https://core.telegram.org/api/updates). * * @param array $params Parameters * @@ -2823,14 +2831,14 @@ interface updates public function getDifference($params); /** - * You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates. + * Returns the difference between the current state of updates of a certain channel and transmitted. * * Parameters: - * * `boolean` **force** - Optional: You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates - * * `InputChannel` **channel** - You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates - * * `ChannelMessagesFilter` **filter** - You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates - * * `int` **pts** - You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates - * * `int` **limit** - You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates + * * `boolean` **force** - Optional: Set to true to skip some possibly unneeded updates and reduce server-side load + * * `InputChannel` **channel** - The channel + * * `ChannelMessagesFilter` **filter** - Messsage filter + * * `int` **pts** - Persistent timestamp (see [updates](https://core.telegram.org/api/updates)) + * * `int` **limit** - How many updates to fetch, max `100000`
Ordinary (non-bot) users are supposed to pass `10-100` * * @param array $params Parameters * @@ -2842,10 +2850,10 @@ interface updates interface photos { /** - * Change the profile photo. + * Installs a previously uploaded photo as a profile photo. * * Parameters: - * * `InputPhoto` **id** - The photo to use + * * `InputPhoto` **id** - Input photo * * @param array $params Parameters * @@ -2854,10 +2862,10 @@ interface photos public function updateProfilePhoto($params); /** - * Upload profile photo. + * Updates current user profile photo. * * Parameters: - * * `InputFile` **file** - The photo + * * `InputFile` **file** - File saved in parts by means of [upload.saveFilePart](../methods/upload.saveFilePart.md) method * * @param array $params Parameters * @@ -2866,7 +2874,7 @@ interface photos public function uploadProfilePhoto($params); /** - * Delete profile photos. + * Deletes profile photos. * * Parameters: * * `[InputPhoto]` **id** - The profile photos to delete @@ -2878,13 +2886,13 @@ interface photos public function deletePhotos($params); /** - * Get the profile photos of a user. + * Returns the list of user photos. * * Parameters: - * * `InputUser` **user_id** - The user - * * `int` **offset** - Offset - * * `long` **max_id** - Maximum ID of photo to return - * * `int` **limit** - Number of photos to return + * * `InputUser` **user_id** - User ID + * * `int` **offset** - Number of list elements to be skipped + * * `long` **max_id** - If a positive value was transferred, the method will return only photos with IDs less than the set one + * * `int` **limit** - Number of list elements to be returned * * @param array $params Parameters * @@ -2896,12 +2904,12 @@ interface photos interface upload { /** - * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info. + * Saves a part of file for futher sending to one of the methods. * * Parameters: - * * `long` **file_id** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info - * * `int` **file_part** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info - * * `bytes` **bytes** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info + * * `long` **file_id** - Random file identifier created by the client + * * `int` **file_part** - Numerical order of a part + * * `bytes` **bytes** - Binary data, contend of a part * * @param array $params Parameters * @@ -2910,13 +2918,13 @@ interface upload public function saveFilePart($params); /** - * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info. + * Returns content of a whole file or its part. * * Parameters: - * * `boolean` **precise** - Optional: You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info - * * `InputFileLocation` **location** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info - * * `int` **offset** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info - * * `int` **limit** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info + * * `boolean` **precise** - Optional: Disable some checks on limit and offset values, useful for example to stream videos by keyframes + * * `InputFileLocation` **location** - File location + * * `int` **offset** - Number of bytes to be skipped + * * `int` **limit** - Number of bytes to be returned * * @param array $params Parameters * @@ -2925,13 +2933,13 @@ interface upload public function getFile($params); /** - * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info. + * Saves a part of a large file (over 10Mb in size) to be later passed to one of the methods. * * Parameters: - * * `long` **file_id** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info - * * `int` **file_part** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info - * * `int` **file_total_parts** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info - * * `bytes` **bytes** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info + * * `long` **file_id** - Random file id, created by the client + * * `int` **file_part** - Part sequence number + * * `int` **file_total_parts** - Total number of parts + * * `bytes` **bytes** - Binary data, part contents * * @param array $params Parameters * @@ -2940,12 +2948,12 @@ interface upload public function saveBigFilePart($params); /** - * Download a file through telegram. + * Returns content of an HTTP file or a part, by proxying the request through telegram. * * Parameters: - * * `InputWebFileLocation` **location** - The file - * * `int` **offset** - The offset in bytes - * * `int` **limit** - The number of bytes to fetch + * * `InputWebFileLocation` **location** - The file to download + * * `int` **offset** - Number of bytes to be skipped + * * `int` **limit** - Number of bytes to be returned * * @param array $params Parameters * @@ -2954,12 +2962,12 @@ interface upload public function getWebFile($params); /** - * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info. + * Download a [CDN](https://core.telegram.org/cdn) file. * * Parameters: - * * `bytes` **file_token** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info - * * `int` **offset** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info - * * `int` **limit** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info + * * `bytes` **file_token** - File token + * * `int` **offset** - Offset of chunk to download + * * `int` **limit** - Length of chunk to download * * @param array $params Parameters * @@ -2968,11 +2976,11 @@ interface upload public function getCdnFile($params); /** - * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info. + * Request a reupload of a certain file to a [CDN DC](https://core.telegram.org/cdn). * * Parameters: - * * `bytes` **file_token** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info - * * `bytes` **request_token** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info + * * `bytes` **file_token** - File token + * * `bytes` **request_token** - Request token * * @param array $params Parameters * @@ -2981,11 +2989,11 @@ interface upload public function reuploadCdnFile($params); /** - * You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info. + * Get SHA256 hashes for verifying downloaded [CDN](https://core.telegram.org/cdn) files. * * Parameters: - * * `bytes` **file_token** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info - * * `int` **offset** - You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info + * * `bytes` **file_token** - File + * * `int` **offset** - Offset from which to start getting hashes * * @param array $params Parameters * @@ -2994,11 +3002,11 @@ interface upload public function getCdnFileHashes($params); /** - * Get file hashes. + * Get SHA256 hashes for verifying downloaded files. * * Parameters: - * * `InputFileLocation` **location** - The file - * * `int` **offset** - Offset + * * `InputFileLocation` **location** - File + * * `int` **offset** - Offset from which to get file hashes * * @param array $params Parameters * @@ -3010,21 +3018,21 @@ interface upload interface help { /** - * Get server configuration. + * Returns current configuration, icluding data center configuration. * * @return Config */ public function getConfig(); /** - * Get nearest datacenter. + * Returns info on data centre nearest to the user. * * @return NearestDc */ public function getNearestDc(); /** - * Get info about app updates. + * Returns information on update availability for the current application. * * Parameters: * * `string` **source** - Source @@ -3036,21 +3044,21 @@ interface help public function getAppUpdate($params); /** - * Get invitation text. + * Returns text of a text message with an invitation. * * @return help.InviteText */ public function getInviteText(); /** - * Get info of support user. + * Returns the support user for the 'ask a question' feature. * * @return help.Support */ public function getSupport(); /** - * Get the changelog of this app. + * Get changelog of current app. * * Parameters: * * `string` **prev_app_version** - Previous app version @@ -3062,11 +3070,11 @@ interface help public function getAppChangelog($params); /** - * Set the update status of webhook. + * Informs the server about the number of pending bot updates if they haven't been processed for a long time; for bots only. * * Parameters: - * * `int` **pending_updates_count** - Pending update count - * * `string` **message** - Message + * * `int` **pending_updates_count** - Number of pending updates + * * `string` **message** - Error message, if present * * @param array $params Parameters * @@ -3075,17 +3083,17 @@ interface help public function setBotUpdatesStatus($params); /** - * Get CDN configuration. + * Get configuration for [CDN](https://core.telegram.org/cdn) file downloads. * * @return CdnConfig */ public function getCdnConfig(); /** - * Get recent t.me URLs. + * Get recently used `t.me` links. * * Parameters: - * * `string` **referer** - Referrer + * * `string` **referer** - Referer * * @param array $params Parameters * @@ -3094,24 +3102,24 @@ interface help public function getRecentMeUrls($params); /** - * Get information about the current proxy. + * Get promotion info of the currently-used MTProxy. * * @return help.ProxyData */ public function getProxyData(); /** - * Get updated TOS. + * Look for updates of telegram's terms of service. * * @return help.TermsOfServiceUpdate */ public function getTermsOfServiceUpdate(); /** - * Accept telegram's TOS. + * Accept the new terms of service. * * Parameters: - * * `DataJSON` **id** - TOS + * * `DataJSON` **id** - ID of terms of service * * @param array $params Parameters * @@ -3120,10 +3128,10 @@ interface help public function acceptTermsOfService($params); /** - * Get deep link info. + * Get info about a `t.me` link. * * Parameters: - * * `string` **path** - Deep link + * * `string` **path** - Path in `t.me/path` * * @param array $params Parameters * @@ -3132,14 +3140,14 @@ interface help public function getDeepLinkInfo($params); /** - * Get app config. + * Get app-specific configuration. * * @return JSONValue */ public function getAppConfig(); /** - * Log data for developer of this app. + * Saves logs of application on the server. * * Parameters: * * `[InputAppEvent]` **events** - Event list @@ -3151,7 +3159,7 @@ interface help public function saveAppLog($params); /** - * Get passport config. + * Get [passport](https://core.telegram.org/passport) configuration. * * Parameters: * * `[int]` **hash** - Optional: Hash @@ -3163,14 +3171,14 @@ interface help public function getPassportConfig($params); /** - * Get support name. + * Get localized name of the telegram support user. * * @return help.SupportName */ public function getSupportName(); /** - * Get user info. + * Internal use. * * Parameters: * * `InputUser` **user_id** - User ID @@ -3182,10 +3190,10 @@ interface help public function getUserInfo($params); /** - * Edit user info. + * Internal use. * * Parameters: - * * `InputUser` **user_id** - User ID + * * `InputUser` **user_id** - User * * `string` **message** - Message * * `[MessageEntity]` **entities** - Entities * @@ -3199,11 +3207,11 @@ interface help interface channels { /** - * Mark channel/supergroup history as read. + * Mark [channel/supergroup](https://core.telegram.org/api/channel) history as read. * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup - * * `int` **max_id** - Maximum message ID to mark as read + * * `InputChannel` **channel** - [Channel/supergroup](https://core.telegram.org/api/channel) + * * `int` **max_id** - ID of message up to which messages should be marked as read * * @param array $params Parameters * @@ -3212,10 +3220,10 @@ interface channels public function readHistory($params); /** - * Delete channel/supergroup messages. + * Delete messages in a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup + * * `InputChannel` **channel** - [Channel/supergroup](https://core.telegram.org/api/channel) * * `[int]` **id** - The IDs of messages to delete * * @param array $params Parameters @@ -3225,11 +3233,11 @@ interface channels public function deleteMessages($params); /** - * Delete all messages of a user in a channel/supergroup. + * Delete all messages sent by a certain user in a [supergroup](https://core.telegram.org/api/channel). * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup - * * `InputUser` **user_id** - The user + * * `InputChannel` **channel** - [Supergroup](https://core.telegram.org/api/channel) + * * `InputUser` **user_id** - User whose messages should be deleted * * @param array $params Parameters * @@ -3238,11 +3246,11 @@ interface channels public function deleteUserHistory($params); /** - * Report a message in a supergroup/channel for spam. + * Reports some messages from a user in a supergroup as spam; requires administrator rights in the supergroup. * * Parameters: - * * `InputChannel` **channel** - The channel - * * `InputUser` **user_id** - The user that sent the messages + * * `InputChannel` **channel** - Supergroup + * * `InputUser` **user_id** - ID of the user that sent the spam messages * * `[int]` **id** - The IDs of messages to report * * @param array $params Parameters @@ -3252,10 +3260,10 @@ interface channels public function reportSpam($params); /** - * Get channel/supergroup messages. + * Get [channel/supergroup](https://core.telegram.org/api/channel) messages. * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup + * * `InputChannel` **channel** - Channel/supergroup * * `[InputMessage]` **id** - The message IDs * * @param array $params Parameters @@ -3265,13 +3273,13 @@ interface channels public function getMessages($params); /** - * Get channel/supergroup participants (you should use `$MadelineProto->getPwrChat($id)` instead). + * Get the participants of a channel. * * Parameters: - * * `InputChannel` **channel** - The channel - * * `ChannelParticipantsFilter` **filter** - Member filter - * * `int` **offset** - Offset - * * `int` **limit** - Limit + * * `InputChannel` **channel** - Channel + * * `ChannelParticipantsFilter` **filter** - Which participant types to fetch + * * `int` **offset** - [Offset](https://core.telegram.org/api/offsets) + * * `int` **limit** - [Limit](https://core.telegram.org/api/offsets) * * `[int]` **hash** - Optional: IDs of previously fetched participants * * @param array $params Parameters @@ -3281,11 +3289,11 @@ interface channels public function getParticipants($params); /** - * Get info about a certain channel/supergroup participant. + * Get info about a [channel/supergroup](https://core.telegram.org/api/channel) participant. * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup - * * `InputUser` **user_id** - The user to fetch info about + * * `InputChannel` **channel** - Channel/supergroup + * * `InputUser` **user_id** - ID of participant to get info about * * @param array $params Parameters * @@ -3294,7 +3302,7 @@ interface channels public function getParticipant($params); /** - * Get info about multiple channels/supergroups. + * Get info about [channels/supergroups](https://core.telegram.org/api/channel). * * Parameters: * * `[InputChannel]` **id** - The channel/supergroup MTProto IDs @@ -3306,10 +3314,10 @@ interface channels public function getChannels($params); /** - * You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info). + * Get full info about a channel. * * Parameters: - * * `InputChannel` **channel** - You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info) + * * `InputChannel` **channel** - The channel to get info about * * @param array $params Parameters * @@ -3318,15 +3326,15 @@ interface channels public function getFullChannel($params); /** - * Create channel/supergroup. + * Create a [supergroup/channel](https://core.telegram.org/api/channel). * * Parameters: - * * `boolean` **broadcast** - Optional: Set this to true to create a channel - * * `boolean` **megagroup** - Optional: Set this to true to create a supergroup - * * `string` **title** - Supergroup/channel title - * * `string` **about** - About text - * * `InputGeoPoint` **geo_point** - Optional: Geopoint (geochats) - * * `string` **address** - Optional: Physical address (geochats) + * * `boolean` **broadcast** - Optional: Whether to create a [channel](https://core.telegram.org/api/channel) + * * `boolean` **megagroup** - Optional: Whether to create a [supergroup](https://core.telegram.org/api/channel) + * * `string` **title** - Channel title + * * `string` **about** - Channel description + * * `InputGeoPoint` **geo_point** - Optional: Geogroup location + * * `string` **address** - Optional: Geogroup address * * @param array $params Parameters * @@ -3335,13 +3343,13 @@ interface channels public function createChannel($params); /** - * Edit admin permissions of a user in a channel/supergroup. + * Modify the admin rights of a user in a [supergroup/channel](https://core.telegram.org/api/channel). * * Parameters: - * * `InputChannel` **channel** - The channel - * * `InputUser` **user_id** - The user - * * `ChatAdminRights` **admin_rights** - Admin rights - * * `string` **rank** - Admin rank, an arbitrary string + * * `InputChannel` **channel** - The [supergroup/channel](https://core.telegram.org/api/channel). + * * `InputUser` **user_id** - The ID of the user whose admin rights should be modified + * * `ChatAdminRights` **admin_rights** - The admin rights + * * `string` **rank** - Indicates the role (rank) of the admin in the group: just an arbitrary string * * @param array $params Parameters * @@ -3350,11 +3358,11 @@ interface channels public function editAdmin($params); /** - * Edit the title of a supergroup/channel. + * Edit the name of a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: - * * `InputChannel` **channel** - The channel - * * `string` **title** - The new channel/supergroup title + * * `InputChannel` **channel** - Channel/supergroup + * * `string` **title** - New name * * @param array $params Parameters * @@ -3363,11 +3371,11 @@ interface channels public function editTitle($params); /** - * Edit the photo of a supergroup/channel. + * Change the photo of a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: - * * `InputChannel` **channel** - The channel - * * `InputChatPhoto` **photo** - The new photo + * * `InputChannel` **channel** - Channel/supergroup whose photo should be edited + * * `InputChatPhoto` **photo** - New photo * * @param array $params Parameters * @@ -3376,11 +3384,11 @@ interface channels public function editPhoto($params); /** - * Check if this username is free and can be assigned to a channel/supergroup. + * Check if a username is free and can be assigned to a channel/supergroup. * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup - * * `string` **username** - The new username for this channel/supergroup + * * `InputChannel` **channel** - The [channel/supergroup](https://core.telegram.org/api/channel) that will assigned the specified username + * * `string` **username** - The username to check * * @param array $params Parameters * @@ -3389,11 +3397,11 @@ interface channels public function checkUsername($params); /** - * Update the username of a supergroup/channel. + * Change the username of a supergroup/channel. * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup - * * `string` **username** - The new username + * * `InputChannel` **channel** - Channel + * * `string` **username** - New username * * @param array $params Parameters * @@ -3405,7 +3413,7 @@ interface channels * Join a channel/supergroup. * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup to join + * * `InputChannel` **channel** - Channel/supergroup to join * * @param array $params Parameters * @@ -3414,10 +3422,10 @@ interface channels public function joinChannel($params); /** - * Leave a channel/supergroup. + * Leave a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup to leave + * * `InputChannel` **channel** - [Channel/supergroup](https://core.telegram.org/api/channel) to leave * * @param array $params Parameters * @@ -3426,10 +3434,10 @@ interface channels public function leaveChannel($params); /** - * Add users to channel/supergroup. + * Invite users to a channel/supergroup. * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup + * * `InputChannel` **channel** - Channel/supergroup * * `[InputUser]` **users** - The users to add * * @param array $params Parameters @@ -3439,10 +3447,10 @@ interface channels public function inviteToChannel($params); /** - * Delete a channel/supergroup. + * Delete a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup to delete + * * `InputChannel` **channel** - [Channel/supergroup](https://core.telegram.org/api/channel) to delete * * @param array $params Parameters * @@ -3451,12 +3459,12 @@ interface channels public function deleteChannel($params); /** - * Get the link of a message in a channel. + * Get link and embed info of a message in a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup - * * `int` **id** - The ID of the message - * * `Bool` **grouped** - Is this an album? + * * `InputChannel` **channel** - Channel + * * `int` **id** - Message ID + * * `Bool` **grouped** - Whether to include other grouped media (for albums) * * @param array $params Parameters * @@ -3465,11 +3473,11 @@ interface channels public function exportMessageLink($params); /** - * Toggle channel signatures. + * Enable/disable message signatures in channels. * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup - * * `Bool` **enabled** - Enable or disable channel signatures? + * * `InputChannel` **channel** - Channel + * * `Bool` **enabled** - Value * * @param array $params Parameters * @@ -3478,11 +3486,11 @@ interface channels public function toggleSignatures($params); /** - * Get all supergroups/channels where you're admin. + * Get [channels/supergroups/geogroups](https://core.telegram.org/api/channel) we're admin in. Usually called when the user exceeds the [limit](../constructors/config.md) for owned public [channels/supergroups/geogroups](https://core.telegram.org/api/channel), and the user is given the choice to remove one of his channels/supergroups/geogroups. * * Parameters: - * * `boolean` **by_location** - Optional: Get channels by location - * * `boolean` **check_limit** - Optional: Check limit + * * `boolean` **by_location** - Optional: Get geogroups + * * `boolean` **check_limit** - Optional: If set and the user has reached the limit of owned public [channels/supergroups/geogroups](https://core.telegram.org/api/channel), instead of returning the channel list one of the specified [errors](#possible-errors) will be returned.
Useful to check if a new public channel can indeed be created, even before asking the user to enter a channel username to use in [channels.checkUsername](../methods/channels.checkUsername.md)/[channels.updateUsername](../methods/channels.updateUsername.md). * * @param array $params Parameters * @@ -3491,12 +3499,12 @@ interface channels public function getAdminedPublicChannels($params); /** - * Kick or ban a user from a channel/supergroup. + * Ban/unban/kick a user in a [supergroup/channel](https://core.telegram.org/api/channel). * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup - * * `InputUser` **user_id** - The user to kick/ban - * * `ChatBannedRights` **banned_rights** - Banned rights + * * `InputChannel` **channel** - The [supergroup/channel](https://core.telegram.org/api/channel). + * * `InputUser` **user_id** - The ID of the user whose banned rights should be modified + * * `ChatBannedRights` **banned_rights** - The banned rights * * @param array $params Parameters * @@ -3505,16 +3513,16 @@ interface channels public function editBanned($params); /** - * Get admin log of a channel/supergroup. + * Get the admin log of a [channel/supergroup](https://core.telegram.org/api/channel). * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup - * * `string` **q** - Search query + * * `InputChannel` **channel** - Channel + * * `string` **q** - Search query, can be empty * * `ChannelAdminLogEventsFilter` **events_filter** - Optional: Event filter * * `[InputUser]` **admins** - Optional: Fetch only actions from these admins - * * `long` **max_id** - Maximum message ID to fetch - * * `long` **min_id** - Minimum message ID to fetch - * * `int` **limit** - Number of results to fetch + * * `long` **max_id** - Maximum ID of message to return (see [pagination](https://core.telegram.org/api/offsets)) + * * `long` **min_id** - Minimum ID of message to return (see [pagination](https://core.telegram.org/api/offsets)) + * * `int` **limit** - Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * @@ -3523,11 +3531,11 @@ interface channels public function getAdminLog($params); /** - * Set the supergroup/channel stickerpack. + * Associate a stickerset to the supergroup. * * Parameters: - * * `InputChannel` **channel** - The channel/supergoup - * * `InputStickerSet` **stickerset** - The stickerset + * * `InputChannel` **channel** - Supergroup + * * `InputStickerSet` **stickerset** - The stickerset to associate * * @param array $params Parameters * @@ -3536,10 +3544,10 @@ interface channels public function setStickers($params); /** - * Mark channel/supergroup messages as read. + * Mark [channel/supergroup](https://core.telegram.org/api/channel) message contents as read. * * Parameters: - * * `InputChannel` **channel** - The channel + * * `InputChannel` **channel** - [Channel/supergroup](https://core.telegram.org/api/channel) * * `[int]` **id** - List of message IDs * * @param array $params Parameters @@ -3549,11 +3557,11 @@ interface channels public function readMessageContents($params); /** - * Delete the history of a supergroup/channel. + * Delete the history of a [supergroup](https://core.telegram.org/api/channel). * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup - * * `int` **max_id** - Maximum message ID to delete + * * `InputChannel` **channel** - [Supergroup](https://core.telegram.org/api/channel) whose history must be deleted + * * `int` **max_id** - ID of message **up to which** the history must be deleted * * @param array $params Parameters * @@ -3562,11 +3570,11 @@ interface channels public function deleteHistory($params); /** - * Enable or disable hidden history for new channel/supergroup users. + * Hide/unhide message history for new channel/supergroup users. * * Parameters: - * * `InputChannel` **channel** - The channel/supergroup - * * `Bool` **enabled** - Enable or disable hidden history for new channel/supergroup users + * * `InputChannel` **channel** - Channel/supergroup + * * `Bool` **enabled** - Hide/unhide * * @param array $params Parameters * @@ -3575,10 +3583,10 @@ interface channels public function togglePreHistoryHidden($params); /** - * Get all channels you left. + * Get a list of [channels/supergroups](https://core.telegram.org/api/channel) we left. * * Parameters: - * * `int` **offset** - Offset + * * `int` **offset** - Offset for [pagination](https://core.telegram.org/api/offsets) * * @param array $params Parameters * @@ -3587,18 +3595,18 @@ interface channels public function getLeftChannels($params); /** - * Get groups for discussion. + * Get all groups that can be used as [discussion groups](https://telegram.org/blog/privacy-discussions-web-bots). * * @return messages.Chats */ public function getGroupsForDiscussion(); /** - * Set discussion group of channel. + * Associate a group to a channel as [discussion group](https://telegram.org/blog/privacy-discussions-web-bots) for that channel. * * Parameters: - * * `InputChannel` **broadcast** - The channel - * * `InputChannel` **group** - The group + * * `InputChannel` **broadcast** - Channel + * * `InputChannel` **group** - Discussion group to associate to the channel * * @param array $params Parameters * @@ -3607,12 +3615,12 @@ interface channels public function setDiscussionGroup($params); /** - * Edit creator of channel. + * Transfer channel ownership. * * Parameters: * * `InputChannel` **channel** - Channel - * * `InputUser` **user_id** - User ID - * * `InputCheckPasswordSRP` **password** - Password + * * `InputUser` **user_id** - New channel owner + * * `InputCheckPasswordSRP` **password** - [2FA password](https://core.telegram.org/api/srp) of account * * @param array $params Parameters * @@ -3621,12 +3629,12 @@ interface channels public function editCreator($params); /** - * Edit location (geochats). + * Edit location of geogroup. * * Parameters: - * * `InputChannel` **channel** - Channel - * * `InputGeoPoint` **geo_point** - Geo point - * * `string` **address** - Physical location (geochats) + * * `InputChannel` **channel** - [Geogroup](https://core.telegram.org/api/channel) + * * `InputGeoPoint` **geo_point** - New geolocation + * * `string` **address** - Address string * * @param array $params Parameters * @@ -3635,10 +3643,10 @@ interface channels public function editLocation($params); /** - * Toggle slow mode. + * Toggle supergroup slow mode: if enabled, users will only be able to send one message every `seconds` seconds. * * Parameters: - * * `InputChannel` **channel** - Supergroup + * * `InputChannel` **channel** - The [supergroup](https://core.telegram.org/api/channel) * * `int` **seconds** - Users will only be able to send one message every `seconds` seconds, `0` to disable the limitation * * @param array $params Parameters @@ -3651,11 +3659,11 @@ interface channels interface bots { /** - * Send a custom request to the bot API. + * Sends a custom request; for bots only. * * Parameters: - * * `string` **custom_method** - The method to call - * * `DataJSON` **params** - Method parameters + * * `string` **custom_method** - The method name + * * `DataJSON` **params** - JSON-serialized method parameters * * @param array $params Parameters * @@ -3664,11 +3672,11 @@ interface bots public function sendCustomRequest($params); /** - * Send webhook request via bot API. + * Answers a custom query; for bots only. * * Parameters: - * * `long` **query_id** - The query ID - * * `DataJSON` **data** - The parameters + * * `long` **query_id** - Identifier of a custom query + * * `DataJSON` **data** - JSON-serialized answer to the query * * @param array $params Parameters * @@ -3680,10 +3688,10 @@ interface bots interface payments { /** - * Get payment form. + * Get a payment form. * * Parameters: - * * `int` **msg_id** - Message ID + * * `int` **msg_id** - Message ID of payment form * * @param array $params Parameters * @@ -3695,7 +3703,7 @@ interface payments * Get payment receipt. * * Parameters: - * * `int` **msg_id** - The message ID + * * `int` **msg_id** - Message ID of receipt * * @param array $params Parameters * @@ -3704,12 +3712,12 @@ interface payments public function getPaymentReceipt($params); /** - * Validate requested payment info. + * Submit requested order information for validation. * * Parameters: - * * `boolean` **save** - Optional: Save payment info? - * * `int` **msg_id** - The message ID - * * `PaymentRequestedInfo` **info** - The requested payment info + * * `boolean` **save** - Optional: Save order information to re-use it for future orders + * * `int` **msg_id** - Message ID of payment form + * * `PaymentRequestedInfo` **info** - Requested order information * * @param array $params Parameters * @@ -3718,12 +3726,12 @@ interface payments public function validateRequestedInfo($params); /** - * Bots only: send payment form. + * Send compiled payment form. * * Parameters: - * * `int` **msg_id** - Message ID - * * `string` **requested_info_id** - Optional: ID of requested info - * * `string` **shipping_option_id** - Optional: Shipping option ID + * * `int` **msg_id** - Message ID of form + * * `string` **requested_info_id** - Optional: ID of saved and validated [order info](../constructors/payments.validatedRequestedInfo.md) + * * `string` **shipping_option_id** - Optional: Chosen shipping option ID * * `InputPaymentCredentials` **credentials** - Payment credentials * * @param array $params Parameters @@ -3733,18 +3741,18 @@ interface payments public function sendPaymentForm($params); /** - * Get saved payments info. + * Get saved payment information. * * @return payments.SavedInfo */ public function getSavedInfo(); /** - * Clear saved payments info. + * Clear saved payment information. * * Parameters: - * * `boolean` **credentials** - Optional: Clear credentials? - * * `boolean` **info** - Optional: Clear payment info? + * * `boolean` **credentials** - Optional: Remove saved payment credentials + * * `boolean` **info** - Optional: Clear the last order settings saved by the user * * @param array $params Parameters * @@ -3756,13 +3764,13 @@ interface payments interface stickers { /** - * Create stickerset. + * Create a stickerset, bots only. * * Parameters: - * * `boolean` **masks** - Optional: Masks? - * * `InputUser` **user_id** - The user ID associated to this stickerset - * * `string` **title** - The stickerset title - * * `string` **short_name** - The stickerset short name + * * `boolean` **masks** - Optional: Whether this is a mask stickerset + * * `InputUser` **user_id** - Stickerset owner + * * `string` **title** - Stickerset name, `1-64` chars + * * `string` **short_name** - Sticker set name. Can contain only English letters, digits and underscores. Must end with *"*by*"* (** is case insensitive); 1-64 characters * * `[InputStickerSetItem]` **stickers** - The stickers to add * * @param array $params Parameters @@ -3772,7 +3780,7 @@ interface stickers public function createStickerSet($params); /** - * Remove sticker from stickerset. + * Remove a sticker from the set where it belongs, bots only. The sticker set must have been created by the bot. * * Parameters: * * `InputDocument` **sticker** - The sticker to remove @@ -3784,11 +3792,11 @@ interface stickers public function removeStickerFromSet($params); /** - * Change sticker position in photo. + * Changes the absolute position of a sticker in the set to which it belongs; for bots only. The sticker set must have been created by the bot. * * Parameters: * * `InputDocument` **sticker** - The sticker - * * `int` **position** - New position + * * `int` **position** - The new position of the sticker, zero-based * * @param array $params Parameters * @@ -3797,7 +3805,7 @@ interface stickers public function changeStickerPosition($params); /** - * Add sticker to stickerset. + * Add a sticker to a stickerset, bots only. The sticker set must have been created by the bot. * * Parameters: * * `InputStickerSet` **stickerset** - The stickerset @@ -3813,20 +3821,20 @@ interface stickers interface phone { /** - * Get call configuration. + * Get phone call configuration to be passed to libtgvoip's shared config. * * @return DataJSON */ public function getCallConfig(); /** - * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls. + * Start a telegram phone call. * * Parameters: - * * `boolean` **video** - Optional: You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls - * * `InputUser` **user_id** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls - * * `bytes` **g_a_hash** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls - * * `PhoneCallProtocol` **protocol** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls + * * `boolean` **video** - Optional: Whether to start a video call + * * `InputUser` **user_id** - Destination of the phone call + * * `bytes` **g_a_hash** - [Parameter for E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls) + * * `PhoneCallProtocol` **protocol** - Phone call settings * * @param array $params Parameters * @@ -3835,12 +3843,12 @@ interface phone public function requestCall($params); /** - * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls. + * Accept incoming call. * * Parameters: - * * `InputPhoneCall` **peer** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls - * * `bytes` **g_b** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls - * * `PhoneCallProtocol` **protocol** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls + * * `InputPhoneCall` **peer** - The call to accept + * * `bytes` **g_b** - [Parameter for E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls) + * * `PhoneCallProtocol` **protocol** - Phone call settings * * @param array $params Parameters * @@ -3849,13 +3857,13 @@ interface phone public function acceptCall($params); /** - * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls. + * [Complete phone call E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls). * * Parameters: - * * `InputPhoneCall` **peer** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls - * * `bytes` **g_a** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls - * * `long` **key_fingerprint** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls - * * `PhoneCallProtocol` **protocol** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls + * * `InputPhoneCall` **peer** - The phone call + * * `bytes` **g_a** - [Parameter for E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls) + * * `long` **key_fingerprint** - Key fingerprint + * * `PhoneCallProtocol` **protocol** - Phone call settings * * @param array $params Parameters * @@ -3864,10 +3872,10 @@ interface phone public function confirmCall($params); /** - * Notify server that you received a call (server will refuse all incoming calls until the current call is over). + * Optional: notify the server that the user is currently busy in a call: this will automatically refuse all incoming phone calls until the current phone call is ended. * * Parameters: - * * `InputPhoneCall` **peer** - The phone call you received + * * `InputPhoneCall` **peer** - The phone call we're currently in * * @param array $params Parameters * @@ -3876,14 +3884,14 @@ interface phone public function receivedCall($params); /** - * You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls. + * Refuse or end running call. * * Parameters: - * * `boolean` **video** - Optional: You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls - * * `InputPhoneCall` **peer** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls - * * `int` **duration** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls - * * `PhoneCallDiscardReason` **reason** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls - * * `long` **connection_id** - You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls + * * `boolean` **video** - Optional: Whether this is a video call + * * `InputPhoneCall` **peer** - The phone call + * * `int` **duration** - Call duration + * * `PhoneCallDiscardReason` **reason** - Why was the call discarded + * * `long` **connection_id** - Preferred libtgvoip relay ID * * @param array $params Parameters * @@ -3892,13 +3900,13 @@ interface phone public function discardCall($params); /** - * Set phone call rating. + * Rate a call. * * Parameters: - * * `boolean` **user_initiative** - Optional: User initiative - * * `InputPhoneCall` **peer** - The phone call - * * `int` **rating** - Rating (1-5 stars) - * * `string` **comment** - An optional comment + * * `boolean` **user_initiative** - Optional: Whether the user decided on their own initiative to rate the call + * * `InputPhoneCall` **peer** - The call to rate + * * `int` **rating** - Rating in `1-5` stars + * * `string` **comment** - An additional comment * * @param array $params Parameters * @@ -3907,11 +3915,11 @@ interface phone public function setCallRating($params); /** - * Save call debugging info. + * Send phone call debug data to server. * * Parameters: - * * `InputPhoneCall` **peer** - The call - * * `DataJSON` **debug** - Debugging info + * * `InputPhoneCall` **peer** - Phone call + * * `DataJSON` **debug** - Debug statistics obtained from libtgvoip * * @param array $params Parameters * @@ -3923,10 +3931,10 @@ interface phone interface langpack { /** - * Get language pack. + * Get localization pack strings. * * Parameters: - * * `string` **lang_pack** - Lang pack + * * `string` **lang_pack** - Language pack name * * `string` **lang_code** - Language code * * @param array $params Parameters @@ -3936,10 +3944,10 @@ interface langpack public function getLangPack($params); /** - * Get language pack strings. + * Get strings from a language pack. * * Parameters: - * * `string` **lang_pack** - Lang pack + * * `string` **lang_pack** - Language pack name * * `string` **lang_code** - Language code * * `[string]` **keys** - Keys * @@ -3950,12 +3958,12 @@ interface langpack public function getStrings($params); /** - * Get language pack updates. + * Get new strings in languagepack. * * Parameters: * * `string` **lang_pack** - Language pack - * * `string` **lang_code** - Lang code - * * `int` **from_version** - Previous version + * * `string` **lang_code** - Language code + * * `int` **from_version** - Previous localization pack version * * @param array $params Parameters * @@ -3964,10 +3972,10 @@ interface langpack public function getDifference($params); /** - * Get available languages. + * Get information about all languages in a localization pack. * * Parameters: - * * `string` **lang_pack** - Lang pack + * * `string` **lang_pack** - Language pack * * @param array $params Parameters * @@ -3976,11 +3984,11 @@ interface langpack public function getLanguages($params); /** - * Get language. + * Get information about a language in a localization pack. * * Parameters: - * * `string` **lang_pack** - Lang pack - * * `string` **lang_code** - Lang code + * * `string` **lang_pack** - Language pack name + * * `string` **lang_code** - Language code * * @param array $params Parameters * @@ -3992,7 +4000,7 @@ interface langpack interface folders { /** - * Edit folder. + * Edit peers in folder. * * Parameters: * * `[InputFolderPeer]` **folder_peers** - New folder peers @@ -4004,10 +4012,10 @@ interface folders public function editPeerFolders($params); /** - * Delete folder. + * Delete a folder. * * Parameters: - * * `int` **folder_id** - Folder ID + * * `int` **folder_id** - Folder to delete * * @param array $params Parameters * @@ -4986,6 +4994,17 @@ class InternalDoc extends APIFactory { return $this->__call(__FUNCTION__, [$params, $extra]); } + /** + * Sanify TL obtained from JSON for TL serialization. + * + * @param array $input Data to sanitize + + * @return array + */ + public function convertJsonTL(array $input, array $extra = []): array + { + return $this->__call(__FUNCTION__, [$input, $extra]); + } /** * Generate MTProto vector hash. * diff --git a/src/danog/MadelineProto/Lang.php b/src/danog/MadelineProto/Lang.php index 5af519ad..183a9e68 100644 --- a/src/danog/MadelineProto/Lang.php +++ b/src/danog/MadelineProto/Lang.php @@ -336,780 +336,786 @@ class Lang 'method_invokeAfterMsg' => 'Invokes a query after successfull completion of one of the previous queries.', 'method_invokeAfterMsg_param_msg_id_type_long' => 'Message identifier on which a current query depends', 'method_invokeAfterMsg_param_query_type_!X' => 'The query itself', - 'method_invokeAfterMsgs' => 'Result type returned by a current query.', + 'method_invokeAfterMsgs' => 'Invokes a query after a successfull completion of previous queries', 'method_invokeAfterMsgs_param_msg_ids_type_Vector t' => 'List of messages on which a current query depends', 'method_invokeAfterMsgs_param_query_type_!X' => 'The query itself', - 'method_initConnection' => 'Initializes connection and save information on the user\'s device and application.', - 'method_initConnection_param_api_id_type_int' => 'Application identifier', + 'method_initConnection' => 'Initialize connection', + 'method_initConnection_param_api_id_type_int' => 'Application identifier (see. [App configuration](https://core.telegram.org/myapp))', 'method_initConnection_param_device_model_type_string' => 'Device model', - 'method_initConnection_param_system_version_type_string' => 'System version', - 'method_initConnection_param_app_version_type_string' => 'App version', - 'method_initConnection_param_system_lang_code_type_string' => 'Language code', + 'method_initConnection_param_system_version_type_string' => 'Operation system version', + 'method_initConnection_param_app_version_type_string' => 'Application version', + 'method_initConnection_param_system_lang_code_type_string' => 'Code for the language used on the device\'s OS, ISO 639-1 standard', 'method_initConnection_param_lang_pack_type_string' => 'Language pack to use', - 'method_initConnection_param_lang_code_type_string' => 'Language code to set', - 'method_initConnection_param_query_type_!X' => 'Nested query', - 'method_invokeWithLayer' => 'Invoke this method with layer X', - 'method_invokeWithLayer_param_layer_type_int' => 'The layer version', + 'method_initConnection_param_lang_code_type_string' => 'Code for the language used on the client, ISO 639-1 standard', + 'method_initConnection_param_query_type_!X' => 'The query itself', + 'method_invokeWithLayer' => 'Invoke the specified query using the specified API [layer](https://core.telegram.org/api/invoking#layers)', + 'method_invokeWithLayer_param_layer_type_int' => 'The layer to use', 'method_invokeWithLayer_param_query_type_!X' => 'The query', - 'method_invokeWithoutUpdates' => 'Invoke with method without returning updates in the socket', + 'method_invokeWithoutUpdates' => 'Invoke a request without subscribing the used connection for [updates](https://core.telegram.org/api/updates) (this is enabled by default for [file queries](https://core.telegram.org/api/files)).', 'method_invokeWithoutUpdates_param_query_type_!X' => 'The query', 'method_auth.checkPhone' => 'Check if this phone number is registered on telegram', 'method_auth.checkPhone_param_phone_number_type_string' => 'The phone number to check', - 'method_auth.sendCode' => 'Use phoneLogin instead', + 'method_auth.sendCode' => 'Send the verification code for login', 'method_auth.sendCode_param_allow_flashcall_type_true' => 'Use phoneLogin instead', - 'method_auth.sendCode_param_phone_number_type_string' => 'Use phoneLogin instead', + 'method_auth.sendCode_param_phone_number_type_string' => 'Phone number in international format', 'method_auth.sendCode_param_current_number_type_Bool' => 'Use phoneLogin instead', - 'method_auth.sendCode_param_api_id_type_int' => 'Use phoneLogin instead', - 'method_auth.sendCode_param_api_hash_type_string' => 'Use phoneLogin instead', - 'method_auth.signUp' => 'You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.signUp_param_phone_number_type_string' => 'You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.signUp_param_phone_code_hash_type_string' => 'You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info)', + 'method_auth.sendCode_param_api_id_type_int' => 'Application identifier (see [App configuration](https://core.telegram.org/myapp))', + 'method_auth.sendCode_param_api_hash_type_string' => 'Application secret hash (see [App configuration](https://core.telegram.org/myapp))', + 'method_auth.signUp' => 'Registers a validated phone number in the system.', + 'method_auth.signUp_param_phone_number_type_string' => 'Phone number in the international format', + 'method_auth.signUp_param_phone_code_hash_type_string' => 'SMS-message ID', 'method_auth.signUp_param_phone_code_type_string' => 'You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.signUp_param_first_name_type_string' => 'You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.signUp_param_last_name_type_string' => 'You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.signIn' => 'You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.signIn_param_phone_number_type_string' => 'You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.signIn_param_phone_code_hash_type_string' => 'You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.signIn_param_phone_code_type_string' => 'You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.logOut' => 'You cannot use this method directly, use the logout method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.resetAuthorizations' => 'Delete all logged-in sessions.', + 'method_auth.signUp_param_first_name_type_string' => 'New user first name', + 'method_auth.signUp_param_last_name_type_string' => 'New user last name', + 'method_auth.signIn' => 'Signs in a user with a validated phone number.', + 'method_auth.signIn_param_phone_number_type_string' => 'Phone number in the international format', + 'method_auth.signIn_param_phone_code_hash_type_string' => 'SMS-message ID, obtained from [auth.sendCode](../methods/auth.sendCode.md)', + 'method_auth.signIn_param_phone_code_type_string' => 'Valid numerical code from the SMS-message', + 'method_auth.logOut' => 'Logs out the user.', + 'method_auth.resetAuthorizations' => 'Terminates all user\'s authorized sessions except for the current one. + +After calling this method it is necessary to reregister the current device using the method [account.registerDevice](../methods/account.registerDevice.md)', 'method_auth.sendInvites' => 'Invite friends to telegram!', 'method_auth.sendInvites_param_phone_numbers_type_Vector t' => 'Phone numbers to invite', 'method_auth.sendInvites_param_message_type_string' => 'The message to send', - 'method_auth.exportAuthorization' => 'You cannot use this method directly, use $MadelineProto->exportAuthorization() instead, see https://docs.madelineproto.xyz/docs/LOGIN.html', - 'method_auth.exportAuthorization_param_dc_id_type_int' => 'You cannot use this method directly, use $MadelineProto->exportAuthorization() instead, see https://docs.madelineproto.xyz/docs/LOGIN.html', - 'method_auth.importAuthorization' => 'You cannot use this method directly, use $MadelineProto->importAuthorization($authorization) instead, see https://docs.madelineproto.xyz/docs/LOGIN.html', - 'method_auth.importAuthorization_param_id_type_int' => 'You cannot use this method directly, use $MadelineProto->importAuthorization($authorization) instead, see https://docs.madelineproto.xyz/docs/LOGIN.html', - 'method_auth.importAuthorization_param_bytes_type_bytes' => 'You cannot use this method directly, use $MadelineProto->importAuthorization($authorization) instead, see https://docs.madelineproto.xyz/docs/LOGIN.html', - 'method_auth.bindTempAuthKey' => 'You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info', - 'method_auth.bindTempAuthKey_param_perm_auth_key_id_type_long' => 'You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info', - 'method_auth.bindTempAuthKey_param_nonce_type_long' => 'You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info', - 'method_auth.bindTempAuthKey_param_expires_at_type_int' => 'You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info', - 'method_auth.bindTempAuthKey_param_encrypted_message_type_bytes' => 'You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info', - 'method_auth.importBotAuthorization' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.importBotAuthorization_param_api_id_type_int' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.importBotAuthorization_param_api_hash_type_string' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.importBotAuthorization_param_bot_auth_token_type_string' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.checkPassword' => 'You cannot use this method directly, use the complete_2fa_login method instead (see https://docs.madelineproto.xyz for more info)', + 'method_auth.exportAuthorization' => 'Returns data for copying authorization to another data-centre.', + 'method_auth.exportAuthorization_param_dc_id_type_int' => 'Number of a target data-centre', + 'method_auth.importAuthorization' => 'Logs in a user using a key transmitted from his native data-centre.', + 'method_auth.importAuthorization_param_id_type_int' => 'User ID', + 'method_auth.importAuthorization_param_bytes_type_bytes' => 'Authorization key', + 'method_auth.bindTempAuthKey' => 'Binds a temporary authorization key `temp_auth_key_id` to the permanent authorization key `perm_auth_key_id`. Each permanent key may only be bound to one temporary key at a time, binding a new temporary key overwrites the previous one. + +For more information, see [Perfect Forward Secrecy](https://core.telegram.org/api/pfs).', + 'method_auth.bindTempAuthKey_param_perm_auth_key_id_type_long' => 'Permanent auth\\_key\\_id to bind to', + 'method_auth.bindTempAuthKey_param_nonce_type_long' => 'Random long from [Binding message contents](#binding-message-contents)', + 'method_auth.bindTempAuthKey_param_expires_at_type_int' => 'Unix timestamp to invalidate temporary key, see [Binding message contents](#binding-message-contents)', + 'method_auth.bindTempAuthKey_param_encrypted_message_type_bytes' => 'See [Generating encrypted\\_message](#generating-encrypted-message)', + 'method_auth.importBotAuthorization' => 'Login as a bot', + 'method_auth.importBotAuthorization_param_api_id_type_int' => 'Application identifier (see. [App configuration](https://core.telegram.org/myapp))', + 'method_auth.importBotAuthorization_param_api_hash_type_string' => 'Application identifier hash (see. [App configuration](https://core.telegram.org/myapp))', + 'method_auth.importBotAuthorization_param_bot_auth_token_type_string' => 'Bot token (see [bots](https://core.telegram.org/bots))', + 'method_auth.checkPassword' => 'Try logging to an account protected by a [2FA password](https://core.telegram.org/api/srp).', 'method_auth.checkPassword_param_password_hash_type_bytes' => 'You cannot use this method directly, use the complete_2fa_login method instead (see https://docs.madelineproto.xyz for more info)', - 'method_auth.requestPasswordRecovery' => 'Send an email to recover the 2FA password', - 'method_auth.recoverPassword' => 'Use the code that was emailed to you after running $MadelineProto->auth->requestPasswordRecovery to login to your account', - 'method_auth.recoverPassword_param_code_type_string' => 'The code that was emailed to you', - 'method_auth.resendCode' => 'Resend the SMS verification code', + 'method_auth.requestPasswordRecovery' => 'Request recovery code of a [2FA password](https://core.telegram.org/api/srp), only for accounts with a [recovery email configured](https://core.telegram.org/api/srp#email-verification).', + 'method_auth.recoverPassword' => 'Reset the [2FA password](https://core.telegram.org/api/srp) using the recovery code sent using [auth.requestPasswordRecovery](../methods/auth.requestPasswordRecovery.md).', + 'method_auth.recoverPassword_param_code_type_string' => 'Code received via email', + 'method_auth.resendCode' => 'Resend the login code via another medium, the phone code type is determined by the return value of the previous auth.sendCode/auth.resendCode: see [login](https://core.telegram.org/api/auth) for more info.', 'method_auth.resendCode_param_phone_number_type_string' => 'The phone number', - 'method_auth.resendCode_param_phone_code_hash_type_string' => 'The phone code hash', - 'method_auth.cancelCode' => 'Invalidate sent phone code', + 'method_auth.resendCode_param_phone_code_hash_type_string' => 'The phone code hash obtained from [auth.sendCode](../methods/auth.sendCode.md)', + 'method_auth.cancelCode' => 'Cancel the login verification code', 'method_auth.cancelCode_param_phone_number_type_string' => 'Phone number', - 'method_auth.cancelCode_param_phone_code_hash_type_string' => 'Phone code hash', - 'method_auth.dropTempAuthKeys' => 'Delete all temporary authorization keys except the ones provided', + 'method_auth.cancelCode_param_phone_code_hash_type_string' => 'Phone code hash from [auth.sendCode](../methods/auth.sendCode.md)', + 'method_auth.dropTempAuthKeys' => 'Delete all temporary authorization keys **except for** the ones specified', 'method_auth.dropTempAuthKeys_param_except_auth_keys_type_Vector t' => 'The temporary authorization keys to keep', - 'method_account.registerDevice' => 'Register device for push notifications', - 'method_account.registerDevice_param_token_type_type_int' => 'Device token type. Possible values: 1 - APNS, 2 - GCM, 3 - MPNS, 4 - Simple Push, 5 - Ubuntu Phone, 6 - Blackberry, and other, see source code of official apps for more info', - 'method_account.registerDevice_param_token_type_string' => 'Device token type. Possible values: 1 - APNS, 2 - GCM, 3 - MPNS, 4 - Simple Push, 5 - Ubuntu Phone,6 - Blackberry, and other, see source code of official apps for more info', - 'method_account.registerDevice_param_app_sandbox_type_Bool' => 'Should the app run in a sandbox?', + 'method_account.registerDevice' => 'Register device to receive [PUSH notifications](https://core.telegram.org/api/push-updates)', + 'method_account.registerDevice_param_token_type_type_int' => 'Device token type.
**Possible values**:
`1` \\- APNS (device token for apple push)
`2` \\- FCM (firebase token for google firebase)
`3` \\- MPNS (channel URI for microsoft push)
`4` \\- Simple push (endpoint for firefox\'s simple push API)
`5` \\- Ubuntu phone (token for ubuntu push)
`6` \\- Blackberry (token for blackberry push)
`7` \\- Unused
`8` \\- WNS (windows push)
`9` \\- APNS VoIP (token for apple push VoIP)
`10` \\- Web push (web push, see below)
`11` \\- MPNS VoIP (token for microsoft push VoIP)
`12` \\- Tizen (token for tizen push)

For `10` web push, the token must be a JSON-encoded object containing the keys described in [PUSH updates](https://core.telegram.org/api/push-updates)', + 'method_account.registerDevice_param_token_type_string' => 'Device token', + 'method_account.registerDevice_param_app_sandbox_type_Bool' => 'If [(boolTrue)](../constructors/boolTrue.md) is transmitted, a sandbox-certificate will be used during transmission.', 'method_account.registerDevice_param_other_uids_type_Vector t' => 'Other UIDs', - 'method_account.unregisterDevice' => 'Stop sending PUSH notifications to app', - 'method_account.unregisterDevice_param_token_type_type_int' => 'Device token type. Possible values: 1 - APNS, 2 - GCM, 3 - MPNS, 4 - Simple Push, 5 - Ubuntu Phone,6 - Blackberry, and other, see source code of official apps for more info', - 'method_account.unregisterDevice_param_token_type_string' => 'Device token type. Possible values: 1 - APNS, 2 - GCM, 3 - MPNS, 4 - Simple Push, 5 - Ubuntu Phone,6 - Blackberry, and other, see source code of official apps for more info', + 'method_account.unregisterDevice' => 'Deletes a device by its token, stops sending PUSH-notifications to it.', + 'method_account.unregisterDevice_param_token_type_type_int' => 'Device token type.
**Possible values**:
`1` \\- APNS (device token for apple push)
`2` \\- FCM (firebase token for google firebase)
`3` \\- MPNS (channel URI for microsoft push)
`4` \\- Simple push (endpoint for firefox\'s simple push API)
`5` \\- Ubuntu phone (token for ubuntu push)
`6` \\- Blackberry (token for blackberry push)
`7` \\- Unused
`8` \\- WNS (windows push)
`9` \\- APNS VoIP (token for apple push VoIP)
`10` \\- Web push (web push, see below)
`11` \\- MPNS VoIP (token for microsoft push VoIP)
`12` \\- Tizen (token for tizen push)

For `10` web push, the token must be a JSON-encoded object containing the keys described in [PUSH updates](https://core.telegram.org/api/push-updates)', + 'method_account.unregisterDevice_param_token_type_string' => 'Device token', 'method_account.unregisterDevice_param_other_uids_type_Vector t' => 'Other UIDs', - 'method_account.updateNotifySettings' => 'Change notification settings', - 'method_account.updateNotifySettings_param_peer_type_InputNotifyPeer' => 'The peers to which the notification settings should be applied', + 'method_account.updateNotifySettings' => 'Edits notification settings from a given user/group, from all users/all groups.', + 'method_account.updateNotifySettings_param_peer_type_InputNotifyPeer' => 'Notification source', 'method_account.updateNotifySettings_param_settings_type_InputPeerNotifySettings' => 'Notification settings', - 'method_account.getNotifySettings' => 'Get notification settings', - 'method_account.getNotifySettings_param_peer_type_InputNotifyPeer' => 'Notification source ', - 'method_account.resetNotifySettings' => 'Reset all notification settings', - 'method_account.updateProfile' => 'Update profile info', - 'method_account.updateProfile_param_first_name_type_string' => 'The first name', - 'method_account.updateProfile_param_last_name_type_string' => 'The last name', - 'method_account.updateProfile_param_about_type_string' => 'The bio/about field', - 'method_account.updateStatus' => 'Update online status', - 'method_account.updateStatus_param_offline_type_Bool' => 'True to set the status to offline', + 'method_account.getNotifySettings' => 'Gets current notification settings for a given user/group, from all users/all groups.', + 'method_account.getNotifySettings_param_peer_type_InputNotifyPeer' => 'Notification source', + 'method_account.resetNotifySettings' => 'Resets all notification settings from users and groups.', + 'method_account.updateProfile' => 'Updates user profile.', + 'method_account.updateProfile_param_first_name_type_string' => 'New user first name', + 'method_account.updateProfile_param_last_name_type_string' => 'New user last name', + 'method_account.updateProfile_param_about_type_string' => 'New bio', + 'method_account.updateStatus' => 'Updates online user status.', + 'method_account.updateStatus_param_offline_type_Bool' => 'If [(boolTrue)](../constructors/boolTrue.md) is transmitted, user status will change to [(userStatusOffline)](../constructors/userStatusOffline.md).', 'method_account.getWallPapers' => 'Returns a list of available wallpapers.', - 'method_account.reportPeer' => 'Report for spam', + 'method_account.reportPeer' => 'Report a peer for violation of telegram\'s Terms of Service', 'method_account.reportPeer_param_peer_type_InputPeer' => 'The peer to report', - 'method_account.reportPeer_param_reason_type_ReportReason' => 'Why are you reporting this peer', - 'method_account.checkUsername' => 'Check if this username is available', - 'method_account.checkUsername_param_username_type_string' => 'The username to check', - 'method_account.updateUsername' => 'Update this user\'s username', - 'method_account.updateUsername_param_username_type_string' => 'The new username', - 'method_account.getPrivacy' => 'Get privacy settings', - 'method_account.getPrivacy_param_key_type_InputPrivacyKey' => 'Privacy setting key', - 'method_account.setPrivacy' => 'Set privacy settings', - 'method_account.setPrivacy_param_key_type_InputPrivacyKey' => 'Privacy setting', + 'method_account.reportPeer_param_reason_type_ReportReason' => 'The reason why this peer is being reported', + 'method_account.checkUsername' => 'Validates a username and checks availability.', + 'method_account.checkUsername_param_username_type_string' => 'username
Accepted characters: A-z (case-insensitive), 0-9 and underscores.
Length: 5-32 characters.', + 'method_account.updateUsername' => 'Changes username for the current user.', + 'method_account.updateUsername_param_username_type_string' => 'username or empty string if username is to be removed
Accepted characters: a-z (case-insensitive), 0-9 and underscores.
Length: 5-32 characters.', + 'method_account.getPrivacy' => 'Get privacy settings of current account', + 'method_account.getPrivacy_param_key_type_InputPrivacyKey' => 'Peer category whose privacy settings should be fetched', + 'method_account.setPrivacy' => 'Change privacy settings of current account', + 'method_account.setPrivacy_param_key_type_InputPrivacyKey' => 'Peers to which the privacy rules apply', 'method_account.setPrivacy_param_rules_type_Vector t' => 'Privacy settings', - 'method_account.deleteAccount' => 'Delete this account', - 'method_account.deleteAccount_param_reason_type_string' => 'Why are you going away? :(', - 'method_account.getAccountTTL' => 'Get account TTL', - 'method_account.setAccountTTL' => 'Set account TTL', - 'method_account.setAccountTTL_param_ttl_type_AccountDaysTTL' => 'Time To Live of account', - 'method_account.sendChangePhoneCode' => 'Change the phone number', + 'method_account.deleteAccount' => 'Delete the user\'s account from the telegram servers. Can be used, for example, to delete the account of a user that provided the login code, but forgot the [2FA password and no recovery method is configured](https://core.telegram.org/api/srp).', + 'method_account.deleteAccount_param_reason_type_string' => 'Why is the account being deleted, can be empty', + 'method_account.getAccountTTL' => 'Get days to live of account', + 'method_account.setAccountTTL' => 'Set account self-destruction period', + 'method_account.setAccountTTL_param_ttl_type_AccountDaysTTL' => 'Time to live in days', + 'method_account.sendChangePhoneCode' => 'Verify a new phone number to associate to the current account', 'method_account.sendChangePhoneCode_param_allow_flashcall_type_true' => 'Can the code be sent using a flash call instead of an SMS?', 'method_account.sendChangePhoneCode_param_phone_number_type_string' => 'New phone number', 'method_account.sendChangePhoneCode_param_current_number_type_Bool' => 'Current phone number', - 'method_account.changePhone' => 'Change the phone number associated to this account', - 'method_account.changePhone_param_phone_number_type_string' => 'Phone number', - 'method_account.changePhone_param_phone_code_hash_type_string' => 'Phone code hash returned by account.sendChangePhoneCode', - 'method_account.changePhone_param_phone_code_type_string' => 'The phone code sent by account.sendChangePhoneCode', - 'method_account.updateDeviceLocked' => 'Disable all notifications for a certain period', - 'method_account.updateDeviceLocked_param_period_type_int' => 'For how long should notifications be disabled', - 'method_account.getAuthorizations' => 'Get all logged-in authorizations', - 'method_account.resetAuthorization' => 'Delete a certain session', - 'method_account.resetAuthorization_param_hash_type_long' => 'The session hash, obtained from $MadelineProto->account->getAuthorizations', - 'method_account.getPassword' => 'Get the current password', - 'method_account.getPasswordSettings' => 'Get the current 2FA settings', + 'method_account.changePhone' => 'Change the phone number of the current account', + 'method_account.changePhone_param_phone_number_type_string' => 'New phone number', + 'method_account.changePhone_param_phone_code_hash_type_string' => 'Phone code hash received when calling [account.sendChangePhoneCode](../methods/account.sendChangePhoneCode.md)', + 'method_account.changePhone_param_phone_code_type_string' => 'Phone code received when calling [account.sendChangePhoneCode](../methods/account.sendChangePhoneCode.md)', + 'method_account.updateDeviceLocked' => 'When client-side passcode lock feature is enabled, will not show message texts in incoming [PUSH notifications](https://core.telegram.org/api/push-updates).', + 'method_account.updateDeviceLocked_param_period_type_int' => 'Inactivity period after which to start hiding message texts in [PUSH notifications](https://core.telegram.org/api/push-updates).', + 'method_account.getAuthorizations' => 'Get logged-in sessions', + 'method_account.resetAuthorization' => 'Log out an active [authorized session](https://core.telegram.org/api/auth) by its hash', + 'method_account.resetAuthorization_param_hash_type_long' => 'Session hash', + 'method_account.getPassword' => 'Obtain configuration for two-factor authorization with password', + 'method_account.getPasswordSettings' => 'Get private info associated to the password info (recovery email, telegram [passport](https://core.telegram.org/passport) info & so on)', 'method_account.getPasswordSettings_param_current_password_hash_type_bytes' => 'Use only if you have set a 2FA password: `$current_salt = $MadelineProto->account->getPassword()[\'current_salt\']; $current_password_hash = hash(\'sha256\', $current_salt.$password.$current_salt, true);`', - 'method_account.updatePasswordSettings' => 'You cannot use this method directly; use $MadelineProto->update_2fa($params), instead (see https://docs.madelineproto.xyz for more info)', + 'method_account.updatePasswordSettings' => 'Set a new 2FA password', 'method_account.updatePasswordSettings_param_current_password_hash_type_bytes' => 'Use only if you have set a 2FA password: `$current_salt = $MadelineProto->account->getPassword()[\'current_salt\']; $current_password_hash = hash(\'sha256\', $current_salt.$password.$current_salt, true);`', - 'method_account.updatePasswordSettings_param_new_settings_type_account.PasswordInputSettings' => 'New 2FA settings', - 'method_account.sendConfirmPhoneCode' => 'Send confirmation phone code', + 'method_account.updatePasswordSettings_param_new_settings_type_account.PasswordInputSettings' => 'The new password (see [SRP](https://core.telegram.org/api/srp))', + 'method_account.sendConfirmPhoneCode' => 'Send confirmation code to cancel account deletion, for more info [click here »](https://core.telegram.org/api/account-deletion)', 'method_account.sendConfirmPhoneCode_param_allow_flashcall_type_true' => 'Can telegram call you instead of sending an SMS?', - 'method_account.sendConfirmPhoneCode_param_hash_type_string' => 'The hash', + 'method_account.sendConfirmPhoneCode_param_hash_type_string' => 'The hash from the service notification, for more info [click here »](https://core.telegram.org/api/account-deletion)', 'method_account.sendConfirmPhoneCode_param_current_number_type_Bool' => 'The current phone number', - 'method_account.confirmPhone' => 'Confirm this phone number is associated to this account, obtain phone_code_hash from sendConfirmPhoneCode', - 'method_account.confirmPhone_param_phone_code_hash_type_string' => 'Obtain phone_code_hash from sendConfirmPhoneCode', - 'method_account.confirmPhone_param_phone_code_type_string' => 'The code sent by sendConfirmPhoneCode', - 'method_account.getTmpPassword' => 'Get temporary password for buying products through bots', + 'method_account.confirmPhone' => 'Confirm a phone number to cancel account deletion, for more info [click here »](https://core.telegram.org/api/account-deletion)', + 'method_account.confirmPhone_param_phone_code_hash_type_string' => 'Phone code hash, for more info [click here »](https://core.telegram.org/api/account-deletion)', + 'method_account.confirmPhone_param_phone_code_type_string' => 'SMS code, for more info [click here »](https://core.telegram.org/api/account-deletion)', + 'method_account.getTmpPassword' => 'Get temporary payment password', 'method_account.getTmpPassword_param_password_hash_type_bytes' => 'The password hash', - 'method_account.getTmpPassword_param_period_type_int' => 'The validity period', - 'method_account.getWebAuthorizations' => 'Get telegram web login authorizations', - 'method_account.resetWebAuthorization' => 'Delete a certain telegram web login authorization', - 'method_account.resetWebAuthorization_param_hash_type_long' => 'The authorization\'s hash', - 'method_account.resetWebAuthorizations' => 'Reset all telegram web login authorizations', - 'method_users.getUsers' => 'Get info about users', + 'method_account.getTmpPassword_param_period_type_int' => 'Time during which the temporary password will be valid, in seconds; should be between 60 and 86400', + 'method_account.getWebAuthorizations' => 'Get web [login widget](https://core.telegram.org/widgets/login) authorizations', + 'method_account.resetWebAuthorization' => 'Log out an active web [telegram login](https://core.telegram.org/widgets/login) session', + 'method_account.resetWebAuthorization_param_hash_type_long' => '[Session](../constructors/webAuthorization.md) hash', + 'method_account.resetWebAuthorizations' => 'Reset all active web [telegram login](https://core.telegram.org/widgets/login) sessions', + 'method_users.getUsers' => 'Returns basic user info according to their identifiers.', 'method_users.getUsers_param_id_type_Vector t' => 'The ids of the users', - 'method_users.getFullUser' => 'You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)', - 'method_users.getFullUser_param_id_type_InputUser' => 'You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)', - 'method_contacts.getStatuses' => 'Get online status of all users', - 'method_contacts.getContacts' => 'Get all contacts', - 'method_contacts.getContacts_param_hash_type_int' => 'User ids of contacts previously fetched with this method', - 'method_contacts.importContacts' => 'Add phone number as contact', + 'method_users.getFullUser' => 'Returns extended user info by ID.', + 'method_users.getFullUser_param_id_type_InputUser' => 'User ID', + 'method_contacts.getStatuses' => 'Returns the list of contact statuses.', + 'method_contacts.getContacts' => 'Returns the current user\'s contact list.', + 'method_contacts.getContacts_param_hash_type_int' => 'If there already is a full contact list on the client, a [hash](https://core.telegram.org/api/offsets#hash-generation) of a the list of contact IDs in ascending order may be passed in this parameter. If the contact set was not changed, [(contacts.contactsNotModified)](../constructors/contacts.contactsNotModified.md) will be returned.', + 'method_contacts.importContacts' => 'Imports contacts: saves a full list on the server, adds already registered contacts to the contact list, returns added contacts and their info.', 'method_contacts.importContacts_param_contacts_type_Vector t' => 'The numbers to import', 'method_contacts.deleteContact' => 'Delete a contact', 'method_contacts.deleteContact_param_id_type_InputUser' => 'The contact to delete', - 'method_contacts.deleteContacts' => 'Delete multiple contacts', + 'method_contacts.deleteContacts' => 'Deletes several contacts from the list.', 'method_contacts.deleteContacts_param_id_type_Vector t' => 'The contacts to delete', - 'method_contacts.block' => 'Block a user', - 'method_contacts.block_param_id_type_InputUser' => 'The user to block', - 'method_contacts.unblock' => 'Unblock a user', - 'method_contacts.unblock_param_id_type_InputUser' => 'The user to unblock', - 'method_contacts.getBlocked' => 'Get blocked users', - 'method_contacts.getBlocked_param_offset_type_int' => 'Initially 0, then set to the number of blocked contacts previously fetched', - 'method_contacts.getBlocked_param_limit_type_int' => 'How many blocked contacts to fetch', + 'method_contacts.block' => 'Adds the user to the blacklist.', + 'method_contacts.block_param_id_type_InputUser' => 'User ID', + 'method_contacts.unblock' => 'Deletes the user from the blacklist.', + 'method_contacts.unblock_param_id_type_InputUser' => 'User ID', + 'method_contacts.getBlocked' => 'Returns the list of blocked users.', + 'method_contacts.getBlocked_param_offset_type_int' => 'The number of list elements to be skipped', + 'method_contacts.getBlocked_param_limit_type_int' => 'The number of list elements to be returned', 'method_contacts.exportCard' => 'Export contact as card', 'method_contacts.importCard' => 'Import card as contact', 'method_contacts.importCard_param_export_card_type_Vector t' => 'The card', - 'method_contacts.search' => 'Search contacts', - 'method_contacts.search_param_q_type_string' => 'The search query', - 'method_contacts.search_param_limit_type_int' => 'How many results should be returned', - 'method_contacts.resolveUsername' => 'You cannot use this method directly, use the resolveUsername, getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)', - 'method_contacts.resolveUsername_param_username_type_string' => 'You cannot use this method directly, use the resolveUsername, getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)', - 'method_contacts.getTopPeers' => 'Get most used chats', - 'method_contacts.getTopPeers_param_correspondents_type_true' => 'Fetch users?', - 'method_contacts.getTopPeers_param_bots_pm_type_true' => 'Fetch bots?', - 'method_contacts.getTopPeers_param_bots_inline_type_true' => 'Fetch inline bots?', - 'method_contacts.getTopPeers_param_phone_calls_type_true' => 'Fetch phone calls?', - 'method_contacts.getTopPeers_param_groups_type_true' => 'Fetch groups?', - 'method_contacts.getTopPeers_param_channels_type_true' => 'Fetch channels and supergroups?', - 'method_contacts.getTopPeers_param_offset_type_int' => 'Initially 0, then `$offset += $contacts_TopPeers[\'categories\'][\'count\'];`', - 'method_contacts.getTopPeers_param_limit_type_int' => 'How many results to fetch', - 'method_contacts.getTopPeers_param_hash_type_int' => 'Peer ids previously fetched with this method', - 'method_contacts.resetTopPeerRating' => 'Reset top peer rating for a certain category/peer', - 'method_contacts.resetTopPeerRating_param_category_type_TopPeerCategory' => 'The category ', - 'method_contacts.resetTopPeerRating_param_peer_type_InputPeer' => 'The peer', - 'method_contacts.resetSaved' => 'Reset saved contacts', - 'method_messages.getMessages' => 'Get messages', + 'method_contacts.search' => 'Returns users found by username substring.', + 'method_contacts.search_param_q_type_string' => 'Target substring', + 'method_contacts.search_param_limit_type_int' => 'Maximum number of users to be returned', + 'method_contacts.resolveUsername' => 'Resolve a @username to get peer info', + 'method_contacts.resolveUsername_param_username_type_string' => '@username to resolve', + 'method_contacts.getTopPeers' => 'Get most used peers', + 'method_contacts.getTopPeers_param_correspondents_type_true' => 'Users we\'ve chatted most frequently with', + 'method_contacts.getTopPeers_param_bots_pm_type_true' => 'Most used bots', + 'method_contacts.getTopPeers_param_bots_inline_type_true' => 'Most used inline bots', + 'method_contacts.getTopPeers_param_phone_calls_type_true' => 'Most frequently called users', + 'method_contacts.getTopPeers_param_groups_type_true' => 'Often-opened groups and supergroups', + 'method_contacts.getTopPeers_param_channels_type_true' => 'Most frequently visited channels', + 'method_contacts.getTopPeers_param_offset_type_int' => 'Offset for [pagination](https://core.telegram.org/api/offsets)', + 'method_contacts.getTopPeers_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)', + 'method_contacts.getTopPeers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', + 'method_contacts.resetTopPeerRating' => 'Reset [rating](https://core.telegram.org/api/top-rating) of top peer', + 'method_contacts.resetTopPeerRating_param_category_type_TopPeerCategory' => 'Top peer category', + 'method_contacts.resetTopPeerRating_param_peer_type_InputPeer' => 'Peer whose rating should be reset', + 'method_contacts.resetSaved' => 'Delete saved contacts', + 'method_messages.getMessages' => 'Returns the list of messages by their IDs.', 'method_messages.getMessages_param_id_type_Vector t' => 'The IDs of messages to fetch (only for users and normal groups)', - 'method_messages.getDialogs' => 'Gets list of chats: you should use $MadelineProto->getDialogs() instead: https://docs.madelineproto.xyz/docs/DIALOGS.html', - 'method_messages.getDialogs_param_exclude_pinned_type_true' => 'Do not fetch pinned chats', - 'method_messages.getDialogs_param_offset_date_type_int' => 'End($res[\'messages\'])[\'date\'];', - 'method_messages.getDialogs_param_offset_id_type_int' => 'End($res[\'messages\'])[\'id\'];', - 'method_messages.getDialogs_param_offset_peer_type_InputPeer' => 'End($res[\'dialogs\'])[\'peer\'];', - 'method_messages.getDialogs_param_limit_type_int' => 'Number of dialogs to fetch', - 'method_messages.getHistory' => 'Get previous messages of a group', - 'method_messages.getHistory_param_peer_type_InputPeer' => 'The chat', - 'method_messages.getHistory_param_offset_id_type_int' => 'The last fetched message ID, initially 0', - 'method_messages.getHistory_param_offset_date_type_int' => 'The date of the last previously fetched message, initially 0', - 'method_messages.getHistory_param_add_offset_type_int' => 'Additional offset, can be 0', - 'method_messages.getHistory_param_limit_type_int' => 'Number of messages to fetch', - 'method_messages.getHistory_param_max_id_type_int' => 'Maximum message ID to fetch', - 'method_messages.getHistory_param_min_id_type_int' => 'Minumum message ID to fetch', - 'method_messages.getHistory_param_hash_type_int' => 'List of IDs of already parsed messages', - 'method_messages.search' => 'Search peers or messages', - 'method_messages.search_param_peer_type_InputPeer' => 'Where to search', - 'method_messages.search_param_q_type_string' => 'What to search', - 'method_messages.search_param_from_id_type_InputUser' => 'Show only messages from a certain user?', - 'method_messages.search_param_filter_type_MessagesFilter' => 'Message filter', - 'method_messages.search_param_min_date_type_int' => 'Minumum date of results to fetch', - 'method_messages.search_param_max_date_type_int' => 'Maximum date of results to fetch', - 'method_messages.search_param_offset_id_type_int' => 'Message ID offset', - 'method_messages.search_param_add_offset_type_int' => 'Additional offset, can be 0', - 'method_messages.search_param_limit_type_int' => 'Number of results to return', - 'method_messages.search_param_max_id_type_int' => 'Maximum message id to return', - 'method_messages.search_param_min_id_type_int' => 'Minumum message id to return', - 'method_messages.readHistory' => 'Mark messages as read', - 'method_messages.readHistory_param_peer_type_InputPeer' => 'Where to mark messages as read', - 'method_messages.readHistory_param_max_id_type_int' => 'Maximum message ID to mark as read', - 'method_messages.deleteHistory' => 'Delete chat history', - 'method_messages.deleteHistory_param_just_clear_type_true' => 'Only clear it from your side', - 'method_messages.deleteHistory_param_peer_type_InputPeer' => 'Where to clear it', - 'method_messages.deleteHistory_param_max_id_type_int' => 'Maximum message id of messages to delete', - 'method_messages.deleteMessages' => 'Delete messages', - 'method_messages.deleteMessages_param_revoke_type_true' => 'Delete the messages for everyone?', + 'method_messages.getDialogs' => 'Returns the current user dialog list.', + 'method_messages.getDialogs_param_exclude_pinned_type_true' => 'Exclude pinned dialogs', + 'method_messages.getDialogs_param_offset_date_type_int' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)', + 'method_messages.getDialogs_param_offset_id_type_int' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)', + 'method_messages.getDialogs_param_offset_peer_type_InputPeer' => '[Offset peer for pagination](https://core.telegram.org/api/offsets)', + 'method_messages.getDialogs_param_limit_type_int' => 'Number of list elements to be returned', + 'method_messages.getHistory' => 'Gets back the conversation history with one interlocutor / within a chat', + 'method_messages.getHistory_param_peer_type_InputPeer' => 'Target peer', + 'method_messages.getHistory_param_offset_id_type_int' => 'Only return messages starting from the specified message ID', + 'method_messages.getHistory_param_offset_date_type_int' => 'Only return messages sent after the specified date', + 'method_messages.getHistory_param_add_offset_type_int' => 'Number of list elements to be skipped, negative values are also accepted.', + 'method_messages.getHistory_param_limit_type_int' => 'Number of results to return', + 'method_messages.getHistory_param_max_id_type_int' => 'If a positive value was transferred, the method will return only messages with IDs less than **max\\_id**', + 'method_messages.getHistory_param_min_id_type_int' => 'If a positive value was transferred, the method will return only messages with IDs more than **min\\_id**', + 'method_messages.getHistory_param_hash_type_int' => '[Result hash](https://core.telegram.org/api/offsets)', + 'method_messages.search' => 'Gets back found messages', + 'method_messages.search_param_peer_type_InputPeer' => 'User or chat, histories with which are searched, or [(inputPeerEmpty)](../constructors/inputPeerEmpty.md) constructor for global search', + 'method_messages.search_param_q_type_string' => 'Text search request', + 'method_messages.search_param_from_id_type_InputUser' => 'Only return messages sent by the specified user ID', + 'method_messages.search_param_filter_type_MessagesFilter' => 'Filter to return only specified message types', + 'method_messages.search_param_min_date_type_int' => 'If a positive value was transferred, only messages with a sending date bigger than the transferred one will be returned', + 'method_messages.search_param_max_date_type_int' => 'If a positive value was transferred, only messages with a sending date smaller than the transferred one will be returned', + 'method_messages.search_param_offset_id_type_int' => 'Only return messages starting from the specified message ID', + 'method_messages.search_param_add_offset_type_int' => '[Additional offset](https://core.telegram.org/api/offsets)', + 'method_messages.search_param_limit_type_int' => '[Number of results to return](https://core.telegram.org/api/offsets)', + 'method_messages.search_param_max_id_type_int' => '[Maximum message ID to return](https://core.telegram.org/api/offsets)', + 'method_messages.search_param_min_id_type_int' => '[Minimum message ID to return](https://core.telegram.org/api/offsets)', + 'method_messages.readHistory' => 'Marks message history as read.', + 'method_messages.readHistory_param_peer_type_InputPeer' => 'Target user or group', + 'method_messages.readHistory_param_max_id_type_int' => 'If a positive value is passed, only messages with identifiers less or equal than the given one will be read', + 'method_messages.deleteHistory' => 'Deletes communication history.', + 'method_messages.deleteHistory_param_just_clear_type_true' => 'Just clear history for the current user, without actually removing messages for every chat user', + 'method_messages.deleteHistory_param_peer_type_InputPeer' => 'User or chat, communication history of which will be deleted', + 'method_messages.deleteHistory_param_max_id_type_int' => 'Maximum ID of message to delete', + 'method_messages.deleteMessages' => 'Deletes messages by their identifiers.', + 'method_messages.deleteMessages_param_revoke_type_true' => 'Whether to delete messages for all participants of the chat', 'method_messages.deleteMessages_param_id_type_Vector t' => 'IDs of messages to delete, use channels->deleteMessages for supergroups', - 'method_messages.receivedMessages' => 'Mark messages as read', - 'method_messages.receivedMessages_param_max_id_type_int' => 'Maximum message id of messages to mark as read', - 'method_messages.setTyping' => 'Change typing status', - 'method_messages.setTyping_param_peer_type_InputPeer' => 'Where to change typing status', - 'method_messages.setTyping_param_action_type_SendMessageAction' => 'Typing status', - 'method_messages.sendMessage' => 'Send a message', - 'method_messages.sendMessage_param_no_webpage_type_true' => 'Disable webpage preview?', - 'method_messages.sendMessage_param_silent_type_true' => 'Disable notifications?', - 'method_messages.sendMessage_param_background_type_true' => 'Disable background notifications?', - 'method_messages.sendMessage_param_clear_draft_type_true' => 'Clear the message draft of this chat?', - 'method_messages.sendMessage_param_peer_type_InputPeer' => 'The chat where to send this message', - 'method_messages.sendMessage_param_reply_to_msg_id_type_int' => 'Reply to message by ID', - 'method_messages.sendMessage_param_message_type_string' => 'The message to send', - 'method_messages.sendMessage_param_reply_markup_type_ReplyMarkup' => 'Keyboards to send', + 'method_messages.receivedMessages' => 'Confirms receipt of messages by a client, cancels PUSH-notification sending.', + 'method_messages.receivedMessages_param_max_id_type_int' => 'Maximum message ID available in a client.', + 'method_messages.setTyping' => 'Sends a current user typing event (see [SendMessageAction](../types/SendMessageAction.md) for all event types) to a conversation partner or group.', + 'method_messages.setTyping_param_peer_type_InputPeer' => 'Target user or group', + 'method_messages.setTyping_param_action_type_SendMessageAction' => 'Type of action
Parameter added in [Layer 17](https://core.telegram.org/api/layers#layer-17).', + 'method_messages.sendMessage' => 'Sends a message to a chat', + 'method_messages.sendMessage_param_no_webpage_type_true' => 'Set this flag to disable generation of the webpage preview', + 'method_messages.sendMessage_param_silent_type_true' => 'Send this message silently (no notifications for the receivers)', + 'method_messages.sendMessage_param_background_type_true' => 'Send this message as background message', + 'method_messages.sendMessage_param_clear_draft_type_true' => 'Clear the draft field', + 'method_messages.sendMessage_param_peer_type_InputPeer' => 'The destination where the message will be sent', + 'method_messages.sendMessage_param_reply_to_msg_id_type_int' => 'The message ID to which this message will reply to', + 'method_messages.sendMessage_param_message_type_string' => 'The message', + 'method_messages.sendMessage_param_reply_markup_type_ReplyMarkup' => 'Reply markup for sending bot buttons', 'method_messages.sendMessage_param_entities_type_Vector t' => 'Entities to send (for styled text)', 'method_messages.sendMedia' => 'Send a media', - 'method_messages.sendMedia_param_silent_type_true' => 'Disable notifications?', - 'method_messages.sendMedia_param_background_type_true' => 'Disable background notifications?', - 'method_messages.sendMedia_param_clear_draft_type_true' => 'Clear the message draft of this chat?', - 'method_messages.sendMedia_param_peer_type_InputPeer' => 'Where to send the media', - 'method_messages.sendMedia_param_reply_to_msg_id_type_int' => 'Reply to message by ID', - 'method_messages.sendMedia_param_media_type_InputMedia' => 'The media to send', - 'method_messages.sendMedia_param_message_type_string' => 'The caption', - 'method_messages.sendMedia_param_reply_markup_type_ReplyMarkup' => 'Keyboards to send', + 'method_messages.sendMedia_param_silent_type_true' => 'Send message silently (no notification should be triggered)', + 'method_messages.sendMedia_param_background_type_true' => 'Send message in background', + 'method_messages.sendMedia_param_clear_draft_type_true' => 'Clear the draft', + 'method_messages.sendMedia_param_peer_type_InputPeer' => 'Destination', + 'method_messages.sendMedia_param_reply_to_msg_id_type_int' => 'Message ID to which this message should reply to', + 'method_messages.sendMedia_param_media_type_InputMedia' => 'Attached media', + 'method_messages.sendMedia_param_message_type_string' => 'Caption', + 'method_messages.sendMedia_param_reply_markup_type_ReplyMarkup' => 'Reply markup for bot keyboards', 'method_messages.sendMedia_param_entities_type_Vector t' => 'Entities for styled text', - 'method_messages.forwardMessages' => 'Forward messages', - 'method_messages.forwardMessages_param_silent_type_true' => 'Disable notifications', - 'method_messages.forwardMessages_param_background_type_true' => 'Disable background notifications', - 'method_messages.forwardMessages_param_with_my_score_type_true' => 'If forwarding a game, forward your score, too', - 'method_messages.forwardMessages_param_grouped_type_true' => 'Set to true if forwarding albums', - 'method_messages.forwardMessages_param_from_peer_type_InputPeer' => 'From where to forward the messages', + 'method_messages.forwardMessages' => 'Forwards messages by their IDs.', + 'method_messages.forwardMessages_param_silent_type_true' => 'Whether to send messages silently (no notification will be triggered on the destination clients)', + 'method_messages.forwardMessages_param_background_type_true' => 'Whether to send the message in background', + 'method_messages.forwardMessages_param_with_my_score_type_true' => 'When forwarding games, whether to include your score in the game', + 'method_messages.forwardMessages_param_grouped_type_true' => 'Whether the specified messages represent an album (grouped media)', + 'method_messages.forwardMessages_param_from_peer_type_InputPeer' => 'Source of messages', 'method_messages.forwardMessages_param_id_type_Vector t' => 'The message IDs', - 'method_messages.forwardMessages_param_to_peer_type_InputPeer' => 'Where to forward the messages', - 'method_messages.reportSpam' => 'Report a peer for spam', - 'method_messages.reportSpam_param_peer_type_InputPeer' => 'The peer to report', + 'method_messages.forwardMessages_param_to_peer_type_InputPeer' => 'Destination peer', + 'method_messages.reportSpam' => 'Report a new incoming chat for spam, if the [peer settings](../constructors/peerSettings.md) of the chat allow us to do that', + 'method_messages.reportSpam_param_peer_type_InputPeer' => 'Peer to report', 'method_messages.hideReportSpam' => 'Hide report spam popup', 'method_messages.hideReportSpam_param_peer_type_InputPeer' => 'Where to hide the popup', - 'method_messages.getPeerSettings' => 'Get the settings of apeer', + 'method_messages.getPeerSettings' => 'Get peer settings', 'method_messages.getPeerSettings_param_peer_type_InputPeer' => 'The peer', - 'method_messages.getChats' => 'Get info about chats', + 'method_messages.getChats' => 'Returns chat basic info on their IDs.', 'method_messages.getChats_param_id_type_Vector t' => 'The MTProto IDs of chats to fetch info about', - 'method_messages.getFullChat' => 'You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)', + 'method_messages.getFullChat' => 'Returns full chat info according to its ID.', 'method_messages.getFullChat_param_chat_id_type_InputPeer' => 'You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)', - 'method_messages.editChatTitle' => 'Edit the title of a normal chat (not supergroup)', + 'method_messages.editChatTitle' => 'Chanages chat name and sends a service message on it.', 'method_messages.editChatTitle_param_chat_id_type_InputPeer' => 'The ID of the chat', - 'method_messages.editChatTitle_param_title_type_string' => 'The new title', - 'method_messages.editChatPhoto' => 'Edit the photo of a normal chat (not supergroup)', + 'method_messages.editChatTitle_param_title_type_string' => 'New chat name, different from the old one', + 'method_messages.editChatPhoto' => 'Changes chat photo and sends a service message on it', 'method_messages.editChatPhoto_param_chat_id_type_InputPeer' => 'The ID of the chat', - 'method_messages.editChatPhoto_param_photo_type_InputChatPhoto' => 'The new phto', - 'method_messages.addChatUser' => 'Add a user to a normal chat (use channels->inviteToChannel for supergroups)', + 'method_messages.editChatPhoto_param_photo_type_InputChatPhoto' => 'Photo to be set', + 'method_messages.addChatUser' => 'Adds a user to a chat and sends a service message on it.', 'method_messages.addChatUser_param_chat_id_type_InputPeer' => 'The chat where to invite users', - 'method_messages.addChatUser_param_user_id_type_InputUser' => 'The user to invite', - 'method_messages.addChatUser_param_fwd_limit_type_int' => 'Number of old messages the user will see', - 'method_messages.deleteChatUser' => 'Delete a user from a chat (not supergroup)', + 'method_messages.addChatUser_param_user_id_type_InputUser' => 'User ID to be added', + 'method_messages.addChatUser_param_fwd_limit_type_int' => 'Number of last messages to be forwarded', + 'method_messages.deleteChatUser' => 'Deletes a user from a chat and sends a service message on it.', 'method_messages.deleteChatUser_param_chat_id_type_InputPeer' => 'The ID of the chat', - 'method_messages.deleteChatUser_param_user_id_type_InputUser' => 'The user to delete (pass @me to leave the chat)', - 'method_messages.createChat' => 'Create a chat (not supergroup)', + 'method_messages.deleteChatUser_param_user_id_type_InputUser' => 'User ID to be deleted', + 'method_messages.createChat' => 'Creates a new chat.', 'method_messages.createChat_param_users_type_Vector t' => 'The users to add to the chat', - 'method_messages.createChat_param_title_type_string' => 'The new chat\'s title', - 'method_messages.getDhConfig' => 'You cannot use this method directly, instead use $MadelineProto->getDhConfig();', - 'method_messages.getDhConfig_param_version_type_int' => 'You cannot use this method directly, instead use $MadelineProto->getDhConfig();', - 'method_messages.getDhConfig_param_random_length_type_int' => 'You cannot use this method directly, instead use $MadelineProto->getDhConfig();', - 'method_messages.requestEncryption' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats', - 'method_messages.requestEncryption_param_user_id_type_InputUser' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats', - 'method_messages.requestEncryption_param_g_a_type_bytes' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats', - 'method_messages.acceptEncryption' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats', - 'method_messages.acceptEncryption_param_peer_type_InputEncryptedChat' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats', - 'method_messages.acceptEncryption_param_g_b_type_bytes' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats', - 'method_messages.acceptEncryption_param_key_fingerprint_type_long' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats', - 'method_messages.discardEncryption' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats', - 'method_messages.discardEncryption_param_chat_id_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats', - 'method_messages.setEncryptedTyping' => 'Send typing notification to secret chat', - 'method_messages.setEncryptedTyping_param_peer_type_InputEncryptedChat' => 'The secret chat where to send the notification', - 'method_messages.setEncryptedTyping_param_typing_type_Bool' => 'Set to true to enable the notification, false to disable it', - 'method_messages.readEncryptedHistory' => 'Mark messages as read in secret chats', - 'method_messages.readEncryptedHistory_param_peer_type_InputEncryptedChat' => 'The secret chat where to mark messages as read', - 'method_messages.readEncryptedHistory_param_max_date_type_int' => 'Maximum date of messages to mark', - 'method_messages.sendEncrypted' => 'Send message to secret chat', - 'method_messages.sendEncrypted_param_peer_type_InputEncryptedChat' => 'The chat where to send the message', + 'method_messages.createChat_param_title_type_string' => 'Chat name', + 'method_messages.getDhConfig' => 'Returns configuration parameters for Diffie-Hellman key generation. Can also return a random sequence of bytes of required length.', + 'method_messages.getDhConfig_param_version_type_int' => 'Value of the **version** parameter from [messages.dhConfig](../constructors/messages.dhConfig.md), avialable at the client', + 'method_messages.getDhConfig_param_random_length_type_int' => 'Length of the required random sequence', + 'method_messages.requestEncryption' => 'Sends a request to start a secret chat to the user.', + 'method_messages.requestEncryption_param_user_id_type_InputUser' => 'User ID', + 'method_messages.requestEncryption_param_g_a_type_bytes' => '`A = g ^ a mod p`, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange)', + 'method_messages.acceptEncryption' => 'Confirms creation of a secret chat', + 'method_messages.acceptEncryption_param_peer_type_InputEncryptedChat' => 'Secret chat ID', + 'method_messages.acceptEncryption_param_g_b_type_bytes' => '`B = g ^ b mod p`, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange)', + 'method_messages.acceptEncryption_param_key_fingerprint_type_long' => '64-bit fingerprint of the received key', + 'method_messages.discardEncryption' => 'Cancels a request for creation and/or delete info on secret chat.', + 'method_messages.discardEncryption_param_chat_id_type_int' => 'Secret chat ID', + 'method_messages.setEncryptedTyping' => 'Send typing event by the current user to a secret chat.', + 'method_messages.setEncryptedTyping_param_peer_type_InputEncryptedChat' => 'Secret chat ID', + 'method_messages.setEncryptedTyping_param_typing_type_Bool' => 'Typing.
**Possible values**:
[(boolTrue)](../constructors/boolTrue.md), if the user started typing and more than **5 seconds** have passed since the last request
[(boolFalse)](../constructors/boolFalse.md), if the user stopped typing', + 'method_messages.readEncryptedHistory' => 'Marks message history within a secret chat as read.', + 'method_messages.readEncryptedHistory_param_peer_type_InputEncryptedChat' => 'Secret chat ID', + 'method_messages.readEncryptedHistory_param_max_date_type_int' => 'Maximum date value for received messages in history', + 'method_messages.sendEncrypted' => 'Sends a text message to a secret chat.', + 'method_messages.sendEncrypted_param_peer_type_InputEncryptedChat' => 'Secret chat ID', 'method_messages.sendEncrypted_param_message_type_DecryptedMessage' => 'The message to send', - 'method_messages.sendEncryptedFile' => 'Send a file to a secret chat', - 'method_messages.sendEncryptedFile_param_peer_type_InputEncryptedChat' => 'The chat where to send the file', + 'method_messages.sendEncryptedFile' => 'Sends a message with a file attachment to a secret chat', + 'method_messages.sendEncryptedFile_param_peer_type_InputEncryptedChat' => 'Secret chat ID', 'method_messages.sendEncryptedFile_param_message_type_DecryptedMessage' => 'The message with the file', - 'method_messages.sendEncryptedFile_param_file_type_InputEncryptedFile' => 'The file (optional)', - 'method_messages.sendEncryptedService' => 'Send a service message to a secret chat', - 'method_messages.sendEncryptedService_param_peer_type_InputEncryptedChat' => 'The chat where to send the service message', + 'method_messages.sendEncryptedFile_param_file_type_InputEncryptedFile' => 'File attachment for the secret chat', + 'method_messages.sendEncryptedService' => 'Sends a service message to a secret chat.', + 'method_messages.sendEncryptedService_param_peer_type_InputEncryptedChat' => 'Secret chat ID', 'method_messages.sendEncryptedService_param_message_type_DecryptedMessage' => 'The service message', - 'method_messages.receivedQueue' => 'You cannot use this method directly', - 'method_messages.receivedQueue_param_max_qts_type_int' => 'You cannot use this method directly', - 'method_messages.reportEncryptedSpam' => 'Report for spam a secret chat', - 'method_messages.reportEncryptedSpam_param_peer_type_InputEncryptedChat' => 'The chat to report', - 'method_messages.readMessageContents' => 'Mark message as read', + 'method_messages.receivedQueue' => 'Confirms receipt of messages in a secret chat by client, cancels push notifications.', + 'method_messages.receivedQueue_param_max_qts_type_int' => 'Maximum qts value available at the client', + 'method_messages.reportEncryptedSpam' => 'Report a secret chat for spam', + 'method_messages.reportEncryptedSpam_param_peer_type_InputEncryptedChat' => 'The secret chat to report', + 'method_messages.readMessageContents' => 'Notifies the sender about the recipient having listened a voice message or watched a video.', 'method_messages.readMessageContents_param_id_type_Vector t' => 'The messages to mark as read (only users and normal chats, not supergroups)', - 'method_messages.getStickers' => 'Get stickers', - 'method_messages.getStickers_param_emoticon_type_string' => 'Search by emoji', + 'method_messages.getStickers' => 'Get stickers by emoji', + 'method_messages.getStickers_param_emoticon_type_string' => 'The emoji', 'method_messages.getStickers_param_hash_type_string' => 'Previously fetched sticker IDs', - 'method_messages.getAllStickers' => 'Get all stickerpacks', - 'method_messages.getAllStickers_param_hash_type_int' => '0 or $result[\'hash\']', - 'method_messages.getWebPagePreview' => 'Get webpage preview', - 'method_messages.getWebPagePreview_param_message_type_string' => 'Extract preview from this message', + 'method_messages.getAllStickers' => 'Get all installed stickers', + 'method_messages.getAllStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', + 'method_messages.getWebPagePreview' => 'Get preview of webpage', + 'method_messages.getWebPagePreview_param_message_type_string' => 'Message from which to extract the preview', 'method_messages.getWebPagePreview_param_entities_type_Vector t' => 'Entities for styled text', - 'method_messages.exportChatInvite' => 'Export chat invite ', + 'method_messages.exportChatInvite' => 'Export an invite link for a chat', 'method_messages.exportChatInvite_param_chat_id_type_InputPeer' => 'The chat id ', - 'method_messages.checkChatInvite' => 'Check if an invitation link is valid', - 'method_messages.checkChatInvite_param_hash_type_string' => 'The invite link in t.me/joinchat/aflakf format', - 'method_messages.importChatInvite' => 'Import chat invite', - 'method_messages.importChatInvite_param_hash_type_string' => 'The invite link in t.me/joinchat/aflakf format', - 'method_messages.getStickerSet' => 'Get a stickerset', - 'method_messages.getStickerSet_param_stickerset_type_InputStickerSet' => 'The stickerset to get', - 'method_messages.installStickerSet' => 'Add a sticker set', - 'method_messages.installStickerSet_param_stickerset_type_InputStickerSet' => 'The sticker set to add', - 'method_messages.installStickerSet_param_archived_type_Bool' => 'Archive this set?', - 'method_messages.uninstallStickerSet' => 'Remove a sticker set', - 'method_messages.uninstallStickerSet_param_stickerset_type_InputStickerSet' => 'The sticker set to remove', - 'method_messages.startBot' => 'Start a bot', - 'method_messages.startBot_param_bot_type_InputUser' => 'The bot\'s ID or username', - 'method_messages.startBot_param_peer_type_InputPeer' => 'Where to start the bot (@me or group ID/username)', - 'method_messages.startBot_param_start_param_type_string' => 'The bot\'s start parameter', - 'method_messages.getMessagesViews' => 'Get and increase message views', - 'method_messages.getMessagesViews_param_peer_type_InputPeer' => 'The chat where the message is located', + 'method_messages.checkChatInvite' => 'Check the validity of a chat invite link and get basic info about it', + 'method_messages.checkChatInvite_param_hash_type_string' => 'Invite hash in `t.me/joinchat/hash`', + 'method_messages.importChatInvite' => 'Import a chat invite and join a private chat/supergroup/channel', + 'method_messages.importChatInvite_param_hash_type_string' => '`hash` from `t.me/joinchat/hash`', + 'method_messages.getStickerSet' => 'Get info about a stickerset', + 'method_messages.getStickerSet_param_stickerset_type_InputStickerSet' => 'Stickerset', + 'method_messages.installStickerSet' => 'Install a stickerset', + 'method_messages.installStickerSet_param_stickerset_type_InputStickerSet' => 'Stickerset to install', + 'method_messages.installStickerSet_param_archived_type_Bool' => 'Whether to archive stickerset', + 'method_messages.uninstallStickerSet' => 'Uninstall a stickerset', + 'method_messages.uninstallStickerSet_param_stickerset_type_InputStickerSet' => 'The stickerset to uninstall', + 'method_messages.startBot' => 'Start a conversation with a bot using a [deep linking parameter](https://core.telegram.org/bots#deep-linking)', + 'method_messages.startBot_param_bot_type_InputUser' => 'The bot', + 'method_messages.startBot_param_peer_type_InputPeer' => 'The chat where to start the bot, can be the bot\'s private chat or a group', + 'method_messages.startBot_param_start_param_type_string' => '[Deep linking parameter](https://core.telegram.org/bots#deep-linking)', + 'method_messages.getMessagesViews' => 'Get and increase the view counter of a message sent or forwarded from a [channel](https://core.telegram.org/api/channel)', + 'method_messages.getMessagesViews_param_peer_type_InputPeer' => 'Peer where the message was found', 'method_messages.getMessagesViews_param_id_type_Vector t' => 'The IDs messages to get', - 'method_messages.getMessagesViews_param_increment_type_Bool' => 'Increase message views?', + 'method_messages.getMessagesViews_param_increment_type_Bool' => 'Whether to mark the message as viewed and increment the view counter', 'method_messages.toggleChatAdmins' => 'Enable all users are admins in normal groups (not supergroups)', 'method_messages.toggleChatAdmins_param_chat_id_type_InputPeer' => 'Group ID', 'method_messages.toggleChatAdmins_param_enabled_type_Bool' => 'Enable all users are admins', - 'method_messages.editChatAdmin' => 'Edit admin permissions', + 'method_messages.editChatAdmin' => 'Make a user admin in a [legacy group](https://core.telegram.org/api/channel).', 'method_messages.editChatAdmin_param_chat_id_type_InputPeer' => 'The chat ID (no supergroups)', - 'method_messages.editChatAdmin_param_user_id_type_InputUser' => 'The user ID', - 'method_messages.editChatAdmin_param_is_admin_type_Bool' => 'Should the user be admin?', - 'method_messages.migrateChat' => 'Convert chat to supergroup', + 'method_messages.editChatAdmin_param_user_id_type_InputUser' => 'The user to make admin', + 'method_messages.editChatAdmin_param_is_admin_type_Bool' => 'Whether to make him admin', + 'method_messages.migrateChat' => 'Turn a [legacy group into a supergroup](https://core.telegram.org/api/channel)', 'method_messages.migrateChat_param_chat_id_type_InputPeer' => 'The chat to convert', - 'method_messages.searchGlobal' => 'Global message search', - 'method_messages.searchGlobal_param_q_type_string' => 'The query', + 'method_messages.searchGlobal' => 'Search for messages and peers globally', + 'method_messages.searchGlobal_param_q_type_string' => 'Query', 'method_messages.searchGlobal_param_offset_date_type_int' => '0 or the date offset', - 'method_messages.searchGlobal_param_offset_peer_type_InputPeer' => '0 or the peer offset', - 'method_messages.searchGlobal_param_offset_id_type_int' => '0 or the message ID offset', - 'method_messages.searchGlobal_param_limit_type_int' => 'The number of results to return', - 'method_messages.reorderStickerSets' => 'Reorder sticker sets', - 'method_messages.reorderStickerSets_param_masks_type_true' => 'Reorder masks?', + 'method_messages.searchGlobal_param_offset_peer_type_InputPeer' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)', + 'method_messages.searchGlobal_param_offset_id_type_int' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)', + 'method_messages.searchGlobal_param_limit_type_int' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)', + 'method_messages.reorderStickerSets' => 'Reorder installed stickersets', + 'method_messages.reorderStickerSets_param_masks_type_true' => 'Reorder mask stickersets', 'method_messages.reorderStickerSets_param_order_type_Vector t' => 'The order', - 'method_messages.getDocumentByHash' => 'Get document by SHA256 hash', - 'method_messages.getDocumentByHash_param_sha256_type_bytes' => '`hash(\'sha256\', $filename, true);`', - 'method_messages.getDocumentByHash_param_size_type_int' => 'The file size', - 'method_messages.getDocumentByHash_param_mime_type_type_string' => 'The mime type of the file', - 'method_messages.searchGifs' => 'Search gifs', - 'method_messages.searchGifs_param_q_type_string' => 'The search query', - 'method_messages.searchGifs_param_offset_type_int' => 'The offset ', - 'method_messages.getSavedGifs' => 'Get saved gifs', - 'method_messages.getSavedGifs_param_hash_type_int' => '0 or $result[\'hash\']', - 'method_messages.saveGif' => 'Save a GIF', - 'method_messages.saveGif_param_id_type_InputDocument' => 'The GIF to save', - 'method_messages.saveGif_param_unsave_type_Bool' => 'Remove the gif?', - 'method_messages.getInlineBotResults' => 'Call inline bot', - 'method_messages.getInlineBotResults_param_bot_type_InputUser' => 'The bot to call', - 'method_messages.getInlineBotResults_param_peer_type_InputPeer' => 'The chat where to call the bot', - 'method_messages.getInlineBotResults_param_geo_point_type_InputGeoPoint' => 'The current location', - 'method_messages.getInlineBotResults_param_query_type_string' => 'The query to send to the bot', - 'method_messages.getInlineBotResults_param_offset_type_string' => 'The offset to send to the bot', - 'method_messages.setInlineBotResults' => 'Bots only: set the results of an inline query', - 'method_messages.setInlineBotResults_param_gallery_type_true' => 'Is this a gallery?', - 'method_messages.setInlineBotResults_param_private_type_true' => 'Is this result private (not cached)?', - 'method_messages.setInlineBotResults_param_query_id_type_long' => 'Query ID', + 'method_messages.getDocumentByHash' => 'Get a document by its SHA256 hash, mainly used for gifs', + 'method_messages.getDocumentByHash_param_sha256_type_bytes' => 'SHA256 of file', + 'method_messages.getDocumentByHash_param_size_type_int' => 'Size of the file in bytes', + 'method_messages.getDocumentByHash_param_mime_type_type_string' => 'Mime type', + 'method_messages.searchGifs' => 'Search for GIFs', + 'method_messages.searchGifs_param_q_type_string' => 'Text query', + 'method_messages.searchGifs_param_offset_type_int' => 'Offset for [pagination »](https://core.telegram.org/api/offsets)', + 'method_messages.getSavedGifs' => 'Get saved GIFs', + 'method_messages.getSavedGifs_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', + 'method_messages.saveGif' => 'Add GIF to saved gifs list', + 'method_messages.saveGif_param_id_type_InputDocument' => 'GIF to save', + 'method_messages.saveGif_param_unsave_type_Bool' => 'Whether to remove GIF from saved gifs list', + 'method_messages.getInlineBotResults' => 'Query an inline bot', + 'method_messages.getInlineBotResults_param_bot_type_InputUser' => 'The bot to query', + 'method_messages.getInlineBotResults_param_peer_type_InputPeer' => 'The currently opened chat', + 'method_messages.getInlineBotResults_param_geo_point_type_InputGeoPoint' => 'The geolocation, if requested', + 'method_messages.getInlineBotResults_param_query_type_string' => 'The query', + 'method_messages.getInlineBotResults_param_offset_type_string' => 'The offset within the results, will be passed directly as-is to the bot.', + 'method_messages.setInlineBotResults' => 'Answer an inline query, for bots only', + 'method_messages.setInlineBotResults_param_gallery_type_true' => 'Set this flag if the results are composed of media files', + 'method_messages.setInlineBotResults_param_private_type_true' => 'Set this flag if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query', + 'method_messages.setInlineBotResults_param_query_id_type_long' => 'Unique identifier for the answered query', 'method_messages.setInlineBotResults_param_results_type_Vector t' => 'Results', - 'method_messages.setInlineBotResults_param_cache_time_type_int' => 'Cache time', - 'method_messages.setInlineBotResults_param_next_offset_type_string' => 'The next offset', - 'method_messages.setInlineBotResults_param_switch_pm_type_InlineBotSwitchPM' => 'Switch to PM?', - 'method_messages.sendInlineBotResult' => 'Send inline bot result obtained with messages.getInlineBotResults to the chat', - 'method_messages.sendInlineBotResult_param_silent_type_true' => 'Disable notifications?', - 'method_messages.sendInlineBotResult_param_background_type_true' => 'Disable background notifications?', - 'method_messages.sendInlineBotResult_param_clear_draft_type_true' => 'Clear the message draft?', - 'method_messages.sendInlineBotResult_param_peer_type_InputPeer' => 'Where to send the message', - 'method_messages.sendInlineBotResult_param_reply_to_msg_id_type_int' => 'Reply to message by ID', - 'method_messages.sendInlineBotResult_param_query_id_type_long' => 'The inline query ID', - 'method_messages.sendInlineBotResult_param_id_type_string' => 'The ID of one of the inline results', - 'method_messages.getMessageEditData' => 'Check if about to edit a message or a media caption', - 'method_messages.getMessageEditData_param_peer_type_InputPeer' => 'The chat', - 'method_messages.getMessageEditData_param_id_type_int' => 'The message ID', - 'method_messages.editMessage' => 'Edit a message', + 'method_messages.setInlineBotResults_param_cache_time_type_int' => 'The maximum amount of time in seconds that the result of the inline query may be cached on the server. Defaults to 300.', + 'method_messages.setInlineBotResults_param_next_offset_type_string' => 'Pass the offset that a client should send in the next query with the same text to receive more results. Pass an empty string if there are no more results or if you don‘t support pagination. Offset length can’t exceed 64 bytes.', + 'method_messages.setInlineBotResults_param_switch_pm_type_InlineBotSwitchPM' => 'If passed, clients will display a button with specified text that switches the user to a private chat with the bot and sends the bot a start message with a certain parameter.', + 'method_messages.sendInlineBotResult' => 'Send a result obtained using [messages.getInlineBotResults](../methods/messages.getInlineBotResults.md).', + 'method_messages.sendInlineBotResult_param_silent_type_true' => 'Whether to send the message silently (no notification will be triggered on the other client)', + 'method_messages.sendInlineBotResult_param_background_type_true' => 'Whether to send the message in background', + 'method_messages.sendInlineBotResult_param_clear_draft_type_true' => 'Whether to clear the [draft](https://core.telegram.org/api/drafts)', + 'method_messages.sendInlineBotResult_param_peer_type_InputPeer' => 'Destination', + 'method_messages.sendInlineBotResult_param_reply_to_msg_id_type_int' => 'ID of the message this message should reply to', + 'method_messages.sendInlineBotResult_param_query_id_type_long' => 'Query ID from [messages.getInlineBotResults](../methods/messages.getInlineBotResults.md)', + 'method_messages.sendInlineBotResult_param_id_type_string' => 'Result ID from [messages.getInlineBotResults](../methods/messages.getInlineBotResults.md)', + 'method_messages.getMessageEditData' => 'Find out if a media message\'s caption can be edited', + 'method_messages.getMessageEditData_param_peer_type_InputPeer' => 'Peer where the media was sent', + 'method_messages.getMessageEditData_param_id_type_int' => 'ID of message', + 'method_messages.editMessage' => 'Edit message', 'method_messages.editMessage_param_no_webpage_type_true' => 'Disable webpage preview', 'method_messages.editMessage_param_stop_geo_live_type_true' => 'Stop live location', - 'method_messages.editMessage_param_peer_type_InputPeer' => 'The chat', - 'method_messages.editMessage_param_id_type_int' => 'The message ID', - 'method_messages.editMessage_param_message_type_string' => 'The new message', - 'method_messages.editMessage_param_reply_markup_type_ReplyMarkup' => 'The new keyboard', + 'method_messages.editMessage_param_peer_type_InputPeer' => 'Where was the message sent', + 'method_messages.editMessage_param_id_type_int' => 'ID of the message to edit', + 'method_messages.editMessage_param_message_type_string' => 'New message', + 'method_messages.editMessage_param_reply_markup_type_ReplyMarkup' => 'Reply markup for inline keyboards', 'method_messages.editMessage_param_entities_type_Vector t' => 'The new entities (for styled text)', 'method_messages.editMessage_param_geo_point_type_InputGeoPoint' => 'The new location', - 'method_messages.editInlineBotMessage' => 'Edit a sent inline message', + 'method_messages.editInlineBotMessage' => 'Edit an inline bot message', 'method_messages.editInlineBotMessage_param_no_webpage_type_true' => 'Disable webpage preview', 'method_messages.editInlineBotMessage_param_stop_geo_live_type_true' => 'Stop live location', - 'method_messages.editInlineBotMessage_param_id_type_InputBotInlineMessageID' => 'The message ID', - 'method_messages.editInlineBotMessage_param_message_type_string' => 'The new message', - 'method_messages.editInlineBotMessage_param_reply_markup_type_ReplyMarkup' => 'The new keyboard', + 'method_messages.editInlineBotMessage_param_id_type_InputBotInlineMessageID' => 'Sent inline message ID', + 'method_messages.editInlineBotMessage_param_message_type_string' => 'Message', + 'method_messages.editInlineBotMessage_param_reply_markup_type_ReplyMarkup' => 'Reply markup for inline keyboards', 'method_messages.editInlineBotMessage_param_entities_type_Vector t' => 'The new entities (for styled text)', 'method_messages.editInlineBotMessage_param_geo_point_type_InputGeoPoint' => 'The new location', - 'method_messages.getBotCallbackAnswer' => 'Get the callback answer of a bot (after clicking a button)', - 'method_messages.getBotCallbackAnswer_param_game_type_true' => 'Is this a game?', - 'method_messages.getBotCallbackAnswer_param_peer_type_InputPeer' => 'The chat', - 'method_messages.getBotCallbackAnswer_param_msg_id_type_int' => 'The message ID', - 'method_messages.getBotCallbackAnswer_param_data_type_bytes' => 'The data to send to the bot', - 'method_messages.setBotCallbackAnswer' => 'Bots only: set the callback answer (after a button was clicked)', - 'method_messages.setBotCallbackAnswer_param_alert_type_true' => 'Is this an alert?', - 'method_messages.setBotCallbackAnswer_param_query_id_type_long' => 'The query ID', - 'method_messages.setBotCallbackAnswer_param_message_type_string' => 'The message', - 'method_messages.setBotCallbackAnswer_param_url_type_string' => 'The URL', - 'method_messages.setBotCallbackAnswer_param_cache_time_type_int' => 'Cache time', - 'method_messages.getPeerDialogs' => 'Get dialog info of peers', + 'method_messages.getBotCallbackAnswer' => 'Press an inline callback button and get a callback answer from the bot', + 'method_messages.getBotCallbackAnswer_param_game_type_true' => 'Whether this is a "play game" button', + 'method_messages.getBotCallbackAnswer_param_peer_type_InputPeer' => 'Where was the inline keyboard sent', + 'method_messages.getBotCallbackAnswer_param_msg_id_type_int' => 'ID of the Message with the inline keyboard', + 'method_messages.getBotCallbackAnswer_param_data_type_bytes' => 'Callback data', + 'method_messages.setBotCallbackAnswer' => 'Set the callback answer to a user button press (bots only)', + 'method_messages.setBotCallbackAnswer_param_alert_type_true' => 'Whether to show the message as a popup instead of a toast notification', + 'method_messages.setBotCallbackAnswer_param_query_id_type_long' => 'Query ID', + 'method_messages.setBotCallbackAnswer_param_message_type_string' => 'Popup to show', + 'method_messages.setBotCallbackAnswer_param_url_type_string' => 'URL to open', + 'method_messages.setBotCallbackAnswer_param_cache_time_type_int' => 'Cache validity', + 'method_messages.getPeerDialogs' => 'Get dialog info of specified peers', 'method_messages.getPeerDialogs_param_peers_type_Vector t' => 'The peers', - 'method_messages.saveDraft' => 'Save a message draft', - 'method_messages.saveDraft_param_no_webpage_type_true' => 'Disable webpage preview', - 'method_messages.saveDraft_param_reply_to_msg_id_type_int' => 'Reply to message by ID', - 'method_messages.saveDraft_param_peer_type_InputPeer' => 'The chat', - 'method_messages.saveDraft_param_message_type_string' => 'The message', + 'method_messages.saveDraft' => 'Save a message [draft](https://core.telegram.org/api/drafts) associated to a chat.', + 'method_messages.saveDraft_param_no_webpage_type_true' => 'Disable generation of the webpage preview', + 'method_messages.saveDraft_param_reply_to_msg_id_type_int' => 'Message ID the message should reply to', + 'method_messages.saveDraft_param_peer_type_InputPeer' => 'Destination of the message that should be sent', + 'method_messages.saveDraft_param_message_type_string' => 'The draft', 'method_messages.saveDraft_param_entities_type_Vector t' => 'The entities (for styled text)', - 'method_messages.getAllDrafts' => 'Get all message drafts', + 'method_messages.getAllDrafts' => 'Save get all message [drafts](https://core.telegram.org/api/drafts).', 'method_messages.getFeaturedStickers' => 'Get featured stickers', - 'method_messages.getFeaturedStickers_param_hash_type_int' => '0 or $result[\'hash\']', + 'method_messages.getFeaturedStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', 'method_messages.readFeaturedStickers' => 'Mark new featured stickers as read', 'method_messages.readFeaturedStickers_param_id_type_Vector t' => 'The stickers to mark as read', 'method_messages.getRecentStickers' => 'Get recent stickers', - 'method_messages.getRecentStickers_param_attached_type_true' => 'Get stickers attached to image?', - 'method_messages.getRecentStickers_param_hash_type_int' => '0 or $result[\'hash\']', - 'method_messages.saveRecentSticker' => 'Add a sticker to recent stickers', - 'method_messages.saveRecentSticker_param_attached_type_true' => 'Get stickers attached to image?', - 'method_messages.saveRecentSticker_param_id_type_InputDocument' => 'The sticker', - 'method_messages.saveRecentSticker_param_unsave_type_Bool' => 'Remove the sticker from recent stickers?', - 'method_messages.clearRecentStickers' => 'Clear all recent stickers', - 'method_messages.clearRecentStickers_param_attached_type_true' => 'Clear recent stickers attached to images?', + 'method_messages.getRecentStickers_param_attached_type_true' => 'Get stickers recently attached to photo or video files', + 'method_messages.getRecentStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', + 'method_messages.saveRecentSticker' => 'Add/remove sticker from recent stickers list', + 'method_messages.saveRecentSticker_param_attached_type_true' => 'Whether to add/remove stickers recently attached to photo or video files', + 'method_messages.saveRecentSticker_param_id_type_InputDocument' => 'Sticker', + 'method_messages.saveRecentSticker_param_unsave_type_Bool' => 'Whether to save or unsave the sticker', + 'method_messages.clearRecentStickers' => 'Clear recent stickers', + 'method_messages.clearRecentStickers_param_attached_type_true' => 'Set this flag to clear the list of stickers recently attached to photo or video files', 'method_messages.getArchivedStickers' => 'Get all archived stickers', - 'method_messages.getArchivedStickers_param_masks_type_true' => 'Get masks?', - 'method_messages.getArchivedStickers_param_offset_id_type_long' => 'Sticker ID offset', - 'method_messages.getArchivedStickers_param_limit_type_int' => 'Number of stickers to fetch', - 'method_messages.getMaskStickers' => 'Get masks', - 'method_messages.getMaskStickers_param_hash_type_int' => '0 or $result[\'hash\']', - 'method_messages.getAttachedStickers' => 'Get stickers attachable to images', - 'method_messages.getAttachedStickers_param_media_type_InputStickeredMedia' => 'The stickered media', - 'method_messages.setGameScore' => 'Set the game score', - 'method_messages.setGameScore_param_edit_message_type_true' => 'Should the message with the game be edited?', - 'method_messages.setGameScore_param_force_type_true' => 'Force setting the game score', - 'method_messages.setGameScore_param_peer_type_InputPeer' => 'The chat where the game was sent', - 'method_messages.setGameScore_param_id_type_int' => 'The message ID', - 'method_messages.setGameScore_param_user_id_type_InputUser' => 'The user that set the score', - 'method_messages.setGameScore_param_score_type_int' => 'The score', - 'method_messages.setInlineGameScore' => 'Set the game score of an inline message', - 'method_messages.setInlineGameScore_param_edit_message_type_true' => 'Should the message with the game be edited?', - 'method_messages.setInlineGameScore_param_force_type_true' => 'Force setting the game score', - 'method_messages.setInlineGameScore_param_id_type_InputBotInlineMessageID' => 'The ID of the inline message', - 'method_messages.setInlineGameScore_param_user_id_type_InputUser' => 'The user that set the score', - 'method_messages.setInlineGameScore_param_score_type_int' => 'The score', - 'method_messages.getGameHighScores' => 'Get high scores of a game', - 'method_messages.getGameHighScores_param_peer_type_InputPeer' => 'The chat', - 'method_messages.getGameHighScores_param_id_type_int' => 'The message ID', - 'method_messages.getGameHighScores_param_user_id_type_InputUser' => 'The user that set the high scores', - 'method_messages.getInlineGameHighScores' => 'Get high scores of a game sent in an inline message', - 'method_messages.getInlineGameHighScores_param_id_type_InputBotInlineMessageID' => 'The inline message', - 'method_messages.getInlineGameHighScores_param_user_id_type_InputUser' => 'The user that set the high scores', + 'method_messages.getArchivedStickers_param_masks_type_true' => 'Get mask stickers', + 'method_messages.getArchivedStickers_param_offset_id_type_long' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)', + 'method_messages.getArchivedStickers_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)', + 'method_messages.getMaskStickers' => 'Get installed mask stickers', + 'method_messages.getMaskStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', + 'method_messages.getAttachedStickers' => 'Get stickers attached to a photo or video', + 'method_messages.getAttachedStickers_param_media_type_InputStickeredMedia' => 'Stickered media', + 'method_messages.setGameScore' => 'Use this method to set the score of the specified user in a game sent as a normal message (bots only).', + 'method_messages.setGameScore_param_edit_message_type_true' => 'Set this flag if the game message should be automatically edited to include the current scoreboard', + 'method_messages.setGameScore_param_force_type_true' => 'Set this flag if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters', + 'method_messages.setGameScore_param_peer_type_InputPeer' => 'Unique identifier of target chat', + 'method_messages.setGameScore_param_id_type_int' => 'Identifier of the sent message', + 'method_messages.setGameScore_param_user_id_type_InputUser' => 'User identifier', + 'method_messages.setGameScore_param_score_type_int' => 'New score', + 'method_messages.setInlineGameScore' => 'Use this method to set the score of the specified user in a game sent as an inline message (bots only).', + 'method_messages.setInlineGameScore_param_edit_message_type_true' => 'Set this flag if the game message should be automatically edited to include the current scoreboard', + 'method_messages.setInlineGameScore_param_force_type_true' => 'Set this flag if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters', + 'method_messages.setInlineGameScore_param_id_type_InputBotInlineMessageID' => 'ID of the inline message', + 'method_messages.setInlineGameScore_param_user_id_type_InputUser' => 'User identifier', + 'method_messages.setInlineGameScore_param_score_type_int' => 'New score', + 'method_messages.getGameHighScores' => 'Get highscores of a game', + 'method_messages.getGameHighScores_param_peer_type_InputPeer' => 'Where was the game sent', + 'method_messages.getGameHighScores_param_id_type_int' => 'ID of message with game media attachment', + 'method_messages.getGameHighScores_param_user_id_type_InputUser' => 'Get high scores made by a certain user', + 'method_messages.getInlineGameHighScores' => 'Get highscores of a game sent using an inline bot', + 'method_messages.getInlineGameHighScores_param_id_type_InputBotInlineMessageID' => 'ID of inline message', + 'method_messages.getInlineGameHighScores_param_user_id_type_InputUser' => 'Get high scores of a certain user', 'method_messages.getCommonChats' => 'Get chats in common with a user', - 'method_messages.getCommonChats_param_user_id_type_InputUser' => 'The user', - 'method_messages.getCommonChats_param_max_id_type_int' => 'The maximum chat ID to fetch', - 'method_messages.getCommonChats_param_limit_type_int' => 'Number of results to fetch', - 'method_messages.getAllChats' => 'Get all chats (not supergroups or channels)', + 'method_messages.getCommonChats_param_user_id_type_InputUser' => 'User ID', + 'method_messages.getCommonChats_param_max_id_type_int' => 'Maximum ID of chat to return (see [pagination](https://core.telegram.org/api/offsets))', + 'method_messages.getCommonChats_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)', + 'method_messages.getAllChats' => 'Get all chats, channels and supergroups', 'method_messages.getAllChats_param_except_ids_type_Vector t' => 'Do not fetch these chats (MTProto id)', - 'method_messages.getWebPage' => 'Get webpage preview', - 'method_messages.getWebPage_param_url_type_string' => 'URL', - 'method_messages.getWebPage_param_hash_type_int' => '0 or $result[\'hash\']', - 'method_messages.toggleDialogPin' => 'Pin or unpin dialog', - 'method_messages.toggleDialogPin_param_pinned_type_true' => 'Pin or unpin the dialog?', + 'method_messages.getWebPage' => 'Get [instant view](https://instantview.telegram.org) page', + 'method_messages.getWebPage_param_url_type_string' => 'URL of IV page to fetch', + 'method_messages.getWebPage_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', + 'method_messages.toggleDialogPin' => 'Pin/unpin a dialog', + 'method_messages.toggleDialogPin_param_pinned_type_true' => 'Whether to pin or unpin the dialog', 'method_messages.toggleDialogPin_param_peer_type_InputPeer' => 'The peer to pin', 'method_messages.reorderPinnedDialogs' => 'Reorder pinned dialogs', - 'method_messages.reorderPinnedDialogs_param_force_type_true' => 'Force reordering', + 'method_messages.reorderPinnedDialogs_param_force_type_true' => 'If set, dialogs pinned server-side but not present in the `order` field will be unpinned.', 'method_messages.reorderPinnedDialogs_param_order_type_Vector t' => 'New order', 'method_messages.getPinnedDialogs' => 'Get pinned dialogs', - 'method_messages.setBotShippingResults' => 'Bots only: set shipping results', - 'method_messages.setBotShippingResults_param_query_id_type_long' => 'Query ID', - 'method_messages.setBotShippingResults_param_error_type_string' => 'Error', + 'method_messages.setBotShippingResults' => 'If you sent an invoice requesting a shipping address and the parameter is\\_flexible was specified, the bot will receive an [updateBotShippingQuery](../constructors/updateBotShippingQuery.md) update. Use this method to reply to shipping queries.', + 'method_messages.setBotShippingResults_param_query_id_type_long' => 'Unique identifier for the query to be answered', + 'method_messages.setBotShippingResults_param_error_type_string' => 'Error message in human readable form that explains why it is impossible to complete the order (e.g. "Sorry, delivery to your desired address is unavailable\'). Telegram will display this message to the user.', 'method_messages.setBotShippingResults_param_shipping_options_type_Vector t' => 'Shipping options', - 'method_messages.setBotPrecheckoutResults' => 'Bots only: set precheckout results', - 'method_messages.setBotPrecheckoutResults_param_success_type_true' => 'Success?', - 'method_messages.setBotPrecheckoutResults_param_query_id_type_long' => 'Query ID', - 'method_messages.setBotPrecheckoutResults_param_error_type_string' => 'Error', - 'method_messages.uploadMedia' => 'Upload a file without sending it to anyone', - 'method_messages.uploadMedia_param_peer_type_InputPeer' => 'Nothing', - 'method_messages.uploadMedia_param_media_type_InputMedia' => 'The media to upload', - 'method_messages.sendScreenshotNotification' => 'Send screenshot notification', - 'method_messages.sendScreenshotNotification_param_peer_type_InputPeer' => 'Where to send the notification', - 'method_messages.sendScreenshotNotification_param_reply_to_msg_id_type_int' => 'Reply to message by ID', - 'method_messages.getFavedStickers' => 'Get favorite stickers', - 'method_messages.getFavedStickers_param_hash_type_int' => '0 or $result[\'hash\']', - 'method_messages.faveSticker' => 'Add a sticker to favorites', - 'method_messages.faveSticker_param_id_type_InputDocument' => 'The sticker to add to favorites', - 'method_messages.faveSticker_param_unfave_type_Bool' => 'Remove it from favorites?', - 'method_messages.getUnreadMentions' => 'Get unread mentions', - 'method_messages.getUnreadMentions_param_peer_type_InputPeer' => 'The chat where to get unread mentions', - 'method_messages.getUnreadMentions_param_offset_id_type_int' => 'The offset', - 'method_messages.getUnreadMentions_param_add_offset_type_int' => 'The additional offset', - 'method_messages.getUnreadMentions_param_limit_type_int' => 'The number of results to fetch', - 'method_messages.getUnreadMentions_param_max_id_type_int' => 'The maximum message ID to fetch', - 'method_messages.getUnreadMentions_param_min_id_type_int' => 'The minumum message ID to fetch', + 'method_messages.setBotPrecheckoutResults' => 'Once the user has confirmed their payment and shipping details, the bot receives an [updateBotPrecheckoutQuery](../constructors/updateBotPrecheckoutQuery.md) update. +Use this method to respond to such pre-checkout queries. +**Note**: Telegram must receive an answer within 10 seconds after the pre-checkout query was sent.', + 'method_messages.setBotPrecheckoutResults_param_success_type_true' => 'Set this flag if everything is alright (goods are available, etc.) and the bot is ready to proceed with the order, otherwise do not set it, and set the `error` field, instead', + 'method_messages.setBotPrecheckoutResults_param_query_id_type_long' => 'Unique identifier for the query to be answered', + 'method_messages.setBotPrecheckoutResults_param_error_type_string' => 'Required if the `success` isn\'t set. Error message in human readable form that explains the reason for failure to proceed with the checkout (e.g. "Sorry, somebody just bought the last of our amazing black T-shirts while you were busy filling out your payment details. Please choose a different color or garment!"). Telegram will display this message to the user.', + 'method_messages.uploadMedia' => 'Upload a file and associate it to a chat (without actually sending it to the chat)', + 'method_messages.uploadMedia_param_peer_type_InputPeer' => 'The chat, can be an [inputPeerEmpty](../constructors/inputPeerEmpty.md) for bots', + 'method_messages.uploadMedia_param_media_type_InputMedia' => 'File uploaded in chunks as described in [files »](https://core.telegram.org/api/files)', + 'method_messages.sendScreenshotNotification' => 'Notify the other user in a private chat that a screenshot of the chat was taken', + 'method_messages.sendScreenshotNotification_param_peer_type_InputPeer' => 'Other user', + 'method_messages.sendScreenshotNotification_param_reply_to_msg_id_type_int' => 'ID of message that was screenshotted, can be 0', + 'method_messages.getFavedStickers' => 'Get faved stickers', + 'method_messages.getFavedStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', + 'method_messages.faveSticker' => 'Mark a sticker as favorite', + 'method_messages.faveSticker_param_id_type_InputDocument' => 'Sticker to mark as favorite', + 'method_messages.faveSticker_param_unfave_type_Bool' => 'Unfavorite', + 'method_messages.getUnreadMentions' => 'Get unread messages where we were mentioned', + 'method_messages.getUnreadMentions_param_peer_type_InputPeer' => 'Peer where to look for mentions', + 'method_messages.getUnreadMentions_param_offset_id_type_int' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)', + 'method_messages.getUnreadMentions_param_add_offset_type_int' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)', + 'method_messages.getUnreadMentions_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)', + 'method_messages.getUnreadMentions_param_max_id_type_int' => 'Maximum message ID to return, [see pagination](https://core.telegram.org/api/offsets)', + 'method_messages.getUnreadMentions_param_min_id_type_int' => 'Minimum message ID to return, [see pagination](https://core.telegram.org/api/offsets)', 'method_messages.readMentions' => 'Mark mentions as read', - 'method_messages.readMentions_param_peer_type_InputPeer' => 'The chat', - 'method_messages.getRecentLocations' => 'Get recent locations', - 'method_messages.getRecentLocations_param_peer_type_InputPeer' => 'The chat where to search locations', - 'method_messages.getRecentLocations_param_limit_type_int' => 'Number of results to return', - 'method_messages.sendMultiMedia' => 'Send an album', - 'method_messages.sendMultiMedia_param_silent_type_true' => 'Disable notifications?', - 'method_messages.sendMultiMedia_param_background_type_true' => 'Disable background notification?', - 'method_messages.sendMultiMedia_param_clear_draft_type_true' => 'Clear draft?', - 'method_messages.sendMultiMedia_param_peer_type_InputPeer' => 'Where to send the album', - 'method_messages.sendMultiMedia_param_reply_to_msg_id_type_int' => 'Reply to message by ID', + 'method_messages.readMentions_param_peer_type_InputPeer' => 'Dialog', + 'method_messages.getRecentLocations' => 'Get live location history of a certain user', + 'method_messages.getRecentLocations_param_peer_type_InputPeer' => 'User', + 'method_messages.getRecentLocations_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)', + 'method_messages.sendMultiMedia' => 'Send an album of media', + 'method_messages.sendMultiMedia_param_silent_type_true' => 'Whether to send the album silently (no notification triggered)', + 'method_messages.sendMultiMedia_param_background_type_true' => 'Send in background?', + 'method_messages.sendMultiMedia_param_clear_draft_type_true' => 'Whether to clear [drafts](https://core.telegram.org/api/drafts)', + 'method_messages.sendMultiMedia_param_peer_type_InputPeer' => 'The destination chat', + 'method_messages.sendMultiMedia_param_reply_to_msg_id_type_int' => 'The message to reply to', 'method_messages.sendMultiMedia_param_multi_media_type_Vector t' => 'The album', - 'method_messages.uploadEncryptedFile' => 'Upload a secret chat file without sending it to anyone', - 'method_messages.uploadEncryptedFile_param_peer_type_InputEncryptedChat' => 'The chat where to upload the media', + 'method_messages.uploadEncryptedFile' => 'Upload encrypted file and associate it to a secret chat', + 'method_messages.uploadEncryptedFile_param_peer_type_InputEncryptedChat' => 'The secret chat to associate the file to', 'method_messages.uploadEncryptedFile_param_file_type_InputEncryptedFile' => 'The file', - 'method_updates.getState' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates', - 'method_updates.getDifference' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates', - 'method_updates.getDifference_param_pts_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates', - 'method_updates.getDifference_param_pts_total_limit_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates', - 'method_updates.getDifference_param_date_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates', - 'method_updates.getDifference_param_qts_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates', - 'method_updates.getChannelDifference' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates', - 'method_updates.getChannelDifference_param_force_type_true' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates', - 'method_updates.getChannelDifference_param_channel_type_InputChannel' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates', - 'method_updates.getChannelDifference_param_filter_type_ChannelMessagesFilter' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates', - 'method_updates.getChannelDifference_param_pts_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates', - 'method_updates.getChannelDifference_param_limit_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates', - 'method_photos.updateProfilePhoto' => 'Change the profile photo', - 'method_photos.updateProfilePhoto_param_id_type_InputPhoto' => 'The photo to use', - 'method_photos.uploadProfilePhoto' => 'Upload profile photo', - 'method_photos.uploadProfilePhoto_param_file_type_InputFile' => 'The photo', - 'method_photos.deletePhotos' => 'Delete profile photos', + 'method_updates.getState' => 'Returns a current state of updates.', + 'method_updates.getDifference' => 'Get new [updates](https://core.telegram.org/api/updates).', + 'method_updates.getDifference_param_pts_type_int' => 'PTS, see [updates](https://core.telegram.org/api/updates).', + 'method_updates.getDifference_param_pts_total_limit_type_int' => 'For fast updating: if provided and `pts + pts_total_limit < remote pts`, [updates.differenceTooLong](../constructors/updates.differenceTooLong.md) will be returned.
Simply tells the server to not return the difference if it is bigger than `pts_total_limit`
If the remote pts is too big (> ~4000000), this field will default to 1000000', + 'method_updates.getDifference_param_date_type_int' => 'date, see [updates](https://core.telegram.org/api/updates).', + 'method_updates.getDifference_param_qts_type_int' => 'QTS, see [updates](https://core.telegram.org/api/updates).', + 'method_updates.getChannelDifference' => 'Returns the difference between the current state of updates of a certain channel and transmitted.', + 'method_updates.getChannelDifference_param_force_type_true' => 'Set to true to skip some possibly unneeded updates and reduce server-side load', + 'method_updates.getChannelDifference_param_channel_type_InputChannel' => 'The channel', + 'method_updates.getChannelDifference_param_filter_type_ChannelMessagesFilter' => 'Messsage filter', + 'method_updates.getChannelDifference_param_pts_type_int' => 'Persistent timestamp (see [updates](https://core.telegram.org/api/updates))', + 'method_updates.getChannelDifference_param_limit_type_int' => 'How many updates to fetch, max `100000`
Ordinary (non-bot) users are supposed to pass `10-100`', + 'method_photos.updateProfilePhoto' => 'Installs a previously uploaded photo as a profile photo.', + 'method_photos.updateProfilePhoto_param_id_type_InputPhoto' => 'Input photo', + 'method_photos.uploadProfilePhoto' => 'Updates current user profile photo.', + 'method_photos.uploadProfilePhoto_param_file_type_InputFile' => 'File saved in parts by means of [upload.saveFilePart](../methods/upload.saveFilePart.md) method', + 'method_photos.deletePhotos' => 'Deletes profile photos.', 'method_photos.deletePhotos_param_id_type_Vector t' => 'The profile photos to delete', - 'method_photos.getUserPhotos' => 'Get the profile photos of a user', - 'method_photos.getUserPhotos_param_user_id_type_InputUser' => 'The user', - 'method_photos.getUserPhotos_param_offset_type_int' => 'Offset', - 'method_photos.getUserPhotos_param_max_id_type_long' => 'Maximum ID of photo to return', - 'method_photos.getUserPhotos_param_limit_type_int' => 'Number of photos to return', - 'method_upload.saveFilePart' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.saveFilePart_param_file_id_type_long' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.saveFilePart_param_file_part_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.saveFilePart_param_bytes_type_bytes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.getFile' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.getFile_param_location_type_InputFileLocation' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.getFile_param_offset_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.getFile_param_limit_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.saveBigFilePart' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.saveBigFilePart_param_file_id_type_long' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.saveBigFilePart_param_file_part_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.saveBigFilePart_param_file_total_parts_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.saveBigFilePart_param_bytes_type_bytes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.getWebFile' => 'Download a file through telegram', - 'method_upload.getWebFile_param_location_type_InputWebFileLocation' => 'The file', - 'method_upload.getWebFile_param_offset_type_int' => 'The offset in bytes', - 'method_upload.getWebFile_param_limit_type_int' => 'The number of bytes to fetch', - 'method_upload.getCdnFile' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.getCdnFile_param_file_token_type_bytes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.getCdnFile_param_offset_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.getCdnFile_param_limit_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.reuploadCdnFile' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.reuploadCdnFile_param_file_token_type_bytes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.reuploadCdnFile_param_request_token_type_bytes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.getCdnFileHashes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.getCdnFileHashes_param_file_token_type_bytes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_upload.getCdnFileHashes_param_offset_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info', - 'method_help.getConfig' => 'Get server configuration', - 'method_help.getNearestDc' => 'Get nearest datacenter', - 'method_help.getAppUpdate' => 'Get info about app updates', - 'method_help.saveAppLog' => 'Log data for developer of this app', + 'method_photos.getUserPhotos' => 'Returns the list of user photos.', + 'method_photos.getUserPhotos_param_user_id_type_InputUser' => 'User ID', + 'method_photos.getUserPhotos_param_offset_type_int' => 'Number of list elements to be skipped', + 'method_photos.getUserPhotos_param_max_id_type_long' => 'If a positive value was transferred, the method will return only photos with IDs less than the set one', + 'method_photos.getUserPhotos_param_limit_type_int' => 'Number of list elements to be returned', + 'method_upload.saveFilePart' => 'Saves a part of file for futher sending to one of the methods.', + 'method_upload.saveFilePart_param_file_id_type_long' => 'Random file identifier created by the client', + 'method_upload.saveFilePart_param_file_part_type_int' => 'Numerical order of a part', + 'method_upload.saveFilePart_param_bytes_type_bytes' => 'Binary data, contend of a part', + 'method_upload.getFile' => 'Returns content of a whole file or its part.', + 'method_upload.getFile_param_location_type_InputFileLocation' => 'File location', + 'method_upload.getFile_param_offset_type_int' => 'Number of bytes to be skipped', + 'method_upload.getFile_param_limit_type_int' => 'Number of bytes to be returned', + 'method_upload.saveBigFilePart' => 'Saves a part of a large file (over 10Mb in size) to be later passed to one of the methods.', + 'method_upload.saveBigFilePart_param_file_id_type_long' => 'Random file id, created by the client', + 'method_upload.saveBigFilePart_param_file_part_type_int' => 'Part sequence number', + 'method_upload.saveBigFilePart_param_file_total_parts_type_int' => 'Total number of parts', + 'method_upload.saveBigFilePart_param_bytes_type_bytes' => 'Binary data, part contents', + 'method_upload.getWebFile' => 'Returns content of an HTTP file or a part, by proxying the request through telegram.', + 'method_upload.getWebFile_param_location_type_InputWebFileLocation' => 'The file to download', + 'method_upload.getWebFile_param_offset_type_int' => 'Number of bytes to be skipped', + 'method_upload.getWebFile_param_limit_type_int' => 'Number of bytes to be returned', + 'method_upload.getCdnFile' => 'Download a [CDN](https://core.telegram.org/cdn) file.', + 'method_upload.getCdnFile_param_file_token_type_bytes' => 'File token', + 'method_upload.getCdnFile_param_offset_type_int' => 'Offset of chunk to download', + 'method_upload.getCdnFile_param_limit_type_int' => 'Length of chunk to download', + 'method_upload.reuploadCdnFile' => 'Request a reupload of a certain file to a [CDN DC](https://core.telegram.org/cdn).', + 'method_upload.reuploadCdnFile_param_file_token_type_bytes' => 'File token', + 'method_upload.reuploadCdnFile_param_request_token_type_bytes' => 'Request token', + 'method_upload.getCdnFileHashes' => 'Get SHA256 hashes for verifying downloaded [CDN](https://core.telegram.org/cdn) files', + 'method_upload.getCdnFileHashes_param_file_token_type_bytes' => 'File', + 'method_upload.getCdnFileHashes_param_offset_type_int' => 'Offset from which to start getting hashes', + 'method_help.getConfig' => 'Returns current configuration, icluding data center configuration.', + 'method_help.getNearestDc' => 'Returns info on data centre nearest to the user.', + 'method_help.getAppUpdate' => 'Returns information on update availability for the current application.', + 'method_help.saveAppLog' => 'Saves logs of application on the server.', 'method_help.saveAppLog_param_events_type_Vector t' => 'Event list', - 'method_help.getInviteText' => 'Get invitation text', - 'method_help.getSupport' => 'Get info of support user', - 'method_help.getAppChangelog' => 'Get the changelog of this app', + 'method_help.getInviteText' => 'Returns text of a text message with an invitation.', + 'method_help.getSupport' => 'Returns the support user for the \'ask a question\' feature.', + 'method_help.getAppChangelog' => 'Get changelog of current app', 'method_help.getAppChangelog_param_prev_app_version_type_string' => 'Previous app version', 'method_help.getTermsOfService' => 'Get terms of service', - 'method_help.setBotUpdatesStatus' => 'Set the update status of webhook', - 'method_help.setBotUpdatesStatus_param_pending_updates_count_type_int' => 'Pending update count', - 'method_help.setBotUpdatesStatus_param_message_type_string' => 'Message', - 'method_help.getCdnConfig' => 'Get CDN configuration', - 'method_help.getRecentMeUrls' => 'Get recent t.me URLs', - 'method_help.getRecentMeUrls_param_referer_type_string' => 'Referrer', - 'method_channels.readHistory' => 'Mark channel/supergroup history as read', - 'method_channels.readHistory_param_channel_type_InputChannel' => 'The channel/supergroup', - 'method_channels.readHistory_param_max_id_type_int' => 'Maximum message ID to mark as read', - 'method_channels.deleteMessages' => 'Delete channel/supergroup messages', - 'method_channels.deleteMessages_param_channel_type_InputChannel' => 'The channel/supergroup', + 'method_help.setBotUpdatesStatus' => 'Informs the server about the number of pending bot updates if they haven\'t been processed for a long time; for bots only', + 'method_help.setBotUpdatesStatus_param_pending_updates_count_type_int' => 'Number of pending updates', + 'method_help.setBotUpdatesStatus_param_message_type_string' => 'Error message, if present', + 'method_help.getCdnConfig' => 'Get configuration for [CDN](https://core.telegram.org/cdn) file downloads.', + 'method_help.getRecentMeUrls' => 'Get recently used `t.me` links', + 'method_help.getRecentMeUrls_param_referer_type_string' => 'Referer', + 'method_channels.readHistory' => 'Mark [channel/supergroup](https://core.telegram.org/api/channel) history as read', + 'method_channels.readHistory_param_channel_type_InputChannel' => '[Channel/supergroup](https://core.telegram.org/api/channel)', + 'method_channels.readHistory_param_max_id_type_int' => 'ID of message up to which messages should be marked as read', + 'method_channels.deleteMessages' => 'Delete messages in a [channel/supergroup](https://core.telegram.org/api/channel)', + 'method_channels.deleteMessages_param_channel_type_InputChannel' => '[Channel/supergroup](https://core.telegram.org/api/channel)', 'method_channels.deleteMessages_param_id_type_Vector t' => 'The IDs of messages to delete', - 'method_channels.deleteUserHistory' => 'Delete all messages of a user in a channel/supergroup', - 'method_channels.deleteUserHistory_param_channel_type_InputChannel' => 'The channel/supergroup', - 'method_channels.deleteUserHistory_param_user_id_type_InputUser' => 'The user', - 'method_channels.reportSpam' => 'Report a message in a supergroup/channel for spam', - 'method_channels.reportSpam_param_channel_type_InputChannel' => 'The channel', - 'method_channels.reportSpam_param_user_id_type_InputUser' => 'The user that sent the messages', + 'method_channels.deleteUserHistory' => 'Delete all messages sent by a certain user in a [supergroup](https://core.telegram.org/api/channel)', + 'method_channels.deleteUserHistory_param_channel_type_InputChannel' => '[Supergroup](https://core.telegram.org/api/channel)', + 'method_channels.deleteUserHistory_param_user_id_type_InputUser' => 'User whose messages should be deleted', + 'method_channels.reportSpam' => 'Reports some messages from a user in a supergroup as spam; requires administrator rights in the supergroup', + 'method_channels.reportSpam_param_channel_type_InputChannel' => 'Supergroup', + 'method_channels.reportSpam_param_user_id_type_InputUser' => 'ID of the user that sent the spam messages', 'method_channels.reportSpam_param_id_type_Vector t' => 'The IDs of messages to report', - 'method_channels.getMessages' => 'Get channel/supergroup messages', - 'method_channels.getMessages_param_channel_type_InputChannel' => 'The channel/supergroup', + 'method_channels.getMessages' => 'Get [channel/supergroup](https://core.telegram.org/api/channel) messages', + 'method_channels.getMessages_param_channel_type_InputChannel' => 'Channel/supergroup', 'method_channels.getMessages_param_id_type_Vector t' => 'The message IDs', - 'method_channels.getParticipants' => 'Get channel/supergroup participants (you should use `$MadelineProto->getPwrChat($id)` instead)', - 'method_channels.getParticipants_param_channel_type_InputChannel' => 'The channel', - 'method_channels.getParticipants_param_filter_type_ChannelParticipantsFilter' => 'Member filter', - 'method_channels.getParticipants_param_offset_type_int' => 'Offset', - 'method_channels.getParticipants_param_limit_type_int' => 'Limit', - 'method_channels.getParticipants_param_hash_type_int' => 'Sorted list of IDs of participants you already fetched', - 'method_channels.getParticipant' => 'Get info about a certain channel/supergroup participant', - 'method_channels.getParticipant_param_channel_type_InputChannel' => 'The channel/supergroup', - 'method_channels.getParticipant_param_user_id_type_InputUser' => 'The user to fetch info about', - 'method_channels.getChannels' => 'Get info about multiple channels/supergroups', + 'method_channels.getParticipants' => 'Get the participants of a channel', + 'method_channels.getParticipants_param_channel_type_InputChannel' => 'Channel', + 'method_channels.getParticipants_param_filter_type_ChannelParticipantsFilter' => 'Which participant types to fetch', + 'method_channels.getParticipants_param_offset_type_int' => '[Offset](https://core.telegram.org/api/offsets)', + 'method_channels.getParticipants_param_limit_type_int' => '[Limit](https://core.telegram.org/api/offsets)', + 'method_channels.getParticipants_param_hash_type_int' => '[Hash](https://core.telegram.org/api/offsets)', + 'method_channels.getParticipant' => 'Get info about a [channel/supergroup](https://core.telegram.org/api/channel) participant', + 'method_channels.getParticipant_param_channel_type_InputChannel' => 'Channel/supergroup', + 'method_channels.getParticipant_param_user_id_type_InputUser' => 'ID of participant to get info about', + 'method_channels.getChannels' => 'Get info about [channels/supergroups](https://core.telegram.org/api/channel)', 'method_channels.getChannels_param_id_type_Vector t' => 'The channel/supergroup MTProto IDs', - 'method_channels.getFullChannel' => 'You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)', - 'method_channels.getFullChannel_param_channel_type_InputChannel' => 'You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)', - 'method_channels.createChannel' => 'Create channel/supergroup', - 'method_channels.createChannel_param_broadcast_type_true' => 'Set this to true to create a channel', - 'method_channels.createChannel_param_megagroup_type_true' => 'Set this to true to create a supergroup', - 'method_channels.createChannel_param_title_type_string' => 'Supergroup/channel title', - 'method_channels.createChannel_param_about_type_string' => 'About text', + 'method_channels.getFullChannel' => 'Get full info about a channel', + 'method_channels.getFullChannel_param_channel_type_InputChannel' => 'The channel to get info about', + 'method_channels.createChannel' => 'Create a [supergroup/channel](https://core.telegram.org/api/channel).', + 'method_channels.createChannel_param_broadcast_type_true' => 'Whether to create a [channel](https://core.telegram.org/api/channel)', + 'method_channels.createChannel_param_megagroup_type_true' => 'Whether to create a [supergroup](https://core.telegram.org/api/channel)', + 'method_channels.createChannel_param_title_type_string' => 'Channel title', + 'method_channels.createChannel_param_about_type_string' => 'Channel description', 'method_channels.editAbout' => 'Edit the about text of a channel/supergroup', 'method_channels.editAbout_param_channel_type_InputChannel' => 'The channel', 'method_channels.editAbout_param_about_type_string' => 'The new about text', - 'method_channels.editAdmin' => 'Edit admin permissions of a user in a channel/supergroup', - 'method_channels.editAdmin_param_channel_type_InputChannel' => 'The channel', - 'method_channels.editAdmin_param_user_id_type_InputUser' => 'The user', + 'method_channels.editAdmin' => 'Modify the admin rights of a user in a [supergroup/channel](https://core.telegram.org/api/channel).', + 'method_channels.editAdmin_param_channel_type_InputChannel' => 'The [supergroup/channel](https://core.telegram.org/api/channel).', + 'method_channels.editAdmin_param_user_id_type_InputUser' => 'The ID of the user whose admin rights should be modified', 'method_channels.editAdmin_param_admin_rights_type_ChannelAdminRights' => 'The new admin rights', - 'method_channels.editTitle' => 'Edit the title of a supergroup/channel', - 'method_channels.editTitle_param_channel_type_InputChannel' => 'The channel', - 'method_channels.editTitle_param_title_type_string' => 'The new channel/supergroup title', - 'method_channels.editPhoto' => 'Edit the photo of a supergroup/channel', - 'method_channels.editPhoto_param_channel_type_InputChannel' => 'The channel', - 'method_channels.editPhoto_param_photo_type_InputChatPhoto' => 'The new photo', - 'method_channels.checkUsername' => 'Check if this username is free and can be assigned to a channel/supergroup', - 'method_channels.checkUsername_param_channel_type_InputChannel' => 'The channel/supergroup', - 'method_channels.checkUsername_param_username_type_string' => 'The new username for this channel/supergroup', - 'method_channels.updateUsername' => 'Update the username of a supergroup/channel', - 'method_channels.updateUsername_param_channel_type_InputChannel' => 'The channel/supergroup', - 'method_channels.updateUsername_param_username_type_string' => 'The new username', + 'method_channels.editTitle' => 'Edit the name of a [channel/supergroup](https://core.telegram.org/api/channel)', + 'method_channels.editTitle_param_channel_type_InputChannel' => 'Channel/supergroup', + 'method_channels.editTitle_param_title_type_string' => 'New name', + 'method_channels.editPhoto' => 'Change the photo of a [channel/supergroup](https://core.telegram.org/api/channel)', + 'method_channels.editPhoto_param_channel_type_InputChannel' => 'Channel/supergroup whose photo should be edited', + 'method_channels.editPhoto_param_photo_type_InputChatPhoto' => 'New photo', + 'method_channels.checkUsername' => 'Check if a username is free and can be assigned to a channel/supergroup', + 'method_channels.checkUsername_param_channel_type_InputChannel' => 'The [channel/supergroup](https://core.telegram.org/api/channel) that will assigned the specified username', + 'method_channels.checkUsername_param_username_type_string' => 'The username to check', + 'method_channels.updateUsername' => 'Change the username of a supergroup/channel', + 'method_channels.updateUsername_param_channel_type_InputChannel' => 'Channel', + 'method_channels.updateUsername_param_username_type_string' => 'New username', 'method_channels.joinChannel' => 'Join a channel/supergroup', - 'method_channels.joinChannel_param_channel_type_InputChannel' => 'The channel/supergroup to join', - 'method_channels.leaveChannel' => 'Leave a channel/supergroup', - 'method_channels.leaveChannel_param_channel_type_InputChannel' => 'The channel/supergroup to leave', - 'method_channels.inviteToChannel' => 'Add users to channel/supergroup', - 'method_channels.inviteToChannel_param_channel_type_InputChannel' => 'The channel/supergroup', + 'method_channels.joinChannel_param_channel_type_InputChannel' => 'Channel/supergroup to join', + 'method_channels.leaveChannel' => 'Leave a [channel/supergroup](https://core.telegram.org/api/channel)', + 'method_channels.leaveChannel_param_channel_type_InputChannel' => '[Channel/supergroup](https://core.telegram.org/api/channel) to leave', + 'method_channels.inviteToChannel' => 'Invite users to a channel/supergroup', + 'method_channels.inviteToChannel_param_channel_type_InputChannel' => 'Channel/supergroup', 'method_channels.inviteToChannel_param_users_type_Vector t' => 'The users to add', 'method_channels.exportInvite' => 'Export the invite link of a channel', 'method_channels.exportInvite_param_channel_type_InputChannel' => 'The channel', - 'method_channels.deleteChannel' => 'Delete a channel/supergroup', - 'method_channels.deleteChannel_param_channel_type_InputChannel' => 'The channel/supergroup to delete', + 'method_channels.deleteChannel' => 'Delete a [channel/supergroup](https://core.telegram.org/api/channel)', + 'method_channels.deleteChannel_param_channel_type_InputChannel' => '[Channel/supergroup](https://core.telegram.org/api/channel) to delete', 'method_channels.toggleInvites' => 'Allow or disallow any user to invite users to this channel/supergroup', 'method_channels.toggleInvites_param_channel_type_InputChannel' => 'The channel/supergroup', 'method_channels.toggleInvites_param_enabled_type_Bool' => 'Allow or disallow', - 'method_channels.exportMessageLink' => 'Get the link of a message in a channel', - 'method_channels.exportMessageLink_param_channel_type_InputChannel' => 'The channel/supergroup', - 'method_channels.exportMessageLink_param_id_type_int' => 'The ID of the message', - 'method_channels.exportMessageLink_param_grouped_type_Bool' => 'Is this an album?', - 'method_channels.toggleSignatures' => 'Toggle channel signatures', - 'method_channels.toggleSignatures_param_channel_type_InputChannel' => 'The channel/supergroup', - 'method_channels.toggleSignatures_param_enabled_type_Bool' => 'Enable or disable channel signatures?', + 'method_channels.exportMessageLink' => 'Get link and embed info of a message in a [channel/supergroup](https://core.telegram.org/api/channel)', + 'method_channels.exportMessageLink_param_channel_type_InputChannel' => 'Channel', + 'method_channels.exportMessageLink_param_id_type_int' => 'Message ID', + 'method_channels.exportMessageLink_param_grouped_type_Bool' => 'Whether to include other grouped media (for albums)', + 'method_channels.toggleSignatures' => 'Enable/disable message signatures in channels', + 'method_channels.toggleSignatures_param_channel_type_InputChannel' => 'Channel', + 'method_channels.toggleSignatures_param_enabled_type_Bool' => 'Value', 'method_channels.updatePinnedMessage' => 'Set the pinned message of a channel/supergroup', 'method_channels.updatePinnedMessage_param_silent_type_true' => 'Pin silently', 'method_channels.updatePinnedMessage_param_channel_type_InputChannel' => 'The channel/supergroup', 'method_channels.updatePinnedMessage_param_id_type_int' => 'The ID of the message to pin', - 'method_channels.getAdminedPublicChannels' => 'Get all supergroups/channels where you\'re admin', - 'method_channels.editBanned' => 'Kick or ban a user from a channel/supergroup', - 'method_channels.editBanned_param_channel_type_InputChannel' => 'The channel/supergroup', - 'method_channels.editBanned_param_user_id_type_InputUser' => 'The user to kick/ban', + 'method_channels.getAdminedPublicChannels' => 'Get [channels/supergroups/geogroups](https://core.telegram.org/api/channel) we\'re admin in. Usually called when the user exceeds the [limit](../constructors/config.md) for owned public [channels/supergroups/geogroups](https://core.telegram.org/api/channel), and the user is given the choice to remove one of his channels/supergroups/geogroups.', + 'method_channels.editBanned' => 'Ban/unban/kick a user in a [supergroup/channel](https://core.telegram.org/api/channel).', + 'method_channels.editBanned_param_channel_type_InputChannel' => 'The [supergroup/channel](https://core.telegram.org/api/channel).', + 'method_channels.editBanned_param_user_id_type_InputUser' => 'The ID of the user whose banned rights should be modified', 'method_channels.editBanned_param_banned_rights_type_ChannelBannedRights' => 'Banned/kicked permissions', - 'method_channels.getAdminLog' => 'Get admin log of a channel/supergroup', - 'method_channels.getAdminLog_param_channel_type_InputChannel' => 'The channel/supergroup', - 'method_channels.getAdminLog_param_q_type_string' => 'Search query', + 'method_channels.getAdminLog' => 'Get the admin log of a [channel/supergroup](https://core.telegram.org/api/channel)', + 'method_channels.getAdminLog_param_channel_type_InputChannel' => 'Channel', + 'method_channels.getAdminLog_param_q_type_string' => 'Search query, can be empty', 'method_channels.getAdminLog_param_events_filter_type_ChannelAdminLogEventsFilter' => 'Event filter', 'method_channels.getAdminLog_param_admins_type_Vector t' => 'Fetch only actions from these admins', - 'method_channels.getAdminLog_param_max_id_type_long' => 'Maximum message ID to fetch', - 'method_channels.getAdminLog_param_min_id_type_long' => 'Minimum message ID to fetch', - 'method_channels.getAdminLog_param_limit_type_int' => 'Number of results to fetch', - 'method_channels.setStickers' => 'Set the supergroup/channel stickerpack', - 'method_channels.setStickers_param_channel_type_InputChannel' => 'The channel/supergoup', - 'method_channels.setStickers_param_stickerset_type_InputStickerSet' => 'The stickerset', - 'method_channels.readMessageContents' => 'Mark channel/supergroup messages as read', - 'method_channels.readMessageContents_param_channel_type_InputChannel' => 'The channel', + 'method_channels.getAdminLog_param_max_id_type_long' => 'Maximum ID of message to return (see [pagination](https://core.telegram.org/api/offsets))', + 'method_channels.getAdminLog_param_min_id_type_long' => 'Minimum ID of message to return (see [pagination](https://core.telegram.org/api/offsets))', + 'method_channels.getAdminLog_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)', + 'method_channels.setStickers' => 'Associate a stickerset to the supergroup', + 'method_channels.setStickers_param_channel_type_InputChannel' => 'Supergroup', + 'method_channels.setStickers_param_stickerset_type_InputStickerSet' => 'The stickerset to associate', + 'method_channels.readMessageContents' => 'Mark [channel/supergroup](https://core.telegram.org/api/channel) message contents as read', + 'method_channels.readMessageContents_param_channel_type_InputChannel' => '[Channel/supergroup](https://core.telegram.org/api/channel)', 'method_channels.readMessageContents_param_id_type_Vector t' => 'List of message IDs', - 'method_channels.deleteHistory' => 'Delete the history of a supergroup/channel', - 'method_channels.deleteHistory_param_channel_type_InputChannel' => 'The channel/supergroup', - 'method_channels.deleteHistory_param_max_id_type_int' => 'Maximum message ID to delete', - 'method_channels.togglePreHistoryHidden' => 'Enable or disable hidden history for new channel/supergroup users', - 'method_channels.togglePreHistoryHidden_param_channel_type_InputChannel' => 'The channel/supergroup', - 'method_channels.togglePreHistoryHidden_param_enabled_type_Bool' => 'Enable or disable hidden history for new channel/supergroup users', - 'method_bots.sendCustomRequest' => 'Send a custom request to the bot API', - 'method_bots.sendCustomRequest_param_custom_method_type_string' => 'The method to call', - 'method_bots.sendCustomRequest_param_params_type_DataJSON' => 'Method parameters', - 'method_bots.answerWebhookJSONQuery' => 'Send webhook request via bot API', - 'method_bots.answerWebhookJSONQuery_param_query_id_type_long' => 'The query ID', - 'method_bots.answerWebhookJSONQuery_param_data_type_DataJSON' => 'The parameters', - 'method_payments.getPaymentForm' => 'Get payment form', - 'method_payments.getPaymentForm_param_msg_id_type_int' => 'Message ID', + 'method_channels.deleteHistory' => 'Delete the history of a [supergroup](https://core.telegram.org/api/channel)', + 'method_channels.deleteHistory_param_channel_type_InputChannel' => '[Supergroup](https://core.telegram.org/api/channel) whose history must be deleted', + 'method_channels.deleteHistory_param_max_id_type_int' => 'ID of message **up to which** the history must be deleted', + 'method_channels.togglePreHistoryHidden' => 'Hide/unhide message history for new channel/supergroup users', + 'method_channels.togglePreHistoryHidden_param_channel_type_InputChannel' => 'Channel/supergroup', + 'method_channels.togglePreHistoryHidden_param_enabled_type_Bool' => 'Hide/unhide', + 'method_bots.sendCustomRequest' => 'Sends a custom request; for bots only', + 'method_bots.sendCustomRequest_param_custom_method_type_string' => 'The method name', + 'method_bots.sendCustomRequest_param_params_type_DataJSON' => 'JSON-serialized method parameters', + 'method_bots.answerWebhookJSONQuery' => 'Answers a custom query; for bots only', + 'method_bots.answerWebhookJSONQuery_param_query_id_type_long' => 'Identifier of a custom query', + 'method_bots.answerWebhookJSONQuery_param_data_type_DataJSON' => 'JSON-serialized answer to the query', + 'method_payments.getPaymentForm' => 'Get a payment form', + 'method_payments.getPaymentForm_param_msg_id_type_int' => 'Message ID of payment form', 'method_payments.getPaymentReceipt' => 'Get payment receipt', - 'method_payments.getPaymentReceipt_param_msg_id_type_int' => 'The message ID', - 'method_payments.validateRequestedInfo' => 'Validate requested payment info', - 'method_payments.validateRequestedInfo_param_save_type_true' => 'Save payment info?', - 'method_payments.validateRequestedInfo_param_msg_id_type_int' => 'The message ID', - 'method_payments.validateRequestedInfo_param_info_type_PaymentRequestedInfo' => 'The requested payment info', - 'method_payments.sendPaymentForm' => 'Bots only: send payment form', - 'method_payments.sendPaymentForm_param_msg_id_type_int' => 'Message ID', - 'method_payments.sendPaymentForm_param_requested_info_id_type_string' => 'ID of requested info', - 'method_payments.sendPaymentForm_param_shipping_option_id_type_string' => 'Shipping option ID', + 'method_payments.getPaymentReceipt_param_msg_id_type_int' => 'Message ID of receipt', + 'method_payments.validateRequestedInfo' => 'Submit requested order information for validation', + 'method_payments.validateRequestedInfo_param_save_type_true' => 'Save order information to re-use it for future orders', + 'method_payments.validateRequestedInfo_param_msg_id_type_int' => 'Message ID of payment form', + 'method_payments.validateRequestedInfo_param_info_type_PaymentRequestedInfo' => 'Requested order information', + 'method_payments.sendPaymentForm' => 'Send compiled payment form', + 'method_payments.sendPaymentForm_param_msg_id_type_int' => 'Message ID of form', + 'method_payments.sendPaymentForm_param_requested_info_id_type_string' => 'ID of saved and validated [order info](../constructors/payments.validatedRequestedInfo.md)', + 'method_payments.sendPaymentForm_param_shipping_option_id_type_string' => 'Chosen shipping option ID', 'method_payments.sendPaymentForm_param_credentials_type_InputPaymentCredentials' => 'Payment credentials', - 'method_payments.getSavedInfo' => 'Get saved payments info', - 'method_payments.clearSavedInfo' => 'Clear saved payments info', - 'method_payments.clearSavedInfo_param_credentials_type_true' => 'Clear credentials?', - 'method_payments.clearSavedInfo_param_info_type_true' => 'Clear payment info?', - 'method_stickers.createStickerSet' => 'Create stickerset', - 'method_stickers.createStickerSet_param_masks_type_true' => 'Masks?', - 'method_stickers.createStickerSet_param_user_id_type_InputUser' => 'The user ID associated to this stickerset', - 'method_stickers.createStickerSet_param_title_type_string' => 'The stickerset title', - 'method_stickers.createStickerSet_param_short_name_type_string' => 'The stickerset short name', + 'method_payments.getSavedInfo' => 'Get saved payment information', + 'method_payments.clearSavedInfo' => 'Clear saved payment information', + 'method_payments.clearSavedInfo_param_credentials_type_true' => 'Remove saved payment credentials', + 'method_payments.clearSavedInfo_param_info_type_true' => 'Clear the last order settings saved by the user', + 'method_stickers.createStickerSet' => 'Create a stickerset, bots only.', + 'method_stickers.createStickerSet_param_masks_type_true' => 'Whether this is a mask stickerset', + 'method_stickers.createStickerSet_param_user_id_type_InputUser' => 'Stickerset owner', + 'method_stickers.createStickerSet_param_title_type_string' => 'Stickerset name, `1-64` chars', + 'method_stickers.createStickerSet_param_short_name_type_string' => 'Sticker set name. Can contain only English letters, digits and underscores. Must end with *"*by*"* (** is case insensitive); 1-64 characters', 'method_stickers.createStickerSet_param_stickers_type_Vector t' => 'The stickers to add', - 'method_stickers.removeStickerFromSet' => 'Remove sticker from stickerset', + 'method_stickers.removeStickerFromSet' => 'Remove a sticker from the set where it belongs, bots only. The sticker set must have been created by the bot.', 'method_stickers.removeStickerFromSet_param_sticker_type_InputDocument' => 'The sticker to remove', - 'method_stickers.changeStickerPosition' => 'Change sticker position in photo', + 'method_stickers.changeStickerPosition' => 'Changes the absolute position of a sticker in the set to which it belongs; for bots only. The sticker set must have been created by the bot', 'method_stickers.changeStickerPosition_param_sticker_type_InputDocument' => 'The sticker', - 'method_stickers.changeStickerPosition_param_position_type_int' => 'New position', - 'method_stickers.addStickerToSet' => 'Add sticker to stickerset', + 'method_stickers.changeStickerPosition_param_position_type_int' => 'The new position of the sticker, zero-based', + 'method_stickers.addStickerToSet' => 'Add a sticker to a stickerset, bots only. The sticker set must have been created by the bot.', 'method_stickers.addStickerToSet_param_stickerset_type_InputStickerSet' => 'The stickerset', 'method_stickers.addStickerToSet_param_sticker_type_InputStickerSetItem' => 'The sticker', - 'method_phone.getCallConfig' => 'Get call configuration', - 'method_phone.requestCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.requestCall_param_user_id_type_InputUser' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.requestCall_param_g_a_hash_type_bytes' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.requestCall_param_protocol_type_PhoneCallProtocol' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.acceptCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.acceptCall_param_peer_type_InputPhoneCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.acceptCall_param_g_b_type_bytes' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.acceptCall_param_protocol_type_PhoneCallProtocol' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.confirmCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.confirmCall_param_peer_type_InputPhoneCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.confirmCall_param_g_a_type_bytes' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.confirmCall_param_key_fingerprint_type_long' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.confirmCall_param_protocol_type_PhoneCallProtocol' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.receivedCall' => 'Notify server that you received a call (server will refuse all incoming calls until the current call is over)', - 'method_phone.receivedCall_param_peer_type_InputPhoneCall' => 'The phone call you received', - 'method_phone.discardCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.discardCall_param_peer_type_InputPhoneCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.discardCall_param_duration_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.discardCall_param_reason_type_PhoneCallDiscardReason' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.discardCall_param_connection_id_type_long' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls', - 'method_phone.setCallRating' => 'Set phone call rating', - 'method_phone.setCallRating_param_peer_type_InputPhoneCall' => 'The phone call', - 'method_phone.setCallRating_param_rating_type_int' => 'Rating (1-5 stars)', - 'method_phone.setCallRating_param_comment_type_string' => 'An optional comment', - 'method_phone.saveCallDebug' => 'Save call debugging info', - 'method_phone.saveCallDebug_param_peer_type_InputPhoneCall' => 'The call', - 'method_phone.saveCallDebug_param_debug_type_DataJSON' => 'Debugging info', - 'method_langpack.getLangPack' => 'Get language pack', + 'method_phone.getCallConfig' => 'Get phone call configuration to be passed to libtgvoip\'s shared config', + 'method_phone.requestCall' => 'Start a telegram phone call', + 'method_phone.requestCall_param_user_id_type_InputUser' => 'Destination of the phone call', + 'method_phone.requestCall_param_g_a_hash_type_bytes' => '[Parameter for E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls)', + 'method_phone.requestCall_param_protocol_type_PhoneCallProtocol' => 'Phone call settings', + 'method_phone.acceptCall' => 'Accept incoming call', + 'method_phone.acceptCall_param_peer_type_InputPhoneCall' => 'The call to accept', + 'method_phone.acceptCall_param_g_b_type_bytes' => '[Parameter for E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls)', + 'method_phone.acceptCall_param_protocol_type_PhoneCallProtocol' => 'Phone call settings', + 'method_phone.confirmCall' => '[Complete phone call E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls)', + 'method_phone.confirmCall_param_peer_type_InputPhoneCall' => 'The phone call', + 'method_phone.confirmCall_param_g_a_type_bytes' => '[Parameter for E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls)', + 'method_phone.confirmCall_param_key_fingerprint_type_long' => 'Key fingerprint', + 'method_phone.confirmCall_param_protocol_type_PhoneCallProtocol' => 'Phone call settings', + 'method_phone.receivedCall' => 'Optional: notify the server that the user is currently busy in a call: this will automatically refuse all incoming phone calls until the current phone call is ended.', + 'method_phone.receivedCall_param_peer_type_InputPhoneCall' => 'The phone call we\'re currently in', + 'method_phone.discardCall' => 'Refuse or end running call', + 'method_phone.discardCall_param_peer_type_InputPhoneCall' => 'The phone call', + 'method_phone.discardCall_param_duration_type_int' => 'Call duration', + 'method_phone.discardCall_param_reason_type_PhoneCallDiscardReason' => 'Why was the call discarded', + 'method_phone.discardCall_param_connection_id_type_long' => 'Preferred libtgvoip relay ID', + 'method_phone.setCallRating' => 'Rate a call', + 'method_phone.setCallRating_param_peer_type_InputPhoneCall' => 'The call to rate', + 'method_phone.setCallRating_param_rating_type_int' => 'Rating in `1-5` stars', + 'method_phone.setCallRating_param_comment_type_string' => 'An additional comment', + 'method_phone.saveCallDebug' => 'Send phone call debug data to server', + 'method_phone.saveCallDebug_param_peer_type_InputPhoneCall' => 'Phone call', + 'method_phone.saveCallDebug_param_debug_type_DataJSON' => 'Debug statistics obtained from libtgvoip', + 'method_langpack.getLangPack' => 'Get localization pack strings', 'method_langpack.getLangPack_param_lang_code_type_string' => 'Language code', - 'method_langpack.getStrings' => 'Get language pack strings', + 'method_langpack.getStrings' => 'Get strings from a language pack', 'method_langpack.getStrings_param_lang_code_type_string' => 'Language code', 'method_langpack.getStrings_param_keys_type_Vector t' => 'Keys', - 'method_langpack.getDifference' => 'Get language pack updates', - 'method_langpack.getDifference_param_from_version_type_int' => 'Previous version', - 'method_langpack.getLanguages' => 'Get available languages', + 'method_langpack.getDifference' => 'Get new strings in languagepack', + 'method_langpack.getDifference_param_from_version_type_int' => 'Previous localization pack version', + 'method_langpack.getLanguages' => 'Get information about all languages in a localization pack', 'method_auth.sendCode_param_sms_type_type_int' => 'You cannot use this method directly, use the phoneLogin method instead (see https://docs.madelineproto.xyz for more info)', 'method_auth.sendCode_param_lang_code_type_string' => 'You cannot use this method directly, use the phoneLogin method instead (see https://docs.madelineproto.xyz for more info)', 'method_auth.sendCall' => 'Send verification phone call', @@ -1276,7 +1282,7 @@ class Lang 'method_auth.importBotAuthorization_param_b_type_true' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)', 'method_auth.importBotAuthorization_param_c_type_true' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)', 'method_auth.importBotAuthorization_param_d_type_true' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)', - 'object_vector' => 'Array', + 'object_vector' => 'A universal vector constructor.', 'object_resPQ' => 'Contains pq to factorize', 'object_resPQ_param_nonce_type_int128' => 'Nonce', 'object_resPQ_param_server_nonce_type_int128' => 'Server nonce', @@ -1407,142 +1413,142 @@ class Lang 'object_bind_auth_key_inner_param_perm_auth_key_id_type_long' => 'Perm auth key ID', 'object_bind_auth_key_inner_param_temp_session_id_type_long' => 'Temp session ID', 'object_bind_auth_key_inner_param_expires_at_type_int' => 'Expires at', - 'object_boolFalse' => 'Bool false', - 'object_boolTrue' => 'Bool true', - 'object_true' => 'True', - 'object_error' => 'Error', - 'object_error_param_code_type_int' => 'Code', - 'object_error_param_text_type_string' => 'Text', - 'object_null' => 'Null', - 'object_inputPeerEmpty' => 'Empty input peer', - 'object_inputPeerSelf' => 'Peer self', - 'object_inputPeerChat' => 'Peer chat', - 'object_inputPeerChat_param_chat_id_type_int' => 'Chat ID', - 'object_inputPeerUser' => 'Peer user', - 'object_inputPeerUser_param_user_id_type_int' => 'User ID', - 'object_inputPeerUser_param_access_hash_type_long' => 'Access hash', - 'object_inputPeerChannel' => 'Peer channel', - 'object_inputPeerChannel_param_channel_id_type_int' => 'Channel ID', - 'object_inputPeerChannel_param_access_hash_type_long' => 'Access hash', - 'object_inputUserEmpty' => 'Empty input user', - 'object_inputUserSelf' => 'User self', - 'object_inputUser' => 'User', - 'object_inputUser_param_user_id_type_int' => 'User ID', - 'object_inputUser_param_access_hash_type_long' => 'Access hash', - 'object_inputPhoneContact' => 'Phone contact', - 'object_inputPhoneContact_param_client_id_type_long' => 'Client ID', - 'object_inputPhoneContact_param_phone_type_string' => 'Phone', - 'object_inputPhoneContact_param_first_name_type_string' => 'First name', - 'object_inputPhoneContact_param_last_name_type_string' => 'Last name', - 'object_inputFile' => 'File', - 'object_inputFile_param_id_type_long' => 'ID', - 'object_inputFile_param_parts_type_int' => 'Parts', - 'object_inputFile_param_name_type_string' => 'Name', - 'object_inputFile_param_md5_checksum_type_string' => 'Md5 checksum', - 'object_inputFileBig' => 'File big', - 'object_inputFileBig_param_id_type_long' => 'ID', - 'object_inputFileBig_param_parts_type_int' => 'Parts', - 'object_inputFileBig_param_name_type_string' => 'Name', - 'object_inputMediaEmpty' => 'Empty input media', - 'object_inputMediaUploadedPhoto' => 'Media uploaded photo', - 'object_inputMediaUploadedPhoto_param_file_type_InputFile' => 'File', + 'object_boolFalse' => 'Constructor may be interpreted as a **boolean**`false` value.', + 'object_boolTrue' => 'The constructor can be interpreted as a **boolean**`true` value.', + 'object_true' => 'See [predefined identifiers](https://core.telegram.org/mtproto/TL-formal#predefined-identifiers).', + 'object_error' => 'Error.', + 'object_error_param_code_type_int' => 'Error code', + 'object_error_param_text_type_string' => 'Message', + 'object_null' => 'Corresponds to an arbitrary empty object.', + 'object_inputPeerEmpty' => 'An empty constructor, no user or chat is defined.', + 'object_inputPeerSelf' => 'Defines the current user.', + 'object_inputPeerChat' => 'Defines a chat for further interaction.', + 'object_inputPeerChat_param_chat_id_type_int' => 'Chat idientifier', + 'object_inputPeerUser' => 'Defines a user for further interaction.', + 'object_inputPeerUser_param_user_id_type_int' => 'User identifier', + 'object_inputPeerUser_param_access_hash_type_long' => '**access\\_hash** value from the [user](../constructors/user.md) constructor', + 'object_inputPeerChannel' => 'Defines a channel for further interaction.', + 'object_inputPeerChannel_param_channel_id_type_int' => 'Channel identifier', + 'object_inputPeerChannel_param_access_hash_type_long' => '**access\\_hash** value from the [channel](../constructors/channel.md) constructor', + 'object_inputUserEmpty' => 'Empty constructor, does not define a user.', + 'object_inputUserSelf' => 'Defines the current user.', + 'object_inputUser' => 'Defines a user for further interaction.', + 'object_inputUser_param_user_id_type_int' => 'User identifier', + 'object_inputUser_param_access_hash_type_long' => '**access\\_hash** value from the [user](../constructors/user.md) constructor', + 'object_inputPhoneContact' => 'Phone contact. The `client_id` is just an arbitrary contact ID: it should be set, for example, to an incremental number when using [contacts.importContacts](../methods/contacts.importContacts.md), in order to retry importing only the contacts that weren\'t imported successfully.', + 'object_inputPhoneContact_param_client_id_type_long' => 'User identifier on the client', + 'object_inputPhoneContact_param_phone_type_string' => 'Phone number', + 'object_inputPhoneContact_param_first_name_type_string' => 'Contact\'s first name', + 'object_inputPhoneContact_param_last_name_type_string' => 'Contact\'s last name', + 'object_inputFile' => 'Defines a file saved in parts using the method [upload.saveFilePart](../methods/upload.saveFilePart.md).', + 'object_inputFile_param_id_type_long' => 'Random file identifier created by the client', + 'object_inputFile_param_parts_type_int' => 'Number of parts saved', + 'object_inputFile_param_name_type_string' => 'Full name of the file', + 'object_inputFile_param_md5_checksum_type_string' => 'In case the file\'s [md5-hash](https://en.wikipedia.org/wiki/MD5#MD5_hashes) was passed, contents of the file will be checked prior to use', + 'object_inputFileBig' => 'Assigns a big file (over 10Mb in size), saved in part using the method [upload.saveBigFilePart](../methods/upload.saveBigFilePart.md).', + 'object_inputFileBig_param_id_type_long' => 'Random file id, created by the client', + 'object_inputFileBig_param_parts_type_int' => 'Number of parts saved', + 'object_inputFileBig_param_name_type_string' => 'Full file name', + 'object_inputMediaEmpty' => 'Empty media content of a message.', + 'object_inputMediaUploadedPhoto' => 'Photo', + 'object_inputMediaUploadedPhoto_param_file_type_InputFile' => 'The [uploaded file](https://core.telegram.org/api/files)', 'object_inputMediaUploadedPhoto_param_stickers_type_Vector t' => 'Stickers', - 'object_inputMediaUploadedPhoto_param_ttl_seconds_type_int' => 'Ttl seconds', - 'object_inputMediaPhoto' => 'Media photo', - 'object_inputMediaPhoto_param_id_type_InputPhoto' => 'ID', - 'object_inputMediaPhoto_param_ttl_seconds_type_int' => 'Ttl seconds', - 'object_inputMediaGeoPoint' => 'Media geo point', - 'object_inputMediaGeoPoint_param_geo_point_type_InputGeoPoint' => 'Geo point', - 'object_inputMediaContact' => 'Media contact', + 'object_inputMediaUploadedPhoto_param_ttl_seconds_type_int' => 'Time to live in seconds of self-destructing photo', + 'object_inputMediaPhoto' => 'Forwarded photo', + 'object_inputMediaPhoto_param_id_type_InputPhoto' => 'Photo to be forwarded', + 'object_inputMediaPhoto_param_ttl_seconds_type_int' => 'Time to live in seconds of self-destructing photo', + 'object_inputMediaGeoPoint' => 'Map.', + 'object_inputMediaGeoPoint_param_geo_point_type_InputGeoPoint' => 'GeoPoint', + 'object_inputMediaContact' => 'Phonebook contact', 'object_inputMediaContact_param_phone_number_type_string' => 'Phone number', - 'object_inputMediaContact_param_first_name_type_string' => 'First name', - 'object_inputMediaContact_param_last_name_type_string' => 'Last name', - 'object_inputMediaUploadedDocument' => 'Media uploaded document', - 'object_inputMediaUploadedDocument_param_nosound_video_type_true' => 'Nosound video?', - 'object_inputMediaUploadedDocument_param_file_type_InputFile' => 'File', - 'object_inputMediaUploadedDocument_param_thumb_type_InputFile' => 'Thumbnail', - 'object_inputMediaUploadedDocument_param_mime_type_type_string' => 'Mime type', + 'object_inputMediaContact_param_first_name_type_string' => 'Contact\'s first name', + 'object_inputMediaContact_param_last_name_type_string' => 'Contact\'s last name', + 'object_inputMediaUploadedDocument' => 'New document', + 'object_inputMediaUploadedDocument_param_nosound_video_type_true' => 'Whether the specified document is a video file with no audio tracks (a GIF animation (even as MPEG4), for example)', + 'object_inputMediaUploadedDocument_param_file_type_InputFile' => 'The [uploaded file](https://core.telegram.org/api/files)', + 'object_inputMediaUploadedDocument_param_thumb_type_InputFile' => 'Thumbnail of the document, uploaded as for the file', + 'object_inputMediaUploadedDocument_param_mime_type_type_string' => 'MIME type of document', 'object_inputMediaUploadedDocument_param_attributes_type_Vector t' => 'Attributes', 'object_inputMediaUploadedDocument_param_stickers_type_Vector t' => 'Stickers', - 'object_inputMediaUploadedDocument_param_ttl_seconds_type_int' => 'Ttl seconds', - 'object_inputMediaDocument' => 'Media document', - 'object_inputMediaDocument_param_id_type_InputDocument' => 'ID', - 'object_inputMediaDocument_param_ttl_seconds_type_int' => 'Ttl seconds', - 'object_inputMediaVenue' => 'Media venue', - 'object_inputMediaVenue_param_geo_point_type_InputGeoPoint' => 'Geo point', - 'object_inputMediaVenue_param_title_type_string' => 'Title', - 'object_inputMediaVenue_param_address_type_string' => 'Address', - 'object_inputMediaVenue_param_provider_type_string' => 'Provider', - 'object_inputMediaVenue_param_venue_id_type_string' => 'Venue ID', - 'object_inputMediaVenue_param_venue_type_type_string' => 'Venue type', - 'object_inputMediaGifExternal' => 'Media gif external', + 'object_inputMediaUploadedDocument_param_ttl_seconds_type_int' => 'Time to live in seconds of self-destructing document', + 'object_inputMediaDocument' => 'Forwarded document', + 'object_inputMediaDocument_param_id_type_InputDocument' => 'The document to be forwarded.', + 'object_inputMediaDocument_param_ttl_seconds_type_int' => 'Time to live of self-destructing document', + 'object_inputMediaVenue' => 'Can be used to send a venue geolocation.', + 'object_inputMediaVenue_param_geo_point_type_InputGeoPoint' => 'Geolocation', + 'object_inputMediaVenue_param_title_type_string' => 'Venue name', + 'object_inputMediaVenue_param_address_type_string' => 'Physical address of the venue', + 'object_inputMediaVenue_param_provider_type_string' => 'Venue provider: currently only "foursquare" needs to be supported', + 'object_inputMediaVenue_param_venue_id_type_string' => 'Venue ID in the provider\'s database', + 'object_inputMediaVenue_param_venue_type_type_string' => 'Venue type in the provider\'s database', + 'object_inputMediaGifExternal' => 'New GIF animation that will be uploaded by the server using the specified URL', 'object_inputMediaGifExternal_param_url_type_string' => 'URL', - 'object_inputMediaGifExternal_param_q_type_string' => 'Q', - 'object_inputMediaPhotoExternal' => 'Media photo external', - 'object_inputMediaPhotoExternal_param_url_type_string' => 'URL', - 'object_inputMediaPhotoExternal_param_ttl_seconds_type_int' => 'Ttl seconds', - 'object_inputMediaDocumentExternal' => 'Media document external', - 'object_inputMediaDocumentExternal_param_url_type_string' => 'URL', - 'object_inputMediaDocumentExternal_param_ttl_seconds_type_int' => 'Ttl seconds', - 'object_inputMediaGame' => 'Media game', - 'object_inputMediaGame_param_id_type_InputGame' => 'ID', - 'object_inputMediaInvoice' => 'Media invoice', - 'object_inputMediaInvoice_param_title_type_string' => 'Title', - 'object_inputMediaInvoice_param_description_type_string' => 'Description', - 'object_inputMediaInvoice_param_photo_type_InputWebDocument' => 'Photo', - 'object_inputMediaInvoice_param_invoice_type_Invoice' => 'Invoice', - 'object_inputMediaInvoice_param_payload_type_bytes' => 'Payload', - 'object_inputMediaInvoice_param_provider_type_string' => 'Provider', - 'object_inputMediaInvoice_param_provider_data_type_DataJSON' => 'Provider data', - 'object_inputMediaInvoice_param_start_param_type_string' => 'Start param', - 'object_inputMediaGeoLive' => 'Media geo live', - 'object_inputMediaGeoLive_param_geo_point_type_InputGeoPoint' => 'Geo point', - 'object_inputMediaGeoLive_param_period_type_int' => 'Period', - 'object_inputChatPhotoEmpty' => 'Empty input chat photo', - 'object_inputChatUploadedPhoto' => 'Chat uploaded photo', - 'object_inputChatUploadedPhoto_param_file_type_InputFile' => 'File', - 'object_inputChatPhoto' => 'Chat photo', - 'object_inputChatPhoto_param_id_type_InputPhoto' => 'ID', - 'object_inputGeoPointEmpty' => 'Empty input geo point', - 'object_inputGeoPoint' => 'Geo point', - 'object_inputGeoPoint_param_lat_type_double' => 'Lat', - 'object_inputGeoPoint_param_long_type_double' => 'Long', - 'object_inputPhotoEmpty' => 'Empty input photo', - 'object_inputPhoto' => 'Photo', - 'object_inputPhoto_param_id_type_long' => 'ID', - 'object_inputPhoto_param_access_hash_type_long' => 'Access hash', - 'object_inputFileLocation' => 'File location', - 'object_inputFileLocation_param_volume_id_type_long' => 'Volume ID', - 'object_inputFileLocation_param_local_id_type_int' => 'Local ID', - 'object_inputFileLocation_param_secret_type_long' => 'Secret', - 'object_inputEncryptedFileLocation' => 'Encrypted file location', - 'object_inputEncryptedFileLocation_param_id_type_long' => 'ID', - 'object_inputEncryptedFileLocation_param_access_hash_type_long' => 'Access hash', - 'object_inputDocumentFileLocation' => 'Document file location', - 'object_inputDocumentFileLocation_param_id_type_long' => 'ID', - 'object_inputDocumentFileLocation_param_access_hash_type_long' => 'Access hash', + 'object_inputMediaGifExternal_param_q_type_string' => 'Query', + 'object_inputMediaPhotoExternal' => 'New photo that will be uploaded by the server using the specified URL', + 'object_inputMediaPhotoExternal_param_url_type_string' => 'URL of the photo', + 'object_inputMediaPhotoExternal_param_ttl_seconds_type_int' => 'Self-destruct time to live of photo', + 'object_inputMediaDocumentExternal' => 'Document that will be downloaded by the telegram servers', + 'object_inputMediaDocumentExternal_param_url_type_string' => 'URL of the document', + 'object_inputMediaDocumentExternal_param_ttl_seconds_type_int' => 'Self-destruct time to live of document', + 'object_inputMediaGame' => 'A game', + 'object_inputMediaGame_param_id_type_InputGame' => 'The game to forward', + 'object_inputMediaInvoice' => 'Generated invoice of a [bot payment](https://core.telegram.org/bots/payments)', + 'object_inputMediaInvoice_param_title_type_string' => 'Product name, 1-32 characters', + 'object_inputMediaInvoice_param_description_type_string' => 'Product description, 1-255 characters', + 'object_inputMediaInvoice_param_photo_type_InputWebDocument' => 'URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. People like it better when they see what they are paying for.', + 'object_inputMediaInvoice_param_invoice_type_Invoice' => 'The actual invoice', + 'object_inputMediaInvoice_param_payload_type_bytes' => 'Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes.', + 'object_inputMediaInvoice_param_provider_type_string' => 'Payments provider token, obtained via [Botfather](https://t.me/botfather)', + 'object_inputMediaInvoice_param_provider_data_type_DataJSON' => 'JSON-encoded data about the invoice, which will be shared with the payment provider. A detailed description of required fields should be provided by the payment provider.', + 'object_inputMediaInvoice_param_start_param_type_string' => 'Start parameter', + 'object_inputMediaGeoLive' => 'Live geographical location', + 'object_inputMediaGeoLive_param_geo_point_type_InputGeoPoint' => 'Current geolocation', + 'object_inputMediaGeoLive_param_period_type_int' => 'Validity period of the current location', + 'object_inputChatPhotoEmpty' => 'Empty constructor, remove group photo.', + 'object_inputChatUploadedPhoto' => 'New photo to be set as group profile photo.', + 'object_inputChatUploadedPhoto_param_file_type_InputFile' => 'File saved in parts using the method [upload.saveFilePart](../methods/upload.saveFilePart.md)', + 'object_inputChatPhoto' => 'Existing photo to be set as a chat profile photo.', + 'object_inputChatPhoto_param_id_type_InputPhoto' => 'Existing photo', + 'object_inputGeoPointEmpty' => 'Empty GeoPoint constructor.', + 'object_inputGeoPoint' => 'Defines a GeoPoint by its coordinates.', + 'object_inputGeoPoint_param_lat_type_double' => 'Latitide', + 'object_inputGeoPoint_param_long_type_double' => 'Longtitude', + 'object_inputPhotoEmpty' => 'Empty constructor.', + 'object_inputPhoto' => 'Defines a photo for further interaction.', + 'object_inputPhoto_param_id_type_long' => 'Photo identifier', + 'object_inputPhoto_param_access_hash_type_long' => '**access\\_hash** value from the [photo](../constructors/photo.md) constructor', + 'object_inputFileLocation' => 'DEPRECATED location of a photo', + 'object_inputFileLocation_param_volume_id_type_long' => 'Server volume', + 'object_inputFileLocation_param_local_id_type_int' => 'File identifier', + 'object_inputFileLocation_param_secret_type_long' => 'Check sum to access the file', + 'object_inputEncryptedFileLocation' => 'Location of encrypted secret chat file.', + 'object_inputEncryptedFileLocation_param_id_type_long' => 'File ID, **id** parameter value from [encryptedFile](../constructors/encryptedFile.md)', + 'object_inputEncryptedFileLocation_param_access_hash_type_long' => 'Checksum, **access\\_hash** parameter value from [encryptedFile](../constructors/encryptedFile.md)', + 'object_inputDocumentFileLocation' => 'Document location (video, voice, audio, basically every type except photo)', + 'object_inputDocumentFileLocation_param_id_type_long' => 'Document ID', + 'object_inputDocumentFileLocation_param_access_hash_type_long' => '**access\\_hash** parameter from the [document](../constructors/document.md) constructor', 'object_inputDocumentFileLocation_param_version_type_int' => 'Version', - 'object_inputAppEvent' => 'App event', - 'object_inputAppEvent_param_time_type_double' => 'Time', - 'object_inputAppEvent_param_type_type_string' => 'Type', - 'object_inputAppEvent_param_peer_type_long' => 'Peer', + 'object_inputAppEvent' => 'Event that occured in the application.', + 'object_inputAppEvent_param_time_type_double' => 'Client\'s exact timestamp for the event', + 'object_inputAppEvent_param_type_type_string' => 'Type of event', + 'object_inputAppEvent_param_peer_type_long' => 'Arbitrary numeric value for more convenient selection of certain event types, or events referring to a certain object', 'object_inputAppEvent_param_data_type_string' => 'Data', - 'object_peerUser' => 'Peer user', - 'object_peerUser_param_user_id_type_int' => 'User ID', - 'object_peerChat' => 'Peer chat', - 'object_peerChat_param_chat_id_type_int' => 'Chat ID', - 'object_peerChannel' => 'Peer channel', + 'object_peerUser' => 'Chat partner', + 'object_peerUser_param_user_id_type_int' => 'User identifier', + 'object_peerChat' => 'Group.', + 'object_peerChat_param_chat_id_type_int' => 'Group identifier', + 'object_peerChannel' => 'Channel/supergroup', 'object_peerChannel_param_channel_id_type_int' => 'Channel ID', - 'object_storage.fileUnknown' => 'File unknown', - 'object_storage.filePartial' => 'File partial', - 'object_storage.fileJpeg' => 'File jpeg', - 'object_storage.fileGif' => 'File gif', - 'object_storage.filePng' => 'File png', - 'object_storage.filePdf' => 'File pdf', - 'object_storage.fileMp3' => 'File mp3', - 'object_storage.fileMov' => 'File mov', - 'object_storage.fileMp4' => 'File mp4', - 'object_storage.fileWebp' => 'File webp', + 'object_storage.fileUnknown' => 'Unknown type.', + 'object_storage.filePartial' => 'Part of a bigger file.', + 'object_storage.fileJpeg' => 'JPEG image. MIME type: `image/jpeg`.', + 'object_storage.fileGif' => 'GIF image. MIME type: `image/gif`.', + 'object_storage.filePng' => 'PNG image. MIME type: `image/png`.', + 'object_storage.filePdf' => 'PDF document image. MIME type: `application/pdf`.', + 'object_storage.fileMp3' => 'Mp3 audio. MIME type: `audio/mpeg`.', + 'object_storage.fileMov' => 'Quicktime video. MIME type: `video/quicktime`.', + 'object_storage.fileMp4' => 'MPEG-4 video. MIME type: `video/mp4`.', + 'object_storage.fileWebp' => 'WEBP image. MIME type: `image/webp`.', 'object_fileLocationUnavailable' => 'File location unavailable', 'object_fileLocationUnavailable_param_volume_id_type_long' => 'Volume ID', 'object_fileLocationUnavailable_param_local_id_type_int' => 'Local ID', @@ -1552,328 +1558,328 @@ class Lang 'object_fileLocation_param_volume_id_type_long' => 'Volume ID', 'object_fileLocation_param_local_id_type_int' => 'Local ID', 'object_fileLocation_param_secret_type_long' => 'Secret', - 'object_userEmpty' => 'Empty user', - 'object_userEmpty_param_id_type_int' => 'ID', - 'object_user' => 'User', - 'object_user_param_self_type_true' => 'Self?', - 'object_user_param_contact_type_true' => 'Contact?', - 'object_user_param_mutual_contact_type_true' => 'Mutual contact?', - 'object_user_param_deleted_type_true' => 'Deleted?', - 'object_user_param_bot_type_true' => 'Bot?', - 'object_user_param_bot_chat_history_type_true' => 'Bot chat history?', - 'object_user_param_bot_nochats_type_true' => 'Bot nochats?', - 'object_user_param_verified_type_true' => 'Verified?', - 'object_user_param_restricted_type_true' => 'Restricted?', - 'object_user_param_min_type_true' => 'Min?', - 'object_user_param_bot_inline_geo_type_true' => 'Bot inline geo?', - 'object_user_param_id_type_int' => 'ID', - 'object_user_param_access_hash_type_long' => 'Access hash', + 'object_userEmpty' => 'Empty constructor, non-existent user.', + 'object_userEmpty_param_id_type_int' => 'User identifier or `0`', + 'object_user' => 'Indicates info about a certain user', + 'object_user_param_self_type_true' => 'Whether this user indicates the currently logged in user', + 'object_user_param_contact_type_true' => 'Whether this user is a contact', + 'object_user_param_mutual_contact_type_true' => 'Whether this user is a mutual contact', + 'object_user_param_deleted_type_true' => 'Whether the account of this user was deleted', + 'object_user_param_bot_type_true' => 'Is this user a bot?', + 'object_user_param_bot_chat_history_type_true' => 'Can the bot see all messages in groups?', + 'object_user_param_bot_nochats_type_true' => 'Can the bot be added to groups?', + 'object_user_param_verified_type_true' => 'Whether this user is verified', + 'object_user_param_restricted_type_true' => 'Access to this user must be restricted for the reason specified in `restriction_reason`', + 'object_user_param_min_type_true' => 'See [min](https://core.telegram.org/api/min)', + 'object_user_param_bot_inline_geo_type_true' => 'Whether the bot can request our geolocation in inline mode', + 'object_user_param_id_type_int' => 'ID of the user', + 'object_user_param_access_hash_type_long' => 'Access hash of the user', 'object_user_param_first_name_type_string' => 'First name', 'object_user_param_last_name_type_string' => 'Last name', 'object_user_param_username_type_string' => 'Username', - 'object_user_param_phone_type_string' => 'Phone', - 'object_user_param_photo_type_UserProfilePhoto' => 'Photo', - 'object_user_param_status_type_UserStatus' => 'Status', - 'object_user_param_bot_info_version_type_int' => 'Bot info version', + 'object_user_param_phone_type_string' => 'Phone number', + 'object_user_param_photo_type_UserProfilePhoto' => 'Profile picture of user', + 'object_user_param_status_type_UserStatus' => 'Online status of user', + 'object_user_param_bot_info_version_type_int' => 'Version of the [bot\\_info field in userFull](../constructors/userFull.md), incremented every time it changes', 'object_user_param_restriction_reason_type_string' => 'Restriction reason', - 'object_user_param_bot_inline_placeholder_type_string' => 'Bot inline placeholder', - 'object_user_param_lang_code_type_string' => 'Lang code', - 'object_userProfilePhotoEmpty' => 'Empty user profile photo', - 'object_userProfilePhoto' => 'User profile photo', - 'object_userProfilePhoto_param_photo_id_type_long' => 'Photo ID', - 'object_userProfilePhoto_param_photo_small_type_FileLocation' => 'Photo small', - 'object_userProfilePhoto_param_photo_big_type_FileLocation' => 'Photo big', - 'object_chatEmpty' => 'Empty chat', - 'object_chatEmpty_param_id_type_int' => 'ID', - 'object_chat' => 'Chat', - 'object_chat_param_creator_type_true' => 'Creator?', - 'object_chat_param_kicked_type_true' => 'Kicked?', - 'object_chat_param_left_type_true' => 'Left?', + 'object_user_param_bot_inline_placeholder_type_string' => 'Inline placeholder for this inline bot', + 'object_user_param_lang_code_type_string' => 'Language code of the user', + 'object_userProfilePhotoEmpty' => 'Profile photo has not been set, or was hidden.', + 'object_userProfilePhoto' => 'User profile photo.', + 'object_userProfilePhoto_param_photo_id_type_long' => 'Identifier of the respective photo
Parameter added in [Layer 2](https://core.telegram.org/api/layers#layer-2)', + 'object_userProfilePhoto_param_photo_small_type_FileLocation' => 'Location of the file, corresponding to the small profile photo thumbnail', + 'object_userProfilePhoto_param_photo_big_type_FileLocation' => 'Location of the file, corresponding to the big profile photo thumbnail', + 'object_chatEmpty' => 'Empty constructor, group doesn\'t exist', + 'object_chatEmpty_param_id_type_int' => 'Group identifier', + 'object_chat' => 'Info about a group', + 'object_chat_param_creator_type_true' => 'Whether the current user is the creator of the group', + 'object_chat_param_kicked_type_true' => 'Whether the current user was kicked from the group', + 'object_chat_param_left_type_true' => 'Whether the current user has left the group', 'object_chat_param_admins_enabled_type_true' => 'Admins enabled?', 'object_chat_param_admin_type_true' => 'Admin?', - 'object_chat_param_deactivated_type_true' => 'Deactivated?', - 'object_chat_param_id_type_int' => 'ID', + 'object_chat_param_deactivated_type_true' => 'Whether the group was [migrated](https://core.telegram.org/api/channel)', + 'object_chat_param_id_type_int' => 'ID of the group', 'object_chat_param_title_type_string' => 'Title', - 'object_chat_param_photo_type_ChatPhoto' => 'Photo', - 'object_chat_param_participants_count_type_int' => 'Participants count', - 'object_chat_param_date_type_int' => 'Date', - 'object_chat_param_version_type_int' => 'Version', - 'object_chat_param_migrated_to_type_InputChannel' => 'Migrated to', - 'object_chatForbidden' => 'Chat forbidden', - 'object_chatForbidden_param_id_type_int' => 'ID', - 'object_chatForbidden_param_title_type_string' => 'Title', - 'object_channel' => 'Channel', - 'object_channel_param_creator_type_true' => 'Creator?', - 'object_channel_param_left_type_true' => 'Left?', + 'object_chat_param_photo_type_ChatPhoto' => 'Chat photo', + 'object_chat_param_participants_count_type_int' => 'Participant count', + 'object_chat_param_date_type_int' => 'Date of creation of the group', + 'object_chat_param_version_type_int' => 'Used in basic groups to reorder updates and make sure that all of them were received.', + 'object_chat_param_migrated_to_type_InputChannel' => 'Means this chat was [upgraded](https://core.telegram.org/api/channel) to a supergroup', + 'object_chatForbidden' => 'A group to which the user has no access. E.g., because the user was kicked from the group.', + 'object_chatForbidden_param_id_type_int' => 'User identifier', + 'object_chatForbidden_param_title_type_string' => 'Group name', + 'object_channel' => 'Channel/supergroup info', + 'object_channel_param_creator_type_true' => 'Whether the current user is the creator of this channel', + 'object_channel_param_left_type_true' => 'Whether the current user has left this channel', 'object_channel_param_editor_type_true' => 'Editor?', - 'object_channel_param_broadcast_type_true' => 'Broadcast?', - 'object_channel_param_verified_type_true' => 'Verified?', - 'object_channel_param_megagroup_type_true' => 'Megagroup?', - 'object_channel_param_restricted_type_true' => 'Restricted?', + 'object_channel_param_broadcast_type_true' => 'Is this a channel?', + 'object_channel_param_verified_type_true' => 'Is this channel verified by telegram?', + 'object_channel_param_megagroup_type_true' => 'Is this a supergroup?', + 'object_channel_param_restricted_type_true' => 'Whether viewing/writing in this channel for a reason (see `restriction_reason`', 'object_channel_param_democracy_type_true' => 'Democracy?', - 'object_channel_param_signatures_type_true' => 'Signatures?', - 'object_channel_param_min_type_true' => 'Min?', - 'object_channel_param_id_type_int' => 'ID', + 'object_channel_param_signatures_type_true' => 'Whether signatures are enabled (channels)', + 'object_channel_param_min_type_true' => 'See [min](https://core.telegram.org/api/min)', + 'object_channel_param_id_type_int' => 'ID of the channel', 'object_channel_param_access_hash_type_long' => 'Access hash', 'object_channel_param_title_type_string' => 'Title', 'object_channel_param_username_type_string' => 'Username', - 'object_channel_param_photo_type_ChatPhoto' => 'Photo', - 'object_channel_param_date_type_int' => 'Date', - 'object_channel_param_version_type_int' => 'Version', + 'object_channel_param_photo_type_ChatPhoto' => 'Profile photo', + 'object_channel_param_date_type_int' => 'Creation date', + 'object_channel_param_version_type_int' => 'Version of the channel (always `0`)', 'object_channel_param_restriction_reason_type_string' => 'Restriction reason', 'object_channel_param_admin_rights_type_ChannelAdminRights' => 'Admin rights', 'object_channel_param_banned_rights_type_ChannelBannedRights' => 'Banned rights', - 'object_channel_param_participants_count_type_int' => 'Participants count', - 'object_channelForbidden' => 'Forbidden channel', - 'object_channelForbidden_param_broadcast_type_true' => 'Broadcast?', - 'object_channelForbidden_param_megagroup_type_true' => 'Megagroup?', - 'object_channelForbidden_param_id_type_int' => 'ID', + 'object_channel_param_participants_count_type_int' => 'Participant count', + 'object_channelForbidden' => 'Indicates a channel/supergroup we can\'t access because we were banned, or for some other reason.', + 'object_channelForbidden_param_broadcast_type_true' => 'Is this a channel', + 'object_channelForbidden_param_megagroup_type_true' => 'Is this a supergroup', + 'object_channelForbidden_param_id_type_int' => 'Channel ID', 'object_channelForbidden_param_access_hash_type_long' => 'Access hash', 'object_channelForbidden_param_title_type_string' => 'Title', - 'object_channelForbidden_param_until_date_type_int' => 'Until date', - 'object_chatFull' => 'Chat full', - 'object_chatFull_param_id_type_int' => 'ID', - 'object_chatFull_param_participants_type_ChatParticipants' => 'Participants', + 'object_channelForbidden_param_until_date_type_int' => 'The ban is valid until the specified date', + 'object_chatFull' => 'Detailed chat info', + 'object_chatFull_param_id_type_int' => 'ID of the chat', + 'object_chatFull_param_participants_type_ChatParticipants' => 'Participant list', 'object_chatFull_param_chat_photo_type_Photo' => 'Chat photo', - 'object_chatFull_param_notify_settings_type_PeerNotifySettings' => 'Notify settings', - 'object_chatFull_param_exported_invite_type_ExportedChatInvite' => 'Exported invite', + 'object_chatFull_param_notify_settings_type_PeerNotifySettings' => 'Notification settings', + 'object_chatFull_param_exported_invite_type_ExportedChatInvite' => 'Chat invite', 'object_chatFull_param_bot_info_type_Vector t' => 'Bot info', - 'object_channelFull' => 'Full channel', - 'object_channelFull_param_can_view_participants_type_true' => 'Can view participants?', - 'object_channelFull_param_can_set_username_type_true' => 'Can set username?', - 'object_channelFull_param_can_set_stickers_type_true' => 'Can set group stickerset?', - 'object_channelFull_param_hidden_prehistory_type_true' => 'Hidden prehistory?', - 'object_channelFull_param_id_type_int' => 'ID', - 'object_channelFull_param_about_type_string' => 'About', - 'object_channelFull_param_participants_count_type_int' => 'Participants count', - 'object_channelFull_param_admins_count_type_int' => 'Admins count', - 'object_channelFull_param_kicked_count_type_int' => 'Kicked count', - 'object_channelFull_param_banned_count_type_int' => 'Banned count', - 'object_channelFull_param_read_inbox_max_id_type_int' => 'Read inbox max ID', - 'object_channelFull_param_read_outbox_max_id_type_int' => 'Read outbox max ID', - 'object_channelFull_param_unread_count_type_int' => 'Unread count', - 'object_channelFull_param_chat_photo_type_Photo' => 'Chat photo', - 'object_channelFull_param_notify_settings_type_PeerNotifySettings' => 'Notify settings', - 'object_channelFull_param_exported_invite_type_ExportedChatInvite' => 'Exported invite', + 'object_channelFull' => 'Full info about a [channel/supergroup](https://core.telegram.org/api/channel)', + 'object_channelFull_param_can_view_participants_type_true' => 'Can we vew the participant list?', + 'object_channelFull_param_can_set_username_type_true' => 'Can we set the channel\'s username?', + 'object_channelFull_param_can_set_stickers_type_true' => 'Can we [associate](../methods/channels.setStickers.md) a stickerpack to the supergroup?', + 'object_channelFull_param_hidden_prehistory_type_true' => 'Is the history before we joined hidden to us?', + 'object_channelFull_param_id_type_int' => 'ID of the channel', + 'object_channelFull_param_about_type_string' => 'Info about the channel', + 'object_channelFull_param_participants_count_type_int' => 'Number of participants of the channel', + 'object_channelFull_param_admins_count_type_int' => 'Number of channel admins', + 'object_channelFull_param_kicked_count_type_int' => 'Number of users [kicked](https://core.telegram.org/api/rights) from the channel', + 'object_channelFull_param_banned_count_type_int' => 'Number of users [banned](https://core.telegram.org/api/rights) from the channel', + 'object_channelFull_param_read_inbox_max_id_type_int' => 'Position up to which all incoming messages are read.', + 'object_channelFull_param_read_outbox_max_id_type_int' => 'Position up to which all outgoing messages are read.', + 'object_channelFull_param_unread_count_type_int' => 'Count of unread messages', + 'object_channelFull_param_chat_photo_type_Photo' => 'Channel picture', + 'object_channelFull_param_notify_settings_type_PeerNotifySettings' => 'Notification settings', + 'object_channelFull_param_exported_invite_type_ExportedChatInvite' => 'Invite link', 'object_channelFull_param_bot_info_type_Vector t' => 'Bot info', - 'object_channelFull_param_migrated_from_chat_id_type_int' => 'Migrated from chat ID', - 'object_channelFull_param_migrated_from_max_id_type_int' => 'Migrated from max ID', - 'object_channelFull_param_pinned_msg_id_type_int' => 'Pinned msg ID', - 'object_channelFull_param_stickerset_type_StickerSet' => 'Stickerset', - 'object_channelFull_param_available_min_id_type_int' => 'Available min ID', - 'object_chatParticipant' => 'Chat participant', - 'object_chatParticipant_param_user_id_type_int' => 'User ID', - 'object_chatParticipant_param_inviter_id_type_int' => 'Inviter ID', - 'object_chatParticipant_param_date_type_int' => 'Date', - 'object_chatParticipantCreator' => 'Chat participant creator', - 'object_chatParticipantCreator_param_user_id_type_int' => 'User ID', - 'object_chatParticipantAdmin' => 'Chat participant admin', - 'object_chatParticipantAdmin_param_user_id_type_int' => 'User ID', - 'object_chatParticipantAdmin_param_inviter_id_type_int' => 'Inviter ID', - 'object_chatParticipantAdmin_param_date_type_int' => 'Date', - 'object_chatParticipantsForbidden' => 'Chat participants forbidden', - 'object_chatParticipantsForbidden_param_chat_id_type_int' => 'Chat ID', - 'object_chatParticipantsForbidden_param_self_participant_type_ChatParticipant' => 'Self participant', - 'object_chatParticipants' => 'Chat participants', - 'object_chatParticipants_param_chat_id_type_int' => 'Chat ID', + 'object_channelFull_param_migrated_from_chat_id_type_int' => 'The chat ID from which this group was [migrated](https://core.telegram.org/api/channel)', + 'object_channelFull_param_migrated_from_max_id_type_int' => 'The message ID in the original chat at which this group was [migrated](https://core.telegram.org/api/channel)', + 'object_channelFull_param_pinned_msg_id_type_int' => 'Message ID of the pinned message', + 'object_channelFull_param_stickerset_type_StickerSet' => 'Associated stickerset', + 'object_channelFull_param_available_min_id_type_int' => 'Identifier of a maximum unavailable message in a channel due to hidden history.', + 'object_chatParticipant' => 'Group member.', + 'object_chatParticipant_param_user_id_type_int' => 'Member user ID', + 'object_chatParticipant_param_inviter_id_type_int' => 'ID of the user that added the member to the group', + 'object_chatParticipant_param_date_type_int' => 'Date added to the group', + 'object_chatParticipantCreator' => 'Represents the creator of the group', + 'object_chatParticipantCreator_param_user_id_type_int' => 'ID of the user that created the group', + 'object_chatParticipantAdmin' => 'Chat admin', + 'object_chatParticipantAdmin_param_user_id_type_int' => 'ID of a group member that is admin', + 'object_chatParticipantAdmin_param_inviter_id_type_int' => 'ID of the user that added the member to the group', + 'object_chatParticipantAdmin_param_date_type_int' => 'Date when the user was added', + 'object_chatParticipantsForbidden' => 'Info on members is unavailable', + 'object_chatParticipantsForbidden_param_chat_id_type_int' => 'Group ID', + 'object_chatParticipantsForbidden_param_self_participant_type_ChatParticipant' => 'Info about the group membership of the current user', + 'object_chatParticipants' => 'Group members.', + 'object_chatParticipants_param_chat_id_type_int' => 'Group identifier', 'object_chatParticipants_param_participants_type_Vector t' => 'Participants', - 'object_chatParticipants_param_version_type_int' => 'Version', - 'object_chatPhotoEmpty' => 'Empty chat photo', - 'object_chatPhoto' => 'Chat photo', - 'object_chatPhoto_param_photo_small_type_FileLocation' => 'Photo small', - 'object_chatPhoto_param_photo_big_type_FileLocation' => 'Photo big', - 'object_messageEmpty' => 'Empty message', - 'object_messageEmpty_param_id_type_int' => 'ID', - 'object_message' => 'Message', - 'object_message_param_out_type_true' => 'Out?', - 'object_message_param_mentioned_type_true' => 'Mentioned?', - 'object_message_param_media_unread_type_true' => 'Media unread?', - 'object_message_param_silent_type_true' => 'Silent?', - 'object_message_param_post_type_true' => 'Post?', - 'object_message_param_id_type_int' => 'ID', - 'object_message_param_from_id_type_int' => 'From ID', - 'object_message_param_to_id_type_Peer' => 'To ID', - 'object_message_param_fwd_from_type_MessageFwdHeader' => 'Forwarded from', - 'object_message_param_via_bot_id_type_int' => 'Via bot ID', - 'object_message_param_reply_to_msg_id_type_int' => 'Reply to msg ID', - 'object_message_param_date_type_int' => 'Date', - 'object_message_param_message_type_string' => 'Message', - 'object_message_param_media_type_MessageMedia' => 'Media', - 'object_message_param_reply_markup_type_ReplyMarkup' => 'Reply markup', + 'object_chatParticipants_param_version_type_int' => 'Group version number', + 'object_chatPhotoEmpty' => 'Group photo is not set.', + 'object_chatPhoto' => 'Group profile photo.', + 'object_chatPhoto_param_photo_small_type_FileLocation' => 'Location of the file corresponding to the small thumbnail for group profile photo', + 'object_chatPhoto_param_photo_big_type_FileLocation' => 'Location of the file corresponding to the small thumbnail for group profile photo', + 'object_messageEmpty' => 'Empty constructor, non-existent message.', + 'object_messageEmpty_param_id_type_int' => 'Message identifier', + 'object_message' => 'A message', + 'object_message_param_out_type_true' => 'Is this an outgoing message', + 'object_message_param_mentioned_type_true' => 'Whether we were mentioned in this message', + 'object_message_param_media_unread_type_true' => 'Whether there are unread media attachments in this message', + 'object_message_param_silent_type_true' => 'Whether this is a silent message (no notification triggered)', + 'object_message_param_post_type_true' => 'Whether this is a channel post', + 'object_message_param_id_type_int' => 'ID of the message', + 'object_message_param_from_id_type_int' => 'ID of the sender of the message', + 'object_message_param_to_id_type_Peer' => 'ID of the chat were the message was sent', + 'object_message_param_fwd_from_type_MessageFwdHeader' => 'Info about forwarded messages', + 'object_message_param_via_bot_id_type_int' => 'ID of the inline bot that generated the message', + 'object_message_param_reply_to_msg_id_type_int' => 'ID of the message this message replies to', + 'object_message_param_date_type_int' => 'Date of the message', + 'object_message_param_message_type_string' => 'The message', + 'object_message_param_media_type_MessageMedia' => 'Media attachment', + 'object_message_param_reply_markup_type_ReplyMarkup' => 'Reply markup (bot/inline keyboards)', 'object_message_param_entities_type_Vector t' => 'Entities', - 'object_message_param_views_type_int' => 'Views', - 'object_message_param_edit_date_type_int' => 'Edit date', - 'object_message_param_post_author_type_string' => 'Post author', - 'object_message_param_grouped_id_type_long' => 'Grouped ID', - 'object_messageService' => 'Message service', - 'object_messageService_param_out_type_true' => 'Out?', - 'object_messageService_param_mentioned_type_true' => 'Mentioned?', - 'object_messageService_param_media_unread_type_true' => 'Media unread?', - 'object_messageService_param_silent_type_true' => 'Silent?', - 'object_messageService_param_post_type_true' => 'Post?', - 'object_messageService_param_id_type_int' => 'ID', - 'object_messageService_param_from_id_type_int' => 'From ID', - 'object_messageService_param_to_id_type_Peer' => 'To ID', - 'object_messageService_param_reply_to_msg_id_type_int' => 'Reply to msg ID', - 'object_messageService_param_date_type_int' => 'Date', - 'object_messageService_param_action_type_MessageAction' => 'Action', - 'object_messageMediaEmpty' => 'Empty message media', - 'object_messageMediaPhoto' => 'Message media photo', + 'object_message_param_views_type_int' => 'View count for channel posts', + 'object_message_param_edit_date_type_int' => 'Last edit date of this message', + 'object_message_param_post_author_type_string' => 'Name of the author of this message for channel posts (with signatures enabled)', + 'object_message_param_grouped_id_type_long' => 'Multiple media messages sent using [messages.sendMultiMedia](../methods/messages.sendMultiMedia.md) with the same grouped ID indicate an album', + 'object_messageService' => 'Indicates a service message', + 'object_messageService_param_out_type_true' => 'Whether the message is outgoing', + 'object_messageService_param_mentioned_type_true' => 'Whether we were mentioned in the message', + 'object_messageService_param_media_unread_type_true' => 'Whether the message contains unread media', + 'object_messageService_param_silent_type_true' => 'Whether the message is silent', + 'object_messageService_param_post_type_true' => 'Whether it\'s a channel post', + 'object_messageService_param_id_type_int' => 'Message ID', + 'object_messageService_param_from_id_type_int' => 'Id of te sender of the message', + 'object_messageService_param_to_id_type_Peer' => 'ID of the destination of the message', + 'object_messageService_param_reply_to_msg_id_type_int' => 'ID of the message this message replies to', + 'object_messageService_param_date_type_int' => 'Message date', + 'object_messageService_param_action_type_MessageAction' => 'Event connected with the service message', + 'object_messageMediaEmpty' => 'Empty constructor.', + 'object_messageMediaPhoto' => 'Attached photo.', 'object_messageMediaPhoto_param_photo_type_Photo' => 'Photo', - 'object_messageMediaPhoto_param_ttl_seconds_type_int' => 'Ttl seconds', - 'object_messageMediaGeo' => 'Message media geo', - 'object_messageMediaGeo_param_geo_type_GeoPoint' => 'Geo', - 'object_messageMediaContact' => 'Message media contact', + 'object_messageMediaPhoto_param_ttl_seconds_type_int' => 'Time to live in seconds of self-destructing photo', + 'object_messageMediaGeo' => 'Attached map.', + 'object_messageMediaGeo_param_geo_type_GeoPoint' => 'GeoPoint', + 'object_messageMediaContact' => 'Attached contact.', 'object_messageMediaContact_param_phone_number_type_string' => 'Phone number', - 'object_messageMediaContact_param_first_name_type_string' => 'First name', - 'object_messageMediaContact_param_last_name_type_string' => 'Last name', - 'object_messageMediaContact_param_user_id_type_int' => 'User ID', - 'object_messageMediaUnsupported' => 'Message media unsupported', - 'object_messageMediaDocument' => 'Message media document', - 'object_messageMediaDocument_param_document_type_Document' => 'Document', - 'object_messageMediaDocument_param_ttl_seconds_type_int' => 'Ttl seconds', - 'object_messageMediaWebPage' => 'Message media web page', - 'object_messageMediaWebPage_param_webpage_type_WebPage' => 'Webpage', - 'object_messageMediaVenue' => 'Message media venue', - 'object_messageMediaVenue_param_geo_type_GeoPoint' => 'Geo', - 'object_messageMediaVenue_param_title_type_string' => 'Title', + 'object_messageMediaContact_param_first_name_type_string' => 'Contact\'s first name', + 'object_messageMediaContact_param_last_name_type_string' => 'Contact\'s last name', + 'object_messageMediaContact_param_user_id_type_int' => 'User identifier or `0`, if the user with the given phone number is not registered', + 'object_messageMediaUnsupported' => 'Current version of the client does not support this media type.', + 'object_messageMediaDocument' => 'Document (video, audio, voice, sticker, any media type except photo)', + 'object_messageMediaDocument_param_document_type_Document' => 'Attached document', + 'object_messageMediaDocument_param_ttl_seconds_type_int' => 'Time to live of self-destructing document', + 'object_messageMediaWebPage' => 'Preview of webpage', + 'object_messageMediaWebPage_param_webpage_type_WebPage' => 'Webpage preview', + 'object_messageMediaVenue' => 'Venue', + 'object_messageMediaVenue_param_geo_type_GeoPoint' => 'Geolocation of venue', + 'object_messageMediaVenue_param_title_type_string' => 'Venue name', 'object_messageMediaVenue_param_address_type_string' => 'Address', - 'object_messageMediaVenue_param_provider_type_string' => 'Provider', - 'object_messageMediaVenue_param_venue_id_type_string' => 'Venue ID', - 'object_messageMediaVenue_param_venue_type_type_string' => 'Venue type', - 'object_messageMediaGame' => 'Message media game', + 'object_messageMediaVenue_param_provider_type_string' => 'Venue provider: currently only "foursquare" needs to be supported', + 'object_messageMediaVenue_param_venue_id_type_string' => 'Venue ID in the provider\'s database', + 'object_messageMediaVenue_param_venue_type_type_string' => 'Venue type in the provider\'s database', + 'object_messageMediaGame' => 'Telegram game', 'object_messageMediaGame_param_game_type_Game' => 'Game', - 'object_messageMediaInvoice' => 'Message media invoice', - 'object_messageMediaInvoice_param_shipping_address_requested_type_true' => 'Shipping address requested?', - 'object_messageMediaInvoice_param_test_type_true' => 'Test?', - 'object_messageMediaInvoice_param_title_type_string' => 'Title', - 'object_messageMediaInvoice_param_description_type_string' => 'Description', - 'object_messageMediaInvoice_param_photo_type_WebDocument' => 'Photo', - 'object_messageMediaInvoice_param_receipt_msg_id_type_int' => 'Receipt msg ID', - 'object_messageMediaInvoice_param_currency_type_string' => 'Currency', - 'object_messageMediaInvoice_param_total_amount_type_long' => 'Total amount', - 'object_messageMediaInvoice_param_start_param_type_string' => 'Start param', - 'object_messageMediaGeoLive' => 'Message media geo live', - 'object_messageMediaGeoLive_param_geo_type_GeoPoint' => 'Geo', - 'object_messageMediaGeoLive_param_period_type_int' => 'Period', - 'object_messageActionEmpty' => 'Empty message action', - 'object_messageActionChatCreate' => 'Message action chat create', - 'object_messageActionChatCreate_param_title_type_string' => 'Title', + 'object_messageMediaInvoice' => 'Invoice', + 'object_messageMediaInvoice_param_shipping_address_requested_type_true' => 'Whether the shipping address was requested', + 'object_messageMediaInvoice_param_test_type_true' => 'Whether this is an example invoice', + 'object_messageMediaInvoice_param_title_type_string' => 'Product name, 1-32 characters', + 'object_messageMediaInvoice_param_description_type_string' => 'Product description, 1-255 characters', + 'object_messageMediaInvoice_param_photo_type_WebDocument' => 'URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. People like it better when they see what they are paying for.', + 'object_messageMediaInvoice_param_receipt_msg_id_type_int' => 'Message ID of receipt: if set, clients should change the text of the first [keyboardButtonBuy](../constructors/keyboardButtonBuy.md) button always attached to the [message](../constructors/message.md) to a localized version of the word `Receipt`', + 'object_messageMediaInvoice_param_currency_type_string' => 'Three-letter ISO 4217 [currency](https://core.telegram.org/bots/payments#supported-currencies) code', + 'object_messageMediaInvoice_param_total_amount_type_long' => 'Total price in the smallest units of the currency (integer, not float/double). For example, for a price of `US$ 1.45` pass `amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).', + 'object_messageMediaInvoice_param_start_param_type_string' => 'Unique bot deep-linking parameter that can be used to generate this invoice', + 'object_messageMediaGeoLive' => 'Indicates a live geolocation', + 'object_messageMediaGeoLive_param_geo_type_GeoPoint' => 'Geolocation', + 'object_messageMediaGeoLive_param_period_type_int' => 'Validity period of provided geolocation', + 'object_messageActionEmpty' => 'Empty constructor.', + 'object_messageActionChatCreate' => 'Group created', + 'object_messageActionChatCreate_param_title_type_string' => 'Group name', 'object_messageActionChatCreate_param_users_type_Vector t' => 'Users', - 'object_messageActionChatEditTitle' => 'Message action chat edit title', - 'object_messageActionChatEditTitle_param_title_type_string' => 'Title', - 'object_messageActionChatEditPhoto' => 'Message action chat edit photo', - 'object_messageActionChatEditPhoto_param_photo_type_Photo' => 'Photo', - 'object_messageActionChatDeletePhoto' => 'Message action chat delete photo', - 'object_messageActionChatAddUser' => 'Message action chat add user', + 'object_messageActionChatEditTitle' => 'Group name changed.', + 'object_messageActionChatEditTitle_param_title_type_string' => 'New group name', + 'object_messageActionChatEditPhoto' => 'Group profile changed', + 'object_messageActionChatEditPhoto_param_photo_type_Photo' => 'New group pofile photo', + 'object_messageActionChatDeletePhoto' => 'Group profile photo removed.', + 'object_messageActionChatAddUser' => 'New member in the group', 'object_messageActionChatAddUser_param_users_type_Vector t' => 'Users', - 'object_messageActionChatDeleteUser' => 'Message action chat delete user', - 'object_messageActionChatDeleteUser_param_user_id_type_int' => 'User ID', - 'object_messageActionChatJoinedByLink' => 'Message action chat joined by link', - 'object_messageActionChatJoinedByLink_param_inviter_id_type_int' => 'Inviter ID', - 'object_messageActionChannelCreate' => 'Message action channel create', - 'object_messageActionChannelCreate_param_title_type_string' => 'Title', - 'object_messageActionChatMigrateTo' => 'Message action chat migrate to', - 'object_messageActionChatMigrateTo_param_channel_id_type_int' => 'Channel ID', - 'object_messageActionChannelMigrateFrom' => 'Message action channel migrate from', - 'object_messageActionChannelMigrateFrom_param_title_type_string' => 'Title', - 'object_messageActionChannelMigrateFrom_param_chat_id_type_int' => 'Chat ID', - 'object_messageActionPinMessage' => 'Message action pin message', - 'object_messageActionHistoryClear' => 'Message action history clear', - 'object_messageActionGameScore' => 'Message action game score', + 'object_messageActionChatDeleteUser' => 'User left the group.', + 'object_messageActionChatDeleteUser_param_user_id_type_int' => 'Leaving user ID', + 'object_messageActionChatJoinedByLink' => 'A user joined the chat via an invite link', + 'object_messageActionChatJoinedByLink_param_inviter_id_type_int' => 'ID of the user that created the invite link', + 'object_messageActionChannelCreate' => 'The channel was created', + 'object_messageActionChannelCreate_param_title_type_string' => 'Original channel/supergroup title', + 'object_messageActionChatMigrateTo' => 'Indicates the chat was [migrated](https://core.telegram.org/api/channel) to the specified supergroup', + 'object_messageActionChatMigrateTo_param_channel_id_type_int' => 'The supergroup it was migrated to', + 'object_messageActionChannelMigrateFrom' => 'Indicates the channel was [migrated](https://core.telegram.org/api/channel) from the specified chat', + 'object_messageActionChannelMigrateFrom_param_title_type_string' => 'The old chat tite', + 'object_messageActionChannelMigrateFrom_param_chat_id_type_int' => 'The old chat ID', + 'object_messageActionPinMessage' => 'A message was pinned', + 'object_messageActionHistoryClear' => 'Chat history was cleared', + 'object_messageActionGameScore' => 'Someone scored in a game', 'object_messageActionGameScore_param_game_id_type_long' => 'Game ID', 'object_messageActionGameScore_param_score_type_int' => 'Score', - 'object_messageActionPaymentSentMe' => 'Message action payment sent me', - 'object_messageActionPaymentSentMe_param_currency_type_string' => 'Currency', - 'object_messageActionPaymentSentMe_param_total_amount_type_long' => 'Total amount', - 'object_messageActionPaymentSentMe_param_payload_type_bytes' => 'Payload', - 'object_messageActionPaymentSentMe_param_info_type_PaymentRequestedInfo' => 'Info', - 'object_messageActionPaymentSentMe_param_shipping_option_id_type_string' => 'Shipping option ID', - 'object_messageActionPaymentSentMe_param_charge_type_PaymentCharge' => 'Charge', - 'object_messageActionPaymentSent' => 'Message action payment sent', - 'object_messageActionPaymentSent_param_currency_type_string' => 'Currency', - 'object_messageActionPaymentSent_param_total_amount_type_long' => 'Total amount', - 'object_messageActionPhoneCall' => 'Message action phone call', + 'object_messageActionPaymentSentMe' => 'A user just sent a payment to me (a bot)', + 'object_messageActionPaymentSentMe_param_currency_type_string' => 'Three-letter ISO 4217 [currency](https://core.telegram.org/bots/payments#supported-currencies) code', + 'object_messageActionPaymentSentMe_param_total_amount_type_long' => 'Price of the product in the smallest units of the currency (integer, not float/double). For example, for a price of `US$ 1.45` pass `amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).', + 'object_messageActionPaymentSentMe_param_payload_type_bytes' => 'Bot specified invoice payload', + 'object_messageActionPaymentSentMe_param_info_type_PaymentRequestedInfo' => 'Order info provided by the user', + 'object_messageActionPaymentSentMe_param_shipping_option_id_type_string' => 'Identifier of the shipping option chosen by the user', + 'object_messageActionPaymentSentMe_param_charge_type_PaymentCharge' => 'Provider payment identifier', + 'object_messageActionPaymentSent' => 'A payment was sent', + 'object_messageActionPaymentSent_param_currency_type_string' => 'Three-letter ISO 4217 [currency](https://core.telegram.org/bots/payments#supported-currencies) code', + 'object_messageActionPaymentSent_param_total_amount_type_long' => 'Price of the product in the smallest units of the currency (integer, not float/double). For example, for a price of `US$ 1.45` pass `amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).', + 'object_messageActionPhoneCall' => 'A phone call', 'object_messageActionPhoneCall_param_call_id_type_long' => 'Call ID', - 'object_messageActionPhoneCall_param_reason_type_PhoneCallDiscardReason' => 'Reason', - 'object_messageActionPhoneCall_param_duration_type_int' => 'Duration', - 'object_messageActionScreenshotTaken' => 'Message action screenshot taken', - 'object_messageActionCustomAction' => 'Message action custom action', - 'object_messageActionCustomAction_param_message_type_string' => 'Message', - 'object_dialog' => 'Dialog', - 'object_dialog_param_pinned_type_true' => 'Pinned?', - 'object_dialog_param_peer_type_Peer' => 'Peer', - 'object_dialog_param_top_message_type_int' => 'Top message', - 'object_dialog_param_read_inbox_max_id_type_int' => 'Read inbox max ID', - 'object_dialog_param_read_outbox_max_id_type_int' => 'Read outbox max ID', - 'object_dialog_param_unread_count_type_int' => 'Unread count', - 'object_dialog_param_unread_mentions_count_type_int' => 'Unread mentions count', - 'object_dialog_param_notify_settings_type_PeerNotifySettings' => 'Notify settings', - 'object_dialog_param_pts_type_int' => 'Pts', - 'object_dialog_param_draft_type_DraftMessage' => 'Draft', - 'object_photoEmpty' => 'Empty photo', - 'object_photoEmpty_param_id_type_long' => 'ID', + 'object_messageActionPhoneCall_param_reason_type_PhoneCallDiscardReason' => 'If the call has ended, the reason why it ended', + 'object_messageActionPhoneCall_param_duration_type_int' => 'Duration of the call in seconds', + 'object_messageActionScreenshotTaken' => 'A screenshot of the chat was taken', + 'object_messageActionCustomAction' => 'Custom action (most likely not supported by the current layer, an upgrade might be needed)', + 'object_messageActionCustomAction_param_message_type_string' => 'Action message', + 'object_dialog' => 'Chat', + 'object_dialog_param_pinned_type_true' => 'Is the dialog pinned', + 'object_dialog_param_peer_type_Peer' => 'The chat', + 'object_dialog_param_top_message_type_int' => 'The latest message ID', + 'object_dialog_param_read_inbox_max_id_type_int' => 'Position up to which all incoming messages are read.', + 'object_dialog_param_read_outbox_max_id_type_int' => 'Position up to which all outgoing messages are read.', + 'object_dialog_param_unread_count_type_int' => 'Number of unread messages', + 'object_dialog_param_unread_mentions_count_type_int' => 'Number of unread mentions', + 'object_dialog_param_notify_settings_type_PeerNotifySettings' => 'Notification settings', + 'object_dialog_param_pts_type_int' => '[PTS](https://core.telegram.org/api/updates)', + 'object_dialog_param_draft_type_DraftMessage' => 'Message draft', + 'object_photoEmpty' => 'Empty constructor, non-existent photo', + 'object_photoEmpty_param_id_type_long' => 'Photo identifier', 'object_photo' => 'Photo', - 'object_photo_param_has_stickers_type_true' => 'Has stickers?', + 'object_photo_param_has_stickers_type_true' => 'Whether the photo has mask stickers attached to it', 'object_photo_param_id_type_long' => 'ID', 'object_photo_param_access_hash_type_long' => 'Access hash', - 'object_photo_param_date_type_int' => 'Date', + 'object_photo_param_date_type_int' => 'Date of upload', 'object_photo_param_sizes_type_Vector t' => 'Sizes', - 'object_photoSizeEmpty' => 'Empty photo size', - 'object_photoSizeEmpty_param_type_type_string' => 'Type', - 'object_photoSize' => 'Photo size', - 'object_photoSize_param_type_type_string' => 'Type', - 'object_photoSize_param_location_type_FileLocation' => 'Location', - 'object_photoSize_param_w_type_int' => 'Width', - 'object_photoSize_param_h_type_int' => 'Height', - 'object_photoSize_param_size_type_int' => 'Size', - 'object_photoCachedSize' => 'Photo cached size', - 'object_photoCachedSize_param_type_type_string' => 'Type', - 'object_photoCachedSize_param_location_type_FileLocation' => 'Location', - 'object_photoCachedSize_param_w_type_int' => 'Width', - 'object_photoCachedSize_param_h_type_int' => 'Height', - 'object_photoCachedSize_param_bytes_type_bytes' => 'Bytes', - 'object_geoPointEmpty' => 'Empty geo point', - 'object_geoPoint' => 'Geo point', - 'object_geoPoint_param_long_type_double' => 'Long', - 'object_geoPoint_param_lat_type_double' => 'Lat', + 'object_photoSizeEmpty' => 'Empty constructor. Image with this thumbnail is unavailable.', + 'object_photoSizeEmpty_param_type_type_string' => 'Thumbnail type (see. [photoSize](../constructors/photoSize.md))', + 'object_photoSize' => 'Image description.', + 'object_photoSize_param_type_type_string' => 'Thumbnail type', + 'object_photoSize_param_location_type_FileLocation' => 'File location', + 'object_photoSize_param_w_type_int' => 'Image width', + 'object_photoSize_param_h_type_int' => 'Image height', + 'object_photoSize_param_size_type_int' => 'File size', + 'object_photoCachedSize' => 'Description of an image and its content.', + 'object_photoCachedSize_param_type_type_string' => 'Thumbnail type', + 'object_photoCachedSize_param_location_type_FileLocation' => 'File location', + 'object_photoCachedSize_param_w_type_int' => 'Image width', + 'object_photoCachedSize_param_h_type_int' => 'Image height', + 'object_photoCachedSize_param_bytes_type_bytes' => 'Binary data, file content', + 'object_geoPointEmpty' => 'Empty constructor.', + 'object_geoPoint' => 'GeoPoint.', + 'object_geoPoint_param_long_type_double' => 'Longtitude', + 'object_geoPoint_param_lat_type_double' => 'Latitude', 'object_auth.checkedPhone' => 'Checked phone', 'object_auth.checkedPhone_param_phone_registered_type_Bool' => 'Phone registered?', - 'object_auth.sentCode' => 'Sent code', + 'object_auth.sentCode' => 'Contains info about a sent verification code.', 'object_auth.sentCode_param_phone_registered_type_true' => 'Phone registered?', - 'object_auth.sentCode_param_type_type_auth.SentCodeType' => 'Type', - 'object_auth.sentCode_param_phone_code_hash_type_string' => 'Phone code hash', - 'object_auth.sentCode_param_next_type_type_auth.CodeType' => 'Next type', - 'object_auth.sentCode_param_timeout_type_int' => 'Timeout', - 'object_auth.authorization' => 'Authorization', - 'object_auth.authorization_param_tmp_sessions_type_int' => 'Temporary sessions', - 'object_auth.authorization_param_user_type_User' => 'User', - 'object_auth.exportedAuthorization' => 'Exported authorization', - 'object_auth.exportedAuthorization_param_id_type_int' => 'ID', - 'object_auth.exportedAuthorization_param_bytes_type_bytes' => 'Bytes', - 'object_inputNotifyPeer' => 'Notify peer', - 'object_inputNotifyPeer_param_peer_type_InputPeer' => 'Peer', - 'object_inputNotifyUsers' => 'Notify users', - 'object_inputNotifyChats' => 'Notify chats', + 'object_auth.sentCode_param_type_type_auth.SentCodeType' => 'Phone code type', + 'object_auth.sentCode_param_phone_code_hash_type_string' => 'Phone code hash, to be stored and later re-used with [auth.signIn](../methods/auth.signIn.md)', + 'object_auth.sentCode_param_next_type_type_auth.CodeType' => 'Phone code type that will be sent next, if the phone code is not received within `timeout` seconds: to send it use [auth.resendCode](../methods/auth.resendCode.md)', + 'object_auth.sentCode_param_timeout_type_int' => 'Timeout for reception of the phone code', + 'object_auth.authorization' => 'Contains user authorization info.', + 'object_auth.authorization_param_tmp_sessions_type_int' => 'Temporary [passport](https://core.telegram.org/passport) sessions', + 'object_auth.authorization_param_user_type_User' => 'Info on authorized user', + 'object_auth.exportedAuthorization' => 'Data for copying of authorization between data centres.', + 'object_auth.exportedAuthorization_param_id_type_int' => 'current user identifier', + 'object_auth.exportedAuthorization_param_bytes_type_bytes' => 'authorizes key', + 'object_inputNotifyPeer' => 'Notifications generated by a certain user or group.', + 'object_inputNotifyPeer_param_peer_type_InputPeer' => 'User or group', + 'object_inputNotifyUsers' => 'Notifications generated by all users.', + 'object_inputNotifyChats' => 'Notifications generated by all groups.', 'object_inputNotifyAll' => 'Notify all', 'object_inputPeerNotifyEventsEmpty' => 'Empty input peer notify events', 'object_inputPeerNotifyEventsAll' => 'Peer notify events all', - 'object_inputPeerNotifySettings' => 'Peer notify settings', + 'object_inputPeerNotifySettings' => 'Notification settings.', 'object_inputPeerNotifySettings_param_show_previews_type_true' => 'Show previews?', 'object_inputPeerNotifySettings_param_silent_type_true' => 'Silent?', - 'object_inputPeerNotifySettings_param_mute_until_type_int' => 'Mute until', - 'object_inputPeerNotifySettings_param_sound_type_string' => 'Sound', + 'object_inputPeerNotifySettings_param_mute_until_type_int' => 'Date until which all notifications shall be switched off', + 'object_inputPeerNotifySettings_param_sound_type_string' => 'Name of an audio file for notification', 'object_peerNotifyEventsEmpty' => 'Empty peer notify events', 'object_peerNotifyEventsAll' => 'Peer notify events all', 'object_peerNotifySettingsEmpty' => 'Empty peer notify settings', - 'object_peerNotifySettings' => 'Peer notify settings', + 'object_peerNotifySettings' => 'Notification settings.', 'object_peerNotifySettings_param_show_previews_type_true' => 'Show previews?', 'object_peerNotifySettings_param_silent_type_true' => 'Silent?', - 'object_peerNotifySettings_param_mute_until_type_int' => 'Mute until', - 'object_peerNotifySettings_param_sound_type_string' => 'Sound', + 'object_peerNotifySettings_param_mute_until_type_int' => 'Mute all notifications until this date', + 'object_peerNotifySettings_param_sound_type_string' => 'Audio file name for notifications', 'object_peerSettings' => 'Peer settings', - 'object_peerSettings_param_report_spam_type_true' => 'Report spam?', - 'object_wallPaper' => 'Wall paper', + 'object_peerSettings_param_report_spam_type_true' => 'Whether we can still report the user for spam', + 'object_wallPaper' => 'Wallpaper settings.', 'object_wallPaper_param_id_type_int' => 'ID', 'object_wallPaper_param_title_type_string' => 'Title', 'object_wallPaper_param_sizes_type_Vector t' => 'Sizes', @@ -1883,142 +1889,142 @@ class Lang 'object_wallPaperSolid_param_title_type_string' => 'Title', 'object_wallPaperSolid_param_bg_color_type_int' => 'Bg color', 'object_wallPaperSolid_param_color_type_int' => 'Color', - 'object_inputReportReasonSpam' => 'Report reason spam', - 'object_inputReportReasonViolence' => 'Report reason violence', - 'object_inputReportReasonPornography' => 'Report reason pornography', - 'object_inputReportReasonOther' => 'Report reason other', - 'object_inputReportReasonOther_param_text_type_string' => 'Text', - 'object_userFull' => 'User full', - 'object_userFull_param_blocked_type_true' => 'Blocked?', - 'object_userFull_param_phone_calls_available_type_true' => 'Phone calls available?', - 'object_userFull_param_phone_calls_private_type_true' => 'Phone calls private?', - 'object_userFull_param_user_type_User' => 'User', - 'object_userFull_param_about_type_string' => 'About', + 'object_inputReportReasonSpam' => 'Report for spam', + 'object_inputReportReasonViolence' => 'Report for violence', + 'object_inputReportReasonPornography' => 'Report for pornography', + 'object_inputReportReasonOther' => 'Other', + 'object_inputReportReasonOther_param_text_type_string' => 'Other report reason', + 'object_userFull' => 'Extended user info', + 'object_userFull_param_blocked_type_true' => 'Whether you have blocked this user', + 'object_userFull_param_phone_calls_available_type_true' => 'Whether this user can make VoIP calls', + 'object_userFull_param_phone_calls_private_type_true' => 'Whether this user\'s privacy settings allow you to call him', + 'object_userFull_param_user_type_User' => 'Remaining user info', + 'object_userFull_param_about_type_string' => 'Bio of the user', 'object_userFull_param_link_type_contacts.Link' => 'Link', 'object_userFull_param_profile_photo_type_Photo' => 'Profile photo', - 'object_userFull_param_notify_settings_type_PeerNotifySettings' => 'Notify settings', - 'object_userFull_param_bot_info_type_BotInfo' => 'Bot info', - 'object_userFull_param_common_chats_count_type_int' => 'Common chats count', - 'object_contact' => 'Contact', - 'object_contact_param_user_id_type_int' => 'User ID', - 'object_contact_param_mutual_type_Bool' => 'Mutual?', - 'object_importedContact' => 'Imported contact', - 'object_importedContact_param_user_id_type_int' => 'User ID', - 'object_importedContact_param_client_id_type_long' => 'Client ID', - 'object_contactBlocked' => 'Contact blocked', - 'object_contactBlocked_param_user_id_type_int' => 'User ID', - 'object_contactBlocked_param_date_type_int' => 'Date', - 'object_contactStatus' => 'Contact status', - 'object_contactStatus_param_user_id_type_int' => 'User ID', - 'object_contactStatus_param_status_type_UserStatus' => 'Status', + 'object_userFull_param_notify_settings_type_PeerNotifySettings' => 'Notification settings', + 'object_userFull_param_bot_info_type_BotInfo' => 'For bots, info about the bot (bot commands, etc)', + 'object_userFull_param_common_chats_count_type_int' => 'Chats in common with this user', + 'object_contact' => 'A contact of the current user that is registered in the system.', + 'object_contact_param_user_id_type_int' => 'User identifier', + 'object_contact_param_mutual_type_Bool' => 'Current user is in the user\'s contact list', + 'object_importedContact' => 'Successfully imported contact.', + 'object_importedContact_param_user_id_type_int' => 'User identifier', + 'object_importedContact_param_client_id_type_long' => 'The contact\'s client identifier (passed to one of the [InputContact](../types/InputContact.md) constructors)', + 'object_contactBlocked' => 'A blocked user.', + 'object_contactBlocked_param_user_id_type_int' => 'User identifier', + 'object_contactBlocked_param_date_type_int' => 'Date blacklisted', + 'object_contactStatus' => 'Contact status: online / offline.', + 'object_contactStatus_param_user_id_type_int' => 'User identifier', + 'object_contactStatus_param_status_type_UserStatus' => 'Online status', 'object_contacts.link' => 'Link', 'object_contacts.link_param_my_link_type_ContactLink' => 'My link', 'object_contacts.link_param_foreign_link_type_ContactLink' => 'Foreign link', 'object_contacts.link_param_user_type_User' => 'User', - 'object_contacts.contactsNotModified' => 'Contacts not modified', - 'object_contacts.contacts' => 'Contacts', + 'object_contacts.contactsNotModified' => 'Contact list on the server is the same as the list on the client.', + 'object_contacts.contacts' => 'The current user\'s contact list and info on users.', 'object_contacts.contacts_param_contacts_type_Vector t' => 'Contacts', - 'object_contacts.contacts_param_saved_count_type_int' => 'Saved count', + 'object_contacts.contacts_param_saved_count_type_int' => 'Number of contacts that were saved successfully', 'object_contacts.contacts_param_users_type_Vector t' => 'Users', - 'object_contacts.importedContacts' => 'Imported contacts', + 'object_contacts.importedContacts' => 'Info on succesfully imported contacts.', 'object_contacts.importedContacts_param_imported_type_Vector t' => 'Imported', 'object_contacts.importedContacts_param_popular_invites_type_Vector t' => 'Popular invites', 'object_contacts.importedContacts_param_retry_contacts_type_Vector t' => 'Retry importing contacts whose client IDs appear here', 'object_contacts.importedContacts_param_users_type_Vector t' => 'Users', - 'object_contacts.blocked' => 'Blocked', + 'object_contacts.blocked' => 'Full list of blocked users.', 'object_contacts.blocked_param_blocked_type_Vector t' => 'Blocked', 'object_contacts.blocked_param_users_type_Vector t' => 'Users', - 'object_contacts.blockedSlice' => 'Blocked slice', - 'object_contacts.blockedSlice_param_count_type_int' => 'Count', + 'object_contacts.blockedSlice' => 'Incomplete list of blocked users.', + 'object_contacts.blockedSlice_param_count_type_int' => 'Total number of elements in the list', 'object_contacts.blockedSlice_param_blocked_type_Vector t' => 'Blocked', 'object_contacts.blockedSlice_param_users_type_Vector t' => 'Users', - 'object_messages.dialogs' => 'Dialogs', + 'object_messages.dialogs' => 'Full list of chats with messages and auxiliary data.', 'object_messages.dialogs_param_dialogs_type_Vector t' => 'Dialogs', 'object_messages.dialogs_param_messages_type_Vector t' => 'Messages', 'object_messages.dialogs_param_chats_type_Vector t' => 'Chats', 'object_messages.dialogs_param_users_type_Vector t' => 'Users', - 'object_messages.dialogsSlice' => 'Dialogs slice', - 'object_messages.dialogsSlice_param_count_type_int' => 'Count', + 'object_messages.dialogsSlice' => 'Incomplete list of dialogs with messages and auxiliary data.', + 'object_messages.dialogsSlice_param_count_type_int' => 'Total number of dialogs', 'object_messages.dialogsSlice_param_dialogs_type_Vector t' => 'Dialogs', 'object_messages.dialogsSlice_param_messages_type_Vector t' => 'Messages', 'object_messages.dialogsSlice_param_chats_type_Vector t' => 'Chats', 'object_messages.dialogsSlice_param_users_type_Vector t' => 'Users', - 'object_messages.messages' => 'Messages', + 'object_messages.messages' => 'Full list of messages with auxilary data.', 'object_messages.messages_param_messages_type_Vector t' => 'Messages', 'object_messages.messages_param_chats_type_Vector t' => 'Chats', 'object_messages.messages_param_users_type_Vector t' => 'Users', - 'object_messages.messagesSlice' => 'Messages slice', - 'object_messages.messagesSlice_param_count_type_int' => 'Count', + 'object_messages.messagesSlice' => 'Incomplete list of messages and auxiliary data.', + 'object_messages.messagesSlice_param_count_type_int' => 'Total number of messages in the list', 'object_messages.messagesSlice_param_messages_type_Vector t' => 'Messages', 'object_messages.messagesSlice_param_chats_type_Vector t' => 'Chats', 'object_messages.messagesSlice_param_users_type_Vector t' => 'Users', 'object_messages.channelMessages' => 'Channel messages', - 'object_messages.channelMessages_param_pts_type_int' => 'Pts', - 'object_messages.channelMessages_param_count_type_int' => 'Count', + 'object_messages.channelMessages_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)', + 'object_messages.channelMessages_param_count_type_int' => 'Total number of results were found server-side (may not be all included here)', 'object_messages.channelMessages_param_messages_type_Vector t' => 'Messages', 'object_messages.channelMessages_param_chats_type_Vector t' => 'Chats', 'object_messages.channelMessages_param_users_type_Vector t' => 'Users', - 'object_messages.messagesNotModified' => 'Messages not modified', - 'object_messages.messagesNotModified_param_count_type_int' => 'Count', - 'object_messages.chats' => 'Chats', + 'object_messages.messagesNotModified' => 'No new messages matching the query were found', + 'object_messages.messagesNotModified_param_count_type_int' => 'Number of results found server-side by the given query', + 'object_messages.chats' => 'List of chats with auxiliary data.', 'object_messages.chats_param_chats_type_Vector t' => 'Chats', - 'object_messages.chatsSlice' => 'Chats slice', - 'object_messages.chatsSlice_param_count_type_int' => 'Count', + 'object_messages.chatsSlice' => 'Partial list of chats, more would have to be fetched with [pagination](https://core.telegram.org/api/offsets)', + 'object_messages.chatsSlice_param_count_type_int' => 'Total number of results that were found server-side (not all are included in `chats`)', 'object_messages.chatsSlice_param_chats_type_Vector t' => 'Chats', - 'object_messages.chatFull' => 'Chat full', - 'object_messages.chatFull_param_full_chat_type_ChatFull' => 'Full chat', + 'object_messages.chatFull' => 'Extended info on chat and auxiliary data.', + 'object_messages.chatFull_param_full_chat_type_ChatFull' => 'Extended info on a chat', 'object_messages.chatFull_param_chats_type_Vector t' => 'Chats', 'object_messages.chatFull_param_users_type_Vector t' => 'Users', - 'object_messages.affectedHistory' => 'Affected history', - 'object_messages.affectedHistory_param_pts_type_int' => 'Pts', - 'object_messages.affectedHistory_param_pts_count_type_int' => 'Pts count', - 'object_messages.affectedHistory_param_offset_type_int' => 'Offset', - 'object_inputMessagesFilterEmpty' => 'Empty input messages filter', - 'object_inputMessagesFilterPhotos' => 'Messages filter photos', - 'object_inputMessagesFilterVideo' => 'Messages filter video', - 'object_inputMessagesFilterPhotoVideo' => 'Messages filter photo video', - 'object_inputMessagesFilterDocument' => 'Messages filter document', - 'object_inputMessagesFilterUrl' => 'Messages filter URL', - 'object_inputMessagesFilterGif' => 'Messages filter gif', - 'object_inputMessagesFilterVoice' => 'Messages filter voice', - 'object_inputMessagesFilterMusic' => 'Messages filter music', - 'object_inputMessagesFilterChatPhotos' => 'Messages filter chat photos', - 'object_inputMessagesFilterPhoneCalls' => 'Messages filter phone calls', - 'object_inputMessagesFilterPhoneCalls_param_missed_type_true' => 'Missed?', - 'object_inputMessagesFilterRoundVoice' => 'Messages filter round voice', - 'object_inputMessagesFilterRoundVideo' => 'Messages filter round video', - 'object_inputMessagesFilterMyMentions' => 'Messages filter my mentions', - 'object_inputMessagesFilterGeo' => 'Messages filter geo', - 'object_inputMessagesFilterContacts' => 'Messages filter contacts', - 'object_updateNewMessage' => 'Update new message', + 'object_messages.affectedHistory' => 'Affected part of communication history with the user or in a chat.', + 'object_messages.affectedHistory_param_pts_type_int' => 'Number of events occured in a text box', + 'object_messages.affectedHistory_param_pts_count_type_int' => 'Number of affected events', + 'object_messages.affectedHistory_param_offset_type_int' => 'If a parameter contains positive value, it is necessary to repeat the method call using the given value; during the proceeding of all the history the value itself shall gradually decrease', + 'object_inputMessagesFilterEmpty' => 'Filter is absent.', + 'object_inputMessagesFilterPhotos' => 'Filter for messages containing photos.', + 'object_inputMessagesFilterVideo' => 'Filter for messages containing videos.', + 'object_inputMessagesFilterPhotoVideo' => 'Filter for messages containing photos or videos.', + 'object_inputMessagesFilterDocument' => 'Filter for messages containing documents.', + 'object_inputMessagesFilterUrl' => 'Return only messages containing URLs', + 'object_inputMessagesFilterGif' => 'Return only messages containing gifs', + 'object_inputMessagesFilterVoice' => 'Return only messages containing voice notes', + 'object_inputMessagesFilterMusic' => 'Return only messages containing audio files', + 'object_inputMessagesFilterChatPhotos' => 'Return only chat photo changes', + 'object_inputMessagesFilterPhoneCalls' => 'Return only phone calls', + 'object_inputMessagesFilterPhoneCalls_param_missed_type_true' => 'Return only missed phone calls', + 'object_inputMessagesFilterRoundVoice' => 'Return only round videos and voice notes', + 'object_inputMessagesFilterRoundVideo' => 'Return only round videos', + 'object_inputMessagesFilterMyMentions' => 'Return only messages where the current user was mentioned', + 'object_inputMessagesFilterGeo' => 'Return only messages containing geolocations', + 'object_inputMessagesFilterContacts' => 'Return only messages containing contacts', + 'object_updateNewMessage' => 'New message.', 'object_updateNewMessage_param_message_type_Message' => 'Message', - 'object_updateNewMessage_param_pts_type_int' => 'Pts', - 'object_updateNewMessage_param_pts_count_type_int' => 'Pts count', - 'object_updateMessageID' => 'Update message ID', - 'object_updateMessageID_param_id_type_int' => 'ID', - 'object_updateDeleteMessages' => 'Update delete messages', + 'object_updateNewMessage_param_pts_type_int' => 'New quantity of actions in a message box', + 'object_updateNewMessage_param_pts_count_type_int' => 'Number of generated events', + 'object_updateMessageID' => 'Sent message with **random\\_id** client identifier was assigned an identifier.', + 'object_updateMessageID_param_id_type_int' => '**id** identifier of a respective [Message](../types/Message.md)', + 'object_updateDeleteMessages' => 'Messages were deleted.', 'object_updateDeleteMessages_param_messages_type_Vector t' => 'Messages', - 'object_updateDeleteMessages_param_pts_type_int' => 'Pts', - 'object_updateDeleteMessages_param_pts_count_type_int' => 'Pts count', - 'object_updateUserTyping' => 'Update user typing', - 'object_updateUserTyping_param_user_id_type_int' => 'User ID', - 'object_updateUserTyping_param_action_type_SendMessageAction' => 'Action', - 'object_updateChatUserTyping' => 'Update chat user typing', - 'object_updateChatUserTyping_param_chat_id_type_int' => 'Chat ID', - 'object_updateChatUserTyping_param_user_id_type_int' => 'User ID', - 'object_updateChatUserTyping_param_action_type_SendMessageAction' => 'Action', - 'object_updateChatParticipants' => 'Update chat participants', - 'object_updateChatParticipants_param_participants_type_ChatParticipants' => 'Participants', - 'object_updateUserName' => 'Update user name', - 'object_updateUserName_param_user_id_type_int' => 'User ID', - 'object_updateUserName_param_first_name_type_string' => 'First name', - 'object_updateUserName_param_last_name_type_string' => 'Last name', - 'object_updateUserName_param_username_type_string' => 'Username', - 'object_updateUserPhoto' => 'Update user photo', - 'object_updateUserPhoto_param_user_id_type_int' => 'User ID', - 'object_updateUserPhoto_param_date_type_int' => 'Date', - 'object_updateUserPhoto_param_photo_type_UserProfilePhoto' => 'Photo', - 'object_updateUserPhoto_param_previous_type_Bool' => 'Previous?', + 'object_updateDeleteMessages_param_pts_type_int' => 'New quality of actions in a message box', + 'object_updateDeleteMessages_param_pts_count_type_int' => 'Number of generated [events](https://core.telegram.org/api/updates)', + 'object_updateUserTyping' => 'The user is preparing a message; typing, recording, uploading, etc. This update is valid for 6 seconds. If no repeated update received after 6 seconds, it should be considered that the user stopped doing whatever he\'s been doing.', + 'object_updateUserTyping_param_user_id_type_int' => 'User id', + 'object_updateUserTyping_param_action_type_SendMessageAction' => 'Action type
Param added in [Layer 17](https://core.telegram.org/api/layers#layer-17).', + 'object_updateChatUserTyping' => 'The user is preparing a message in a group; typing, recording, uploading, etc. This update is valid for 6 seconds. If no repeated update received after 6 seconds, it should be considered that the user stopped doing whatever he\'s been doing.', + 'object_updateChatUserTyping_param_chat_id_type_int' => 'Group id', + 'object_updateChatUserTyping_param_user_id_type_int' => 'User id', + 'object_updateChatUserTyping_param_action_type_SendMessageAction' => 'Type of action
Parameter added in [Layer 17](https://core.telegram.org/api/layers#layer-17).', + 'object_updateChatParticipants' => 'Composition of chat participants changed.', + 'object_updateChatParticipants_param_participants_type_ChatParticipants' => 'Updated chat participants', + 'object_updateUserName' => 'Changes the user\'s first name, last name and username.', + 'object_updateUserName_param_user_id_type_int' => 'User identifier', + 'object_updateUserName_param_first_name_type_string' => 'New first name. Corresponds to the new value of **real\\_first\\_name** field of the [userFull](../constructors/userFull.md) constructor.', + 'object_updateUserName_param_last_name_type_string' => 'New last name. Corresponds to the new value of **real\\_last\\_name** field of the [userFull](../constructors/userFull.md) constructor.', + 'object_updateUserName_param_username_type_string' => 'New username.
Parameter added in [Layer 18](https://core.telegram.org/api/layers#layer-18).', + 'object_updateUserPhoto' => 'Change of contact\'s profile photo.', + 'object_updateUserPhoto_param_user_id_type_int' => 'User identifier', + 'object_updateUserPhoto_param_date_type_int' => 'Date of photo update.
Parameter was added in [second layer](?layer=2).', + 'object_updateUserPhoto_param_photo_type_UserProfilePhoto' => 'New profile photo', + 'object_updateUserPhoto_param_previous_type_Bool' => '([boolTrue](../constructors/boolTrue.md)), if one of the previously used photos is set a profile photo.
Parameter was added in [second layer](?layer=2).', 'object_updateContactRegistered' => 'Update contact registered', 'object_updateContactRegistered_param_user_id_type_int' => 'User ID', 'object_updateContactRegistered_param_date_type_int' => 'Date', @@ -2026,733 +2032,741 @@ class Lang 'object_updateContactLink_param_user_id_type_int' => 'User ID', 'object_updateContactLink_param_my_link_type_ContactLink' => 'My link', 'object_updateContactLink_param_foreign_link_type_ContactLink' => 'Foreign link', - 'object_updateNewEncryptedMessage' => 'Update new encrypted message', + 'object_updateNewEncryptedMessage' => 'New encrypted message.', 'object_updateNewEncryptedMessage_param_message_type_EncryptedMessage' => 'Message', - 'object_updateNewEncryptedMessage_param_qts_type_int' => 'Qts', - 'object_updateEncryptedChatTyping' => 'Update encrypted chat typing', + 'object_updateNewEncryptedMessage_param_qts_type_int' => 'New **qts** value', + 'object_updateEncryptedChatTyping' => 'Interlocutor is typing a message in an encrypted chat. Update period is 6 second. If upon this time there is no repeated update, it shall be considered that the interlocutor stopped typing.', 'object_updateEncryptedChatTyping_param_chat_id_type_int' => 'Chat ID', - 'object_updateEncryption' => 'Update encryption', - 'object_updateEncryption_param_chat_type_EncryptedChat' => 'Chat', - 'object_updateEncryption_param_date_type_int' => 'Date', - 'object_updateEncryptedMessagesRead' => 'Update encrypted messages read', + 'object_updateEncryption' => 'Change of state in an encrypted chat.', + 'object_updateEncryption_param_chat_type_EncryptedChat' => 'Encrypted chat', + 'object_updateEncryption_param_date_type_int' => 'Date of change', + 'object_updateEncryptedMessagesRead' => 'Communication history in an encrypted chat was marked as read.', 'object_updateEncryptedMessagesRead_param_chat_id_type_int' => 'Chat ID', - 'object_updateEncryptedMessagesRead_param_max_date_type_int' => 'Max date', - 'object_updateEncryptedMessagesRead_param_date_type_int' => 'Date', - 'object_updateChatParticipantAdd' => 'Update chat participant add', - 'object_updateChatParticipantAdd_param_chat_id_type_int' => 'Chat ID', - 'object_updateChatParticipantAdd_param_user_id_type_int' => 'User ID', - 'object_updateChatParticipantAdd_param_inviter_id_type_int' => 'Inviter ID', - 'object_updateChatParticipantAdd_param_date_type_int' => 'Date', - 'object_updateChatParticipantAdd_param_version_type_int' => 'Version', - 'object_updateChatParticipantDelete' => 'Update chat participant delete', - 'object_updateChatParticipantDelete_param_chat_id_type_int' => 'Chat ID', - 'object_updateChatParticipantDelete_param_user_id_type_int' => 'User ID', - 'object_updateChatParticipantDelete_param_version_type_int' => 'Version', - 'object_updateDcOptions' => 'Update DC options', + 'object_updateEncryptedMessagesRead_param_max_date_type_int' => 'Maximum value of data for read messages', + 'object_updateEncryptedMessagesRead_param_date_type_int' => 'Time when messages were read', + 'object_updateChatParticipantAdd' => 'New group member.', + 'object_updateChatParticipantAdd_param_chat_id_type_int' => 'Group ID', + 'object_updateChatParticipantAdd_param_user_id_type_int' => 'ID of the new member', + 'object_updateChatParticipantAdd_param_inviter_id_type_int' => 'ID of the user, who added member to the group', + 'object_updateChatParticipantAdd_param_date_type_int' => 'When was the participant added', + 'object_updateChatParticipantAdd_param_version_type_int' => 'Chat version number', + 'object_updateChatParticipantDelete' => 'A member has left the group.', + 'object_updateChatParticipantDelete_param_chat_id_type_int' => 'Group ID', + 'object_updateChatParticipantDelete_param_user_id_type_int' => 'ID of the user', + 'object_updateChatParticipantDelete_param_version_type_int' => 'Used in basic groups to reorder updates and make sure that all of them was received.', + 'object_updateDcOptions' => 'Changes in the data center configuration options.', 'object_updateDcOptions_param_dc_options_type_Vector t' => 'DC options', - 'object_updateUserBlocked' => 'Update user blocked', - 'object_updateUserBlocked_param_user_id_type_int' => 'User ID', - 'object_updateUserBlocked_param_blocked_type_Bool' => 'Blocked?', - 'object_updateNotifySettings' => 'Update notify settings', - 'object_updateNotifySettings_param_peer_type_NotifyPeer' => 'Peer', - 'object_updateNotifySettings_param_notify_settings_type_PeerNotifySettings' => 'Notify settings', - 'object_updateServiceNotification' => 'Update service notification', - 'object_updateServiceNotification_param_popup_type_true' => 'Popup?', - 'object_updateServiceNotification_param_inbox_date_type_int' => 'Inbox date', - 'object_updateServiceNotification_param_type_type_string' => 'Type', - 'object_updateServiceNotification_param_message_type_string' => 'Message', - 'object_updateServiceNotification_param_media_type_MessageMedia' => 'Media', + 'object_updateUserBlocked' => 'User was added to the blacklist (method [contacts.block](../methods/contacts.block.md)) or removed from the blacklist (method [contacts.unblock](../methods/contacts.unblock.md)).', + 'object_updateUserBlocked_param_user_id_type_int' => 'User id', + 'object_updateUserBlocked_param_blocked_type_Bool' => '([boolTrue](../constructors/boolTrue.md)) if the the user is blocked', + 'object_updateNotifySettings' => 'Changes in notification settings.', + 'object_updateNotifySettings_param_peer_type_NotifyPeer' => 'Nofication source', + 'object_updateNotifySettings_param_notify_settings_type_PeerNotifySettings' => 'New notification settings', + 'object_updateServiceNotification' => 'A service message for the user. + +The app must show the message to the user upon receiving this update. In case the **popup** parameter was passed, the text message must be displayed in a popup alert immediately upon receipt. It is recommended to handle the text as you would an ordinary message in terms of highlighting links, etc. The message must also be stored locally as part of the message history with the user id `777000` (Telegram Notifications).', + 'object_updateServiceNotification_param_popup_type_true' => '(boolTrue) if the message must be displayed in a popup.', + 'object_updateServiceNotification_param_inbox_date_type_int' => 'When was the notification received
The message must also be stored locally as part of the message history with the user id `777000` (Telegram Notifications).', + 'object_updateServiceNotification_param_type_type_string' => 'String, identical in format and contents to the [**type**](https://core.telegram.org/api/errors#error-type) field in API errors. Describes type of service message. It is acceptable to ignore repeated messages of the same **type** within a short period of time (15 minutes).', + 'object_updateServiceNotification_param_message_type_string' => 'Message text', + 'object_updateServiceNotification_param_media_type_MessageMedia' => 'Media content (optional)', 'object_updateServiceNotification_param_entities_type_Vector t' => 'Entities', - 'object_updatePrivacy' => 'Update privacy', - 'object_updatePrivacy_param_key_type_PrivacyKey' => 'Key', + 'object_updatePrivacy' => 'Privacy rules were changed', + 'object_updatePrivacy_param_key_type_PrivacyKey' => 'Peers to which the privacy rules apply', 'object_updatePrivacy_param_rules_type_Vector t' => 'Rules', - 'object_updateUserPhone' => 'Update user phone', + 'object_updateUserPhone' => 'A user\'s phone number was changed', 'object_updateUserPhone_param_user_id_type_int' => 'User ID', - 'object_updateUserPhone_param_phone_type_string' => 'Phone', - 'object_updateReadHistoryInbox' => 'Update read history inbox', + 'object_updateUserPhone_param_phone_type_string' => 'New phone number', + 'object_updateReadHistoryInbox' => 'Incoming messages were read', 'object_updateReadHistoryInbox_param_peer_type_Peer' => 'Peer', - 'object_updateReadHistoryInbox_param_max_id_type_int' => 'Max ID', - 'object_updateReadHistoryInbox_param_pts_type_int' => 'Pts', - 'object_updateReadHistoryInbox_param_pts_count_type_int' => 'Pts count', - 'object_updateReadHistoryOutbox' => 'Update read history outbox', + 'object_updateReadHistoryInbox_param_max_id_type_int' => 'Maximum ID of messages read', + 'object_updateReadHistoryInbox_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)', + 'object_updateReadHistoryInbox_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)', + 'object_updateReadHistoryOutbox' => 'Outgoing messages were read', 'object_updateReadHistoryOutbox_param_peer_type_Peer' => 'Peer', - 'object_updateReadHistoryOutbox_param_max_id_type_int' => 'Max ID', - 'object_updateReadHistoryOutbox_param_pts_type_int' => 'Pts', - 'object_updateReadHistoryOutbox_param_pts_count_type_int' => 'Pts count', - 'object_updateWebPage' => 'Update web page', - 'object_updateWebPage_param_webpage_type_WebPage' => 'Webpage', - 'object_updateWebPage_param_pts_type_int' => 'Pts', - 'object_updateWebPage_param_pts_count_type_int' => 'Pts count', - 'object_updateReadMessagesContents' => 'Update read messages contents', + 'object_updateReadHistoryOutbox_param_max_id_type_int' => 'Maximum ID of read outgoing messages', + 'object_updateReadHistoryOutbox_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)', + 'object_updateReadHistoryOutbox_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)', + 'object_updateWebPage' => 'An [instant view](https://instantview.telegram.org) webpage preview was generated', + 'object_updateWebPage_param_webpage_type_WebPage' => 'Webpage preview', + 'object_updateWebPage_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)', + 'object_updateWebPage_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)', + 'object_updateReadMessagesContents' => 'Contents of messages in the common [message box](https://core.telegram.org/api/updates) were read', 'object_updateReadMessagesContents_param_messages_type_Vector t' => 'Messages', - 'object_updateReadMessagesContents_param_pts_type_int' => 'Pts', - 'object_updateReadMessagesContents_param_pts_count_type_int' => 'Pts count', - 'object_updateChannelTooLong' => 'Update channel too long', - 'object_updateChannelTooLong_param_channel_id_type_int' => 'Channel ID', - 'object_updateChannelTooLong_param_pts_type_int' => 'Pts', - 'object_updateChannel' => 'Update channel', + 'object_updateReadMessagesContents_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)', + 'object_updateReadMessagesContents_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)', + 'object_updateChannelTooLong' => 'There are new updates in the specified channel, the client must fetch them, eventually starting the specified pts if the difference is too long or if the channel isn\'t currently in the states.', + 'object_updateChannelTooLong_param_channel_id_type_int' => 'The channel', + 'object_updateChannelTooLong_param_pts_type_int' => 'The [PTS](https://core.telegram.org/api/updates).', + 'object_updateChannel' => 'A new channel is available', 'object_updateChannel_param_channel_id_type_int' => 'Channel ID', - 'object_updateNewChannelMessage' => 'Update new channel message', - 'object_updateNewChannelMessage_param_message_type_Message' => 'Message', - 'object_updateNewChannelMessage_param_pts_type_int' => 'Pts', - 'object_updateNewChannelMessage_param_pts_count_type_int' => 'Pts count', - 'object_updateReadChannelInbox' => 'Update read channel inbox', - 'object_updateReadChannelInbox_param_channel_id_type_int' => 'Channel ID', - 'object_updateReadChannelInbox_param_max_id_type_int' => 'Max ID', - 'object_updateDeleteChannelMessages' => 'Update delete channel messages', + 'object_updateNewChannelMessage' => 'A new message was sent in a [channel/supergroup](https://core.telegram.org/api/channel)', + 'object_updateNewChannelMessage_param_message_type_Message' => 'New message', + 'object_updateNewChannelMessage_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)', + 'object_updateNewChannelMessage_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)', + 'object_updateReadChannelInbox' => 'Incoming messages in a [channel/supergroup](https://core.telegram.org/api/channel) were read', + 'object_updateReadChannelInbox_param_channel_id_type_int' => 'Channel/supergroup ID', + 'object_updateReadChannelInbox_param_max_id_type_int' => 'Position up to which all incoming messages are read.', + 'object_updateDeleteChannelMessages' => 'Some messages in a [supergroup/channel](https://core.telegram.org/api/channel) were deleted', 'object_updateDeleteChannelMessages_param_channel_id_type_int' => 'Channel ID', 'object_updateDeleteChannelMessages_param_messages_type_Vector t' => 'Messages', - 'object_updateDeleteChannelMessages_param_pts_type_int' => 'Pts', - 'object_updateDeleteChannelMessages_param_pts_count_type_int' => 'Pts count', - 'object_updateChannelMessageViews' => 'Update channel message views', + 'object_updateDeleteChannelMessages_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)', + 'object_updateDeleteChannelMessages_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)', + 'object_updateChannelMessageViews' => 'The view counter of a message in a channel has changed', 'object_updateChannelMessageViews_param_channel_id_type_int' => 'Channel ID', - 'object_updateChannelMessageViews_param_id_type_int' => 'ID', - 'object_updateChannelMessageViews_param_views_type_int' => 'Views', + 'object_updateChannelMessageViews_param_id_type_int' => 'ID of the message', + 'object_updateChannelMessageViews_param_views_type_int' => 'New view counter', 'object_updateChatAdmins' => 'Update chat admins', 'object_updateChatAdmins_param_chat_id_type_int' => 'Chat ID', 'object_updateChatAdmins_param_enabled_type_Bool' => 'Enabled?', 'object_updateChatAdmins_param_version_type_int' => 'Version', - 'object_updateChatParticipantAdmin' => 'Update chat participant admin', + 'object_updateChatParticipantAdmin' => 'Admin permissions of a user in a [legacy group](https://core.telegram.org/api/channel) were changed', 'object_updateChatParticipantAdmin_param_chat_id_type_int' => 'Chat ID', - 'object_updateChatParticipantAdmin_param_user_id_type_int' => 'User ID', - 'object_updateChatParticipantAdmin_param_is_admin_type_Bool' => 'Is admin?', - 'object_updateChatParticipantAdmin_param_version_type_int' => 'Version', - 'object_updateNewStickerSet' => 'Update new sticker set', - 'object_updateNewStickerSet_param_stickerset_type_messages.StickerSet' => 'Stickerset', - 'object_updateStickerSetsOrder' => 'Update sticker sets order', - 'object_updateStickerSetsOrder_param_masks_type_true' => 'Masks?', + 'object_updateChatParticipantAdmin_param_user_id_type_int' => 'ID of the (de)admined user', + 'object_updateChatParticipantAdmin_param_is_admin_type_Bool' => 'Whether the user was rendered admin', + 'object_updateChatParticipantAdmin_param_version_type_int' => 'Used in basic groups to reorder updates and make sure that all of them was received.', + 'object_updateNewStickerSet' => 'A new stickerset was installed', + 'object_updateNewStickerSet_param_stickerset_type_messages.StickerSet' => 'The installed stickerset', + 'object_updateStickerSetsOrder' => 'The order of stickersets was changed', + 'object_updateStickerSetsOrder_param_masks_type_true' => 'Whether the updated stickers are mask stickers', 'object_updateStickerSetsOrder_param_order_type_Vector t' => 'Order', - 'object_updateStickerSets' => 'Update sticker sets', - 'object_updateSavedGifs' => 'Update saved gifs', - 'object_updateBotInlineQuery' => 'Update bot inline query', + 'object_updateStickerSets' => 'Installed stickersets have changed, the client should refetch them using [messages.getAllStickers](https://core.telegram.org/method/messages.getAllStickers)', + 'object_updateSavedGifs' => 'The saved gif list has changed, the client should refetch it using [messages.getSavedGifs](https://core.telegram.org/method/messages.getSavedGifs)', + 'object_updateBotInlineQuery' => 'An incoming inline query', 'object_updateBotInlineQuery_param_query_id_type_long' => 'Query ID', - 'object_updateBotInlineQuery_param_user_id_type_int' => 'User ID', - 'object_updateBotInlineQuery_param_query_type_string' => 'Query', - 'object_updateBotInlineQuery_param_geo_type_GeoPoint' => 'Geo', - 'object_updateBotInlineQuery_param_offset_type_string' => 'Offset', - 'object_updateBotInlineSend' => 'Update bot inline send', - 'object_updateBotInlineSend_param_user_id_type_int' => 'User ID', - 'object_updateBotInlineSend_param_query_type_string' => 'Query', - 'object_updateBotInlineSend_param_geo_type_GeoPoint' => 'Geo', - 'object_updateBotInlineSend_param_id_type_string' => 'ID', - 'object_updateBotInlineSend_param_msg_id_type_InputBotInlineMessageID' => 'Msg ID', - 'object_updateEditChannelMessage' => 'Update edit channel message', - 'object_updateEditChannelMessage_param_message_type_Message' => 'Message', - 'object_updateEditChannelMessage_param_pts_type_int' => 'Pts', - 'object_updateEditChannelMessage_param_pts_count_type_int' => 'Pts count', - 'object_updateChannelPinnedMessage' => 'Update channel pinned message', - 'object_updateChannelPinnedMessage_param_channel_id_type_int' => 'Channel ID', - 'object_updateChannelPinnedMessage_param_id_type_int' => 'ID', - 'object_updateBotCallbackQuery' => 'Update bot callback query', + 'object_updateBotInlineQuery_param_user_id_type_int' => 'User that sent the query', + 'object_updateBotInlineQuery_param_query_type_string' => 'Text of query', + 'object_updateBotInlineQuery_param_geo_type_GeoPoint' => 'Attached geolocation', + 'object_updateBotInlineQuery_param_offset_type_string' => 'Offset to navigate through results', + 'object_updateBotInlineSend' => 'The result of an inline query that was chosen by a user and sent to their chat partner. Please see our documentation on the [feedback collecting](https://core.telegram.org/bots/inline#collecting-feedback) for details on how to enable these updates for your bot.', + 'object_updateBotInlineSend_param_user_id_type_int' => 'The user that chose the result', + 'object_updateBotInlineSend_param_query_type_string' => 'The query that was used to obtain the result', + 'object_updateBotInlineSend_param_geo_type_GeoPoint' => 'Optional. Sender location, only for bots that require user location', + 'object_updateBotInlineSend_param_id_type_string' => 'The unique identifier for the result that was chosen', + 'object_updateBotInlineSend_param_msg_id_type_InputBotInlineMessageID' => 'Identifier of the sent inline message. Available only if there is an inline keyboard attached to the message. Will be also received in callback queries and can be used to edit the message.', + 'object_updateEditChannelMessage' => 'A message was edited in a [channel/supergroup](https://core.telegram.org/api/channel)', + 'object_updateEditChannelMessage_param_message_type_Message' => 'The new message', + 'object_updateEditChannelMessage_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)', + 'object_updateEditChannelMessage_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)', + 'object_updateChannelPinnedMessage' => 'A message was pinned in a [channel/supergroup](https://core.telegram.org/api/channel).', + 'object_updateChannelPinnedMessage_param_channel_id_type_int' => 'Channel/supergroup ID', + 'object_updateChannelPinnedMessage_param_id_type_int' => 'ID of pinned message', + 'object_updateBotCallbackQuery' => 'A callback button was pressed, and the button data was sent to the bot that created the button', 'object_updateBotCallbackQuery_param_query_id_type_long' => 'Query ID', - 'object_updateBotCallbackQuery_param_user_id_type_int' => 'User ID', - 'object_updateBotCallbackQuery_param_peer_type_Peer' => 'Peer', - 'object_updateBotCallbackQuery_param_msg_id_type_int' => 'Msg ID', - 'object_updateBotCallbackQuery_param_chat_instance_type_long' => 'Chat instance', - 'object_updateBotCallbackQuery_param_data_type_bytes' => 'Data', - 'object_updateBotCallbackQuery_param_game_short_name_type_string' => 'Game short name', - 'object_updateEditMessage' => 'Update edit message', - 'object_updateEditMessage_param_message_type_Message' => 'Message', - 'object_updateEditMessage_param_pts_type_int' => 'Pts', - 'object_updateEditMessage_param_pts_count_type_int' => 'Pts count', - 'object_updateInlineBotCallbackQuery' => 'Update inline bot callback query', + 'object_updateBotCallbackQuery_param_user_id_type_int' => 'ID of the user that pressed the button', + 'object_updateBotCallbackQuery_param_peer_type_Peer' => 'Chat where the inline keyboard was sent', + 'object_updateBotCallbackQuery_param_msg_id_type_int' => 'Message ID', + 'object_updateBotCallbackQuery_param_chat_instance_type_long' => 'Global identifier, uniquely corresponding to the chat to which the message with the callback button was sent. Useful for high scores in games.', + 'object_updateBotCallbackQuery_param_data_type_bytes' => 'Callback data', + 'object_updateBotCallbackQuery_param_game_short_name_type_string' => 'Short name of a Game to be returned, serves as the unique identifier for the game', + 'object_updateEditMessage' => 'A message was edited', + 'object_updateEditMessage_param_message_type_Message' => 'The new edited message', + 'object_updateEditMessage_param_pts_type_int' => '[PTS](https://core.telegram.org/api/updates)', + 'object_updateEditMessage_param_pts_count_type_int' => '[PTS count](https://core.telegram.org/api/updates)', + 'object_updateInlineBotCallbackQuery' => 'This notification is received by bots when a button is pressed', 'object_updateInlineBotCallbackQuery_param_query_id_type_long' => 'Query ID', - 'object_updateInlineBotCallbackQuery_param_user_id_type_int' => 'User ID', - 'object_updateInlineBotCallbackQuery_param_msg_id_type_InputBotInlineMessageID' => 'Msg ID', - 'object_updateInlineBotCallbackQuery_param_chat_instance_type_long' => 'Chat instance', - 'object_updateInlineBotCallbackQuery_param_data_type_bytes' => 'Data', - 'object_updateInlineBotCallbackQuery_param_game_short_name_type_string' => 'Game short name', - 'object_updateReadChannelOutbox' => 'Update read channel outbox', - 'object_updateReadChannelOutbox_param_channel_id_type_int' => 'Channel ID', - 'object_updateReadChannelOutbox_param_max_id_type_int' => 'Max ID', - 'object_updateDraftMessage' => 'Update draft message', - 'object_updateDraftMessage_param_peer_type_Peer' => 'Peer', - 'object_updateDraftMessage_param_draft_type_DraftMessage' => 'Draft', - 'object_updateReadFeaturedStickers' => 'Update read featured stickers', - 'object_updateRecentStickers' => 'Update recent stickers', - 'object_updateConfig' => 'Update config', - 'object_updatePtsChanged' => 'Update pts changed', - 'object_updateChannelWebPage' => 'Update channel web page', - 'object_updateChannelWebPage_param_channel_id_type_int' => 'Channel ID', - 'object_updateChannelWebPage_param_webpage_type_WebPage' => 'Webpage', - 'object_updateChannelWebPage_param_pts_type_int' => 'Pts', - 'object_updateChannelWebPage_param_pts_count_type_int' => 'Pts count', - 'object_updateDialogPinned' => 'Update dialog pinned', - 'object_updateDialogPinned_param_pinned_type_true' => 'Pinned?', + 'object_updateInlineBotCallbackQuery_param_user_id_type_int' => 'ID of the user that pressed the button', + 'object_updateInlineBotCallbackQuery_param_msg_id_type_InputBotInlineMessageID' => 'ID of the inline message with the button', + 'object_updateInlineBotCallbackQuery_param_chat_instance_type_long' => 'Global identifier, uniquely corresponding to the chat to which the message with the callback button was sent. Useful for high scores in games.', + 'object_updateInlineBotCallbackQuery_param_data_type_bytes' => 'Data associated with the callback button. Be aware that a bad client can send arbitrary data in this field.', + 'object_updateInlineBotCallbackQuery_param_game_short_name_type_string' => 'Short name of a Game to be returned, serves as the unique identifier for the game', + 'object_updateReadChannelOutbox' => 'Outgoing messages in a [channel/supergroup](https://core.telegram.org/api/channel) were read', + 'object_updateReadChannelOutbox_param_channel_id_type_int' => 'Channel/supergroup ID', + 'object_updateReadChannelOutbox_param_max_id_type_int' => 'Position up to which all outgoing messages are read.', + 'object_updateDraftMessage' => 'Notifies a change of a message [draft](https://core.telegram.org/api/drafts).', + 'object_updateDraftMessage_param_peer_type_Peer' => 'The peer to which the draft is associated', + 'object_updateDraftMessage_param_draft_type_DraftMessage' => 'The draft', + 'object_updateReadFeaturedStickers' => 'Some featured stickers were marked as read', + 'object_updateRecentStickers' => 'The recent sticker list was updated', + 'object_updateConfig' => 'The server-side configuration has changed; the client should re-fetch the config using [help.getConfig](../methods/help.getConfig.md)', + 'object_updatePtsChanged' => '[Common message box sequence PTS](https://core.telegram.org/api/updates) has changed, [state has to be refetched using updates.getState](https://core.telegram.org/api/updates#fetching-state)', + 'object_updateChannelWebPage' => 'A webpage preview of a link in a [channel/supergroup](https://core.telegram.org/api/channel) message was generated', + 'object_updateChannelWebPage_param_channel_id_type_int' => '[Channel/supergroup](https://core.telegram.org/api/channel) ID', + 'object_updateChannelWebPage_param_webpage_type_WebPage' => 'Generated webpage preview', + 'object_updateChannelWebPage_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)', + 'object_updateChannelWebPage_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)', + 'object_updateDialogPinned' => 'A dialog was pinned/unpinned', + 'object_updateDialogPinned_param_pinned_type_true' => 'Whether the dialog was pinned', 'object_updateDialogPinned_param_peer_type_Peer' => 'Peer', - 'object_updatePinnedDialogs' => 'Update pinned dialogs', + 'object_updatePinnedDialogs' => 'Pinned dialogs were updated', 'object_updatePinnedDialogs_param_order_type_Vector t' => 'Order', - 'object_updateBotWebhookJSON' => 'Update bot webhook json', - 'object_updateBotWebhookJSON_param_data_type_DataJSON' => 'Data', - 'object_updateBotWebhookJSONQuery' => 'Update bot webhook json query', - 'object_updateBotWebhookJSONQuery_param_query_id_type_long' => 'Query ID', - 'object_updateBotWebhookJSONQuery_param_data_type_DataJSON' => 'Data', - 'object_updateBotWebhookJSONQuery_param_timeout_type_int' => 'Timeout', - 'object_updateBotShippingQuery' => 'Update bot shipping query', - 'object_updateBotShippingQuery_param_query_id_type_long' => 'Query ID', - 'object_updateBotShippingQuery_param_user_id_type_int' => 'User ID', - 'object_updateBotShippingQuery_param_payload_type_bytes' => 'Payload', - 'object_updateBotShippingQuery_param_shipping_address_type_PostAddress' => 'Shipping address', - 'object_updateBotPrecheckoutQuery' => 'Update bot precheckout query', - 'object_updateBotPrecheckoutQuery_param_query_id_type_long' => 'Query ID', - 'object_updateBotPrecheckoutQuery_param_user_id_type_int' => 'User ID', - 'object_updateBotPrecheckoutQuery_param_payload_type_bytes' => 'Payload', - 'object_updateBotPrecheckoutQuery_param_info_type_PaymentRequestedInfo' => 'Info', - 'object_updateBotPrecheckoutQuery_param_shipping_option_id_type_string' => 'Shipping option ID', - 'object_updateBotPrecheckoutQuery_param_currency_type_string' => 'Currency', - 'object_updateBotPrecheckoutQuery_param_total_amount_type_long' => 'Total amount', - 'object_updatePhoneCall' => 'Update phone call', + 'object_updateBotWebhookJSON' => 'A new incoming event; for bots only', + 'object_updateBotWebhookJSON_param_data_type_DataJSON' => 'The event', + 'object_updateBotWebhookJSONQuery' => 'A new incoming query; for bots only', + 'object_updateBotWebhookJSONQuery_param_query_id_type_long' => 'Query identifier', + 'object_updateBotWebhookJSONQuery_param_data_type_DataJSON' => 'Query data', + 'object_updateBotWebhookJSONQuery_param_timeout_type_int' => 'Query timeout', + 'object_updateBotShippingQuery' => 'This object contains information about an incoming shipping query.', + 'object_updateBotShippingQuery_param_query_id_type_long' => 'Unique query identifier', + 'object_updateBotShippingQuery_param_user_id_type_int' => 'User who sent the query', + 'object_updateBotShippingQuery_param_payload_type_bytes' => 'Bot specified invoice payload', + 'object_updateBotShippingQuery_param_shipping_address_type_PostAddress' => 'User specified shipping address', + 'object_updateBotPrecheckoutQuery' => 'This object contains information about an incoming pre-checkout query.', + 'object_updateBotPrecheckoutQuery_param_query_id_type_long' => 'Unique query identifier', + 'object_updateBotPrecheckoutQuery_param_user_id_type_int' => 'User who sent the query', + 'object_updateBotPrecheckoutQuery_param_payload_type_bytes' => 'Bot specified invoice payload', + 'object_updateBotPrecheckoutQuery_param_info_type_PaymentRequestedInfo' => 'Order info provided by the user', + 'object_updateBotPrecheckoutQuery_param_shipping_option_id_type_string' => 'Identifier of the shipping option chosen by the user', + 'object_updateBotPrecheckoutQuery_param_currency_type_string' => 'Three-letter ISO 4217 [currency](https://core.telegram.org/bots/payments#supported-currencies) code', + 'object_updateBotPrecheckoutQuery_param_total_amount_type_long' => 'Total amount in the smallest units of the currency (integer, not float/double). For example, for a price of `US$ 1.45` pass `amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).', + 'object_updatePhoneCall' => 'An incoming phone call', 'object_updatePhoneCall_param_phone_call_type_PhoneCall' => 'Phone call', - 'object_updateLangPackTooLong' => 'Update lang pack too long', - 'object_updateLangPack' => 'Update lang pack', - 'object_updateLangPack_param_difference_type_LangPackDifference' => 'Difference', - 'object_updateFavedStickers' => 'Update faved stickers', - 'object_updateChannelReadMessagesContents' => 'Update channel read messages contents', - 'object_updateChannelReadMessagesContents_param_channel_id_type_int' => 'Channel ID', + 'object_updateLangPackTooLong' => 'A language pack has changed, the client should manually fetch the changed strings using [langpack.getDifference](../methods/langpack.getDifference.md)', + 'object_updateLangPack' => 'Language pack updated', + 'object_updateLangPack_param_difference_type_LangPackDifference' => 'Changed strings', + 'object_updateFavedStickers' => 'The list of favorited stickers was changed, the client should call [messages.getFavedStickers](../methods/messages.getFavedStickers.md) to refetch the new list', + 'object_updateChannelReadMessagesContents' => 'The specified [channel/supergroup](https://core.telegram.org/api/channel) messages were read', + 'object_updateChannelReadMessagesContents_param_channel_id_type_int' => '[Channel/supergroup](https://core.telegram.org/api/channel) ID', 'object_updateChannelReadMessagesContents_param_messages_type_Vector t' => 'Messages', - 'object_updateContactsReset' => 'Update contacts reset', - 'object_updateChannelAvailableMessages' => 'Update channel available messages', - 'object_updateChannelAvailableMessages_param_channel_id_type_int' => 'Channel ID', - 'object_updateChannelAvailableMessages_param_available_min_id_type_int' => 'Available min ID', - 'object_updates.state' => 'State', - 'object_updates.state_param_pts_type_int' => 'Pts', - 'object_updates.state_param_qts_type_int' => 'Qts', - 'object_updates.state_param_date_type_int' => 'Date', - 'object_updates.state_param_seq_type_int' => 'Seq', - 'object_updates.state_param_unread_count_type_int' => 'Unread count', - 'object_updates.differenceEmpty' => 'Empty difference', - 'object_updates.differenceEmpty_param_date_type_int' => 'Date', - 'object_updates.differenceEmpty_param_seq_type_int' => 'Seq', - 'object_updates.difference' => 'Difference', + 'object_updateContactsReset' => 'All contacts were deleted', + 'object_updateChannelAvailableMessages' => 'The history of a [channel/supergroup](https://core.telegram.org/api/channel) was hidden.', + 'object_updateChannelAvailableMessages_param_channel_id_type_int' => 'Channel/supergroup ID', + 'object_updateChannelAvailableMessages_param_available_min_id_type_int' => 'Identifier of a maximum unavailable message in a channel due to hidden history.', + 'object_updates.state' => 'Updates state.', + 'object_updates.state_param_pts_type_int' => 'Number of events occured in a text box', + 'object_updates.state_param_qts_type_int' => 'Position in a sequence of updates in secret chats. For further detailes refer to article [secret chats](https://core.telegram.org/api/end-to-end)
Parameter was added in [eigth layer](https://core.telegram.org/api/layers#layer-8).', + 'object_updates.state_param_date_type_int' => 'Date of condition', + 'object_updates.state_param_seq_type_int' => 'Number of sent updates', + 'object_updates.state_param_unread_count_type_int' => 'Number of unread messages', + 'object_updates.differenceEmpty' => 'No events.', + 'object_updates.differenceEmpty_param_date_type_int' => 'Current date', + 'object_updates.differenceEmpty_param_seq_type_int' => 'Number of sent updates', + 'object_updates.difference' => 'Full list of occurred events.', 'object_updates.difference_param_new_messages_type_Vector t' => 'New messages', 'object_updates.difference_param_new_encrypted_messages_type_Vector t' => 'New encrypted messages', 'object_updates.difference_param_other_updates_type_Vector t' => 'Other updates', 'object_updates.difference_param_chats_type_Vector t' => 'Chats', 'object_updates.difference_param_users_type_Vector t' => 'Users', - 'object_updates.difference_param_state_type_updates.State' => 'State', - 'object_updates.differenceSlice' => 'Difference slice', + 'object_updates.difference_param_state_type_updates.State' => 'Current state', + 'object_updates.differenceSlice' => 'Incomplete list of occurred events.', 'object_updates.differenceSlice_param_new_messages_type_Vector t' => 'New messages', 'object_updates.differenceSlice_param_new_encrypted_messages_type_Vector t' => 'New encrypted messages', 'object_updates.differenceSlice_param_other_updates_type_Vector t' => 'Other updates', 'object_updates.differenceSlice_param_chats_type_Vector t' => 'Chats', 'object_updates.differenceSlice_param_users_type_Vector t' => 'Users', - 'object_updates.differenceSlice_param_intermediate_state_type_updates.State' => 'Intermediate state', - 'object_updates.differenceTooLong' => 'Difference too long', - 'object_updates.differenceTooLong_param_pts_type_int' => 'Pts', - 'object_updatesTooLong' => 'Updates too long', - 'object_updateShortMessage' => 'Update short message', - 'object_updateShortMessage_param_out_type_true' => 'Out?', - 'object_updateShortMessage_param_mentioned_type_true' => 'Mentioned?', - 'object_updateShortMessage_param_media_unread_type_true' => 'Media unread?', - 'object_updateShortMessage_param_silent_type_true' => 'Silent?', - 'object_updateShortMessage_param_id_type_int' => 'ID', - 'object_updateShortMessage_param_user_id_type_int' => 'User ID', - 'object_updateShortMessage_param_message_type_string' => 'Message', - 'object_updateShortMessage_param_pts_type_int' => 'Pts', - 'object_updateShortMessage_param_pts_count_type_int' => 'Pts count', - 'object_updateShortMessage_param_date_type_int' => 'Date', - 'object_updateShortMessage_param_fwd_from_type_MessageFwdHeader' => 'Fwd from', - 'object_updateShortMessage_param_via_bot_id_type_int' => 'Via bot ID', - 'object_updateShortMessage_param_reply_to_msg_id_type_int' => 'Reply to msg ID', + 'object_updates.differenceSlice_param_intermediate_state_type_updates.State' => 'Intermediary state', + 'object_updates.differenceTooLong' => 'The difference is [too long](https://core.telegram.org/api/updates#recovering-gaps), and the specified state must be used to refetch updates.', + 'object_updates.differenceTooLong_param_pts_type_int' => 'The new state to use.', + 'object_updatesTooLong' => 'Too many updates, it is necessary to execute [updates.getDifference](../methods/updates.getDifference.md).', + 'object_updateShortMessage' => 'Info about a message sent to (received from) another user', + 'object_updateShortMessage_param_out_type_true' => 'Whether the message is outgoing', + 'object_updateShortMessage_param_mentioned_type_true' => 'Whether we were mentioned in the message', + 'object_updateShortMessage_param_media_unread_type_true' => 'Whether there are some **unread** mentions in this message', + 'object_updateShortMessage_param_silent_type_true' => 'If true, the message is a silent message, no notifications should be triggered', + 'object_updateShortMessage_param_id_type_int' => 'The message ID', + 'object_updateShortMessage_param_user_id_type_int' => 'The ID of the sender (if `outgoing` will be the ID of the destination) of the message', + 'object_updateShortMessage_param_message_type_string' => 'The message', + 'object_updateShortMessage_param_pts_type_int' => '[PTS](https://core.telegram.org/api/updates)', + 'object_updateShortMessage_param_pts_count_type_int' => '[PTS count](https://core.telegram.org/api/updates)', + 'object_updateShortMessage_param_date_type_int' => '[date](https://core.telegram.org/api/updates)', + 'object_updateShortMessage_param_fwd_from_type_MessageFwdHeader' => 'Info about a forwarded message', + 'object_updateShortMessage_param_via_bot_id_type_int' => 'Info about the inline bot used to generate this message', + 'object_updateShortMessage_param_reply_to_msg_id_type_int' => 'ID of the message this message replies to', 'object_updateShortMessage_param_entities_type_Vector t' => 'Entities', - 'object_updateShortChatMessage' => 'Update short chat message', - 'object_updateShortChatMessage_param_out_type_true' => 'Out?', - 'object_updateShortChatMessage_param_mentioned_type_true' => 'Mentioned?', - 'object_updateShortChatMessage_param_media_unread_type_true' => 'Media unread?', - 'object_updateShortChatMessage_param_silent_type_true' => 'Silent?', - 'object_updateShortChatMessage_param_id_type_int' => 'ID', - 'object_updateShortChatMessage_param_from_id_type_int' => 'From ID', - 'object_updateShortChatMessage_param_chat_id_type_int' => 'Chat ID', + 'object_updateShortChatMessage' => 'Shortened constructor containing info on one new incoming text message from a chat', + 'object_updateShortChatMessage_param_out_type_true' => 'Whether the message is outgoing', + 'object_updateShortChatMessage_param_mentioned_type_true' => 'Whether we were mentioned in this message', + 'object_updateShortChatMessage_param_media_unread_type_true' => 'Whether the message contains some **unread** mentions', + 'object_updateShortChatMessage_param_silent_type_true' => 'If true, the message is a silent message, no notifications should be triggered', + 'object_updateShortChatMessage_param_id_type_int' => 'ID of the message', + 'object_updateShortChatMessage_param_from_id_type_int' => 'ID of the sender of the message', + 'object_updateShortChatMessage_param_chat_id_type_int' => 'ID of the chat where the message was sent', 'object_updateShortChatMessage_param_message_type_string' => 'Message', - 'object_updateShortChatMessage_param_pts_type_int' => 'Pts', - 'object_updateShortChatMessage_param_pts_count_type_int' => 'Pts count', - 'object_updateShortChatMessage_param_date_type_int' => 'Date', - 'object_updateShortChatMessage_param_fwd_from_type_MessageFwdHeader' => 'Fwd from', - 'object_updateShortChatMessage_param_via_bot_id_type_int' => 'Via bot ID', - 'object_updateShortChatMessage_param_reply_to_msg_id_type_int' => 'Reply to msg ID', + 'object_updateShortChatMessage_param_pts_type_int' => '[PTS](https://core.telegram.org/api/updates)', + 'object_updateShortChatMessage_param_pts_count_type_int' => '[PTS count](https://core.telegram.org/api/updates)', + 'object_updateShortChatMessage_param_date_type_int' => '[date](https://core.telegram.org/api/updates)', + 'object_updateShortChatMessage_param_fwd_from_type_MessageFwdHeader' => 'Info about a forwarded message', + 'object_updateShortChatMessage_param_via_bot_id_type_int' => 'Info about the inline bot used to generate this message', + 'object_updateShortChatMessage_param_reply_to_msg_id_type_int' => 'ID of the message this message replies to', 'object_updateShortChatMessage_param_entities_type_Vector t' => 'Entities', - 'object_updateShort' => 'Update short', + 'object_updateShort' => 'Shortened constructor containing info on one update not requiring auxiliary data', 'object_updateShort_param_update_type_Update' => 'Update', - 'object_updateShort_param_date_type_int' => 'Date', - 'object_updatesCombined' => 'Updates combined', + 'object_updateShort_param_date_type_int' => 'Date of event', + 'object_updatesCombined' => 'Constructor for a group of updates.', 'object_updatesCombined_param_updates_type_Vector t' => 'Updates', 'object_updatesCombined_param_users_type_Vector t' => 'Users', 'object_updatesCombined_param_chats_type_Vector t' => 'Chats', - 'object_updatesCombined_param_date_type_int' => 'Date', - 'object_updatesCombined_param_seq_start_type_int' => 'Seq start', - 'object_updatesCombined_param_seq_type_int' => 'Seq', - 'object_updates' => 'Updates', + 'object_updatesCombined_param_date_type_int' => 'Current date', + 'object_updatesCombined_param_seq_start_type_int' => 'Value **seq** for the earliest update in a group', + 'object_updatesCombined_param_seq_type_int' => 'Value **seq** for the latest update in a group', + 'object_updates' => 'Full constructor of updates', 'object_updates_param_updates_type_Vector t' => 'Updates', 'object_updates_param_users_type_Vector t' => 'Users', 'object_updates_param_chats_type_Vector t' => 'Chats', - 'object_updates_param_date_type_int' => 'Date', - 'object_updates_param_seq_type_int' => 'Seq', - 'object_updateShortSentMessage' => 'Update short sent message', - 'object_updateShortSentMessage_param_out_type_true' => 'Out?', - 'object_updateShortSentMessage_param_id_type_int' => 'ID', - 'object_updateShortSentMessage_param_pts_type_int' => 'Pts', - 'object_updateShortSentMessage_param_pts_count_type_int' => 'Pts count', - 'object_updateShortSentMessage_param_date_type_int' => 'Date', - 'object_updateShortSentMessage_param_media_type_MessageMedia' => 'Media', + 'object_updates_param_date_type_int' => 'Current date', + 'object_updates_param_seq_type_int' => 'Total number of sent updates', + 'object_updateShortSentMessage' => 'Shortened constructor containing info on one outgoing message to a contact (the destination chat has to be extracted from the method call that returned this object).', + 'object_updateShortSentMessage_param_out_type_true' => 'Whether the message is outgoing', + 'object_updateShortSentMessage_param_id_type_int' => 'ID of the sent message', + 'object_updateShortSentMessage_param_pts_type_int' => '[PTS](https://core.telegram.org/api/updates)', + 'object_updateShortSentMessage_param_pts_count_type_int' => '[PTS count](https://core.telegram.org/api/updates)', + 'object_updateShortSentMessage_param_date_type_int' => '[date](https://core.telegram.org/api/updates)', + 'object_updateShortSentMessage_param_media_type_MessageMedia' => 'Attached media', 'object_updateShortSentMessage_param_entities_type_Vector t' => 'Entities', - 'object_photos.photos' => 'Photos', + 'object_photos.photos' => 'Full list of photos with auxiliary data.', 'object_photos.photos_param_photos_type_Vector t' => 'Photos', 'object_photos.photos_param_users_type_Vector t' => 'Users', - 'object_photos.photosSlice' => 'Photos slice', - 'object_photos.photosSlice_param_count_type_int' => 'Count', + 'object_photos.photosSlice' => 'Incomplete list of photos with auxiliary data.', + 'object_photos.photosSlice_param_count_type_int' => 'Total number of photos', 'object_photos.photosSlice_param_photos_type_Vector t' => 'Photos', 'object_photos.photosSlice_param_users_type_Vector t' => 'Users', - 'object_photos.photo' => 'Photo', + 'object_photos.photo' => 'Photo with auxiliary data.', 'object_photos.photo_param_photo_type_Photo' => 'Photo', 'object_photos.photo_param_users_type_Vector t' => 'Users', - 'object_upload.file' => 'File', - 'object_upload.file_param_type_type_storage.FileType' => 'Type', - 'object_upload.file_param_mtime_type_int' => 'Mtime', - 'object_upload.file_param_bytes_type_bytes' => 'Bytes', - 'object_upload.fileCdnRedirect' => 'File cdn redirect', - 'object_upload.fileCdnRedirect_param_dc_id_type_int' => 'DC ID', - 'object_upload.fileCdnRedirect_param_file_token_type_bytes' => 'File token', - 'object_upload.fileCdnRedirect_param_encryption_key_type_bytes' => 'Encryption key', - 'object_upload.fileCdnRedirect_param_encryption_iv_type_bytes' => 'Encryption iv', + 'object_upload.file' => 'File content.', + 'object_upload.file_param_type_type_storage.FileType' => 'File type', + 'object_upload.file_param_mtime_type_int' => 'Modification type', + 'object_upload.file_param_bytes_type_bytes' => 'Binary data, file content', + 'object_upload.fileCdnRedirect' => 'The file must be downloaded from a [CDN DC](https://core.telegram.org/cdn).', + 'object_upload.fileCdnRedirect_param_dc_id_type_int' => '[CDN DC](https://core.telegram.org/cdn) ID', + 'object_upload.fileCdnRedirect_param_file_token_type_bytes' => 'File token (see [CDN files](https://core.telegram.org/cdn)', + 'object_upload.fileCdnRedirect_param_encryption_key_type_bytes' => 'Encryption key (see [CDN files](https://core.telegram.org/cdn)', + 'object_upload.fileCdnRedirect_param_encryption_iv_type_bytes' => 'Encryption IV (see [CDN files](https://core.telegram.org/cdn)', 'object_upload.fileCdnRedirect_param_cdn_file_hashes_type_Vector t' => 'Cdn file hashes', - 'object_dcOption' => 'DC option', - 'object_dcOption_param_ipv6_type_true' => 'Ipv6?', - 'object_dcOption_param_media_only_type_true' => 'Media only?', - 'object_dcOption_param_tcpo_only_type_true' => 'Tcpo only?', - 'object_dcOption_param_cdn_type_true' => 'Cdn?', - 'object_dcOption_param_static_type_true' => 'Static?', - 'object_dcOption_param_id_type_int' => 'ID', - 'object_dcOption_param_ip_address_type_string' => 'Ip address', + 'object_dcOption' => 'Data centre', + 'object_dcOption_param_ipv6_type_true' => 'Whether the specified IP is an IPv6 address', + 'object_dcOption_param_media_only_type_true' => 'Whether this DC should only be used to [download or upload files](https://core.telegram.org/api/files)', + 'object_dcOption_param_tcpo_only_type_true' => 'Whether this DC only supports connection with [transport obfuscation](https://core.telegram.org/mtproto/mtproto-transports#transport-obfuscation)', + 'object_dcOption_param_cdn_type_true' => 'Whether this is a [CDN DC](https://core.telegram.org/cdn).', + 'object_dcOption_param_static_type_true' => 'If set, this IP should be used when connecting through a proxy', + 'object_dcOption_param_id_type_int' => 'DC ID', + 'object_dcOption_param_ip_address_type_string' => 'IP address of DC', 'object_dcOption_param_port_type_int' => 'Port', - 'object_config' => 'Config', - 'object_config_param_phonecalls_enabled_type_true' => 'Phonecalls enabled?', - 'object_config_param_default_p2p_contacts_type_true' => 'Default p2p contacts?', - 'object_config_param_date_type_int' => 'Date', - 'object_config_param_expires_type_int' => 'Expires', - 'object_config_param_test_mode_type_Bool' => 'Test mode?', - 'object_config_param_this_dc_type_int' => 'This DC', + 'object_config' => 'Current configuration', + 'object_config_param_phonecalls_enabled_type_true' => 'Whether phone calls can be used', + 'object_config_param_default_p2p_contacts_type_true' => 'Whether the client should use P2P by default for phone calls with contacts', + 'object_config_param_date_type_int' => 'Current date at the server', + 'object_config_param_expires_type_int' => 'Expiration date of this config: when it expires it\'ll have to be refetched using [help.getConfig](../methods/help.getConfig.md)', + 'object_config_param_test_mode_type_Bool' => 'Whether we\'re connected to the test DCs', + 'object_config_param_this_dc_type_int' => 'ID of the DC that returned the reply', 'object_config_param_dc_options_type_Vector t' => 'DC options', - 'object_config_param_chat_size_max_type_int' => 'Chat size max', - 'object_config_param_megagroup_size_max_type_int' => 'Megagroup size max', - 'object_config_param_forwarded_count_max_type_int' => 'Forwarded count max', - 'object_config_param_online_update_period_ms_type_int' => 'Online update period ms', - 'object_config_param_offline_blur_timeout_ms_type_int' => 'Offline blur timeout ms', - 'object_config_param_offline_idle_timeout_ms_type_int' => 'Offline IDle timeout ms', - 'object_config_param_online_cloud_timeout_ms_type_int' => 'Online cloud timeout ms', - 'object_config_param_notify_cloud_delay_ms_type_int' => 'Notify cloud delay ms', - 'object_config_param_notify_default_delay_ms_type_int' => 'Notify default delay ms', + 'object_config_param_chat_size_max_type_int' => 'Maximum member count for normal [groups](https://core.telegram.org/api/channel)', + 'object_config_param_megagroup_size_max_type_int' => 'Maximum member count for [supergroups](https://core.telegram.org/api/channel)', + 'object_config_param_forwarded_count_max_type_int' => 'Maximum number of messages that can be forwarded at once using [messages.forwardMessages](../methods/messages.forwardMessages.md).', + 'object_config_param_online_update_period_ms_type_int' => 'The client should [update its online status](../methods/account.updateStatus.md) every N milliseconds', + 'object_config_param_offline_blur_timeout_ms_type_int' => 'Delay before offline status needs to be sent to the server', + 'object_config_param_offline_idle_timeout_ms_type_int' => 'Time without any user activity after which it should be treated offline', + 'object_config_param_online_cloud_timeout_ms_type_int' => 'If we are offline, but were online from some other client in last `online_cloud_timeout_ms` milliseconds after we had gone offline, then delay offline notification for `notify_cloud_delay_ms` milliseconds.', + 'object_config_param_notify_cloud_delay_ms_type_int' => 'If we are offline, but online from some other client then delay sending the offline notification for `notify_cloud_delay_ms` milliseconds.', + 'object_config_param_notify_default_delay_ms_type_int' => 'If some other client is online, then delay notification for `notification_default_delay_ms` milliseconds', 'object_config_param_chat_big_size_type_int' => 'Chat big size', - 'object_config_param_push_chat_period_ms_type_int' => 'Push chat period ms', - 'object_config_param_push_chat_limit_type_int' => 'Push chat limit', - 'object_config_param_saved_gifs_limit_type_int' => 'Saved gifs limit', - 'object_config_param_edit_time_limit_type_int' => 'Edit time limit', - 'object_config_param_rating_e_decay_type_int' => 'Rating e decay', - 'object_config_param_stickers_recent_limit_type_int' => 'Stickers recent limit', - 'object_config_param_stickers_faved_limit_type_int' => 'Stickers faved limit', - 'object_config_param_channels_read_media_period_type_int' => 'Channels read media period', - 'object_config_param_tmp_sessions_type_int' => 'Tmp sessions', - 'object_config_param_pinned_dialogs_count_max_type_int' => 'Pinned dialogs count max', - 'object_config_param_call_receive_timeout_ms_type_int' => 'Call receive timeout ms', - 'object_config_param_call_ring_timeout_ms_type_int' => 'Call ring timeout ms', - 'object_config_param_call_connect_timeout_ms_type_int' => 'Call connect timeout ms', - 'object_config_param_call_packet_timeout_ms_type_int' => 'Call packet timeout ms', - 'object_config_param_me_url_prefix_type_string' => 'Me URL prefix', - 'object_config_param_suggested_lang_code_type_string' => 'Suggested lang code', - 'object_config_param_lang_pack_version_type_int' => 'Lang pack version', + 'object_config_param_push_chat_period_ms_type_int' => 'Not for client use', + 'object_config_param_push_chat_limit_type_int' => 'Not for client use', + 'object_config_param_saved_gifs_limit_type_int' => 'Maximum count of saved gifs', + 'object_config_param_edit_time_limit_type_int' => 'Only messages with age smaller than the one specified can be edited', + 'object_config_param_rating_e_decay_type_int' => 'Exponential decay rate for computing [top peer rating](https://core.telegram.org/api/top-rating)', + 'object_config_param_stickers_recent_limit_type_int' => 'Maximum number of recent stickers', + 'object_config_param_stickers_faved_limit_type_int' => 'Maximum number of faved stickers', + 'object_config_param_channels_read_media_period_type_int' => 'Indicates that round videos (video notes) and voice messages sent in channels and older than the specified period must be marked as read', + 'object_config_param_tmp_sessions_type_int' => 'Temporary [passport](https://core.telegram.org/passport) sessions', + 'object_config_param_pinned_dialogs_count_max_type_int' => 'Maximum count of pinned dialogs', + 'object_config_param_call_receive_timeout_ms_type_int' => 'Maximum allowed outgoing ring time in VoIP calls: if the user we\'re calling doesn\'t reply within the specified time (in milliseconds), we should hang up the call', + 'object_config_param_call_ring_timeout_ms_type_int' => 'Maximum allowed incoming ring time in VoIP calls: if the current user doesn\'t reply within the specified time (in milliseconds), the call will be automatically refused', + 'object_config_param_call_connect_timeout_ms_type_int' => 'VoIP connection timeout: if the instance of libtgvoip on the other side of the call doesn\'t connect to our instance of libtgvoip within the specified time (in milliseconds), the call must be aborted', + 'object_config_param_call_packet_timeout_ms_type_int' => 'If during a VoIP call a packet isn\'t received for the specified period of time, the call must be aborted', + 'object_config_param_me_url_prefix_type_string' => 'The domain to use to parse in-app links.
For example t.me indicates that t.me/username links should parsed to @username, t.me/addsticker/name should be parsed to the appropriate stickerset and so on...', + 'object_config_param_suggested_lang_code_type_string' => 'Suggested language code', + 'object_config_param_lang_pack_version_type_int' => 'Language pack version', 'object_config_param_disabled_features_type_Vector t' => 'Disabled features', - 'object_nearestDc' => 'Nearest DC', - 'object_nearestDc_param_country_type_string' => 'Country', - 'object_nearestDc_param_this_dc_type_int' => 'This DC', - 'object_nearestDc_param_nearest_dc_type_int' => 'Nearest DC', - 'object_help.appUpdate' => 'App update', - 'object_help.appUpdate_param_id_type_int' => 'ID', + 'object_nearestDc' => 'Nearest data centre, according to geo-ip.', + 'object_nearestDc_param_country_type_string' => 'Country code determined by geo-ip', + 'object_nearestDc_param_this_dc_type_int' => 'Number of current data centre', + 'object_nearestDc_param_nearest_dc_type_int' => 'Number of nearest data centre', + 'object_help.appUpdate' => 'An update is available for the application.', + 'object_help.appUpdate_param_id_type_int' => 'Update ID', 'object_help.appUpdate_param_critical_type_Bool' => 'Critical?', - 'object_help.appUpdate_param_url_type_string' => 'URL', - 'object_help.appUpdate_param_text_type_string' => 'Text', - 'object_help.noAppUpdate' => 'No app update', - 'object_help.inviteText' => 'Invite text', - 'object_help.inviteText_param_message_type_string' => 'Message', - 'object_encryptedChatEmpty' => 'Empty encrypted chat', - 'object_encryptedChatEmpty_param_id_type_int' => 'ID', - 'object_encryptedChatWaiting' => 'Encrypted chat waiting', - 'object_encryptedChatWaiting_param_id_type_int' => 'ID', - 'object_encryptedChatWaiting_param_access_hash_type_long' => 'Access hash', - 'object_encryptedChatWaiting_param_date_type_int' => 'Date', - 'object_encryptedChatWaiting_param_admin_id_type_int' => 'Admin ID', - 'object_encryptedChatWaiting_param_participant_id_type_int' => 'Participant ID', - 'object_encryptedChatRequested' => 'Encrypted chat requested', - 'object_encryptedChatRequested_param_id_type_int' => 'ID', - 'object_encryptedChatRequested_param_access_hash_type_long' => 'Access hash', - 'object_encryptedChatRequested_param_date_type_int' => 'Date', - 'object_encryptedChatRequested_param_admin_id_type_int' => 'Admin ID', - 'object_encryptedChatRequested_param_participant_id_type_int' => 'Participant ID', - 'object_encryptedChatRequested_param_g_a_type_bytes' => 'G a', + 'object_help.appUpdate_param_url_type_string' => 'Application download URL', + 'object_help.appUpdate_param_text_type_string' => 'Text description of the update', + 'object_help.noAppUpdate' => 'No updates are available for the application.', + 'object_help.inviteText' => 'Text of a text message with an invitation to install application.', + 'object_help.inviteText_param_message_type_string' => 'Text of a message', + 'object_encryptedChatEmpty' => 'Empty constructor.', + 'object_encryptedChatEmpty_param_id_type_int' => 'Chat ID', + 'object_encryptedChatWaiting' => 'Chat waiting for approval of second participant.', + 'object_encryptedChatWaiting_param_id_type_int' => 'Chat ID', + 'object_encryptedChatWaiting_param_access_hash_type_long' => 'Checking sum depending on user ID', + 'object_encryptedChatWaiting_param_date_type_int' => 'Date of chat creation', + 'object_encryptedChatWaiting_param_admin_id_type_int' => 'Chat creator ID', + 'object_encryptedChatWaiting_param_participant_id_type_int' => 'ID of second chat participant', + 'object_encryptedChatRequested' => 'Request to create an encrypted chat.', + 'object_encryptedChatRequested_param_id_type_int' => 'Chat ID', + 'object_encryptedChatRequested_param_access_hash_type_long' => 'Check sum depending on user ID', + 'object_encryptedChatRequested_param_date_type_int' => 'Chat creation date', + 'object_encryptedChatRequested_param_admin_id_type_int' => 'Chat creator ID', + 'object_encryptedChatRequested_param_participant_id_type_int' => 'ID of second chat participant', + 'object_encryptedChatRequested_param_g_a_type_bytes' => '`A = g ^ a mod p`, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange)', 'object_encryptedChat' => 'Encrypted chat', - 'object_encryptedChat_param_id_type_int' => 'ID', - 'object_encryptedChat_param_access_hash_type_long' => 'Access hash', - 'object_encryptedChat_param_date_type_int' => 'Date', - 'object_encryptedChat_param_admin_id_type_int' => 'Admin ID', - 'object_encryptedChat_param_participant_id_type_int' => 'Participant ID', - 'object_encryptedChat_param_g_a_or_b_type_bytes' => 'G a or b', - 'object_encryptedChat_param_key_fingerprint_type_long' => 'Key fingerprint', - 'object_encryptedChatDiscarded' => 'Encrypted chat discarded', - 'object_encryptedChatDiscarded_param_id_type_int' => 'ID', - 'object_inputEncryptedChat' => 'Encrypted chat', + 'object_encryptedChat_param_id_type_int' => 'Chat ID', + 'object_encryptedChat_param_access_hash_type_long' => 'Check sum dependant on the user ID', + 'object_encryptedChat_param_date_type_int' => 'Date chat was created', + 'object_encryptedChat_param_admin_id_type_int' => 'Chat creator ID', + 'object_encryptedChat_param_participant_id_type_int' => 'ID of the second chat participant', + 'object_encryptedChat_param_g_a_or_b_type_bytes' => '`B = g ^ b mod p`, if the currently authorized user is the chat\'s creator,
or `A = g ^ a mod p` otherwise
See [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange) for more info', + 'object_encryptedChat_param_key_fingerprint_type_long' => '64-bit fingerprint of received key', + 'object_encryptedChatDiscarded' => 'Discarded or deleted chat.', + 'object_encryptedChatDiscarded_param_id_type_int' => 'Chat ID', + 'object_inputEncryptedChat' => 'Creates an encrypted chat.', 'object_inputEncryptedChat_param_chat_id_type_int' => 'Chat ID', - 'object_inputEncryptedChat_param_access_hash_type_long' => 'Access hash', - 'object_encryptedFileEmpty' => 'Empty encrypted file', - 'object_encryptedFile' => 'Encrypted file', - 'object_encryptedFile_param_id_type_long' => 'ID', - 'object_encryptedFile_param_access_hash_type_long' => 'Access hash', - 'object_encryptedFile_param_size_type_int' => 'Size', - 'object_encryptedFile_param_dc_id_type_int' => 'DC ID', - 'object_encryptedFile_param_key_fingerprint_type_int' => 'Key fingerprint', - 'object_inputEncryptedFileEmpty' => 'Empty input encrypted file', - 'object_inputEncryptedFileUploaded' => 'Encrypted file uploaded', - 'object_inputEncryptedFileUploaded_param_id_type_long' => 'ID', - 'object_inputEncryptedFileUploaded_param_parts_type_int' => 'Parts', - 'object_inputEncryptedFileUploaded_param_md5_checksum_type_string' => 'Md5 checksum', - 'object_inputEncryptedFileUploaded_param_key_fingerprint_type_int' => 'Key fingerprint', - 'object_inputEncryptedFile' => 'Encrypted file', - 'object_inputEncryptedFile_param_id_type_long' => 'ID', - 'object_inputEncryptedFile_param_access_hash_type_long' => 'Access hash', - 'object_inputEncryptedFileBigUploaded' => 'Encrypted file big uploaded', - 'object_inputEncryptedFileBigUploaded_param_id_type_long' => 'ID', - 'object_inputEncryptedFileBigUploaded_param_parts_type_int' => 'Parts', - 'object_inputEncryptedFileBigUploaded_param_key_fingerprint_type_int' => 'Key fingerprint', - 'object_encryptedMessage' => 'Encrypted message', - 'object_encryptedMessage_param_chat_id_type_int' => 'Chat ID', - 'object_encryptedMessage_param_date_type_int' => 'Date', + 'object_inputEncryptedChat_param_access_hash_type_long' => 'Checking sum from constructor [encryptedChat](../constructors/encryptedChat.md), [encryptedChatWaiting](../constructors/encryptedChatWaiting.md) or [encryptedChatRequested](../constructors/encryptedChatRequested.md)', + 'object_encryptedFileEmpty' => 'Empty constructor, unexisitng file.', + 'object_encryptedFile' => 'Encrypted file.', + 'object_encryptedFile_param_id_type_long' => 'File ID', + 'object_encryptedFile_param_access_hash_type_long' => 'Checking sum depending on user ID', + 'object_encryptedFile_param_size_type_int' => 'File size in bytes', + 'object_encryptedFile_param_dc_id_type_int' => 'Number of data centre', + 'object_encryptedFile_param_key_fingerprint_type_int' => '32-bit fingerprint of key used for file encryption', + 'object_inputEncryptedFileEmpty' => 'Empty constructor.', + 'object_inputEncryptedFileUploaded' => 'Sets new encrypted file saved by parts using upload.saveFilePart method.', + 'object_inputEncryptedFileUploaded_param_id_type_long' => 'Random file ID created by clien', + 'object_inputEncryptedFileUploaded_param_parts_type_int' => 'Number of saved parts', + 'object_inputEncryptedFileUploaded_param_md5_checksum_type_string' => 'In case [md5-HASH](https://en.wikipedia.org/wiki/MD5) of the (already encrypted) file was transmitted, file content will be checked prior to use', + 'object_inputEncryptedFileUploaded_param_key_fingerprint_type_int' => '32-bit fingerprint of the key used to encrypt a file', + 'object_inputEncryptedFile' => 'Sets forwarded encrypted file for attachment.', + 'object_inputEncryptedFile_param_id_type_long' => 'File ID, value of **id** parameter from [encryptedFile](../constructors/encryptedFile.md)', + 'object_inputEncryptedFile_param_access_hash_type_long' => 'Checking sum, value of **access\\_hash** parameter from [encryptedFile](../constructors/encryptedFile.md)', + 'object_inputEncryptedFileBigUploaded' => 'Assigns a new big encrypted file (over 10Mb in size), saved in parts using the method [upload.saveBigFilePart](../methods/upload.saveBigFilePart.md).', + 'object_inputEncryptedFileBigUploaded_param_id_type_long' => 'Random file id, created by the client', + 'object_inputEncryptedFileBigUploaded_param_parts_type_int' => 'Number of saved parts', + 'object_inputEncryptedFileBigUploaded_param_key_fingerprint_type_int' => '32-bit imprint of the key used to encrypt the file', + 'object_encryptedMessage' => 'Encrypted message.', + 'object_encryptedMessage_param_chat_id_type_int' => 'ID of encrypted chat', + 'object_encryptedMessage_param_date_type_int' => 'Date of sending', 'object_encryptedMessage_param_decrypted_message_type_DecryptedMessage' => 'Decrypted message', - 'object_encryptedMessage_param_file_type_EncryptedFile' => 'File', - 'object_encryptedMessageService' => 'Encrypted message service', - 'object_encryptedMessageService_param_chat_id_type_int' => 'Chat ID', - 'object_encryptedMessageService_param_date_type_int' => 'Date', + 'object_encryptedMessage_param_file_type_EncryptedFile' => 'Attached encrypted file', + 'object_encryptedMessageService' => 'Encrypted service message', + 'object_encryptedMessageService_param_chat_id_type_int' => 'ID of encrypted chat', + 'object_encryptedMessageService_param_date_type_int' => 'Date of sending', 'object_encryptedMessageService_param_decrypted_message_type_DecryptedMessage' => 'Decrypted message', - 'object_messages.dhConfigNotModified' => 'Dh config not modified', - 'object_messages.dhConfigNotModified_param_random_type_bytes' => 'Random', - 'object_messages.dhConfig' => 'Dh config', - 'object_messages.dhConfig_param_g_type_int' => 'G', - 'object_messages.dhConfig_param_p_type_bytes' => 'P', - 'object_messages.dhConfig_param_version_type_int' => 'Version', - 'object_messages.dhConfig_param_random_type_bytes' => 'Random', - 'object_messages.sentEncryptedMessage' => 'Sent encrypted message', - 'object_messages.sentEncryptedMessage_param_date_type_int' => 'Date', - 'object_messages.sentEncryptedFile' => 'Sent encrypted file', - 'object_messages.sentEncryptedFile_param_date_type_int' => 'Date', - 'object_messages.sentEncryptedFile_param_file_type_EncryptedFile' => 'File', - 'object_inputDocumentEmpty' => 'Empty input document', - 'object_inputDocument' => 'Document', - 'object_inputDocument_param_id_type_long' => 'ID', - 'object_inputDocument_param_access_hash_type_long' => 'Access hash', - 'object_documentEmpty' => 'Empty document', - 'object_documentEmpty_param_id_type_long' => 'ID', + 'object_messages.dhConfigNotModified' => 'Configuring parameters did not change.', + 'object_messages.dhConfigNotModified_param_random_type_bytes' => 'Random sequence of bytes of assigned length', + 'object_messages.dhConfig' => 'New set of configuring parameters.', + 'object_messages.dhConfig_param_g_type_int' => 'New value **prime**, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange)', + 'object_messages.dhConfig_param_p_type_bytes' => 'New value **primitive root**, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange)', + 'object_messages.dhConfig_param_version_type_int' => 'Vestion of set of parameters', + 'object_messages.dhConfig_param_random_type_bytes' => 'Random sequence of bytes of assigned length', + 'object_messages.sentEncryptedMessage' => 'Message without file attachemts sent to an encrypted file.', + 'object_messages.sentEncryptedMessage_param_date_type_int' => 'Date of sending', + 'object_messages.sentEncryptedFile' => 'Message with a file enclosure sent to a protected chat', + 'object_messages.sentEncryptedFile_param_date_type_int' => 'Sending date', + 'object_messages.sentEncryptedFile_param_file_type_EncryptedFile' => 'Attached file', + 'object_inputDocumentEmpty' => 'Empty constructor.', + 'object_inputDocument' => 'Defines a video for subsequent interaction.', + 'object_inputDocument_param_id_type_long' => 'Document ID', + 'object_inputDocument_param_access_hash_type_long' => '**access\\_hash** parameter from the [document](../constructors/document.md) constructor', + 'object_documentEmpty' => 'Empty constructor, document doesn\'t exist.', + 'object_documentEmpty_param_id_type_long' => 'Document ID or `0`', 'object_document' => 'Document', - 'object_document_param_id_type_long' => 'ID', - 'object_document_param_access_hash_type_long' => 'Access hash', - 'object_document_param_date_type_int' => 'Date', - 'object_document_param_mime_type_type_string' => 'Mime type', + 'object_document_param_id_type_long' => 'Document ID', + 'object_document_param_access_hash_type_long' => 'Check sum, dependant on document ID', + 'object_document_param_date_type_int' => 'Creation date', + 'object_document_param_mime_type_type_string' => 'MIME type', 'object_document_param_size_type_int' => 'Size', 'object_document_param_thumb_type_PhotoSize' => 'Thumbnail', 'object_document_param_dc_id_type_int' => 'DC ID', 'object_document_param_version_type_int' => 'Version', 'object_document_param_attributes_type_Vector t' => 'Attributes', - 'object_help.support' => 'Support', + 'object_help.support' => 'Info on support user.', 'object_help.support_param_phone_number_type_string' => 'Phone number', 'object_help.support_param_user_type_User' => 'User', - 'object_notifyPeer' => 'Notify peer', - 'object_notifyPeer_param_peer_type_Peer' => 'Peer', - 'object_notifyUsers' => 'Notify users', - 'object_notifyChats' => 'Notify chats', + 'object_notifyPeer' => 'Notifications generated by a certain user or group.', + 'object_notifyPeer_param_peer_type_Peer' => 'user or group', + 'object_notifyUsers' => 'Notifications generated by all users.', + 'object_notifyChats' => 'Notifications generated by all groups.', 'object_notifyAll' => 'Notify all', - 'object_sendMessageTypingAction' => 'Send message typing action', - 'object_sendMessageCancelAction' => 'Send message cancel action', - 'object_sendMessageRecordVideoAction' => 'Send message record video action', - 'object_sendMessageUploadVideoAction' => 'Send message upload video action', - 'object_sendMessageUploadVideoAction_param_progress_type_int' => 'Progress', - 'object_sendMessageRecordAudioAction' => 'Send message record audio action', - 'object_sendMessageUploadAudioAction' => 'Send message upload audio action', - 'object_sendMessageUploadAudioAction_param_progress_type_int' => 'Progress', - 'object_sendMessageUploadPhotoAction' => 'Send message upload photo action', - 'object_sendMessageUploadPhotoAction_param_progress_type_int' => 'Progress', - 'object_sendMessageUploadDocumentAction' => 'Send message upload document action', - 'object_sendMessageUploadDocumentAction_param_progress_type_int' => 'Progress', - 'object_sendMessageGeoLocationAction' => 'Send message geo location action', - 'object_sendMessageChooseContactAction' => 'Send message choose contact action', - 'object_sendMessageGamePlayAction' => 'Send message game play action', - 'object_sendMessageRecordRoundAction' => 'Send message record round action', - 'object_sendMessageUploadRoundAction' => 'Send message upload round action', - 'object_sendMessageUploadRoundAction_param_progress_type_int' => 'Progress', - 'object_contacts.found' => 'Found', + 'object_sendMessageTypingAction' => 'User is typing.', + 'object_sendMessageCancelAction' => 'Invalidate all previous action updates. E.g. when user deletes entered text or aborts a video upload.', + 'object_sendMessageRecordVideoAction' => 'User is recording a video.', + 'object_sendMessageUploadVideoAction' => 'User is uploading a video.', + 'object_sendMessageUploadVideoAction_param_progress_type_int' => 'Progress percentage', + 'object_sendMessageRecordAudioAction' => 'User is recording a voice message.', + 'object_sendMessageUploadAudioAction' => 'User is uploading a voice message.', + 'object_sendMessageUploadAudioAction_param_progress_type_int' => 'Progress percentage', + 'object_sendMessageUploadPhotoAction' => 'User is uploading a photo.', + 'object_sendMessageUploadPhotoAction_param_progress_type_int' => 'Progress percentage', + 'object_sendMessageUploadDocumentAction' => 'User is uploading a file.', + 'object_sendMessageUploadDocumentAction_param_progress_type_int' => 'Progress percentage', + 'object_sendMessageGeoLocationAction' => 'User is selecting a location to share.', + 'object_sendMessageChooseContactAction' => 'User is selecting a contact to share.', + 'object_sendMessageGamePlayAction' => 'User is playing a game', + 'object_sendMessageRecordRoundAction' => 'User is recording a round video to share', + 'object_sendMessageUploadRoundAction' => 'User is uploading a round video', + 'object_sendMessageUploadRoundAction_param_progress_type_int' => 'Progress percentage', + 'object_contacts.found' => 'Users found by name substring and auxiliary data.', 'object_contacts.found_param_my_results_type_Vector t' => 'My results', 'object_contacts.found_param_results_type_Vector t' => 'Results', 'object_contacts.found_param_chats_type_Vector t' => 'Chats', 'object_contacts.found_param_users_type_Vector t' => 'Users', - 'object_inputPrivacyKeyStatusTimestamp' => 'Privacy key status timestamp', - 'object_inputPrivacyKeyChatInvite' => 'Privacy key chat invite', - 'object_inputPrivacyKeyPhoneCall' => 'Privacy key phone call', - 'object_privacyKeyStatusTimestamp' => 'Privacy key status timestamp', - 'object_privacyKeyPhoneCall' => 'Privacy key phone call', - 'object_inputPrivacyValueAllowContacts' => 'Privacy value allow contacts', - 'object_inputPrivacyValueAllowAll' => 'Privacy value allow all', - 'object_inputPrivacyValueAllowUsers' => 'Privacy value allow users', + 'object_inputPrivacyKeyStatusTimestamp' => 'Whether we can see the exact last online timestamp of the user', + 'object_inputPrivacyKeyChatInvite' => 'Whether the user can be invited to chats', + 'object_inputPrivacyKeyPhoneCall' => 'Whether the user will accept phone calls', + 'object_privacyKeyStatusTimestamp' => 'Whether we can see the last online timestamp', + 'object_privacyKeyPhoneCall' => 'Whether the user accepts phone calls', + 'object_inputPrivacyValueAllowContacts' => 'Allow only contacts', + 'object_inputPrivacyValueAllowAll' => 'Allow all users', + 'object_inputPrivacyValueAllowUsers' => 'Allow only certain users', 'object_inputPrivacyValueAllowUsers_param_users_type_Vector t' => 'Users', - 'object_inputPrivacyValueDisallowContacts' => 'Privacy value disallow contacts', - 'object_inputPrivacyValueDisallowAll' => 'Privacy value disallow all', - 'object_inputPrivacyValueDisallowUsers' => 'Privacy value disallow users', + 'object_inputPrivacyValueDisallowContacts' => 'Disallow only contacts', + 'object_inputPrivacyValueDisallowAll' => 'Disallow all', + 'object_inputPrivacyValueDisallowUsers' => 'Disallow only certain users', 'object_inputPrivacyValueDisallowUsers_param_users_type_Vector t' => 'Users', - 'object_privacyValueAllowContacts' => 'Privacy value allow contacts', - 'object_privacyValueAllowAll' => 'Privacy value allow all', - 'object_privacyValueAllowUsers' => 'Privacy value allow users', + 'object_privacyValueAllowContacts' => 'Allow all contacts', + 'object_privacyValueAllowAll' => 'Allow all users', + 'object_privacyValueAllowUsers' => 'Allow only certain users', 'object_privacyValueAllowUsers_param_users_type_Vector t' => 'Users', - 'object_privacyValueDisallowContacts' => 'Privacy value disallow contacts', - 'object_privacyValueDisallowAll' => 'Privacy value disallow all', - 'object_privacyValueDisallowUsers' => 'Privacy value disallow users', + 'object_privacyValueDisallowContacts' => 'Disallow only contacts', + 'object_privacyValueDisallowAll' => 'Disallow all users', + 'object_privacyValueDisallowUsers' => 'Disallow only certain users', 'object_privacyValueDisallowUsers_param_users_type_Vector t' => 'Users', 'object_account.privacyRules' => 'Privacy rules', 'object_account.privacyRules_param_rules_type_Vector t' => 'Rules', 'object_account.privacyRules_param_users_type_Vector t' => 'Users', - 'object_accountDaysTTL' => 'Account TTL in days', - 'object_accountDaysTTL_param_days_type_int' => 'Days', - 'object_documentAttributeImageSize' => 'Document attribute image size', - 'object_documentAttributeImageSize_param_w_type_int' => 'Width', - 'object_documentAttributeImageSize_param_h_type_int' => 'Height', - 'object_documentAttributeAnimated' => 'Document attribute animated', - 'object_documentAttributeSticker' => 'Document attribute sticker', - 'object_documentAttributeSticker_param_mask_type_true' => 'Mask?', - 'object_documentAttributeSticker_param_alt_type_string' => 'Alt', - 'object_documentAttributeSticker_param_stickerset_type_InputStickerSet' => 'Stickerset', - 'object_documentAttributeSticker_param_mask_coords_type_MaskCoords' => 'Mask coords', - 'object_documentAttributeVideo' => 'Document attribute video', - 'object_documentAttributeVideo_param_round_message_type_true' => 'Round message?', - 'object_documentAttributeVideo_param_supports_streaming_type_true' => 'Supports streaming?', - 'object_documentAttributeVideo_param_duration_type_int' => 'Duration', - 'object_documentAttributeVideo_param_w_type_int' => 'Width', - 'object_documentAttributeVideo_param_h_type_int' => 'Height', - 'object_documentAttributeAudio' => 'Document attribute audio', - 'object_documentAttributeAudio_param_voice_type_true' => 'Voice?', - 'object_documentAttributeAudio_param_duration_type_int' => 'Duration', - 'object_documentAttributeAudio_param_title_type_string' => 'Title', + 'object_accountDaysTTL' => 'Time to live in days of the current account', + 'object_accountDaysTTL_param_days_type_int' => 'This account will self-destruct in the specified number of days', + 'object_documentAttributeImageSize' => 'Defines the width and height of an image uploaded as document', + 'object_documentAttributeImageSize_param_w_type_int' => 'Width of image', + 'object_documentAttributeImageSize_param_h_type_int' => 'Height of image', + 'object_documentAttributeAnimated' => 'Defines an animated GIF', + 'object_documentAttributeSticker' => 'Defines a sticker', + 'object_documentAttributeSticker_param_mask_type_true' => 'Whether this is a mask sticker', + 'object_documentAttributeSticker_param_alt_type_string' => 'Alternative emoji representation of sticker', + 'object_documentAttributeSticker_param_stickerset_type_InputStickerSet' => 'Associated stickerset', + 'object_documentAttributeSticker_param_mask_coords_type_MaskCoords' => 'Mask coordinates (if this is a mask sticker, attached to a photo)', + 'object_documentAttributeVideo' => 'Defines a video', + 'object_documentAttributeVideo_param_round_message_type_true' => 'Whether this is a round video', + 'object_documentAttributeVideo_param_supports_streaming_type_true' => 'Whether the video supports streaming', + 'object_documentAttributeVideo_param_duration_type_int' => 'Duration in seconds', + 'object_documentAttributeVideo_param_w_type_int' => 'Video width', + 'object_documentAttributeVideo_param_h_type_int' => 'Video height', + 'object_documentAttributeAudio' => 'Represents an audio file', + 'object_documentAttributeAudio_param_voice_type_true' => 'Whether this is a voice message', + 'object_documentAttributeAudio_param_duration_type_int' => 'Duration in seconds', + 'object_documentAttributeAudio_param_title_type_string' => 'Name of song', 'object_documentAttributeAudio_param_performer_type_string' => 'Performer', 'object_documentAttributeAudio_param_waveform_type_bytes' => 'Waveform', - 'object_documentAttributeFilename' => 'Document attribute filename', - 'object_documentAttributeFilename_param_file_name_type_string' => 'File name', - 'object_documentAttributeHasStickers' => 'Document attribute has stickers', - 'object_messages.stickersNotModified' => 'Stickers not modified', - 'object_messages.stickers' => 'Stickers', + 'object_documentAttributeFilename' => 'A simple document with a file name', + 'object_documentAttributeFilename_param_file_name_type_string' => 'The file name', + 'object_documentAttributeHasStickers' => 'Whether the current document has stickers attached', + 'object_messages.stickersNotModified' => 'No new stickers were found for the given query', + 'object_messages.stickers' => 'Found stickers', 'object_messages.stickers_param_hash_type_string' => 'Hash', 'object_messages.stickers_param_stickers_type_Vector t' => 'Stickers', - 'object_stickerPack' => 'Sticker pack', - 'object_stickerPack_param_emoticon_type_string' => 'Emoticon', + 'object_stickerPack' => 'A stickerpack is a group of stickers associated to the same emoji. +It is **not** a sticker pack the way it is usually intended, you may be looking for a [StickerSet](../types/StickerSet.md).', + 'object_stickerPack_param_emoticon_type_string' => 'Emoji', 'object_stickerPack_param_documents_type_Vector t' => 'Documents', - 'object_messages.allStickersNotModified' => 'All stickers not modified', - 'object_messages.allStickers' => 'All stickers', - 'object_messages.allStickers_param_hash_type_int' => 'Hash', + 'object_messages.allStickersNotModified' => 'Info about all installed stickers hasn\'t changed', + 'object_messages.allStickers' => 'Info about all installed stickers', + 'object_messages.allStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', 'object_messages.allStickers_param_sets_type_Vector t' => 'Sets', 'object_disabledFeature' => 'Disabled feature', 'object_disabledFeature_param_feature_type_string' => 'Feature', 'object_disabledFeature_param_description_type_string' => 'Description', - 'object_messages.affectedMessages' => 'Affected messages', - 'object_messages.affectedMessages_param_pts_type_int' => 'Pts', - 'object_messages.affectedMessages_param_pts_count_type_int' => 'Pts count', + 'object_messages.affectedMessages' => 'Events affected by operation', + 'object_messages.affectedMessages_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)', + 'object_messages.affectedMessages_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)', 'object_contactLinkUnknown' => 'Contact link unknown', 'object_contactLinkNone' => 'Contact link none', 'object_contactLinkHasPhone' => 'Contact link has phone', 'object_contactLinkContact' => 'Contact link contact', - 'object_webPageEmpty' => 'Empty web page', - 'object_webPageEmpty_param_id_type_long' => 'ID', - 'object_webPagePending' => 'Web page pending', - 'object_webPagePending_param_id_type_long' => 'ID', - 'object_webPagePending_param_date_type_int' => 'Date', - 'object_webPage' => 'Web page', - 'object_webPage_param_id_type_long' => 'ID', - 'object_webPage_param_url_type_string' => 'URL', - 'object_webPage_param_display_url_type_string' => 'Display URL', - 'object_webPage_param_hash_type_int' => 'Hash', - 'object_webPage_param_type_type_string' => 'Type', - 'object_webPage_param_site_name_type_string' => 'Site name', - 'object_webPage_param_title_type_string' => 'Title', - 'object_webPage_param_description_type_string' => 'Description', - 'object_webPage_param_photo_type_Photo' => 'Photo', - 'object_webPage_param_embed_url_type_string' => 'Embed URL', - 'object_webPage_param_embed_type_type_string' => 'Embed type', - 'object_webPage_param_embed_width_type_int' => 'Embed width', - 'object_webPage_param_embed_height_type_int' => 'Embed height', - 'object_webPage_param_duration_type_int' => 'Duration', - 'object_webPage_param_author_type_string' => 'Author', - 'object_webPage_param_document_type_Document' => 'Document', - 'object_webPage_param_cached_page_type_Page' => 'Cached page', - 'object_webPageNotModified' => 'Web page not modified', - 'object_authorization' => 'Authorization', - 'object_authorization_param_hash_type_long' => 'Hash', + 'object_webPageEmpty' => 'No preview is available for the webpage', + 'object_webPageEmpty_param_id_type_long' => 'Preview ID', + 'object_webPagePending' => 'A preview of the webpage is currently being generated', + 'object_webPagePending_param_id_type_long' => 'ID of preview', + 'object_webPagePending_param_date_type_int' => 'When was the processing started', + 'object_webPage' => 'Webpage preview', + 'object_webPage_param_id_type_long' => 'Preview ID', + 'object_webPage_param_url_type_string' => 'URL of previewed webpage', + 'object_webPage_param_display_url_type_string' => 'Webpage URL to be displayed to the user', + 'object_webPage_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', + 'object_webPage_param_type_type_string' => 'Type of the web page. Can be: article, photo, audio, video, document, profile, app, or something else', + 'object_webPage_param_site_name_type_string' => 'Short name of the site (e.g., Google Docs, App Store)', + 'object_webPage_param_title_type_string' => 'Title of the content', + 'object_webPage_param_description_type_string' => 'Content description', + 'object_webPage_param_photo_type_Photo' => 'Image representing the content', + 'object_webPage_param_embed_url_type_string' => 'URL to show in the embedded preview', + 'object_webPage_param_embed_type_type_string' => 'MIME type of the embedded preview, (e.g., text/html or video/mp4)', + 'object_webPage_param_embed_width_type_int' => 'Width of the embedded preview', + 'object_webPage_param_embed_height_type_int' => 'Height of the embedded preview', + 'object_webPage_param_duration_type_int' => 'Duration of the content, in seconds', + 'object_webPage_param_author_type_string' => 'Author of the content', + 'object_webPage_param_document_type_Document' => 'Preview of the content as a media file', + 'object_webPage_param_cached_page_type_Page' => 'Page contents in [instant view](https://instantview.telegram.org) format', + 'object_webPageNotModified' => 'The preview of the webpage hasn\'t changed', + 'object_authorization' => 'Logged-in session', + 'object_authorization_param_hash_type_long' => 'Identifier', 'object_authorization_param_device_model_type_string' => 'Device model', 'object_authorization_param_platform_type_string' => 'Platform', 'object_authorization_param_system_version_type_string' => 'System version', - 'object_authorization_param_api_id_type_int' => 'Api ID', + 'object_authorization_param_api_id_type_int' => '[API ID](https://core.telegram.org/api/obtaining_api_id)', 'object_authorization_param_app_name_type_string' => 'App name', 'object_authorization_param_app_version_type_string' => 'App version', - 'object_authorization_param_date_created_type_int' => 'Date created', - 'object_authorization_param_date_active_type_int' => 'Date active', - 'object_authorization_param_ip_type_string' => 'Ip', - 'object_authorization_param_country_type_string' => 'Country', - 'object_authorization_param_region_type_string' => 'Region', - 'object_account.authorizations' => 'Authorized clients for this account', + 'object_authorization_param_date_created_type_int' => 'When was the session created', + 'object_authorization_param_date_active_type_int' => 'When was the session last active', + 'object_authorization_param_ip_type_string' => 'Last known IP', + 'object_authorization_param_country_type_string' => 'Country determined from IP', + 'object_authorization_param_region_type_string' => 'Region determined from IP', + 'object_account.authorizations' => 'Logged-in sessions', 'object_account.authorizations_param_authorizations_type_Vector t' => 'Authorizations', 'object_account.noPassword' => 'No password', 'object_account.noPassword_param_new_salt_type_bytes' => 'New salt', 'object_account.noPassword_param_email_unconfirmed_pattern_type_string' => 'Email unconfirmed pattern', - 'object_account.password' => 'Password', + 'object_account.password' => 'Configuration for two-factor authorization', 'object_account.password_param_current_salt_type_bytes' => 'Current salt', 'object_account.password_param_new_salt_type_bytes' => 'New salt', - 'object_account.password_param_hint_type_string' => 'Hint', + 'object_account.password_param_hint_type_string' => 'Text hint for the password', 'object_account.password_param_has_recovery_type_Bool' => 'Has recovery?', - 'object_account.password_param_email_unconfirmed_pattern_type_string' => 'Email unconfirmed pattern', - 'object_account.passwordSettings' => 'Password settings', - 'object_account.passwordSettings_param_email_type_string' => 'Email', - 'object_account.passwordInputSettings' => '2FA password settings', + 'object_account.password_param_email_unconfirmed_pattern_type_string' => 'A [password recovery email](https://core.telegram.org/api/srp#email-verification) with the specified [pattern](https://core.telegram.org/api/pattern) is still awaiting verification', + 'object_account.passwordSettings' => 'Private info associated to the password info (recovery email, telegram [passport](https://core.telegram.org/passport) info & so on)', + 'object_account.passwordSettings_param_email_type_string' => '[2FA Recovery email](https://core.telegram.org/api/srp#email-verification)', + 'object_account.passwordInputSettings' => 'Settings for setting up a new password', 'object_account.passwordInputSettings_param_new_salt_type_bytes' => '`$new_salt = $MadelineProto->account->getPassword()[\'new_salt\'].$MadelineProto->random(8);`', - 'object_account.passwordInputSettings_param_new_password_hash_type_bytes' => '`hash(\'sha256\', $new_salt.$new_password.$new_salt, true)`', - 'object_account.passwordInputSettings_param_hint_type_string' => 'Hint', - 'object_account.passwordInputSettings_param_email_type_string' => 'Email', - 'object_auth.passwordRecovery' => 'Password recovery', - 'object_auth.passwordRecovery_param_email_pattern_type_string' => 'Email pattern', - 'object_receivedNotifyMessage' => 'Received notify message', - 'object_receivedNotifyMessage_param_id_type_int' => 'ID', - 'object_chatInviteEmpty' => 'Empty chat invite', + 'object_account.passwordInputSettings_param_new_password_hash_type_bytes' => 'The [computed password hash](https://core.telegram.org/api/srp)', + 'object_account.passwordInputSettings_param_hint_type_string' => 'Text hint for the password', + 'object_account.passwordInputSettings_param_email_type_string' => 'Password recovery email', + 'object_auth.passwordRecovery' => 'Recovery info of a [2FA password](https://core.telegram.org/api/srp), only for accounts with a [recovery email configured](https://core.telegram.org/api/srp#email-verification).', + 'object_auth.passwordRecovery_param_email_pattern_type_string' => 'The email to which the recovery code was sent must match this [pattern](https://core.telegram.org/api/pattern).', + 'object_receivedNotifyMessage' => 'Message ID, for which PUSH-notifications were cancelled.', + 'object_receivedNotifyMessage_param_id_type_int' => 'Message ID, for which PUSH-notifications were canceled', + 'object_chatInviteEmpty' => 'No info is associated to the chat invite', 'object_chatInviteExported' => 'Exported chat invite', - 'object_chatInviteExported_param_link_type_string' => 'Link', - 'object_chatInviteAlready' => 'Invite of a chat of which I am already member ', - 'object_chatInviteAlready_param_chat_type_Chat' => 'Chat', - 'object_chatInvite' => 'Chat invite', - 'object_chatInvite_param_channel_type_true' => 'Channel?', - 'object_chatInvite_param_broadcast_type_true' => 'Broadcast?', - 'object_chatInvite_param_public_type_true' => 'Public?', - 'object_chatInvite_param_megagroup_type_true' => 'Megagroup?', - 'object_chatInvite_param_title_type_string' => 'Title', + 'object_chatInviteExported_param_link_type_string' => 'Chat invitation link', + 'object_chatInviteAlready' => 'The user has already joined this chat', + 'object_chatInviteAlready_param_chat_type_Chat' => 'The chat connected to the invite', + 'object_chatInvite' => 'Chat invite info', + 'object_chatInvite_param_channel_type_true' => 'Whether this is a [channel/supergroup](https://core.telegram.org/api/channel) or a [normal group](https://core.telegram.org/api/channel)', + 'object_chatInvite_param_broadcast_type_true' => 'Whether this is a [channel](https://core.telegram.org/api/channel)', + 'object_chatInvite_param_public_type_true' => 'Whether this is a public [channel/supergroup](https://core.telegram.org/api/channel)', + 'object_chatInvite_param_megagroup_type_true' => 'Whether this is a [supergroup](https://core.telegram.org/api/channel)', + 'object_chatInvite_param_title_type_string' => 'Chat/supergroup/channel title', 'object_chatInvite_param_photo_type_ChatPhoto' => 'Photo', - 'object_chatInvite_param_participants_count_type_int' => 'Participants count', + 'object_chatInvite_param_participants_count_type_int' => 'Participant count', 'object_chatInvite_param_participants_type_Vector t' => 'Participants', - 'object_inputStickerSetEmpty' => 'Empty input sticker set', - 'object_inputStickerSetID' => 'Sticker set ID', + 'object_inputStickerSetEmpty' => 'Empty constructor', + 'object_inputStickerSetID' => 'Stickerset by ID', 'object_inputStickerSetID_param_id_type_long' => 'ID', 'object_inputStickerSetID_param_access_hash_type_long' => 'Access hash', - 'object_inputStickerSetShortName' => 'Sticker set short name', - 'object_inputStickerSetShortName_param_short_name_type_string' => 'Short name', - 'object_stickerSet' => 'Sticker set', + 'object_inputStickerSetShortName' => 'Stickerset by short name, from `tg://addstickers?set=short_name`', + 'object_inputStickerSetShortName_param_short_name_type_string' => 'From `tg://addstickers?set=short_name`', + 'object_stickerSet' => 'Represents a stickerset (stickerpack)', 'object_stickerSet_param_installed_type_true' => 'Installed?', - 'object_stickerSet_param_archived_type_true' => 'Archived?', - 'object_stickerSet_param_official_type_true' => 'Official?', - 'object_stickerSet_param_masks_type_true' => 'Masks?', - 'object_stickerSet_param_id_type_long' => 'ID', - 'object_stickerSet_param_access_hash_type_long' => 'Access hash', - 'object_stickerSet_param_title_type_string' => 'Title', - 'object_stickerSet_param_short_name_type_string' => 'Short name', - 'object_stickerSet_param_count_type_int' => 'Count', + 'object_stickerSet_param_archived_type_true' => 'Whether this stickerset was archived (due to too many saved stickers in the current account)', + 'object_stickerSet_param_official_type_true' => 'Is this stickerset official', + 'object_stickerSet_param_masks_type_true' => 'Is this a mask stickerset', + 'object_stickerSet_param_id_type_long' => 'ID of the stickerset', + 'object_stickerSet_param_access_hash_type_long' => 'Access hash of stickerset', + 'object_stickerSet_param_title_type_string' => 'Title of stickerset', + 'object_stickerSet_param_short_name_type_string' => 'Short name of stickerset to use in `tg://addstickers?set=short_name`', + 'object_stickerSet_param_count_type_int' => 'Number of stickers in pack', 'object_stickerSet_param_hash_type_int' => 'Hash', - 'object_messages.stickerSet' => 'Sticker set', - 'object_messages.stickerSet_param_set_type_StickerSet' => 'Set', + 'object_messages.stickerSet' => 'Stickerset and stickers inside it', + 'object_messages.stickerSet_param_set_type_StickerSet' => 'The stickerset', 'object_messages.stickerSet_param_packs_type_Vector t' => 'Packs', 'object_messages.stickerSet_param_documents_type_Vector t' => 'Documents', - 'object_botInfo' => 'Bot info', - 'object_botInfo_param_user_id_type_int' => 'User ID', - 'object_botInfo_param_description_type_string' => 'Description', + 'object_botInfo' => 'Info about bots (available bot commands, etc)', + 'object_botInfo_param_user_id_type_int' => 'ID of the bot', + 'object_botInfo_param_description_type_string' => 'Description of the bot', 'object_botInfo_param_commands_type_Vector t' => 'Commands', - 'object_keyboardButton' => 'Keyboard button', - 'object_keyboardButton_param_text_type_string' => 'Text', - 'object_keyboardButtonUrl' => 'Keyboard button URL', - 'object_keyboardButtonUrl_param_text_type_string' => 'Text', + 'object_keyboardButton' => 'Bot keyboard button', + 'object_keyboardButton_param_text_type_string' => 'Button text', + 'object_keyboardButtonUrl' => 'URL button', + 'object_keyboardButtonUrl_param_text_type_string' => 'Button label', 'object_keyboardButtonUrl_param_url_type_string' => 'URL', - 'object_keyboardButtonCallback' => 'Keyboard button callback', - 'object_keyboardButtonCallback_param_text_type_string' => 'Text', - 'object_keyboardButtonCallback_param_data_type_bytes' => 'Data', - 'object_keyboardButtonRequestPhone' => 'Keyboard button request phone', - 'object_keyboardButtonRequestPhone_param_text_type_string' => 'Text', - 'object_keyboardButtonRequestGeoLocation' => 'Keyboard button request geo location', - 'object_keyboardButtonRequestGeoLocation_param_text_type_string' => 'Text', - 'object_keyboardButtonSwitchInline' => 'Keyboard button switch inline', - 'object_keyboardButtonSwitchInline_param_same_peer_type_true' => 'Same peer?', - 'object_keyboardButtonSwitchInline_param_text_type_string' => 'Text', - 'object_keyboardButtonSwitchInline_param_query_type_string' => 'Query', - 'object_keyboardButtonGame' => 'Keyboard button game', - 'object_keyboardButtonGame_param_text_type_string' => 'Text', - 'object_keyboardButtonBuy' => 'Keyboard button buy', - 'object_keyboardButtonBuy_param_text_type_string' => 'Text', - 'object_keyboardButtonRow' => 'Keyboard button row', + 'object_keyboardButtonCallback' => 'Callback button', + 'object_keyboardButtonCallback_param_text_type_string' => 'Button text', + 'object_keyboardButtonCallback_param_data_type_bytes' => 'Callback data', + 'object_keyboardButtonRequestPhone' => 'Button to request a user\'s phone number', + 'object_keyboardButtonRequestPhone_param_text_type_string' => 'Button text', + 'object_keyboardButtonRequestGeoLocation' => 'Button to request a user\'s geolocation', + 'object_keyboardButtonRequestGeoLocation_param_text_type_string' => 'Button text', + 'object_keyboardButtonSwitchInline' => 'Button to force a user to switch to inline mode Pressing the button will prompt the user to select one of their chats, open that chat and insert the bot‘s username and the specified inline query in the input field.', + 'object_keyboardButtonSwitchInline_param_same_peer_type_true' => 'If set, pressing the button will insert the bot‘s username and the specified inline `query` in the current chat\'s input field.', + 'object_keyboardButtonSwitchInline_param_text_type_string' => 'Button label', + 'object_keyboardButtonSwitchInline_param_query_type_string' => 'The inline query to use', + 'object_keyboardButtonGame' => 'Button to start a game', + 'object_keyboardButtonGame_param_text_type_string' => 'Button text', + 'object_keyboardButtonBuy' => 'Button to buy a product', + 'object_keyboardButtonBuy_param_text_type_string' => 'Button text', + 'object_keyboardButtonRow' => 'Inline keyboard row', 'object_keyboardButtonRow_param_buttons_type_Vector t' => 'Buttons', - 'object_replyKeyboardHide' => 'Reply keyboard hide', - 'object_replyKeyboardHide_param_selective_type_true' => 'Selective?', - 'object_replyKeyboardForceReply' => 'Reply keyboard force reply', - 'object_replyKeyboardForceReply_param_single_use_type_true' => 'Single use?', - 'object_replyKeyboardForceReply_param_selective_type_true' => 'Selective?', - 'object_replyKeyboardMarkup' => 'Reply keyboard markup', - 'object_replyKeyboardMarkup_param_resize_type_true' => 'Resize?', - 'object_replyKeyboardMarkup_param_single_use_type_true' => 'Single use?', - 'object_replyKeyboardMarkup_param_selective_type_true' => 'Selective?', + 'object_replyKeyboardHide' => 'Hide sent bot keyboard', + 'object_replyKeyboardHide_param_selective_type_true' => 'Use this flag if you want to remove the keyboard for specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot\'s message is a reply (has reply\\_to\\_message\\_id), sender of the original message.

Example: A user votes in a poll, bot returns confirmation message in reply to the vote and removes the keyboard for that user, while still showing the keyboard with poll options to users who haven\'t voted yet', + 'object_replyKeyboardForceReply' => 'Force the user to send a reply', + 'object_replyKeyboardForceReply_param_single_use_type_true' => 'Requests clients to hide the keyboard as soon as it\'s been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat – the user can press a special button in the input field to see the custom keyboard again.', + 'object_replyKeyboardForceReply_param_selective_type_true' => 'Use this parameter if you want to show the keyboard to specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot\'s message is a reply (has reply\\_to\\_message\\_id), sender of the original message.
Example: A user requests to change the bot‘s language, bot replies to the request with a keyboard to select the new language. Other users in the group don’t see the keyboard.', + 'object_replyKeyboardMarkup' => 'Bot keyboard', + 'object_replyKeyboardMarkup_param_resize_type_true' => 'Requests clients to resize the keyboard vertically for optimal fit (e.g., make the keyboard smaller if there are just two rows of buttons). If not set, the custom keyboard is always of the same height as the app\'s standard keyboard.', + 'object_replyKeyboardMarkup_param_single_use_type_true' => 'Requests clients to hide the keyboard as soon as it\'s been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat – the user can press a special button in the input field to see the custom keyboard again.', + 'object_replyKeyboardMarkup_param_selective_type_true' => 'Use this parameter if you want to show the keyboard to specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot\'s message is a reply (has reply\\_to\\_message\\_id), sender of the original message.

Example: A user requests to change the bot‘s language, bot replies to the request with a keyboard to select the new language. Other users in the group don’t see the keyboard.', 'object_replyKeyboardMarkup_param_rows_type_Vector t' => 'Rows', - 'object_replyInlineMarkup' => 'Reply inline markup', + 'object_replyInlineMarkup' => 'Bot or inline keyboard', 'object_replyInlineMarkup_param_rows_type_Vector t' => 'Rows', - 'object_messageEntityUnknown' => 'Message entity unknown', - 'object_messageEntityUnknown_param_offset_type_int' => 'Offset', - 'object_messageEntityUnknown_param_length_type_int' => 'Length', - 'object_messageEntityMention' => 'Message entity mention', - 'object_messageEntityMention_param_offset_type_int' => 'Offset', - 'object_messageEntityMention_param_length_type_int' => 'Length', - 'object_messageEntityHashtag' => 'Message entity hashtag', - 'object_messageEntityHashtag_param_offset_type_int' => 'Offset', - 'object_messageEntityHashtag_param_length_type_int' => 'Length', - 'object_messageEntityBotCommand' => 'Message entity bot command', - 'object_messageEntityBotCommand_param_offset_type_int' => 'Offset', - 'object_messageEntityBotCommand_param_length_type_int' => 'Length', - 'object_messageEntityUrl' => 'Message entity URL', - 'object_messageEntityUrl_param_offset_type_int' => 'Offset', - 'object_messageEntityUrl_param_length_type_int' => 'Length', - 'object_messageEntityEmail' => 'Message entity email', - 'object_messageEntityEmail_param_offset_type_int' => 'Offset', - 'object_messageEntityEmail_param_length_type_int' => 'Length', - 'object_messageEntityBold' => 'Message entity bold', - 'object_messageEntityBold_param_offset_type_int' => 'Offset', - 'object_messageEntityBold_param_length_type_int' => 'Length', - 'object_messageEntityItalic' => 'Message entity italic', - 'object_messageEntityItalic_param_offset_type_int' => 'Offset', - 'object_messageEntityItalic_param_length_type_int' => 'Length', - 'object_messageEntityCode' => 'Message entity code', - 'object_messageEntityCode_param_offset_type_int' => 'Offset', - 'object_messageEntityCode_param_length_type_int' => 'Length', - 'object_messageEntityPre' => 'Message entity pre', - 'object_messageEntityPre_param_offset_type_int' => 'Offset', - 'object_messageEntityPre_param_length_type_int' => 'Length', - 'object_messageEntityPre_param_language_type_string' => 'Language', - 'object_messageEntityTextUrl' => 'Message entity text URL', - 'object_messageEntityTextUrl_param_offset_type_int' => 'Offset', - 'object_messageEntityTextUrl_param_length_type_int' => 'Length', - 'object_messageEntityTextUrl_param_url_type_string' => 'URL', - 'object_messageEntityMentionName' => 'Message entity mention name', - 'object_messageEntityMentionName_param_offset_type_int' => 'Offset', - 'object_messageEntityMentionName_param_length_type_int' => 'Length', - 'object_messageEntityMentionName_param_user_id_type_int' => 'User ID', - 'object_inputMessageEntityMentionName' => 'Message entity mention name', - 'object_inputMessageEntityMentionName_param_offset_type_int' => 'Offset', - 'object_inputMessageEntityMentionName_param_length_type_int' => 'Length', - 'object_inputMessageEntityMentionName_param_user_id_type_InputUser' => 'User ID', - 'object_inputChannelEmpty' => 'Empty input channel', - 'object_inputChannel' => 'Channel', + 'object_messageEntityUnknown' => 'Unknown message entity', + 'object_messageEntityUnknown_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityUnknown_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityMention' => 'Message entity mentioning the current user', + 'object_messageEntityMention_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityMention_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityHashtag' => '**\\#hashtag** message entity', + 'object_messageEntityHashtag_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityHashtag_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityBotCommand' => 'Message entity representing a bot /command', + 'object_messageEntityBotCommand_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityBotCommand_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityUrl' => 'Message entity representing an in-text url: ; for [text urls](https://google.com), use [messageEntityTextUrl](../constructors/messageEntityTextUrl.md).', + 'object_messageEntityUrl_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityUrl_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityEmail' => 'Message entity representing an .', + 'object_messageEntityEmail_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityEmail_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityBold' => 'Message entity representing **bold text**.', + 'object_messageEntityBold_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityBold_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityItalic' => 'Message entity representing *italic text*.', + 'object_messageEntityItalic_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityItalic_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityCode' => 'Message entity representing a `codeblock`.', + 'object_messageEntityCode_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityCode_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityPre' => 'Message entity representing a preformatted `codeblock`, allowing the user to specify a programming language for the codeblock.', + 'object_messageEntityPre_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityPre_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityPre_param_language_type_string' => 'Programming language of the code', + 'object_messageEntityTextUrl' => 'Message entity representing a [text url](https://google.com): for in-text urls like use [messageEntityUrl](../constructors/messageEntityUrl.md).', + 'object_messageEntityTextUrl_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityTextUrl_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityTextUrl_param_url_type_string' => 'The actual URL', + 'object_messageEntityMentionName' => 'Message entity representing a [user mention](https://t.me/test): for *creating* a mention use [inputMessageEntityMentionName](../constructors/inputMessageEntityMentionName.md).', + 'object_messageEntityMentionName_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityMentionName_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)', + 'object_messageEntityMentionName_param_user_id_type_int' => 'Identifier of the user that was mentioned', + 'object_inputMessageEntityMentionName' => 'Message entity that can be used to create a user [user mention](https://t.me/test): received mentions use the [messageEntityMentionName](../constructors/messageEntityMentionName.md) constructor, instead.', + 'object_inputMessageEntityMentionName_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)', + 'object_inputMessageEntityMentionName_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)', + 'object_inputMessageEntityMentionName_param_user_id_type_InputUser' => 'Identifier of the user that was mentioned', + 'object_inputChannelEmpty' => 'Represents the absence of a channel', + 'object_inputChannel' => 'Represents a channel', 'object_inputChannel_param_channel_id_type_int' => 'Channel ID', - 'object_inputChannel_param_access_hash_type_long' => 'Access hash', + 'object_inputChannel_param_access_hash_type_long' => 'Access hash taken from the [channel](../constructors/channel.md) constructor', 'object_contacts.resolvedPeer' => 'Resolved peer', - 'object_contacts.resolvedPeer_param_peer_type_Peer' => 'Peer', + 'object_contacts.resolvedPeer_param_peer_type_Peer' => 'The peer', 'object_contacts.resolvedPeer_param_chats_type_Vector t' => 'Chats', 'object_contacts.resolvedPeer_param_users_type_Vector t' => 'Users', - 'object_messageRange' => 'Message range', - 'object_messageRange_param_min_id_type_int' => 'Min ID', - 'object_messageRange_param_max_id_type_int' => 'Max ID', - 'object_updates.channelDifferenceEmpty' => 'Empty channel difference', - 'object_updates.channelDifferenceEmpty_param_final_type_true' => 'Final?', - 'object_updates.channelDifferenceEmpty_param_pts_type_int' => 'Pts', - 'object_updates.channelDifferenceEmpty_param_timeout_type_int' => 'Timeout', - 'object_updates.channelDifferenceTooLong' => 'Channel difference too long', - 'object_updates.channelDifferenceTooLong_param_final_type_true' => 'Final?', + 'object_messageRange' => 'Indicates a range of chat messages', + 'object_messageRange_param_min_id_type_int' => 'Start of range (message ID)', + 'object_messageRange_param_max_id_type_int' => 'End of range (message ID)', + 'object_updates.channelDifferenceEmpty' => 'There are no new updates', + 'object_updates.channelDifferenceEmpty_param_final_type_true' => 'Whether there are more updates that must be fetched (always false)', + 'object_updates.channelDifferenceEmpty_param_pts_type_int' => 'The latest [PTS](https://core.telegram.org/api/updates)', + 'object_updates.channelDifferenceEmpty_param_timeout_type_int' => 'Clients are supposed to refetch the channel difference after timeout seconds have elapsed', + 'object_updates.channelDifferenceTooLong' => 'The provided `pts + limit < remote pts`. Simply, there are too many updates to be fetched (more than `limit`), the client has to resolve the update gap in one of the following ways: + +1. Delete all known messages in the chat, begin from scratch by refetching all messages manually with [getHistory](../methods/messages.getHistory.md). It is easy to implement, but suddenly disappearing messages looks awful for the user. +2. Save all messages loaded in the memory until application restart, but delete all messages from database. Messages left in the memory must be lazily updated using calls to [getHistory](../methods/messages.getHistory.md). It looks much smoothly for the user, he will need to redownload messages only after client restart. Unsynchronized messages left in the memory shouldn\'t be saved to database, results of [getHistory](../methods/messages.getHistory.md) and [getMessages](../methods/messages.getMessages.md) must be used to update state of deleted and edited messages left in the memory. +3. Save all messages loaded in the memory and stored in the database without saving that some messages form continuous ranges. Messages in the database will be excluded from results of getChatHistory and searchChatMessages after application restart and will be available only through getMessage. Every message should still be checked using getHistory. It has more disadvantages over 2) than advantages. +4. Save all messages with saving all data about continuous message ranges. Messages from the database may be used as results of getChatHistory and (if implemented continuous ranges support for searching shared media) searchChatMessages. The messages should still be lazily checked using getHistory, but they are still available offline. It is the best way for gaps support, but it is pretty hard to implement correctly. It should be also noted that some messages like live location messages shouldn\'t be deleted.', + 'object_updates.channelDifferenceTooLong_param_final_type_true' => 'Whether there are more updates that must be fetched (always false)', 'object_updates.channelDifferenceTooLong_param_pts_type_int' => 'Pts', - 'object_updates.channelDifferenceTooLong_param_timeout_type_int' => 'Timeout', + 'object_updates.channelDifferenceTooLong_param_timeout_type_int' => 'Clients are supposed to refetch the channel difference after timeout seconds have elapsed', 'object_updates.channelDifferenceTooLong_param_top_message_type_int' => 'Top message', 'object_updates.channelDifferenceTooLong_param_read_inbox_max_id_type_int' => 'Read inbox max ID', 'object_updates.channelDifferenceTooLong_param_read_outbox_max_id_type_int' => 'Read outbox max ID', @@ -2761,110 +2775,110 @@ class Lang 'object_updates.channelDifferenceTooLong_param_messages_type_Vector t' => 'Messages', 'object_updates.channelDifferenceTooLong_param_chats_type_Vector t' => 'Chats', 'object_updates.channelDifferenceTooLong_param_users_type_Vector t' => 'Users', - 'object_updates.channelDifference' => 'Channel difference', - 'object_updates.channelDifference_param_final_type_true' => 'Final?', - 'object_updates.channelDifference_param_pts_type_int' => 'Pts', - 'object_updates.channelDifference_param_timeout_type_int' => 'Timeout', + 'object_updates.channelDifference' => 'The new updates', + 'object_updates.channelDifference_param_final_type_true' => 'Whether there are more updates to be fetched using getDifference, starting from the provided `pts`', + 'object_updates.channelDifference_param_pts_type_int' => 'The [PTS](https://core.telegram.org/api/updates) from which to start getting updates the next time', + 'object_updates.channelDifference_param_timeout_type_int' => 'Clients are supposed to refetch the channel difference after timeout seconds have elapsed', 'object_updates.channelDifference_param_new_messages_type_Vector t' => 'New messages', 'object_updates.channelDifference_param_other_updates_type_Vector t' => 'Other updates', 'object_updates.channelDifference_param_chats_type_Vector t' => 'Chats', 'object_updates.channelDifference_param_users_type_Vector t' => 'Users', - 'object_channelMessagesFilterEmpty' => 'Empty channel messages filter', - 'object_channelMessagesFilter' => 'Channel messages filter', - 'object_channelMessagesFilter_param_exclude_new_messages_type_true' => 'Exclude new messages?', + 'object_channelMessagesFilterEmpty' => 'No filter', + 'object_channelMessagesFilter' => 'Filter for getting only certain types of channel messages', + 'object_channelMessagesFilter_param_exclude_new_messages_type_true' => 'Whether to exclude new messages from the search', 'object_channelMessagesFilter_param_ranges_type_Vector t' => 'Ranges', - 'object_channelParticipant' => 'Channel participant', - 'object_channelParticipant_param_user_id_type_int' => 'User ID', - 'object_channelParticipant_param_date_type_int' => 'Date', - 'object_channelParticipantSelf' => 'Channel participant self', + 'object_channelParticipant' => 'Channel/supergroup participant', + 'object_channelParticipant_param_user_id_type_int' => 'Pariticipant user ID', + 'object_channelParticipant_param_date_type_int' => 'Date joined', + 'object_channelParticipantSelf' => 'Myself', 'object_channelParticipantSelf_param_user_id_type_int' => 'User ID', - 'object_channelParticipantSelf_param_inviter_id_type_int' => 'Inviter ID', - 'object_channelParticipantSelf_param_date_type_int' => 'Date', - 'object_channelParticipantCreator' => 'Channel participant creator', + 'object_channelParticipantSelf_param_inviter_id_type_int' => 'User that invited me to the channel/supergroup', + 'object_channelParticipantSelf_param_date_type_int' => 'When did I join the channel/supergroup', + 'object_channelParticipantCreator' => 'Channel/supergroup creator', 'object_channelParticipantCreator_param_user_id_type_int' => 'User ID', - 'object_channelParticipantAdmin' => 'Channel participant admin', - 'object_channelParticipantAdmin_param_can_edit_type_true' => 'Can edit?', - 'object_channelParticipantAdmin_param_user_id_type_int' => 'User ID', - 'object_channelParticipantAdmin_param_inviter_id_type_int' => 'Inviter ID', - 'object_channelParticipantAdmin_param_promoted_by_type_int' => 'Promoted by', - 'object_channelParticipantAdmin_param_date_type_int' => 'Date', + 'object_channelParticipantAdmin' => 'Admin', + 'object_channelParticipantAdmin_param_can_edit_type_true' => 'Can this admin promote other admins with the same permissions?', + 'object_channelParticipantAdmin_param_user_id_type_int' => 'Admin user ID', + 'object_channelParticipantAdmin_param_inviter_id_type_int' => 'User that invited the admin to the channel/group', + 'object_channelParticipantAdmin_param_promoted_by_type_int' => 'User that promoted the user to admin', + 'object_channelParticipantAdmin_param_date_type_int' => 'When did the user join', 'object_channelParticipantAdmin_param_admin_rights_type_ChannelAdminRights' => 'Admin rights', - 'object_channelParticipantBanned' => 'Channel participant banned', - 'object_channelParticipantBanned_param_left_type_true' => 'Left?', + 'object_channelParticipantBanned' => 'Banned/kicked user', + 'object_channelParticipantBanned_param_left_type_true' => 'Whether the user has left the group', 'object_channelParticipantBanned_param_user_id_type_int' => 'User ID', - 'object_channelParticipantBanned_param_kicked_by_type_int' => 'Kicked by', - 'object_channelParticipantBanned_param_date_type_int' => 'Date', + 'object_channelParticipantBanned_param_kicked_by_type_int' => 'User was kicked by the specified admin', + 'object_channelParticipantBanned_param_date_type_int' => 'When did the user join the group', 'object_channelParticipantBanned_param_banned_rights_type_ChannelBannedRights' => 'Banned rights', - 'object_channelParticipantsRecent' => 'Channel participants recent', - 'object_channelParticipantsAdmins' => 'Channel participants admins', - 'object_channelParticipantsKicked' => 'Channel participants kicked', - 'object_channelParticipantsKicked_param_q_type_string' => 'Query', - 'object_channelParticipantsBots' => 'Channel participants bots', - 'object_channelParticipantsBanned' => 'Channel participants banned', - 'object_channelParticipantsBanned_param_q_type_string' => 'Query', - 'object_channelParticipantsSearch' => 'Channel participants search', - 'object_channelParticipantsSearch_param_q_type_string' => 'Query', - 'object_channels.channelParticipants' => 'Channel participants', - 'object_channels.channelParticipants_param_count_type_int' => 'Count', + 'object_channelParticipantsRecent' => 'Fetch only recent participants', + 'object_channelParticipantsAdmins' => 'Fetch only admin participants', + 'object_channelParticipantsKicked' => 'Fetch only kicked participants', + 'object_channelParticipantsKicked_param_q_type_string' => 'Optional filter for searching kicked participants by name (otherwise empty)', + 'object_channelParticipantsBots' => 'Fetch only bot participants', + 'object_channelParticipantsBanned' => 'Fetch only banned participants', + 'object_channelParticipantsBanned_param_q_type_string' => 'Optional filter for searching banned participants by name (otherwise empty)', + 'object_channelParticipantsSearch' => 'Query participants by name', + 'object_channelParticipantsSearch_param_q_type_string' => 'Search query', + 'object_channels.channelParticipants' => 'Represents multiple channel participants', + 'object_channels.channelParticipants_param_count_type_int' => 'Total number of participants that correspond to the given query', 'object_channels.channelParticipants_param_participants_type_Vector t' => 'Participants', 'object_channels.channelParticipants_param_users_type_Vector t' => 'Users', - 'object_channels.channelParticipantsNotModified' => 'Channel participants not modified', - 'object_channels.channelParticipant' => 'Channel participant', - 'object_channels.channelParticipant_param_participant_type_ChannelParticipant' => 'Participant', + 'object_channels.channelParticipantsNotModified' => 'No new participant info could be found', + 'object_channels.channelParticipant' => 'Represents a channel participant', + 'object_channels.channelParticipant_param_participant_type_ChannelParticipant' => 'The channel participant', 'object_channels.channelParticipant_param_users_type_Vector t' => 'Users', - 'object_help.termsOfService' => 'Terms of service', - 'object_help.termsOfService_param_text_type_string' => 'Text', - 'object_foundGif' => 'Found gif', - 'object_foundGif_param_url_type_string' => 'URL', + 'object_help.termsOfService' => 'Info about the latest telegram Terms Of Service', + 'object_help.termsOfService_param_text_type_string' => 'Text of the new terms', + 'object_foundGif' => 'Found GIF', + 'object_foundGif_param_url_type_string' => 'GIF URL', 'object_foundGif_param_thumb_url_type_string' => 'Thumbnail URL', - 'object_foundGif_param_content_url_type_string' => 'Content URL', - 'object_foundGif_param_content_type_type_string' => 'Content type', - 'object_foundGif_param_w_type_int' => 'Width', - 'object_foundGif_param_h_type_int' => 'Height', - 'object_foundGifCached' => 'Found gif cached', - 'object_foundGifCached_param_url_type_string' => 'URL', - 'object_foundGifCached_param_photo_type_Photo' => 'Photo', - 'object_foundGifCached_param_document_type_Document' => 'Document', - 'object_messages.foundGifs' => 'Found gifs', - 'object_messages.foundGifs_param_next_offset_type_int' => 'Next offset', + 'object_foundGif_param_content_url_type_string' => 'Actual URL of the content to send', + 'object_foundGif_param_content_type_type_string' => 'Content-type of media', + 'object_foundGif_param_w_type_int' => 'Width of GIF', + 'object_foundGif_param_h_type_int' => 'Height of GIF', + 'object_foundGifCached' => 'Found cached results', + 'object_foundGifCached_param_url_type_string' => 'GIF URL', + 'object_foundGifCached_param_photo_type_Photo' => 'Thumbnail', + 'object_foundGifCached_param_document_type_Document' => 'Actual GIF document to send', + 'object_messages.foundGifs' => 'Found GIFs', + 'object_messages.foundGifs_param_next_offset_type_int' => 'Next offset to use when trying to [load more results](../methods/messages.searchGifs.md)', 'object_messages.foundGifs_param_results_type_Vector t' => 'Results', - 'object_messages.savedGifsNotModified' => 'Saved gifs not modified', + 'object_messages.savedGifsNotModified' => 'No new saved gifs were found', 'object_messages.savedGifs' => 'Saved gifs', - 'object_messages.savedGifs_param_hash_type_int' => 'Hash', + 'object_messages.savedGifs_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', 'object_messages.savedGifs_param_gifs_type_Vector t' => 'Gifs', - 'object_inputBotInlineMessageMediaAuto' => 'Bot inline message media auto', - 'object_inputBotInlineMessageMediaAuto_param_message_type_string' => 'Message', + 'object_inputBotInlineMessageMediaAuto' => 'A media', + 'object_inputBotInlineMessageMediaAuto_param_message_type_string' => 'Caption', 'object_inputBotInlineMessageMediaAuto_param_entities_type_Vector t' => 'Entities', - 'object_inputBotInlineMessageMediaAuto_param_reply_markup_type_ReplyMarkup' => 'Reply markup', - 'object_inputBotInlineMessageText' => 'Bot inline message text', - 'object_inputBotInlineMessageText_param_no_webpage_type_true' => 'No webpage?', + 'object_inputBotInlineMessageMediaAuto_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard', + 'object_inputBotInlineMessageText' => 'Simple text message', + 'object_inputBotInlineMessageText_param_no_webpage_type_true' => 'Disable webpage preview', 'object_inputBotInlineMessageText_param_message_type_string' => 'Message', 'object_inputBotInlineMessageText_param_entities_type_Vector t' => 'Entities', - 'object_inputBotInlineMessageText_param_reply_markup_type_ReplyMarkup' => 'Reply markup', - 'object_inputBotInlineMessageMediaGeo' => 'Bot inline message media geo', - 'object_inputBotInlineMessageMediaGeo_param_geo_point_type_InputGeoPoint' => 'Geo point', - 'object_inputBotInlineMessageMediaGeo_param_period_type_int' => 'Period', - 'object_inputBotInlineMessageMediaGeo_param_reply_markup_type_ReplyMarkup' => 'Reply markup', - 'object_inputBotInlineMessageMediaVenue' => 'Bot inline message media venue', - 'object_inputBotInlineMessageMediaVenue_param_geo_point_type_InputGeoPoint' => 'Geo point', - 'object_inputBotInlineMessageMediaVenue_param_title_type_string' => 'Title', + 'object_inputBotInlineMessageText_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard', + 'object_inputBotInlineMessageMediaGeo' => 'Geolocation', + 'object_inputBotInlineMessageMediaGeo_param_geo_point_type_InputGeoPoint' => 'Geolocation', + 'object_inputBotInlineMessageMediaGeo_param_period_type_int' => 'Validity period', + 'object_inputBotInlineMessageMediaGeo_param_reply_markup_type_ReplyMarkup' => 'Reply markup for bot/inline keyboards', + 'object_inputBotInlineMessageMediaVenue' => 'Venue', + 'object_inputBotInlineMessageMediaVenue_param_geo_point_type_InputGeoPoint' => 'Geolocation', + 'object_inputBotInlineMessageMediaVenue_param_title_type_string' => 'Venue name', 'object_inputBotInlineMessageMediaVenue_param_address_type_string' => 'Address', - 'object_inputBotInlineMessageMediaVenue_param_provider_type_string' => 'Provider', - 'object_inputBotInlineMessageMediaVenue_param_venue_id_type_string' => 'Venue ID', - 'object_inputBotInlineMessageMediaVenue_param_reply_markup_type_ReplyMarkup' => 'Reply markup', - 'object_inputBotInlineMessageMediaContact' => 'Bot inline message media contact', + 'object_inputBotInlineMessageMediaVenue_param_provider_type_string' => 'Venue provider: currently only "foursquare" needs to be supported', + 'object_inputBotInlineMessageMediaVenue_param_venue_id_type_string' => 'Venue ID in the provider\'s database', + 'object_inputBotInlineMessageMediaVenue_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard', + 'object_inputBotInlineMessageMediaContact' => 'A contact', 'object_inputBotInlineMessageMediaContact_param_phone_number_type_string' => 'Phone number', 'object_inputBotInlineMessageMediaContact_param_first_name_type_string' => 'First name', 'object_inputBotInlineMessageMediaContact_param_last_name_type_string' => 'Last name', - 'object_inputBotInlineMessageMediaContact_param_reply_markup_type_ReplyMarkup' => 'Reply markup', - 'object_inputBotInlineMessageGame' => 'Bot inline message game', - 'object_inputBotInlineMessageGame_param_reply_markup_type_ReplyMarkup' => 'Reply markup', - 'object_inputBotInlineResult' => 'Bot inline result', - 'object_inputBotInlineResult_param_id_type_string' => 'ID', - 'object_inputBotInlineResult_param_type_type_string' => 'Type', - 'object_inputBotInlineResult_param_title_type_string' => 'Title', - 'object_inputBotInlineResult_param_description_type_string' => 'Description', - 'object_inputBotInlineResult_param_url_type_string' => 'URL', + 'object_inputBotInlineMessageMediaContact_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard', + 'object_inputBotInlineMessageGame' => 'A game', + 'object_inputBotInlineMessageGame_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard', + 'object_inputBotInlineResult' => 'An inline bot result', + 'object_inputBotInlineResult_param_id_type_string' => 'ID of result', + 'object_inputBotInlineResult_param_type_type_string' => 'Result type (see [bot API docs](https://core.telegram.org/bots/api#inlinequeryresult))', + 'object_inputBotInlineResult_param_title_type_string' => 'Result title', + 'object_inputBotInlineResult_param_description_type_string' => 'Result description', + 'object_inputBotInlineResult_param_url_type_string' => 'URL of result', 'object_inputBotInlineResult_param_thumb_url_type_string' => 'Thumbnail URL', 'object_inputBotInlineResult_param_content_url_type_string' => 'Content URL', 'object_inputBotInlineResult_param_content_type_type_string' => 'Content type', @@ -2872,53 +2886,53 @@ class Lang 'object_inputBotInlineResult_param_h_type_int' => 'Height', 'object_inputBotInlineResult_param_duration_type_int' => 'Duration', 'object_inputBotInlineResult_param_sendMessage_type_InputBotInlineMessage' => 'Message to send', - 'object_inputBotInlineResultPhoto' => 'Bot inline result photo', - 'object_inputBotInlineResultPhoto_param_id_type_string' => 'ID', - 'object_inputBotInlineResultPhoto_param_type_type_string' => 'Type', - 'object_inputBotInlineResultPhoto_param_photo_type_InputPhoto' => 'Photo', + 'object_inputBotInlineResultPhoto' => 'Photo', + 'object_inputBotInlineResultPhoto_param_id_type_string' => 'Result ID', + 'object_inputBotInlineResultPhoto_param_type_type_string' => 'Result type (see [bot API docs](https://core.telegram.org/bots/api#inlinequeryresult))', + 'object_inputBotInlineResultPhoto_param_photo_type_InputPhoto' => 'Photo to send', 'object_inputBotInlineResultPhoto_param_sendMessage_type_InputBotInlineMessage' => 'Message to send', - 'object_inputBotInlineResultDocument' => 'Bot inline result document', - 'object_inputBotInlineResultDocument_param_id_type_string' => 'ID', - 'object_inputBotInlineResultDocument_param_type_type_string' => 'Type', - 'object_inputBotInlineResultDocument_param_title_type_string' => 'Title', - 'object_inputBotInlineResultDocument_param_description_type_string' => 'Description', - 'object_inputBotInlineResultDocument_param_document_type_InputDocument' => 'Document', + 'object_inputBotInlineResultDocument' => 'Document (media of any type except for photos)', + 'object_inputBotInlineResultDocument_param_id_type_string' => 'Result ID', + 'object_inputBotInlineResultDocument_param_type_type_string' => 'Result type (see [bot API docs](https://core.telegram.org/bots/api#inlinequeryresult))', + 'object_inputBotInlineResultDocument_param_title_type_string' => 'Result title', + 'object_inputBotInlineResultDocument_param_description_type_string' => 'Result description', + 'object_inputBotInlineResultDocument_param_document_type_InputDocument' => 'Document to send', 'object_inputBotInlineResultDocument_param_sendMessage_type_InputBotInlineMessage' => 'Message to send', - 'object_inputBotInlineResultGame' => 'Bot inline result game', - 'object_inputBotInlineResultGame_param_id_type_string' => 'ID', - 'object_inputBotInlineResultGame_param_short_name_type_string' => 'Short name', + 'object_inputBotInlineResultGame' => 'Game', + 'object_inputBotInlineResultGame_param_id_type_string' => 'Result ID', + 'object_inputBotInlineResultGame_param_short_name_type_string' => 'Game short name', 'object_inputBotInlineResultGame_param_sendMessage_type_InputBotInlineMessage' => 'Message to send', - 'object_botInlineMessageMediaAuto' => 'Bot inline message media auto', - 'object_botInlineMessageMediaAuto_param_message_type_string' => 'Message', + 'object_botInlineMessageMediaAuto' => 'Send whatever media is attached to the [botInlineMediaResult](../constructors/botInlineMediaResult.md)', + 'object_botInlineMessageMediaAuto_param_message_type_string' => 'Caption', 'object_botInlineMessageMediaAuto_param_entities_type_Vector t' => 'Entities', - 'object_botInlineMessageMediaAuto_param_reply_markup_type_ReplyMarkup' => 'Reply markup', - 'object_botInlineMessageText' => 'Bot inline message text', - 'object_botInlineMessageText_param_no_webpage_type_true' => 'No webpage?', - 'object_botInlineMessageText_param_message_type_string' => 'Message', + 'object_botInlineMessageMediaAuto_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard', + 'object_botInlineMessageText' => 'Send a simple text message', + 'object_botInlineMessageText_param_no_webpage_type_true' => 'Disable webpage preview', + 'object_botInlineMessageText_param_message_type_string' => 'The message', 'object_botInlineMessageText_param_entities_type_Vector t' => 'Entities', - 'object_botInlineMessageText_param_reply_markup_type_ReplyMarkup' => 'Reply markup', - 'object_botInlineMessageMediaGeo' => 'Bot inline message media geo', - 'object_botInlineMessageMediaGeo_param_geo_type_GeoPoint' => 'Geo', - 'object_botInlineMessageMediaGeo_param_period_type_int' => 'Period', - 'object_botInlineMessageMediaGeo_param_reply_markup_type_ReplyMarkup' => 'Reply markup', - 'object_botInlineMessageMediaVenue' => 'Bot inline message media venue', - 'object_botInlineMessageMediaVenue_param_geo_type_GeoPoint' => 'Geo', - 'object_botInlineMessageMediaVenue_param_title_type_string' => 'Title', + 'object_botInlineMessageText_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard', + 'object_botInlineMessageMediaGeo' => 'Send a geolocation', + 'object_botInlineMessageMediaGeo_param_geo_type_GeoPoint' => 'Geolocation', + 'object_botInlineMessageMediaGeo_param_period_type_int' => 'Validity period', + 'object_botInlineMessageMediaGeo_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard', + 'object_botInlineMessageMediaVenue' => 'Send a venue', + 'object_botInlineMessageMediaVenue_param_geo_type_GeoPoint' => 'Geolocation of venue', + 'object_botInlineMessageMediaVenue_param_title_type_string' => 'Venue name', 'object_botInlineMessageMediaVenue_param_address_type_string' => 'Address', - 'object_botInlineMessageMediaVenue_param_provider_type_string' => 'Provider', - 'object_botInlineMessageMediaVenue_param_venue_id_type_string' => 'Venue ID', - 'object_botInlineMessageMediaVenue_param_reply_markup_type_ReplyMarkup' => 'Reply markup', - 'object_botInlineMessageMediaContact' => 'Bot inline message media contact', + 'object_botInlineMessageMediaVenue_param_provider_type_string' => 'Venue provider: currently only "foursquare" needs to be supported', + 'object_botInlineMessageMediaVenue_param_venue_id_type_string' => 'Venue ID in the provider\'s database', + 'object_botInlineMessageMediaVenue_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard', + 'object_botInlineMessageMediaContact' => 'Send a contact', 'object_botInlineMessageMediaContact_param_phone_number_type_string' => 'Phone number', 'object_botInlineMessageMediaContact_param_first_name_type_string' => 'First name', 'object_botInlineMessageMediaContact_param_last_name_type_string' => 'Last name', - 'object_botInlineMessageMediaContact_param_reply_markup_type_ReplyMarkup' => 'Reply markup', - 'object_botInlineResult' => 'Bot inline result', - 'object_botInlineResult_param_id_type_string' => 'ID', - 'object_botInlineResult_param_type_type_string' => 'Type', - 'object_botInlineResult_param_title_type_string' => 'Title', - 'object_botInlineResult_param_description_type_string' => 'Description', - 'object_botInlineResult_param_url_type_string' => 'URL', + 'object_botInlineMessageMediaContact_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard', + 'object_botInlineResult' => 'Generic result', + 'object_botInlineResult_param_id_type_string' => 'Result ID', + 'object_botInlineResult_param_type_type_string' => 'Result type (see [bot API docs](https://core.telegram.org/bots/api#inlinequeryresult))', + 'object_botInlineResult_param_title_type_string' => 'Result title', + 'object_botInlineResult_param_description_type_string' => 'Result description', + 'object_botInlineResult_param_url_type_string' => 'URL of article or webpage', 'object_botInlineResult_param_thumb_url_type_string' => 'Thumbnail URL', 'object_botInlineResult_param_content_url_type_string' => 'Content URL', 'object_botInlineResult_param_content_type_type_string' => 'Content type', @@ -2926,222 +2940,229 @@ class Lang 'object_botInlineResult_param_h_type_int' => 'Height', 'object_botInlineResult_param_duration_type_int' => 'Duration', 'object_botInlineResult_param_sendMessage_type_BotInlineMessage' => 'Message to send', - 'object_botInlineMediaResult' => 'Bot inline media result', - 'object_botInlineMediaResult_param_id_type_string' => 'ID', - 'object_botInlineMediaResult_param_type_type_string' => 'Type', - 'object_botInlineMediaResult_param_photo_type_Photo' => 'Photo', - 'object_botInlineMediaResult_param_document_type_Document' => 'Document', - 'object_botInlineMediaResult_param_title_type_string' => 'Title', + 'object_botInlineMediaResult' => 'Media result', + 'object_botInlineMediaResult_param_id_type_string' => 'Result ID', + 'object_botInlineMediaResult_param_type_type_string' => 'Result type (see [bot API docs](https://core.telegram.org/bots/api#inlinequeryresult))', + 'object_botInlineMediaResult_param_photo_type_Photo' => 'If type is `photo`, the photo to send', + 'object_botInlineMediaResult_param_document_type_Document' => 'If type is `document`, the document to send', + 'object_botInlineMediaResult_param_title_type_string' => 'Result title', 'object_botInlineMediaResult_param_description_type_string' => 'Description', 'object_botInlineMediaResult_param_sendMessage_type_BotInlineMessage' => 'Send message', - 'object_messages.botResults' => 'Bot results', - 'object_messages.botResults_param_gallery_type_true' => 'Gallery?', + 'object_messages.botResults' => 'Result of a query to an inline bot', + 'object_messages.botResults_param_gallery_type_true' => 'Whether the result is a picture gallery', 'object_messages.botResults_param_query_id_type_long' => 'Query ID', - 'object_messages.botResults_param_next_offset_type_string' => 'Next offset', - 'object_messages.botResults_param_switch_pm_type_InlineBotSwitchPM' => 'Switch pm', + 'object_messages.botResults_param_next_offset_type_string' => 'The next offset to use when navigating through results', + 'object_messages.botResults_param_switch_pm_type_InlineBotSwitchPM' => 'Whether the bot requested the user to message him in private', 'object_messages.botResults_param_results_type_Vector t' => 'Results', - 'object_messages.botResults_param_cache_time_type_int' => 'Cache time', + 'object_messages.botResults_param_cache_time_type_int' => 'Caching validity of the results', 'object_messages.botResults_param_users_type_Vector t' => 'Users', - 'object_exportedMessageLink' => 'Exported message link', - 'object_exportedMessageLink_param_link_type_string' => 'Link', - 'object_exportedMessageLink_param_html_type_string' => 'Html', - 'object_messageFwdHeader' => 'Forwarded message info', - 'object_messageFwdHeader_param_from_id_type_int' => 'From ID', - 'object_messageFwdHeader_param_date_type_int' => 'Date', - 'object_messageFwdHeader_param_channel_id_type_int' => 'Channel ID', - 'object_messageFwdHeader_param_channel_post_type_int' => 'Channel post', - 'object_messageFwdHeader_param_post_author_type_string' => 'Post author', - 'object_messageFwdHeader_param_saved_from_peer_type_Peer' => 'Saved from peer', - 'object_messageFwdHeader_param_saved_from_msg_id_type_int' => 'Saved from msg ID', - 'object_auth.codeTypeSms' => 'Auth code type: SMS', - 'object_auth.codeTypeCall' => 'Auth code type: call', - 'object_auth.codeTypeFlashCall' => 'Auth code type: flash call', - 'object_auth.sentCodeTypeApp' => 'Sent code type app', - 'object_auth.sentCodeTypeApp_param_length_type_int' => 'Length', - 'object_auth.sentCodeTypeSms' => 'Sent code type sms', - 'object_auth.sentCodeTypeSms_param_length_type_int' => 'Length', - 'object_auth.sentCodeTypeCall' => 'Sent code type call', - 'object_auth.sentCodeTypeCall_param_length_type_int' => 'Length', - 'object_auth.sentCodeTypeFlashCall' => 'Sent code type flash call', - 'object_auth.sentCodeTypeFlashCall_param_pattern_type_string' => 'Pattern', - 'object_messages.botCallbackAnswer' => 'Bot callback answer', - 'object_messages.botCallbackAnswer_param_alert_type_true' => 'Alert?', - 'object_messages.botCallbackAnswer_param_has_url_type_true' => 'Has URL?', - 'object_messages.botCallbackAnswer_param_native_ui_type_true' => 'Native ui?', - 'object_messages.botCallbackAnswer_param_message_type_string' => 'Message', - 'object_messages.botCallbackAnswer_param_url_type_string' => 'URL', - 'object_messages.botCallbackAnswer_param_cache_time_type_int' => 'Cache time', - 'object_messages.messageEditData' => 'Message edit data', - 'object_messages.messageEditData_param_caption_type_true' => 'Caption?', - 'object_inputBotInlineMessageID' => 'Bot inline message ID', - 'object_inputBotInlineMessageID_param_dc_id_type_int' => 'DC ID', - 'object_inputBotInlineMessageID_param_id_type_long' => 'ID', - 'object_inputBotInlineMessageID_param_access_hash_type_long' => 'Access hash', - 'object_inlineBotSwitchPM' => 'Inline bot switch pm', - 'object_inlineBotSwitchPM_param_text_type_string' => 'Text', - 'object_inlineBotSwitchPM_param_start_param_type_string' => 'Start param', - 'object_messages.peerDialogs' => 'Peer dialogs', + 'object_exportedMessageLink' => 'Link to a message in a supergroup/channel', + 'object_exportedMessageLink_param_link_type_string' => 'URL', + 'object_exportedMessageLink_param_html_type_string' => 'Embed code', + 'object_messageFwdHeader' => 'Info about a forwarded message', + 'object_messageFwdHeader_param_from_id_type_int' => 'The ID of the user that originally sent the message', + 'object_messageFwdHeader_param_date_type_int' => 'When was the message originally sent', + 'object_messageFwdHeader_param_channel_id_type_int' => 'ID of the channel from which the message was forwarded', + 'object_messageFwdHeader_param_channel_post_type_int' => 'ID of the channel message that was forwarded', + 'object_messageFwdHeader_param_post_author_type_string' => 'For channels and if signatures are enabled, author of the channel message', + 'object_messageFwdHeader_param_saved_from_peer_type_Peer' => 'Only for messages forwarded to the current user (inputPeerSelf), full info about the user/channel that originally sent the message', + 'object_messageFwdHeader_param_saved_from_msg_id_type_int' => 'Only for messages forwarded to the current user (inputPeerSelf), ID of the message that was forwarded from the original user/channel', + 'object_auth.codeTypeSms' => 'Type of verification code that will be sent next if you call the resendCode method: SMS code', + 'object_auth.codeTypeCall' => 'Type of verification code that will be sent next if you call the resendCode method: SMS code', + 'object_auth.codeTypeFlashCall' => 'Type of verification code that will be sent next if you call the resendCode method: SMS code', + 'object_auth.sentCodeTypeApp' => 'The code was sent through the telegram app', + 'object_auth.sentCodeTypeApp_param_length_type_int' => 'Length of the code in bytes', + 'object_auth.sentCodeTypeSms' => 'The code was sent via SMS', + 'object_auth.sentCodeTypeSms_param_length_type_int' => 'Length of the code in bytes', + 'object_auth.sentCodeTypeCall' => 'The code will be sent via a phone call: a synthesized voice will tell the user which verification code to input.', + 'object_auth.sentCodeTypeCall_param_length_type_int' => 'Length of the verification code', + 'object_auth.sentCodeTypeFlashCall' => 'The code will be sent via a flash phone call, that will be closed immediately. The phone code will then be the phone number itself, just make sure that the phone number matches the specified pattern.', + 'object_auth.sentCodeTypeFlashCall_param_pattern_type_string' => '[pattern](https://core.telegram.org/api/pattern) to match', + 'object_messages.botCallbackAnswer' => 'Callback answer sent by the bot in response to a button press', + 'object_messages.botCallbackAnswer_param_alert_type_true' => 'Whether an alert should be shown to the user instead of a toast notification', + 'object_messages.botCallbackAnswer_param_has_url_type_true' => 'Whether an URL is present', + 'object_messages.botCallbackAnswer_param_native_ui_type_true' => 'Whether to show games in WebView or in native UI.', + 'object_messages.botCallbackAnswer_param_message_type_string' => 'Alert to show', + 'object_messages.botCallbackAnswer_param_url_type_string' => 'URL to open', + 'object_messages.botCallbackAnswer_param_cache_time_type_int' => 'For how long should this answer be cached', + 'object_messages.messageEditData' => 'Message edit data for media', + 'object_messages.messageEditData_param_caption_type_true' => 'Media caption, if the specified media\'s caption can be edited', + 'object_inputBotInlineMessageID' => 'Represents a sent inline message from the perspective of a bot', + 'object_inputBotInlineMessageID_param_dc_id_type_int' => 'DC ID to use when working with this inline message', + 'object_inputBotInlineMessageID_param_id_type_long' => 'ID of message', + 'object_inputBotInlineMessageID_param_access_hash_type_long' => 'Access hash of message', + 'object_inlineBotSwitchPM' => 'The bot requested the user to message him in private', + 'object_inlineBotSwitchPM_param_text_type_string' => 'Text for the button that switches the user to a private chat with the bot and sends the bot a start message with the parameter `start_parameter` (can be empty)', + 'object_inlineBotSwitchPM_param_start_param_type_string' => 'The parameter for the `/start parameter`', + 'object_messages.peerDialogs' => 'Dialog info of multiple peers', 'object_messages.peerDialogs_param_dialogs_type_Vector t' => 'Dialogs', 'object_messages.peerDialogs_param_messages_type_Vector t' => 'Messages', 'object_messages.peerDialogs_param_chats_type_Vector t' => 'Chats', 'object_messages.peerDialogs_param_users_type_Vector t' => 'Users', - 'object_messages.peerDialogs_param_state_type_updates.State' => 'State', + 'object_messages.peerDialogs_param_state_type_updates.State' => 'Current [update state of dialog](https://core.telegram.org/api/updates)', 'object_topPeer' => 'Top peer', 'object_topPeer_param_peer_type_Peer' => 'Peer', - 'object_topPeer_param_rating_type_double' => 'Rating', - 'object_topPeerCategoryBotsPM' => 'Top peer category bots pm', - 'object_topPeerCategoryBotsInline' => 'Top peer category bots inline', - 'object_topPeerCategoryCorrespondents' => 'Top peer category correspondents', - 'object_topPeerCategoryGroups' => 'Top peer category groups', - 'object_topPeerCategoryChannels' => 'Top peer category channels', - 'object_topPeerCategoryPhoneCalls' => 'Top peer category phone calls', - 'object_topPeerCategoryPeers' => 'Top peer category peers', - 'object_topPeerCategoryPeers_param_category_type_TopPeerCategory' => 'Category', - 'object_topPeerCategoryPeers_param_count_type_int' => 'Count', + 'object_topPeer_param_rating_type_double' => 'Rating as computer in [top peer rating »](https://core.telegram.org/api/top-rating)', + 'object_topPeerCategoryBotsPM' => 'Most used bots', + 'object_topPeerCategoryBotsInline' => 'Most used inline bots', + 'object_topPeerCategoryCorrespondents' => 'Users we\'ve chatted most frequently with', + 'object_topPeerCategoryGroups' => 'Often-opened groups and supergroups', + 'object_topPeerCategoryChannels' => 'Most frequently visited channels', + 'object_topPeerCategoryPhoneCalls' => 'Most frequently called users', + 'object_topPeerCategoryPeers' => 'Top peer category', + 'object_topPeerCategoryPeers_param_category_type_TopPeerCategory' => 'Top peer category of peers', + 'object_topPeerCategoryPeers_param_count_type_int' => 'Count of peers', 'object_topPeerCategoryPeers_param_peers_type_Vector t' => 'Peers', - 'object_contacts.topPeersNotModified' => 'Top peers not modified', + 'object_contacts.topPeersNotModified' => 'Top peer info hasn\'t changed', 'object_contacts.topPeers' => 'Top peers', 'object_contacts.topPeers_param_categories_type_Vector t' => 'Categories', 'object_contacts.topPeers_param_chats_type_Vector t' => 'Chats', 'object_contacts.topPeers_param_users_type_Vector t' => 'Users', - 'object_draftMessageEmpty' => 'Empty draft message', - 'object_draftMessage' => 'Draft message', - 'object_draftMessage_param_no_webpage_type_true' => 'No webpage?', - 'object_draftMessage_param_reply_to_msg_id_type_int' => 'Reply to msg ID', - 'object_draftMessage_param_message_type_string' => 'Message', + 'object_draftMessageEmpty' => 'Empty draft', + 'object_draftMessage' => 'Represents a message [draft](https://core.telegram.org/api/drafts).', + 'object_draftMessage_param_no_webpage_type_true' => 'Whether no webpage preview will be generated', + 'object_draftMessage_param_reply_to_msg_id_type_int' => 'The message this message will reply to', + 'object_draftMessage_param_message_type_string' => 'The draft', 'object_draftMessage_param_entities_type_Vector t' => 'Entities', - 'object_draftMessage_param_date_type_int' => 'Date', - 'object_messages.featuredStickersNotModified' => 'Featured stickers not modified', - 'object_messages.featuredStickers' => 'Featured stickers', - 'object_messages.featuredStickers_param_hash_type_int' => 'Hash', + 'object_draftMessage_param_date_type_int' => 'Date of last update of the draft.', + 'object_messages.featuredStickersNotModified' => 'Featured stickers haven\'t changed', + 'object_messages.featuredStickers' => 'Featured stickersets', + 'object_messages.featuredStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', 'object_messages.featuredStickers_param_sets_type_Vector t' => 'Sets', 'object_messages.featuredStickers_param_unread_type_Vector t' => 'Unread', - 'object_messages.recentStickersNotModified' => 'Recent stickers not modified', - 'object_messages.recentStickers' => 'Recent stickers', - 'object_messages.recentStickers_param_hash_type_int' => 'Hash', + 'object_messages.recentStickersNotModified' => 'No new recent sticker was found', + 'object_messages.recentStickers' => 'Recently used stickers', + 'object_messages.recentStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', 'object_messages.recentStickers_param_stickers_type_Vector t' => 'Stickers', - 'object_messages.archivedStickers' => 'Archived stickers', - 'object_messages.archivedStickers_param_count_type_int' => 'Count', + 'object_messages.archivedStickers' => 'Archived stickersets', + 'object_messages.archivedStickers_param_count_type_int' => 'Number of archived stickers', 'object_messages.archivedStickers_param_sets_type_Vector t' => 'Sets', - 'object_messages.stickerSetInstallResultSuccess' => 'Sticker set install result success', - 'object_messages.stickerSetInstallResultArchive' => 'Sticker set install result archive', + 'object_messages.stickerSetInstallResultSuccess' => 'The stickerset was installed successfully', + 'object_messages.stickerSetInstallResultArchive' => 'The stickerset was installed, but since there are too many stickersets some were archived', 'object_messages.stickerSetInstallResultArchive_param_sets_type_Vector t' => 'Sets', - 'object_stickerSetCovered' => 'Sticker set covered', - 'object_stickerSetCovered_param_set_type_StickerSet' => 'Set', - 'object_stickerSetCovered_param_cover_type_Document' => 'Cover', - 'object_stickerSetMultiCovered' => 'Sticker set multi covered', - 'object_stickerSetMultiCovered_param_set_type_StickerSet' => 'Set', + 'object_stickerSetCovered' => 'Stickerset, with a specific sticker as preview', + 'object_stickerSetCovered_param_set_type_StickerSet' => 'Stickerset', + 'object_stickerSetCovered_param_cover_type_Document' => 'Preview', + 'object_stickerSetMultiCovered' => 'Stickerset, with a specific stickers as preview', + 'object_stickerSetMultiCovered_param_set_type_StickerSet' => 'Stickerset', 'object_stickerSetMultiCovered_param_covers_type_Vector t' => 'Covers', - 'object_maskCoords' => 'Mask coords', - 'object_maskCoords_param_n_type_int' => 'N', - 'object_maskCoords_param_x_type_double' => 'X', - 'object_maskCoords_param_y_type_double' => 'Y', - 'object_maskCoords_param_zoom_type_double' => 'Zoom', - 'object_inputStickeredMediaPhoto' => 'Stickered media photo', - 'object_inputStickeredMediaPhoto_param_id_type_InputPhoto' => 'ID', - 'object_inputStickeredMediaDocument' => 'Stickered media document', - 'object_inputStickeredMediaDocument_param_id_type_InputDocument' => 'ID', - 'object_game' => 'Game', - 'object_game_param_id_type_long' => 'ID', - 'object_game_param_access_hash_type_long' => 'Access hash', - 'object_game_param_short_name_type_string' => 'Short name', - 'object_game_param_title_type_string' => 'Title', - 'object_game_param_description_type_string' => 'Description', - 'object_game_param_photo_type_Photo' => 'Photo', - 'object_game_param_document_type_Document' => 'Document', - 'object_inputGameID' => 'Game ID', - 'object_inputGameID_param_id_type_long' => 'ID', - 'object_inputGameID_param_access_hash_type_long' => 'Access hash', - 'object_inputGameShortName' => 'Game short name', - 'object_inputGameShortName_param_bot_id_type_InputUser' => 'Bot ID', - 'object_inputGameShortName_param_short_name_type_string' => 'Short name', - 'object_highScore' => 'High score', - 'object_highScore_param_pos_type_int' => 'Pos', + 'object_maskCoords' => 'Position on a photo where a mask should be placed + +The `n` position indicates where the mask should be placed: + +- 0 => Relative to the forehead +- 1 => Relative to the eyes +- 2 => Relative to the mouth +- 3 => Relative to the chin', + 'object_maskCoords_param_n_type_int' => 'Part of the face, relative to which the mask should be placed', + 'object_maskCoords_param_x_type_double' => 'Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. (For example, -1.0 will place the mask just to the left of the default mask position)', + 'object_maskCoords_param_y_type_double' => 'Shift by Y-axis measured in widths of the mask scaled to the face size, from left to right. (For example, -1.0 will place the mask just to the left of the default mask position)', + 'object_maskCoords_param_zoom_type_double' => 'Mask scaling coefficient. (For example, 2.0 means a doubled size)', + 'object_inputStickeredMediaPhoto' => 'A photo with stickers attached', + 'object_inputStickeredMediaPhoto_param_id_type_InputPhoto' => 'The photo', + 'object_inputStickeredMediaDocument' => 'A document with stickers attached', + 'object_inputStickeredMediaDocument_param_id_type_InputDocument' => 'The document', + 'object_game' => 'Indicates an already sent game', + 'object_game_param_id_type_long' => 'ID of the game', + 'object_game_param_access_hash_type_long' => 'Access hash of the game', + 'object_game_param_short_name_type_string' => 'Short name for the game', + 'object_game_param_title_type_string' => 'Title of the game', + 'object_game_param_description_type_string' => 'Game description', + 'object_game_param_photo_type_Photo' => 'Game preview', + 'object_game_param_document_type_Document' => 'Optional attached document', + 'object_inputGameID' => 'Indicates an already sent game', + 'object_inputGameID_param_id_type_long' => 'game ID from [Game](../types/Game.md) constructor', + 'object_inputGameID_param_access_hash_type_long' => 'access hash from [Game](../types/Game.md) constructor', + 'object_inputGameShortName' => 'Game by short name', + 'object_inputGameShortName_param_bot_id_type_InputUser' => 'The bot that provides the game', + 'object_inputGameShortName_param_short_name_type_string' => 'The game\'s short name', + 'object_highScore' => 'Game highscore', + 'object_highScore_param_pos_type_int' => 'Position in highscore list', 'object_highScore_param_user_id_type_int' => 'User ID', 'object_highScore_param_score_type_int' => 'Score', - 'object_messages.highScores' => 'High scores', + 'object_messages.highScores' => 'Highscores in a game', 'object_messages.highScores_param_scores_type_Vector t' => 'Scores', 'object_messages.highScores_param_users_type_Vector t' => 'Users', - 'object_textEmpty' => 'Empty text', - 'object_textPlain' => 'Text plain', + 'object_textEmpty' => 'Empty rich text element', + 'object_textPlain' => 'Plain text', 'object_textPlain_param_text_type_string' => 'Text', - 'object_textBold' => 'Text bold', + 'object_textBold' => '**Bold** text', 'object_textBold_param_text_type_RichText' => 'Text', - 'object_textItalic' => 'Text italic', + 'object_textItalic' => '*Italic* text', 'object_textItalic_param_text_type_RichText' => 'Text', - 'object_textUnderline' => 'Text underline', + 'object_textUnderline' => 'Underlined text', 'object_textUnderline_param_text_type_RichText' => 'Text', - 'object_textStrike' => 'Text strike', + 'object_textStrike' => 'Strikethrough text', 'object_textStrike_param_text_type_RichText' => 'Text', - 'object_textFixed' => 'Text fixed', + 'object_textFixed' => '`fixed-width` rich text', 'object_textFixed_param_text_type_RichText' => 'Text', - 'object_textUrl' => 'Text URL', - 'object_textUrl_param_text_type_RichText' => 'Text', - 'object_textUrl_param_url_type_string' => 'URL', - 'object_textUrl_param_webpage_id_type_long' => 'Webpage ID', - 'object_textEmail' => 'Text email', - 'object_textEmail_param_text_type_RichText' => 'Text', - 'object_textEmail_param_email_type_string' => 'Email', - 'object_textConcat' => 'Text concat', + 'object_textUrl' => 'Link', + 'object_textUrl_param_text_type_RichText' => 'Text of link', + 'object_textUrl_param_url_type_string' => 'Webpage HTTP URL', + 'object_textUrl_param_webpage_id_type_long' => 'If a preview was already generated for the page, the page ID', + 'object_textEmail' => 'Rich text email link', + 'object_textEmail_param_text_type_RichText' => 'Link text', + 'object_textEmail_param_email_type_string' => 'Email address', + 'object_textConcat' => 'Concatenation of rich texts', 'object_textConcat_param_texts_type_Vector t' => 'Texts', - 'object_pageBlockUnsupported' => 'Page block unsupported', - 'object_pageBlockTitle' => 'Page block title', - 'object_pageBlockTitle_param_text_type_RichText' => 'Text', - 'object_pageBlockSubtitle' => 'Page block subtitle', + 'object_pageBlockUnsupported' => 'Unsupported IV element', + 'object_pageBlockTitle' => 'Title', + 'object_pageBlockTitle_param_text_type_RichText' => 'Title', + 'object_pageBlockSubtitle' => 'Subtitle', 'object_pageBlockSubtitle_param_text_type_RichText' => 'Text', - 'object_pageBlockAuthorDate' => 'Page block author date', - 'object_pageBlockAuthorDate_param_author_type_RichText' => 'Author', - 'object_pageBlockAuthorDate_param_published_date_type_int' => 'Published date', - 'object_pageBlockHeader' => 'Page block header', - 'object_pageBlockHeader_param_text_type_RichText' => 'Text', - 'object_pageBlockSubheader' => 'Page block subheader', - 'object_pageBlockSubheader_param_text_type_RichText' => 'Text', - 'object_pageBlockFooter' => 'Page block footer', - 'object_pageBlockFooter_param_text_type_RichText' => 'Text', - 'object_pageBlockList' => 'Page block list', + 'object_pageBlockAuthorDate' => 'Author and date of creation of article', + 'object_pageBlockAuthorDate_param_author_type_RichText' => 'Author name', + 'object_pageBlockAuthorDate_param_published_date_type_int' => 'Date of pubblication', + 'object_pageBlockHeader' => 'Page header', + 'object_pageBlockHeader_param_text_type_RichText' => 'Contents', + 'object_pageBlockSubheader' => 'Subheader', + 'object_pageBlockSubheader_param_text_type_RichText' => 'Subheader', + 'object_pageBlockFooter' => 'Page footer', + 'object_pageBlockFooter_param_text_type_RichText' => 'Contents', + 'object_pageBlockList' => 'Unordered list of IV blocks', 'object_pageBlockList_param_ordered_type_Bool' => 'Ordered?', 'object_pageBlockList_param_items_type_Vector t' => 'Items', - 'object_pageBlockBlockquote' => 'Page block blockquote', - 'object_pageBlockBlockquote_param_text_type_RichText' => 'Text', + 'object_pageBlockBlockquote' => 'Quote (equivalent to the HTML `
`)', + 'object_pageBlockBlockquote_param_text_type_RichText' => 'Quote contents', 'object_pageBlockBlockquote_param_caption_type_RichText' => 'Caption', - 'object_pageBlockPullquote' => 'Page block pullquote', + 'object_pageBlockPullquote' => 'Pullquote', 'object_pageBlockPullquote_param_text_type_RichText' => 'Text', 'object_pageBlockPullquote_param_caption_type_RichText' => 'Caption', - 'object_pageBlockPhoto' => 'Page block photo', + 'object_pageBlockPhoto' => 'A photo', 'object_pageBlockPhoto_param_photo_id_type_long' => 'Photo ID', 'object_pageBlockPhoto_param_caption_type_RichText' => 'Caption', - 'object_pageBlockVideo' => 'Page block video', - 'object_pageBlockVideo_param_autoplay_type_true' => 'Autoplay?', - 'object_pageBlockVideo_param_loop_type_true' => 'Loop?', + 'object_pageBlockVideo' => 'Video', + 'object_pageBlockVideo_param_autoplay_type_true' => 'Whether the video is set to autoplay', + 'object_pageBlockVideo_param_loop_type_true' => 'Whether the video is set to loop', 'object_pageBlockVideo_param_video_id_type_long' => 'Video ID', 'object_pageBlockVideo_param_caption_type_RichText' => 'Caption', - 'object_pageBlockEmbed' => 'Page block embed', - 'object_pageBlockEmbed_param_full_width_type_true' => 'Full width?', - 'object_pageBlockEmbed_param_allow_scrolling_type_true' => 'Allow scrolling?', - 'object_pageBlockEmbed_param_url_type_string' => 'URL', - 'object_pageBlockEmbed_param_html_type_string' => 'Html', - 'object_pageBlockEmbed_param_poster_photo_id_type_long' => 'Poster photo ID', - 'object_pageBlockEmbed_param_w_type_int' => 'Width', - 'object_pageBlockEmbed_param_h_type_int' => 'Height', + 'object_pageBlockEmbed' => 'An embedded webpage', + 'object_pageBlockEmbed_param_full_width_type_true' => 'Whether the block should be full width', + 'object_pageBlockEmbed_param_allow_scrolling_type_true' => 'Whether scrolling should be allowed', + 'object_pageBlockEmbed_param_url_type_string' => 'Web page URL, if available', + 'object_pageBlockEmbed_param_html_type_string' => 'HTML-markup of the embedded page', + 'object_pageBlockEmbed_param_poster_photo_id_type_long' => 'Poster photo, if available', + 'object_pageBlockEmbed_param_w_type_int' => 'Block width, if known', + 'object_pageBlockEmbed_param_h_type_int' => 'Block height, if known', 'object_pageBlockEmbed_param_caption_type_RichText' => 'Caption', - 'object_pageBlockEmbedPost' => 'Page block embed post', - 'object_pageBlockEmbedPost_param_url_type_string' => 'URL', - 'object_pageBlockEmbedPost_param_webpage_id_type_long' => 'Webpage ID', - 'object_pageBlockEmbedPost_param_author_photo_id_type_long' => 'Author photo ID', - 'object_pageBlockEmbedPost_param_author_type_string' => 'Author', - 'object_pageBlockEmbedPost_param_date_type_int' => 'Date', + 'object_pageBlockEmbedPost' => 'An embedded post', + 'object_pageBlockEmbedPost_param_url_type_string' => 'Web page URL', + 'object_pageBlockEmbedPost_param_webpage_id_type_long' => 'ID of generated webpage preview', + 'object_pageBlockEmbedPost_param_author_photo_id_type_long' => 'ID of the author\'s photo', + 'object_pageBlockEmbedPost_param_author_type_string' => 'Author name', + 'object_pageBlockEmbedPost_param_date_type_int' => 'Creation date', 'object_pageBlockEmbedPost_param_blocks_type_Vector t' => 'Blocks', 'object_pageBlockEmbedPost_param_caption_type_RichText' => 'Caption', - 'object_pageBlockCollage' => 'Page block collage', + 'object_pageBlockCollage' => 'Collage of media', 'object_pageBlockCollage_param_items_type_Vector t' => 'Items', 'object_pageBlockCollage_param_caption_type_RichText' => 'Caption', - 'object_pageBlockSlideshow' => 'Page block slideshow', + 'object_pageBlockSlideshow' => 'Slideshow', 'object_pageBlockSlideshow_param_items_type_Vector t' => 'Items', 'object_pageBlockSlideshow_param_caption_type_RichText' => 'Caption', - 'object_pageBlockChannel' => 'Page block channel', - 'object_pageBlockChannel_param_channel_type_Chat' => 'Channel', - 'object_pageBlockAudio' => 'Page block audio', - 'object_pageBlockAudio_param_audio_id_type_long' => 'Audio ID', + 'object_pageBlockChannel' => 'Reference to a telegram channel', + 'object_pageBlockChannel_param_channel_type_Chat' => 'The channel/supergroup/chat', + 'object_pageBlockAudio' => 'Audio', + 'object_pageBlockAudio_param_audio_id_type_long' => 'Audio ID (to be fetched from the container [page](../constructors/page.md) constructor', 'object_pageBlockAudio_param_caption_type_RichText' => 'Caption', 'object_pagePart' => 'Page part', 'object_pagePart_param_blocks_type_Vector t' => 'Blocks', @@ -3151,212 +3172,212 @@ class Lang 'object_pageFull_param_blocks_type_Vector t' => 'Blocks', 'object_pageFull_param_photos_type_Vector t' => 'Photos', 'object_pageFull_param_documents_type_Vector t' => 'Documents', - 'object_phoneCallDiscardReasonMissed' => 'Phone call discard reason missed', - 'object_phoneCallDiscardReasonDisconnect' => 'Phone call discard reason disconnect', - 'object_phoneCallDiscardReasonHangup' => 'Phone call discard reason hangup', - 'object_phoneCallDiscardReasonBusy' => 'Phone call discard reason busy', - 'object_dataJSON' => 'Data json', - 'object_dataJSON_param_data_type_string' => 'Data', - 'object_labeledPrice' => 'Labeled price', - 'object_labeledPrice_param_label_type_string' => 'Label', - 'object_labeledPrice_param_amount_type_long' => 'Amount', + 'object_phoneCallDiscardReasonMissed' => 'The phone call was missed', + 'object_phoneCallDiscardReasonDisconnect' => 'The phone call was disconnected', + 'object_phoneCallDiscardReasonHangup' => 'The phone call was ended normally', + 'object_phoneCallDiscardReasonBusy' => 'The phone call was discared because the user is busy in another call', + 'object_dataJSON' => 'Represents a json-encoded object', + 'object_dataJSON_param_data_type_string' => 'JSON-encoded object', + 'object_labeledPrice' => 'This object represents a portion of the price for goods or services.', + 'object_labeledPrice_param_label_type_string' => 'Portion label', + 'object_labeledPrice_param_amount_type_long' => 'Price of the product in the smallest units of the currency (integer, not float/double). For example, for a price of `US$ 1.45` pass `amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).', 'object_invoice' => 'Invoice', - 'object_invoice_param_test_type_true' => 'Test?', - 'object_invoice_param_name_requested_type_true' => 'Name requested?', - 'object_invoice_param_phone_requested_type_true' => 'Phone requested?', - 'object_invoice_param_email_requested_type_true' => 'Email requested?', - 'object_invoice_param_shipping_address_requested_type_true' => 'Shipping address requested?', - 'object_invoice_param_flexible_type_true' => 'Flexible?', - 'object_invoice_param_phone_to_provider_type_true' => 'Phone to provider?', - 'object_invoice_param_email_to_provider_type_true' => 'Email to provider?', - 'object_invoice_param_currency_type_string' => 'Currency', + 'object_invoice_param_test_type_true' => 'Test invoice', + 'object_invoice_param_name_requested_type_true' => 'Set this flag if you require the user\'s full name to complete the order', + 'object_invoice_param_phone_requested_type_true' => 'Set this flag if you require the user\'s phone number to complete the order', + 'object_invoice_param_email_requested_type_true' => 'Set this flag if you require the user\'s email address to complete the order', + 'object_invoice_param_shipping_address_requested_type_true' => 'Set this flag if you require the user\'s shipping address to complete the order', + 'object_invoice_param_flexible_type_true' => 'Set this flag if the final price depends on the shipping method', + 'object_invoice_param_phone_to_provider_type_true' => 'Set this flag if user\'s phone number should be sent to provider', + 'object_invoice_param_email_to_provider_type_true' => 'Set this flag if user\'s email address should be sent to provider', + 'object_invoice_param_currency_type_string' => 'Three-letter ISO 4217 [currency](https://core.telegram.org/bots/payments#supported-currencies) code', 'object_invoice_param_prices_type_Vector t' => 'Prices', - 'object_paymentCharge' => 'Payment charge', - 'object_paymentCharge_param_id_type_string' => 'ID', - 'object_paymentCharge_param_provider_charge_id_type_string' => 'Provider charge ID', - 'object_postAddress' => 'Post address', - 'object_postAddress_param_street_line1_type_string' => 'Street line1', - 'object_postAddress_param_street_line2_type_string' => 'Street line2', + 'object_paymentCharge' => 'Payment identifier', + 'object_paymentCharge_param_id_type_string' => 'Telegram payment identifier', + 'object_paymentCharge_param_provider_charge_id_type_string' => 'Provider payment identifier', + 'object_postAddress' => 'Shipping address', + 'object_postAddress_param_street_line1_type_string' => 'First line for the address', + 'object_postAddress_param_street_line2_type_string' => 'Second line for the address', 'object_postAddress_param_city_type_string' => 'City', - 'object_postAddress_param_state_type_string' => 'State', - 'object_postAddress_param_country_iso2_type_string' => 'Country iso2', - 'object_postAddress_param_post_code_type_string' => 'Post code', - 'object_paymentRequestedInfo' => 'Payment requested info', - 'object_paymentRequestedInfo_param_name_type_string' => 'Name', - 'object_paymentRequestedInfo_param_phone_type_string' => 'Phone', - 'object_paymentRequestedInfo_param_email_type_string' => 'Email', - 'object_paymentRequestedInfo_param_shipping_address_type_PostAddress' => 'Shipping address', - 'object_paymentSavedCredentialsCard' => 'Payment saved credentials card', - 'object_paymentSavedCredentialsCard_param_id_type_string' => 'ID', + 'object_postAddress_param_state_type_string' => 'State, if applicable (empty otherwise)', + 'object_postAddress_param_country_iso2_type_string' => 'ISO 3166-1 alpha-2 country code', + 'object_postAddress_param_post_code_type_string' => 'Address post code', + 'object_paymentRequestedInfo' => 'Order info provided by the user', + 'object_paymentRequestedInfo_param_name_type_string' => 'User\'s full name', + 'object_paymentRequestedInfo_param_phone_type_string' => 'User\'s phone number', + 'object_paymentRequestedInfo_param_email_type_string' => 'User\'s email address', + 'object_paymentRequestedInfo_param_shipping_address_type_PostAddress' => 'User\'s shipping address', + 'object_paymentSavedCredentialsCard' => 'Saved credit card', + 'object_paymentSavedCredentialsCard_param_id_type_string' => 'Card ID', 'object_paymentSavedCredentialsCard_param_title_type_string' => 'Title', - 'object_webDocument' => 'Web document', - 'object_webDocument_param_url_type_string' => 'URL', + 'object_webDocument' => 'Remote document', + 'object_webDocument_param_url_type_string' => 'Document URL', 'object_webDocument_param_access_hash_type_long' => 'Access hash', - 'object_webDocument_param_size_type_int' => 'Size', - 'object_webDocument_param_mime_type_type_string' => 'Mime type', + 'object_webDocument_param_size_type_int' => 'File size', + 'object_webDocument_param_mime_type_type_string' => 'MIME type', 'object_webDocument_param_attributes_type_Vector t' => 'Attributes', 'object_webDocument_param_dc_id_type_int' => 'DC ID', - 'object_inputWebDocument' => 'Web document', - 'object_inputWebDocument_param_url_type_string' => 'URL', - 'object_inputWebDocument_param_size_type_int' => 'Size', + 'object_inputWebDocument' => 'The document', + 'object_inputWebDocument_param_url_type_string' => 'Remote document URL to be downloaded using the appropriate [method](https://core.telegram.org/api/files)', + 'object_inputWebDocument_param_size_type_int' => 'Remote file size', 'object_inputWebDocument_param_mime_type_type_string' => 'Mime type', 'object_inputWebDocument_param_attributes_type_Vector t' => 'Attributes', - 'object_inputWebFileLocation' => 'Web file location', - 'object_inputWebFileLocation_param_url_type_string' => 'URL', + 'object_inputWebFileLocation' => 'Location of a remote HTTP(s) file', + 'object_inputWebFileLocation_param_url_type_string' => 'HTTP URL of file', 'object_inputWebFileLocation_param_access_hash_type_long' => 'Access hash', - 'object_upload.webFile' => 'Web file', - 'object_upload.webFile_param_size_type_int' => 'Size', + 'object_upload.webFile' => 'Represents a chunk of an [HTTP webfile](https://core.telegram.org/api/files) downloaded through telegram\'s secure MTProto servers', + 'object_upload.webFile_param_size_type_int' => 'File size', 'object_upload.webFile_param_mime_type_type_string' => 'Mime type', 'object_upload.webFile_param_file_type_type_storage.FileType' => 'File type', - 'object_upload.webFile_param_mtime_type_int' => 'Mtime', - 'object_upload.webFile_param_bytes_type_bytes' => 'Bytes', + 'object_upload.webFile_param_mtime_type_int' => 'Modified time', + 'object_upload.webFile_param_bytes_type_bytes' => 'Data', 'object_payments.paymentForm' => 'Payment form', - 'object_payments.paymentForm_param_can_save_credentials_type_true' => 'Can save credentials?', - 'object_payments.paymentForm_param_password_missing_type_true' => 'Password missing?', + 'object_payments.paymentForm_param_can_save_credentials_type_true' => 'Whether the user can choose to save credentials.', + 'object_payments.paymentForm_param_password_missing_type_true' => 'Indicates that the user can save payment credentials, but only after setting up a [2FA password](https://core.telegram.org/api/srp) (currently the account doesn\'t have a [2FA password](https://core.telegram.org/api/srp))', 'object_payments.paymentForm_param_bot_id_type_int' => 'Bot ID', 'object_payments.paymentForm_param_invoice_type_Invoice' => 'Invoice', - 'object_payments.paymentForm_param_provider_id_type_int' => 'Provider ID', - 'object_payments.paymentForm_param_url_type_string' => 'URL', - 'object_payments.paymentForm_param_native_provider_type_string' => 'Native provider', - 'object_payments.paymentForm_param_native_params_type_DataJSON' => 'Native params', - 'object_payments.paymentForm_param_saved_info_type_PaymentRequestedInfo' => 'Saved info', - 'object_payments.paymentForm_param_saved_credentials_type_PaymentSavedCredentials' => 'Saved credentials', + 'object_payments.paymentForm_param_provider_id_type_int' => 'Payment provider ID.', + 'object_payments.paymentForm_param_url_type_string' => 'Payment form URL', + 'object_payments.paymentForm_param_native_provider_type_string' => 'Payment provider name.
One of the following:
\\- `stripe`', + 'object_payments.paymentForm_param_native_params_type_DataJSON' => 'Contains information about the payment provider, if available, to support it natively without the need for opening the URL.
A JSON object that can contain the following fields:

\\- `publishable_key`: Stripe API publishable key
\\- `apple_pay_merchant_id`: Apple Pay merchant ID
\\- `android_pay_public_key`: Android Pay public key
\\- `android_pay_bgcolor`: Android Pay form background color
\\- `android_pay_inverse`: Whether to use the dark theme in the Android Pay form
\\- `need_country`: True, if the user country must be provided,
\\- `need_zip`: True, if the user ZIP/postal code must be provided,
\\- `need_cardholder_name`: True, if the cardholder name must be provided
', + 'object_payments.paymentForm_param_saved_info_type_PaymentRequestedInfo' => 'Saved server-side order information', + 'object_payments.paymentForm_param_saved_credentials_type_PaymentSavedCredentials' => 'Contains information about saved card credentials', 'object_payments.paymentForm_param_users_type_Vector t' => 'Users', - 'object_payments.validatedRequestedInfo' => 'Validated requested info', + 'object_payments.validatedRequestedInfo' => 'Validated user-provided info', 'object_payments.validatedRequestedInfo_param_id_type_string' => 'ID', 'object_payments.validatedRequestedInfo_param_shipping_options_type_Vector t' => 'Shipping options', 'object_payments.paymentResult' => 'Payment result', - 'object_payments.paymentResult_param_updates_type_Updates' => 'Updates', + 'object_payments.paymentResult_param_updates_type_Updates' => 'Info about the payment', 'object_payments.paymentVerficationNeeded' => 'Payment verfication needed', 'object_payments.paymentVerficationNeeded_param_url_type_string' => 'URL', - 'object_payments.paymentReceipt' => 'Payment receipt', - 'object_payments.paymentReceipt_param_date_type_int' => 'Date', + 'object_payments.paymentReceipt' => 'Receipt', + 'object_payments.paymentReceipt_param_date_type_int' => 'Date of generation', 'object_payments.paymentReceipt_param_bot_id_type_int' => 'Bot ID', 'object_payments.paymentReceipt_param_invoice_type_Invoice' => 'Invoice', 'object_payments.paymentReceipt_param_provider_id_type_int' => 'Provider ID', 'object_payments.paymentReceipt_param_info_type_PaymentRequestedInfo' => 'Info', - 'object_payments.paymentReceipt_param_shipping_type_ShippingOption' => 'Shipping', - 'object_payments.paymentReceipt_param_currency_type_string' => 'Currency', - 'object_payments.paymentReceipt_param_total_amount_type_long' => 'Total amount', - 'object_payments.paymentReceipt_param_credentials_title_type_string' => 'Credentials title', + 'object_payments.paymentReceipt_param_shipping_type_ShippingOption' => 'Selected shipping option', + 'object_payments.paymentReceipt_param_currency_type_string' => 'Three-letter ISO 4217 [currency](https://core.telegram.org/bots/payments#supported-currencies) code', + 'object_payments.paymentReceipt_param_total_amount_type_long' => 'Total amount in the smallest units of the currency (integer, not float/double). For example, for a price of `US$ 1.45` pass `amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).', + 'object_payments.paymentReceipt_param_credentials_title_type_string' => 'Payment credential name', 'object_payments.paymentReceipt_param_users_type_Vector t' => 'Users', - 'object_payments.savedInfo' => 'Saved info', - 'object_payments.savedInfo_param_has_saved_credentials_type_true' => 'Has saved credentials?', - 'object_payments.savedInfo_param_saved_info_type_PaymentRequestedInfo' => 'Saved info', - 'object_inputPaymentCredentialsSaved' => 'Payment credentials saved', - 'object_inputPaymentCredentialsSaved_param_id_type_string' => 'ID', - 'object_inputPaymentCredentialsSaved_param_tmp_password_type_bytes' => 'Tmp password', + 'object_payments.savedInfo' => 'Saved server-side order information', + 'object_payments.savedInfo_param_has_saved_credentials_type_true' => 'Whether the user has some saved payment credentials', + 'object_payments.savedInfo_param_saved_info_type_PaymentRequestedInfo' => 'Saved server-side order information', + 'object_inputPaymentCredentialsSaved' => 'Saved payment credentials', + 'object_inputPaymentCredentialsSaved_param_id_type_string' => 'Credential ID', + 'object_inputPaymentCredentialsSaved_param_tmp_password_type_bytes' => 'Temporary password', 'object_inputPaymentCredentials' => 'Payment credentials', - 'object_inputPaymentCredentials_param_save_type_true' => 'Save?', - 'object_inputPaymentCredentials_param_data_type_DataJSON' => 'Data', - 'object_inputPaymentCredentialsApplePay' => 'Payment credentials apple pay', + 'object_inputPaymentCredentials_param_save_type_true' => 'Save payment credential for future use', + 'object_inputPaymentCredentials_param_data_type_DataJSON' => 'Payment credentials', + 'object_inputPaymentCredentialsApplePay' => 'Apple pay payment credentials', 'object_inputPaymentCredentialsApplePay_param_payment_data_type_DataJSON' => 'Payment data', - 'object_inputPaymentCredentialsAndroidPay' => 'Payment credentials android pay', - 'object_inputPaymentCredentialsAndroidPay_param_payment_token_type_DataJSON' => 'Payment token', + 'object_inputPaymentCredentialsAndroidPay' => 'Android pay payment credentials', + 'object_inputPaymentCredentialsAndroidPay_param_payment_token_type_DataJSON' => 'Android pay payment token', 'object_inputPaymentCredentialsAndroidPay_param_google_transaction_id_type_string' => 'Google transaction ID', - 'object_account.tmpPassword' => 'Tmp password', - 'object_account.tmpPassword_param_tmp_password_type_bytes' => 'Tmp password', - 'object_account.tmpPassword_param_valid_until_type_int' => 'Valid until', + 'object_account.tmpPassword' => 'Temporary payment password', + 'object_account.tmpPassword_param_tmp_password_type_bytes' => 'Temporary password', + 'object_account.tmpPassword_param_valid_until_type_int' => 'Validity period', 'object_shippingOption' => 'Shipping option', - 'object_shippingOption_param_id_type_string' => 'ID', + 'object_shippingOption_param_id_type_string' => 'Option ID', 'object_shippingOption_param_title_type_string' => 'Title', 'object_shippingOption_param_prices_type_Vector t' => 'Prices', - 'object_inputStickerSetItem' => 'Sticker set item', - 'object_inputStickerSetItem_param_document_type_InputDocument' => 'Document', - 'object_inputStickerSetItem_param_emoji_type_string' => 'Emoji', - 'object_inputStickerSetItem_param_mask_coords_type_MaskCoords' => 'Mask coords', + 'object_inputStickerSetItem' => 'Sticker in a stickerset', + 'object_inputStickerSetItem_param_document_type_InputDocument' => 'The sticker', + 'object_inputStickerSetItem_param_emoji_type_string' => 'Associated emoji', + 'object_inputStickerSetItem_param_mask_coords_type_MaskCoords' => 'Coordinates for mask sticker', 'object_inputPhoneCall' => 'Phone call', - 'object_inputPhoneCall_param_id_type_long' => 'ID', + 'object_inputPhoneCall_param_id_type_long' => 'Call ID', 'object_inputPhoneCall_param_access_hash_type_long' => 'Access hash', - 'object_phoneCallEmpty' => 'Empty phone call', - 'object_phoneCallEmpty_param_id_type_long' => 'ID', - 'object_phoneCallWaiting' => 'Phone call waiting', - 'object_phoneCallWaiting_param_id_type_long' => 'ID', + 'object_phoneCallEmpty' => 'Empty constructor', + 'object_phoneCallEmpty_param_id_type_long' => 'Call ID', + 'object_phoneCallWaiting' => 'Incoming phone call', + 'object_phoneCallWaiting_param_id_type_long' => 'Call ID', 'object_phoneCallWaiting_param_access_hash_type_long' => 'Access hash', 'object_phoneCallWaiting_param_date_type_int' => 'Date', 'object_phoneCallWaiting_param_admin_id_type_int' => 'Admin ID', 'object_phoneCallWaiting_param_participant_id_type_int' => 'Participant ID', - 'object_phoneCallWaiting_param_protocol_type_PhoneCallProtocol' => 'Protocol', - 'object_phoneCallWaiting_param_receive_date_type_int' => 'Receive date', - 'object_phoneCallRequested' => 'Phone call requested', - 'object_phoneCallRequested_param_id_type_long' => 'ID', + 'object_phoneCallWaiting_param_protocol_type_PhoneCallProtocol' => 'Phone call protocol info', + 'object_phoneCallWaiting_param_receive_date_type_int' => 'When was the phone call received', + 'object_phoneCallRequested' => 'Requested phone call', + 'object_phoneCallRequested_param_id_type_long' => 'Phone call ID', 'object_phoneCallRequested_param_access_hash_type_long' => 'Access hash', - 'object_phoneCallRequested_param_date_type_int' => 'Date', - 'object_phoneCallRequested_param_admin_id_type_int' => 'Admin ID', - 'object_phoneCallRequested_param_participant_id_type_int' => 'Participant ID', - 'object_phoneCallRequested_param_g_a_hash_type_bytes' => 'G a hash', - 'object_phoneCallRequested_param_protocol_type_PhoneCallProtocol' => 'Protocol', - 'object_phoneCallAccepted' => 'Phone call accepted', - 'object_phoneCallAccepted_param_id_type_long' => 'ID', - 'object_phoneCallAccepted_param_access_hash_type_long' => 'Access hash', - 'object_phoneCallAccepted_param_date_type_int' => 'Date', - 'object_phoneCallAccepted_param_admin_id_type_int' => 'Admin ID', - 'object_phoneCallAccepted_param_participant_id_type_int' => 'Participant ID', - 'object_phoneCallAccepted_param_g_b_type_bytes' => 'G b', - 'object_phoneCallAccepted_param_protocol_type_PhoneCallProtocol' => 'Protocol', + 'object_phoneCallRequested_param_date_type_int' => 'When was the phone call created', + 'object_phoneCallRequested_param_admin_id_type_int' => 'ID of the creator of the phone call', + 'object_phoneCallRequested_param_participant_id_type_int' => 'ID of the other participant of the phone call', + 'object_phoneCallRequested_param_g_a_hash_type_bytes' => '[Parameter for key exchange](https://core.telegram.org/api/end-to-end/voice-calls)', + 'object_phoneCallRequested_param_protocol_type_PhoneCallProtocol' => 'Call protocol info to be passed to libtgvoip', + 'object_phoneCallAccepted' => 'An accepted phone call', + 'object_phoneCallAccepted_param_id_type_long' => 'ID of accepted phone call', + 'object_phoneCallAccepted_param_access_hash_type_long' => 'Access hash of phone call', + 'object_phoneCallAccepted_param_date_type_int' => 'When was the call accepted', + 'object_phoneCallAccepted_param_admin_id_type_int' => 'ID of the call creator', + 'object_phoneCallAccepted_param_participant_id_type_int' => 'ID of the other user in the call', + 'object_phoneCallAccepted_param_g_b_type_bytes' => 'B parameter for [secure E2E phone call key exchange](https://core.telegram.org/api/end-to-end/voice-calls)', + 'object_phoneCallAccepted_param_protocol_type_PhoneCallProtocol' => 'Protocol to use for phone call', 'object_phoneCall' => 'Phone call', - 'object_phoneCall_param_id_type_long' => 'ID', + 'object_phoneCall_param_id_type_long' => 'Call ID', 'object_phoneCall_param_access_hash_type_long' => 'Access hash', - 'object_phoneCall_param_date_type_int' => 'Date', - 'object_phoneCall_param_admin_id_type_int' => 'Admin ID', - 'object_phoneCall_param_participant_id_type_int' => 'Participant ID', - 'object_phoneCall_param_g_a_or_b_type_bytes' => 'G a or b', - 'object_phoneCall_param_key_fingerprint_type_long' => 'Key fingerprint', - 'object_phoneCall_param_protocol_type_PhoneCallProtocol' => 'Protocol', + 'object_phoneCall_param_date_type_int' => 'Date of creation of the call', + 'object_phoneCall_param_admin_id_type_int' => 'User ID of the creator of the call', + 'object_phoneCall_param_participant_id_type_int' => 'User ID of the other participant in the call', + 'object_phoneCall_param_g_a_or_b_type_bytes' => '[Parameter for key exchange](https://core.telegram.org/api/end-to-end/voice-calls)', + 'object_phoneCall_param_key_fingerprint_type_long' => '[Key fingerprint](https://core.telegram.org/api/end-to-end/voice-calls)', + 'object_phoneCall_param_protocol_type_PhoneCallProtocol' => 'Call protocol info to be passed to libtgvoip', 'object_phoneCall_param_connection_type_PhoneConnection' => 'Connection', 'object_phoneCall_param_alternative_connections_type_Vector t' => 'Alternative connections', - 'object_phoneCall_param_start_date_type_int' => 'Start date', - 'object_phoneCallDiscarded' => 'Phone call discarded', - 'object_phoneCallDiscarded_param_need_rating_type_true' => 'Need rating?', - 'object_phoneCallDiscarded_param_need_debug_type_true' => 'Need debug?', - 'object_phoneCallDiscarded_param_id_type_long' => 'ID', - 'object_phoneCallDiscarded_param_reason_type_PhoneCallDiscardReason' => 'Reason', - 'object_phoneCallDiscarded_param_duration_type_int' => 'Duration', - 'object_phoneConnection' => 'Phone connection', - 'object_phoneConnection_param_id_type_long' => 'ID', - 'object_phoneConnection_param_ip_type_string' => 'Ip', - 'object_phoneConnection_param_ipv6_type_string' => 'Ipv6', - 'object_phoneConnection_param_port_type_int' => 'Port', - 'object_phoneConnection_param_peer_tag_type_bytes' => 'Peer tag', - 'object_phoneCallProtocol' => 'Phone call protocol', - 'object_phoneCallProtocol_param_udp_p2p_type_true' => 'Udp p2p?', - 'object_phoneCallProtocol_param_udp_reflector_type_true' => 'Udp reflector?', - 'object_phoneCallProtocol_param_min_layer_type_int' => 'Min layer', - 'object_phoneCallProtocol_param_max_layer_type_int' => 'Max layer', - 'object_phone.phoneCall' => 'Phone call', - 'object_phone.phoneCall_param_phone_call_type_PhoneCall' => 'Phone call', + 'object_phoneCall_param_start_date_type_int' => 'When was the call actually started', + 'object_phoneCallDiscarded' => 'Indicates a discarded phone call', + 'object_phoneCallDiscarded_param_need_rating_type_true' => 'Whether the server required the user to [rate](../methods/phone.setCallRating.md) the call', + 'object_phoneCallDiscarded_param_need_debug_type_true' => 'Whether the server required the client to [send](../methods/phone.saveCallDebug.md) the libtgvoip call debug data', + 'object_phoneCallDiscarded_param_id_type_long' => 'Call ID', + 'object_phoneCallDiscarded_param_reason_type_PhoneCallDiscardReason' => 'Why was the phone call discarded', + 'object_phoneCallDiscarded_param_duration_type_int' => 'Duration of the phone call in seconds', + 'object_phoneConnection' => 'Identifies an endpoint that can be used to connect to the other user in a phone call', + 'object_phoneConnection_param_id_type_long' => 'Endpoint ID', + 'object_phoneConnection_param_ip_type_string' => 'IP address of endpoint', + 'object_phoneConnection_param_ipv6_type_string' => 'IPv6 address of endpoint', + 'object_phoneConnection_param_port_type_int' => 'Port ID', + 'object_phoneConnection_param_peer_tag_type_bytes' => 'Our peer tag', + 'object_phoneCallProtocol' => 'Protocol info for libtgvoip', + 'object_phoneCallProtocol_param_udp_p2p_type_true' => 'Whether to allow P2P connection to the other participant', + 'object_phoneCallProtocol_param_udp_reflector_type_true' => 'Whether to allow connection to the other participants through the reflector servers', + 'object_phoneCallProtocol_param_min_layer_type_int' => 'Minimum layer for remote libtgvoip', + 'object_phoneCallProtocol_param_max_layer_type_int' => 'Maximum layer for remote libtgvoip', + 'object_phone.phoneCall' => 'A VoIP phone call', + 'object_phone.phoneCall_param_phone_call_type_PhoneCall' => 'The VoIP phone call', 'object_phone.phoneCall_param_users_type_Vector t' => 'Users', - 'object_upload.cdnFileReuploadNeeded' => 'Cdn file reupload needed', - 'object_upload.cdnFileReuploadNeeded_param_request_token_type_bytes' => 'Request token', - 'object_upload.cdnFile' => 'Cdn file', - 'object_upload.cdnFile_param_bytes_type_bytes' => 'Bytes', - 'object_cdnPublicKey' => 'Cdn public key', - 'object_cdnPublicKey_param_dc_id_type_int' => 'DC ID', - 'object_cdnPublicKey_param_public_key_type_string' => 'Public key', - 'object_cdnConfig' => 'CDN configuration', + 'object_upload.cdnFileReuploadNeeded' => 'The file was cleared from the temporary RAM cache of the [CDN](https://core.telegram.org/cdn) and has to be reuploaded.', + 'object_upload.cdnFileReuploadNeeded_param_request_token_type_bytes' => 'Request token (see [CDN](https://core.telegram.org/cdn))', + 'object_upload.cdnFile' => 'Represent a chunk of a [CDN](https://core.telegram.org/cdn) file.', + 'object_upload.cdnFile_param_bytes_type_bytes' => 'The data', + 'object_cdnPublicKey' => 'Public key to use **only** during handshakes to [CDN](https://core.telegram.org/cdn) DCs.', + 'object_cdnPublicKey_param_dc_id_type_int' => '[CDN DC](https://core.telegram.org/cdn) ID', + 'object_cdnPublicKey_param_public_key_type_string' => 'RSA public key', + 'object_cdnConfig' => 'Configuration for [CDN](https://core.telegram.org/cdn) file downloads.', 'object_cdnConfig_param_public_keys_type_Vector t' => 'Public keys', - 'object_langPackString' => 'Lang pack string', - 'object_langPackString_param_key_type_string' => 'Key', + 'object_langPackString' => 'Translated localization string', + 'object_langPackString_param_key_type_string' => 'Language key', 'object_langPackString_param_value_type_string' => 'Value', - 'object_langPackStringPluralized' => 'Lang pack string pluralized', - 'object_langPackStringPluralized_param_key_type_string' => 'Key', - 'object_langPackStringPluralized_param_zero_value_type_string' => 'Zero value', - 'object_langPackStringPluralized_param_one_value_type_string' => 'One value', - 'object_langPackStringPluralized_param_two_value_type_string' => 'Two value', - 'object_langPackStringPluralized_param_few_value_type_string' => 'Few value', - 'object_langPackStringPluralized_param_many_value_type_string' => 'Many value', - 'object_langPackStringPluralized_param_other_value_type_string' => 'Other value', - 'object_langPackStringDeleted' => 'Lang pack string deleted', - 'object_langPackStringDeleted_param_key_type_string' => 'Key', - 'object_langPackDifference' => 'Lang pack difference', - 'object_langPackDifference_param_lang_code_type_string' => 'Lang code', - 'object_langPackDifference_param_from_version_type_int' => 'From version', - 'object_langPackDifference_param_version_type_int' => 'Version', + 'object_langPackStringPluralized' => 'A language pack string which has different forms based on the number of some object it mentions. See [https://www.unicode.org/cldr/charts/latest/supplemental/language\\_plural\\_rules.html](https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html) for more info', + 'object_langPackStringPluralized_param_key_type_string' => 'Localization key', + 'object_langPackStringPluralized_param_zero_value_type_string' => 'Value for zero objects', + 'object_langPackStringPluralized_param_one_value_type_string' => 'Value for one object', + 'object_langPackStringPluralized_param_two_value_type_string' => 'Value for two objects', + 'object_langPackStringPluralized_param_few_value_type_string' => 'Value for a few objects', + 'object_langPackStringPluralized_param_many_value_type_string' => 'Value for many objects', + 'object_langPackStringPluralized_param_other_value_type_string' => 'Default value', + 'object_langPackStringDeleted' => 'Deleted localization string', + 'object_langPackStringDeleted_param_key_type_string' => 'Localization key', + 'object_langPackDifference' => 'Changes to the app\'s localization pack', + 'object_langPackDifference_param_lang_code_type_string' => 'Language code', + 'object_langPackDifference_param_from_version_type_int' => 'Previous version number', + 'object_langPackDifference_param_version_type_int' => 'New version number', 'object_langPackDifference_param_strings_type_Vector t' => 'Strings', - 'object_langPackLanguage' => 'Lang pack language', - 'object_langPackLanguage_param_name_type_string' => 'Name', - 'object_langPackLanguage_param_native_name_type_string' => 'Native name', - 'object_langPackLanguage_param_lang_code_type_string' => 'Lang code', + 'object_langPackLanguage' => 'Identifies a localization pack', + 'object_langPackLanguage_param_name_type_string' => 'Language name', + 'object_langPackLanguage_param_native_name_type_string' => 'Language name in the language itself', + 'object_langPackLanguage_param_lang_code_type_string' => 'Language code (pack identifier)', 'object_channelAdminRights' => 'Admin rights', 'object_channelAdminRights_param_change_info_type_true' => 'Change info', 'object_channelAdminRights_param_post_messages_type_true' => 'Post messages', @@ -3377,120 +3398,120 @@ class Lang 'object_channelBannedRights_param_send_inline_type_true' => 'Disallow sending inline keyboards', 'object_channelBannedRights_param_embed_links_type_true' => 'Disallow embedding links', 'object_channelBannedRights_param_until_date_type_int' => 'Until date', - 'object_channelAdminLogEventActionChangeTitle' => 'Change title', - 'object_channelAdminLogEventActionChangeTitle_param_prev_value_type_string' => 'Previous value', - 'object_channelAdminLogEventActionChangeTitle_param_new_value_type_string' => 'New value', - 'object_channelAdminLogEventActionChangeAbout' => 'Change about text', - 'object_channelAdminLogEventActionChangeAbout_param_prev_value_type_string' => 'Previous value', - 'object_channelAdminLogEventActionChangeAbout_param_new_value_type_string' => 'New value', - 'object_channelAdminLogEventActionChangeUsername' => 'Change username', - 'object_channelAdminLogEventActionChangeUsername_param_prev_value_type_string' => 'Prev value', - 'object_channelAdminLogEventActionChangeUsername_param_new_value_type_string' => 'New value', - 'object_channelAdminLogEventActionChangePhoto' => 'Change photo', + 'object_channelAdminLogEventActionChangeTitle' => 'Channel/supergroup title was changed', + 'object_channelAdminLogEventActionChangeTitle_param_prev_value_type_string' => 'Previous title', + 'object_channelAdminLogEventActionChangeTitle_param_new_value_type_string' => 'New title', + 'object_channelAdminLogEventActionChangeAbout' => 'The description was changed', + 'object_channelAdminLogEventActionChangeAbout_param_prev_value_type_string' => 'Previous description', + 'object_channelAdminLogEventActionChangeAbout_param_new_value_type_string' => 'New description', + 'object_channelAdminLogEventActionChangeUsername' => 'Channel/supergroup username was changed', + 'object_channelAdminLogEventActionChangeUsername_param_prev_value_type_string' => 'Old username', + 'object_channelAdminLogEventActionChangeUsername_param_new_value_type_string' => 'New username', + 'object_channelAdminLogEventActionChangePhoto' => 'The channel/supergroup\'s picture was changed', 'object_channelAdminLogEventActionChangePhoto_param_prev_photo_type_ChatPhoto' => 'Previous photo', 'object_channelAdminLogEventActionChangePhoto_param_new_photo_type_ChatPhoto' => 'New photo', - 'object_channelAdminLogEventActionToggleInvites' => 'Invite setting toggled', + 'object_channelAdminLogEventActionToggleInvites' => 'Invites were enabled/disabled', 'object_channelAdminLogEventActionToggleInvites_param_new_value_type_Bool' => 'New value', - 'object_channelAdminLogEventActionToggleSignatures' => 'Toggle channel signatures', - 'object_channelAdminLogEventActionToggleSignatures_param_new_value_type_Bool' => 'New value?', - 'object_channelAdminLogEventActionUpdatePinned' => 'Message pinned', - 'object_channelAdminLogEventActionUpdatePinned_param_message_type_Message' => 'Message', - 'object_channelAdminLogEventActionEditMessage' => 'Edit message', - 'object_channelAdminLogEventActionEditMessage_param_prev_message_type_Message' => 'Prev message', + 'object_channelAdminLogEventActionToggleSignatures' => 'Channel signatures were enabled/disabled', + 'object_channelAdminLogEventActionToggleSignatures_param_new_value_type_Bool' => 'New value', + 'object_channelAdminLogEventActionUpdatePinned' => 'A message was pinned', + 'object_channelAdminLogEventActionUpdatePinned_param_message_type_Message' => 'The message that was pinned', + 'object_channelAdminLogEventActionEditMessage' => 'A message was edited', + 'object_channelAdminLogEventActionEditMessage_param_prev_message_type_Message' => 'Old message', 'object_channelAdminLogEventActionEditMessage_param_new_message_type_Message' => 'New message', - 'object_channelAdminLogEventActionDeleteMessage' => 'Delete message', - 'object_channelAdminLogEventActionDeleteMessage_param_message_type_Message' => 'Message', - 'object_channelAdminLogEventActionParticipantJoin' => 'Joined participant', - 'object_channelAdminLogEventActionParticipantLeave' => 'Left participant', - 'object_channelAdminLogEventActionParticipantInvite' => 'Invite participant', - 'object_channelAdminLogEventActionParticipantInvite_param_participant_type_ChannelParticipant' => 'Participant', - 'object_channelAdminLogEventActionParticipantToggleBan' => 'User banned', - 'object_channelAdminLogEventActionParticipantToggleBan_param_prev_participant_type_ChannelParticipant' => 'Prev participant', - 'object_channelAdminLogEventActionParticipantToggleBan_param_new_participant_type_ChannelParticipant' => 'New participant', - 'object_channelAdminLogEventActionParticipantToggleAdmin' => 'Admin toggled', - 'object_channelAdminLogEventActionParticipantToggleAdmin_param_prev_participant_type_ChannelParticipant' => 'Prev participant', - 'object_channelAdminLogEventActionParticipantToggleAdmin_param_new_participant_type_ChannelParticipant' => 'New participant', - 'object_channelAdminLogEventActionChangeStickerSet' => 'Change stickerset', + 'object_channelAdminLogEventActionDeleteMessage' => 'A message was deleted', + 'object_channelAdminLogEventActionDeleteMessage_param_message_type_Message' => 'The message that was deleted', + 'object_channelAdminLogEventActionParticipantJoin' => 'A user has joined the group (in the case of big groups, info of the user that has joined isn\'t shown)', + 'object_channelAdminLogEventActionParticipantLeave' => 'A user left the channel/supergroup (in the case of big groups, info of the user that has joined isn\'t shown)', + 'object_channelAdminLogEventActionParticipantInvite' => 'A user was invited to the group', + 'object_channelAdminLogEventActionParticipantInvite_param_participant_type_ChannelParticipant' => 'The user that was invited', + 'object_channelAdminLogEventActionParticipantToggleBan' => 'The banned [rights](https://core.telegram.org/api/rights) of a user were changed', + 'object_channelAdminLogEventActionParticipantToggleBan_param_prev_participant_type_ChannelParticipant' => 'Old banned rights of user', + 'object_channelAdminLogEventActionParticipantToggleBan_param_new_participant_type_ChannelParticipant' => 'New banned rights of user', + 'object_channelAdminLogEventActionParticipantToggleAdmin' => 'The admin [rights](https://core.telegram.org/api/rights) of a user were changed', + 'object_channelAdminLogEventActionParticipantToggleAdmin_param_prev_participant_type_ChannelParticipant' => 'Previous admin rights', + 'object_channelAdminLogEventActionParticipantToggleAdmin_param_new_participant_type_ChannelParticipant' => 'New admin rights', + 'object_channelAdminLogEventActionChangeStickerSet' => 'The supergroup\'s stickerset was changed', 'object_channelAdminLogEventActionChangeStickerSet_param_prev_stickerset_type_InputStickerSet' => 'Previous stickerset', 'object_channelAdminLogEventActionChangeStickerSet_param_new_stickerset_type_InputStickerSet' => 'New stickerset', - 'object_channelAdminLogEventActionTogglePreHistoryHidden' => 'Previous history hidden', + 'object_channelAdminLogEventActionTogglePreHistoryHidden' => 'The hidden prehistory setting was [changed](../methods/channels.togglePreHistoryHidden.md)', 'object_channelAdminLogEventActionTogglePreHistoryHidden_param_new_value_type_Bool' => 'New value', - 'object_channelAdminLogEvent' => 'Channel admin log event', - 'object_channelAdminLogEvent_param_id_type_long' => 'ID', + 'object_channelAdminLogEvent' => 'Admin log event', + 'object_channelAdminLogEvent_param_id_type_long' => 'Event ID', 'object_channelAdminLogEvent_param_date_type_int' => 'Date', 'object_channelAdminLogEvent_param_user_id_type_int' => 'User ID', 'object_channelAdminLogEvent_param_action_type_ChannelAdminLogEventAction' => 'Action', - 'object_channels.adminLogResults' => 'Admin log results', + 'object_channels.adminLogResults' => 'Admin log events', 'object_channels.adminLogResults_param_events_type_Vector t' => 'Events', 'object_channels.adminLogResults_param_chats_type_Vector t' => 'Chats', 'object_channels.adminLogResults_param_users_type_Vector t' => 'Users', - 'object_channelAdminLogEventsFilter' => 'Event filter', - 'object_channelAdminLogEventsFilter_param_join_type_true' => 'Join users events', - 'object_channelAdminLogEventsFilter_param_leave_type_true' => 'Left users events', - 'object_channelAdminLogEventsFilter_param_invite_type_true' => 'Invite users events', - 'object_channelAdminLogEventsFilter_param_ban_type_true' => 'Ban events', - 'object_channelAdminLogEventsFilter_param_unban_type_true' => 'Unban events', - 'object_channelAdminLogEventsFilter_param_kick_type_true' => 'Kicked users events', - 'object_channelAdminLogEventsFilter_param_unkick_type_true' => 'Unkick events', - 'object_channelAdminLogEventsFilter_param_promote_type_true' => 'Admin promotion events', - 'object_channelAdminLogEventsFilter_param_demote_type_true' => 'Demote admin events', - 'object_channelAdminLogEventsFilter_param_info_type_true' => 'Change info events', - 'object_channelAdminLogEventsFilter_param_settings_type_true' => 'Setting changes', - 'object_channelAdminLogEventsFilter_param_pinned_type_true' => 'Pinned message events', - 'object_channelAdminLogEventsFilter_param_edit_type_true' => 'Edit message events', - 'object_channelAdminLogEventsFilter_param_delete_type_true' => 'Delete message events', + 'object_channelAdminLogEventsFilter' => 'Filter only certain admin log events', + 'object_channelAdminLogEventsFilter_param_join_type_true' => '[Join events](../constructors/channelAdminLogEventActionParticipantJoin.md)', + 'object_channelAdminLogEventsFilter_param_leave_type_true' => '[Leave events](../constructors/channelAdminLogEventActionParticipantLeave.md)', + 'object_channelAdminLogEventsFilter_param_invite_type_true' => '[Invite events](../constructors/channelAdminLogEventActionParticipantInvite.md)', + 'object_channelAdminLogEventsFilter_param_ban_type_true' => '[Ban events](../constructors/channelAdminLogEventActionParticipantToggleBan.md)', + 'object_channelAdminLogEventsFilter_param_unban_type_true' => '[Unban events](../constructors/channelAdminLogEventActionParticipantToggleBan.md)', + 'object_channelAdminLogEventsFilter_param_kick_type_true' => '[Kick events](../constructors/channelAdminLogEventActionParticipantToggleBan.md)', + 'object_channelAdminLogEventsFilter_param_unkick_type_true' => '[Unkick events](../constructors/channelAdminLogEventActionParticipantToggleBan.md)', + 'object_channelAdminLogEventsFilter_param_promote_type_true' => '[Admin promotion events](../constructors/channelAdminLogEventActionParticipantToggleAdmin.md)', + 'object_channelAdminLogEventsFilter_param_demote_type_true' => '[Admin demotion events](../constructors/channelAdminLogEventActionParticipantToggleAdmin.md)', + 'object_channelAdminLogEventsFilter_param_info_type_true' => 'Info change events (when [about](../constructors/channelAdminLogEventActionChangeAbout.md), [linked chat](../constructors/channelAdminLogEventActionChangeLinkedChat.md), [location](../constructors/channelAdminLogEventActionChangeLocation.md), [photo](../constructors/channelAdminLogEventActionChangePhoto.md), [stickerset](../constructors/channelAdminLogEventActionChangeStickerSet.md), [title](../constructors/channelAdminLogEventActionChangeTitle.md) or [username](../constructors/channelAdminLogEventActionChangeUsername.md) data of a channel gets modified)', + 'object_channelAdminLogEventsFilter_param_settings_type_true' => 'Settings change events ([invites](../constructors/channelAdminLogEventActionToggleInvites.md), [hidden prehistory](../constructors/channelAdminLogEventActionTogglePreHistoryHidden.md), [signatures](../constructors/channelAdminLogEventActionToggleSignatures.md), [default banned rights](../constructors/channelAdminLogEventActionDefaultBannedRights.md))', + 'object_channelAdminLogEventsFilter_param_pinned_type_true' => '[Message pin events](../constructors/channelAdminLogEventActionUpdatePinned.md)', + 'object_channelAdminLogEventsFilter_param_edit_type_true' => '[Message edit events](../constructors/channelAdminLogEventActionEditMessage.md)', + 'object_channelAdminLogEventsFilter_param_delete_type_true' => '[Message deletion events](../constructors/channelAdminLogEventActionDeleteMessage.md)', 'object_popularContact' => 'Popular contact', - 'object_popularContact_param_client_id_type_long' => 'Client ID', - 'object_popularContact_param_importers_type_int' => 'Importers', + 'object_popularContact_param_client_id_type_long' => 'Contact identifier', + 'object_popularContact_param_importers_type_int' => 'How many people imported this contact', 'object_cdnFileHash' => 'CDN file hash', 'object_cdnFileHash_param_offset_type_int' => 'Offset', 'object_cdnFileHash_param_limit_type_int' => 'Limit', 'object_cdnFileHash_param_hash_type_bytes' => 'Hash', - 'object_messages.favedStickersNotModified' => 'Faved stickers not modified', - 'object_messages.favedStickers' => 'Faved stickers', - 'object_messages.favedStickers_param_hash_type_int' => 'Hash', + 'object_messages.favedStickersNotModified' => 'No new favorited stickers were found', + 'object_messages.favedStickers' => 'Favorited stickers', + 'object_messages.favedStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)', 'object_messages.favedStickers_param_packs_type_Vector t' => 'Packs', 'object_messages.favedStickers_param_stickers_type_Vector t' => 'Stickers', - 'object_recentMeUrlUnknown' => 'Recent me URL unknown', + 'object_recentMeUrlUnknown' => 'Unknown t.me url', 'object_recentMeUrlUnknown_param_url_type_string' => 'URL', - 'object_recentMeUrlUser' => 'Recent me URL user', + 'object_recentMeUrlUser' => 'Recent t.me link to a user', 'object_recentMeUrlUser_param_url_type_string' => 'URL', 'object_recentMeUrlUser_param_user_id_type_int' => 'User ID', - 'object_recentMeUrlChat' => 'Recent me URL chat', - 'object_recentMeUrlChat_param_url_type_string' => 'URL', + 'object_recentMeUrlChat' => 'Recent t.me link to a chat', + 'object_recentMeUrlChat_param_url_type_string' => 't.me URL', 'object_recentMeUrlChat_param_chat_id_type_int' => 'Chat ID', - 'object_recentMeUrlChatInvite' => 'Recent me URL chat invite', - 'object_recentMeUrlChatInvite_param_url_type_string' => 'URL', - 'object_recentMeUrlChatInvite_param_chat_invite_type_ChatInvite' => 'Chat invite', - 'object_recentMeUrlStickerSet' => 'Recent me URL sticker set', - 'object_recentMeUrlStickerSet_param_url_type_string' => 'URL', - 'object_recentMeUrlStickerSet_param_set_type_StickerSetCovered' => 'Set', - 'object_help.recentMeUrls' => 'Recent me URLs', + 'object_recentMeUrlChatInvite' => 'Recent t.me invite link to a chat', + 'object_recentMeUrlChatInvite_param_url_type_string' => 't.me URL', + 'object_recentMeUrlChatInvite_param_chat_invite_type_ChatInvite' => 'Chat invitation', + 'object_recentMeUrlStickerSet' => 'Recent t.me stickerset installation URL', + 'object_recentMeUrlStickerSet_param_url_type_string' => 't.me URL', + 'object_recentMeUrlStickerSet_param_set_type_StickerSetCovered' => 'Stickerset', + 'object_help.recentMeUrls' => 'Recent t.me URLs', 'object_help.recentMeUrls_param_urls_type_Vector t' => 'URLs', 'object_help.recentMeUrls_param_chats_type_Vector t' => 'Chats', 'object_help.recentMeUrls_param_users_type_Vector t' => 'Users', - 'object_inputSingleMedia' => 'Single media', - 'object_inputSingleMedia_param_media_type_InputMedia' => 'Media', - 'object_inputSingleMedia_param_message_type_string' => 'Message', + 'object_inputSingleMedia' => 'A single media in an album sent with [messages.sendMultiMedia](../methods/messages.sendMultiMedia.md).', + 'object_inputSingleMedia_param_media_type_InputMedia' => 'The media', + 'object_inputSingleMedia_param_message_type_string' => 'A caption for the media', 'object_inputSingleMedia_param_entities_type_Vector t' => 'Entities', - 'object_webAuthorization' => 'Web authorization', - 'object_webAuthorization_param_hash_type_long' => 'Hash', + 'object_webAuthorization' => 'Represents a bot logged in using the [Telegram login widget](https://core.telegram.org/widgets/login)', + 'object_webAuthorization_param_hash_type_long' => 'Authorization hash', 'object_webAuthorization_param_bot_id_type_int' => 'Bot ID', - 'object_webAuthorization_param_domain_type_string' => 'Domain', - 'object_webAuthorization_param_browser_type_string' => 'Browser', + 'object_webAuthorization_param_domain_type_string' => 'The domain name of the website on which the user has logged in.', + 'object_webAuthorization_param_browser_type_string' => 'Browser user-agent', 'object_webAuthorization_param_platform_type_string' => 'Platform', - 'object_webAuthorization_param_date_created_type_int' => 'Date created', - 'object_webAuthorization_param_date_active_type_int' => 'Date active', - 'object_webAuthorization_param_ip_type_string' => 'Ip', - 'object_webAuthorization_param_region_type_string' => 'Region', - 'object_account.webAuthorizations' => 'Telegram login authorizations', + 'object_webAuthorization_param_date_created_type_int' => 'When was the web session created', + 'object_webAuthorization_param_date_active_type_int' => 'When was the web session last active', + 'object_webAuthorization_param_ip_type_string' => 'IP address', + 'object_webAuthorization_param_region_type_string' => 'Region, determined from IP address', + 'object_account.webAuthorizations' => 'Web authorizations', 'object_account.webAuthorizations_param_authorizations_type_Vector t' => 'Authorizations', 'object_account.webAuthorizations_param_users_type_Vector t' => 'Users', - 'object_inputMessageID' => 'Message ID', - 'object_inputMessageID_param_id_type_int' => 'ID', - 'object_inputMessageReplyTo' => 'Message reply to', - 'object_inputMessageReplyTo_param_id_type_int' => 'ID', - 'object_inputMessagePinned' => 'Message pinned', + 'object_inputMessageID' => 'Message by ID', + 'object_inputMessageID_param_id_type_int' => 'Message ID', + 'object_inputMessageReplyTo' => 'Message to which the specified message replies to', + 'object_inputMessageReplyTo_param_id_type_int' => 'ID of the message that replies to the message we need', + 'object_inputMessagePinned' => 'Pinned message', 'object_decryptedDataBlock' => 'Decrypted data block', 'object_decryptedDataBlock_param_voice_call_id_type_int128' => 'Voice call ID', 'object_decryptedDataBlock_param_in_seq_no_type_int' => 'In seq no', @@ -3501,85 +3522,87 @@ class Lang 'object_decryptedDataBlock_param_raw_data_type_string' => 'Raw data', 'object_simpleDataBlock' => 'Simple data block', 'object_simpleDataBlock_param_raw_data_type_string' => 'Raw data', - 'object_decryptedMessage' => 'Decrypted message', - 'object_decryptedMessage_param_message_type_string' => 'Message', - 'object_decryptedMessage_param_media_type_DecryptedMessageMedia' => 'Media', - 'object_decryptedMessageService' => 'Decrypted message service', - 'object_decryptedMessageService_param_action_type_DecryptedMessageAction' => 'Action', - 'object_decryptedMessageMediaEmpty' => 'Empty decrypted message media', - 'object_decryptedMessageMediaPhoto' => 'Decrypted message media photo', - 'object_decryptedMessageMediaPhoto_param_thumb_type_bytes' => 'Thumbnail', + 'object_decryptedMessage' => 'Contents of an encrypted message.', + 'object_decryptedMessage_param_message_type_string' => 'Message text', + 'object_decryptedMessage_param_media_type_DecryptedMessageMedia' => 'Media content', + 'object_decryptedMessageService' => 'Contents of an encrypted service message.', + 'object_decryptedMessageService_param_action_type_DecryptedMessageAction' => 'Action relevant to the service message', + 'object_decryptedMessageMediaEmpty' => 'Empty constructor, no media content.', + 'object_decryptedMessageMediaPhoto' => 'Photo attached to an encrypted message.', + 'object_decryptedMessageMediaPhoto_param_thumb_type_bytes' => 'Content of thumbnail file (JPEGfile, quality 55, set in a square 90x90)', 'object_decryptedMessageMediaPhoto_param_thumb_w_type_int' => 'Thumbnail width', 'object_decryptedMessageMediaPhoto_param_thumb_h_type_int' => 'Thumbnail height', - 'object_decryptedMessageMediaPhoto_param_w_type_int' => 'Width', - 'object_decryptedMessageMediaPhoto_param_h_type_int' => 'Height', - 'object_decryptedMessageMediaPhoto_param_size_type_int' => 'Size', - 'object_decryptedMessageMediaVideo' => 'Decrypted message media video', - 'object_decryptedMessageMediaVideo_param_thumb_type_bytes' => 'Thumbnail', + 'object_decryptedMessageMediaPhoto_param_w_type_int' => 'Photo width', + 'object_decryptedMessageMediaPhoto_param_h_type_int' => 'Photo height', + 'object_decryptedMessageMediaPhoto_param_size_type_int' => 'Size of the photo in bytes', + 'object_decryptedMessageMediaVideo' => 'Video attached to an encrypted message.', + 'object_decryptedMessageMediaVideo_param_thumb_type_bytes' => 'Content of thumbnail file (JPEG file, quality 55, set in a square 90x90)', 'object_decryptedMessageMediaVideo_param_thumb_w_type_int' => 'Thumbnail width', 'object_decryptedMessageMediaVideo_param_thumb_h_type_int' => 'Thumbnail height', - 'object_decryptedMessageMediaVideo_param_duration_type_int' => 'Duration', - 'object_decryptedMessageMediaVideo_param_w_type_int' => 'Width', - 'object_decryptedMessageMediaVideo_param_h_type_int' => 'Height', - 'object_decryptedMessageMediaVideo_param_size_type_int' => 'Size', - 'object_decryptedMessageMediaGeoPoint' => 'Decrypted message media geo point', - 'object_decryptedMessageMediaGeoPoint_param_lat_type_double' => 'Lat', - 'object_decryptedMessageMediaGeoPoint_param_long_type_double' => 'Long', - 'object_decryptedMessageMediaContact' => 'Decrypted message media contact', + 'object_decryptedMessageMediaVideo_param_duration_type_int' => 'Duration of video in seconds', + 'object_decryptedMessageMediaVideo_param_w_type_int' => 'Image width', + 'object_decryptedMessageMediaVideo_param_h_type_int' => 'Image height', + 'object_decryptedMessageMediaVideo_param_size_type_int' => 'File size', + 'object_decryptedMessageMediaGeoPoint' => 'GeoPont attached to an encrypted message.', + 'object_decryptedMessageMediaGeoPoint_param_lat_type_double' => 'Latitude of point', + 'object_decryptedMessageMediaGeoPoint_param_long_type_double' => 'Longtitude of point', + 'object_decryptedMessageMediaContact' => 'Contact attached to an encrypted message.', 'object_decryptedMessageMediaContact_param_phone_number_type_string' => 'Phone number', - 'object_decryptedMessageMediaContact_param_first_name_type_string' => 'First name', - 'object_decryptedMessageMediaContact_param_last_name_type_string' => 'Last name', - 'object_decryptedMessageMediaContact_param_user_id_type_int' => 'User ID', - 'object_decryptedMessageActionSetMessageTTL' => 'Decrypted message action set message ttl', - 'object_decryptedMessageActionSetMessageTTL_param_ttl_seconds_type_int' => 'Ttl seconds', - 'object_decryptedMessageMediaDocument' => 'Decrypted message media document', - 'object_decryptedMessageMediaDocument_param_thumb_type_bytes' => 'Thumbnail', - 'object_decryptedMessageMediaDocument_param_thumb_w_type_int' => 'Thumbnail w', - 'object_decryptedMessageMediaDocument_param_thumb_h_type_int' => 'Thumbnail h', + 'object_decryptedMessageMediaContact_param_first_name_type_string' => 'Contact\'s first name', + 'object_decryptedMessageMediaContact_param_last_name_type_string' => 'Contact\'s last name', + 'object_decryptedMessageMediaContact_param_user_id_type_int' => 'Telegram User ID of signed-up contact', + 'object_decryptedMessageActionSetMessageTTL' => 'Setting of a message lifetime after reading. + +Upon receiving such message the client shall start deleting of all messages of an encrypted chat **ttl\\_seconds** seconds after the messages were read by user.', + 'object_decryptedMessageActionSetMessageTTL_param_ttl_seconds_type_int' => 'Lifetime in seconds', + 'object_decryptedMessageMediaDocument' => 'Document attached to a message in a secret chat.', + 'object_decryptedMessageMediaDocument_param_thumb_type_bytes' => 'Thumbnail-file contents (JPEG-file, quality 55, set in a 90x90 square)', + 'object_decryptedMessageMediaDocument_param_thumb_w_type_int' => 'Thumbnail width', + 'object_decryptedMessageMediaDocument_param_thumb_h_type_int' => 'Thumbnail height', 'object_decryptedMessageMediaDocument_param_file_name_type_string' => 'File name', - 'object_decryptedMessageMediaDocument_param_mime_type_type_string' => 'Mime type', - 'object_decryptedMessageMediaDocument_param_size_type_int' => 'Size', - 'object_decryptedMessageMediaAudio' => 'Decrypted message media audio', - 'object_decryptedMessageMediaAudio_param_duration_type_int' => 'Duration', - 'object_decryptedMessageMediaAudio_param_size_type_int' => 'Size', - 'object_decryptedMessageActionReadMessages' => 'Decrypted message action read messages', + 'object_decryptedMessageMediaDocument_param_mime_type_type_string' => 'File MIME-type', + 'object_decryptedMessageMediaDocument_param_size_type_int' => 'Document size', + 'object_decryptedMessageMediaAudio' => 'Audio file attached to a secret chat message.', + 'object_decryptedMessageMediaAudio_param_duration_type_int' => 'Audio duration in seconds', + 'object_decryptedMessageMediaAudio_param_size_type_int' => 'File size', + 'object_decryptedMessageActionReadMessages' => 'Messages marked as read.', 'object_decryptedMessageActionReadMessages_param_random_ids_type_Vector t' => 'Random IDs', - 'object_decryptedMessageActionDeleteMessages' => 'Decrypted message action delete messages', + 'object_decryptedMessageActionDeleteMessages' => 'Deleted messages.', 'object_decryptedMessageActionDeleteMessages_param_random_ids_type_Vector t' => 'Random IDs', - 'object_decryptedMessageActionScreenshotMessages' => 'Decrypted message action screenshot messages', + 'object_decryptedMessageActionScreenshotMessages' => 'A screenshot was taken.', 'object_decryptedMessageActionScreenshotMessages_param_random_ids_type_Vector t' => 'Random IDs', - 'object_decryptedMessageActionFlushHistory' => 'Decrypted message action flush history', - 'object_decryptedMessage_param_ttl_type_int' => 'Ttl', - 'object_decryptedMessageMediaVideo_param_mime_type_type_string' => 'Mime type', - 'object_decryptedMessageMediaAudio_param_mime_type_type_string' => 'Mime type', - 'object_decryptedMessageLayer' => 'Decrypted message layer', - 'object_decryptedMessageLayer_param_layer_type_int' => 'Layer', - 'object_decryptedMessageLayer_param_in_seq_no_type_int' => 'In seq no', - 'object_decryptedMessageLayer_param_out_seq_no_type_int' => 'Out seq no', - 'object_decryptedMessageLayer_param_message_type_DecryptedMessage' => 'Message', - 'object_decryptedMessageActionResend' => 'Decrypted message action resend', - 'object_decryptedMessageActionResend_param_start_seq_no_type_int' => 'Start seq no', - 'object_decryptedMessageActionResend_param_end_seq_no_type_int' => 'End seq no', - 'object_decryptedMessageActionNotifyLayer' => 'Decrypted message action notify layer', - 'object_decryptedMessageActionNotifyLayer_param_layer_type_int' => 'Layer', - 'object_decryptedMessageActionTyping' => 'Decrypted message action typing', - 'object_decryptedMessageActionTyping_param_action_type_SendMessageAction' => 'Action', - 'object_decryptedMessageActionRequestKey' => 'Decrypted message action request key', + 'object_decryptedMessageActionFlushHistory' => 'The entire message history has been deleted.', + 'object_decryptedMessage_param_ttl_type_int' => 'Message lifetime. Has higher priority than [decryptedMessageActionSetMessageTTL](../constructors/decryptedMessageActionSetMessageTTL.md).
Parameter added in [Layer 17](https://core.telegram.org/api/layers#layer-17).', + 'object_decryptedMessageMediaVideo_param_mime_type_type_string' => 'MIME-type of the video file
Parameter added in [Layer 17](https://core.telegram.org/api/layers#layer-17).', + 'object_decryptedMessageMediaAudio_param_mime_type_type_string' => 'MIME-type of the audio file
Parameter added in [Layer 13](https://core.telegram.org/api/layers#layer-13).', + 'object_decryptedMessageLayer' => 'Sets the layer number for the contents of an encrypted message.', + 'object_decryptedMessageLayer_param_layer_type_int' => 'Layer number. Mimimal value - **17** (the layer in which the constructor was added).', + 'object_decryptedMessageLayer_param_in_seq_no_type_int' => '2x the number of messages in the sender\'s inbox (including deleted and service messages), incremented by 1 if current user was not the chat creator
Parameter added in [Layer 17](https://core.telegram.org/api/layers#layer-17).', + 'object_decryptedMessageLayer_param_out_seq_no_type_int' => '2x the number of messages in the recipient\'s inbox (including deleted and service messages), incremented by 1 if current user was the chat creator
Parameter added in [Layer 17](https://core.telegram.org/api/layers#layer-17).', + 'object_decryptedMessageLayer_param_message_type_DecryptedMessage' => 'The content of message itself', + 'object_decryptedMessageActionResend' => 'Request for the other party in a Secret Chat to automatically resend a contiguous range of previously sent messages, as explained in [Sequence number is Secret Chats](https://core.telegram.org/api/end-to-end/seq_no).', + 'object_decryptedMessageActionResend_param_start_seq_no_type_int' => '`out_seq_no` of the first message to be resent, with correct parity', + 'object_decryptedMessageActionResend_param_end_seq_no_type_int' => '`out_seq_no` of the last message to be resent, with same parity.', + 'object_decryptedMessageActionNotifyLayer' => 'A notification stating the API layer that is used by the client. You should use your current layer and take notice of the layer used on the other side of a conversation when sending messages.', + 'object_decryptedMessageActionNotifyLayer_param_layer_type_int' => 'Layer number, must be **17** or higher (this contructor was introduced in [Layer 17](https://core.telegram.org/api/layers#layer-17)).', + 'object_decryptedMessageActionTyping' => 'User is preparing a message: typing, recording, uploading, etc.', + 'object_decryptedMessageActionTyping_param_action_type_SendMessageAction' => 'Type of action', + 'object_decryptedMessageActionRequestKey' => 'Request rekeying, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)', 'object_decryptedMessageActionRequestKey_param_exchange_id_type_long' => 'Exchange ID', - 'object_decryptedMessageActionRequestKey_param_g_a_type_bytes' => 'G a', - 'object_decryptedMessageActionAcceptKey' => 'Decrypted message action accept key', + 'object_decryptedMessageActionRequestKey_param_g_a_type_bytes' => 'g\\_a, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)', + 'object_decryptedMessageActionAcceptKey' => 'Accept new key', 'object_decryptedMessageActionAcceptKey_param_exchange_id_type_long' => 'Exchange ID', - 'object_decryptedMessageActionAcceptKey_param_g_b_type_bytes' => 'G b', - 'object_decryptedMessageActionAcceptKey_param_key_fingerprint_type_long' => 'Key fingerprint', - 'object_decryptedMessageActionAbortKey' => 'Decrypted message action abort key', + 'object_decryptedMessageActionAcceptKey_param_g_b_type_bytes' => 'B parameter, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)', + 'object_decryptedMessageActionAcceptKey_param_key_fingerprint_type_long' => 'Key fingerprint, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)', + 'object_decryptedMessageActionAbortKey' => 'Abort rekeying', 'object_decryptedMessageActionAbortKey_param_exchange_id_type_long' => 'Exchange ID', - 'object_decryptedMessageActionCommitKey' => 'Decrypted message action commit key', - 'object_decryptedMessageActionCommitKey_param_exchange_id_type_long' => 'Exchange ID', - 'object_decryptedMessageActionCommitKey_param_key_fingerprint_type_long' => 'Key fingerprint', - 'object_decryptedMessageActionNoop' => 'Decrypted message action noop', - 'object_decryptedMessageMediaExternalDocument' => 'Decrypted message media external document', - 'object_decryptedMessageMediaExternalDocument_param_id_type_long' => 'ID', - 'object_decryptedMessageMediaExternalDocument_param_access_hash_type_long' => 'Access hash', + 'object_decryptedMessageActionCommitKey' => 'Commit new key, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)', + 'object_decryptedMessageActionCommitKey_param_exchange_id_type_long' => 'Exchange ID, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)', + 'object_decryptedMessageActionCommitKey_param_key_fingerprint_type_long' => 'Key fingerprint, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)', + 'object_decryptedMessageActionNoop' => 'NOOP action', + 'object_decryptedMessageMediaExternalDocument' => 'Non-e2e documented forwarded from non-secret chat', + 'object_decryptedMessageMediaExternalDocument_param_id_type_long' => 'Document ID', + 'object_decryptedMessageMediaExternalDocument_param_access_hash_type_long' => 'access hash', 'object_decryptedMessageMediaExternalDocument_param_date_type_int' => 'Date', 'object_decryptedMessageMediaExternalDocument_param_mime_type_type_string' => 'Mime type', 'object_decryptedMessageMediaExternalDocument_param_size_type_int' => 'Size', @@ -3587,22 +3610,22 @@ class Lang 'object_decryptedMessageMediaExternalDocument_param_dc_id_type_int' => 'DC ID', 'object_decryptedMessageMediaExternalDocument_param_attributes_type_Vector t' => 'Attributes', 'object_decryptedMessage_param_entities_type_Vector t' => 'Entities', - 'object_decryptedMessage_param_via_bot_name_type_string' => 'Via bot name', - 'object_decryptedMessage_param_reply_to_random_id_type_long' => 'Reply to random ID', + 'object_decryptedMessage_param_via_bot_name_type_string' => 'Specifies the ID of the inline bot that generated the message (parameter added in layer 45)', + 'object_decryptedMessage_param_reply_to_random_id_type_long' => 'Random message ID of the message this message replies to (parameter added in layer 45)', 'object_decryptedMessageMediaPhoto_param_caption_type_string' => 'Caption', 'object_decryptedMessageMediaVideo_param_caption_type_string' => 'Caption', 'object_decryptedMessageMediaDocument_param_attributes_type_Vector t' => 'Attributes', 'object_decryptedMessageMediaDocument_param_caption_type_string' => 'Caption', - 'object_decryptedMessageMediaVenue' => 'Decrypted message media venue', - 'object_decryptedMessageMediaVenue_param_lat_type_double' => 'Lat', - 'object_decryptedMessageMediaVenue_param_long_type_double' => 'Long', - 'object_decryptedMessageMediaVenue_param_title_type_string' => 'Title', + 'object_decryptedMessageMediaVenue' => 'Venue', + 'object_decryptedMessageMediaVenue_param_lat_type_double' => 'Latitude of venue', + 'object_decryptedMessageMediaVenue_param_long_type_double' => 'Longitude of venue', + 'object_decryptedMessageMediaVenue_param_title_type_string' => 'Venue name', 'object_decryptedMessageMediaVenue_param_address_type_string' => 'Address', - 'object_decryptedMessageMediaVenue_param_provider_type_string' => 'Provider', - 'object_decryptedMessageMediaVenue_param_venue_id_type_string' => 'Venue ID', - 'object_decryptedMessageMediaWebPage' => 'Decrypted message media web page', - 'object_decryptedMessageMediaWebPage_param_url_type_string' => 'URL', - 'object_decryptedMessage_param_grouped_id_type_long' => 'Grouped ID', + 'object_decryptedMessageMediaVenue_param_provider_type_string' => 'Venue provider: currently only "foursquare" needs to be supported', + 'object_decryptedMessageMediaVenue_param_venue_id_type_string' => 'Venue ID in the provider\'s database', + 'object_decryptedMessageMediaWebPage' => 'Webpage preview', + 'object_decryptedMessageMediaWebPage_param_url_type_string' => 'URL of webpage', + 'object_decryptedMessage_param_grouped_id_type_long' => 'Random group ID, assigned by the author of message.
Multiple encrypted messages with a photo attached and with the same group ID indicate an album (parameter added in layer 45)', 'object_inputPeerContact' => 'Peer contact', 'object_inputPeerContact_param_user_id_type_int' => 'User ID', 'object_inputPeerForeign' => 'Peer foreign', @@ -3682,11 +3705,11 @@ class Lang 'object_userDeleted_param_first_name_type_string' => 'First name', 'object_userDeleted_param_last_name_type_string' => 'Last name', 'object_userDeleted_param_username_type_string' => 'Username', - 'object_userStatusEmpty' => 'Empty user status', - 'object_userStatusOnline' => 'User status online', - 'object_userStatusOnline_param_expires_type_int' => 'Expires', - 'object_userStatusOffline' => 'User status offline', - 'object_userStatusOffline_param_was_online_type_int' => 'Was online', + 'object_userStatusEmpty' => 'User status has not been set yet.', + 'object_userStatusOnline' => 'Online status of the user.', + 'object_userStatusOnline_param_expires_type_int' => 'Time to expiration of the current online status', + 'object_userStatusOffline' => 'The user\'s offline status.', + 'object_userStatusOffline_param_was_online_type_int' => 'Time the user was last seen online', 'object_chat_param_left_type_Bool' => 'Left?', 'object_chatForbidden_param_date_type_int' => 'Date', 'object_chatParticipants_param_admin_id_type_int' => 'Admin ID', @@ -3726,9 +3749,9 @@ class Lang 'object_auth.sentCode_param_send_call_timeout_type_int' => 'Send call timeout', 'object_auth.sentCode_param_is_password_type_Bool' => 'Is password?', 'object_auth.authorization_param_expires_type_int' => 'Expiration date', - 'object_inputPeerNotifySettings_param_show_previews_type_Bool' => 'Show previews?', + 'object_inputPeerNotifySettings_param_show_previews_type_Bool' => 'If the text of the message shall be displayed in notification', 'object_inputPeerNotifySettings_param_events_mask_type_int' => 'Events mask', - 'object_peerNotifySettings_param_show_previews_type_Bool' => 'Show previews?', + 'object_peerNotifySettings_param_show_previews_type_Bool' => 'Display text in notifications', 'object_peerNotifySettings_param_events_mask_type_int' => 'Events mask', 'object_userFull_param_blocked_type_Bool' => 'Blocked?', 'object_userFull_param_real_first_name_type_string' => 'Real first name', @@ -3775,9 +3798,9 @@ class Lang 'object_updateReadMessages' => 'Update read messages', 'object_updateReadMessages_param_messages_type_Vector t' => 'Messages', 'object_updateReadMessages_param_pts_type_int' => 'Pts', - 'object_updateUserStatus' => 'Update user status', - 'object_updateUserStatus_param_user_id_type_int' => 'User ID', - 'object_updateUserStatus_param_status_type_UserStatus' => 'Status', + 'object_updateUserStatus' => 'Contact status update.', + 'object_updateUserStatus_param_user_id_type_int' => 'User identifier', + 'object_updateUserStatus_param_status_type_UserStatus' => 'New status', 'object_updateContactLink_param_my_link_type_contacts.MyLink' => 'My link', 'object_updateContactLink_param_foreign_link_type_contacts.ForeignLink' => 'Foreign link', 'object_updateNewAuthorization' => 'Update new authorization', @@ -3853,9 +3876,9 @@ class Lang 'object_contactFound_param_user_id_type_int' => 'User ID', 'object_updateServiceNotification_param_popup_type_Bool' => 'Popup?', 'object_inputMediaUploadedThumbDocument_param_attributes_type_Vector t' => 'Attributes', - 'object_userStatusRecently' => 'User status recently', - 'object_userStatusLastWeek' => 'User status last week', - 'object_userStatusLastMonth' => 'User status last month', + 'object_userStatusRecently' => 'Online status: last seen recently', + 'object_userStatusLastWeek' => 'Online status: last seen last week', + 'object_userStatusLastMonth' => 'Online status: last seen last month', 'object_account.sentChangePhoneCode' => 'Sent change phone code', 'object_account.sentChangePhoneCode_param_phone_code_hash_type_string' => 'Phone code hash', 'object_account.sentChangePhoneCode_param_send_call_timeout_type_int' => 'Send call timeout', @@ -3946,9 +3969,9 @@ class Lang 'object_inputMediaVideo_param_caption_type_string' => 'Caption', 'object_messageMediaPhoto_param_caption_type_string' => 'Caption', 'object_messageMediaVideo_param_caption_type_string' => 'Caption', - 'object_botCommand' => 'Bot command', - 'object_botCommand_param_command_type_string' => 'Command', - 'object_botCommand_param_description_type_string' => 'Description', + 'object_botCommand' => 'Describes a bot command that can be used in a chat', + 'object_botCommand_param_command_type_string' => '`/command` name', + 'object_botCommand_param_description_type_string' => 'Description of the command', 'object_botInfoEmpty' => 'Empty bot info', 'object_botInfo_param_version_type_int' => 'Version', 'object_botInfo_param_share_text_type_string' => 'Share text', @@ -4059,7 +4082,7 @@ class Lang 'object_updates.channelDifferenceEmpty_param_channel_pts_type_int' => 'Channel pts', 'object_updates.channelDifferenceTooLong_param_channel_pts_type_int' => 'Channel pts', 'object_updates.channelDifference_param_channel_pts_type_int' => 'Channel pts', - 'object_privacyKeyChatInvite' => 'Privacy key chat invite', + 'object_privacyKeyChatInvite' => 'Whether the user can be invited to chats', 'object_inputMediaUploadedThumbDocument_param_stickers_type_Vector t' => 'Stickers', 'object_inputMediaPhotoExternal_param_caption_type_string' => 'Caption', 'object_inputMediaDocumentExternal_param_caption_type_string' => 'Caption', @@ -4069,15 +4092,15 @@ class Lang 'object_help.appChangelog_param_message_type_string' => 'Message', 'object_help.appChangelog_param_media_type_MessageMedia' => 'Media', 'object_help.appChangelog_param_entities_type_Vector t' => 'Entities', - 'object_pageBlockParagraph' => 'Page block paragraph', + 'object_pageBlockParagraph' => 'A paragraph', 'object_pageBlockParagraph_param_text_type_RichText' => 'Text', - 'object_pageBlockPreformatted' => 'Page block preformatted', + 'object_pageBlockPreformatted' => 'Preformatted (`
` text)',
     'object_pageBlockPreformatted_param_text_type_RichText' => 'Text',
-    'object_pageBlockPreformatted_param_language_type_string' => 'Language',
-    'object_pageBlockDivider' => 'Page block divider',
-    'object_pageBlockAnchor' => 'Page block anchor',
-    'object_pageBlockAnchor_param_name_type_string' => 'Name',
-    'object_pageBlockCover' => 'Page block cover',
+    'object_pageBlockPreformatted_param_language_type_string' => 'Programming language of preformatted text',
+    'object_pageBlockDivider' => 'An empty block separating a page',
+    'object_pageBlockAnchor' => 'Link to section within the page itself (like `anchor`)',
+    'object_pageBlockAnchor_param_name_type_string' => 'Name of target section',
+    'object_pageBlockCover' => 'A page cover',
     'object_pageBlockCover_param_cover_type_PageBlock' => 'Cover',
     'object_pagePart_param_videos_type_Vector t' => 'Videos',
     'object_pageFull_param_videos_type_Vector t' => 'Videos',
@@ -4105,131 +4128,133 @@ class Lang
     'object_help.configSimple_param_dc_id_type_int' => 'DC ID',
     'object_help.configSimple_param_ip_port_list_type_Vector t' => 'Ip port list',
     'object_inputMessagesFilterMyMentionsUnread' => 'Messages filter my mentions unread',
-    'method_initConnection_param_proxy_type_InputClientProxy' => 'The current proxy',
-    'method_account.registerDevice_param_secret_type_bytes' => 'Secret',
-    'method_account.getAllSecureValues' => 'Get all secure telegram passport values',
-    'method_account.getSecureValue' => 'Get secure value for telegram passport',
+    'method_initConnection_param_proxy_type_InputClientProxy' => 'Info about an MTProto proxy',
+    'method_account.registerDevice_param_secret_type_bytes' => 'For FCM and APNS VoIP, optional encryption key used to encrypt push notifications',
+    'method_account.getAllSecureValues' => 'Get all saved [Telegram Passport](https://core.telegram.org/passport) documents, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
+    'method_account.getSecureValue' => 'Get saved [Telegram Passport](https://core.telegram.org/passport) document, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
     'method_account.getSecureValue_param_types_type_Vector t' => 'Get telegram passport secure parameters',
-    'method_account.saveSecureValue' => 'Save telegram passport secure value',
-    'method_account.saveSecureValue_param_value_type_InputSecureValue' => 'Encrypted value',
-    'method_account.saveSecureValue_param_secure_secret_id_type_long' => 'Secret',
-    'method_account.deleteSecureValue' => 'Delete secure telegram passport value',
+    'method_account.saveSecureValue' => 'Securely save [Telegram Passport](https://core.telegram.org/passport) document, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
+    'method_account.saveSecureValue_param_value_type_InputSecureValue' => 'Secure value, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
+    'method_account.saveSecureValue_param_secure_secret_id_type_long' => 'Passport secret hash, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
+    'method_account.deleteSecureValue' => 'Delete stored [Telegram Passport](https://core.telegram.org/passport) documents, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
     'method_account.deleteSecureValue_param_types_type_Vector t' => 'The values to delete',
-    'method_account.getAuthorizationForm' => 'Bots only: get telegram passport authorization form',
-    'method_account.getAuthorizationForm_param_bot_id_type_int' => 'Bot ID',
-    'method_account.getAuthorizationForm_param_scope_type_string' => 'Scope',
-    'method_account.getAuthorizationForm_param_public_key_type_string' => 'Bot\'s public key',
-    'method_account.acceptAuthorization' => 'Accept telegram passport authorization',
+    'method_account.getAuthorizationForm' => 'Returns a Telegram Passport authorization form for sharing data with a service',
+    'method_account.getAuthorizationForm_param_bot_id_type_int' => 'User identifier of the service\'s bot',
+    'method_account.getAuthorizationForm_param_scope_type_string' => 'Telegram Passport element types requested by the service',
+    'method_account.getAuthorizationForm_param_public_key_type_string' => 'Service\'s public key',
+    'method_account.acceptAuthorization' => 'Sends a Telegram Passport authorization form, effectively sharing data with the service',
     'method_account.acceptAuthorization_param_bot_id_type_int' => 'Bot ID',
-    'method_account.acceptAuthorization_param_scope_type_string' => 'Scope',
-    'method_account.acceptAuthorization_param_public_key_type_string' => 'The bot\'s RSA public key',
+    'method_account.acceptAuthorization_param_scope_type_string' => 'Telegram Passport element types requested by the service',
+    'method_account.acceptAuthorization_param_public_key_type_string' => 'Service\'s public key',
     'method_account.acceptAuthorization_param_value_hashes_type_Vector t' => 'Hashes of the encrypted credentials',
-    'method_account.acceptAuthorization_param_credentials_type_SecureCredentialsEncrypted' => 'Encrypted secure credentials',
-    'method_account.sendVerifyPhoneCode' => 'Send phone verification code',
+    'method_account.acceptAuthorization_param_credentials_type_SecureCredentialsEncrypted' => 'Encrypted values',
+    'method_account.sendVerifyPhoneCode' => 'Send the verification phone code for telegram [passport](https://core.telegram.org/passport).',
     'method_account.sendVerifyPhoneCode_param_allow_flashcall_type_true' => 'Allow phone calls?',
-    'method_account.sendVerifyPhoneCode_param_phone_number_type_string' => 'The phone number',
+    'method_account.sendVerifyPhoneCode_param_phone_number_type_string' => 'The phone number to verify',
     'method_account.sendVerifyPhoneCode_param_current_number_type_Bool' => 'Is this the current number?',
-    'method_account.verifyPhone' => 'Verify phone number',
-    'method_account.verifyPhone_param_phone_number_type_string' => 'The phone number',
-    'method_account.verifyPhone_param_phone_code_hash_type_string' => 'The phone code hash returned by account.sendVerifyPhoneCode',
-    'method_account.verifyPhone_param_phone_code_type_string' => 'The phone code type returned by account.sendVerifyPhoneCode',
-    'method_account.sendVerifyEmailCode' => 'Send email verification code',
-    'method_account.sendVerifyEmailCode_param_email_type_string' => 'Email',
-    'method_account.verifyEmail' => 'Verify email address',
-    'method_account.verifyEmail_param_email_type_string' => 'The email address',
-    'method_account.verifyEmail_param_code_type_string' => 'The received code',
-    'method_users.setSecureValueErrors' => 'Set secure value error for telegram passport',
-    'method_users.setSecureValueErrors_param_id_type_InputUser' => 'The user ID',
+    'method_account.verifyPhone' => 'Verify a phone number for telegram [passport](https://core.telegram.org/passport).',
+    'method_account.verifyPhone_param_phone_number_type_string' => 'Phone number',
+    'method_account.verifyPhone_param_phone_code_hash_type_string' => 'Phone code hash received from the call to [account.sendVerifyPhoneCode](../methods/account.sendVerifyPhoneCode.md)',
+    'method_account.verifyPhone_param_phone_code_type_string' => 'Code received after the call to [account.sendVerifyPhoneCode](../methods/account.sendVerifyPhoneCode.md)',
+    'method_account.sendVerifyEmailCode' => 'Send the verification email code for telegram [passport](https://core.telegram.org/passport).',
+    'method_account.sendVerifyEmailCode_param_email_type_string' => 'The email where to send the code',
+    'method_account.verifyEmail' => 'Verify an email address for telegram [passport](https://core.telegram.org/passport).',
+    'method_account.verifyEmail_param_email_type_string' => 'The email to verify',
+    'method_account.verifyEmail_param_code_type_string' => 'The verification code that was received',
+    'method_users.setSecureValueErrors' => 'Notify the user that the sent [passport](https://core.telegram.org/passport) data contains some errors The user will not be able to re-submit their Passport data to you until the errors are fixed (the contents of the field for which you returned the error must change).
+
+Use this if the data submitted by the user doesn\'t satisfy the standards your service requires for any reason. For example, if a birthday date seems invalid, a submitted document is blurry, a scan shows evidence of tampering, etc. Supply some details in the error message to make sure the user knows how to correct the issues.',
+    'method_users.setSecureValueErrors_param_id_type_InputUser' => 'The user',
     'method_users.setSecureValueErrors_param_errors_type_Vector t' => 'The errors',
-    'method_messages.search_param_hash_type_int' => 'IDs of messages you already fetched',
-    'method_messages.report' => 'Report a message',
-    'method_messages.report_param_peer_type_InputPeer' => 'The user that sent the messages',
+    'method_messages.search_param_hash_type_int' => '[Hash](https://core.telegram.org/api/offsets)',
+    'method_messages.report' => 'Report a message in a chat for violation of telegram\'s Terms of Service',
+    'method_messages.report_param_peer_type_InputPeer' => 'Peer',
     'method_messages.report_param_id_type_Vector t' => 'The messages to report',
-    'method_messages.report_param_reason_type_ReportReason' => 'The reason why you\'re sending this report',
-    'method_messages.getStickers_param_hash_type_int' => 'IDs of previously fetched stickers',
-    'method_messages.editMessage_param_media_type_InputMedia' => 'The media to substitute',
-    'method_messages.editInlineBotMessage_param_media_type_InputMedia' => 'The media to substitute',
+    'method_messages.report_param_reason_type_ReportReason' => 'Why are these messages being reported',
+    'method_messages.getStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+    'method_messages.editMessage_param_media_type_InputMedia' => 'New attached media',
+    'method_messages.editInlineBotMessage_param_media_type_InputMedia' => 'Media',
     'method_messages.toggleDialogPin_param_peer_type_InputDialogPeer' => 'The dialog to pin',
-    'method_messages.getRecentLocations_param_hash_type_int' => 'IDs of previously fetched locations',
-    'method_messages.searchStickerSets' => 'Find a sticker set',
-    'method_messages.searchStickerSets_param_exclude_featured_type_true' => 'Exclude featured sticker sets from the search?',
-    'method_messages.searchStickerSets_param_q_type_string' => 'The search query',
-    'method_messages.searchStickerSets_param_hash_type_int' => 'Ids of stickers you already cached',
-    'method_upload.getFileHashes' => 'Get file hashes',
-    'method_upload.getFileHashes_param_location_type_InputFileLocation' => 'The file',
-    'method_upload.getFileHashes_param_offset_type_int' => 'Offset',
-    'method_help.getProxyData' => 'Get information about the current proxy',
-    'method_help.getTermsOfServiceUpdate' => 'Get updated TOS',
-    'method_help.acceptTermsOfService' => 'Accept telegram\'s TOS',
-    'method_help.acceptTermsOfService_param_id_type_DataJSON' => 'TOS',
-    'method_help.getDeepLinkInfo' => 'Get deep link info',
-    'method_help.getDeepLinkInfo_param_path_type_string' => 'Deep link',
-    'object_inputSecureFileLocation' => 'Secure file location',
-    'object_inputSecureFileLocation_param_id_type_long' => 'ID',
-    'object_inputSecureFileLocation_param_access_hash_type_long' => 'Access hash',
-    'object_messageActionBotAllowed' => 'Message action bot allowed',
-    'object_messageActionBotAllowed_param_domain_type_string' => 'Domain',
-    'object_messageActionSecureValuesSentMe' => 'Message action secure values sent me',
+    'method_messages.getRecentLocations_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+    'method_messages.searchStickerSets' => 'Search for stickersets',
+    'method_messages.searchStickerSets_param_exclude_featured_type_true' => 'Exclude featured stickersets from results',
+    'method_messages.searchStickerSets_param_q_type_string' => 'Query string',
+    'method_messages.searchStickerSets_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+    'method_upload.getFileHashes' => 'Get SHA256 hashes for verifying downloaded files',
+    'method_upload.getFileHashes_param_location_type_InputFileLocation' => 'File',
+    'method_upload.getFileHashes_param_offset_type_int' => 'Offset from which to get file hashes',
+    'method_help.getProxyData' => 'Get promotion info of the currently-used MTProxy',
+    'method_help.getTermsOfServiceUpdate' => 'Look for updates of telegram\'s terms of service',
+    'method_help.acceptTermsOfService' => 'Accept the new terms of service',
+    'method_help.acceptTermsOfService_param_id_type_DataJSON' => 'ID of terms of service',
+    'method_help.getDeepLinkInfo' => 'Get info about a `t.me` link',
+    'method_help.getDeepLinkInfo_param_path_type_string' => 'Path in `t.me/path`',
+    'object_inputSecureFileLocation' => 'Location of encrypted telegram [passport](https://core.telegram.org/passport) file.',
+    'object_inputSecureFileLocation_param_id_type_long' => 'File ID, **id** parameter value from [secureFile](../constructors/secureFile.md)',
+    'object_inputSecureFileLocation_param_access_hash_type_long' => 'Checksum, **access\\_hash** parameter value from [secureFile](../constructors/secureFile.md)',
+    'object_messageActionBotAllowed' => 'The domain name of the website on which the user has logged in. [More about Telegram Login »](https://core.telegram.org/widgets/login)',
+    'object_messageActionBotAllowed_param_domain_type_string' => 'The domain name of the website on which the user has logged in.',
+    'object_messageActionSecureValuesSentMe' => 'Secure [telegram passport](https://core.telegram.org/passport) values were received',
     'object_messageActionSecureValuesSentMe_param_values_type_Vector t' => 'Values',
-    'object_messageActionSecureValuesSentMe_param_credentials_type_SecureCredentialsEncrypted' => 'Credentials',
-    'object_messageActionSecureValuesSent' => 'Message action secure values sent',
+    'object_messageActionSecureValuesSentMe_param_credentials_type_SecureCredentialsEncrypted' => 'Encrypted credentials required to decrypt the data',
+    'object_messageActionSecureValuesSent' => 'Request for secure [telegram passport](https://core.telegram.org/passport) values was sent',
     'object_messageActionSecureValuesSent_param_types_type_Vector t' => 'Types',
     'object_auth.sentCode_param_terms_of_service_type_help.TermsOfService' => 'Terms of service',
-    'object_inputPeerNotifySettings_param_silent_type_Bool' => 'Silent?',
-    'object_peerNotifySettings_param_silent_type_Bool' => 'Silent?',
-    'object_updateDialogPinned_param_peer_type_DialogPeer' => 'Peer',
+    'object_inputPeerNotifySettings_param_silent_type_Bool' => 'Peer was muted?',
+    'object_peerNotifySettings_param_silent_type_Bool' => 'Mute peer?',
+    'object_updateDialogPinned_param_peer_type_DialogPeer' => 'The dialog',
     'object_upload.fileCdnRedirect_param_file_hashes_type_Vector t' => 'File hashes',
-    'object_dcOption_param_secret_type_bytes' => 'Secret',
-    'object_config_param_preload_featured_stickers_type_true' => 'Preload featured stickers?',
-    'object_config_param_ignore_phone_entities_type_true' => 'Ignore phone entities?',
-    'object_config_param_revoke_pm_inbox_type_true' => 'Revoke pm inbox?',
-    'object_config_param_blocked_mode_type_true' => 'Blocked mode?',
-    'object_config_param_revoke_time_limit_type_int' => 'Revoke time limit',
-    'object_config_param_revoke_pm_time_limit_type_int' => 'Revoke pm time limit',
-    'object_config_param_autoupdate_url_prefix_type_string' => 'Autoupdate URL prefix',
-    'object_messages.stickers_param_hash_type_int' => 'Hash',
+    'object_dcOption_param_secret_type_bytes' => 'If the `tcpo_only` flag is set, specifies the secret to use when connecting using [transport obfuscation](https://core.telegram.org/mtproto/mtproto-transports#transport-obfuscation)',
+    'object_config_param_preload_featured_stickers_type_true' => 'Whether the client should preload featured stickers',
+    'object_config_param_ignore_phone_entities_type_true' => 'Whether the client should ignore phone [entities](https://core.telegram.org/api/entities)',
+    'object_config_param_revoke_pm_inbox_type_true' => 'Whether incoming private messages can be deleted for both participants',
+    'object_config_param_blocked_mode_type_true' => 'Indicates that telegram is *probably* censored by governments/ISPs in the current region',
+    'object_config_param_revoke_time_limit_type_int' => 'Only channel/supergroup messages with age smaller than the specified can be deleted',
+    'object_config_param_revoke_pm_time_limit_type_int' => 'Only private messages with age smaller than the specified can be deleted',
+    'object_config_param_autoupdate_url_prefix_type_string' => 'URL to use to auto-update the current app',
+    'object_messages.stickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
     'object_account.noPassword_param_new_secure_salt_type_bytes' => 'New secure salt',
     'object_account.noPassword_param_secure_random_type_bytes' => 'Secure random',
-    'object_account.password_param_has_recovery_type_true' => 'Has recovery?',
-    'object_account.password_param_has_secure_values_type_true' => 'Has secure values?',
+    'object_account.password_param_has_recovery_type_true' => 'Whether the user has a recovery method configured',
+    'object_account.password_param_has_secure_values_type_true' => 'Whether telegram [passport](https://core.telegram.org/passport) is enabled',
     'object_account.password_param_new_secure_salt_type_bytes' => 'New secure salt',
-    'object_account.password_param_secure_random_type_bytes' => 'Secure random',
+    'object_account.password_param_secure_random_type_bytes' => 'Secure random string',
     'object_account.passwordSettings_param_secure_salt_type_bytes' => 'Secure salt',
     'object_account.passwordSettings_param_secure_secret_type_bytes' => 'Secure secret',
     'object_account.passwordSettings_param_secure_secret_id_type_long' => 'Secure secret ID',
     'object_account.passwordInputSettings_param_new_secure_salt_type_bytes' => 'New secure salt',
     'object_account.passwordInputSettings_param_new_secure_secret_type_bytes' => 'New secure secret',
     'object_account.passwordInputSettings_param_new_secure_secret_id_type_long' => 'New secure secret ID',
-    'object_stickerSet_param_installed_date_type_int' => 'Installed date',
-    'object_messageEntityPhone' => 'Message entity phone',
-    'object_messageEntityPhone_param_offset_type_int' => 'Offset',
-    'object_messageEntityPhone_param_length_type_int' => 'Length',
-    'object_messageEntityCashtag' => 'Message entity cashtag',
-    'object_messageEntityCashtag_param_offset_type_int' => 'Offset',
-    'object_messageEntityCashtag_param_length_type_int' => 'Length',
-    'object_help.termsOfService_param_popup_type_true' => 'Popup?',
-    'object_help.termsOfService_param_id_type_DataJSON' => 'ID',
+    'object_stickerSet_param_installed_date_type_int' => 'When was this stickerset installed',
+    'object_messageEntityPhone' => 'Message entity representing a phone number.',
+    'object_messageEntityPhone_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+    'object_messageEntityPhone_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+    'object_messageEntityCashtag' => 'Message entity representing a **$cashtag**.',
+    'object_messageEntityCashtag_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+    'object_messageEntityCashtag_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+    'object_help.termsOfService_param_popup_type_true' => 'Whether a prompt must be showed to the user, in order to accept the new terms.',
+    'object_help.termsOfService_param_id_type_DataJSON' => 'ID of the new terms',
     'object_help.termsOfService_param_entities_type_Vector t' => 'Entities',
-    'object_help.termsOfService_param_min_age_confirm_type_int' => 'Min age confirm',
-    'object_inputBotInlineMessageMediaVenue_param_venue_type_type_string' => 'Venue type',
-    'object_inputBotInlineResult_param_thumb_type_InputWebDocument' => 'Thumbnail',
-    'object_inputBotInlineResult_param_content_type_InputWebDocument' => 'Content',
-    'object_botInlineMessageMediaVenue_param_venue_type_type_string' => 'Venue type',
-    'object_botInlineResult_param_thumb_type_WebDocument' => 'Thumbnailnail',
-    'object_botInlineResult_param_content_type_WebDocument' => 'Content',
+    'object_help.termsOfService_param_min_age_confirm_type_int' => 'Minimum age required to sign up to telegram, the user must confirm that they is older than the minimum age.',
+    'object_inputBotInlineMessageMediaVenue_param_venue_type_type_string' => 'Venue type in the provider\'s database',
+    'object_inputBotInlineResult_param_thumb_type_InputWebDocument' => 'Thumbnail for result',
+    'object_inputBotInlineResult_param_content_type_InputWebDocument' => 'Result contents',
+    'object_botInlineMessageMediaVenue_param_venue_type_type_string' => 'Venue type in the provider\'s database',
+    'object_botInlineResult_param_thumb_type_WebDocument' => 'Thumbnail for the result',
+    'object_botInlineResult_param_content_type_WebDocument' => 'Content of the result',
     'object_messages.recentStickers_param_packs_type_Vector t' => 'Packs',
     'object_messages.recentStickers_param_dates_type_Vector t' => 'Dates',
-    'object_webDocumentNoProxy' => 'Web document no proxy',
-    'object_webDocumentNoProxy_param_url_type_string' => 'URL',
-    'object_webDocumentNoProxy_param_size_type_int' => 'Size',
-    'object_webDocumentNoProxy_param_mime_type_type_string' => 'Mime type',
+    'object_webDocumentNoProxy' => 'Remote document that can be downloaded without [proxying through telegram](https://core.telegram.org/api/files)',
+    'object_webDocumentNoProxy_param_url_type_string' => 'Document URL',
+    'object_webDocumentNoProxy_param_size_type_int' => 'File size',
+    'object_webDocumentNoProxy_param_mime_type_type_string' => 'MIME type',
     'object_webDocumentNoProxy_param_attributes_type_Vector t' => 'Attributes',
-    'object_inputWebFileGeoPointLocation' => 'Web file geo point location',
-    'object_inputWebFileGeoPointLocation_param_geo_point_type_InputGeoPoint' => 'Geo point',
-    'object_inputWebFileGeoPointLocation_param_w_type_int' => 'Width',
-    'object_inputWebFileGeoPointLocation_param_h_type_int' => 'Height',
-    'object_inputWebFileGeoPointLocation_param_zoom_type_int' => 'Zoom',
-    'object_inputWebFileGeoPointLocation_param_scale_type_int' => 'Scale',
+    'object_inputWebFileGeoPointLocation' => 'Geolocation',
+    'object_inputWebFileGeoPointLocation_param_geo_point_type_InputGeoPoint' => 'Geolocation',
+    'object_inputWebFileGeoPointLocation_param_w_type_int' => 'Map width in pixels before applying scale; 16-1024',
+    'object_inputWebFileGeoPointLocation_param_h_type_int' => 'Map height in pixels before applying scale; 16-1024',
+    'object_inputWebFileGeoPointLocation_param_zoom_type_int' => 'Map zoom level; 13-20',
+    'object_inputWebFileGeoPointLocation_param_scale_type_int' => 'Map scale; 1-3',
     'object_inputWebFileGeoMessageLocation' => 'Web file geo message location',
     'object_inputWebFileGeoMessageLocation_param_peer_type_InputPeer' => 'Peer',
     'object_inputWebFileGeoMessageLocation_param_msg_id_type_int' => 'Msg ID',
@@ -4238,156 +4263,156 @@ class Lang
     'object_inputWebFileGeoMessageLocation_param_zoom_type_int' => 'Zoom',
     'object_inputWebFileGeoMessageLocation_param_scale_type_int' => 'Scale',
     'object_channelAdminRights_param_manage_call_type_true' => 'Manage group calls',
-    'object_inputDialogPeer' => 'Dialog peer',
+    'object_inputDialogPeer' => 'A peer',
     'object_inputDialogPeer_param_peer_type_InputPeer' => 'Peer',
-    'object_dialogPeer' => 'Dialog peer',
+    'object_dialogPeer' => 'Peer',
     'object_dialogPeer_param_peer_type_Peer' => 'Peer',
-    'object_messages.foundStickerSetsNotModified' => 'Found sticker sets not modified',
-    'object_messages.foundStickerSets' => 'Found sticker sets',
-    'object_messages.foundStickerSets_param_hash_type_int' => 'Hash',
+    'object_messages.foundStickerSetsNotModified' => 'No further results were found',
+    'object_messages.foundStickerSets' => 'Found stickersets',
+    'object_messages.foundStickerSets_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
     'object_messages.foundStickerSets_param_sets_type_Vector t' => 'Sets',
-    'object_fileHash' => 'File hash',
-    'object_fileHash_param_offset_type_int' => 'Offset',
-    'object_fileHash_param_limit_type_int' => 'Limit',
-    'object_fileHash_param_hash_type_bytes' => 'Hash',
-    'object_inputClientProxy' => 'Client proxy',
-    'object_inputClientProxy_param_address_type_string' => 'Address',
-    'object_inputClientProxy_param_port_type_int' => 'Port',
-    'object_help.proxyDataEmpty' => 'Empty proxy data',
-    'object_help.proxyDataEmpty_param_expires_type_int' => 'Expires',
-    'object_help.proxyDataPromo' => 'Proxy data promo',
-    'object_help.proxyDataPromo_param_expires_type_int' => 'Expires',
-    'object_help.proxyDataPromo_param_peer_type_Peer' => 'Peer',
+    'object_fileHash' => 'SHA256 Hash of an uploaded file, to be checked for validity after download',
+    'object_fileHash_param_offset_type_int' => 'Offset from where to start computing SHA-256 hash',
+    'object_fileHash_param_limit_type_int' => 'Length',
+    'object_fileHash_param_hash_type_bytes' => 'SHA-256 Hash of file chunk, to be checked for validity after download',
+    'object_inputClientProxy' => 'Info about an [MTProxy](https://core.telegram.org/mtproto/mtproto-transports#transport-obfuscation) used to connect.',
+    'object_inputClientProxy_param_address_type_string' => 'Proxy address',
+    'object_inputClientProxy_param_port_type_int' => 'Proxy port',
+    'object_help.proxyDataEmpty' => 'No proxy was used to connect to tg (or none was provided to [initConnection](../methods/initConnection.md), or the used proxy doesn\'t have a promotion channel associated to it)',
+    'object_help.proxyDataEmpty_param_expires_type_int' => 'Expiration date of proxy info, will have to be refetched in `expires` seconds',
+    'object_help.proxyDataPromo' => 'Promotion channel associated to a certain MTProxy',
+    'object_help.proxyDataPromo_param_expires_type_int' => 'Expiration date of proxy info, will have to be refetched in `expires` seconds',
+    'object_help.proxyDataPromo_param_peer_type_Peer' => 'The promoted channel',
     'object_help.proxyDataPromo_param_chats_type_Vector t' => 'Chats',
     'object_help.proxyDataPromo_param_users_type_Vector t' => 'Users',
-    'object_help.termsOfServiceUpdateEmpty' => 'Empty terms of service update',
-    'object_help.termsOfServiceUpdateEmpty_param_expires_type_int' => 'Expires',
-    'object_help.termsOfServiceUpdate' => 'Terms of service update',
-    'object_help.termsOfServiceUpdate_param_expires_type_int' => 'Expires',
-    'object_help.termsOfServiceUpdate_param_terms_of_service_type_help.TermsOfService' => 'Terms of service',
-    'object_inputSecureFileUploaded' => 'Secure file uploaded',
-    'object_inputSecureFileUploaded_param_id_type_long' => 'ID',
-    'object_inputSecureFileUploaded_param_parts_type_int' => 'Parts',
-    'object_inputSecureFileUploaded_param_md5_checksum_type_string' => 'Md5 checksum',
+    'object_help.termsOfServiceUpdateEmpty' => 'No changes were made to telegram\'s terms of service',
+    'object_help.termsOfServiceUpdateEmpty_param_expires_type_int' => 'New TOS updates will have to be queried using [help.getTermsOfServiceUpdate](../methods/help.getTermsOfServiceUpdate.md) in `expires` seconds',
+    'object_help.termsOfServiceUpdate' => 'Info about an update of telegram\'s terms of service. If the terms of service are declined, then the [account.deleteAccount](../methods/account.deleteAccount.md) method should be called with the reason "Decline ToS update"',
+    'object_help.termsOfServiceUpdate_param_expires_type_int' => 'New TOS updates will have to be queried using [help.getTermsOfServiceUpdate](../methods/help.getTermsOfServiceUpdate.md) in `expires` seconds',
+    'object_help.termsOfServiceUpdate_param_terms_of_service_type_help.TermsOfService' => 'New terms of service',
+    'object_inputSecureFileUploaded' => 'Uploaded secure file, for more info [see the passport docs »](https://core.telegram.org/passport/encryption#inputsecurefile)',
+    'object_inputSecureFileUploaded_param_id_type_long' => 'Secure file ID',
+    'object_inputSecureFileUploaded_param_parts_type_int' => 'Secure file part count',
+    'object_inputSecureFileUploaded_param_md5_checksum_type_string' => 'MD5 hash of encrypted uploaded file, to be checked server-side',
     'object_inputSecureFileUploaded_param_file_hash_type_bytes' => 'File hash',
     'object_inputSecureFileUploaded_param_secret_type_bytes' => 'Secret',
-    'object_inputSecureFile' => 'Secure file',
-    'object_inputSecureFile_param_id_type_long' => 'ID',
-    'object_inputSecureFile_param_access_hash_type_long' => 'Access hash',
-    'object_secureFileEmpty' => 'Empty secure file',
-    'object_secureFile' => 'Secure file',
+    'object_inputSecureFile' => 'Preuploaded [passport](https://core.telegram.org/passport) file, for more info [see the passport docs »](https://core.telegram.org/passport/encryption#inputsecurefile)',
+    'object_inputSecureFile_param_id_type_long' => 'Secure file ID',
+    'object_inputSecureFile_param_access_hash_type_long' => 'Secure file access hash',
+    'object_secureFileEmpty' => 'Empty constructor',
+    'object_secureFile' => 'Secure [passport](https://core.telegram.org/passport) file, for more info [see the passport docs »](https://core.telegram.org/passport/encryption#inputsecurefile)',
     'object_secureFile_param_id_type_long' => 'ID',
     'object_secureFile_param_access_hash_type_long' => 'Access hash',
-    'object_secureFile_param_size_type_int' => 'Size',
+    'object_secureFile_param_size_type_int' => 'File size',
     'object_secureFile_param_dc_id_type_int' => 'DC ID',
-    'object_secureFile_param_date_type_int' => 'Date',
+    'object_secureFile_param_date_type_int' => 'Date of upload',
     'object_secureFile_param_file_hash_type_bytes' => 'File hash',
     'object_secureFile_param_secret_type_bytes' => 'Secret',
-    'object_secureData' => 'Secure data',
+    'object_secureData' => 'Secure [passport](https://core.telegram.org/passport) data, for more info [see the passport docs »](https://core.telegram.org/passport/encryption#securedata)',
     'object_secureData_param_data_type_bytes' => 'Data',
     'object_secureData_param_data_hash_type_bytes' => 'Data hash',
     'object_secureData_param_secret_type_bytes' => 'Secret',
-    'object_securePlainPhone' => 'Secure plain phone',
-    'object_securePlainPhone_param_phone_type_string' => 'Phone',
-    'object_securePlainEmail' => 'Secure plain email',
-    'object_securePlainEmail_param_email_type_string' => 'Email',
-    'object_secureValueTypePersonalDetails' => 'Secure value type personal details',
-    'object_secureValueTypePassport' => 'Secure value type passport',
-    'object_secureValueTypeDriverLicense' => 'Secure value type driver license',
-    'object_secureValueTypeIdentityCard' => 'Secure value type IDentity card',
-    'object_secureValueTypeInternalPassport' => 'Secure value type internal passport',
-    'object_secureValueTypeAddress' => 'Secure value type address',
-    'object_secureValueTypeUtilityBill' => 'Secure value type utility bill',
-    'object_secureValueTypeBankStatement' => 'Secure value type bank statement',
-    'object_secureValueTypeRentalAgreement' => 'Secure value type rental agreement',
-    'object_secureValueTypePassportRegistration' => 'Secure value type passport registration',
-    'object_secureValueTypeTemporaryRegistration' => 'Secure value type temporary registration',
-    'object_secureValueTypePhone' => 'Secure value type phone',
-    'object_secureValueTypeEmail' => 'Secure value type email',
+    'object_securePlainPhone' => 'Phone number to use in [telegram passport](https://core.telegram.org/passport): [it must be verified, first »](https://core.telegram.org/passport/encryption#secureplaindata).',
+    'object_securePlainPhone_param_phone_type_string' => 'Phone number',
+    'object_securePlainEmail' => 'Email address to use in [telegram passport](https://core.telegram.org/passport): [it must be verified, first »](https://core.telegram.org/passport/encryption#secureplaindata).',
+    'object_securePlainEmail_param_email_type_string' => 'Email address',
+    'object_secureValueTypePersonalDetails' => 'Personal details',
+    'object_secureValueTypePassport' => 'Passport',
+    'object_secureValueTypeDriverLicense' => 'Driver\'s license',
+    'object_secureValueTypeIdentityCard' => 'Identity card',
+    'object_secureValueTypeInternalPassport' => 'Internal [passport](https://core.telegram.org/passport)',
+    'object_secureValueTypeAddress' => 'Address',
+    'object_secureValueTypeUtilityBill' => 'Utility bill',
+    'object_secureValueTypeBankStatement' => 'Bank statement',
+    'object_secureValueTypeRentalAgreement' => 'Rental agreement',
+    'object_secureValueTypePassportRegistration' => 'Internal registration [passport](https://core.telegram.org/passport)',
+    'object_secureValueTypeTemporaryRegistration' => 'Temporary registration',
+    'object_secureValueTypePhone' => 'Phone',
+    'object_secureValueTypeEmail' => 'Email',
     'object_secureValue' => 'Secure value',
-    'object_secureValue_param_type_type_SecureValueType' => 'Type',
-    'object_secureValue_param_data_type_SecureData' => 'Data',
-    'object_secureValue_param_front_side_type_SecureFile' => 'Front side',
-    'object_secureValue_param_reverse_side_type_SecureFile' => 'Reverse side',
-    'object_secureValue_param_selfie_type_SecureFile' => 'Selfie',
+    'object_secureValue_param_type_type_SecureValueType' => 'Secure [passport](https://core.telegram.org/passport) value type',
+    'object_secureValue_param_data_type_SecureData' => 'Encrypted [Telegram Passport](https://core.telegram.org/passport) element data',
+    'object_secureValue_param_front_side_type_SecureFile' => 'Encrypted [passport](https://core.telegram.org/passport) file with the front side of the document',
+    'object_secureValue_param_reverse_side_type_SecureFile' => 'Encrypted [passport](https://core.telegram.org/passport) file with the reverse side of the document',
+    'object_secureValue_param_selfie_type_SecureFile' => 'Encrypted [passport](https://core.telegram.org/passport) file with a selfie of the user holding the document',
     'object_secureValue_param_files_type_Vector t' => 'Files',
-    'object_secureValue_param_plain_data_type_SecurePlainData' => 'Plain data',
-    'object_secureValue_param_hash_type_bytes' => 'Hash',
-    'object_inputSecureValue' => 'Secure value',
-    'object_inputSecureValue_param_type_type_SecureValueType' => 'Type',
-    'object_inputSecureValue_param_data_type_SecureData' => 'Data',
-    'object_inputSecureValue_param_front_side_type_InputSecureFile' => 'Front side',
-    'object_inputSecureValue_param_reverse_side_type_InputSecureFile' => 'Reverse side',
-    'object_inputSecureValue_param_selfie_type_InputSecureFile' => 'Selfie',
+    'object_secureValue_param_plain_data_type_SecurePlainData' => 'Plaintext verified [passport](https://core.telegram.org/passport) data',
+    'object_secureValue_param_hash_type_bytes' => 'Data hash',
+    'object_inputSecureValue' => 'Secure value, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
+    'object_inputSecureValue_param_type_type_SecureValueType' => 'Secure [passport](https://core.telegram.org/passport) value type',
+    'object_inputSecureValue_param_data_type_SecureData' => 'Encrypted [Telegram Passport](https://core.telegram.org/passport) element data',
+    'object_inputSecureValue_param_front_side_type_InputSecureFile' => 'Encrypted [passport](https://core.telegram.org/passport) file with the front side of the document',
+    'object_inputSecureValue_param_reverse_side_type_InputSecureFile' => 'Encrypted [passport](https://core.telegram.org/passport) file with the reverse side of the document',
+    'object_inputSecureValue_param_selfie_type_InputSecureFile' => 'Encrypted [passport](https://core.telegram.org/passport) file with a selfie of the user holding the document',
     'object_inputSecureValue_param_files_type_Vector t' => 'Files',
-    'object_inputSecureValue_param_plain_data_type_SecurePlainData' => 'Plain data',
+    'object_inputSecureValue_param_plain_data_type_SecurePlainData' => 'Plaintext verified [passport](https://core.telegram.org/passport) data',
     'object_secureValueHash' => 'Secure value hash',
-    'object_secureValueHash_param_type_type_SecureValueType' => 'Type',
+    'object_secureValueHash_param_type_type_SecureValueType' => 'Secure value type',
     'object_secureValueHash_param_hash_type_bytes' => 'Hash',
-    'object_secureValueErrorData' => 'Secure value error data',
-    'object_secureValueErrorData_param_type_type_SecureValueType' => 'Type',
+    'object_secureValueErrorData' => 'Represents an issue in one of the data fields that was provided by the user. The error is considered resolved when the field\'s value changes.',
+    'object_secureValueErrorData_param_type_type_SecureValueType' => 'The section of the user\'s Telegram Passport which has the error, one of [secureValueTypePersonalDetails](../constructors/secureValueTypePersonalDetails.md), [secureValueTypePassport](../constructors/secureValueTypePassport.md), [secureValueTypeDriverLicense](../constructors/secureValueTypeDriverLicense.md), [secureValueTypeIdentityCard](../constructors/secureValueTypeIdentityCard.md), [secureValueTypeInternalPassport](../constructors/secureValueTypeInternalPassport.md), [secureValueTypeAddress](../constructors/secureValueTypeAddress.md)',
     'object_secureValueErrorData_param_data_hash_type_bytes' => 'Data hash',
-    'object_secureValueErrorData_param_field_type_string' => 'Field',
-    'object_secureValueErrorData_param_text_type_string' => 'Text',
-    'object_secureValueErrorFrontSide' => 'Secure value error front side',
-    'object_secureValueErrorFrontSide_param_type_type_SecureValueType' => 'Type',
+    'object_secureValueErrorData_param_field_type_string' => 'Name of the data field which has the error',
+    'object_secureValueErrorData_param_text_type_string' => 'Error message',
+    'object_secureValueErrorFrontSide' => 'Represents an issue with the front side of a document. The error is considered resolved when the file with the front side of the document changes.',
+    'object_secureValueErrorFrontSide_param_type_type_SecureValueType' => 'One of [secureValueTypePassport](../constructors/secureValueTypePassport.md), [secureValueTypeDriverLicense](../constructors/secureValueTypeDriverLicense.md), [secureValueTypeIdentityCard](../constructors/secureValueTypeIdentityCard.md), [secureValueTypeInternalPassport](../constructors/secureValueTypeInternalPassport.md)',
     'object_secureValueErrorFrontSide_param_file_hash_type_bytes' => 'File hash',
-    'object_secureValueErrorFrontSide_param_text_type_string' => 'Text',
-    'object_secureValueErrorReverseSide' => 'Secure value error reverse side',
-    'object_secureValueErrorReverseSide_param_type_type_SecureValueType' => 'Type',
+    'object_secureValueErrorFrontSide_param_text_type_string' => 'Error message',
+    'object_secureValueErrorReverseSide' => 'Represents an issue with the reverse side of a document. The error is considered resolved when the file with reverse side of the document changes.',
+    'object_secureValueErrorReverseSide_param_type_type_SecureValueType' => 'One of [secureValueTypeDriverLicense](../constructors/secureValueTypeDriverLicense.md), [secureValueTypeIdentityCard](../constructors/secureValueTypeIdentityCard.md)',
     'object_secureValueErrorReverseSide_param_file_hash_type_bytes' => 'File hash',
-    'object_secureValueErrorReverseSide_param_text_type_string' => 'Text',
-    'object_secureValueErrorSelfie' => 'Secure value error selfie',
-    'object_secureValueErrorSelfie_param_type_type_SecureValueType' => 'Type',
+    'object_secureValueErrorReverseSide_param_text_type_string' => 'Error message',
+    'object_secureValueErrorSelfie' => 'Represents an issue with the selfie with a document. The error is considered resolved when the file with the selfie changes.',
+    'object_secureValueErrorSelfie_param_type_type_SecureValueType' => 'One of [secureValueTypePassport](../constructors/secureValueTypePassport.md), [secureValueTypeDriverLicense](../constructors/secureValueTypeDriverLicense.md), [secureValueTypeIdentityCard](../constructors/secureValueTypeIdentityCard.md), [secureValueTypeInternalPassport](../constructors/secureValueTypeInternalPassport.md)',
     'object_secureValueErrorSelfie_param_file_hash_type_bytes' => 'File hash',
-    'object_secureValueErrorSelfie_param_text_type_string' => 'Text',
-    'object_secureValueErrorFile' => 'Secure value error file',
-    'object_secureValueErrorFile_param_type_type_SecureValueType' => 'Type',
+    'object_secureValueErrorSelfie_param_text_type_string' => 'Error message',
+    'object_secureValueErrorFile' => 'Represents an issue with a document scan. The error is considered resolved when the file with the document scan changes.',
+    'object_secureValueErrorFile_param_type_type_SecureValueType' => 'One of [secureValueTypeUtilityBill](../constructors/secureValueTypeUtilityBill.md), [secureValueTypeBankStatement](../constructors/secureValueTypeBankStatement.md), [secureValueTypeRentalAgreement](../constructors/secureValueTypeRentalAgreement.md), [secureValueTypePassportRegistration](../constructors/secureValueTypePassportRegistration.md), [secureValueTypeTemporaryRegistration](../constructors/secureValueTypeTemporaryRegistration.md)',
     'object_secureValueErrorFile_param_file_hash_type_bytes' => 'File hash',
-    'object_secureValueErrorFile_param_text_type_string' => 'Text',
-    'object_secureValueErrorFiles' => 'Secure value error files',
-    'object_secureValueErrorFiles_param_type_type_SecureValueType' => 'Type',
+    'object_secureValueErrorFile_param_text_type_string' => 'Error message',
+    'object_secureValueErrorFiles' => 'Represents an issue with a list of scans. The error is considered resolved when the list of files containing the scans changes.',
+    'object_secureValueErrorFiles_param_type_type_SecureValueType' => 'One of [secureValueTypeUtilityBill](../constructors/secureValueTypeUtilityBill.md), [secureValueTypeBankStatement](../constructors/secureValueTypeBankStatement.md), [secureValueTypeRentalAgreement](../constructors/secureValueTypeRentalAgreement.md), [secureValueTypePassportRegistration](../constructors/secureValueTypePassportRegistration.md), [secureValueTypeTemporaryRegistration](../constructors/secureValueTypeTemporaryRegistration.md)',
     'object_secureValueErrorFiles_param_file_hash_type_Vector t' => 'File hash',
-    'object_secureValueErrorFiles_param_text_type_string' => 'Text',
-    'object_secureCredentialsEncrypted' => 'Secure credentials encrypted',
-    'object_secureCredentialsEncrypted_param_data_type_bytes' => 'Data',
-    'object_secureCredentialsEncrypted_param_hash_type_bytes' => 'Hash',
-    'object_secureCredentialsEncrypted_param_secret_type_bytes' => 'Secret',
-    'object_account.authorizationForm' => 'Telegram passport authorization form',
+    'object_secureValueErrorFiles_param_text_type_string' => 'Error message',
+    'object_secureCredentialsEncrypted' => 'Encrypted credentials required to decrypt [telegram passport](https://core.telegram.org/passport) data.',
+    'object_secureCredentialsEncrypted_param_data_type_bytes' => 'Encrypted JSON-serialized data with unique user\'s payload, data hashes and secrets required for EncryptedPassportElement decryption and authentication, as described in [decrypting data »](https://core.telegram.org/passport#decrypting-data)',
+    'object_secureCredentialsEncrypted_param_hash_type_bytes' => 'Data hash for data authentication as described in [decrypting data »](https://core.telegram.org/passport#decrypting-data)',
+    'object_secureCredentialsEncrypted_param_secret_type_bytes' => 'Secret, encrypted with the bot\'s public RSA key, required for data decryption as described in [decrypting data »](https://core.telegram.org/passport#decrypting-data)',
+    'object_account.authorizationForm' => '[Telegram Passport](https://core.telegram.org/passport) authorization form',
     'object_account.authorizationForm_param_selfie_required_type_true' => 'Selfie required?',
     'object_account.authorizationForm_param_required_types_type_Vector t' => 'Required types',
     'object_account.authorizationForm_param_values_type_Vector t' => 'Values',
     'object_account.authorizationForm_param_errors_type_Vector t' => 'Errors',
     'object_account.authorizationForm_param_users_type_Vector t' => 'Users',
-    'object_account.authorizationForm_param_privacy_policy_url_type_string' => 'Privacy policy URL',
-    'object_account.sentEmailCode' => 'Sent email code',
-    'object_account.sentEmailCode_param_email_pattern_type_string' => 'Email pattern',
-    'object_account.sentEmailCode_param_length_type_int' => 'Length',
-    'object_help.deepLinkInfoEmpty' => 'Empty deep link info',
-    'object_help.deepLinkInfo' => 'Deep link info',
-    'object_help.deepLinkInfo_param_update_app_type_true' => 'Update app?',
-    'object_help.deepLinkInfo_param_message_type_string' => 'Message',
+    'object_account.authorizationForm_param_privacy_policy_url_type_string' => 'URL of the service\'s privacy policy',
+    'object_account.sentEmailCode' => 'The sent email code',
+    'object_account.sentEmailCode_param_email_pattern_type_string' => 'The email (to which the code was sent) must match this [pattern](https://core.telegram.org/api/pattern)',
+    'object_account.sentEmailCode_param_length_type_int' => 'The length of the verification code',
+    'object_help.deepLinkInfoEmpty' => 'Deep link info empty',
+    'object_help.deepLinkInfo' => 'Deep linking info',
+    'object_help.deepLinkInfo_param_update_app_type_true' => 'An update of the app is required to parse this link',
+    'object_help.deepLinkInfo_param_message_type_string' => 'Message to show to the user',
     'object_help.deepLinkInfo_param_entities_type_Vector t' => 'Entities',
-    'method_invokeWithMessagesRange' => 'Invoke with messages range',
-    'method_invokeWithMessagesRange_param_range_type_MessageRange' => 'The range',
-    'method_invokeWithMessagesRange_param_query_type_!X' => 'The query',
-    'method_invokeWithTakeout' => 'Invoke method from takeout session',
-    'method_invokeWithTakeout_param_takeout_id_type_long' => 'The takeout session ID',
-    'method_invokeWithTakeout_param_query_type_!X' => 'The query',
-    'method_account.initTakeoutSession' => 'Start account exporting session',
-    'method_account.initTakeoutSession_param_contacts_type_true' => 'Export contacts?',
-    'method_account.initTakeoutSession_param_message_users_type_true' => 'Export users?',
-    'method_account.initTakeoutSession_param_message_chats_type_true' => 'Export chats?',
-    'method_account.initTakeoutSession_param_message_megagroups_type_true' => 'Export supergroups?',
-    'method_account.initTakeoutSession_param_message_channels_type_true' => 'Export channel messages?',
-    'method_account.initTakeoutSession_param_files_type_true' => 'Export files?',
-    'method_account.initTakeoutSession_param_file_max_size_type_int' => 'Export only files smaller than this size',
-    'method_account.finishTakeoutSession' => 'Finish account exporting session',
-    'method_account.finishTakeoutSession_param_success_type_true' => 'Did the data export succeed?',
-    'method_contacts.getSaved' => 'Get saved contacts',
-    'method_messages.getSplitRanges' => 'Get message ranges to fetch',
-    'method_channels.getLeftChannels' => 'Get all channels you left',
-    'method_channels.getLeftChannels_param_offset_type_int' => 'Offset',
+    'method_invokeWithMessagesRange' => 'Invoke with the given message range',
+    'method_invokeWithMessagesRange_param_range_type_MessageRange' => 'Message range',
+    'method_invokeWithMessagesRange_param_query_type_!X' => 'Query',
+    'method_invokeWithTakeout' => 'Invoke a method within a takeout session',
+    'method_invokeWithTakeout_param_takeout_id_type_long' => 'Takeout session ID',
+    'method_invokeWithTakeout_param_query_type_!X' => 'Query',
+    'method_account.initTakeoutSession' => 'Intialize account takeout session',
+    'method_account.initTakeoutSession_param_contacts_type_true' => 'Whether to export contacts',
+    'method_account.initTakeoutSession_param_message_users_type_true' => 'Whether to export messages in private chats',
+    'method_account.initTakeoutSession_param_message_chats_type_true' => 'Whether to export messages in [legacy groups](https://core.telegram.org/api/channel)',
+    'method_account.initTakeoutSession_param_message_megagroups_type_true' => 'Whether to export messages in [supergroups](https://core.telegram.org/api/channel)',
+    'method_account.initTakeoutSession_param_message_channels_type_true' => 'Whether to export messages in [channels](https://core.telegram.org/api/channel)',
+    'method_account.initTakeoutSession_param_files_type_true' => 'Whether to export files',
+    'method_account.initTakeoutSession_param_file_max_size_type_int' => 'Maximum size of files to export',
+    'method_account.finishTakeoutSession' => 'Finish account takeout session',
+    'method_account.finishTakeoutSession_param_success_type_true' => 'Data exported successfully',
+    'method_contacts.getSaved' => 'Get all contacts',
+    'method_messages.getSplitRanges' => 'Get message ranges for saving the user\'s chat history',
+    'method_channels.getLeftChannels' => 'Get a list of [channels/supergroups](https://core.telegram.org/api/channel) we left',
+    'method_channels.getLeftChannels_param_offset_type_int' => 'Offset for [pagination](https://core.telegram.org/api/offsets)',
     'object_ipPortSecret' => 'Ip port secret',
     'object_ipPortSecret_param_ipv4_type_int' => 'Ipv4',
     'object_ipPortSecret_param_port_type_int' => 'Port',
@@ -4397,42 +4422,42 @@ class Lang
     'object_accessPointRule_param_dc_id_type_int' => 'DC ID',
     'object_accessPointRule_param_ips_type_vector' => 'Ips',
     'object_help.configSimple_param_rules_type_vector' => 'Rules',
-    'object_inputTakeoutFileLocation' => 'Takeout file location',
-    'object_savedPhoneContact' => 'Saved phone contact',
-    'object_savedPhoneContact_param_phone_type_string' => 'Phone',
+    'object_inputTakeoutFileLocation' => 'Empty constructor for takeout',
+    'object_savedPhoneContact' => 'Saved contact',
+    'object_savedPhoneContact_param_phone_type_string' => 'Phone number',
     'object_savedPhoneContact_param_first_name_type_string' => 'First name',
     'object_savedPhoneContact_param_last_name_type_string' => 'Last name',
-    'object_savedPhoneContact_param_date_type_int' => 'Date',
-    'object_account.takeout' => 'Takeout',
-    'object_account.takeout_param_id_type_long' => 'ID',
-    'method_contacts.toggleTopPeers' => 'Toggle top peers',
-    'method_contacts.toggleTopPeers_param_enabled_type_Bool' => 'Enable or disable top peer',
-    'method_messages.getDialogs_param_hash_type_int' => 'IDs of previously fetched dialogs',
-    'method_messages.markDialogUnread' => 'Mark dialog as unread ',
-    'method_messages.markDialogUnread_param_unread_type_true' => 'Should it be marked or unmarked as read',
-    'method_messages.markDialogUnread_param_peer_type_InputDialogPeer' => 'The dialog to mark as unread',
-    'method_messages.getDialogUnreadMarks' => 'Get dialogs marked as unread manually',
-    'object_inputMediaContact_param_vcard_type_string' => 'Vcard',
-    'object_messageMediaContact_param_vcard_type_string' => 'Vcard',
-    'object_dialog_param_unread_mark_type_true' => 'Unread mark?',
+    'object_savedPhoneContact_param_date_type_int' => 'Date added',
+    'object_account.takeout' => 'Takout info',
+    'object_account.takeout_param_id_type_long' => 'Takeout ID',
+    'method_contacts.toggleTopPeers' => 'Enable/disable [top peers](https://core.telegram.org/api/top-rating)',
+    'method_contacts.toggleTopPeers_param_enabled_type_Bool' => 'Enable/disable',
+    'method_messages.getDialogs_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+    'method_messages.markDialogUnread' => 'Manually mark dialog as unread',
+    'method_messages.markDialogUnread_param_unread_type_true' => 'Mark as unread/read',
+    'method_messages.markDialogUnread_param_peer_type_InputDialogPeer' => 'Dialog',
+    'method_messages.getDialogUnreadMarks' => 'Get dialogs manually marked as unread',
+    'object_inputMediaContact_param_vcard_type_string' => 'Contact vcard',
+    'object_messageMediaContact_param_vcard_type_string' => 'VCARD of contact',
+    'object_dialog_param_unread_mark_type_true' => 'Whether the chat was manually marked as unread',
     'object_geoPoint_param_access_hash_type_long' => 'Access hash',
-    'object_messages.dialogsNotModified' => 'Dialogs not modified',
-    'object_messages.dialogsNotModified_param_count_type_int' => 'Count',
-    'object_updateDialogUnreadMark' => 'Update dialog unread mark',
-    'object_updateDialogUnreadMark_param_unread_type_true' => 'Unread?',
-    'object_updateDialogUnreadMark_param_peer_type_DialogPeer' => 'Peer',
-    'object_config_param_dc_txt_domain_name_type_string' => 'DC txt domain name',
-    'object_config_param_gif_search_username_type_string' => 'Gif search username',
-    'object_config_param_venue_search_username_type_string' => 'Venue search username',
-    'object_config_param_img_search_username_type_string' => 'Img search username',
-    'object_config_param_static_maps_provider_type_string' => 'Static maps provider',
-    'object_config_param_caption_length_max_type_int' => 'Caption length max',
-    'object_config_param_message_length_max_type_int' => 'Message length max',
-    'object_config_param_webfile_dc_id_type_int' => 'Webfile DC ID',
-    'object_inputBotInlineMessageMediaContact_param_vcard_type_string' => 'Vcard',
-    'object_botInlineMessageMediaContact_param_vcard_type_string' => 'Vcard',
+    'object_messages.dialogsNotModified' => 'Dialogs haven\'t changed',
+    'object_messages.dialogsNotModified_param_count_type_int' => 'Number of dialogs found server-side by the query',
+    'object_updateDialogUnreadMark' => 'The manual unread mark of a chat was changed',
+    'object_updateDialogUnreadMark_param_unread_type_true' => 'Was the chat marked or unmarked as read',
+    'object_updateDialogUnreadMark_param_peer_type_DialogPeer' => 'The dialog',
+    'object_config_param_dc_txt_domain_name_type_string' => 'Domain name for fetching encrypted DC list from DNS TXT record',
+    'object_config_param_gif_search_username_type_string' => 'Username of the bot to use to search for GIFs',
+    'object_config_param_venue_search_username_type_string' => 'Username of the bot to use to search for venues',
+    'object_config_param_img_search_username_type_string' => 'Username of the bot to use for image search',
+    'object_config_param_static_maps_provider_type_string' => 'ID of the map provider to use for venues',
+    'object_config_param_caption_length_max_type_int' => 'Maximum length of caption (length in utf8 codepoints)',
+    'object_config_param_message_length_max_type_int' => 'Maximum length of messages (length in utf8 codepoints)',
+    'object_config_param_webfile_dc_id_type_int' => 'DC ID to use to download [webfiles](https://core.telegram.org/api/files)',
+    'object_inputBotInlineMessageMediaContact_param_vcard_type_string' => 'VCard info',
+    'object_botInlineMessageMediaContact_param_vcard_type_string' => 'VCard info',
     'object_contacts.topPeersDisabled' => 'Top peers disabled',
-    'object_draftMessageEmpty_param_date_type_int' => 'Date',
+    'object_draftMessageEmpty_param_date_type_int' => 'When was the draft last updated',
     'object_inputWebFileGeoPointLocation_param_access_hash_type_long' => 'Access hash',
     'method_contacts.getContacts_param_hash_type_Vector t' => 'User IDs of previously cached contacts',
     'method_contacts.getTopPeers_param_hash_type_Vector t' => 'Peer IDs of previously cached peers',
@@ -4450,710 +4475,712 @@ class Lang
     'method_messages.getRecentLocations_param_hash_type_Vector t' => 'IDs of locations you already fetched',
     'method_messages.searchStickerSets_param_hash_type_Vector t' => 'The IDs of stickersets you already fetched',
     'method_channels.getParticipants_param_hash_type_Vector t' => 'IDs of previously fetched participants',
-    'method_auth.checkPassword_param_password_type_InputCheckPasswordSRP' => 'You cannot use this method directly, use the complete_2fa_login method instead (see https://docs.madelineproto.xyz for more info)',
-    'method_account.getPasswordSettings_param_password_type_InputCheckPasswordSRP' => 'You cannot use this method directly; use $MadelineProto->update_2fa($params), instead (see https://docs.madelineproto.xyz for more info)',
-    'method_account.updatePasswordSettings_param_password_type_InputCheckPasswordSRP' => 'You cannot use this method directly; use $MadelineProto->update_2fa($params), instead (see https://docs.madelineproto.xyz for more info)',
-    'method_account.getTmpPassword_param_password_type_InputCheckPasswordSRP' => 'Password',
-    'method_account.confirmPasswordEmail' => 'Confirm password recovery using email',
-    'method_account.confirmPasswordEmail_param_code_type_string' => 'Code',
-    'method_account.resendPasswordEmail' => 'Resend password recovery email',
-    'method_account.cancelPasswordEmail' => 'Cancel password recovery email',
-    'method_account.getContactSignUpNotification' => 'Contact signup notification setting value',
-    'method_account.setContactSignUpNotification' => 'Set contact sign up notification',
-    'method_account.setContactSignUpNotification_param_silent_type_Bool' => 'Silent?',
-    'method_account.getNotifyExceptions' => 'Get notification exceptions',
-    'method_account.getNotifyExceptions_param_compare_sound_type_true' => 'Compare sound?',
-    'method_account.getNotifyExceptions_param_peer_type_InputNotifyPeer' => 'Peer',
-    'method_contacts.getContactIDs' => 'Get contacts by IDs',
+    'method_auth.checkPassword_param_password_type_InputCheckPasswordSRP' => 'The account\'s password (see [SRP](https://core.telegram.org/api/srp))',
+    'method_account.getPasswordSettings_param_password_type_InputCheckPasswordSRP' => 'The password (see [SRP](https://core.telegram.org/api/srp))',
+    'method_account.updatePasswordSettings_param_password_type_InputCheckPasswordSRP' => 'The old password (see [SRP](https://core.telegram.org/api/srp))',
+    'method_account.getTmpPassword_param_password_type_InputCheckPasswordSRP' => 'SRP password parameters',
+    'method_account.confirmPasswordEmail' => 'Verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp).',
+    'method_account.confirmPasswordEmail_param_code_type_string' => 'The phone code that was received after [setting a recovery email](https://core.telegram.org/api/srp#email-verification)',
+    'method_account.resendPasswordEmail' => 'Resend the code to verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp).',
+    'method_account.cancelPasswordEmail' => 'Cancel the code that was sent to verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp).',
+    'method_account.getContactSignUpNotification' => 'Whether the user will receive notifications when contacts sign up',
+    'method_account.setContactSignUpNotification' => 'Toggle contact sign up notifications',
+    'method_account.setContactSignUpNotification_param_silent_type_Bool' => 'Whether to disable contact sign up notifications',
+    'method_account.getNotifyExceptions' => 'Returns list of chats with non-default notification settings',
+    'method_account.getNotifyExceptions_param_compare_sound_type_true' => 'If true, chats with non-default sound will also be returned',
+    'method_account.getNotifyExceptions_param_peer_type_InputNotifyPeer' => 'If specified, only chats of the specified category will be returned',
+    'method_contacts.getContactIDs' => 'Get contact by telegram IDs',
     'method_contacts.getContactIDs_param_hash_type_Vector t' => 'Previously fetched IDs',
-    'method_contacts.deleteByPhones' => 'Delete contacts by phones',
+    'method_contacts.deleteByPhones' => 'Delete contacts by phone number',
     'method_contacts.deleteByPhones_param_phones_type_Vector t' => 'Phones',
-    'method_messages.sendInlineBotResult_param_hide_via_type_true' => 'Hide "via @bot"',
-    'method_messages.clearAllDrafts' => 'Clear all drafts',
-    'method_messages.updatePinnedMessage' => 'Update pinned message',
-    'method_messages.updatePinnedMessage_param_silent_type_true' => 'Silent?',
-    'method_messages.updatePinnedMessage_param_peer_type_InputPeer' => 'Peer',
-    'method_messages.updatePinnedMessage_param_id_type_int' => 'Message ID',
-    'method_messages.sendVote' => 'Send vote',
-    'method_messages.sendVote_param_peer_type_InputPeer' => 'Peer',
-    'method_messages.sendVote_param_msg_id_type_int' => 'Message ID',
+    'method_messages.sendInlineBotResult_param_hide_via_type_true' => 'Whether to hide the `via @botname` in the resulting message (only for bot usernames encountered in the [config](../constructors/config.md))',
+    'method_messages.clearAllDrafts' => 'Clear all [drafts](https://core.telegram.org/api/drafts).',
+    'method_messages.updatePinnedMessage' => 'Pin a message',
+    'method_messages.updatePinnedMessage_param_silent_type_true' => 'Pin the message silently, without triggering a notification',
+    'method_messages.updatePinnedMessage_param_peer_type_InputPeer' => 'The peer where to pin the message',
+    'method_messages.updatePinnedMessage_param_id_type_int' => 'The message to pin, can be 0 to unpin any currently pinned messages',
+    'method_messages.sendVote' => 'Vote in a [poll](../constructors/poll.md)',
+    'method_messages.sendVote_param_peer_type_InputPeer' => 'The chat where the poll was sent',
+    'method_messages.sendVote_param_msg_id_type_int' => 'The message ID of the poll',
     'method_messages.sendVote_param_options_type_Vector t' => 'Options',
     'method_messages.getPollResults' => 'Get poll results',
-    'method_messages.getPollResults_param_peer_type_InputPeer' => 'Peer',
-    'method_messages.getPollResults_param_msg_id_type_int' => 'Message ID',
-    'method_messages.getOnlines' => 'Get online users',
-    'method_messages.getOnlines_param_peer_type_InputPeer' => 'Peer',
-    'method_messages.getStatsURL' => 'Get stats URL',
-    'method_messages.getStatsURL_param_peer_type_InputPeer' => 'Peer',
+    'method_messages.getPollResults_param_peer_type_InputPeer' => 'Peer where the poll was found',
+    'method_messages.getPollResults_param_msg_id_type_int' => 'Message ID of poll message',
+    'method_messages.getOnlines' => 'Get count of online users in a chat',
+    'method_messages.getOnlines_param_peer_type_InputPeer' => 'The chat',
+    'method_messages.getStatsURL' => 'Returns URL with the chat statistics. Currently this method can be used only for channels',
+    'method_messages.getStatsURL_param_peer_type_InputPeer' => 'Chat identifier',
     'method_help.getAppUpdate_param_source_type_string' => 'Source',
-    'method_help.getAppConfig' => 'Get app config',
-    'method_help.getPassportConfig' => 'Get passport config',
+    'method_help.getAppConfig' => 'Get app-specific configuration',
+    'method_help.getPassportConfig' => 'Get [passport](https://core.telegram.org/passport) configuration',
     'method_help.getPassportConfig_param_hash_type_Vector t' => 'Hash',
-    'method_help.getSupportName' => 'Get support name',
-    'method_help.getUserInfo' => 'Get user info',
+    'method_help.getSupportName' => 'Get localized name of the telegram support user',
+    'method_help.getUserInfo' => 'Internal use',
     'method_help.getUserInfo_param_user_id_type_InputUser' => 'User ID',
-    'method_help.editUserInfo' => 'Edit user info',
-    'method_help.editUserInfo_param_user_id_type_InputUser' => 'User ID',
+    'method_help.editUserInfo' => 'Internal use',
+    'method_help.editUserInfo_param_user_id_type_InputUser' => 'User',
     'method_help.editUserInfo_param_message_type_string' => 'Message',
     'method_help.editUserInfo_param_entities_type_Vector t' => 'Entities',
-    'method_langpack.getLangPack_param_lang_pack_type_string' => 'Lang pack',
-    'method_langpack.getStrings_param_lang_pack_type_string' => 'Lang pack',
-    'method_langpack.getDifference_param_lang_code_type_string' => 'Lang code',
-    'method_langpack.getLanguages_param_lang_pack_type_string' => 'Lang pack',
-    'method_langpack.getLanguage' => 'Get language',
-    'method_langpack.getLanguage_param_lang_pack_type_string' => 'Lang pack',
-    'method_langpack.getLanguage_param_lang_code_type_string' => 'Lang code',
-    'object_inputMediaGeoLive_param_stopped_type_true' => 'Stopped?',
-    'object_inputMediaPoll' => 'Media poll',
-    'object_inputMediaPoll_param_poll_type_Poll' => 'Poll',
-    'object_inputPhoto_param_file_reference_type_bytes' => 'File reference',
-    'object_inputFileLocation_param_file_reference_type_bytes' => 'File reference',
-    'object_inputDocumentFileLocation_param_file_reference_type_bytes' => 'File reference',
+    'method_langpack.getLangPack_param_lang_pack_type_string' => 'Language pack name',
+    'method_langpack.getStrings_param_lang_pack_type_string' => 'Language pack name',
+    'method_langpack.getDifference_param_lang_code_type_string' => 'Language code',
+    'method_langpack.getLanguages_param_lang_pack_type_string' => 'Language pack',
+    'method_langpack.getLanguage' => 'Get information about a language in a localization pack',
+    'method_langpack.getLanguage_param_lang_pack_type_string' => 'Language pack name',
+    'method_langpack.getLanguage_param_lang_code_type_string' => 'Language code',
+    'object_inputMediaGeoLive_param_stopped_type_true' => 'Whether sending of the geolocation was stopped',
+    'object_inputMediaPoll' => 'A poll',
+    'object_inputMediaPoll_param_poll_type_Poll' => 'The poll to send',
+    'object_inputPhoto_param_file_reference_type_bytes' => '[File reference](https://core.telegram.org/api/file_reference)',
+    'object_inputFileLocation_param_file_reference_type_bytes' => '[File reference](https://core.telegram.org/api/file_reference)',
+    'object_inputDocumentFileLocation_param_file_reference_type_bytes' => '[File reference](https://core.telegram.org/api/file_reference)',
     'object_fileLocation_param_file_reference_type_bytes' => 'File reference',
-    'object_chatFull_param_pinned_msg_id_type_int' => 'Pinned msg ID',
-    'object_channelFull_param_can_view_stats_type_true' => 'Can view stats?',
-    'object_channelFull_param_online_count_type_int' => 'Online count',
-    'object_message_param_from_scheduled_type_true' => 'From scheduled?',
-    'object_messageMediaPoll' => 'Message media poll',
-    'object_messageMediaPoll_param_poll_type_Poll' => 'Poll',
-    'object_messageMediaPoll_param_results_type_PollResults' => 'Results',
-    'object_messageActionContactSignUp' => 'Message action contact sign up',
-    'object_photo_param_file_reference_type_bytes' => 'File reference',
-    'object_inputNotifyBroadcasts' => 'Notify broadcasts',
-    'object_inputReportReasonChildAbuse' => 'Report reason child abuse',
-    'object_inputReportReasonCopyright' => 'Report reason copyright',
-    'object_userFull_param_can_pin_message_type_true' => 'Can pin message?',
-    'object_userFull_param_pinned_msg_id_type_int' => 'Pinned msg ID',
-    'object_messages.channelMessages_param_inexact_type_true' => 'Inexact?',
-    'object_updateLangPackTooLong_param_lang_code_type_string' => 'Lang code',
-    'object_updateUserPinnedMessage' => 'Update user pinned message',
-    'object_updateUserPinnedMessage_param_user_id_type_int' => 'User ID',
-    'object_updateUserPinnedMessage_param_id_type_int' => 'ID',
-    'object_updateChatPinnedMessage' => 'Update chat pinned message',
-    'object_updateChatPinnedMessage_param_chat_id_type_int' => 'Chat ID',
-    'object_updateChatPinnedMessage_param_id_type_int' => 'ID',
-    'object_updateMessagePoll' => 'Update message poll',
+    'object_chatFull_param_pinned_msg_id_type_int' => 'Message ID of the pinned message',
+    'object_channelFull_param_can_view_stats_type_true' => 'Can the user call [messages.getStatsURL](../methods/messages.getStatsURL.md) on this channel',
+    'object_channelFull_param_online_count_type_int' => 'Number of users currently online',
+    'object_message_param_from_scheduled_type_true' => 'Whether this is a scheduled post',
+    'object_messageMediaPoll' => 'Poll',
+    'object_messageMediaPoll_param_poll_type_Poll' => 'The poll',
+    'object_messageMediaPoll_param_results_type_PollResults' => 'The results of the poll',
+    'object_messageActionContactSignUp' => 'A contact just signed up to telegram',
+    'object_photo_param_file_reference_type_bytes' => '[file reference](https://core.telegram.org/api/file_reference)',
+    'object_inputNotifyBroadcasts' => 'All [channels](https://core.telegram.org/api/channel)',
+    'object_inputReportReasonChildAbuse' => 'Report for child abuse',
+    'object_inputReportReasonCopyright' => 'Report for copyrighted content',
+    'object_userFull_param_can_pin_message_type_true' => 'Whether you can pin messages in the chat with this user, you can do this only for a chat with yourself',
+    'object_userFull_param_pinned_msg_id_type_int' => 'Pinned message ID, you can only pin messages in a chat with yourself',
+    'object_messages.channelMessages_param_inexact_type_true' => 'If set, returned results may be inexact',
+    'object_updateLangPackTooLong_param_lang_code_type_string' => 'Language code',
+    'object_updateUserPinnedMessage' => 'A message was pinned in a private chat with a user',
+    'object_updateUserPinnedMessage_param_user_id_type_int' => 'User that pinned the message',
+    'object_updateUserPinnedMessage_param_id_type_int' => 'Message ID that was pinned',
+    'object_updateChatPinnedMessage' => 'A message was pinned in a [legacy group](https://core.telegram.org/api/channel)',
+    'object_updateChatPinnedMessage_param_chat_id_type_int' => '[Legacy group](https://core.telegram.org/api/channel) ID',
+    'object_updateChatPinnedMessage_param_id_type_int' => 'ID of pinned message',
+    'object_updateMessagePoll' => 'The results of a poll have changed',
     'object_updateMessagePoll_param_poll_id_type_long' => 'Poll ID',
-    'object_updateMessagePoll_param_poll_type_Poll' => 'Poll',
-    'object_updateMessagePoll_param_results_type_PollResults' => 'Results',
-    'object_config_param_pfs_enabled_type_true' => 'Pfs enabled?',
-    'object_config_param_base_lang_pack_version_type_int' => 'Base lang pack version',
+    'object_updateMessagePoll_param_poll_type_Poll' => 'If the server knows the client hasn\'t cached this poll yet, the poll itself',
+    'object_updateMessagePoll_param_results_type_PollResults' => 'New poll results',
+    'object_config_param_pfs_enabled_type_true' => 'Whether [pfs](https://core.telegram.org/api/pfs) was used',
+    'object_config_param_base_lang_pack_version_type_int' => 'Basic language pack version',
     'object_help.appUpdate_param_popup_type_true' => 'Popup?',
-    'object_help.appUpdate_param_version_type_string' => 'Version',
+    'object_help.appUpdate_param_version_type_string' => 'New version name',
     'object_help.appUpdate_param_entities_type_Vector t' => 'Entities',
-    'object_help.appUpdate_param_document_type_Document' => 'Document',
-    'object_inputDocument_param_file_reference_type_bytes' => 'File reference',
-    'object_document_param_file_reference_type_bytes' => 'File reference',
-    'object_notifyBroadcasts' => 'Notify broadcasts',
-    'object_inputPrivacyKeyPhoneP2P' => 'Privacy key phone p2p',
-    'object_privacyKeyPhoneP2P' => 'Privacy key phone p2p',
-    'object_authorization_param_current_type_true' => 'Current?',
-    'object_authorization_param_official_app_type_true' => 'Official app?',
-    'object_authorization_param_password_pending_type_true' => 'Password pending?',
-    'object_account.password_param_has_password_type_true' => 'Has password?',
-    'object_account.password_param_current_algo_type_PasswordKdfAlgo' => 'Current algo',
-    'object_account.password_param_srp_B_type_bytes' => 'Srp b',
-    'object_account.password_param_srp_id_type_long' => 'Srp ID',
-    'object_account.password_param_new_algo_type_PasswordKdfAlgo' => 'New algo',
-    'object_account.password_param_new_secure_algo_type_SecurePasswordKdfAlgo' => 'New secure algo',
-    'object_account.passwordSettings_param_secure_settings_type_SecureSecretSettings' => 'Secure settings',
-    'object_account.passwordInputSettings_param_new_algo_type_PasswordKdfAlgo' => 'New algo',
-    'object_account.passwordInputSettings_param_new_secure_settings_type_SecureSecretSettings' => 'New secure settings',
-    'object_textSubscript' => 'Text subscript',
+    'object_help.appUpdate_param_document_type_Document' => 'Attached document',
+    'object_inputDocument_param_file_reference_type_bytes' => '[File reference](https://core.telegram.org/api/file_reference)',
+    'object_document_param_file_reference_type_bytes' => '[File reference](https://core.telegram.org/api/file_reference)',
+    'object_notifyBroadcasts' => 'Channel notification settings',
+    'object_inputPrivacyKeyPhoneP2P' => 'Whether the user allows P2P communication during VoIP calls',
+    'object_privacyKeyPhoneP2P' => 'Whether P2P connections in phone calls are allowed',
+    'object_authorization_param_current_type_true' => 'Whether this is the current session',
+    'object_authorization_param_official_app_type_true' => 'Whether the session is from an official app',
+    'object_authorization_param_password_pending_type_true' => 'Whether the session is still waiting for a 2FA password',
+    'object_account.password_param_has_password_type_true' => 'Whether the user has a password',
+    'object_account.password_param_current_algo_type_PasswordKdfAlgo' => 'The [KDF algorithm for SRP two-factor authentication](https://core.telegram.org/api/srp) of the current password',
+    'object_account.password_param_srp_B_type_bytes' => 'Srp B param for [SRP authorization](https://core.telegram.org/api/srp)',
+    'object_account.password_param_srp_id_type_long' => 'Srp ID param for [SRP authorization](https://core.telegram.org/api/srp)',
+    'object_account.password_param_new_algo_type_PasswordKdfAlgo' => 'The [KDF algorithm for SRP two-factor authentication](https://core.telegram.org/api/srp) to use when creating new passwords',
+    'object_account.password_param_new_secure_algo_type_SecurePasswordKdfAlgo' => 'The KDF algorithm for telegram [passport](https://core.telegram.org/passport)',
+    'object_account.passwordSettings_param_secure_settings_type_SecureSecretSettings' => 'Telegram [passport](https://core.telegram.org/passport) settings',
+    'object_account.passwordInputSettings_param_new_algo_type_PasswordKdfAlgo' => 'The [SRP algorithm](https://core.telegram.org/api/srp) to use',
+    'object_account.passwordInputSettings_param_new_secure_settings_type_SecureSecretSettings' => 'Telegram [passport](https://core.telegram.org/passport) settings',
+    'object_textSubscript' => 'Subscript text',
     'object_textSubscript_param_text_type_RichText' => 'Text',
-    'object_textSuperscript' => 'Text superscript',
+    'object_textSuperscript' => 'Superscript text',
     'object_textSuperscript_param_text_type_RichText' => 'Text',
-    'object_textMarked' => 'Text marked',
+    'object_textMarked' => 'Highlighted text',
     'object_textMarked_param_text_type_RichText' => 'Text',
-    'object_textPhone' => 'Text phone',
+    'object_textPhone' => 'Rich text linked to a phone number',
     'object_textPhone_param_text_type_RichText' => 'Text',
-    'object_textPhone_param_phone_type_string' => 'Phone',
-    'object_textImage' => 'Text image',
+    'object_textPhone_param_phone_type_string' => 'Phone number',
+    'object_textImage' => 'Inline image',
     'object_textImage_param_document_id_type_long' => 'Document ID',
     'object_textImage_param_w_type_int' => 'Width',
     'object_textImage_param_h_type_int' => 'Height',
-    'object_textAnchor' => 'Text anchor',
+    'object_textAnchor' => 'Text linking to another section of the page',
     'object_textAnchor_param_text_type_RichText' => 'Text',
-    'object_textAnchor_param_name_type_string' => 'Name',
+    'object_textAnchor_param_name_type_string' => 'Section name',
     'object_pageBlockPhoto_param_caption_type_PageCaption' => 'Caption',
-    'object_pageBlockPhoto_param_url_type_string' => 'URL',
-    'object_pageBlockPhoto_param_webpage_id_type_long' => 'Webpage ID',
+    'object_pageBlockPhoto_param_url_type_string' => 'HTTP URL of page the photo leads to when clicked',
+    'object_pageBlockPhoto_param_webpage_id_type_long' => 'ID of preview of the page the photo leads to when clicked',
     'object_pageBlockVideo_param_caption_type_PageCaption' => 'Caption',
     'object_pageBlockEmbed_param_caption_type_PageCaption' => 'Caption',
     'object_pageBlockEmbedPost_param_caption_type_PageCaption' => 'Caption',
     'object_pageBlockCollage_param_caption_type_PageCaption' => 'Caption',
     'object_pageBlockSlideshow_param_caption_type_PageCaption' => 'Caption',
-    'object_pageBlockAudio_param_caption_type_PageCaption' => 'Caption',
-    'object_pageBlockKicker' => 'Page block kicker',
-    'object_pageBlockKicker_param_text_type_RichText' => 'Text',
-    'object_pageBlockTable' => 'Page block table',
-    'object_pageBlockTable_param_bordered_type_true' => 'Bordered?',
-    'object_pageBlockTable_param_striped_type_true' => 'Striped?',
+    'object_pageBlockAudio_param_caption_type_PageCaption' => 'Audio caption',
+    'object_pageBlockKicker' => 'Kicker',
+    'object_pageBlockKicker_param_text_type_RichText' => 'Contents',
+    'object_pageBlockTable' => 'Table',
+    'object_pageBlockTable_param_bordered_type_true' => 'Does the table have a visible border?',
+    'object_pageBlockTable_param_striped_type_true' => 'Is the table striped?',
     'object_pageBlockTable_param_title_type_RichText' => 'Title',
     'object_pageBlockTable_param_rows_type_Vector t' => 'Rows',
-    'object_pageBlockOrderedList' => 'Page block ordered list',
+    'object_pageBlockOrderedList' => 'Ordered list of IV blocks',
     'object_pageBlockOrderedList_param_items_type_Vector t' => 'Items',
-    'object_pageBlockDetails' => 'Page block details',
-    'object_pageBlockDetails_param_open_type_true' => 'Open?',
+    'object_pageBlockDetails' => 'A collapsible details block',
+    'object_pageBlockDetails_param_open_type_true' => 'Whether the block is open by default',
     'object_pageBlockDetails_param_blocks_type_Vector t' => 'Blocks',
-    'object_pageBlockDetails_param_title_type_RichText' => 'Title',
-    'object_pageBlockRelatedArticles' => 'Page block related articles',
+    'object_pageBlockDetails_param_title_type_RichText' => 'Always visible heading for the block',
+    'object_pageBlockRelatedArticles' => 'Related articles',
     'object_pageBlockRelatedArticles_param_title_type_RichText' => 'Title',
     'object_pageBlockRelatedArticles_param_articles_type_Vector t' => 'Articles',
-    'object_pageBlockMap' => 'Page block map',
-    'object_pageBlockMap_param_geo_type_GeoPoint' => 'Geo',
-    'object_pageBlockMap_param_zoom_type_int' => 'Zoom',
-    'object_pageBlockMap_param_w_type_int' => 'Width',
-    'object_pageBlockMap_param_h_type_int' => 'Height',
+    'object_pageBlockMap' => 'A map',
+    'object_pageBlockMap_param_geo_type_GeoPoint' => 'Location of the map center',
+    'object_pageBlockMap_param_zoom_type_int' => 'Map zoom level; 13-20',
+    'object_pageBlockMap_param_w_type_int' => 'Map width in pixels before applying scale; 16-102',
+    'object_pageBlockMap_param_h_type_int' => 'Map height in pixels before applying scale; 16-1024',
     'object_pageBlockMap_param_caption_type_PageCaption' => 'Caption',
-    'object_phoneCall_param_p2p_allowed_type_true' => 'P2p allowed?',
-    'object_langPackLanguage_param_official_type_true' => 'Official?',
-    'object_langPackLanguage_param_rtl_type_true' => 'Rtl?',
-    'object_langPackLanguage_param_beta_type_true' => 'Beta?',
-    'object_langPackLanguage_param_base_lang_code_type_string' => 'Base lang code',
-    'object_langPackLanguage_param_plural_code_type_string' => 'Plural code',
-    'object_langPackLanguage_param_strings_count_type_int' => 'Strings count',
-    'object_langPackLanguage_param_translated_count_type_int' => 'Translated count',
-    'object_langPackLanguage_param_translations_url_type_string' => 'Translations URL',
+    'object_phoneCall_param_p2p_allowed_type_true' => 'Whether P2P connection to the other peer is allowed',
+    'object_langPackLanguage_param_official_type_true' => 'Whether the language pack is official',
+    'object_langPackLanguage_param_rtl_type_true' => 'Is this a localization pack for an RTL language',
+    'object_langPackLanguage_param_beta_type_true' => 'Is this a beta localization pack?',
+    'object_langPackLanguage_param_base_lang_code_type_string' => 'Identifier of a base language pack; may be empty. If a string is missed in the language pack, then it should be fetched from base language pack. Unsupported in custom language packs',
+    'object_langPackLanguage_param_plural_code_type_string' => 'A language code to be used to apply plural forms. See [https://www.unicode.org/cldr/charts/latest/supplemental/language\\_plural\\_rules.html](https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html) for more info',
+    'object_langPackLanguage_param_strings_count_type_int' => 'Total number of non-deleted strings from the language pack',
+    'object_langPackLanguage_param_translated_count_type_int' => 'Total number of translated strings from the language pack',
+    'object_langPackLanguage_param_translations_url_type_string' => 'Link to language translation interface; empty for custom local language packs',
     'object_secureValue_param_translation_type_Vector t' => 'Translation',
     'object_inputSecureValue_param_translation_type_Vector t' => 'Translation',
     'object_secureValueError' => 'Secure value error',
-    'object_secureValueError_param_type_type_SecureValueType' => 'Type',
+    'object_secureValueError_param_type_type_SecureValueType' => 'Type of element which has the issue',
     'object_secureValueError_param_hash_type_bytes' => 'Hash',
-    'object_secureValueError_param_text_type_string' => 'Text',
-    'object_secureValueErrorTranslationFile' => 'Secure value error translation file',
-    'object_secureValueErrorTranslationFile_param_type_type_SecureValueType' => 'Type',
+    'object_secureValueError_param_text_type_string' => 'Error message',
+    'object_secureValueErrorTranslationFile' => 'Represents an issue with one of the files that constitute the translation of a document. The error is considered resolved when the file changes.',
+    'object_secureValueErrorTranslationFile_param_type_type_SecureValueType' => 'One of [secureValueTypePersonalDetails](../constructors/secureValueTypePersonalDetails.md), [secureValueTypePassport](../constructors/secureValueTypePassport.md), [secureValueTypeDriverLicense](../constructors/secureValueTypeDriverLicense.md), [secureValueTypeIdentityCard](../constructors/secureValueTypeIdentityCard.md), [secureValueTypeInternalPassport](../constructors/secureValueTypeInternalPassport.md), [secureValueTypeUtilityBill](../constructors/secureValueTypeUtilityBill.md), [secureValueTypeBankStatement](../constructors/secureValueTypeBankStatement.md), [secureValueTypeRentalAgreement](../constructors/secureValueTypeRentalAgreement.md), [secureValueTypePassportRegistration](../constructors/secureValueTypePassportRegistration.md), [secureValueTypeTemporaryRegistration](../constructors/secureValueTypeTemporaryRegistration.md)',
     'object_secureValueErrorTranslationFile_param_file_hash_type_bytes' => 'File hash',
-    'object_secureValueErrorTranslationFile_param_text_type_string' => 'Text',
-    'object_secureValueErrorTranslationFiles' => 'Secure value error translation files',
-    'object_secureValueErrorTranslationFiles_param_type_type_SecureValueType' => 'Type',
+    'object_secureValueErrorTranslationFile_param_text_type_string' => 'Error message',
+    'object_secureValueErrorTranslationFiles' => 'Represents an issue with the translated version of a document. The error is considered resolved when a file with the document translation changes.',
+    'object_secureValueErrorTranslationFiles_param_type_type_SecureValueType' => 'One of [secureValueTypePersonalDetails](../constructors/secureValueTypePersonalDetails.md), [secureValueTypePassport](../constructors/secureValueTypePassport.md), [secureValueTypeDriverLicense](../constructors/secureValueTypeDriverLicense.md), [secureValueTypeIdentityCard](../constructors/secureValueTypeIdentityCard.md), [secureValueTypeInternalPassport](../constructors/secureValueTypeInternalPassport.md), [secureValueTypeUtilityBill](../constructors/secureValueTypeUtilityBill.md), [secureValueTypeBankStatement](../constructors/secureValueTypeBankStatement.md), [secureValueTypeRentalAgreement](../constructors/secureValueTypeRentalAgreement.md), [secureValueTypePassportRegistration](../constructors/secureValueTypePassportRegistration.md), [secureValueTypeTemporaryRegistration](../constructors/secureValueTypeTemporaryRegistration.md)',
     'object_secureValueErrorTranslationFiles_param_file_hash_type_Vector t' => 'File hash',
-    'object_secureValueErrorTranslationFiles_param_text_type_string' => 'Text',
-    'object_passwordKdfAlgoUnknown' => 'Password kdf algo unknown',
-    'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow' => 'Password kdf algo sha256sha256pbkdf2hmacsh a512iter100000 sha256 mod pow',
-    'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_salt1_type_bytes' => 'Salt1',
-    'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_salt2_type_bytes' => 'Salt2',
-    'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_g_type_int' => 'G',
-    'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_p_type_bytes' => 'P',
-    'object_securePasswordKdfAlgoUnknown' => 'Secure password kdf algo unknown',
-    'object_securePasswordKdfAlgoPBKDF2HMACSHA512iter100000' => 'Secure password kdf algo pbkdf2hmacsh a512iter100000',
+    'object_secureValueErrorTranslationFiles_param_text_type_string' => 'Error message',
+    'object_passwordKdfAlgoUnknown' => 'Unknown KDF (most likely, the client is outdated and does not support the specified KDF algorithm)',
+    'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow' => 'This key derivation algorithm defines that [SRP 2FA login](https://core.telegram.org/api/srp) must be used',
+    'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_salt1_type_bytes' => 'One of two salts used by the derivation function (see [SRP 2FA login](https://core.telegram.org/api/srp))',
+    'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_salt2_type_bytes' => 'One of two salts used by the derivation function (see [SRP 2FA login](https://core.telegram.org/api/srp))',
+    'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_g_type_int' => 'Base (see [SRP 2FA login](https://core.telegram.org/api/srp))',
+    'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_p_type_bytes' => '2048-bit modulus (see [SRP 2FA login](https://core.telegram.org/api/srp))',
+    'object_securePasswordKdfAlgoUnknown' => 'Unknown KDF algo (most likely the client has to be updated)',
+    'object_securePasswordKdfAlgoPBKDF2HMACSHA512iter100000' => 'PBKDF2 with SHA512 and 100000 iterations KDF algo',
     'object_securePasswordKdfAlgoPBKDF2HMACSHA512iter100000_param_salt_type_bytes' => 'Salt',
-    'object_securePasswordKdfAlgoSHA512' => 'Secure password kdf algo sha512',
+    'object_securePasswordKdfAlgoSHA512' => 'SHA512 KDF algo',
     'object_securePasswordKdfAlgoSHA512_param_salt_type_bytes' => 'Salt',
-    'object_secureSecretSettings' => 'Secure secret settings',
-    'object_secureSecretSettings_param_secure_algo_type_SecurePasswordKdfAlgo' => 'Secure algo',
+    'object_secureSecretSettings' => 'Secure settings',
+    'object_secureSecretSettings_param_secure_algo_type_SecurePasswordKdfAlgo' => 'Secure KDF algo',
     'object_secureSecretSettings_param_secure_secret_type_bytes' => 'Secure secret',
-    'object_secureSecretSettings_param_secure_secret_id_type_long' => 'Secure secret ID',
-    'object_inputCheckPasswordEmpty' => 'Empty input check password',
-    'object_inputCheckPasswordSRP' => 'Check password srp',
-    'object_inputCheckPasswordSRP_param_srp_id_type_long' => 'Srp ID',
-    'object_inputCheckPasswordSRP_param_A_type_bytes' => 'A',
-    'object_inputCheckPasswordSRP_param_M1_type_bytes' => 'M1',
-    'object_secureRequiredType' => 'Secure required type',
-    'object_secureRequiredType_param_native_names_type_true' => 'Native names?',
-    'object_secureRequiredType_param_selfie_required_type_true' => 'Selfie required?',
-    'object_secureRequiredType_param_translation_required_type_true' => 'Translation required?',
-    'object_secureRequiredType_param_type_type_SecureValueType' => 'Type',
-    'object_secureRequiredTypeOneOf' => 'Secure required type one of',
+    'object_secureSecretSettings_param_secure_secret_id_type_long' => 'Secret ID',
+    'object_inputCheckPasswordEmpty' => 'There is no password',
+    'object_inputCheckPasswordSRP' => 'Constructor for checking the validity of a 2FA SRP password (see [SRP](https://core.telegram.org/api/srp))',
+    'object_inputCheckPasswordSRP_param_srp_id_type_long' => '[SRP ID](https://core.telegram.org/api/srp)',
+    'object_inputCheckPasswordSRP_param_A_type_bytes' => '`A` parameter (see [SRP](https://core.telegram.org/api/srp))',
+    'object_inputCheckPasswordSRP_param_M1_type_bytes' => '`M1` parameter (see [SRP](https://core.telegram.org/api/srp))',
+    'object_secureRequiredType' => 'Required type',
+    'object_secureRequiredType_param_native_names_type_true' => 'Native names',
+    'object_secureRequiredType_param_selfie_required_type_true' => 'Is a selfie required',
+    'object_secureRequiredType_param_translation_required_type_true' => 'Is a translation required',
+    'object_secureRequiredType_param_type_type_SecureValueType' => 'Secure value type',
+    'object_secureRequiredTypeOneOf' => 'One of',
     'object_secureRequiredTypeOneOf_param_types_type_Vector t' => 'Types',
-    'object_help.passportConfigNotModified' => 'Passport config not modified',
-    'object_help.passportConfig' => 'Passport config',
-    'object_help.passportConfig_param_hash_type_int' => 'Hash',
-    'object_help.passportConfig_param_countries_langs_type_DataJSON' => 'Countries langs',
-    'object_inputAppEvent_param_data_type_JSONValue' => 'Data',
-    'object_jsonObjectValue' => 'Json object value',
+    'object_help.passportConfigNotModified' => 'Password configuration not modified',
+    'object_help.passportConfig' => 'Telegram [passport](https://core.telegram.org/passport) configuration',
+    'object_help.passportConfig_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+    'object_help.passportConfig_param_countries_langs_type_DataJSON' => 'Localization',
+    'object_inputAppEvent_param_data_type_JSONValue' => 'Details of the event',
+    'object_jsonObjectValue' => 'JSON key: value pair',
     'object_jsonObjectValue_param_key_type_string' => 'Key',
     'object_jsonObjectValue_param_value_type_JSONValue' => 'Value',
-    'object_jsonNull' => 'Json null',
-    'object_jsonBool' => 'Json bool',
-    'object_jsonBool_param_value_type_Bool' => 'Value?',
-    'object_jsonNumber' => 'Json number',
+    'object_jsonNull' => 'null JSON value',
+    'object_jsonBool' => 'JSON boolean value',
+    'object_jsonBool_param_value_type_Bool' => 'Value',
+    'object_jsonNumber' => 'JSON numeric value',
     'object_jsonNumber_param_value_type_double' => 'Value',
-    'object_jsonString' => 'Json string',
+    'object_jsonString' => 'JSON string',
     'object_jsonString_param_value_type_string' => 'Value',
-    'object_jsonArray' => 'Json array',
+    'object_jsonArray' => 'JSON array',
     'object_jsonArray_param_value_type_Vector t' => 'Value',
-    'object_jsonObject' => 'Json object',
+    'object_jsonObject' => 'JSON object value',
     'object_jsonObject_param_value_type_Vector t' => 'Value',
-    'object_pageTableCell' => 'Page table cell',
-    'object_pageTableCell_param_header_type_true' => 'Header?',
-    'object_pageTableCell_param_align_center_type_true' => 'Align center?',
-    'object_pageTableCell_param_align_right_type_true' => 'Align right?',
-    'object_pageTableCell_param_valign_middle_type_true' => 'Valign middle?',
-    'object_pageTableCell_param_valign_bottom_type_true' => 'Valign bottom?',
-    'object_pageTableCell_param_text_type_RichText' => 'Text',
-    'object_pageTableCell_param_colspan_type_int' => 'Colspan',
-    'object_pageTableCell_param_rowspan_type_int' => 'Rowspan',
-    'object_pageTableRow' => 'Page table row',
+    'object_pageTableCell' => 'Table cell',
+    'object_pageTableCell_param_header_type_true' => 'Is this element part of the column header',
+    'object_pageTableCell_param_align_center_type_true' => 'Horizontally centered block',
+    'object_pageTableCell_param_align_right_type_true' => 'Right-aligned block',
+    'object_pageTableCell_param_valign_middle_type_true' => 'Vertically centered block',
+    'object_pageTableCell_param_valign_bottom_type_true' => 'Block vertically-alligned to the bottom',
+    'object_pageTableCell_param_text_type_RichText' => 'Content',
+    'object_pageTableCell_param_colspan_type_int' => 'For how many columns should this cell extend',
+    'object_pageTableCell_param_rowspan_type_int' => 'For how many rows should this cell extend',
+    'object_pageTableRow' => 'Table row',
     'object_pageTableRow_param_cells_type_Vector t' => 'Cells',
     'object_pageCaption' => 'Page caption',
-    'object_pageCaption_param_text_type_RichText' => 'Text',
-    'object_pageCaption_param_credit_type_RichText' => 'Credit',
-    'object_pageListItemText' => 'Page list item text',
+    'object_pageCaption_param_text_type_RichText' => 'Caption',
+    'object_pageCaption_param_credit_type_RichText' => 'Credits',
+    'object_pageListItemText' => 'List item',
     'object_pageListItemText_param_text_type_RichText' => 'Text',
-    'object_pageListItemBlocks' => 'Page list item blocks',
+    'object_pageListItemBlocks' => 'List item',
     'object_pageListItemBlocks_param_blocks_type_Vector t' => 'Blocks',
-    'object_pageListOrderedItemText' => 'Page list ordered item text',
-    'object_pageListOrderedItemText_param_num_type_string' => 'Num',
+    'object_pageListOrderedItemText' => 'Ordered list of text items',
+    'object_pageListOrderedItemText_param_num_type_string' => 'Number of element within ordered list',
     'object_pageListOrderedItemText_param_text_type_RichText' => 'Text',
-    'object_pageListOrderedItemBlocks' => 'Page list ordered item blocks',
-    'object_pageListOrderedItemBlocks_param_num_type_string' => 'Num',
+    'object_pageListOrderedItemBlocks' => 'Ordered list of [IV](https://instantview.telegram.org) blocks',
+    'object_pageListOrderedItemBlocks_param_num_type_string' => 'Number of element within ordered list',
     'object_pageListOrderedItemBlocks_param_blocks_type_Vector t' => 'Blocks',
-    'object_pageRelatedArticle' => 'Page related article',
-    'object_pageRelatedArticle_param_url_type_string' => 'URL',
-    'object_pageRelatedArticle_param_webpage_id_type_long' => 'Webpage ID',
+    'object_pageRelatedArticle' => 'Related article',
+    'object_pageRelatedArticle_param_url_type_string' => 'URL of article',
+    'object_pageRelatedArticle_param_webpage_id_type_long' => 'Webpage ID of generated IV preview',
     'object_pageRelatedArticle_param_title_type_string' => 'Title',
     'object_pageRelatedArticle_param_description_type_string' => 'Description',
-    'object_pageRelatedArticle_param_photo_id_type_long' => 'Photo ID',
-    'object_pageRelatedArticle_param_author_type_string' => 'Author',
-    'object_pageRelatedArticle_param_published_date_type_int' => 'Published date',
-    'object_page' => 'Page',
-    'object_page_param_part_type_true' => 'Part?',
-    'object_page_param_rtl_type_true' => 'Rtl?',
-    'object_page_param_v2_type_true' => 'V2?',
-    'object_page_param_url_type_string' => 'URL',
+    'object_pageRelatedArticle_param_photo_id_type_long' => 'ID of preview photo',
+    'object_pageRelatedArticle_param_author_type_string' => 'Author name',
+    'object_pageRelatedArticle_param_published_date_type_int' => 'Date of pubblication',
+    'object_page' => '[Instant view](https://instantview.telegram.org) page',
+    'object_page_param_part_type_true' => 'Indicates that not full page preview is available to the client and it will need to fetch full Instant View from the server using [messages.getWebPagePreview](../methods/messages.getWebPagePreview.md).',
+    'object_page_param_rtl_type_true' => 'Whether the page contains RTL text',
+    'object_page_param_v2_type_true' => 'Whether this is an [IV v2](https://instantview.telegram.org/docs#what-39s-new-in-2-0) page',
+    'object_page_param_url_type_string' => 'Original page HTTP URL',
     'object_page_param_blocks_type_Vector t' => 'Blocks',
     'object_page_param_photos_type_Vector t' => 'Photos',
     'object_page_param_documents_type_Vector t' => 'Documents',
-    'object_help.supportName' => 'Support name',
-    'object_help.supportName_param_name_type_string' => 'Name',
-    'object_help.userInfoEmpty' => 'Empty user info',
-    'object_help.userInfo' => 'User info',
-    'object_help.userInfo_param_message_type_string' => 'Message',
+    'object_help.supportName' => 'Localized name for telegram support',
+    'object_help.supportName_param_name_type_string' => 'Localized name',
+    'object_help.userInfoEmpty' => 'Internal use',
+    'object_help.userInfo' => 'Internal use',
+    'object_help.userInfo_param_message_type_string' => 'Info',
     'object_help.userInfo_param_entities_type_Vector t' => 'Entities',
     'object_help.userInfo_param_author_type_string' => 'Author',
     'object_help.userInfo_param_date_type_int' => 'Date',
-    'object_pollAnswer' => 'Poll answer',
-    'object_pollAnswer_param_text_type_string' => 'Text',
-    'object_pollAnswer_param_option_type_bytes' => 'Option',
+    'object_pollAnswer' => 'A possible answer of a poll',
+    'object_pollAnswer_param_text_type_string' => 'Textual representation of the answer',
+    'object_pollAnswer_param_option_type_bytes' => 'The param that has to be passed to [messages.sendVote](../methods/messages.sendVote.md).',
     'object_poll' => 'Poll',
-    'object_poll_param_id_type_long' => 'ID',
-    'object_poll_param_closed_type_true' => 'Closed?',
-    'object_poll_param_question_type_string' => 'Question',
+    'object_poll_param_id_type_long' => 'ID of the poll',
+    'object_poll_param_closed_type_true' => 'Whether the poll is closed and doesn\'t accept any more answers',
+    'object_poll_param_question_type_string' => 'The question of the poll',
     'object_poll_param_answers_type_Vector t' => 'Answers',
-    'object_pollAnswerVoters' => 'Poll answer voters',
-    'object_pollAnswerVoters_param_chosen_type_true' => 'Chosen?',
-    'object_pollAnswerVoters_param_option_type_bytes' => 'Option',
-    'object_pollAnswerVoters_param_voters_type_int' => 'Voters',
-    'object_pollResults' => 'Poll results',
-    'object_pollResults_param_min_type_true' => 'Min?',
+    'object_pollAnswerVoters' => 'A poll answer, and how users voted on it',
+    'object_pollAnswerVoters_param_chosen_type_true' => 'Whether we have chosen this answer',
+    'object_pollAnswerVoters_param_option_type_bytes' => 'The param that has to be passed to [messages.sendVote](../methods/messages.sendVote.md).',
+    'object_pollAnswerVoters_param_voters_type_int' => 'How many users voted for this option',
+    'object_pollResults' => 'Results of poll',
+    'object_pollResults_param_min_type_true' => 'Similar to [min](https://core.telegram.org/api/min) objects, used for poll constructors that are the same for all users so they don\'t have option chosen by the current user (you can use [messages.getPollResults](../methods/messages.getPollResults.md) to get the full poll results).',
     'object_pollResults_param_results_type_Vector t' => 'Results',
-    'object_pollResults_param_total_voters_type_int' => 'Total voters',
-    'object_chatOnlines' => 'Chat onlines',
-    'object_chatOnlines_param_onlines_type_int' => 'Onlines',
-    'object_statsURL' => 'Stats URL',
-    'object_statsURL_param_url_type_string' => 'URL',
-    'method_auth.sendCode_param_settings_type_CodeSettings' => 'You cannot use this method directly, use the phoneLogin method instead (see https://docs.madelineproto.xyz for more info)',
+    'object_pollResults_param_total_voters_type_int' => 'Total number of people that voted in the poll',
+    'object_chatOnlines' => 'Number of online users in a chat',
+    'object_chatOnlines_param_onlines_type_int' => 'Number of online users',
+    'object_statsURL' => 'URL with chat statistics',
+    'object_statsURL_param_url_type_string' => 'Chat statistics',
+    'method_auth.sendCode_param_settings_type_CodeSettings' => 'Settings for the code type to send',
     'method_account.getWallPapers_param_hash_type_Vector t' => 'IDs of previously fetched wallpapers',
-    'method_account.sendChangePhoneCode_param_settings_type_CodeSettings' => 'Code settings',
-    'method_account.sendConfirmPhoneCode_param_settings_type_CodeSettings' => 'Code settings',
-    'method_account.sendVerifyPhoneCode_param_settings_type_CodeSettings' => 'Code settings',
-    'method_account.getWallPaper' => 'Get wallpaper info',
-    'method_account.getWallPaper_param_wallpaper_type_InputWallPaper' => 'Wallpaper',
-    'method_account.uploadWallPaper' => 'Upload wallpaper',
-    'method_account.uploadWallPaper_param_file_type_InputFile' => 'Image',
-    'method_account.uploadWallPaper_param_mime_type_type_string' => 'Mime type',
+    'method_account.sendChangePhoneCode_param_settings_type_CodeSettings' => 'Phone code settings',
+    'method_account.sendConfirmPhoneCode_param_settings_type_CodeSettings' => 'Phone code settings',
+    'method_account.sendVerifyPhoneCode_param_settings_type_CodeSettings' => 'Phone code settings',
+    'method_account.getWallPaper' => 'Get info about a certain wallpaper',
+    'method_account.getWallPaper_param_wallpaper_type_InputWallPaper' => 'The wallpaper to get info about',
+    'method_account.uploadWallPaper' => 'Create and upload a new wallpaper',
+    'method_account.uploadWallPaper_param_file_type_InputFile' => 'The JPG/PNG wallpaper',
+    'method_account.uploadWallPaper_param_mime_type_type_string' => 'MIME type of uploaded wallpaper',
     'method_account.uploadWallPaper_param_settings_type_WallPaperSettings' => 'Wallpaper settings',
-    'method_account.saveWallPaper' => 'Save wallpaper',
-    'method_account.saveWallPaper_param_wallpaper_type_InputWallPaper' => 'The wallpaper to save',
-    'method_account.saveWallPaper_param_unsave_type_Bool' => 'Delete saved wallpaper',
-    'method_account.saveWallPaper_param_settings_type_WallPaperSettings' => 'The wallpaper to save',
+    'method_account.saveWallPaper' => 'Install/uninstall wallpaper',
+    'method_account.saveWallPaper_param_wallpaper_type_InputWallPaper' => 'Wallpaper to save',
+    'method_account.saveWallPaper_param_unsave_type_Bool' => 'Uninstall wallpaper?',
+    'method_account.saveWallPaper_param_settings_type_WallPaperSettings' => 'Wallpaper settings',
     'method_account.installWallPaper' => 'Install wallpaper',
     'method_account.installWallPaper_param_wallpaper_type_InputWallPaper' => 'Wallpaper to install',
     'method_account.installWallPaper_param_settings_type_WallPaperSettings' => 'Wallpaper settings',
-    'method_account.resetWallPapers' => 'Reset wallpapers',
-    'method_messages.exportChatInvite_param_peer_type_InputPeer' => 'Export invite only for this user',
-    'method_messages.editChatAbout' => 'Edit chat info',
-    'method_messages.editChatAbout_param_peer_type_InputPeer' => 'Chat',
-    'method_messages.editChatAbout_param_about_type_string' => 'Info',
-    'method_messages.editChatDefaultBannedRights' => 'Edit default rights of chat',
-    'method_messages.editChatDefaultBannedRights_param_peer_type_InputPeer' => 'Chat',
-    'method_messages.editChatDefaultBannedRights_param_banned_rights_type_ChatBannedRights' => 'Global chat rights',
-    'method_channels.editAdmin_param_admin_rights_type_ChatAdminRights' => 'Admin rights',
-    'method_channels.editBanned_param_banned_rights_type_ChatBannedRights' => 'Banned rights',
-    'object_chat_param_admin_rights_type_ChatAdminRights' => 'Admin rights of current user',
-    'object_chat_param_default_banned_rights_type_ChatBannedRights' => 'Global chat banned rights',
-    'object_channel_param_admin_rights_type_ChatAdminRights' => 'Admin rights of current user',
-    'object_channel_param_banned_rights_type_ChatBannedRights' => 'Banned rights of current user',
-    'object_channel_param_default_banned_rights_type_ChatBannedRights' => 'Global chat banned rights',
-    'object_chatFull_param_can_set_username_type_true' => 'Can set username?',
-    'object_chatFull_param_about_type_string' => 'Chat about',
-    'object_photoStrippedSize' => 'Stripped size',
-    'object_photoStrippedSize_param_type_type_string' => 'Stripped size',
-    'object_photoStrippedSize_param_bytes_type_bytes' => 'Bytes',
-    'object_wallPaper_param_id_type_long' => 'ID',
-    'object_wallPaper_param_creator_type_true' => 'Am I the creator?',
-    'object_wallPaper_param_default_type_true' => 'Default?',
+    'method_account.resetWallPapers' => 'Delete installed wallpapers',
+    'method_messages.exportChatInvite_param_peer_type_InputPeer' => 'Chat',
+    'method_messages.editChatAbout' => 'Edit the description of a [group/supergroup/channel](https://core.telegram.org/api/channel).',
+    'method_messages.editChatAbout_param_peer_type_InputPeer' => 'The [group/supergroup/channel](https://core.telegram.org/api/channel).',
+    'method_messages.editChatAbout_param_about_type_string' => 'The new description',
+    'method_messages.editChatDefaultBannedRights' => 'Edit the default banned rights of a [channel/supergroup/group](https://core.telegram.org/api/channel).',
+    'method_messages.editChatDefaultBannedRights_param_peer_type_InputPeer' => 'The peer',
+    'method_messages.editChatDefaultBannedRights_param_banned_rights_type_ChatBannedRights' => 'The new global rights',
+    'method_channels.editAdmin_param_admin_rights_type_ChatAdminRights' => 'The admin rights',
+    'method_channels.editBanned_param_banned_rights_type_ChatBannedRights' => 'The banned rights',
+    'object_chat_param_admin_rights_type_ChatAdminRights' => '[Admin rights](https://core.telegram.org/api/rights) of the user in the group',
+    'object_chat_param_default_banned_rights_type_ChatBannedRights' => '[Default banned rights](https://core.telegram.org/api/rights) of all users in the group',
+    'object_channel_param_admin_rights_type_ChatAdminRights' => 'Admin rights of the user in this channel (see [rights](https://core.telegram.org/api/rights))',
+    'object_channel_param_banned_rights_type_ChatBannedRights' => 'Banned rights of the user in this channel (see [rights](https://core.telegram.org/api/rights))',
+    'object_channel_param_default_banned_rights_type_ChatBannedRights' => 'Default chat rights (see [rights](https://core.telegram.org/api/rights))',
+    'object_chatFull_param_can_set_username_type_true' => 'Can we change the username of this chat',
+    'object_chatFull_param_about_type_string' => 'About string for this chat',
+    'object_photoStrippedSize' => 'Just the image\'s content',
+    'object_photoStrippedSize_param_type_type_string' => 'Thumbnail type',
+    'object_photoStrippedSize_param_bytes_type_bytes' => 'Thumbnail data',
+    'object_wallPaper_param_id_type_long' => 'Identifier',
+    'object_wallPaper_param_creator_type_true' => 'Creator of the wallpaper',
+    'object_wallPaper_param_default_type_true' => 'Whether this is the default wallpaper',
     'object_wallPaper_param_pattern_type_true' => 'Pattern',
-    'object_wallPaper_param_dark_type_true' => 'Dark?',
-    'object_wallPaper_param_access_hash_type_long' => 'Hash',
-    'object_wallPaper_param_slug_type_string' => 'Slug?',
-    'object_wallPaper_param_document_type_Document' => 'Wallpaper',
+    'object_wallPaper_param_dark_type_true' => 'Dark mode',
+    'object_wallPaper_param_access_hash_type_long' => 'Access hash',
+    'object_wallPaper_param_slug_type_string' => 'Unique wallpaper ID',
+    'object_wallPaper_param_document_type_Document' => 'The actual wallpaper',
     'object_wallPaper_param_settings_type_WallPaperSettings' => 'Wallpaper settings',
-    'object_messages.messagesSlice_param_inexact_type_true' => 'Inexact?',
-    'object_updateChatDefaultBannedRights' => 'Global chat rights updated',
-    'object_updateChatDefaultBannedRights_param_peer_type_Peer' => 'Peer',
-    'object_updateChatDefaultBannedRights_param_default_banned_rights_type_ChatBannedRights' => 'Global chat rights',
+    'object_messages.messagesSlice_param_inexact_type_true' => 'If set, indicates that the results may be inexact',
+    'object_updateChatDefaultBannedRights' => 'Default banned rights in a [normal chat](https://core.telegram.org/api/channel) were updated',
+    'object_updateChatDefaultBannedRights_param_peer_type_Peer' => 'The chat',
+    'object_updateChatDefaultBannedRights_param_default_banned_rights_type_ChatBannedRights' => 'New default banned rights',
     'object_updateChatDefaultBannedRights_param_version_type_int' => 'Version',
     'object_document_param_thumbs_type_Vector t' => 'Thumbnails',
-    'object_channelParticipantAdmin_param_self_type_true' => 'Is this the current user?',
-    'object_channelParticipantAdmin_param_admin_rights_type_ChatAdminRights' => 'Admin rights',
-    'object_channelParticipantBanned_param_banned_rights_type_ChatBannedRights' => 'Banned rights',
-    'object_channelParticipantsContacts' => 'Contacts',
-    'object_channelParticipantsContacts_param_q_type_string' => 'Query',
-    'object_channelAdminLogEventActionDefaultBannedRights' => 'Changed global chat rights',
-    'object_channelAdminLogEventActionDefaultBannedRights_param_prev_banned_rights_type_ChatBannedRights' => 'Previous Banned rights of current user',
-    'object_channelAdminLogEventActionDefaultBannedRights_param_new_banned_rights_type_ChatBannedRights' => 'New Banned rights of current user',
-    'object_channelAdminLogEventActionStopPoll' => 'Stopped poll',
-    'object_channelAdminLogEventActionStopPoll_param_message_type_Message' => 'Message',
-    'object_chatAdminRights' => 'Admin rights',
-    'object_chatAdminRights_param_change_info_type_true' => 'Can change info?',
-    'object_chatAdminRights_param_post_messages_type_true' => 'Can post messages?',
-    'object_chatAdminRights_param_edit_messages_type_true' => 'Can edit messages?',
-    'object_chatAdminRights_param_delete_messages_type_true' => 'Can delete messages?',
-    'object_chatAdminRights_param_ban_users_type_true' => 'Can ban users?',
-    'object_chatAdminRights_param_invite_users_type_true' => 'Can invite users?',
-    'object_chatAdminRights_param_pin_messages_type_true' => 'Can pin messages?',
-    'object_chatAdminRights_param_add_admins_type_true' => 'Can add other admins?',
-    'object_chatBannedRights' => 'Banned rights (when true, the user will NOT be able to do that thing)',
-    'object_chatBannedRights_param_view_messages_type_true' => 'Can view messages?',
+    'object_channelParticipantAdmin_param_self_type_true' => 'Is this the current user',
+    'object_channelParticipantAdmin_param_admin_rights_type_ChatAdminRights' => 'Admin [rights](https://core.telegram.org/api/rights)',
+    'object_channelParticipantBanned_param_banned_rights_type_ChatBannedRights' => 'Banned [rights](https://core.telegram.org/api/rights)',
+    'object_channelParticipantsContacts' => 'Fetch only participants that are also contacts',
+    'object_channelParticipantsContacts_param_q_type_string' => 'Optional search query for searching contact participants by name',
+    'object_channelAdminLogEventActionDefaultBannedRights' => 'The default banned rights were modified',
+    'object_channelAdminLogEventActionDefaultBannedRights_param_prev_banned_rights_type_ChatBannedRights' => 'Previous global [banned rights](https://core.telegram.org/api/rights)',
+    'object_channelAdminLogEventActionDefaultBannedRights_param_new_banned_rights_type_ChatBannedRights' => 'New glboal [banned rights](https://core.telegram.org/api/rights).',
+    'object_channelAdminLogEventActionStopPoll' => 'A poll was stopped',
+    'object_channelAdminLogEventActionStopPoll_param_message_type_Message' => 'The poll that was stopped',
+    'object_chatAdminRights' => 'Represents the rights of an admin in a [channel/supergroup](https://core.telegram.org/api/channel).',
+    'object_chatAdminRights_param_change_info_type_true' => 'If set, allows the admin to modify the description of the [channel/supergroup](https://core.telegram.org/api/channel)',
+    'object_chatAdminRights_param_post_messages_type_true' => 'If set, allows the admin to post messages in the [channel](https://core.telegram.org/api/channel)',
+    'object_chatAdminRights_param_edit_messages_type_true' => 'If set, allows the admin to also edit messages from other admins in the [channel](https://core.telegram.org/api/channel)',
+    'object_chatAdminRights_param_delete_messages_type_true' => 'If set, allows the admin to also delete messages from other admins in the [channel](https://core.telegram.org/api/channel)',
+    'object_chatAdminRights_param_ban_users_type_true' => 'If set, allows the admin to ban users from the [channel/supergroup](https://core.telegram.org/api/channel)',
+    'object_chatAdminRights_param_invite_users_type_true' => 'If set, allows the admin to invite users in the [channel/supergroup](https://core.telegram.org/api/channel)',
+    'object_chatAdminRights_param_pin_messages_type_true' => 'If set, allows the admin to pin messages in the [channel/supergroup](https://core.telegram.org/api/channel)',
+    'object_chatAdminRights_param_add_admins_type_true' => 'If set, allows the admin to add other admins with the same (or more limited) permissions in the [channel/supergroup](https://core.telegram.org/api/channel)',
+    'object_chatBannedRights' => 'Represents the rights of a normal user in a [supergroup/channel/chat](https://core.telegram.org/api/channel). In this case, the flags are inverted: if set, a flag **does not allow** a user to do X.',
+    'object_chatBannedRights_param_view_messages_type_true' => 'If set, does not allow a user to view messages in a [supergroup/channel/chat](https://core.telegram.org/api/channel)',
     'object_chatBannedRights_param_sendMessages_type_true' => 'Can send messages?',
-    'object_chatBannedRights_param_send_media_type_true' => 'Can send media?',
-    'object_chatBannedRights_param_send_stickers_type_true' => 'Can send stickers?',
-    'object_chatBannedRights_param_send_gifs_type_true' => 'Can send gifs?',
-    'object_chatBannedRights_param_send_games_type_true' => 'Can send games?',
-    'object_chatBannedRights_param_send_inline_type_true' => 'Can use inline bots?',
-    'object_chatBannedRights_param_embed_links_type_true' => 'Can embed links?',
-    'object_chatBannedRights_param_send_polls_type_true' => 'Can send polls?',
-    'object_chatBannedRights_param_change_info_type_true' => 'Can change info?',
-    'object_chatBannedRights_param_invite_users_type_true' => 'Can invite users?',
-    'object_chatBannedRights_param_pin_messages_type_true' => 'Can pin messages?',
-    'object_chatBannedRights_param_until_date_type_int' => 'Until date (0 = forever)',
+    'object_chatBannedRights_param_send_media_type_true' => 'If set, does not allow a user to send any media in a [supergroup/chat](https://core.telegram.org/api/channel)',
+    'object_chatBannedRights_param_send_stickers_type_true' => 'If set, does not allow a user to send stickers in a [supergroup/chat](https://core.telegram.org/api/channel)',
+    'object_chatBannedRights_param_send_gifs_type_true' => 'If set, does not allow a user to send gifs in a [supergroup/chat](https://core.telegram.org/api/channel)',
+    'object_chatBannedRights_param_send_games_type_true' => 'If set, does not allow a user to send games in a [supergroup/chat](https://core.telegram.org/api/channel)',
+    'object_chatBannedRights_param_send_inline_type_true' => 'If set, does not allow a user to use inline bots in a [supergroup/chat](https://core.telegram.org/api/channel)',
+    'object_chatBannedRights_param_embed_links_type_true' => 'If set, does not allow a user to embed links in the messages of a [supergroup/chat](https://core.telegram.org/api/channel)',
+    'object_chatBannedRights_param_send_polls_type_true' => 'If set, does not allow a user to send stickers in a [supergroup/chat](https://core.telegram.org/api/channel)',
+    'object_chatBannedRights_param_change_info_type_true' => 'If set, does not allow any user to change the description of a [supergroup/chat](https://core.telegram.org/api/channel)',
+    'object_chatBannedRights_param_invite_users_type_true' => 'If set, does not allow any user to invite users in a [supergroup/chat](https://core.telegram.org/api/channel)',
+    'object_chatBannedRights_param_pin_messages_type_true' => 'If set, does not allow any user to pin messages in a [supergroup/chat](https://core.telegram.org/api/channel)',
+    'object_chatBannedRights_param_until_date_type_int' => 'Validity of said permissions (0 = forever, forever = 2^31-1 for now).',
     'object_inputWallPaper' => 'Wallpaper',
-    'object_inputWallPaper_param_id_type_long' => 'ID',
+    'object_inputWallPaper_param_id_type_long' => 'Wallpaper ID',
     'object_inputWallPaper_param_access_hash_type_long' => 'Access hash',
-    'object_inputWallPaperSlug' => 'Wallpaper slug',
-    'object_inputWallPaperSlug_param_slug_type_string' => 'Type',
-    'object_account.wallPapersNotModified' => 'No wallpapers were modified',
-    'object_account.wallPapers' => 'Wallpapers',
-    'object_account.wallPapers_param_hash_type_int' => 'Hash',
+    'object_inputWallPaperSlug' => 'Wallpaper by slug (a unique ID)',
+    'object_inputWallPaperSlug_param_slug_type_string' => 'Unique wallpaper ID',
+    'object_account.wallPapersNotModified' => 'No new wallpapers were found',
+    'object_account.wallPapers' => 'Installed wallpapers',
+    'object_account.wallPapers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
     'object_account.wallPapers_param_wallpapers_type_Vector t' => 'Wallpapers',
-    'object_codeSettings' => 'Code settings',
-    'object_codeSettings_param_allow_flashcall_type_true' => 'Allow flashcal?',
-    'object_codeSettings_param_current_number_type_true' => 'Current number?',
+    'object_codeSettings' => 'Settings used by telegram servers for sending the confirm code.
+
+Example implementations: [telegram for android](https://github.com/DrKLO/Telegram/blob/master/TMessagesProj/src/main/java/org/telegram/ui/LoginActivity.java), [tdlib](https://github.com/tdlib/td/tree/master/td/telegram/SendCodeHelper.cpp).',
+    'object_codeSettings_param_allow_flashcall_type_true' => 'Whether to allow phone verification via [phone calls](https://core.telegram.org/api/auth).',
+    'object_codeSettings_param_current_number_type_true' => 'Pass true if the phone number is used on the current device. Ignored if allow\\_flashcall is not set.',
     'object_codeSettings_param_app_hash_persistent_type_true' => 'Persistent hash?',
     'object_codeSettings_param_app_hash_type_string' => 'Hash type',
     'object_wallPaperSettings' => 'Wallpaper settings',
-    'object_wallPaperSettings_param_blur_type_true' => 'Blur?',
-    'object_wallPaperSettings_param_motion_type_true' => 'Motion?',
-    'object_wallPaperSettings_param_background_color_type_int' => 'Background color',
-    'object_wallPaperSettings_param_intensity_type_int' => 'Intensity',
-    'object_inputPrivacyKeyProfilePhoto' => 'Can his profile photo be viewed?',
-    'object_inputPrivacyKeyForwards' => 'Can his messages be forwarded?',
-    'method_account.getAutoDownloadSettings' => 'Get autodownload settings',
-    'method_account.saveAutoDownloadSettings' => 'Save autodownload settings',
-    'method_account.saveAutoDownloadSettings_param_low_type_true' => 'Low preset',
-    'method_account.saveAutoDownloadSettings_param_high_type_true' => 'High preset',
-    'method_account.saveAutoDownloadSettings_param_settings_type_AutoDownloadSettings' => 'Autodownload settings',
-    'method_messages.deleteHistory_param_revoke_type_true' => 'Delete messages for the other user',
-    'method_messages.getStatsURL_param_dark_type_true' => 'Dark?',
-    'method_messages.getStatsURL_param_params_type_string' => 'Params',
-    'method_messages.getEmojiKeywords' => 'Get emoji keywords',
+    'object_wallPaperSettings_param_blur_type_true' => 'If set, the wallpaper must be downscaled to fit in 450x450 square and then box-blurred with radius 12',
+    'object_wallPaperSettings_param_motion_type_true' => 'If set, the background needs to be slightly moved when device is rotated',
+    'object_wallPaperSettings_param_background_color_type_int' => 'If set, a PNG pattern is to be combined with the `color` chosen by the user: the main color of the background in RGB24 format',
+    'object_wallPaperSettings_param_intensity_type_int' => 'Intensity of the pattern when it is shown above the main background color, 0-100',
+    'object_inputPrivacyKeyProfilePhoto' => 'Whether people will be able to see the user\'s profile picture',
+    'object_inputPrivacyKeyForwards' => 'Whether messages forwarded from this user will be [anonymous](https://telegram.org/blog/unsend-privacy-emoji#anonymous-forwarding)',
+    'method_account.getAutoDownloadSettings' => 'Get media autodownload settings',
+    'method_account.saveAutoDownloadSettings' => 'Change media autodownload settings',
+    'method_account.saveAutoDownloadSettings_param_low_type_true' => 'Whether to save settings in the low data usage preset',
+    'method_account.saveAutoDownloadSettings_param_high_type_true' => 'Whether to save settings in the high data usage preset',
+    'method_account.saveAutoDownloadSettings_param_settings_type_AutoDownloadSettings' => 'Media autodownload settings',
+    'method_messages.deleteHistory_param_revoke_type_true' => 'Whether to delete the message history for all chat participants',
+    'method_messages.getStatsURL_param_dark_type_true' => 'Pass true if a URL with the dark theme must be returned',
+    'method_messages.getStatsURL_param_params_type_string' => 'Parameters from `tg://statsrefresh?params=******` link',
+    'method_messages.getEmojiKeywords' => 'Get localized emoji keywords',
     'method_messages.getEmojiKeywords_param_lang_code_type_string' => 'Language code',
-    'method_messages.getEmojiKeywordsDifference' => 'Get emoji keyword difference',
+    'method_messages.getEmojiKeywordsDifference' => 'Get changed emoji keywords',
     'method_messages.getEmojiKeywordsDifference_param_lang_code_type_string' => 'Language code',
-    'method_messages.getEmojiKeywordsDifference_param_from_version_type_int' => 'From version',
-    'method_messages.getEmojiURL' => 'Get emoji URL',
-    'method_messages.getEmojiURL_param_lang_code_type_string' => 'Language code',
-    'method_phone.setCallRating_param_user_initiative_type_true' => 'User initiative',
+    'method_messages.getEmojiKeywordsDifference_param_from_version_type_int' => 'Previous emoji keyword localization version',
+    'method_messages.getEmojiURL' => 'Returns an HTTP URL which can be used to automatically log in into translation platform and suggest new emoji replacements. The URL will be valid for 30 seconds after generation',
+    'method_messages.getEmojiURL_param_lang_code_type_string' => 'Language code for which the emoji replacements will be suggested',
+    'method_phone.setCallRating_param_user_initiative_type_true' => 'Whether the user decided on their own initiative to rate the call',
     'method_langpack.getDifference_param_lang_pack_type_string' => 'Language pack',
-    'object_user_param_support_type_true' => 'Is this a support user?',
-    'object_updateChatPinnedMessage_param_version_type_int' => 'Version',
-    'object_privacyKeyForwards' => 'Forwards privacy key',
-    'object_privacyKeyProfilePhoto' => 'Show profile photo?',
-    'object_stickerSet_param_thumb_type_PhotoSize' => 'Thumbnail',
-    'object_messageFwdHeader_param_from_name_type_string' => 'Author of the original message',
+    'object_user_param_support_type_true' => 'Whether this is an official support user',
+    'object_updateChatPinnedMessage_param_version_type_int' => 'Used to reorder updates in legacy groups',
+    'object_privacyKeyForwards' => 'Whether messages forwarded from the user will be [anonymously forwarded](https://telegram.org/blog/unsend-privacy-emoji#anonymous-forwarding)',
+    'object_privacyKeyProfilePhoto' => 'Whether the profile picture of the user is visible',
+    'object_stickerSet_param_thumb_type_PhotoSize' => 'Thumbnail for stickerset',
+    'object_messageFwdHeader_param_from_name_type_string' => 'The name of the user that originally sent the message',
     'object_autoDownloadSettings' => 'Autodownload settings',
-    'object_autoDownloadSettings_param_disabled_type_true' => 'Disabled?',
-    'object_autoDownloadSettings_param_video_preload_large_type_true' => 'Preload large videos?',
-    'object_autoDownloadSettings_param_audio_preload_next_type_true' => 'Preload audios?',
-    'object_autoDownloadSettings_param_phonecalls_less_data_type_true' => 'Use less data in phonecalls?',
-    'object_autoDownloadSettings_param_photo_size_max_type_int' => 'Maximum photo file size to preload',
-    'object_autoDownloadSettings_param_video_size_max_type_int' => 'Maximum video file size to preload',
-    'object_autoDownloadSettings_param_file_size_max_type_int' => 'Maximum file size to preload',
-    'object_account.autoDownloadSettings' => 'Autodownload settings',
-    'object_account.autoDownloadSettings_param_low_type_AutoDownloadSettings' => 'Low preset?',
-    'object_account.autoDownloadSettings_param_medium_type_AutoDownloadSettings' => 'Medium preset?',
-    'object_account.autoDownloadSettings_param_high_type_AutoDownloadSettings' => 'High preset?',
+    'object_autoDownloadSettings_param_disabled_type_true' => 'Disable automatic media downloads?',
+    'object_autoDownloadSettings_param_video_preload_large_type_true' => 'Whether to preload the first seconds of videos larger than the specified limit',
+    'object_autoDownloadSettings_param_audio_preload_next_type_true' => 'Whether to preload the next audio track when you\'re listening to music',
+    'object_autoDownloadSettings_param_phonecalls_less_data_type_true' => 'Whether to enable data saving mode in phone calls',
+    'object_autoDownloadSettings_param_photo_size_max_type_int' => 'Maximum size of photos to preload',
+    'object_autoDownloadSettings_param_video_size_max_type_int' => 'Maximum size of videos to preload',
+    'object_autoDownloadSettings_param_file_size_max_type_int' => 'Maximum size of other files to preload',
+    'object_account.autoDownloadSettings' => 'Media autodownload settings',
+    'object_account.autoDownloadSettings_param_low_type_AutoDownloadSettings' => 'Low data usage preset',
+    'object_account.autoDownloadSettings_param_medium_type_AutoDownloadSettings' => 'Medium data usage preset',
+    'object_account.autoDownloadSettings_param_high_type_AutoDownloadSettings' => 'High data usage preset',
     'object_emojiKeyword' => 'Emoji keyword',
     'object_emojiKeyword_param_keyword_type_string' => 'Keyword',
     'object_emojiKeyword_param_emoticons_type_Vector t' => 'Emoticons',
     'object_emojiKeywordDeleted' => 'Deleted emoji keyword',
     'object_emojiKeywordDeleted_param_keyword_type_string' => 'Keyword',
     'object_emojiKeywordDeleted_param_emoticons_type_Vector t' => 'Emoticons',
-    'object_emojiKeywordsDifference' => 'Emoji keword difference',
-    'object_emojiKeywordsDifference_param_lang_code_type_string' => 'Language code',
-    'object_emojiKeywordsDifference_param_from_version_type_int' => 'Previous version',
-    'object_emojiKeywordsDifference_param_version_type_int' => 'Current version',
+    'object_emojiKeywordsDifference' => 'Changes to emoji keywords',
+    'object_emojiKeywordsDifference_param_lang_code_type_string' => 'Language code for keywords',
+    'object_emojiKeywordsDifference_param_from_version_type_int' => 'Previous emoji keyword list version',
+    'object_emojiKeywordsDifference_param_version_type_int' => 'Current version of emoji keyword list',
     'object_emojiKeywordsDifference_param_keywords_type_Vector t' => 'Keywords',
-    'object_emojiURL' => 'Emoji URL',
-    'object_emojiURL_param_url_type_string' => 'URL',
-    'method_contacts.getTopPeers_param_forward_users_type_true' => 'Forward users?',
-    'method_contacts.getTopPeers_param_forward_chats_type_true' => 'Forward chats?',
+    'object_emojiURL' => 'An HTTP URL which can be used to automatically log in into translation platform and suggest new emoji replacements. The URL will be valid for 30 seconds after generation',
+    'object_emojiURL_param_url_type_string' => 'An HTTP URL which can be used to automatically log in into translation platform and suggest new emoji replacements. The URL will be valid for 30 seconds after generation',
+    'method_contacts.getTopPeers_param_forward_users_type_true' => 'Users to which the users often forwards messages to',
+    'method_contacts.getTopPeers_param_forward_chats_type_true' => 'Chats to which the users often forwards messages to',
     'method_messages.getDialogs_param_folder_id_type_int' => 'Folder ID',
-    'method_messages.searchGlobal_param_offset_rate_type_int' => 'Offset rate',
+    'method_messages.searchGlobal_param_offset_rate_type_int' => 'Initially 0, then set to the [`next_rate` parameter of messages.messagesSlice](../constructors/messages.messagesSlice.md)',
     'method_messages.reorderPinnedDialogs_param_folder_id_type_int' => 'Folder ID',
     'method_messages.getPinnedDialogs_param_folder_id_type_int' => 'Folder ID',
-    'method_messages.getEmojiKeywordsLanguages' => 'Get emoji keyword languages',
+    'method_messages.getEmojiKeywordsLanguages' => 'Get info about an emoji keyword localization',
     'method_messages.getEmojiKeywordsLanguages_param_lang_codes_type_Vector t' => 'Language codes',
-    'method_messages.getSearchCounters' => 'Get search counter',
-    'method_messages.getSearchCounters_param_peer_type_InputPeer' => 'Peer',
+    'method_messages.getSearchCounters' => 'Get the number of results that would be found by a [messages.search](../methods/messages.search.md) call with the same parameters',
+    'method_messages.getSearchCounters_param_peer_type_InputPeer' => 'Peer where to search',
     'method_messages.getSearchCounters_param_filters_type_Vector t' => 'Filters',
-    'method_messages.requestUrlAuth' => 'Request URL authorization',
-    'method_messages.requestUrlAuth_param_peer_type_InputPeer' => 'Peer',
-    'method_messages.requestUrlAuth_param_msg_id_type_int' => 'Message ID',
-    'method_messages.requestUrlAuth_param_button_id_type_int' => 'Button ID',
-    'method_messages.acceptUrlAuth' => 'Accept URL authorization',
-    'method_messages.acceptUrlAuth_param_write_allowed_type_true' => 'Write allowed?',
-    'method_messages.acceptUrlAuth_param_peer_type_InputPeer' => 'Peer',
-    'method_messages.acceptUrlAuth_param_msg_id_type_int' => 'Message ID',
-    'method_messages.acceptUrlAuth_param_button_id_type_int' => 'Button ID',
-    'method_channels.getGroupsForDiscussion' => 'Get groups for discussion',
+    'method_messages.requestUrlAuth' => 'Get more info about a Seamless Telegram Login authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization)',
+    'method_messages.requestUrlAuth_param_peer_type_InputPeer' => 'Peer where the message is located',
+    'method_messages.requestUrlAuth_param_msg_id_type_int' => 'The message',
+    'method_messages.requestUrlAuth_param_button_id_type_int' => 'The ID of the button with the authorization request',
+    'method_messages.acceptUrlAuth' => 'Use this to accept a Seamless Telegram Login authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization)',
+    'method_messages.acceptUrlAuth_param_write_allowed_type_true' => 'Set this flag to allow the bot to send messages to you (if requested)',
+    'method_messages.acceptUrlAuth_param_peer_type_InputPeer' => 'The location of the message',
+    'method_messages.acceptUrlAuth_param_msg_id_type_int' => 'Message ID of the message with the login button',
+    'method_messages.acceptUrlAuth_param_button_id_type_int' => 'ID of the login button',
+    'method_channels.getGroupsForDiscussion' => 'Get all groups that can be used as [discussion groups](https://telegram.org/blog/privacy-discussions-web-bots)',
     'method_channels.getBroadcastsForDiscussion' => 'Get channels for discussion',
-    'method_channels.setDiscussionGroup' => 'Set discussion group of channel',
-    'method_channels.setDiscussionGroup_param_broadcast_type_InputChannel' => 'The channel',
-    'method_channels.setDiscussionGroup_param_group_type_InputChannel' => 'The group',
-    'method_phone.requestCall_param_video_type_true' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-    'method_phone.discardCall_param_video_type_true' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-    'method_folders.editPeerFolders' => 'Edit folder',
+    'method_channels.setDiscussionGroup' => 'Associate a group to a channel as [discussion group](https://telegram.org/blog/privacy-discussions-web-bots) for that channel',
+    'method_channels.setDiscussionGroup_param_broadcast_type_InputChannel' => 'Channel',
+    'method_channels.setDiscussionGroup_param_group_type_InputChannel' => 'Discussion group to associate to the channel',
+    'method_phone.requestCall_param_video_type_true' => 'Whether to start a video call',
+    'method_phone.discardCall_param_video_type_true' => 'Whether this is a video call',
+    'method_folders.editPeerFolders' => 'Edit peers in folder',
     'method_folders.editPeerFolders_param_folder_peers_type_Vector t' => 'New folder peers',
-    'method_folders.deleteFolder' => 'Delete folder',
-    'method_folders.deleteFolder_param_folder_id_type_int' => 'Folder ID',
-    'object_inputPeerUserFromMessage' => 'User from message',
-    'object_inputPeerUserFromMessage_param_peer_type_InputPeer' => 'Chat',
-    'object_inputPeerUserFromMessage_param_msg_id_type_int' => 'Message ID',
-    'object_inputPeerUserFromMessage_param_user_id_type_int' => 'User ID',
-    'object_inputPeerChannelFromMessage' => 'Channel from message',
-    'object_inputPeerChannelFromMessage_param_peer_type_InputPeer' => 'Peer',
-    'object_inputPeerChannelFromMessage_param_msg_id_type_int' => 'Message ID',
-    'object_inputPeerChannelFromMessage_param_channel_id_type_int' => 'Channel ID',
-    'object_inputUserFromMessage' => 'User from message',
-    'object_inputUserFromMessage_param_peer_type_InputPeer' => 'Peer',
-    'object_inputUserFromMessage_param_msg_id_type_int' => 'Message ID',
-    'object_inputUserFromMessage_param_user_id_type_int' => 'User ID',
-    'object_inputDocumentFileLocation_param_thumb_size_type_string' => 'Thumb size',
-    'object_inputPhotoFileLocation' => 'Photo file location',
-    'object_inputPhotoFileLocation_param_id_type_long' => 'ID',
-    'object_inputPhotoFileLocation_param_access_hash_type_long' => 'Access hash',
-    'object_inputPhotoFileLocation_param_file_reference_type_bytes' => 'File reference',
-    'object_inputPhotoFileLocation_param_thumb_size_type_string' => 'Thumb size',
-    'object_inputPeerPhotoFileLocation' => 'Profile picture location',
-    'object_inputPeerPhotoFileLocation_param_big_type_true' => 'Big?',
-    'object_inputPeerPhotoFileLocation_param_peer_type_InputPeer' => 'Peer',
-    'object_inputPeerPhotoFileLocation_param_volume_id_type_long' => 'Volume ID',
-    'object_inputPeerPhotoFileLocation_param_local_id_type_int' => 'Local ID',
-    'object_inputStickerSetThumb' => 'Stickerset thumbnail',
-    'object_inputStickerSetThumb_param_stickerset_type_InputStickerSet' => 'Stickerset',
+    'method_folders.deleteFolder' => 'Delete a folder',
+    'method_folders.deleteFolder_param_folder_id_type_int' => 'Folder to delete',
+    'object_inputPeerUserFromMessage' => 'Defines a [min](https://core.telegram.org/api/min) user that was seen in a certain message of a certain chat.',
+    'object_inputPeerUserFromMessage_param_peer_type_InputPeer' => 'The chat where the user was seen',
+    'object_inputPeerUserFromMessage_param_msg_id_type_int' => 'The message ID',
+    'object_inputPeerUserFromMessage_param_user_id_type_int' => 'The identifier of the user that was seen',
+    'object_inputPeerChannelFromMessage' => 'Defines a [min](https://core.telegram.org/api/min) channel that was seen in a certain message of a certain chat.',
+    'object_inputPeerChannelFromMessage_param_peer_type_InputPeer' => 'The chat where the channel\'s message was seen',
+    'object_inputPeerChannelFromMessage_param_msg_id_type_int' => 'The message ID',
+    'object_inputPeerChannelFromMessage_param_channel_id_type_int' => 'The identifier of the channel that was seen',
+    'object_inputUserFromMessage' => 'Defines a [min](https://core.telegram.org/api/min) user that was seen in a certain message of a certain chat.',
+    'object_inputUserFromMessage_param_peer_type_InputPeer' => 'The chat where the user was seen',
+    'object_inputUserFromMessage_param_msg_id_type_int' => 'The message ID',
+    'object_inputUserFromMessage_param_user_id_type_int' => 'The identifier of the user that was seen',
+    'object_inputDocumentFileLocation_param_thumb_size_type_string' => 'Thumbnail size to download the thumbnail',
+    'object_inputPhotoFileLocation' => 'Use this object to download a photo with [upload.getFile](../methods/upload.getFile.md) method',
+    'object_inputPhotoFileLocation_param_id_type_long' => 'Photo ID, obtained from the [photo](../constructors/photo.md) object',
+    'object_inputPhotoFileLocation_param_access_hash_type_long' => 'Photo\'s access hash, obtained from the [photo](../constructors/photo.md) object',
+    'object_inputPhotoFileLocation_param_file_reference_type_bytes' => '[File reference](https://core.telegram.org/api/file_reference)',
+    'object_inputPhotoFileLocation_param_thumb_size_type_string' => 'The [PhotoSize](../types/PhotoSize.md) to download: must be set to the `type` field of the desired PhotoSize object of the [photo](../constructors/photo.md)',
+    'object_inputPeerPhotoFileLocation' => 'Location of profile photo of channel/group/supergroup/user',
+    'object_inputPeerPhotoFileLocation_param_big_type_true' => 'Whether to download the high-quality version of the picture',
+    'object_inputPeerPhotoFileLocation_param_peer_type_InputPeer' => 'The peer whose profile picture should be downloaded',
+    'object_inputPeerPhotoFileLocation_param_volume_id_type_long' => 'Volume ID from [FileLocation](../types/FileLocation.md) met in the profile photo container.',
+    'object_inputPeerPhotoFileLocation_param_local_id_type_int' => 'Local ID from [FileLocation](../types/FileLocation.md) met in the profile photo container.',
+    'object_inputStickerSetThumb' => 'Location of stickerset thumbnail (see [files](https://core.telegram.org/api/files))',
+    'object_inputStickerSetThumb_param_stickerset_type_InputStickerSet' => 'Sticker set',
     'object_inputStickerSetThumb_param_volume_id_type_long' => 'Volume ID',
     'object_inputStickerSetThumb_param_local_id_type_int' => 'Local ID',
-    'object_user_param_scam_type_true' => 'Scam?',
-    'object_userProfilePhoto_param_dc_id_type_int' => 'DC ID',
-    'object_channel_param_scam_type_true' => 'Scam channel',
-    'object_channel_param_has_link_type_true' => 'Has linked chat?',
+    'object_user_param_scam_type_true' => 'This may be a scam user',
+    'object_userProfilePhoto_param_dc_id_type_int' => 'DC ID where the photo is stored',
+    'object_channel_param_scam_type_true' => 'This channel/supergroup is probably a scam',
+    'object_channel_param_has_link_type_true' => 'Whether this channel has a private join link',
     'object_chatFull_param_folder_id_type_int' => 'Folder ID',
     'object_channelFull_param_folder_id_type_int' => 'Folder ID',
-    'object_channelFull_param_linked_chat_id_type_int' => 'Linked chat ID',
-    'object_channelFull_param_pts_type_int' => 'PTS',
-    'object_chatPhoto_param_dc_id_type_int' => 'DC ID',
-    'object_message_param_legacy_type_true' => 'Legacy message',
-    'object_messageService_param_legacy_type_true' => 'Legacy message',
-    'object_messageActionPhoneCall_param_video_type_true' => 'Video call?',
+    'object_channelFull_param_linked_chat_id_type_int' => 'ID of the linked discussion chat for channels',
+    'object_channelFull_param_pts_type_int' => 'Latest [PTS](https://core.telegram.org/api/updates) for this channel',
+    'object_chatPhoto_param_dc_id_type_int' => 'DC where this photo is stored',
+    'object_message_param_legacy_type_true' => 'This is a legacy message: it has to be refetched with the new layer',
+    'object_messageService_param_legacy_type_true' => 'This is a legacy message: it has to be refetched with the new layer',
+    'object_messageActionPhoneCall_param_video_type_true' => 'Is this a video call?',
     'object_dialog_param_folder_id_type_int' => 'Folder ID',
-    'object_dialogFolder' => 'Dialog folder',
-    'object_dialogFolder_param_pinned_type_true' => 'Pinned?',
-    'object_dialogFolder_param_folder_type_Folder' => 'Folder',
-    'object_dialogFolder_param_peer_type_Peer' => 'Peer',
-    'object_dialogFolder_param_top_message_type_int' => 'Top message',
-    'object_dialogFolder_param_unread_muted_peers_count_type_int' => 'Unread muted peers count',
-    'object_dialogFolder_param_unread_unmuted_peers_count_type_int' => 'Unread unmuted peer count',
-    'object_dialogFolder_param_unread_muted_messages_count_type_int' => 'Unread muted messages count',
-    'object_dialogFolder_param_unread_unmuted_messages_count_type_int' => 'Unread unmuted messages count',
-    'object_photo_param_dc_id_type_int' => 'DC ID',
+    'object_dialogFolder' => 'Dialog in folder',
+    'object_dialogFolder_param_pinned_type_true' => 'Is this folder pinned',
+    'object_dialogFolder_param_folder_type_Folder' => 'The folder',
+    'object_dialogFolder_param_peer_type_Peer' => 'Peer in folder',
+    'object_dialogFolder_param_top_message_type_int' => 'Latest message ID of dialog',
+    'object_dialogFolder_param_unread_muted_peers_count_type_int' => 'Number of unread muted peers in folder',
+    'object_dialogFolder_param_unread_unmuted_peers_count_type_int' => 'Number of unread unmuted peers in folder',
+    'object_dialogFolder_param_unread_muted_messages_count_type_int' => 'Number of unread messages from muted peers in folder',
+    'object_dialogFolder_param_unread_unmuted_messages_count_type_int' => 'Number of unread messages from unmuted peers in folder',
+    'object_photo_param_dc_id_type_int' => 'DC ID to use for download',
     'object_userFull_param_folder_id_type_int' => 'Folder ID',
-    'object_messages.messagesSlice_param_next_rate_type_int' => 'Next rate',
+    'object_messages.messagesSlice_param_next_rate_type_int' => 'Rate to use in the `offset_rate` parameter in the next call to [messages.searchGlobal](../methods/messages.searchGlobal.md)',
     'object_updateReadHistoryInbox_param_folder_id_type_int' => 'Folder ID',
-    'object_updateReadHistoryInbox_param_still_unread_count_type_int' => 'Still unread count',
-    'object_updateReadChannelInbox_param_folder_id_type_int' => 'Folder ID',
-    'object_updateReadChannelInbox_param_still_unread_count_type_int' => 'Still unread count',
-    'object_updateReadChannelInbox_param_pts_type_int' => 'PTS',
-    'object_updateDialogPinned_param_folder_id_type_int' => 'Folder ID',
-    'object_updatePinnedDialogs_param_folder_id_type_int' => 'Folder ID',
-    'object_updateFolderPeers' => 'Folder update',
+    'object_updateReadHistoryInbox_param_still_unread_count_type_int' => 'Number of messages that are still unread',
+    'object_updateReadChannelInbox_param_folder_id_type_int' => 'ID of folder for peers in folders',
+    'object_updateReadChannelInbox_param_still_unread_count_type_int' => 'Count of messages weren\'t read yet',
+    'object_updateReadChannelInbox_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+    'object_updateDialogPinned_param_folder_id_type_int' => 'If the dialog is in a folder, the folder ID',
+    'object_updatePinnedDialogs_param_folder_id_type_int' => 'If the dialogs are in a folder, the folder ID',
+    'object_updateFolderPeers' => 'The dialog list of a folder was changed',
     'object_updateFolderPeers_param_folder_peers_type_Vector t' => 'New folder peers',
-    'object_updateFolderPeers_param_pts_type_int' => 'PTS',
-    'object_updateFolderPeers_param_pts_count_type_int' => 'PTS',
-    'object_config_param_pinned_infolder_count_max_type_int' => 'Pinned infolder count max_type',
-    'object_inputPrivacyKeyPhoneNumber' => 'Phone number',
-    'object_privacyKeyPhoneNumber' => 'Phone number',
-    'object_inputPrivacyValueAllowChatParticipants' => 'Allow chat participant?',
+    'object_updateFolderPeers_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+    'object_updateFolderPeers_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)',
+    'object_config_param_pinned_infolder_count_max_type_int' => 'Maximum count of dialogs per folder',
+    'object_inputPrivacyKeyPhoneNumber' => 'Whether people will be able to see the user\'s phone number',
+    'object_privacyKeyPhoneNumber' => 'Whether the user allows us to see his phone number',
+    'object_inputPrivacyValueAllowChatParticipants' => 'Allow only participants of certain chats',
     'object_inputPrivacyValueAllowChatParticipants_param_chats_type_Vector t' => 'Chats',
-    'object_inputPrivacyValueDisallowChatParticipants' => 'Disallowed chats',
+    'object_inputPrivacyValueDisallowChatParticipants' => 'Disallow only participants of certain chats',
     'object_inputPrivacyValueDisallowChatParticipants_param_chats_type_Vector t' => 'CHats',
-    'object_privacyValueAllowChatParticipants' => 'Allow chat participants?',
+    'object_privacyValueAllowChatParticipants' => 'Allow all participants of certain chats',
     'object_privacyValueAllowChatParticipants_param_chats_type_Vector t' => 'Allowed chats',
-    'object_privacyValueDisallowChatParticipants' => 'Diallowed chats',
+    'object_privacyValueDisallowChatParticipants' => 'Disallow only participants of certain chats',
     'object_privacyValueDisallowChatParticipants_param_chats_type_Vector t' => 'Disallowed chats',
     'object_account.privacyRules_param_chats_type_Vector t' => 'Chats allowed?',
-    'object_chatInvite_param_photo_type_Photo' => 'Photo',
-    'object_stickerSet_param_thumb_dc_id_type_int' => 'DC ID',
-    'object_keyboardButtonUrlAuth' => 'Url authorization request',
-    'object_keyboardButtonUrlAuth_param_text_type_string' => 'Text',
-    'object_keyboardButtonUrlAuth_param_fwd_text_type_string' => 'Forward text',
-    'object_keyboardButtonUrlAuth_param_url_type_string' => 'URL',
-    'object_keyboardButtonUrlAuth_param_button_id_type_int' => 'Button ID',
-    'object_inputKeyboardButtonUrlAuth' => 'Request authorization',
-    'object_inputKeyboardButtonUrlAuth_param_request_write_access_type_true' => 'Request write access?',
-    'object_inputKeyboardButtonUrlAuth_param_text_type_string' => 'Text',
-    'object_inputKeyboardButtonUrlAuth_param_fwd_text_type_string' => 'Forward text',
-    'object_inputKeyboardButtonUrlAuth_param_url_type_string' => 'URL',
-    'object_inputKeyboardButtonUrlAuth_param_bot_type_InputUser' => 'Bot',
-    'object_inputChannelFromMessage' => 'Channel from message',
-    'object_inputChannelFromMessage_param_peer_type_InputPeer' => 'Peer',
-    'object_inputChannelFromMessage_param_msg_id_type_int' => 'Message ID',
-    'object_inputChannelFromMessage_param_channel_id_type_int' => 'Channel ID',
-    'object_updates.channelDifferenceTooLong_param_dialog_type_Dialog' => 'Dialog',
-    'object_topPeerCategoryForwardUsers' => 'Top peer category: forward users',
-    'object_topPeerCategoryForwardChats' => 'Top peer category: forward chats',
-    'object_phoneCallWaiting_param_video_type_true' => 'Video call?',
-    'object_phoneCallRequested_param_video_type_true' => 'Video call?',
-    'object_phoneCallAccepted_param_video_type_true' => 'Video call?',
+    'object_chatInvite_param_photo_type_Photo' => 'Chat/supergroup/channel photo',
+    'object_stickerSet_param_thumb_dc_id_type_int' => 'DC ID of thumbnail',
+    'object_keyboardButtonUrlAuth' => 'Button to request a user to authorize via URL using [Seamless Telegram Login](https://telegram.org/blog/privacy-discussions-web-bots#meet-seamless-web-bots). When the user clicks on such a button, [messages.requestUrlAuth](../methods/messages.requestUrlAuth.md) should be called, providing the `button_id` and the ID of the container message. The returned [urlAuthResultRequest](../constructors/urlAuthResultRequest.md) object will contain more details about the authorization request (`request_write_access` if the bot would like to send messages to the user along with the username of the bot which will be used for user authorization). Finally, the user can choose to call [messages.acceptUrlAuth](../methods/messages.acceptUrlAuth.md) to get a [urlAuthResultAccepted](../constructors/urlAuthResultAccepted.md) with the URL to open instead of the `url` of this constructor, or a [urlAuthResultDefault](../constructors/urlAuthResultDefault.md), in which case the `url` of this constructor must be opened, instead. If the user refuses the authorization request but still wants to open the link, the `url` of this constructor must be used.',
+    'object_keyboardButtonUrlAuth_param_text_type_string' => 'Button label',
+    'object_keyboardButtonUrlAuth_param_fwd_text_type_string' => 'New text of the button in forwarded messages.',
+    'object_keyboardButtonUrlAuth_param_url_type_string' => 'An HTTP URL to be opened with user authorization data added to the query string when the button is pressed. If the user refuses to provide authorization data, the original URL without information about the user will be opened. The data added is the same as described in [Receiving authorization data](https://core.telegram.org/widgets/login#receiving-authorization-data).

**NOTE**: Services must **always** check the hash of the received data to verify the authentication and the integrity of the data as described in [Checking authorization](https://core.telegram.org/widgets/login#checking-authorization).',
+    'object_keyboardButtonUrlAuth_param_button_id_type_int' => 'ID of the button to pass to [messages.requestUrlAuth](../methods/messages.requestUrlAuth.md)',
+    'object_inputKeyboardButtonUrlAuth' => 'Button to request a user to [authorize](../methods/messages.acceptUrlAuth.md) via URL using [Seamless Telegram Login](https://telegram.org/blog/privacy-discussions-web-bots#meet-seamless-web-bots).',
+    'object_inputKeyboardButtonUrlAuth_param_request_write_access_type_true' => 'Set this flag to request the permission for your bot to send messages to the user.',
+    'object_inputKeyboardButtonUrlAuth_param_text_type_string' => 'Button text',
+    'object_inputKeyboardButtonUrlAuth_param_fwd_text_type_string' => 'New text of the button in forwarded messages.',
+    'object_inputKeyboardButtonUrlAuth_param_url_type_string' => 'An HTTP URL to be opened with user authorization data added to the query string when the button is pressed. If the user refuses to provide authorization data, the original URL without information about the user will be opened. The data added is the same as described in [Receiving authorization data](https://core.telegram.org/widgets/login#receiving-authorization-data).
NOTE: You must always check the hash of the received data to verify the authentication and the integrity of the data as described in [Checking authorization](https://core.telegram.org/widgets/login#checking-authorization).',
+    'object_inputKeyboardButtonUrlAuth_param_bot_type_InputUser' => 'Username of a bot, which will be used for user authorization. See [Setting up a bot](https://core.telegram.org/widgets/login#setting-up-a-bot) for more details. If not specified, the current bot\'s username will be assumed. The url\'s domain must be the same as the domain linked with the bot. See [Linking your domain to the bot](https://core.telegram.org/widgets/login#linking-your-domain-to-the-bot) for more details.',
+    'object_inputChannelFromMessage' => 'Defines a [min](https://core.telegram.org/api/min) channel that was seen in a certain message of a certain chat.',
+    'object_inputChannelFromMessage_param_peer_type_InputPeer' => 'The chat where the channel was seen',
+    'object_inputChannelFromMessage_param_msg_id_type_int' => 'The message ID in the chat where the channel was seen',
+    'object_inputChannelFromMessage_param_channel_id_type_int' => 'The channel ID',
+    'object_updates.channelDifferenceTooLong_param_dialog_type_Dialog' => 'Dialog containing the latest [PTS](https://core.telegram.org/api/updates) that can be used to reset the channel state',
+    'object_topPeerCategoryForwardUsers' => 'Users to which the users often forwards messages to',
+    'object_topPeerCategoryForwardChats' => 'Chats to which the users often forwards messages to',
+    'object_phoneCallWaiting_param_video_type_true' => 'Is this a video call',
+    'object_phoneCallRequested_param_video_type_true' => 'Whether this is a video call',
+    'object_phoneCallAccepted_param_video_type_true' => 'Whether this is a video call',
     'object_phoneCall_param_connections_type_Vector t' => 'Phone connections',
-    'object_phoneCallDiscarded_param_video_type_true' => 'Video call?',
-    'object_channelAdminLogEventActionChangePhoto_param_prev_photo_type_Photo' => 'Old photo',
-    'object_channelAdminLogEventActionChangePhoto_param_new_photo_type_Photo' => 'New photo',
-    'object_channelAdminLogEventActionChangeLinkedChat' => 'Linked chat was changed',
-    'object_channelAdminLogEventActionChangeLinkedChat_param_prev_value_type_int' => 'Old linked chat',
+    'object_phoneCallDiscarded_param_video_type_true' => 'Whether the call was a video call',
+    'object_channelAdminLogEventActionChangePhoto_param_prev_photo_type_Photo' => 'Previous picture',
+    'object_channelAdminLogEventActionChangePhoto_param_new_photo_type_Photo' => 'New picture',
+    'object_channelAdminLogEventActionChangeLinkedChat' => 'The linked chat was changed',
+    'object_channelAdminLogEventActionChangeLinkedChat_param_prev_value_type_int' => 'Previous linked chat',
     'object_channelAdminLogEventActionChangeLinkedChat_param_new_value_type_int' => 'New linked chat',
-    'object_inputDialogPeerFolder' => 'Dialog peer folder',
+    'object_inputDialogPeerFolder' => 'All peers in a folder',
     'object_inputDialogPeerFolder_param_folder_id_type_int' => 'Folder ID',
-    'object_dialogPeerFolder' => 'Dialog peer folder',
+    'object_dialogPeerFolder' => 'Folder',
     'object_dialogPeerFolder_param_folder_id_type_int' => 'Folder ID',
     'object_emojiLanguage' => 'Emoji language',
     'object_emojiLanguage_param_lang_code_type_string' => 'Language code',
-    'object_fileLocationToBeDeprecated' => 'File location (deprecated)',
+    'object_fileLocationToBeDeprecated' => 'Indicates the location of a photo, will be deprecated soon',
     'object_fileLocationToBeDeprecated_param_volume_id_type_long' => 'Volume ID',
     'object_fileLocationToBeDeprecated_param_local_id_type_int' => 'Local ID',
     'object_folder' => 'Folder',
-    'object_folder_param_autofill_new_broadcasts_type_true' => 'New broadcasts?',
-    'object_folder_param_autofill_public_groups_type_true' => 'Autofill public groups?',
-    'object_folder_param_autofill_new_correspondents_type_true' => 'New correspondents',
-    'object_folder_param_id_type_int' => 'ID',
-    'object_folder_param_title_type_string' => 'Title',
-    'object_folder_param_photo_type_ChatPhoto' => 'Photo',
-    'object_inputFolderPeer' => 'Folder peer',
+    'object_folder_param_autofill_new_broadcasts_type_true' => 'Automatically add new channels to this folder',
+    'object_folder_param_autofill_public_groups_type_true' => 'Automatically add joined new public supergroups to this folder',
+    'object_folder_param_autofill_new_correspondents_type_true' => 'Automatically add new private chats to this folder',
+    'object_folder_param_id_type_int' => 'Folder ID',
+    'object_folder_param_title_type_string' => 'Folder title',
+    'object_folder_param_photo_type_ChatPhoto' => 'Folder picture',
+    'object_inputFolderPeer' => 'Peer in a folder',
     'object_inputFolderPeer_param_peer_type_InputPeer' => 'Peer',
     'object_inputFolderPeer_param_folder_id_type_int' => 'Folder ID',
-    'object_folderPeer' => 'Peer',
-    'object_folderPeer_param_peer_type_Peer' => 'Peer',
+    'object_folderPeer' => 'Peer in a folder',
+    'object_folderPeer_param_peer_type_Peer' => 'Folder peer info',
     'object_folderPeer_param_folder_id_type_int' => 'Folder ID',
-    'object_messages.searchCounter' => 'Search counter',
-    'object_messages.searchCounter_param_inexact_type_true' => 'Inexact?',
-    'object_messages.searchCounter_param_filter_type_MessagesFilter' => 'Filter',
-    'object_messages.searchCounter_param_count_type_int' => 'Count',
-    'object_urlAuthResultRequest' => 'Request',
-    'object_urlAuthResultRequest_param_request_write_access_type_true' => 'Request write access?',
-    'object_urlAuthResultRequest_param_bot_type_User' => 'Bot',
-    'object_urlAuthResultRequest_param_domain_type_string' => 'Doamin',
-    'object_urlAuthResultAccepted' => 'URL authorization accepted',
-    'object_urlAuthResultAccepted_param_url_type_string' => 'URL',
-    'object_urlAuthResultDefault' => 'Default result',
-    'method_contacts.addContact' => 'Add contact',
-    'method_contacts.addContact_param_add_phone_privacy_exception_type_true' => 'Phone privacy exception?',
-    'method_contacts.addContact_param_id_type_InputUser' => 'ID',
+    'object_messages.searchCounter' => 'Indicates how many results would be found by a [messages.search](../methods/messages.search.md) call with the same parameters',
+    'object_messages.searchCounter_param_inexact_type_true' => 'If set, the results may be inexact',
+    'object_messages.searchCounter_param_filter_type_MessagesFilter' => 'Provided message filter',
+    'object_messages.searchCounter_param_count_type_int' => 'Number of results that were found server-side',
+    'object_urlAuthResultRequest' => 'Details about the authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization)',
+    'object_urlAuthResultRequest_param_request_write_access_type_true' => 'Whether the bot would like to send messages to the user',
+    'object_urlAuthResultRequest_param_bot_type_User' => 'Username of a bot, which will be used for user authorization. If not specified, the current bot\'s username will be assumed. The url\'s domain must be the same as the domain linked with the bot. See [Linking your domain to the bot](https://core.telegram.org/widgets/login#linking-your-domain-to-the-bot) for more details.',
+    'object_urlAuthResultRequest_param_domain_type_string' => 'The domain name of the website on which the user will log in.',
+    'object_urlAuthResultAccepted' => 'Details about an accepted authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization)',
+    'object_urlAuthResultAccepted_param_url_type_string' => 'The URL name of the website on which the user has logged in.',
+    'object_urlAuthResultDefault' => 'Details about an accepted authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization)',
+    'method_contacts.addContact' => 'Add an existing telegram user as contact',
+    'method_contacts.addContact_param_add_phone_privacy_exception_type_true' => 'Allow the other user to see our phone number?',
+    'method_contacts.addContact_param_id_type_InputUser' => 'Telegram ID of the other user',
     'method_contacts.addContact_param_first_name_type_string' => 'First name',
     'method_contacts.addContact_param_last_name_type_string' => 'Last name',
-    'method_contacts.addContact_param_phone_type_string' => 'Phone number',
-    'method_contacts.acceptContact' => 'Accept contact',
-    'method_contacts.acceptContact_param_id_type_InputUser' => 'ID',
-    'method_contacts.getLocated' => 'Get people nearby (geochats)',
-    'method_contacts.getLocated_param_geo_point_type_InputGeoPoint' => 'Current location',
-    'method_messages.searchGlobal_param_folder_id_type_int' => 'Folder ID',
-    'method_messages.hidePeerSettingsBar' => 'Hide peer settings bar',
+    'method_contacts.addContact_param_phone_type_string' => 'User\'s phone number',
+    'method_contacts.acceptContact' => 'If the [peer settings](../constructors/peerSettings.md) of a new user allow us to add him as contact, add that user as contact',
+    'method_contacts.acceptContact_param_id_type_InputUser' => 'The user to add as contact',
+    'method_contacts.getLocated' => 'Get contacts near you',
+    'method_contacts.getLocated_param_geo_point_type_InputGeoPoint' => 'Geolocation',
+    'method_messages.searchGlobal_param_folder_id_type_int' => 'Folder where to search',
+    'method_messages.hidePeerSettingsBar' => 'Should be called after the user hides the report spam/add as contact bar of a new chat, effectively prevents the user from executing the actions specified in the [peer\'s settings](../constructors/peerSettings.md).',
     'method_messages.hidePeerSettingsBar_param_peer_type_InputPeer' => 'Peer',
-    'method_channels.createChannel_param_geo_point_type_InputGeoPoint' => 'Geopoint (geochats)',
-    'method_channels.createChannel_param_address_type_string' => 'Physical address (geochats)',
-    'method_channels.getAdminedPublicChannels_param_by_location_type_true' => 'Get channels by location',
-    'method_channels.getAdminedPublicChannels_param_check_limit_type_true' => 'Check limit',
-    'method_channels.editCreator' => 'Edit creator of channel',
+    'method_channels.createChannel_param_geo_point_type_InputGeoPoint' => 'Geogroup location',
+    'method_channels.createChannel_param_address_type_string' => 'Geogroup address',
+    'method_channels.getAdminedPublicChannels_param_by_location_type_true' => 'Get geogroups',
+    'method_channels.getAdminedPublicChannels_param_check_limit_type_true' => 'If set and the user has reached the limit of owned public [channels/supergroups/geogroups](https://core.telegram.org/api/channel), instead of returning the channel list one of the specified [errors](#possible-errors) will be returned.
Useful to check if a new public channel can indeed be created, even before asking the user to enter a channel username to use in [channels.checkUsername](../methods/channels.checkUsername.md)/[channels.updateUsername](../methods/channels.updateUsername.md).',
+    'method_channels.editCreator' => 'Transfer channel ownership',
     'method_channels.editCreator_param_channel_type_InputChannel' => 'Channel',
-    'method_channels.editCreator_param_user_id_type_InputUser' => 'User ID',
-    'method_channels.editCreator_param_password_type_InputCheckPasswordSRP' => 'Password',
-    'method_channels.editLocation' => 'Edit location (geochats)',
-    'method_channels.editLocation_param_channel_type_InputChannel' => 'Channel',
-    'method_channels.editLocation_param_geo_point_type_InputGeoPoint' => 'Geo point',
-    'method_channels.editLocation_param_address_type_string' => 'Physical location (geochats)',
-    'object_channelFull_param_can_set_location_type_true' => 'Can set location?',
-    'object_channelFull_param_location_type_ChannelLocation' => 'Location',
-    'object_peerSettings_param_add_contact_type_true' => 'Can add as a contact?',
-    'object_peerSettings_param_block_contact_type_true' => 'Block contact',
-    'object_peerSettings_param_share_contact_type_true' => 'Share contact',
-    'object_peerSettings_param_need_contacts_exception_type_true' => 'Contact exception',
-    'object_peerSettings_param_report_geo_type_true' => 'Geotype',
-    'object_inputReportReasonGeoIrrelevant' => 'Irrelevant geochat',
+    'method_channels.editCreator_param_user_id_type_InputUser' => 'New channel owner',
+    'method_channels.editCreator_param_password_type_InputCheckPasswordSRP' => '[2FA password](https://core.telegram.org/api/srp) of account',
+    'method_channels.editLocation' => 'Edit location of geogroup',
+    'method_channels.editLocation_param_channel_type_InputChannel' => '[Geogroup](https://core.telegram.org/api/channel)',
+    'method_channels.editLocation_param_geo_point_type_InputGeoPoint' => 'New geolocation',
+    'method_channels.editLocation_param_address_type_string' => 'Address string',
+    'object_channelFull_param_can_set_location_type_true' => 'Can we set the geolocation of this group (for geogroups)',
+    'object_channelFull_param_location_type_ChannelLocation' => 'Location of the geogroup',
+    'object_peerSettings_param_add_contact_type_true' => 'Whether we can add the user as contact',
+    'object_peerSettings_param_block_contact_type_true' => 'Whether we can block the user',
+    'object_peerSettings_param_share_contact_type_true' => 'Whether we can share the user\'s contact',
+    'object_peerSettings_param_need_contacts_exception_type_true' => 'Whether a special exception for contacts is needed',
+    'object_peerSettings_param_report_geo_type_true' => 'Whether we can report a geogroup is irrelevant for this location',
+    'object_inputReportReasonGeoIrrelevant' => 'Report an irrelevant geogroup',
     'object_userFull_param_settings_type_PeerSettings' => 'Peer settings',
-    'object_updatePeerSettings' => 'Peer settings updated',
-    'object_updatePeerSettings_param_peer_type_Peer' => 'Peer',
-    'object_updatePeerSettings_param_settings_type_PeerSettings' => 'Settings',
-    'object_updatePeerLocated' => 'Peer location updated',
+    'object_updatePeerSettings' => 'Settings of a certain peer have changed',
+    'object_updatePeerSettings_param_peer_type_Peer' => 'The peer',
+    'object_updatePeerSettings_param_settings_type_PeerSettings' => 'Associated peer settings',
+    'object_updatePeerLocated' => 'List of peers near you was updated',
     'object_updatePeerLocated_param_peers_type_Vector t' => 'Peers',
-    'object_stickerSet_param_animated_type_true' => 'Animated stickerset?',
-    'object_messageEntityUnderline' => 'Underline',
-    'object_messageEntityUnderline_param_offset_type_int' => 'Offset',
-    'object_messageEntityUnderline_param_length_type_int' => 'Length',
-    'object_messageEntityStrike' => 'Strikethrough',
-    'object_messageEntityStrike_param_offset_type_int' => 'Offset',
-    'object_messageEntityStrike_param_length_type_int' => 'Length',
-    'object_messageEntityBlockquote' => 'Quote',
-    'object_messageEntityBlockquote_param_offset_type_int' => 'Offset',
-    'object_messageEntityBlockquote_param_length_type_int' => 'Length',
-    'object_channelAdminLogEventActionChangeLocation' => 'Channel location changed',
-    'object_channelAdminLogEventActionChangeLocation_param_prev_value_type_ChannelLocation' => 'Previous value',
-    'object_channelAdminLogEventActionChangeLocation_param_new_value_type_ChannelLocation' => 'New value',
-    'object_channelLocationEmpty' => 'No physical location (normal chat/channel)',
-    'object_channelLocation' => 'Physical location (getchats)',
-    'object_channelLocation_param_geo_point_type_GeoPoint' => 'Geo point',
-    'object_channelLocation_param_address_type_string' => 'Physical address',
-    'object_peerLocated' => 'Located peer',
+    'object_stickerSet_param_animated_type_true' => 'Is this an animated stickerpack',
+    'object_messageEntityUnderline' => 'Message entity representing underlined text.',
+    'object_messageEntityUnderline_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+    'object_messageEntityUnderline_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+    'object_messageEntityStrike' => 'Message entity representing strikethrough text.',
+    'object_messageEntityStrike_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+    'object_messageEntityStrike_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+    'object_messageEntityBlockquote' => 'Message entity representing a block quote.',
+    'object_messageEntityBlockquote_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+    'object_messageEntityBlockquote_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+    'object_channelAdminLogEventActionChangeLocation' => 'The geogroup location was changed',
+    'object_channelAdminLogEventActionChangeLocation_param_prev_value_type_ChannelLocation' => 'Previous location',
+    'object_channelAdminLogEventActionChangeLocation_param_new_value_type_ChannelLocation' => 'New location',
+    'object_channelLocationEmpty' => 'No location (normal supergroup)',
+    'object_channelLocation' => 'Geographical location of supergroup (geogroups)',
+    'object_channelLocation_param_geo_point_type_GeoPoint' => 'Geographical location of supergrup',
+    'object_channelLocation_param_address_type_string' => 'Textual description of the address',
+    'object_peerLocated' => 'Peer geolocated nearby',
     'object_peerLocated_param_peer_type_Peer' => 'Peer',
-    'object_peerLocated_param_expires_type_int' => 'Expiry date',
-    'object_peerLocated_param_distance_type_int' => 'Distance',
-    'method_account.registerDevice_param_no_muted_type_true' => 'Idk yet',
-    'method_upload.getFile_param_precise_type_true' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-    'method_channels.editAdmin_param_rank_type_string' => 'Admin rank, an arbitrary string',
-    'method_channels.toggleSlowMode' => 'Toggle slow mode',
-    'method_channels.toggleSlowMode_param_channel_type_InputChannel' => 'Supergroup',
-    'method_channels.toggleSlowMode_param_seconds_type_int' => 'Users will only be able to send one message every `seconds` seconds, `0` to disable the limitation ',
-    'object_channel_param_has_geo_type_true' => 'Whether this is a geogroup',
-    'object_channel_param_slowmode_enabled_type_true' => 'Whether slowmode is enabled',
+    'object_peerLocated_param_expires_type_int' => 'Validity period of current data',
+    'object_peerLocated_param_distance_type_int' => 'Distance from the peer in meters',
+    'method_account.registerDevice_param_no_muted_type_true' => 'Avoid receiving (silent and invisible background) notifications. Useful to save battery.',
+    'method_upload.getFile_param_precise_type_true' => 'Disable some checks on limit and offset values, useful for example to stream videos by keyframes',
+    'method_channels.editAdmin_param_rank_type_string' => 'Indicates the role (rank) of the admin in the group: just an arbitrary string',
+    'method_channels.toggleSlowMode' => 'Toggle supergroup slow mode: if enabled, users will only be able to send one message every `seconds` seconds',
+    'method_channels.toggleSlowMode_param_channel_type_InputChannel' => 'The [supergroup](https://core.telegram.org/api/channel)',
+    'method_channels.toggleSlowMode_param_seconds_type_int' => 'Users will only be able to send one message every `seconds` seconds, `0` to disable the limitation',
+    'object_channel_param_has_geo_type_true' => 'Whether this chanel has a geoposition',
+    'object_channel_param_slowmode_enabled_type_true' => 'Whether slow mode is enabled for groups to prevent flood in chat',
     'object_channelFull_param_slowmode_seconds_type_int' => 'If specified, users in supergroups will only be able to send one message every `slowmode_seconds` seconds',
-    'object_auth.authorizationSignUpRequired' => 'Signup is required',
-    'object_auth.authorizationSignUpRequired_param_terms_of_service_type_help.TermsOfService' => 'Telegram\'s Terms of Service',
-    'object_help.appUpdate_param_can_not_skip_type_true' => 'Whether the update is skippable',
+    'object_auth.authorizationSignUpRequired' => 'An account with this phone number doesn\'t exist on telegram: the user has to [enter basic information and sign up](https://core.telegram.org/api/auth)',
+    'object_auth.authorizationSignUpRequired_param_terms_of_service_type_help.TermsOfService' => 'Telegram\'s terms of service: the user must read and accept the terms of service before signing up to telegram',
+    'object_help.appUpdate_param_can_not_skip_type_true' => 'Unskippable, the new info must be shown to the user (with a popup or something else)',
     'object_inputStickerSetAnimatedEmoji' => 'Animated emojis stickerset',
-    'object_channelParticipantCreator_param_rank_type_string' => 'Creator rank, an arbitrary string',
-    'object_channelParticipantAdmin_param_rank_type_string' => 'Admin\'s rank, an arbitrary string',
-    'object_payments.paymentVerificationNeeded' => 'Payment verification needed',
-    'object_payments.paymentVerificationNeeded_param_url_type_string' => '3dsecure URL',
-    'object_channelAdminLogEventActionToggleSlowMode' => 'Channel admin log event action toggle slow mode',
-    'object_channelAdminLogEventActionToggleSlowMode_param_prev_value_type_int' => 'Prev value',
-    'object_channelAdminLogEventActionToggleSlowMode_param_new_value_type_int' => 'New value',
-    'object_codeSettings_param_allow_app_hash_type_true' => 'Whether to allow a persistent app hash',
-    'object_channelFull_param_slowmode_next_send_date_type_int' => ' Indicates when the user will be allowed to send another message in the supergroup (unixdate)',
+    'object_channelParticipantCreator_param_rank_type_string' => 'The role (rank) of the group creator in the group: just an arbitrary string, `admin` by default',
+    'object_channelParticipantAdmin_param_rank_type_string' => 'The role (rank) of the admin in the group: just an arbitrary string, `admin` by default',
+    'object_payments.paymentVerificationNeeded' => 'Payment was not successful, additional verification is needed',
+    'object_payments.paymentVerificationNeeded_param_url_type_string' => 'URL for additional payment credentials verification',
+    'object_channelAdminLogEventActionToggleSlowMode' => '[Slow mode setting for supergroups was changed](../methods/channels.toggleSlowMode.md)',
+    'object_channelAdminLogEventActionToggleSlowMode_param_prev_value_type_int' => 'Previous slow mode value',
+    'object_channelAdminLogEventActionToggleSlowMode_param_new_value_type_int' => 'New slow mode value',
+    'object_codeSettings_param_allow_app_hash_type_true' => 'If a token that will be included in eventually sent SMSs is required: required in newer versions of android, to use the [android SMS receiver APIs](https://developers.google.com/identity/sms-retriever/overview)',
+    'object_channelFull_param_slowmode_next_send_date_type_int' => 'Indicates when the user will be allowed to send another message in the supergroup (unixdate)',
     'method_account.uploadTheme' => 'Upload theme',
-    'method_account.uploadTheme_param_file_type_InputFile' => 'File',
-    'method_account.uploadTheme_param_thumb_type_InputFile' => 'Thumb',
+    'method_account.uploadTheme_param_file_type_InputFile' => 'Theme file uploaded as described in [files »](https://core.telegram.org/api/files)',
+    'method_account.uploadTheme_param_thumb_type_InputFile' => 'Thumbnail',
     'method_account.uploadTheme_param_file_name_type_string' => 'File name',
-    'method_account.uploadTheme_param_mime_type_type_string' => 'Mime type',
+    'method_account.uploadTheme_param_mime_type_type_string' => 'MIME type, must be `application/x-tgtheme-{format}`, where `format` depends on the client',
     'method_account.createTheme' => 'Create a theme',
     'method_account.createTheme_param_slug_type_string' => 'Unique theme ID',
     'method_account.createTheme_param_title_type_string' => 'Theme name',
@@ -5166,8 +5193,8 @@ class Lang
     'method_account.updateTheme_param_document_type_InputDocument' => 'Theme file',
     'method_account.saveTheme_param_theme_type_InputTheme' => 'Theme to save',
     'method_account.saveTheme_param_unsave_type_Bool' => 'Unsave',
-    'method_account.installTheme' => 'Install theme',
-    'method_account.installTheme_param_format_type_string' => 'Format',
+    'method_account.installTheme' => 'Install a theme',
+    'method_account.installTheme_param_format_type_string' => 'Theme format, a string that identifies the theming engines supported by the client',
     'method_account.installTheme_param_theme_type_InputTheme' => 'Theme to install',
     'method_account.getTheme' => 'Get theme information',
     'method_account.getTheme_param_format_type_string' => 'Theme format, a string that identifies the theming engines supported by the client',
@@ -5175,19 +5202,19 @@ class Lang
     'method_account.getTheme_param_document_id_type_long' => 'Document ID',
     'method_account.getThemes_param_format_type_string' => 'Theme format, a string that identifies the theming engines supported by the client',
     'method_account.getThemes_param_hash_type_Vector t' => 'Hash for pagination',
-    'method_messages.sendMessage_param_schedule_date_type_int' => 'Schedule date',
-    'method_messages.sendMedia_param_schedule_date_type_int' => 'Schedule date',
-    'method_messages.forwardMessages_param_schedule_date_type_int' => 'Schedule date',
-    'method_messages.sendInlineBotResult_param_schedule_date_type_int' => 'Schedule date',
-    'method_messages.editMessage_param_schedule_date_type_int' => 'Schedule date',
-    'method_messages.sendMultiMedia_param_schedule_date_type_int' => 'Schedule date',
-    'method_messages.getScheduledHistory' => 'Get scheduled history',
+    'method_messages.sendMessage_param_schedule_date_type_int' => 'Scheduled message date for scheduled messages',
+    'method_messages.sendMedia_param_schedule_date_type_int' => 'Scheduled message date for scheduled messages',
+    'method_messages.forwardMessages_param_schedule_date_type_int' => 'Scheduled message date for scheduled messages',
+    'method_messages.sendInlineBotResult_param_schedule_date_type_int' => 'Scheduled message date for scheduled messages',
+    'method_messages.editMessage_param_schedule_date_type_int' => 'Scheduled message date for scheduled messages',
+    'method_messages.sendMultiMedia_param_schedule_date_type_int' => 'Scheduled message date for scheduled messages',
+    'method_messages.getScheduledHistory' => 'Get scheduled messages',
     'method_messages.getScheduledHistory_param_peer_type_InputPeer' => 'Peer',
     'method_messages.getScheduledHistory_param_hash_type_Vector t' => 'Hash',
     'method_messages.getScheduledMessages' => 'Get scheduled messages',
     'method_messages.getScheduledMessages_param_peer_type_InputPeer' => 'Peer',
     'method_messages.getScheduledMessages_param_id_type_Vector t' => 'ID',
-    'method_messages.sendScheduledMessages' => 'Send scheduled messages',
+    'method_messages.sendScheduledMessages' => 'Send scheduled messages right away',
     'method_messages.sendScheduledMessages_param_peer_type_InputPeer' => 'Peer',
     'method_messages.sendScheduledMessages_param_id_type_Vector t' => 'ID',
     'method_messages.deleteScheduledMessages' => 'Delete scheduled messages',
@@ -5195,54 +5222,408 @@ class Lang
     'method_messages.deleteScheduledMessages_param_id_type_Vector t' => 'ID',
     'object_user_param_restriction_reason_type_Vector t' => 'Restriction reason',
     'object_channel_param_restriction_reason_type_Vector t' => 'Restriction reason',
-    'object_chatFull_param_has_scheduled_type_true' => 'Has scheduled messages?',
-    'object_channelFull_param_has_scheduled_type_true' => 'Has scheduled messages?',
-    'object_message_param_edit_hide_type_true' => 'Whether to hide that the message was edited?',
+    'object_chatFull_param_has_scheduled_type_true' => 'Whether scheduled messages are available',
+    'object_channelFull_param_has_scheduled_type_true' => 'Whether scheduled messages are available',
+    'object_message_param_edit_hide_type_true' => 'Whether the message should be shown as not modified to the user, even if an edit date is present',
     'object_message_param_restriction_reason_type_Vector t' => 'Restriction reason',
-    'object_userFull_param_has_scheduled_type_true' => 'Has scheduled messages?',
-    'object_updateNewScheduledMessage' => 'Update new scheduled message',
+    'object_userFull_param_has_scheduled_type_true' => 'Whether scheduled messages are available',
+    'object_updateNewScheduledMessage' => 'New incoming scheduled message',
     'object_updateNewScheduledMessage_param_message_type_Message' => 'Message',
-    'object_updateDeleteScheduledMessages' => 'Update delete scheduled messages',
+    'object_updateDeleteScheduledMessages' => 'Some scheduled messages were deleted',
     'object_updateDeleteScheduledMessages_param_peer_type_Peer' => 'Peer',
     'object_updateDeleteScheduledMessages_param_messages_type_Vector t' => 'Messages',
-    'object_updateTheme' => 'Update theme',
+    'object_updateTheme' => 'A cloud theme was updated',
     'object_updateTheme_param_theme_type_Theme' => 'Theme',
-    'object_inputPrivacyKeyAddedByPhone' => 'Input privacy key added by phone',
-    'object_privacyKeyAddedByPhone' => 'Privacy key added by phone',
+    'object_inputPrivacyKeyAddedByPhone' => 'Whether people can add you to their contact list by your phone number',
+    'object_privacyKeyAddedByPhone' => 'Whether people can add you to their contact list by your phone number',
     'object_webPage_param_documents_type_Vector t' => 'Documents',
-    'object_restrictionReason' => 'Restriction reason',
-    'object_restrictionReason_param_platform_type_string' => 'Platform',
-    'object_restrictionReason_param_reason_type_string' => 'Reason',
-    'object_restrictionReason_param_text_type_string' => 'Text',
-    'object_inputTheme' => 'Input theme',
+    'object_restrictionReason' => 'Restriction reason.
+
+Contains the reason why access to a certain object must be restricted. Clients are supposed to deny access to the channel if the `platform` field is equal to `all` or to the current platform (`ios`, `android`, `wp`, etc.). Platforms can be concatenated (`ios-android`, `ios-wp`), unknown platforms are to be ignored. The `text` is the error message that should be shown to the user.',
+    'object_restrictionReason_param_platform_type_string' => 'Platform identifier (ios, android, wp, all, etc.), can be concatenated with a dash as separator (`android-ios`, `ios-wp`, etc)',
+    'object_restrictionReason_param_reason_type_string' => 'Restriction reason (`porno`, `terms`, etc.)',
+    'object_restrictionReason_param_text_type_string' => 'Error message to be shown to the user',
+    'object_inputTheme' => 'Theme',
     'object_inputTheme_param_id_type_long' => 'ID',
     'object_inputTheme_param_access_hash_type_long' => 'Access hash',
-    'object_inputThemeSlug' => 'Input theme slug',
-    'object_inputThemeSlug_param_slug_type_string' => 'Slug',
-    'object_themeDocumentNotModified' => 'Theme document not modified',
+    'object_inputThemeSlug' => 'Theme by theme ID',
+    'object_inputThemeSlug_param_slug_type_string' => 'Unique theme ID',
+    'object_themeDocumentNotModified' => 'Theme background hasn\'t changed',
     'object_theme' => 'Theme',
-    'object_theme_param_creator_type_true' => 'Creator?',
-    'object_theme_param_default_type_true' => 'Default?',
-    'object_theme_param_id_type_long' => 'ID',
-    'object_theme_param_access_hash_type_long' => 'Access hash',
-    'object_theme_param_slug_type_string' => 'Slug',
-    'object_theme_param_title_type_string' => 'Title',
-    'object_theme_param_document_type_Document' => 'Document',
-    'object_theme_param_installs_count_type_int' => 'Installs count',
-    'object_account.themesNotModified' => 'Themes not modified',
-    'object_account.themes' => 'Themes',
-    'object_account.themes_param_hash_type_int' => 'Hash',
+    'object_theme_param_creator_type_true' => 'Whether the current user is the creator of this theme',
+    'object_theme_param_default_type_true' => 'Whether this is the default theme',
+    'object_theme_param_id_type_long' => 'Theme ID',
+    'object_theme_param_access_hash_type_long' => 'Theme access hash',
+    'object_theme_param_slug_type_string' => 'Unique theme ID',
+    'object_theme_param_title_type_string' => 'Theme name',
+    'object_theme_param_document_type_Document' => 'Theme',
+    'object_theme_param_installs_count_type_int' => 'Installation count',
+    'object_account.themesNotModified' => 'No new themes were installed',
+    'object_account.themes' => 'Installed themes',
+    'object_account.themes_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
     'object_account.themes_param_themes_type_Vector t' => 'Themes',
     'method_account.installTheme_param_dark_type_true' => 'Whether to install the dark version',
     'method_account.getThemes' => 'Get installed themes',
-    'method_account.saveTheme' => 'Save theme',
-    'object_inputBotInlineResult_param_send_message_type_InputBotInlineMessage' => '',
-    'object_inputBotInlineResultPhoto_param_send_message_type_InputBotInlineMessage' => '',
-    'object_inputBotInlineResultDocument_param_send_message_type_InputBotInlineMessage' => '',
-    'object_inputBotInlineResultGame_param_send_message_type_InputBotInlineMessage' => '',
-    'object_botInlineResult_param_send_message_type_BotInlineMessage' => '',
-    'object_botInlineMediaResult_param_send_message_type_BotInlineMessage' => '',
-    'object_chatBannedRights_param_send_messages_type_true' => '',
+    'method_account.saveTheme' => 'Save a theme',
+    'object_inputBotInlineResult_param_send_message_type_InputBotInlineMessage' => 'Message to send when the result is selected',
+    'object_inputBotInlineResultPhoto_param_send_message_type_InputBotInlineMessage' => 'Message to send when the result is selected',
+    'object_inputBotInlineResultDocument_param_send_message_type_InputBotInlineMessage' => 'Message to send when the result is selected',
+    'object_inputBotInlineResultGame_param_send_message_type_InputBotInlineMessage' => 'Message to send when the result is selected',
+    'object_botInlineResult_param_send_message_type_BotInlineMessage' => 'Message to send',
+    'object_botInlineMediaResult_param_send_message_type_BotInlineMessage' => 'Depending on the `type` and on the [constructor](../types/BotInlineMessage.md), contains the caption of the media or the content of the message to be sent **instead** of the media',
+    'object_chatBannedRights_param_send_messages_type_true' => 'If set, does not allow a user to send messages in a [supergroup/chat](https://core.telegram.org/api/channel)',
+    'object_updateStickerSetsOrder_param_order_type_Vector long' => 'New sticker order by sticker ID',
+    'object_pageBlockList_param_items_type_Vector PageListItem' => 'List of blocks in an IV page',
+    'object_topPeerCategoryPeers_param_peers_type_Vector TopPeer' => 'Peers',
+    'object_stickerPack_param_documents_type_Vector long' => 'Stickers',
+    'object_updateDeleteChannelMessages_param_messages_type_Vector int' => 'IDs of messages that were deleted',
+    'object_photos.photos_param_photos_type_Vector Photo' => 'List of photos',
+    'object_photos.photos_param_users_type_Vector User' => 'List of mentioned users',
+    'object_updatePeerLocated_param_peers_type_Vector PeerLocated' => 'Geolocated peer list update',
+    'object_messages.savedGifs_param_gifs_type_Vector Document' => 'List of saved gifs',
+    'object_pageBlockRelatedArticles_param_articles_type_Vector PageRelatedArticle' => 'Related articles',
+    'object_inputSingleMedia_param_random_id_type_long' => 'Unique client media ID required to prevent message resending',
+    'object_inputSingleMedia_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for styled text',
+    'object_updatePinnedDialogs_param_order_type_Vector DialogPeer' => 'New order of pinned dialogs',
+    'object_messages.chatsSlice_param_chats_type_Vector Chat' => 'Chats',
+    'object_messages.stickerSetInstallResultArchive_param_sets_type_Vector StickerSetCovered' => 'Archived stickersets',
+    'object_upload.fileCdnRedirect_param_file_hashes_type_Vector FileHash' => 'File hashes (see [CDN files](https://core.telegram.org/cdn)',
+    'object_help.deepLinkInfo_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+    'object_inputPrivacyValueDisallowChatParticipants_param_chats_type_Vector int' => 'Disallowed chat IDs',
+    'object_updateServiceNotification_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+    'object_pageListOrderedItemBlocks_param_blocks_type_Vector PageBlock' => 'Item contents',
+    'object_channels.adminLogResults_param_events_type_Vector ChannelAdminLogEvent' => 'Admin log events',
+    'object_channels.adminLogResults_param_chats_type_Vector Chat' => 'Chats mentioned in events',
+    'object_channels.adminLogResults_param_users_type_Vector User' => 'Users mentioned in events',
+    'object_messages.channelMessages_param_messages_type_Vector Message' => 'Found messages',
+    'object_messages.channelMessages_param_chats_type_Vector Chat' => 'Chats',
+    'object_messages.channelMessages_param_users_type_Vector User' => 'Users',
+    'object_message_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for styled text',
+    'object_message_param_restriction_reason_type_Vector RestrictionReason' => 'Contains the reason why access to this message must be restricted.',
+    'object_messages.favedStickers_param_packs_type_Vector StickerPack' => 'Emojis associated to stickers',
+    'object_messages.favedStickers_param_stickers_type_Vector Document' => 'Favorited stickers',
+    'object_messages.foundStickerSets_param_sets_type_Vector StickerSetCovered' => 'Found stickersets',
+    'object_account.authorizationForm_param_required_types_type_Vector SecureRequiredType' => 'Required [Telegram Passport](https://core.telegram.org/passport) documents',
+    'object_account.authorizationForm_param_values_type_Vector SecureValue' => 'Already submitted [Telegram Passport](https://core.telegram.org/passport) documents',
+    'object_account.authorizationForm_param_errors_type_Vector SecureValueError' => '[Telegram Passport](https://core.telegram.org/passport) errors',
+    'object_account.authorizationForm_param_users_type_Vector User' => 'Info about the bot to which the form will be submitted',
+    'object_messageActionChatAddUser_param_users_type_Vector int' => 'Users that were invited to the chat',
+    'object_shippingOption_param_prices_type_Vector LabeledPrice' => 'List of price portions',
+    'object_inputBotInlineMessageMediaAuto_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+    'object_photos.photosSlice_param_photos_type_Vector Photo' => 'List of photos',
+    'object_photos.photosSlice_param_users_type_Vector User' => 'List of mentioned users',
+    'object_pageBlockCollage_param_items_type_Vector PageBlock' => 'Media elements',
+    'object_updatesCombined_param_updates_type_Vector Update' => 'List of updates',
+    'object_updatesCombined_param_users_type_Vector User' => 'List of users mentioned in updates',
+    'object_updatesCombined_param_chats_type_Vector Chat' => 'List of chats mentioned in updates',
+    'object_pageBlockOrderedList_param_items_type_Vector PageListOrderedItem' => 'List items',
+    'object_privacyValueAllowChatParticipants_param_chats_type_Vector int' => 'Allowed chats',
+    'object_emojiKeyword_param_emoticons_type_Vector string' => 'Emojis associated to keyword',
+    'object_botInlineMessageMediaAuto_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+    'object_messageReactions' => 'Message reactions',
+    'object_messageReactions_param_min_type_true' => 'Similar to [min](https://core.telegram.org/api/min) objects, used for message reaction constructors that are the same for all users so they don\'t have the reactions sent by the current user (you can use [messages.getMessagesReactions](../methods/messages.getMessagesReactions.md) to get the full reaction info).',
+    'object_messageReactions_param_results_type_Vector ReactionCount' => 'Reactions',
+    'object_decryptedMessageMediaDocument_param_attributes_type_Vector DocumentAttribute' => 'Document attributes for media types',
+    'object_messageActionSecureValuesSent_param_types_type_Vector SecureValueType' => 'Secure value types',
+    'object_pollResults_param_results_type_Vector PollAnswerVoters' => 'Poll results',
+    'object_messages.stickers_param_stickers_type_Vector Document' => 'Stickers',
+    'object_photo_param_sizes_type_Vector PhotoSize' => 'Available sizes for download',
+    'object_inputPrivacyValueAllowChatParticipants_param_chats_type_Vector int' => 'Allowed chat IDs',
+    'object_contacts.found_param_my_results_type_Vector Peer' => 'Personalized results',
+    'object_contacts.found_param_results_type_Vector Peer' => 'List of found user identifiers',
+    'object_contacts.found_param_chats_type_Vector Chat' => 'Found chats',
+    'object_contacts.found_param_users_type_Vector User' => 'List of users',
+    'object_chatInvite_param_participants_type_Vector User' => 'A few of the participants that are in the group',
+    'object_messages.dialogs_param_dialogs_type_Vector Dialog' => 'List of chats',
+    'object_messages.dialogs_param_messages_type_Vector Message' => 'List of last messages from each chat',
+    'object_messages.dialogs_param_chats_type_Vector Chat' => 'List of groups mentioned in the chats',
+    'object_messages.dialogs_param_users_type_Vector User' => 'List of users mentioned in messages and groups',
+    'object_textConcat_param_texts_type_Vector RichText' => 'Concatenated rich texts',
+    'object_messages.allStickers_param_sets_type_Vector StickerSet' => 'All stickersets',
+    'object_phone.phoneCall_param_users_type_Vector User' => 'VoIP phone call participants',
+    'object_updatePrivacy_param_rules_type_Vector PrivacyRule' => 'New privacy rules',
+    'object_channelMessagesFilter_param_ranges_type_Vector MessageRange' => 'A range of messages to fetch',
+    'object_updateShortMessage_param_entities_type_Vector MessageEntity' => '[Entities](https://core.telegram.org/api/entities) for styled text',
+    'object_pageListItemBlocks_param_blocks_type_Vector PageBlock' => 'Blocks',
+    'object_inputWebDocument_param_attributes_type_Vector DocumentAttribute' => 'Attributes for media types',
+    'object_inputMediaUploadedPhoto_param_stickers_type_Vector InputDocument' => 'Attached mask stickers',
+    'object_contacts.topPeers_param_categories_type_Vector TopPeerCategoryPeers' => 'Top peers by top peer category',
+    'object_contacts.topPeers_param_chats_type_Vector Chat' => 'Chats',
+    'object_contacts.topPeers_param_users_type_Vector User' => 'Users',
+    'object_user_param_restriction_reason_type_Vector RestrictionReason' => 'Contains the reason why access to this user must be restricted.',
+    'object_messages.botResults_param_results_type_Vector BotInlineResult' => 'The results',
+    'object_messages.botResults_param_users_type_Vector User' => 'Users mentioned in the results',
+    'object_pageBlockDetails_param_blocks_type_Vector PageBlock' => 'Block contents',
+    'object_inputPrivacyValueAllowUsers_param_users_type_Vector InputUser' => 'Allowed users',
+    'object_messages.chatFull_param_chats_type_Vector Chat' => 'List containing basic info on chat',
+    'object_messages.chatFull_param_users_type_Vector User' => 'List of users mentioned above',
+    'object_privacyValueDisallowChatParticipants_param_chats_type_Vector int' => 'Disallowed chats',
+    'object_replyInlineMarkup_param_rows_type_Vector KeyboardButtonRow' => 'Bot or inline keyboard rows',
+    'object_updates.differenceSlice_param_new_messages_type_Vector Message' => 'List of new messgaes',
+    'object_updates.differenceSlice_param_new_encrypted_messages_type_Vector EncryptedMessage' => 'New messages from the [encrypted event sequence](https://core.telegram.org/api/updates)',
+    'object_updates.differenceSlice_param_other_updates_type_Vector Update' => 'List of updates',
+    'object_updates.differenceSlice_param_chats_type_Vector Chat' => 'List of chats mentioned in events',
+    'object_updates.differenceSlice_param_users_type_Vector User' => 'List of users mentioned in events',
+    'object_channelFull_param_bot_info_type_Vector BotInfo' => 'Info about bots in the channel/supergrup',
+    'object_messages.foundGifs_param_results_type_Vector FoundGif' => 'Found GIFs',
+    'object_messageUserReaction' => 'Message reaction',
+    'object_messageUserReaction_param_user_id_type_int' => 'ID of user that reacted this way',
+    'object_messageUserReaction_param_reaction_type_string' => 'Reaction (UTF8 emoji)',
+    'object_updates.channelDifference_param_new_messages_type_Vector Message' => 'New messages',
+    'object_updates.channelDifference_param_other_updates_type_Vector Update' => 'Other updates',
+    'object_updates.channelDifference_param_chats_type_Vector Chat' => 'Chats',
+    'object_updates.channelDifference_param_users_type_Vector User' => 'Users',
+    'object_decryptedMessageActionDeleteMessages_param_random_ids_type_Vector long' => 'List of deleted message IDs',
+    'object_jsonObject_param_value_type_Vector JSONObjectValue' => 'Values',
+    'object_photos.photo_param_users_type_Vector User' => 'Users',
+    'object_account.webAuthorizations_param_authorizations_type_Vector WebAuthorization' => 'Web authorization list',
+    'object_account.webAuthorizations_param_users_type_Vector User' => 'Users',
+    'object_account.wallPapers_param_wallpapers_type_Vector WallPaper' => 'Wallpapers',
+    'object_inputBotInlineMessageText_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+    'object_invoice_param_prices_type_Vector LabeledPrice' => 'Price breakdown, a list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.)',
+    'object_replyKeyboardMarkup_param_rows_type_Vector KeyboardButtonRow' => 'Button row',
+    'object_payments.paymentForm_param_users_type_Vector User' => 'Users',
+    'object_contacts.resolvedPeer_param_chats_type_Vector Chat' => 'Chats',
+    'object_contacts.resolvedPeer_param_users_type_Vector User' => 'Users',
+    'object_config_param_dc_options_type_Vector DcOption' => 'DC IP list',
+    'object_contacts.importedContacts_param_imported_type_Vector ImportedContact' => 'List of succesfully imported contacts',
+    'object_contacts.importedContacts_param_popular_invites_type_Vector PopularContact' => 'Popular contacts',
+    'object_contacts.importedContacts_param_retry_contacts_type_Vector long' => 'List of contact ids that could not be imported due to system limitation and will need to be imported at a later date.
Parameter added in [Layer 13](https://core.telegram.org/api/layers#layer-13)',
+    'object_contacts.importedContacts_param_users_type_Vector User' => 'List of users',
+    'object_inputMediaUploadedDocument_param_attributes_type_Vector DocumentAttribute' => 'Attributes that specify the type of the document (video, audio, voice, sticker, etc.)',
+    'object_inputMediaUploadedDocument_param_stickers_type_Vector InputDocument' => 'Attached stickers',
+    'object_messages.stickerSet_param_packs_type_Vector StickerPack' => 'Emoji info for stickers',
+    'object_messages.stickerSet_param_documents_type_Vector Document' => 'Stickers in stickerset',
+    'object_contacts.contacts_param_contacts_type_Vector Contact' => 'Contact list',
+    'object_contacts.contacts_param_users_type_Vector User' => 'User list',
+    'object_pageBlockTable_param_rows_type_Vector PageTableRow' => 'Table rows',
+    'object_account.themes_param_themes_type_Vector Theme' => 'Themes',
+    'object_help.proxyDataPromo_param_chats_type_Vector Chat' => 'Chats',
+    'object_help.proxyDataPromo_param_users_type_Vector User' => 'Users',
+    'object_messages.peerDialogs_param_dialogs_type_Vector Dialog' => 'Dialog info',
+    'object_messages.peerDialogs_param_messages_type_Vector Message' => 'Messages mentioned in dialog info',
+    'object_messages.peerDialogs_param_chats_type_Vector Chat' => 'Chats',
+    'object_messages.peerDialogs_param_users_type_Vector User' => 'Users',
+    'object_updates.channelDifferenceTooLong_param_messages_type_Vector Message' => 'The latest messages',
+    'object_updates.channelDifferenceTooLong_param_chats_type_Vector Chat' => 'Chats from messages',
+    'object_updates.channelDifferenceTooLong_param_users_type_Vector User' => 'Users from messages',
+    'object_messages.recentStickers_param_packs_type_Vector StickerPack' => 'Emojis associated to stickers',
+    'object_messages.recentStickers_param_stickers_type_Vector Document' => 'Recent stickers',
+    'object_messages.recentStickers_param_dates_type_Vector int' => 'When was each sticker last used',
+    'object_inputPhotoLegacyFileLocation' => 'Legacy file location',
+    'object_inputPhotoLegacyFileLocation_param_id_type_long' => 'Photo ID',
+    'object_inputPhotoLegacyFileLocation_param_access_hash_type_long' => 'Access hash',
+    'object_inputPhotoLegacyFileLocation_param_file_reference_type_bytes' => 'File reference',
+    'object_inputPhotoLegacyFileLocation_param_volume_id_type_long' => 'Volume ID',
+    'object_inputPhotoLegacyFileLocation_param_local_id_type_int' => 'Local ID',
+    'object_inputPhotoLegacyFileLocation_param_secret_type_long' => 'Secret',
+    'object_draftMessage_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for styled text.',
+    'object_help.termsOfService_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+    'object_contacts.blocked_param_blocked_type_Vector ContactBlocked' => 'List of blocked users',
+    'object_contacts.blocked_param_users_type_Vector User' => 'List of users',
+    'object_pageBlockSlideshow_param_items_type_Vector PageBlock' => 'Slideshow items',
+    'object_keyboardButtonRow_param_buttons_type_Vector KeyboardButton' => 'Bot or inline keyboard buttons',
+    'object_updateFolderPeers_param_folder_peers_type_Vector FolderPeer' => 'New peer list',
+    'object_channels.channelParticipants_param_participants_type_Vector ChannelParticipant' => 'Participants',
+    'object_channels.channelParticipants_param_users_type_Vector User' => 'Users mentioned in participant info',
+    'object_emojiKeywordsDifference_param_keywords_type_Vector EmojiKeyword' => 'Emojis associated to keywords',
+    'object_page_param_blocks_type_Vector PageBlock' => 'Page elements (like with HTML elements, only as TL constructors)',
+    'object_page_param_photos_type_Vector Photo' => 'Photos in page',
+    'object_page_param_documents_type_Vector Document' => 'Media in page',
+    'object_webDocumentNoProxy_param_attributes_type_Vector DocumentAttribute' => 'Attributes for media types',
+    'object_messageActionSecureValuesSentMe_param_values_type_Vector SecureValue' => 'Vector with information about documents and other Telegram Passport elements that were shared with the bot',
+    'object_reactionCount' => 'Reactions',
+    'object_reactionCount_param_chosen_type_true' => 'Whether the current user sent this reaction',
+    'object_reactionCount_param_reaction_type_string' => 'Reaction (a UTF8 emoji)',
+    'object_reactionCount_param_count_type_int' => 'NUmber of users that reacted with this emoji',
+    'object_emojiKeywordDeleted_param_emoticons_type_Vector string' => 'Emojis that were associated to keyword',
+    'object_decryptedMessageService_param_random_id_type_long' => 'Random message ID, assigned by the message author.
Must be equal to the ID passed to the sending method.',
+    'object_messages.highScores_param_scores_type_Vector HighScore' => 'Highscores',
+    'object_messages.highScores_param_users_type_Vector User' => 'Users, associated to the highscores',
+    'object_stickerSetMultiCovered_param_covers_type_Vector Document' => 'Preview stickers',
+    'object_inputSecureValue_param_translation_type_Vector InputSecureFile' => 'Array of encrypted [passport](https://core.telegram.org/passport) files with translated versions of the provided documents',
+    'object_inputSecureValue_param_files_type_Vector InputSecureFile' => 'Array of encrypted [passport](https://core.telegram.org/passport) files with photos the of the documents',
+    'object_updates_param_updates_type_Vector Update' => 'List of updates',
+    'object_updates_param_users_type_Vector User' => 'List of users mentioned in updates',
+    'object_updates_param_chats_type_Vector Chat' => 'List of chats mentioned in updates',
+    'object_updateReadMessagesContents_param_messages_type_Vector int' => 'IDs of read messages',
+    'object_decryptedMessageLayer_param_random_bytes_type_bytes' => 'Set of random bytes to prevent content recognition in short encrypted messages.
Clients are required to check that there are at least 15 random bytes included in each message. Messages with less than 15 random bytes must be ignored.
Parameter moved here from [decryptedMessage](../constructors/decryptedMessage.md) in [Layer 17](https://core.telegram.org/api/layers#layer-17).',
+    'object_decryptedMessage_param_random_id_type_long' => 'Random message ID, assigned by the author of message.
Must be equal to the ID passed to sending method.',
+    'object_decryptedMessage_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for styled text (parameter added in layer 45)',
+    'object_chatFull_param_bot_info_type_Vector BotInfo' => 'Info about bots that are in this chat',
+    'object_messages.featuredStickers_param_sets_type_Vector StickerSetCovered' => 'Featured stickersets',
+    'object_messages.featuredStickers_param_unread_type_Vector long' => 'IDs of new featured stickersets',
+    'object_decryptedMessageMediaExternalDocument_param_attributes_type_Vector DocumentAttribute' => 'Attributes for media types',
+    'object_document_param_thumbs_type_Vector PhotoSize' => 'Thumbnails',
+    'object_document_param_attributes_type_Vector DocumentAttribute' => 'Attributes',
+    'object_help.appUpdate_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+    'object_updates.difference_param_new_messages_type_Vector Message' => 'List of new messages',
+    'object_updates.difference_param_new_encrypted_messages_type_Vector EncryptedMessage' => 'List of new encrypted secret chat messages',
+    'object_updates.difference_param_other_updates_type_Vector Update' => 'List of updates',
+    'object_updates.difference_param_chats_type_Vector Chat' => 'List of chats mentioned in events',
+    'object_updates.difference_param_users_type_Vector User' => 'List of users mentioned in events',
+    'object_webPage_param_documents_type_Vector Document' => 'Attached webpage documents',
+    'object_decryptedMessageActionReadMessages_param_random_ids_type_Vector long' => 'List of message IDs',
+    'object_messageActionChatCreate_param_users_type_Vector int' => 'List of group members',
+    'object_botInlineMessageText_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+    'object_account.authorizations_param_authorizations_type_Vector Authorization' => 'Logged-in sessions',
+    'object_langPackDifference_param_strings_type_Vector LangPackString' => 'Localized strings',
+    'object_updateDeleteScheduledMessages_param_messages_type_Vector int' => 'Deleted scheduled messages',
+    'object_encryptedMessage_param_random_id_type_long' => 'Random message ID, assigned by the author of message',
+    'object_encryptedMessage_param_bytes_type_bytes' => 'TL-serialising of [DecryptedMessage](../types/DecryptedMessage.md) type, encrypted with the key creatied at stage of chat initialization',
+    'object_account.privacyRules_param_rules_type_Vector PrivacyRule' => 'Privacy rules',
+    'object_account.privacyRules_param_chats_type_Vector Chat' => 'Chats to which the rules apply',
+    'object_account.privacyRules_param_users_type_Vector User' => 'Users to which the rules apply',
+    'object_phoneCall_param_connections_type_Vector PhoneConnection' => 'List of endpoints the user can connect to to exchange call data',
+    'object_secureValueErrorFiles_param_file_hash_type_Vector bytes' => 'File hash',
+    'object_chatParticipants_param_participants_type_Vector ChatParticipant' => 'List of group members',
+    'object_secureValueErrorTranslationFiles_param_file_hash_type_Vector bytes' => 'Hash',
+    'object_pageBlockEmbedPost_param_blocks_type_Vector PageBlock' => 'Post contents',
+    'object_decryptedMessageActionScreenshotMessages_param_random_ids_type_Vector long' => 'List of affected message ids (that appeared on the screenshot)',
+    'object_channel_param_restriction_reason_type_Vector RestrictionReason' => 'Contains the reason why access to this channel must be restricted.',
+    'object_updateChannelReadMessagesContents_param_messages_type_Vector int' => 'IDs of messages that were read',
+    'object_messages.chats_param_chats_type_Vector Chat' => 'List of chats',
+    'object_contacts.blockedSlice_param_blocked_type_Vector ContactBlocked' => 'List of blocked users',
+    'object_contacts.blockedSlice_param_users_type_Vector User' => 'List of users',
+    'object_encryptedMessageService_param_random_id_type_long' => 'Random message ID, assigned by the author of message',
+    'object_encryptedMessageService_param_bytes_type_bytes' => 'TL-serialising of [DecryptedMessage](../types/DecryptedMessage.md) type, encrypted with the key creatied at stage of chat initialization',
+    'object_messages.dialogsSlice_param_dialogs_type_Vector Dialog' => 'List of dialogs',
+    'object_messages.dialogsSlice_param_messages_type_Vector Message' => 'List of last messages from dialogs',
+    'object_messages.dialogsSlice_param_chats_type_Vector Chat' => 'List of chats mentioned in dialogs',
+    'object_messages.dialogsSlice_param_users_type_Vector User' => 'List of users mentioned in messages and chats',
+    'object_cdnConfig_param_public_keys_type_Vector CdnPublicKey' => 'Vector of public keys to use **only** during handshakes to [CDN](https://core.telegram.org/cdn) DCs.',
+    'object_jsonArray_param_value_type_Vector JSONValue' => 'JSON values',
+    'object_messages.messages_param_messages_type_Vector Message' => 'List of messages',
+    'object_messages.messages_param_chats_type_Vector Chat' => 'List of chats mentioned in dialogs',
+    'object_messages.messages_param_users_type_Vector User' => 'List of users mentioned in messages and chats',
+    'object_help.recentMeUrls_param_urls_type_Vector RecentMeUrl' => 'URLs',
+    'object_help.recentMeUrls_param_chats_type_Vector Chat' => 'Chats',
+    'object_help.recentMeUrls_param_users_type_Vector User' => 'Users',
+    'object_botInfo_param_commands_type_Vector BotCommand' => 'Bot commands that can be used in the chat',
+    'object_pageTableRow_param_cells_type_Vector PageTableCell' => 'Table cells',
+    'object_help.userInfo_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+    'object_inputPrivacyValueDisallowUsers_param_users_type_Vector InputUser' => 'Users to disallow',
+    'object_secureValue_param_translation_type_Vector SecureFile' => 'Array of encrypted [passport](https://core.telegram.org/passport) files with translated versions of the provided documents',
+    'object_secureValue_param_files_type_Vector SecureFile' => 'Array of encrypted [passport](https://core.telegram.org/passport) files with photos the of the documents',
+    'object_payments.validatedRequestedInfo_param_shipping_options_type_Vector ShippingOption' => 'Shipping options',
+    'object_privacyValueAllowUsers_param_users_type_Vector int' => 'Allowed users',
+    'object_webDocument_param_attributes_type_Vector DocumentAttribute' => 'Attributes for media types',
+    'object_secureRequiredTypeOneOf_param_types_type_Vector SecureRequiredType' => 'Secure required value types',
+    'object_updateShortSentMessage_param_entities_type_Vector MessageEntity' => '[Entities](https://core.telegram.org/api/entities) for styled text',
+    'object_updateShortChatMessage_param_entities_type_Vector MessageEntity' => '[Entities](https://core.telegram.org/api/entities) for styled text',
+    'object_updateMessageID_param_random_id_type_long' => 'Previuosly transferred client **random\\_id** identifier',
+    'object_messages.archivedStickers_param_sets_type_Vector StickerSetCovered' => 'Archived stickersets',
+    'object_messages.messagesSlice_param_messages_type_Vector Message' => 'List of messages',
+    'object_messages.messagesSlice_param_chats_type_Vector Chat' => 'List of chats mentioned in messages',
+    'object_messages.messagesSlice_param_users_type_Vector User' => 'List of users mentioned in messages and chats',
+    'object_privacyValueDisallowUsers_param_users_type_Vector int' => 'Disallowed users',
+    'object_updateDcOptions_param_dc_options_type_Vector DcOption' => 'New connection options',
+    'object_payments.paymentReceipt_param_users_type_Vector User' => 'Users',
+    'object_updateMessageReactions' => 'New message reactions are available',
+    'object_updateMessageReactions_param_peer_type_Peer' => 'Peer',
+    'object_updateMessageReactions_param_msg_id_type_int' => 'Message ID',
+    'object_updateMessageReactions_param_reactions_type_MessageReactions' => 'Reactions',
+    'object_channels.channelParticipant_param_users_type_Vector User' => 'Users',
+    'object_poll_param_answers_type_Vector PollAnswer' => 'The possible answers, vote using [messages.sendVote](../methods/messages.sendVote.md).',
+    'object_updateDeleteMessages_param_messages_type_Vector int' => 'List of identifiers of deleted messages',
+    'object_messageReactionsList' => 'List of message reactions',
+    'object_messageReactionsList_param_count_type_int' => 'Total number of reactions',
+    'object_messageReactionsList_param_reactions_type_Vector MessageUserReaction' => 'Reactions',
+    'object_messageReactionsList_param_users_type_Vector User' => 'Users that reacted like this',
+    'object_messageReactionsList_param_next_offset_type_string' => 'Next offset to use when fetching reactions using [messages.getMessageReactionsList](../methods/messages.getMessageReactionsList.md)',
+    'method_messages.sendEncryptedFile_param_random_id_type_long' => 'Unique client message ID necessary to prevent message resending',
+    'method_messages.sendEncryptedFile_param_data_type_bytes' => 'TL-serialization of [DecryptedMessage](../types/DecryptedMessage.md) type, encrypted with a key generated during chat initialization',
+    'method_channels.getChannels_param_id_type_Vector InputChannel' => 'IDs of channels/supergroups to get info about',
+    'method_users.getUsers_param_id_type_Vector InputUser' => 'List of user identifiers',
+    'method_channels.getMessages_param_id_type_Vector InputMessage' => 'IDs of messages to get',
+    'method_channels.readMessageContents_param_id_type_Vector int' => 'IDs of messages whose contents should be marked as read',
+    'method_channels.inviteToChannel_param_users_type_Vector InputUser' => 'Users to invite',
+    'method_messages.sendVote_param_options_type_Vector bytes' => 'The options that were chosen',
+    'method_messages.getEmojiKeywordsLanguages_param_lang_codes_type_Vector string' => 'Language codes',
+    'method_messages.sendScheduledMessages_param_id_type_Vector int' => 'Scheduled message IDs',
+    'method_help.getPassportConfig_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+    'method_langpack.getStrings_param_keys_type_Vector string' => 'Strings to get',
+    'method_account.setPrivacy_param_rules_type_Vector InputPrivacyRule' => 'New privacy rules',
+    'method_messages.sendScreenshotNotification_param_random_id_type_long' => 'Random ID to avoid message resending',
+    'method_messages.startBot_param_random_id_type_long' => 'Random ID to avoid resending the same message',
+    'method_messages.deleteChatUser_param_chat_id_type_int' => 'Chat ID',
+    'method_messages.sendMessage_param_random_id_type_long' => 'Unique client message ID required to prevent message resending',
+    'method_messages.sendMessage_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for sending styled text',
+    'method_messages.getWebPagePreview_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+    'method_account.getWallPapers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+    'method_messages.readMessageContents_param_id_type_Vector int' => 'Message ID list',
+    'method_messages.getScheduledHistory_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+    'method_phone.requestCall_param_random_id_type_int' => 'Random ID to avoid resending the same object',
+    'method_messages.setInlineBotResults_param_results_type_Vector InputBotInlineResult' => 'Vector of results for the inline query',
+    'method_messages.sendMedia_param_random_id_type_long' => 'Random ID to avoid resending the same message',
+    'method_messages.sendMedia_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for styled text',
+    'method_messages.editMessage_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+    'method_messages.getMessagesReactions' => 'Get message reactions',
+    'method_messages.getMessagesReactions_param_peer_type_InputPeer' => 'Peer',
+    'method_messages.getMessagesReactions_param_id_type_Vector int' => 'Message IDs',
+    'method_users.setSecureValueErrors_param_errors_type_Vector SecureValueError' => 'Errors',
+    'method_contacts.getContactIDs_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+    'method_messages.getSearchCounters_param_filters_type_Vector MessagesFilter' => 'Search filters',
+    'method_contacts.deleteByPhones_param_phones_type_Vector string' => 'Phone numbers',
+    'method_messages.readFeaturedStickers_param_id_type_Vector long' => 'IDs of stickersets to mark as read',
+    'method_messages.saveDraft_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for styled text',
+    'method_account.unregisterDevice_param_other_uids_type_Vector int' => 'List of user identifiers of other users currently using the client',
+    'method_messages.report_param_id_type_Vector int' => 'IDs of messages to report',
+    'method_account.deleteSecureValue_param_types_type_Vector SecureValueType' => 'Document types to delete',
+    'method_messages.getChats_param_id_type_Vector int' => 'List of chat IDs',
+    'method_messages.reorderStickerSets_param_order_type_Vector long' => 'New stickerset order by stickerset IDs',
+    'method_messages.sendInlineBotResult_param_random_id_type_long' => 'Random ID to avoid resending the same query',
+    'method_messages.getAllChats_param_except_ids_type_Vector int' => 'Except these chats/channels/supergroups',
+    'method_messages.requestEncryption_param_random_id_type_int' => 'Unique client request ID required to prevent resending. This also doubles as the chat ID.',
+    'method_channels.reportSpam_param_id_type_Vector int' => 'IDs of spam messages',
+    'method_messages.createChat_param_users_type_Vector InputUser' => 'List of user IDs to be invited',
+    'method_account.acceptAuthorization_param_value_hashes_type_Vector SecureValueHash' => 'Types of values sent and their hashes',
+    'method_folders.editPeerFolders_param_folder_peers_type_Vector InputFolderPeer' => 'New peer list',
+    'method_messages.setBotShippingResults_param_shipping_options_type_Vector ShippingOption' => 'A vector of available shipping options.',
+    'method_messages.deleteScheduledMessages_param_id_type_Vector int' => 'Scheduled message IDs',
+    'method_messages.editChatTitle_param_chat_id_type_int' => 'Chat ID',
+    'method_account.registerDevice_param_other_uids_type_Vector int' => 'List of user identifiers of other users currently using the client',
+    'method_messages.addChatUser_param_chat_id_type_int' => 'Chat ID',
+    'method_messages.migrateChat_param_chat_id_type_int' => 'Legacy group to migrate',
+    'method_messages.sendReaction' => 'Send reaction to message',
+    'method_messages.sendReaction_param_peer_type_InputPeer' => 'Peer',
+    'method_messages.sendReaction_param_msg_id_type_int' => 'Message ID to react to',
+    'method_messages.sendReaction_param_reaction_type_string' => 'Reaction (a UTF8 emoji)',
+    'method_channels.deleteMessages_param_id_type_Vector int' => 'IDs of messages to delete',
+    'method_messages.deleteMessages_param_id_type_Vector int' => 'Message ID list',
+    'method_messages.getFullChat_param_chat_id_type_int' => 'Chat ID',
+    'method_account.getSecureValue_param_types_type_Vector SecureValueType' => 'Requested value types',
+    'method_messages.getMessagesViews_param_id_type_Vector int' => 'ID of message',
+    'method_account.getThemes_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+    'method_messages.sendEncrypted_param_random_id_type_long' => 'Unique client message ID, necessary to avoid message resending',
+    'method_messages.sendEncrypted_param_data_type_bytes' => 'TL-serialization of [DecryptedMessage](../types/DecryptedMessage.md) type, encrypted with a key that was created during chat initialization',
+    'method_auth.dropTempAuthKeys_param_except_auth_keys_type_Vector long' => 'The auth keys that **shouldn\'t** be dropped.',
+    'method_messages.reorderPinnedDialogs_param_order_type_Vector InputDialogPeer' => 'New dialog order',
+    'method_help.saveAppLog_param_events_type_Vector InputAppEvent' => 'List of input events',
+    'method_messages.getScheduledMessages_param_id_type_Vector int' => 'IDs of scheduled messages',
+    'method_photos.deletePhotos_param_id_type_Vector InputPhoto' => 'Input photos to delete',
+    'method_messages.sendEncryptedService_param_random_id_type_long' => 'Unique client message ID required to prevent message resending',
+    'method_messages.sendEncryptedService_param_data_type_bytes' => 'TL-serialization of  [DecryptedMessage](../types/DecryptedMessage.md) type, encrypted with a key generated during chat initialization',
+    'method_messages.sendMultiMedia_param_multi_media_type_Vector InputSingleMedia' => 'The medias to send',
+    'method_contacts.importContacts_param_contacts_type_Vector InputContact' => 'List of contacts to import',
+    'method_contacts.deleteContacts_param_id_type_Vector InputUser' => 'User ID list',
+    'method_stickers.createStickerSet_param_stickers_type_Vector InputStickerSetItem' => 'Stickers',
+    'method_channels.getAdminLog_param_admins_type_Vector InputUser' => 'Only show events from these admins',
+    'method_help.editUserInfo_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+    'method_messages.editChatPhoto_param_chat_id_type_int' => 'Chat ID',
+    'method_messages.getMessages_param_id_type_Vector InputMessage' => 'Message ID list',
+    'method_messages.editInlineBotMessage_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+    'method_messages.getPeerDialogs_param_peers_type_Vector InputDialogPeer' => 'Peers',
+    'method_messages.forwardMessages_param_id_type_Vector int' => 'IDs of messages',
+    'method_messages.forwardMessages_param_random_id_type_Vector long' => 'Random ID to prevent resending of messages',
+    'method_messages.getMessageReactionsList' => 'Get full message reaction list',
+    'method_messages.getMessageReactionsList_param_peer_type_InputPeer' => 'Peer',
+    'method_messages.getMessageReactionsList_param_id_type_int' => 'Message ID',
+    'method_messages.getMessageReactionsList_param_reaction_type_string' => 'Get only reactions of this type (UTF8 emoji)',
+    'method_messages.getMessageReactionsList_param_offset_type_string' => 'Offset (typically taken from the `next_offset` field of the returned [MessageReactionsList](../types/MessageReactionsList.md))',
+    'method_messages.getMessageReactionsList_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)',
+    'method_messages.editChatAdmin_param_chat_id_type_int' => 'The ID of the group',
+    'method_invokeAfterMsgs_param_msg_ids_type_Vector long' => 'List of messages on which a current query depends',
     'object_botInlineMediaResultDocument_param_send_message_type_BotInlineMessage' => '',
     'object_botInlineMediaResultPhoto_param_send_message_type_BotInlineMessage' => '',
     'object_channelBannedRights_param_send_messages_type_true' => '',
@@ -5423,780 +5804,786 @@ class Lang
   'method_invokeAfterMsg' => 'Invokes a query after successfull completion of one of the previous queries.',
   'method_invokeAfterMsg_param_msg_id_type_long' => 'Message identifier on which a current query depends',
   'method_invokeAfterMsg_param_query_type_!X' => 'The query itself',
-  'method_invokeAfterMsgs' => 'Result type returned by a current query.',
+  'method_invokeAfterMsgs' => 'Invokes a query after a successfull completion of previous queries',
   'method_invokeAfterMsgs_param_msg_ids_type_Vector t' => 'List of messages on which a current query depends',
   'method_invokeAfterMsgs_param_query_type_!X' => 'The query itself',
-  'method_initConnection' => 'Initializes connection and save information on the user\'s device and application.',
-  'method_initConnection_param_api_id_type_int' => 'Application identifier',
+  'method_initConnection' => 'Initialize connection',
+  'method_initConnection_param_api_id_type_int' => 'Application identifier (see. [App configuration](https://core.telegram.org/myapp))',
   'method_initConnection_param_device_model_type_string' => 'Device model',
-  'method_initConnection_param_system_version_type_string' => 'System version',
-  'method_initConnection_param_app_version_type_string' => 'App version',
-  'method_initConnection_param_system_lang_code_type_string' => 'Language code',
+  'method_initConnection_param_system_version_type_string' => 'Operation system version',
+  'method_initConnection_param_app_version_type_string' => 'Application version',
+  'method_initConnection_param_system_lang_code_type_string' => 'Code for the language used on the device\'s OS, ISO 639-1 standard',
   'method_initConnection_param_lang_pack_type_string' => 'Language pack to use',
-  'method_initConnection_param_lang_code_type_string' => 'Language code to set',
-  'method_initConnection_param_query_type_!X' => 'Nested query',
-  'method_invokeWithLayer' => 'Invoke this method with layer X',
-  'method_invokeWithLayer_param_layer_type_int' => 'The layer version',
+  'method_initConnection_param_lang_code_type_string' => 'Code for the language used on the client, ISO 639-1 standard',
+  'method_initConnection_param_query_type_!X' => 'The query itself',
+  'method_invokeWithLayer' => 'Invoke the specified query using the specified API [layer](https://core.telegram.org/api/invoking#layers)',
+  'method_invokeWithLayer_param_layer_type_int' => 'The layer to use',
   'method_invokeWithLayer_param_query_type_!X' => 'The query',
-  'method_invokeWithoutUpdates' => 'Invoke with method without returning updates in the socket',
+  'method_invokeWithoutUpdates' => 'Invoke a request without subscribing the used connection for [updates](https://core.telegram.org/api/updates) (this is enabled by default for [file queries](https://core.telegram.org/api/files)).',
   'method_invokeWithoutUpdates_param_query_type_!X' => 'The query',
   'method_auth.checkPhone' => 'Check if this phone number is registered on telegram',
   'method_auth.checkPhone_param_phone_number_type_string' => 'The phone number to check',
-  'method_auth.sendCode' => 'Use phoneLogin instead',
+  'method_auth.sendCode' => 'Send the verification code for login',
   'method_auth.sendCode_param_allow_flashcall_type_true' => 'Use phoneLogin instead',
-  'method_auth.sendCode_param_phone_number_type_string' => 'Use phoneLogin instead',
+  'method_auth.sendCode_param_phone_number_type_string' => 'Phone number in international format',
   'method_auth.sendCode_param_current_number_type_Bool' => 'Use phoneLogin instead',
-  'method_auth.sendCode_param_api_id_type_int' => 'Use phoneLogin instead',
-  'method_auth.sendCode_param_api_hash_type_string' => 'Use phoneLogin instead',
-  'method_auth.signUp' => 'You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.signUp_param_phone_number_type_string' => 'You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.signUp_param_phone_code_hash_type_string' => 'You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info)',
+  'method_auth.sendCode_param_api_id_type_int' => 'Application identifier (see [App configuration](https://core.telegram.org/myapp))',
+  'method_auth.sendCode_param_api_hash_type_string' => 'Application secret hash (see [App configuration](https://core.telegram.org/myapp))',
+  'method_auth.signUp' => 'Registers a validated phone number in the system.',
+  'method_auth.signUp_param_phone_number_type_string' => 'Phone number in the international format',
+  'method_auth.signUp_param_phone_code_hash_type_string' => 'SMS-message ID',
   'method_auth.signUp_param_phone_code_type_string' => 'You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.signUp_param_first_name_type_string' => 'You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.signUp_param_last_name_type_string' => 'You cannot use this method directly, use the completeSignup method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.signIn' => 'You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.signIn_param_phone_number_type_string' => 'You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.signIn_param_phone_code_hash_type_string' => 'You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.signIn_param_phone_code_type_string' => 'You cannot use this method directly, use the completePhoneLogin method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.logOut' => 'You cannot use this method directly, use the logout method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.resetAuthorizations' => 'Delete all logged-in sessions.',
+  'method_auth.signUp_param_first_name_type_string' => 'New user first name',
+  'method_auth.signUp_param_last_name_type_string' => 'New user last name',
+  'method_auth.signIn' => 'Signs in a user with a validated phone number.',
+  'method_auth.signIn_param_phone_number_type_string' => 'Phone number in the international format',
+  'method_auth.signIn_param_phone_code_hash_type_string' => 'SMS-message ID, obtained from [auth.sendCode](../methods/auth.sendCode.md)',
+  'method_auth.signIn_param_phone_code_type_string' => 'Valid numerical code from the SMS-message',
+  'method_auth.logOut' => 'Logs out the user.',
+  'method_auth.resetAuthorizations' => 'Terminates all user\'s authorized sessions except for the current one.
+
+After calling this method it is necessary to reregister the current device using the method [account.registerDevice](../methods/account.registerDevice.md)',
   'method_auth.sendInvites' => 'Invite friends to telegram!',
   'method_auth.sendInvites_param_phone_numbers_type_Vector t' => 'Phone numbers to invite',
   'method_auth.sendInvites_param_message_type_string' => 'The message to send',
-  'method_auth.exportAuthorization' => 'You cannot use this method directly, use $MadelineProto->exportAuthorization() instead, see https://docs.madelineproto.xyz/docs/LOGIN.html',
-  'method_auth.exportAuthorization_param_dc_id_type_int' => 'You cannot use this method directly, use $MadelineProto->exportAuthorization() instead, see https://docs.madelineproto.xyz/docs/LOGIN.html',
-  'method_auth.importAuthorization' => 'You cannot use this method directly, use $MadelineProto->importAuthorization($authorization) instead, see https://docs.madelineproto.xyz/docs/LOGIN.html',
-  'method_auth.importAuthorization_param_id_type_int' => 'You cannot use this method directly, use $MadelineProto->importAuthorization($authorization) instead, see https://docs.madelineproto.xyz/docs/LOGIN.html',
-  'method_auth.importAuthorization_param_bytes_type_bytes' => 'You cannot use this method directly, use $MadelineProto->importAuthorization($authorization) instead, see https://docs.madelineproto.xyz/docs/LOGIN.html',
-  'method_auth.bindTempAuthKey' => 'You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info',
-  'method_auth.bindTempAuthKey_param_perm_auth_key_id_type_long' => 'You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info',
-  'method_auth.bindTempAuthKey_param_nonce_type_long' => 'You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info',
-  'method_auth.bindTempAuthKey_param_expires_at_type_int' => 'You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info',
-  'method_auth.bindTempAuthKey_param_encrypted_message_type_bytes' => 'You cannot use this method directly, instead modify the PFS and default_temp_auth_key_expires_in settings, see https://docs.madelineproto.xyz/docs/SETTINGS.html for more info',
-  'method_auth.importBotAuthorization' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.importBotAuthorization_param_api_id_type_int' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.importBotAuthorization_param_api_hash_type_string' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.importBotAuthorization_param_bot_auth_token_type_string' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.checkPassword' => 'You cannot use this method directly, use the complete_2fa_login method instead (see https://docs.madelineproto.xyz for more info)',
+  'method_auth.exportAuthorization' => 'Returns data for copying authorization to another data-centre.',
+  'method_auth.exportAuthorization_param_dc_id_type_int' => 'Number of a target data-centre',
+  'method_auth.importAuthorization' => 'Logs in a user using a key transmitted from his native data-centre.',
+  'method_auth.importAuthorization_param_id_type_int' => 'User ID',
+  'method_auth.importAuthorization_param_bytes_type_bytes' => 'Authorization key',
+  'method_auth.bindTempAuthKey' => 'Binds a temporary authorization key `temp_auth_key_id` to the permanent authorization key `perm_auth_key_id`. Each permanent key may only be bound to one temporary key at a time, binding a new temporary key overwrites the previous one.
+
+For more information, see [Perfect Forward Secrecy](https://core.telegram.org/api/pfs).',
+  'method_auth.bindTempAuthKey_param_perm_auth_key_id_type_long' => 'Permanent auth\\_key\\_id to bind to',
+  'method_auth.bindTempAuthKey_param_nonce_type_long' => 'Random long from [Binding message contents](#binding-message-contents)',
+  'method_auth.bindTempAuthKey_param_expires_at_type_int' => 'Unix timestamp to invalidate temporary key, see [Binding message contents](#binding-message-contents)',
+  'method_auth.bindTempAuthKey_param_encrypted_message_type_bytes' => 'See [Generating encrypted\\_message](#generating-encrypted-message)',
+  'method_auth.importBotAuthorization' => 'Login as a bot',
+  'method_auth.importBotAuthorization_param_api_id_type_int' => 'Application identifier (see. [App configuration](https://core.telegram.org/myapp))',
+  'method_auth.importBotAuthorization_param_api_hash_type_string' => 'Application identifier hash (see. [App configuration](https://core.telegram.org/myapp))',
+  'method_auth.importBotAuthorization_param_bot_auth_token_type_string' => 'Bot token (see [bots](https://core.telegram.org/bots))',
+  'method_auth.checkPassword' => 'Try logging to an account protected by a [2FA password](https://core.telegram.org/api/srp).',
   'method_auth.checkPassword_param_password_hash_type_bytes' => 'You cannot use this method directly, use the complete_2fa_login method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_auth.requestPasswordRecovery' => 'Send an email to recover the 2FA password',
-  'method_auth.recoverPassword' => 'Use the code that was emailed to you after running $MadelineProto->auth->requestPasswordRecovery to login to your account',
-  'method_auth.recoverPassword_param_code_type_string' => 'The code that was emailed to you',
-  'method_auth.resendCode' => 'Resend the SMS verification code',
+  'method_auth.requestPasswordRecovery' => 'Request recovery code of a [2FA password](https://core.telegram.org/api/srp), only for accounts with a [recovery email configured](https://core.telegram.org/api/srp#email-verification).',
+  'method_auth.recoverPassword' => 'Reset the [2FA password](https://core.telegram.org/api/srp) using the recovery code sent using [auth.requestPasswordRecovery](../methods/auth.requestPasswordRecovery.md).',
+  'method_auth.recoverPassword_param_code_type_string' => 'Code received via email',
+  'method_auth.resendCode' => 'Resend the login code via another medium, the phone code type is determined by the return value of the previous auth.sendCode/auth.resendCode: see [login](https://core.telegram.org/api/auth) for more info.',
   'method_auth.resendCode_param_phone_number_type_string' => 'The phone number',
-  'method_auth.resendCode_param_phone_code_hash_type_string' => 'The phone code hash',
-  'method_auth.cancelCode' => 'Invalidate sent phone code',
+  'method_auth.resendCode_param_phone_code_hash_type_string' => 'The phone code hash obtained from [auth.sendCode](../methods/auth.sendCode.md)',
+  'method_auth.cancelCode' => 'Cancel the login verification code',
   'method_auth.cancelCode_param_phone_number_type_string' => 'Phone number',
-  'method_auth.cancelCode_param_phone_code_hash_type_string' => 'Phone code hash',
-  'method_auth.dropTempAuthKeys' => 'Delete all temporary authorization keys except the ones provided',
+  'method_auth.cancelCode_param_phone_code_hash_type_string' => 'Phone code hash from [auth.sendCode](../methods/auth.sendCode.md)',
+  'method_auth.dropTempAuthKeys' => 'Delete all temporary authorization keys **except for** the ones specified',
   'method_auth.dropTempAuthKeys_param_except_auth_keys_type_Vector t' => 'The temporary authorization keys to keep',
-  'method_account.registerDevice' => 'Register device for push notifications',
-  'method_account.registerDevice_param_token_type_type_int' => 'Device token type. Possible values: 1 - APNS, 2 - GCM, 3 - MPNS, 4 - Simple Push, 5 - Ubuntu Phone, 6 - Blackberry, and other, see source code of official apps for more info',
-  'method_account.registerDevice_param_token_type_string' => 'Device token type. Possible values: 1 - APNS, 2 - GCM, 3 - MPNS, 4 - Simple Push, 5 - Ubuntu Phone,6 - Blackberry, and other, see source code of official apps for more info',
-  'method_account.registerDevice_param_app_sandbox_type_Bool' => 'Should the app run in a sandbox?',
+  'method_account.registerDevice' => 'Register device to receive [PUSH notifications](https://core.telegram.org/api/push-updates)',
+  'method_account.registerDevice_param_token_type_type_int' => 'Device token type.
**Possible values**:
`1` \\- APNS (device token for apple push)
`2` \\- FCM (firebase token for google firebase)
`3` \\- MPNS (channel URI for microsoft push)
`4` \\- Simple push (endpoint for firefox\'s simple push API)
`5` \\- Ubuntu phone (token for ubuntu push)
`6` \\- Blackberry (token for blackberry push)
`7` \\- Unused
`8` \\- WNS (windows push)
`9` \\- APNS VoIP (token for apple push VoIP)
`10` \\- Web push (web push, see below)
`11` \\- MPNS VoIP (token for microsoft push VoIP)
`12` \\- Tizen (token for tizen push)

For `10` web push, the token must be a JSON-encoded object containing the keys described in [PUSH updates](https://core.telegram.org/api/push-updates)',
+  'method_account.registerDevice_param_token_type_string' => 'Device token',
+  'method_account.registerDevice_param_app_sandbox_type_Bool' => 'If [(boolTrue)](../constructors/boolTrue.md) is transmitted, a sandbox-certificate will be used during transmission.',
   'method_account.registerDevice_param_other_uids_type_Vector t' => 'Other UIDs',
-  'method_account.unregisterDevice' => 'Stop sending PUSH notifications to app',
-  'method_account.unregisterDevice_param_token_type_type_int' => 'Device token type. Possible values: 1 - APNS, 2 - GCM, 3 - MPNS, 4 - Simple Push, 5 - Ubuntu Phone,6 - Blackberry, and other, see source code of official apps for more info',
-  'method_account.unregisterDevice_param_token_type_string' => 'Device token type. Possible values: 1 - APNS, 2 - GCM, 3 - MPNS, 4 - Simple Push, 5 - Ubuntu Phone,6 - Blackberry, and other, see source code of official apps for more info',
+  'method_account.unregisterDevice' => 'Deletes a device by its token, stops sending PUSH-notifications to it.',
+  'method_account.unregisterDevice_param_token_type_type_int' => 'Device token type.
**Possible values**:
`1` \\- APNS (device token for apple push)
`2` \\- FCM (firebase token for google firebase)
`3` \\- MPNS (channel URI for microsoft push)
`4` \\- Simple push (endpoint for firefox\'s simple push API)
`5` \\- Ubuntu phone (token for ubuntu push)
`6` \\- Blackberry (token for blackberry push)
`7` \\- Unused
`8` \\- WNS (windows push)
`9` \\- APNS VoIP (token for apple push VoIP)
`10` \\- Web push (web push, see below)
`11` \\- MPNS VoIP (token for microsoft push VoIP)
`12` \\- Tizen (token for tizen push)

For `10` web push, the token must be a JSON-encoded object containing the keys described in [PUSH updates](https://core.telegram.org/api/push-updates)',
+  'method_account.unregisterDevice_param_token_type_string' => 'Device token',
   'method_account.unregisterDevice_param_other_uids_type_Vector t' => 'Other UIDs',
-  'method_account.updateNotifySettings' => 'Change notification settings',
-  'method_account.updateNotifySettings_param_peer_type_InputNotifyPeer' => 'The peers to which the notification settings should be applied',
+  'method_account.updateNotifySettings' => 'Edits notification settings from a given user/group, from all users/all groups.',
+  'method_account.updateNotifySettings_param_peer_type_InputNotifyPeer' => 'Notification source',
   'method_account.updateNotifySettings_param_settings_type_InputPeerNotifySettings' => 'Notification settings',
-  'method_account.getNotifySettings' => 'Get notification settings',
-  'method_account.getNotifySettings_param_peer_type_InputNotifyPeer' => 'Notification source ',
-  'method_account.resetNotifySettings' => 'Reset all notification settings',
-  'method_account.updateProfile' => 'Update profile info',
-  'method_account.updateProfile_param_first_name_type_string' => 'The first name',
-  'method_account.updateProfile_param_last_name_type_string' => 'The last name',
-  'method_account.updateProfile_param_about_type_string' => 'The bio/about field',
-  'method_account.updateStatus' => 'Update online status',
-  'method_account.updateStatus_param_offline_type_Bool' => 'True to set the status to offline',
+  'method_account.getNotifySettings' => 'Gets current notification settings for a given user/group, from all users/all groups.',
+  'method_account.getNotifySettings_param_peer_type_InputNotifyPeer' => 'Notification source',
+  'method_account.resetNotifySettings' => 'Resets all notification settings from users and groups.',
+  'method_account.updateProfile' => 'Updates user profile.',
+  'method_account.updateProfile_param_first_name_type_string' => 'New user first name',
+  'method_account.updateProfile_param_last_name_type_string' => 'New user last name',
+  'method_account.updateProfile_param_about_type_string' => 'New bio',
+  'method_account.updateStatus' => 'Updates online user status.',
+  'method_account.updateStatus_param_offline_type_Bool' => 'If [(boolTrue)](../constructors/boolTrue.md) is transmitted, user status will change to [(userStatusOffline)](../constructors/userStatusOffline.md).',
   'method_account.getWallPapers' => 'Returns a list of available wallpapers.',
-  'method_account.reportPeer' => 'Report for spam',
+  'method_account.reportPeer' => 'Report a peer for violation of telegram\'s Terms of Service',
   'method_account.reportPeer_param_peer_type_InputPeer' => 'The peer to report',
-  'method_account.reportPeer_param_reason_type_ReportReason' => 'Why are you reporting this peer',
-  'method_account.checkUsername' => 'Check if this username is available',
-  'method_account.checkUsername_param_username_type_string' => 'The username to check',
-  'method_account.updateUsername' => 'Update this user\'s username',
-  'method_account.updateUsername_param_username_type_string' => 'The new username',
-  'method_account.getPrivacy' => 'Get privacy settings',
-  'method_account.getPrivacy_param_key_type_InputPrivacyKey' => 'Privacy setting key',
-  'method_account.setPrivacy' => 'Set privacy settings',
-  'method_account.setPrivacy_param_key_type_InputPrivacyKey' => 'Privacy setting',
+  'method_account.reportPeer_param_reason_type_ReportReason' => 'The reason why this peer is being reported',
+  'method_account.checkUsername' => 'Validates a username and checks availability.',
+  'method_account.checkUsername_param_username_type_string' => 'username
Accepted characters: A-z (case-insensitive), 0-9 and underscores.
Length: 5-32 characters.',
+  'method_account.updateUsername' => 'Changes username for the current user.',
+  'method_account.updateUsername_param_username_type_string' => 'username or empty string if username is to be removed
Accepted characters: a-z (case-insensitive), 0-9 and underscores.
Length: 5-32 characters.',
+  'method_account.getPrivacy' => 'Get privacy settings of current account',
+  'method_account.getPrivacy_param_key_type_InputPrivacyKey' => 'Peer category whose privacy settings should be fetched',
+  'method_account.setPrivacy' => 'Change privacy settings of current account',
+  'method_account.setPrivacy_param_key_type_InputPrivacyKey' => 'Peers to which the privacy rules apply',
   'method_account.setPrivacy_param_rules_type_Vector t' => 'Privacy settings',
-  'method_account.deleteAccount' => 'Delete this account',
-  'method_account.deleteAccount_param_reason_type_string' => 'Why are you going away? :(',
-  'method_account.getAccountTTL' => 'Get account TTL',
-  'method_account.setAccountTTL' => 'Set account TTL',
-  'method_account.setAccountTTL_param_ttl_type_AccountDaysTTL' => 'Time To Live of account',
-  'method_account.sendChangePhoneCode' => 'Change the phone number',
+  'method_account.deleteAccount' => 'Delete the user\'s account from the telegram servers. Can be used, for example, to delete the account of a user that provided the login code, but forgot the [2FA password and no recovery method is configured](https://core.telegram.org/api/srp).',
+  'method_account.deleteAccount_param_reason_type_string' => 'Why is the account being deleted, can be empty',
+  'method_account.getAccountTTL' => 'Get days to live of account',
+  'method_account.setAccountTTL' => 'Set account self-destruction period',
+  'method_account.setAccountTTL_param_ttl_type_AccountDaysTTL' => 'Time to live in days',
+  'method_account.sendChangePhoneCode' => 'Verify a new phone number to associate to the current account',
   'method_account.sendChangePhoneCode_param_allow_flashcall_type_true' => 'Can the code be sent using a flash call instead of an SMS?',
   'method_account.sendChangePhoneCode_param_phone_number_type_string' => 'New phone number',
   'method_account.sendChangePhoneCode_param_current_number_type_Bool' => 'Current phone number',
-  'method_account.changePhone' => 'Change the phone number associated to this account',
-  'method_account.changePhone_param_phone_number_type_string' => 'Phone number',
-  'method_account.changePhone_param_phone_code_hash_type_string' => 'Phone code hash returned by account.sendChangePhoneCode',
-  'method_account.changePhone_param_phone_code_type_string' => 'The phone code sent by account.sendChangePhoneCode',
-  'method_account.updateDeviceLocked' => 'Disable all notifications for a certain period',
-  'method_account.updateDeviceLocked_param_period_type_int' => 'For how long should notifications be disabled',
-  'method_account.getAuthorizations' => 'Get all logged-in authorizations',
-  'method_account.resetAuthorization' => 'Delete a certain session',
-  'method_account.resetAuthorization_param_hash_type_long' => 'The session hash, obtained from $MadelineProto->account->getAuthorizations',
-  'method_account.getPassword' => 'Get the current password',
-  'method_account.getPasswordSettings' => 'Get the current 2FA settings',
+  'method_account.changePhone' => 'Change the phone number of the current account',
+  'method_account.changePhone_param_phone_number_type_string' => 'New phone number',
+  'method_account.changePhone_param_phone_code_hash_type_string' => 'Phone code hash received when calling [account.sendChangePhoneCode](../methods/account.sendChangePhoneCode.md)',
+  'method_account.changePhone_param_phone_code_type_string' => 'Phone code received when calling [account.sendChangePhoneCode](../methods/account.sendChangePhoneCode.md)',
+  'method_account.updateDeviceLocked' => 'When client-side passcode lock feature is enabled, will not show message texts in incoming [PUSH notifications](https://core.telegram.org/api/push-updates).',
+  'method_account.updateDeviceLocked_param_period_type_int' => 'Inactivity period after which to start hiding message texts in [PUSH notifications](https://core.telegram.org/api/push-updates).',
+  'method_account.getAuthorizations' => 'Get logged-in sessions',
+  'method_account.resetAuthorization' => 'Log out an active [authorized session](https://core.telegram.org/api/auth) by its hash',
+  'method_account.resetAuthorization_param_hash_type_long' => 'Session hash',
+  'method_account.getPassword' => 'Obtain configuration for two-factor authorization with password',
+  'method_account.getPasswordSettings' => 'Get private info associated to the password info (recovery email, telegram [passport](https://core.telegram.org/passport) info & so on)',
   'method_account.getPasswordSettings_param_current_password_hash_type_bytes' => 'Use only if you have set a 2FA password: `$current_salt = $MadelineProto->account->getPassword()[\'current_salt\']; $current_password_hash = hash(\'sha256\', $current_salt.$password.$current_salt, true);`',
-  'method_account.updatePasswordSettings' => 'You cannot use this method directly; use $MadelineProto->update_2fa($params), instead (see https://docs.madelineproto.xyz for more info)',
+  'method_account.updatePasswordSettings' => 'Set a new 2FA password',
   'method_account.updatePasswordSettings_param_current_password_hash_type_bytes' => 'Use only if you have set a 2FA password: `$current_salt = $MadelineProto->account->getPassword()[\'current_salt\']; $current_password_hash = hash(\'sha256\', $current_salt.$password.$current_salt, true);`',
-  'method_account.updatePasswordSettings_param_new_settings_type_account.PasswordInputSettings' => 'New 2FA settings',
-  'method_account.sendConfirmPhoneCode' => 'Send confirmation phone code',
+  'method_account.updatePasswordSettings_param_new_settings_type_account.PasswordInputSettings' => 'The new password (see [SRP](https://core.telegram.org/api/srp))',
+  'method_account.sendConfirmPhoneCode' => 'Send confirmation code to cancel account deletion, for more info [click here »](https://core.telegram.org/api/account-deletion)',
   'method_account.sendConfirmPhoneCode_param_allow_flashcall_type_true' => 'Can telegram call you instead of sending an SMS?',
-  'method_account.sendConfirmPhoneCode_param_hash_type_string' => 'The hash',
+  'method_account.sendConfirmPhoneCode_param_hash_type_string' => 'The hash from the service notification, for more info [click here »](https://core.telegram.org/api/account-deletion)',
   'method_account.sendConfirmPhoneCode_param_current_number_type_Bool' => 'The current phone number',
-  'method_account.confirmPhone' => 'Confirm this phone number is associated to this account, obtain phone_code_hash from sendConfirmPhoneCode',
-  'method_account.confirmPhone_param_phone_code_hash_type_string' => 'Obtain phone_code_hash from sendConfirmPhoneCode',
-  'method_account.confirmPhone_param_phone_code_type_string' => 'The code sent by sendConfirmPhoneCode',
-  'method_account.getTmpPassword' => 'Get temporary password for buying products through bots',
+  'method_account.confirmPhone' => 'Confirm a phone number to cancel account deletion, for more info [click here »](https://core.telegram.org/api/account-deletion)',
+  'method_account.confirmPhone_param_phone_code_hash_type_string' => 'Phone code hash, for more info [click here »](https://core.telegram.org/api/account-deletion)',
+  'method_account.confirmPhone_param_phone_code_type_string' => 'SMS code, for more info [click here »](https://core.telegram.org/api/account-deletion)',
+  'method_account.getTmpPassword' => 'Get temporary payment password',
   'method_account.getTmpPassword_param_password_hash_type_bytes' => 'The password hash',
-  'method_account.getTmpPassword_param_period_type_int' => 'The validity period',
-  'method_account.getWebAuthorizations' => 'Get telegram web login authorizations',
-  'method_account.resetWebAuthorization' => 'Delete a certain telegram web login authorization',
-  'method_account.resetWebAuthorization_param_hash_type_long' => 'The authorization\'s hash',
-  'method_account.resetWebAuthorizations' => 'Reset all telegram web login authorizations',
-  'method_users.getUsers' => 'Get info about users',
+  'method_account.getTmpPassword_param_period_type_int' => 'Time during which the temporary password will be valid, in seconds; should be between 60 and 86400',
+  'method_account.getWebAuthorizations' => 'Get web [login widget](https://core.telegram.org/widgets/login) authorizations',
+  'method_account.resetWebAuthorization' => 'Log out an active web [telegram login](https://core.telegram.org/widgets/login) session',
+  'method_account.resetWebAuthorization_param_hash_type_long' => '[Session](../constructors/webAuthorization.md) hash',
+  'method_account.resetWebAuthorizations' => 'Reset all active web [telegram login](https://core.telegram.org/widgets/login) sessions',
+  'method_users.getUsers' => 'Returns basic user info according to their identifiers.',
   'method_users.getUsers_param_id_type_Vector t' => 'The ids of the users',
-  'method_users.getFullUser' => 'You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)',
-  'method_users.getFullUser_param_id_type_InputUser' => 'You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)',
-  'method_contacts.getStatuses' => 'Get online status of all users',
-  'method_contacts.getContacts' => 'Get all contacts',
-  'method_contacts.getContacts_param_hash_type_int' => 'User ids of contacts previously fetched with this method',
-  'method_contacts.importContacts' => 'Add phone number as contact',
+  'method_users.getFullUser' => 'Returns extended user info by ID.',
+  'method_users.getFullUser_param_id_type_InputUser' => 'User ID',
+  'method_contacts.getStatuses' => 'Returns the list of contact statuses.',
+  'method_contacts.getContacts' => 'Returns the current user\'s contact list.',
+  'method_contacts.getContacts_param_hash_type_int' => 'If there already is a full contact list on the client, a [hash](https://core.telegram.org/api/offsets#hash-generation) of a the list of contact IDs in ascending order may be passed in this parameter. If the contact set was not changed, [(contacts.contactsNotModified)](../constructors/contacts.contactsNotModified.md) will be returned.',
+  'method_contacts.importContacts' => 'Imports contacts: saves a full list on the server, adds already registered contacts to the contact list, returns added contacts and their info.',
   'method_contacts.importContacts_param_contacts_type_Vector t' => 'The numbers to import',
   'method_contacts.deleteContact' => 'Delete a contact',
   'method_contacts.deleteContact_param_id_type_InputUser' => 'The contact to delete',
-  'method_contacts.deleteContacts' => 'Delete multiple contacts',
+  'method_contacts.deleteContacts' => 'Deletes several contacts from the list.',
   'method_contacts.deleteContacts_param_id_type_Vector t' => 'The contacts to delete',
-  'method_contacts.block' => 'Block a user',
-  'method_contacts.block_param_id_type_InputUser' => 'The user to block',
-  'method_contacts.unblock' => 'Unblock a user',
-  'method_contacts.unblock_param_id_type_InputUser' => 'The user to unblock',
-  'method_contacts.getBlocked' => 'Get blocked users',
-  'method_contacts.getBlocked_param_offset_type_int' => 'Initially 0, then set to the number of blocked contacts previously fetched',
-  'method_contacts.getBlocked_param_limit_type_int' => 'How many blocked contacts to fetch',
+  'method_contacts.block' => 'Adds the user to the blacklist.',
+  'method_contacts.block_param_id_type_InputUser' => 'User ID',
+  'method_contacts.unblock' => 'Deletes the user from the blacklist.',
+  'method_contacts.unblock_param_id_type_InputUser' => 'User ID',
+  'method_contacts.getBlocked' => 'Returns the list of blocked users.',
+  'method_contacts.getBlocked_param_offset_type_int' => 'The number of list elements to be skipped',
+  'method_contacts.getBlocked_param_limit_type_int' => 'The number of list elements to be returned',
   'method_contacts.exportCard' => 'Export contact as card',
   'method_contacts.importCard' => 'Import card as contact',
   'method_contacts.importCard_param_export_card_type_Vector t' => 'The card',
-  'method_contacts.search' => 'Search contacts',
-  'method_contacts.search_param_q_type_string' => 'The search query',
-  'method_contacts.search_param_limit_type_int' => 'How many results should be returned',
-  'method_contacts.resolveUsername' => 'You cannot use this method directly, use the resolveUsername, getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)',
-  'method_contacts.resolveUsername_param_username_type_string' => 'You cannot use this method directly, use the resolveUsername, getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)',
-  'method_contacts.getTopPeers' => 'Get most used chats',
-  'method_contacts.getTopPeers_param_correspondents_type_true' => 'Fetch users?',
-  'method_contacts.getTopPeers_param_bots_pm_type_true' => 'Fetch bots?',
-  'method_contacts.getTopPeers_param_bots_inline_type_true' => 'Fetch inline bots?',
-  'method_contacts.getTopPeers_param_phone_calls_type_true' => 'Fetch phone calls?',
-  'method_contacts.getTopPeers_param_groups_type_true' => 'Fetch groups?',
-  'method_contacts.getTopPeers_param_channels_type_true' => 'Fetch channels and supergroups?',
-  'method_contacts.getTopPeers_param_offset_type_int' => 'Initially 0, then `$offset += $contacts_TopPeers[\'categories\'][\'count\'];`',
-  'method_contacts.getTopPeers_param_limit_type_int' => 'How many results to fetch',
-  'method_contacts.getTopPeers_param_hash_type_int' => 'Peer ids previously fetched with this method',
-  'method_contacts.resetTopPeerRating' => 'Reset top peer rating for a certain category/peer',
-  'method_contacts.resetTopPeerRating_param_category_type_TopPeerCategory' => 'The category ',
-  'method_contacts.resetTopPeerRating_param_peer_type_InputPeer' => 'The peer',
-  'method_contacts.resetSaved' => 'Reset saved contacts',
-  'method_messages.getMessages' => 'Get messages',
+  'method_contacts.search' => 'Returns users found by username substring.',
+  'method_contacts.search_param_q_type_string' => 'Target substring',
+  'method_contacts.search_param_limit_type_int' => 'Maximum number of users to be returned',
+  'method_contacts.resolveUsername' => 'Resolve a @username to get peer info',
+  'method_contacts.resolveUsername_param_username_type_string' => '@username to resolve',
+  'method_contacts.getTopPeers' => 'Get most used peers',
+  'method_contacts.getTopPeers_param_correspondents_type_true' => 'Users we\'ve chatted most frequently with',
+  'method_contacts.getTopPeers_param_bots_pm_type_true' => 'Most used bots',
+  'method_contacts.getTopPeers_param_bots_inline_type_true' => 'Most used inline bots',
+  'method_contacts.getTopPeers_param_phone_calls_type_true' => 'Most frequently called users',
+  'method_contacts.getTopPeers_param_groups_type_true' => 'Often-opened groups and supergroups',
+  'method_contacts.getTopPeers_param_channels_type_true' => 'Most frequently visited channels',
+  'method_contacts.getTopPeers_param_offset_type_int' => 'Offset for [pagination](https://core.telegram.org/api/offsets)',
+  'method_contacts.getTopPeers_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)',
+  'method_contacts.getTopPeers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_contacts.resetTopPeerRating' => 'Reset [rating](https://core.telegram.org/api/top-rating) of top peer',
+  'method_contacts.resetTopPeerRating_param_category_type_TopPeerCategory' => 'Top peer category',
+  'method_contacts.resetTopPeerRating_param_peer_type_InputPeer' => 'Peer whose rating should be reset',
+  'method_contacts.resetSaved' => 'Delete saved contacts',
+  'method_messages.getMessages' => 'Returns the list of messages by their IDs.',
   'method_messages.getMessages_param_id_type_Vector t' => 'The IDs of messages to fetch (only for users and normal groups)',
-  'method_messages.getDialogs' => 'Gets list of chats: you should use $MadelineProto->getDialogs() instead: https://docs.madelineproto.xyz/docs/DIALOGS.html',
-  'method_messages.getDialogs_param_exclude_pinned_type_true' => 'Do not fetch pinned chats',
-  'method_messages.getDialogs_param_offset_date_type_int' => 'End($res[\'messages\'])[\'date\'];',
-  'method_messages.getDialogs_param_offset_id_type_int' => 'End($res[\'messages\'])[\'id\'];',
-  'method_messages.getDialogs_param_offset_peer_type_InputPeer' => 'End($res[\'dialogs\'])[\'peer\'];',
-  'method_messages.getDialogs_param_limit_type_int' => 'Number of dialogs to fetch',
-  'method_messages.getHistory' => 'Get previous messages of a group',
-  'method_messages.getHistory_param_peer_type_InputPeer' => 'The chat',
-  'method_messages.getHistory_param_offset_id_type_int' => 'The last fetched message ID, initially 0',
-  'method_messages.getHistory_param_offset_date_type_int' => 'The date of the last previously fetched message, initially 0',
-  'method_messages.getHistory_param_add_offset_type_int' => 'Additional offset, can be 0',
-  'method_messages.getHistory_param_limit_type_int' => 'Number of messages to fetch',
-  'method_messages.getHistory_param_max_id_type_int' => 'Maximum message ID to fetch',
-  'method_messages.getHistory_param_min_id_type_int' => 'Minumum message ID to fetch',
-  'method_messages.getHistory_param_hash_type_int' => 'List of IDs of already parsed messages',
-  'method_messages.search' => 'Search peers or messages',
-  'method_messages.search_param_peer_type_InputPeer' => 'Where to search',
-  'method_messages.search_param_q_type_string' => 'What to search',
-  'method_messages.search_param_from_id_type_InputUser' => 'Show only messages from a certain user?',
-  'method_messages.search_param_filter_type_MessagesFilter' => 'Message filter',
-  'method_messages.search_param_min_date_type_int' => 'Minumum date of results to fetch',
-  'method_messages.search_param_max_date_type_int' => 'Maximum date of results to fetch',
-  'method_messages.search_param_offset_id_type_int' => 'Message ID offset',
-  'method_messages.search_param_add_offset_type_int' => 'Additional offset, can be 0',
-  'method_messages.search_param_limit_type_int' => 'Number of results to return',
-  'method_messages.search_param_max_id_type_int' => 'Maximum message id to return',
-  'method_messages.search_param_min_id_type_int' => 'Minumum message id to return',
-  'method_messages.readHistory' => 'Mark messages as read',
-  'method_messages.readHistory_param_peer_type_InputPeer' => 'Where to mark messages as read',
-  'method_messages.readHistory_param_max_id_type_int' => 'Maximum message ID to mark as read',
-  'method_messages.deleteHistory' => 'Delete chat history',
-  'method_messages.deleteHistory_param_just_clear_type_true' => 'Only clear it from your side',
-  'method_messages.deleteHistory_param_peer_type_InputPeer' => 'Where to clear it',
-  'method_messages.deleteHistory_param_max_id_type_int' => 'Maximum message id of messages to delete',
-  'method_messages.deleteMessages' => 'Delete messages',
-  'method_messages.deleteMessages_param_revoke_type_true' => 'Delete the messages for everyone?',
+  'method_messages.getDialogs' => 'Returns the current user dialog list.',
+  'method_messages.getDialogs_param_exclude_pinned_type_true' => 'Exclude pinned dialogs',
+  'method_messages.getDialogs_param_offset_date_type_int' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)',
+  'method_messages.getDialogs_param_offset_id_type_int' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)',
+  'method_messages.getDialogs_param_offset_peer_type_InputPeer' => '[Offset peer for pagination](https://core.telegram.org/api/offsets)',
+  'method_messages.getDialogs_param_limit_type_int' => 'Number of list elements to be returned',
+  'method_messages.getHistory' => 'Gets back the conversation history with one interlocutor / within a chat',
+  'method_messages.getHistory_param_peer_type_InputPeer' => 'Target peer',
+  'method_messages.getHistory_param_offset_id_type_int' => 'Only return messages starting from the specified message ID',
+  'method_messages.getHistory_param_offset_date_type_int' => 'Only return messages sent after the specified date',
+  'method_messages.getHistory_param_add_offset_type_int' => 'Number of list elements to be skipped, negative values are also accepted.',
+  'method_messages.getHistory_param_limit_type_int' => 'Number of results to return',
+  'method_messages.getHistory_param_max_id_type_int' => 'If a positive value was transferred, the method will return only messages with IDs less than **max\\_id**',
+  'method_messages.getHistory_param_min_id_type_int' => 'If a positive value was transferred, the method will return only messages with IDs more than **min\\_id**',
+  'method_messages.getHistory_param_hash_type_int' => '[Result hash](https://core.telegram.org/api/offsets)',
+  'method_messages.search' => 'Gets back found messages',
+  'method_messages.search_param_peer_type_InputPeer' => 'User or chat, histories with which are searched, or [(inputPeerEmpty)](../constructors/inputPeerEmpty.md) constructor for global search',
+  'method_messages.search_param_q_type_string' => 'Text search request',
+  'method_messages.search_param_from_id_type_InputUser' => 'Only return messages sent by the specified user ID',
+  'method_messages.search_param_filter_type_MessagesFilter' => 'Filter to return only specified message types',
+  'method_messages.search_param_min_date_type_int' => 'If a positive value was transferred, only messages with a sending date bigger than the transferred one will be returned',
+  'method_messages.search_param_max_date_type_int' => 'If a positive value was transferred, only messages with a sending date smaller than the transferred one will be returned',
+  'method_messages.search_param_offset_id_type_int' => 'Only return messages starting from the specified message ID',
+  'method_messages.search_param_add_offset_type_int' => '[Additional offset](https://core.telegram.org/api/offsets)',
+  'method_messages.search_param_limit_type_int' => '[Number of results to return](https://core.telegram.org/api/offsets)',
+  'method_messages.search_param_max_id_type_int' => '[Maximum message ID to return](https://core.telegram.org/api/offsets)',
+  'method_messages.search_param_min_id_type_int' => '[Minimum message ID to return](https://core.telegram.org/api/offsets)',
+  'method_messages.readHistory' => 'Marks message history as read.',
+  'method_messages.readHistory_param_peer_type_InputPeer' => 'Target user or group',
+  'method_messages.readHistory_param_max_id_type_int' => 'If a positive value is passed, only messages with identifiers less or equal than the given one will be read',
+  'method_messages.deleteHistory' => 'Deletes communication history.',
+  'method_messages.deleteHistory_param_just_clear_type_true' => 'Just clear history for the current user, without actually removing messages for every chat user',
+  'method_messages.deleteHistory_param_peer_type_InputPeer' => 'User or chat, communication history of which will be deleted',
+  'method_messages.deleteHistory_param_max_id_type_int' => 'Maximum ID of message to delete',
+  'method_messages.deleteMessages' => 'Deletes messages by their identifiers.',
+  'method_messages.deleteMessages_param_revoke_type_true' => 'Whether to delete messages for all participants of the chat',
   'method_messages.deleteMessages_param_id_type_Vector t' => 'IDs of messages to delete, use channels->deleteMessages for supergroups',
-  'method_messages.receivedMessages' => 'Mark messages as read',
-  'method_messages.receivedMessages_param_max_id_type_int' => 'Maximum message id of messages to mark as read',
-  'method_messages.setTyping' => 'Change typing status',
-  'method_messages.setTyping_param_peer_type_InputPeer' => 'Where to change typing status',
-  'method_messages.setTyping_param_action_type_SendMessageAction' => 'Typing status',
-  'method_messages.sendMessage' => 'Send a message',
-  'method_messages.sendMessage_param_no_webpage_type_true' => 'Disable webpage preview?',
-  'method_messages.sendMessage_param_silent_type_true' => 'Disable notifications?',
-  'method_messages.sendMessage_param_background_type_true' => 'Disable background notifications?',
-  'method_messages.sendMessage_param_clear_draft_type_true' => 'Clear the message draft of this chat?',
-  'method_messages.sendMessage_param_peer_type_InputPeer' => 'The chat where to send this message',
-  'method_messages.sendMessage_param_reply_to_msg_id_type_int' => 'Reply to message by ID',
-  'method_messages.sendMessage_param_message_type_string' => 'The message to send',
-  'method_messages.sendMessage_param_reply_markup_type_ReplyMarkup' => 'Keyboards to send',
+  'method_messages.receivedMessages' => 'Confirms receipt of messages by a client, cancels PUSH-notification sending.',
+  'method_messages.receivedMessages_param_max_id_type_int' => 'Maximum message ID available in a client.',
+  'method_messages.setTyping' => 'Sends a current user typing event (see [SendMessageAction](../types/SendMessageAction.md) for all event types) to a conversation partner or group.',
+  'method_messages.setTyping_param_peer_type_InputPeer' => 'Target user or group',
+  'method_messages.setTyping_param_action_type_SendMessageAction' => 'Type of action
Parameter added in [Layer 17](https://core.telegram.org/api/layers#layer-17).',
+  'method_messages.sendMessage' => 'Sends a message to a chat',
+  'method_messages.sendMessage_param_no_webpage_type_true' => 'Set this flag to disable generation of the webpage preview',
+  'method_messages.sendMessage_param_silent_type_true' => 'Send this message silently (no notifications for the receivers)',
+  'method_messages.sendMessage_param_background_type_true' => 'Send this message as background message',
+  'method_messages.sendMessage_param_clear_draft_type_true' => 'Clear the draft field',
+  'method_messages.sendMessage_param_peer_type_InputPeer' => 'The destination where the message will be sent',
+  'method_messages.sendMessage_param_reply_to_msg_id_type_int' => 'The message ID to which this message will reply to',
+  'method_messages.sendMessage_param_message_type_string' => 'The message',
+  'method_messages.sendMessage_param_reply_markup_type_ReplyMarkup' => 'Reply markup for sending bot buttons',
   'method_messages.sendMessage_param_entities_type_Vector t' => 'Entities to send (for styled text)',
   'method_messages.sendMedia' => 'Send a media',
-  'method_messages.sendMedia_param_silent_type_true' => 'Disable notifications?',
-  'method_messages.sendMedia_param_background_type_true' => 'Disable background notifications?',
-  'method_messages.sendMedia_param_clear_draft_type_true' => 'Clear the message draft of this chat?',
-  'method_messages.sendMedia_param_peer_type_InputPeer' => 'Where to send the media',
-  'method_messages.sendMedia_param_reply_to_msg_id_type_int' => 'Reply to message by ID',
-  'method_messages.sendMedia_param_media_type_InputMedia' => 'The media to send',
-  'method_messages.sendMedia_param_message_type_string' => 'The caption',
-  'method_messages.sendMedia_param_reply_markup_type_ReplyMarkup' => 'Keyboards to send',
+  'method_messages.sendMedia_param_silent_type_true' => 'Send message silently (no notification should be triggered)',
+  'method_messages.sendMedia_param_background_type_true' => 'Send message in background',
+  'method_messages.sendMedia_param_clear_draft_type_true' => 'Clear the draft',
+  'method_messages.sendMedia_param_peer_type_InputPeer' => 'Destination',
+  'method_messages.sendMedia_param_reply_to_msg_id_type_int' => 'Message ID to which this message should reply to',
+  'method_messages.sendMedia_param_media_type_InputMedia' => 'Attached media',
+  'method_messages.sendMedia_param_message_type_string' => 'Caption',
+  'method_messages.sendMedia_param_reply_markup_type_ReplyMarkup' => 'Reply markup for bot keyboards',
   'method_messages.sendMedia_param_entities_type_Vector t' => 'Entities for styled text',
-  'method_messages.forwardMessages' => 'Forward messages',
-  'method_messages.forwardMessages_param_silent_type_true' => 'Disable notifications',
-  'method_messages.forwardMessages_param_background_type_true' => 'Disable background notifications',
-  'method_messages.forwardMessages_param_with_my_score_type_true' => 'If forwarding a game, forward your score, too',
-  'method_messages.forwardMessages_param_grouped_type_true' => 'Set to true if forwarding albums',
-  'method_messages.forwardMessages_param_from_peer_type_InputPeer' => 'From where to forward the messages',
+  'method_messages.forwardMessages' => 'Forwards messages by their IDs.',
+  'method_messages.forwardMessages_param_silent_type_true' => 'Whether to send messages silently (no notification will be triggered on the destination clients)',
+  'method_messages.forwardMessages_param_background_type_true' => 'Whether to send the message in background',
+  'method_messages.forwardMessages_param_with_my_score_type_true' => 'When forwarding games, whether to include your score in the game',
+  'method_messages.forwardMessages_param_grouped_type_true' => 'Whether the specified messages represent an album (grouped media)',
+  'method_messages.forwardMessages_param_from_peer_type_InputPeer' => 'Source of messages',
   'method_messages.forwardMessages_param_id_type_Vector t' => 'The message IDs',
-  'method_messages.forwardMessages_param_to_peer_type_InputPeer' => 'Where to forward the messages',
-  'method_messages.reportSpam' => 'Report a peer for spam',
-  'method_messages.reportSpam_param_peer_type_InputPeer' => 'The peer to report',
+  'method_messages.forwardMessages_param_to_peer_type_InputPeer' => 'Destination peer',
+  'method_messages.reportSpam' => 'Report a new incoming chat for spam, if the [peer settings](../constructors/peerSettings.md) of the chat allow us to do that',
+  'method_messages.reportSpam_param_peer_type_InputPeer' => 'Peer to report',
   'method_messages.hideReportSpam' => 'Hide report spam popup',
   'method_messages.hideReportSpam_param_peer_type_InputPeer' => 'Where to hide the popup',
-  'method_messages.getPeerSettings' => 'Get the settings of  apeer',
+  'method_messages.getPeerSettings' => 'Get peer settings',
   'method_messages.getPeerSettings_param_peer_type_InputPeer' => 'The peer',
-  'method_messages.getChats' => 'Get info about chats',
+  'method_messages.getChats' => 'Returns chat basic info on their IDs.',
   'method_messages.getChats_param_id_type_Vector t' => 'The MTProto IDs of chats to fetch info about',
-  'method_messages.getFullChat' => 'You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)',
+  'method_messages.getFullChat' => 'Returns full chat info according to its ID.',
   'method_messages.getFullChat_param_chat_id_type_InputPeer' => 'You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)',
-  'method_messages.editChatTitle' => 'Edit the title of a normal chat (not supergroup)',
+  'method_messages.editChatTitle' => 'Chanages chat name and sends a service message on it.',
   'method_messages.editChatTitle_param_chat_id_type_InputPeer' => 'The ID of the chat',
-  'method_messages.editChatTitle_param_title_type_string' => 'The new title',
-  'method_messages.editChatPhoto' => 'Edit the photo of a normal chat (not supergroup)',
+  'method_messages.editChatTitle_param_title_type_string' => 'New chat name, different from the old one',
+  'method_messages.editChatPhoto' => 'Changes chat photo and sends a service message on it',
   'method_messages.editChatPhoto_param_chat_id_type_InputPeer' => 'The ID of the chat',
-  'method_messages.editChatPhoto_param_photo_type_InputChatPhoto' => 'The new phto',
-  'method_messages.addChatUser' => 'Add a user to a normal chat (use channels->inviteToChannel for supergroups)',
+  'method_messages.editChatPhoto_param_photo_type_InputChatPhoto' => 'Photo to be set',
+  'method_messages.addChatUser' => 'Adds a user to a chat and sends a service message on it.',
   'method_messages.addChatUser_param_chat_id_type_InputPeer' => 'The chat where to invite users',
-  'method_messages.addChatUser_param_user_id_type_InputUser' => 'The user to invite',
-  'method_messages.addChatUser_param_fwd_limit_type_int' => 'Number of old messages the user will see',
-  'method_messages.deleteChatUser' => 'Delete a user from a chat (not supergroup)',
+  'method_messages.addChatUser_param_user_id_type_InputUser' => 'User ID to be added',
+  'method_messages.addChatUser_param_fwd_limit_type_int' => 'Number of last messages to be forwarded',
+  'method_messages.deleteChatUser' => 'Deletes a user from a chat and sends a service message on it.',
   'method_messages.deleteChatUser_param_chat_id_type_InputPeer' => 'The ID of the chat',
-  'method_messages.deleteChatUser_param_user_id_type_InputUser' => 'The user to delete (pass @me to leave the chat)',
-  'method_messages.createChat' => 'Create a chat (not supergroup)',
+  'method_messages.deleteChatUser_param_user_id_type_InputUser' => 'User ID to be deleted',
+  'method_messages.createChat' => 'Creates a new chat.',
   'method_messages.createChat_param_users_type_Vector t' => 'The users to add to the chat',
-  'method_messages.createChat_param_title_type_string' => 'The new chat\'s title',
-  'method_messages.getDhConfig' => 'You cannot use this method directly, instead use $MadelineProto->getDhConfig();',
-  'method_messages.getDhConfig_param_version_type_int' => 'You cannot use this method directly, instead use $MadelineProto->getDhConfig();',
-  'method_messages.getDhConfig_param_random_length_type_int' => 'You cannot use this method directly, instead use $MadelineProto->getDhConfig();',
-  'method_messages.requestEncryption' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats',
-  'method_messages.requestEncryption_param_user_id_type_InputUser' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats',
-  'method_messages.requestEncryption_param_g_a_type_bytes' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats',
-  'method_messages.acceptEncryption' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats',
-  'method_messages.acceptEncryption_param_peer_type_InputEncryptedChat' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats',
-  'method_messages.acceptEncryption_param_g_b_type_bytes' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats',
-  'method_messages.acceptEncryption_param_key_fingerprint_type_long' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats',
-  'method_messages.discardEncryption' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats',
-  'method_messages.discardEncryption_param_chat_id_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling secret chats',
-  'method_messages.setEncryptedTyping' => 'Send typing notification to secret chat',
-  'method_messages.setEncryptedTyping_param_peer_type_InputEncryptedChat' => 'The secret chat where to send the notification',
-  'method_messages.setEncryptedTyping_param_typing_type_Bool' => 'Set to true to enable the notification, false to disable it',
-  'method_messages.readEncryptedHistory' => 'Mark messages as read in secret chats',
-  'method_messages.readEncryptedHistory_param_peer_type_InputEncryptedChat' => 'The secret chat where to mark messages as read',
-  'method_messages.readEncryptedHistory_param_max_date_type_int' => 'Maximum date of messages to mark',
-  'method_messages.sendEncrypted' => 'Send message to secret chat',
-  'method_messages.sendEncrypted_param_peer_type_InputEncryptedChat' => 'The chat where to send the message',
+  'method_messages.createChat_param_title_type_string' => 'Chat name',
+  'method_messages.getDhConfig' => 'Returns configuration parameters for Diffie-Hellman key generation. Can also return a random sequence of bytes of required length.',
+  'method_messages.getDhConfig_param_version_type_int' => 'Value of the **version** parameter from [messages.dhConfig](../constructors/messages.dhConfig.md), avialable at the client',
+  'method_messages.getDhConfig_param_random_length_type_int' => 'Length of the required random sequence',
+  'method_messages.requestEncryption' => 'Sends a request to start a secret chat to the user.',
+  'method_messages.requestEncryption_param_user_id_type_InputUser' => 'User ID',
+  'method_messages.requestEncryption_param_g_a_type_bytes' => '`A = g ^ a mod p`, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange)',
+  'method_messages.acceptEncryption' => 'Confirms creation of a secret chat',
+  'method_messages.acceptEncryption_param_peer_type_InputEncryptedChat' => 'Secret chat ID',
+  'method_messages.acceptEncryption_param_g_b_type_bytes' => '`B = g ^ b mod p`, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange)',
+  'method_messages.acceptEncryption_param_key_fingerprint_type_long' => '64-bit fingerprint of the received key',
+  'method_messages.discardEncryption' => 'Cancels a request for creation and/or delete info on secret chat.',
+  'method_messages.discardEncryption_param_chat_id_type_int' => 'Secret chat ID',
+  'method_messages.setEncryptedTyping' => 'Send typing event by the current user to a secret chat.',
+  'method_messages.setEncryptedTyping_param_peer_type_InputEncryptedChat' => 'Secret chat ID',
+  'method_messages.setEncryptedTyping_param_typing_type_Bool' => 'Typing.
**Possible values**:
[(boolTrue)](../constructors/boolTrue.md), if the user started typing and more than **5 seconds** have passed since the last request
[(boolFalse)](../constructors/boolFalse.md), if the user stopped typing',
+  'method_messages.readEncryptedHistory' => 'Marks message history within a secret chat as read.',
+  'method_messages.readEncryptedHistory_param_peer_type_InputEncryptedChat' => 'Secret chat ID',
+  'method_messages.readEncryptedHistory_param_max_date_type_int' => 'Maximum date value for received messages in history',
+  'method_messages.sendEncrypted' => 'Sends a text message to a secret chat.',
+  'method_messages.sendEncrypted_param_peer_type_InputEncryptedChat' => 'Secret chat ID',
   'method_messages.sendEncrypted_param_message_type_DecryptedMessage' => 'The message to send',
-  'method_messages.sendEncryptedFile' => 'Send a file to a secret chat',
-  'method_messages.sendEncryptedFile_param_peer_type_InputEncryptedChat' => 'The chat where to send the file',
+  'method_messages.sendEncryptedFile' => 'Sends a message with a file attachment to a secret chat',
+  'method_messages.sendEncryptedFile_param_peer_type_InputEncryptedChat' => 'Secret chat ID',
   'method_messages.sendEncryptedFile_param_message_type_DecryptedMessage' => 'The message with the file',
-  'method_messages.sendEncryptedFile_param_file_type_InputEncryptedFile' => 'The file (optional)',
-  'method_messages.sendEncryptedService' => 'Send a service message to a secret chat',
-  'method_messages.sendEncryptedService_param_peer_type_InputEncryptedChat' => 'The chat where to send the service message',
+  'method_messages.sendEncryptedFile_param_file_type_InputEncryptedFile' => 'File attachment for the secret chat',
+  'method_messages.sendEncryptedService' => 'Sends a service message to a secret chat.',
+  'method_messages.sendEncryptedService_param_peer_type_InputEncryptedChat' => 'Secret chat ID',
   'method_messages.sendEncryptedService_param_message_type_DecryptedMessage' => 'The service message',
-  'method_messages.receivedQueue' => 'You cannot use this method directly',
-  'method_messages.receivedQueue_param_max_qts_type_int' => 'You cannot use this method directly',
-  'method_messages.reportEncryptedSpam' => 'Report for spam a secret chat',
-  'method_messages.reportEncryptedSpam_param_peer_type_InputEncryptedChat' => 'The chat to report',
-  'method_messages.readMessageContents' => 'Mark message as read',
+  'method_messages.receivedQueue' => 'Confirms receipt of messages in a secret chat by client, cancels push notifications.',
+  'method_messages.receivedQueue_param_max_qts_type_int' => 'Maximum qts value available at the client',
+  'method_messages.reportEncryptedSpam' => 'Report a secret chat for spam',
+  'method_messages.reportEncryptedSpam_param_peer_type_InputEncryptedChat' => 'The secret chat to report',
+  'method_messages.readMessageContents' => 'Notifies the sender about the recipient having listened a voice message or watched a video.',
   'method_messages.readMessageContents_param_id_type_Vector t' => 'The messages to mark as read (only users and normal chats, not supergroups)',
-  'method_messages.getStickers' => 'Get stickers',
-  'method_messages.getStickers_param_emoticon_type_string' => 'Search by emoji',
+  'method_messages.getStickers' => 'Get stickers by emoji',
+  'method_messages.getStickers_param_emoticon_type_string' => 'The emoji',
   'method_messages.getStickers_param_hash_type_string' => 'Previously fetched sticker IDs',
-  'method_messages.getAllStickers' => 'Get all stickerpacks',
-  'method_messages.getAllStickers_param_hash_type_int' => '0 or $result[\'hash\']',
-  'method_messages.getWebPagePreview' => 'Get webpage preview',
-  'method_messages.getWebPagePreview_param_message_type_string' => 'Extract preview from this message',
+  'method_messages.getAllStickers' => 'Get all installed stickers',
+  'method_messages.getAllStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_messages.getWebPagePreview' => 'Get preview of webpage',
+  'method_messages.getWebPagePreview_param_message_type_string' => 'Message from which to extract the preview',
   'method_messages.getWebPagePreview_param_entities_type_Vector t' => 'Entities for styled text',
-  'method_messages.exportChatInvite' => 'Export chat invite ',
+  'method_messages.exportChatInvite' => 'Export an invite link for a chat',
   'method_messages.exportChatInvite_param_chat_id_type_InputPeer' => 'The chat id ',
-  'method_messages.checkChatInvite' => 'Check if an invitation link is valid',
-  'method_messages.checkChatInvite_param_hash_type_string' => 'The invite link in t.me/joinchat/aflakf format',
-  'method_messages.importChatInvite' => 'Import chat invite',
-  'method_messages.importChatInvite_param_hash_type_string' => 'The invite link in t.me/joinchat/aflakf format',
-  'method_messages.getStickerSet' => 'Get a stickerset',
-  'method_messages.getStickerSet_param_stickerset_type_InputStickerSet' => 'The stickerset to get',
-  'method_messages.installStickerSet' => 'Add a sticker set',
-  'method_messages.installStickerSet_param_stickerset_type_InputStickerSet' => 'The sticker set to add',
-  'method_messages.installStickerSet_param_archived_type_Bool' => 'Archive this set?',
-  'method_messages.uninstallStickerSet' => 'Remove a sticker set',
-  'method_messages.uninstallStickerSet_param_stickerset_type_InputStickerSet' => 'The sticker set to remove',
-  'method_messages.startBot' => 'Start a bot',
-  'method_messages.startBot_param_bot_type_InputUser' => 'The bot\'s ID or username',
-  'method_messages.startBot_param_peer_type_InputPeer' => 'Where to start the bot (@me or group ID/username)',
-  'method_messages.startBot_param_start_param_type_string' => 'The bot\'s start parameter',
-  'method_messages.getMessagesViews' => 'Get and increase message views',
-  'method_messages.getMessagesViews_param_peer_type_InputPeer' => 'The chat where the message is located',
+  'method_messages.checkChatInvite' => 'Check the validity of a chat invite link and get basic info about it',
+  'method_messages.checkChatInvite_param_hash_type_string' => 'Invite hash in `t.me/joinchat/hash`',
+  'method_messages.importChatInvite' => 'Import a chat invite and join a private chat/supergroup/channel',
+  'method_messages.importChatInvite_param_hash_type_string' => '`hash` from `t.me/joinchat/hash`',
+  'method_messages.getStickerSet' => 'Get info about a stickerset',
+  'method_messages.getStickerSet_param_stickerset_type_InputStickerSet' => 'Stickerset',
+  'method_messages.installStickerSet' => 'Install a stickerset',
+  'method_messages.installStickerSet_param_stickerset_type_InputStickerSet' => 'Stickerset to install',
+  'method_messages.installStickerSet_param_archived_type_Bool' => 'Whether to archive stickerset',
+  'method_messages.uninstallStickerSet' => 'Uninstall a stickerset',
+  'method_messages.uninstallStickerSet_param_stickerset_type_InputStickerSet' => 'The stickerset to uninstall',
+  'method_messages.startBot' => 'Start a conversation with a bot using a [deep linking parameter](https://core.telegram.org/bots#deep-linking)',
+  'method_messages.startBot_param_bot_type_InputUser' => 'The bot',
+  'method_messages.startBot_param_peer_type_InputPeer' => 'The chat where to start the bot, can be the bot\'s private chat or a group',
+  'method_messages.startBot_param_start_param_type_string' => '[Deep linking parameter](https://core.telegram.org/bots#deep-linking)',
+  'method_messages.getMessagesViews' => 'Get and increase the view counter of a message sent or forwarded from a [channel](https://core.telegram.org/api/channel)',
+  'method_messages.getMessagesViews_param_peer_type_InputPeer' => 'Peer where the message was found',
   'method_messages.getMessagesViews_param_id_type_Vector t' => 'The IDs messages to get',
-  'method_messages.getMessagesViews_param_increment_type_Bool' => 'Increase message views?',
+  'method_messages.getMessagesViews_param_increment_type_Bool' => 'Whether to mark the message as viewed and increment the view counter',
   'method_messages.toggleChatAdmins' => 'Enable all users are admins in normal groups (not supergroups)',
   'method_messages.toggleChatAdmins_param_chat_id_type_InputPeer' => 'Group ID',
   'method_messages.toggleChatAdmins_param_enabled_type_Bool' => 'Enable all users are admins',
-  'method_messages.editChatAdmin' => 'Edit admin permissions',
+  'method_messages.editChatAdmin' => 'Make a user admin in a [legacy group](https://core.telegram.org/api/channel).',
   'method_messages.editChatAdmin_param_chat_id_type_InputPeer' => 'The chat ID (no supergroups)',
-  'method_messages.editChatAdmin_param_user_id_type_InputUser' => 'The user ID',
-  'method_messages.editChatAdmin_param_is_admin_type_Bool' => 'Should the user be admin?',
-  'method_messages.migrateChat' => 'Convert chat to supergroup',
+  'method_messages.editChatAdmin_param_user_id_type_InputUser' => 'The user to make admin',
+  'method_messages.editChatAdmin_param_is_admin_type_Bool' => 'Whether to make him admin',
+  'method_messages.migrateChat' => 'Turn a [legacy group into a supergroup](https://core.telegram.org/api/channel)',
   'method_messages.migrateChat_param_chat_id_type_InputPeer' => 'The chat to convert',
-  'method_messages.searchGlobal' => 'Global message search',
-  'method_messages.searchGlobal_param_q_type_string' => 'The query',
+  'method_messages.searchGlobal' => 'Search for messages and peers globally',
+  'method_messages.searchGlobal_param_q_type_string' => 'Query',
   'method_messages.searchGlobal_param_offset_date_type_int' => '0 or the date offset',
-  'method_messages.searchGlobal_param_offset_peer_type_InputPeer' => '0 or the peer offset',
-  'method_messages.searchGlobal_param_offset_id_type_int' => '0 or the message ID offset',
-  'method_messages.searchGlobal_param_limit_type_int' => 'The number of results to return',
-  'method_messages.reorderStickerSets' => 'Reorder sticker sets',
-  'method_messages.reorderStickerSets_param_masks_type_true' => 'Reorder masks?',
+  'method_messages.searchGlobal_param_offset_peer_type_InputPeer' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)',
+  'method_messages.searchGlobal_param_offset_id_type_int' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)',
+  'method_messages.searchGlobal_param_limit_type_int' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)',
+  'method_messages.reorderStickerSets' => 'Reorder installed stickersets',
+  'method_messages.reorderStickerSets_param_masks_type_true' => 'Reorder mask stickersets',
   'method_messages.reorderStickerSets_param_order_type_Vector t' => 'The order',
-  'method_messages.getDocumentByHash' => 'Get document by SHA256 hash',
-  'method_messages.getDocumentByHash_param_sha256_type_bytes' => '`hash(\'sha256\', $filename, true);`',
-  'method_messages.getDocumentByHash_param_size_type_int' => 'The file size',
-  'method_messages.getDocumentByHash_param_mime_type_type_string' => 'The mime type of the file',
-  'method_messages.searchGifs' => 'Search gifs',
-  'method_messages.searchGifs_param_q_type_string' => 'The search query',
-  'method_messages.searchGifs_param_offset_type_int' => 'The offset ',
-  'method_messages.getSavedGifs' => 'Get saved gifs',
-  'method_messages.getSavedGifs_param_hash_type_int' => '0 or $result[\'hash\']',
-  'method_messages.saveGif' => 'Save a GIF',
-  'method_messages.saveGif_param_id_type_InputDocument' => 'The GIF to save',
-  'method_messages.saveGif_param_unsave_type_Bool' => 'Remove the gif?',
-  'method_messages.getInlineBotResults' => 'Call inline bot',
-  'method_messages.getInlineBotResults_param_bot_type_InputUser' => 'The bot to call',
-  'method_messages.getInlineBotResults_param_peer_type_InputPeer' => 'The chat where to call the bot',
-  'method_messages.getInlineBotResults_param_geo_point_type_InputGeoPoint' => 'The current location',
-  'method_messages.getInlineBotResults_param_query_type_string' => 'The query to send to the bot',
-  'method_messages.getInlineBotResults_param_offset_type_string' => 'The offset to send to the bot',
-  'method_messages.setInlineBotResults' => 'Bots only: set the results of an inline query',
-  'method_messages.setInlineBotResults_param_gallery_type_true' => 'Is this a gallery?',
-  'method_messages.setInlineBotResults_param_private_type_true' => 'Is this result private (not cached)?',
-  'method_messages.setInlineBotResults_param_query_id_type_long' => 'Query ID',
+  'method_messages.getDocumentByHash' => 'Get a document by its SHA256 hash, mainly used for gifs',
+  'method_messages.getDocumentByHash_param_sha256_type_bytes' => 'SHA256 of file',
+  'method_messages.getDocumentByHash_param_size_type_int' => 'Size of the file in bytes',
+  'method_messages.getDocumentByHash_param_mime_type_type_string' => 'Mime type',
+  'method_messages.searchGifs' => 'Search for GIFs',
+  'method_messages.searchGifs_param_q_type_string' => 'Text query',
+  'method_messages.searchGifs_param_offset_type_int' => 'Offset for [pagination »](https://core.telegram.org/api/offsets)',
+  'method_messages.getSavedGifs' => 'Get saved GIFs',
+  'method_messages.getSavedGifs_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_messages.saveGif' => 'Add GIF to saved gifs list',
+  'method_messages.saveGif_param_id_type_InputDocument' => 'GIF to save',
+  'method_messages.saveGif_param_unsave_type_Bool' => 'Whether to remove GIF from saved gifs list',
+  'method_messages.getInlineBotResults' => 'Query an inline bot',
+  'method_messages.getInlineBotResults_param_bot_type_InputUser' => 'The bot to query',
+  'method_messages.getInlineBotResults_param_peer_type_InputPeer' => 'The currently opened chat',
+  'method_messages.getInlineBotResults_param_geo_point_type_InputGeoPoint' => 'The geolocation, if requested',
+  'method_messages.getInlineBotResults_param_query_type_string' => 'The query',
+  'method_messages.getInlineBotResults_param_offset_type_string' => 'The offset within the results, will be passed directly as-is to the bot.',
+  'method_messages.setInlineBotResults' => 'Answer an inline query, for bots only',
+  'method_messages.setInlineBotResults_param_gallery_type_true' => 'Set this flag if the results are composed of media files',
+  'method_messages.setInlineBotResults_param_private_type_true' => 'Set this flag if results may be cached on the server side only for the user that sent the query. By default, results may be returned to any user who sends the same query',
+  'method_messages.setInlineBotResults_param_query_id_type_long' => 'Unique identifier for the answered query',
   'method_messages.setInlineBotResults_param_results_type_Vector t' => 'Results',
-  'method_messages.setInlineBotResults_param_cache_time_type_int' => 'Cache time',
-  'method_messages.setInlineBotResults_param_next_offset_type_string' => 'The next offset',
-  'method_messages.setInlineBotResults_param_switch_pm_type_InlineBotSwitchPM' => 'Switch to PM?',
-  'method_messages.sendInlineBotResult' => 'Send inline bot result obtained with messages.getInlineBotResults to the chat',
-  'method_messages.sendInlineBotResult_param_silent_type_true' => 'Disable notifications?',
-  'method_messages.sendInlineBotResult_param_background_type_true' => 'Disable background notifications?',
-  'method_messages.sendInlineBotResult_param_clear_draft_type_true' => 'Clear the message draft?',
-  'method_messages.sendInlineBotResult_param_peer_type_InputPeer' => 'Where to send the message',
-  'method_messages.sendInlineBotResult_param_reply_to_msg_id_type_int' => 'Reply to message by ID',
-  'method_messages.sendInlineBotResult_param_query_id_type_long' => 'The inline query ID',
-  'method_messages.sendInlineBotResult_param_id_type_string' => 'The ID of one of the inline results',
-  'method_messages.getMessageEditData' => 'Check if about to edit a message or a media caption',
-  'method_messages.getMessageEditData_param_peer_type_InputPeer' => 'The chat',
-  'method_messages.getMessageEditData_param_id_type_int' => 'The message ID',
-  'method_messages.editMessage' => 'Edit a message',
+  'method_messages.setInlineBotResults_param_cache_time_type_int' => 'The maximum amount of time in seconds that the result of the inline query may be cached on the server. Defaults to 300.',
+  'method_messages.setInlineBotResults_param_next_offset_type_string' => 'Pass the offset that a client should send in the next query with the same text to receive more results. Pass an empty string if there are no more results or if you don‘t support pagination. Offset length can’t exceed 64 bytes.',
+  'method_messages.setInlineBotResults_param_switch_pm_type_InlineBotSwitchPM' => 'If passed, clients will display a button with specified text that switches the user to a private chat with the bot and sends the bot a start message with a certain parameter.',
+  'method_messages.sendInlineBotResult' => 'Send a result obtained using [messages.getInlineBotResults](../methods/messages.getInlineBotResults.md).',
+  'method_messages.sendInlineBotResult_param_silent_type_true' => 'Whether to send the message silently (no notification will be triggered on the other client)',
+  'method_messages.sendInlineBotResult_param_background_type_true' => 'Whether to send the message in background',
+  'method_messages.sendInlineBotResult_param_clear_draft_type_true' => 'Whether to clear the [draft](https://core.telegram.org/api/drafts)',
+  'method_messages.sendInlineBotResult_param_peer_type_InputPeer' => 'Destination',
+  'method_messages.sendInlineBotResult_param_reply_to_msg_id_type_int' => 'ID of the message this message should reply to',
+  'method_messages.sendInlineBotResult_param_query_id_type_long' => 'Query ID from [messages.getInlineBotResults](../methods/messages.getInlineBotResults.md)',
+  'method_messages.sendInlineBotResult_param_id_type_string' => 'Result ID from [messages.getInlineBotResults](../methods/messages.getInlineBotResults.md)',
+  'method_messages.getMessageEditData' => 'Find out if a media message\'s caption can be edited',
+  'method_messages.getMessageEditData_param_peer_type_InputPeer' => 'Peer where the media was sent',
+  'method_messages.getMessageEditData_param_id_type_int' => 'ID of message',
+  'method_messages.editMessage' => 'Edit message',
   'method_messages.editMessage_param_no_webpage_type_true' => 'Disable webpage preview',
   'method_messages.editMessage_param_stop_geo_live_type_true' => 'Stop live location',
-  'method_messages.editMessage_param_peer_type_InputPeer' => 'The chat',
-  'method_messages.editMessage_param_id_type_int' => 'The message ID',
-  'method_messages.editMessage_param_message_type_string' => 'The new message',
-  'method_messages.editMessage_param_reply_markup_type_ReplyMarkup' => 'The new keyboard',
+  'method_messages.editMessage_param_peer_type_InputPeer' => 'Where was the message sent',
+  'method_messages.editMessage_param_id_type_int' => 'ID of the message to edit',
+  'method_messages.editMessage_param_message_type_string' => 'New message',
+  'method_messages.editMessage_param_reply_markup_type_ReplyMarkup' => 'Reply markup for inline keyboards',
   'method_messages.editMessage_param_entities_type_Vector t' => 'The new entities (for styled text)',
   'method_messages.editMessage_param_geo_point_type_InputGeoPoint' => 'The new location',
-  'method_messages.editInlineBotMessage' => 'Edit a sent inline message',
+  'method_messages.editInlineBotMessage' => 'Edit an inline bot message',
   'method_messages.editInlineBotMessage_param_no_webpage_type_true' => 'Disable webpage preview',
   'method_messages.editInlineBotMessage_param_stop_geo_live_type_true' => 'Stop live location',
-  'method_messages.editInlineBotMessage_param_id_type_InputBotInlineMessageID' => 'The message ID',
-  'method_messages.editInlineBotMessage_param_message_type_string' => 'The new message',
-  'method_messages.editInlineBotMessage_param_reply_markup_type_ReplyMarkup' => 'The new keyboard',
+  'method_messages.editInlineBotMessage_param_id_type_InputBotInlineMessageID' => 'Sent inline message ID',
+  'method_messages.editInlineBotMessage_param_message_type_string' => 'Message',
+  'method_messages.editInlineBotMessage_param_reply_markup_type_ReplyMarkup' => 'Reply markup for inline keyboards',
   'method_messages.editInlineBotMessage_param_entities_type_Vector t' => 'The new entities (for styled text)',
   'method_messages.editInlineBotMessage_param_geo_point_type_InputGeoPoint' => 'The new location',
-  'method_messages.getBotCallbackAnswer' => 'Get the callback answer of a bot (after clicking a button)',
-  'method_messages.getBotCallbackAnswer_param_game_type_true' => 'Is this a game?',
-  'method_messages.getBotCallbackAnswer_param_peer_type_InputPeer' => 'The chat',
-  'method_messages.getBotCallbackAnswer_param_msg_id_type_int' => 'The message ID',
-  'method_messages.getBotCallbackAnswer_param_data_type_bytes' => 'The data to send to the bot',
-  'method_messages.setBotCallbackAnswer' => 'Bots only: set the callback answer (after a button was clicked)',
-  'method_messages.setBotCallbackAnswer_param_alert_type_true' => 'Is this an alert?',
-  'method_messages.setBotCallbackAnswer_param_query_id_type_long' => 'The query ID',
-  'method_messages.setBotCallbackAnswer_param_message_type_string' => 'The message',
-  'method_messages.setBotCallbackAnswer_param_url_type_string' => 'The URL',
-  'method_messages.setBotCallbackAnswer_param_cache_time_type_int' => 'Cache time',
-  'method_messages.getPeerDialogs' => 'Get dialog info of peers',
+  'method_messages.getBotCallbackAnswer' => 'Press an inline callback button and get a callback answer from the bot',
+  'method_messages.getBotCallbackAnswer_param_game_type_true' => 'Whether this is a "play game" button',
+  'method_messages.getBotCallbackAnswer_param_peer_type_InputPeer' => 'Where was the inline keyboard sent',
+  'method_messages.getBotCallbackAnswer_param_msg_id_type_int' => 'ID of the Message with the inline keyboard',
+  'method_messages.getBotCallbackAnswer_param_data_type_bytes' => 'Callback data',
+  'method_messages.setBotCallbackAnswer' => 'Set the callback answer to a user button press (bots only)',
+  'method_messages.setBotCallbackAnswer_param_alert_type_true' => 'Whether to show the message as a popup instead of a toast notification',
+  'method_messages.setBotCallbackAnswer_param_query_id_type_long' => 'Query ID',
+  'method_messages.setBotCallbackAnswer_param_message_type_string' => 'Popup to show',
+  'method_messages.setBotCallbackAnswer_param_url_type_string' => 'URL to open',
+  'method_messages.setBotCallbackAnswer_param_cache_time_type_int' => 'Cache validity',
+  'method_messages.getPeerDialogs' => 'Get dialog info of specified peers',
   'method_messages.getPeerDialogs_param_peers_type_Vector t' => 'The peers',
-  'method_messages.saveDraft' => 'Save a message draft',
-  'method_messages.saveDraft_param_no_webpage_type_true' => 'Disable webpage preview',
-  'method_messages.saveDraft_param_reply_to_msg_id_type_int' => 'Reply to message by ID',
-  'method_messages.saveDraft_param_peer_type_InputPeer' => 'The chat',
-  'method_messages.saveDraft_param_message_type_string' => 'The message',
+  'method_messages.saveDraft' => 'Save a message [draft](https://core.telegram.org/api/drafts) associated to a chat.',
+  'method_messages.saveDraft_param_no_webpage_type_true' => 'Disable generation of the webpage preview',
+  'method_messages.saveDraft_param_reply_to_msg_id_type_int' => 'Message ID the message should reply to',
+  'method_messages.saveDraft_param_peer_type_InputPeer' => 'Destination of the message that should be sent',
+  'method_messages.saveDraft_param_message_type_string' => 'The draft',
   'method_messages.saveDraft_param_entities_type_Vector t' => 'The entities (for styled text)',
-  'method_messages.getAllDrafts' => 'Get all message drafts',
+  'method_messages.getAllDrafts' => 'Save get all message [drafts](https://core.telegram.org/api/drafts).',
   'method_messages.getFeaturedStickers' => 'Get featured stickers',
-  'method_messages.getFeaturedStickers_param_hash_type_int' => '0 or $result[\'hash\']',
+  'method_messages.getFeaturedStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
   'method_messages.readFeaturedStickers' => 'Mark new featured stickers as read',
   'method_messages.readFeaturedStickers_param_id_type_Vector t' => 'The stickers to mark as read',
   'method_messages.getRecentStickers' => 'Get recent stickers',
-  'method_messages.getRecentStickers_param_attached_type_true' => 'Get stickers attached to image?',
-  'method_messages.getRecentStickers_param_hash_type_int' => '0 or $result[\'hash\']',
-  'method_messages.saveRecentSticker' => 'Add a sticker to recent stickers',
-  'method_messages.saveRecentSticker_param_attached_type_true' => 'Get stickers attached to image?',
-  'method_messages.saveRecentSticker_param_id_type_InputDocument' => 'The sticker',
-  'method_messages.saveRecentSticker_param_unsave_type_Bool' => 'Remove the sticker from recent stickers?',
-  'method_messages.clearRecentStickers' => 'Clear all recent stickers',
-  'method_messages.clearRecentStickers_param_attached_type_true' => 'Clear recent stickers attached to images?',
+  'method_messages.getRecentStickers_param_attached_type_true' => 'Get stickers recently attached to photo or video files',
+  'method_messages.getRecentStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_messages.saveRecentSticker' => 'Add/remove sticker from recent stickers list',
+  'method_messages.saveRecentSticker_param_attached_type_true' => 'Whether to add/remove stickers recently attached to photo or video files',
+  'method_messages.saveRecentSticker_param_id_type_InputDocument' => 'Sticker',
+  'method_messages.saveRecentSticker_param_unsave_type_Bool' => 'Whether to save or unsave the sticker',
+  'method_messages.clearRecentStickers' => 'Clear recent stickers',
+  'method_messages.clearRecentStickers_param_attached_type_true' => 'Set this flag to clear the list of stickers recently attached to photo or video files',
   'method_messages.getArchivedStickers' => 'Get all archived stickers',
-  'method_messages.getArchivedStickers_param_masks_type_true' => 'Get masks?',
-  'method_messages.getArchivedStickers_param_offset_id_type_long' => 'Sticker ID offset',
-  'method_messages.getArchivedStickers_param_limit_type_int' => 'Number of stickers to fetch',
-  'method_messages.getMaskStickers' => 'Get masks',
-  'method_messages.getMaskStickers_param_hash_type_int' => '0 or $result[\'hash\']',
-  'method_messages.getAttachedStickers' => 'Get stickers attachable to images',
-  'method_messages.getAttachedStickers_param_media_type_InputStickeredMedia' => 'The stickered media',
-  'method_messages.setGameScore' => 'Set the game score',
-  'method_messages.setGameScore_param_edit_message_type_true' => 'Should the message with the game be edited?',
-  'method_messages.setGameScore_param_force_type_true' => 'Force setting the game score',
-  'method_messages.setGameScore_param_peer_type_InputPeer' => 'The chat where the game was sent',
-  'method_messages.setGameScore_param_id_type_int' => 'The message ID',
-  'method_messages.setGameScore_param_user_id_type_InputUser' => 'The user that set the score',
-  'method_messages.setGameScore_param_score_type_int' => 'The score',
-  'method_messages.setInlineGameScore' => 'Set the game score of an inline message',
-  'method_messages.setInlineGameScore_param_edit_message_type_true' => 'Should the message with the game be edited?',
-  'method_messages.setInlineGameScore_param_force_type_true' => 'Force setting the game score',
-  'method_messages.setInlineGameScore_param_id_type_InputBotInlineMessageID' => 'The ID of the inline message',
-  'method_messages.setInlineGameScore_param_user_id_type_InputUser' => 'The user that set the score',
-  'method_messages.setInlineGameScore_param_score_type_int' => 'The score',
-  'method_messages.getGameHighScores' => 'Get high scores of a game',
-  'method_messages.getGameHighScores_param_peer_type_InputPeer' => 'The chat',
-  'method_messages.getGameHighScores_param_id_type_int' => 'The message ID',
-  'method_messages.getGameHighScores_param_user_id_type_InputUser' => 'The user that set the high scores',
-  'method_messages.getInlineGameHighScores' => 'Get high scores of a game sent in an inline message',
-  'method_messages.getInlineGameHighScores_param_id_type_InputBotInlineMessageID' => 'The inline message',
-  'method_messages.getInlineGameHighScores_param_user_id_type_InputUser' => 'The user that set the high scores',
+  'method_messages.getArchivedStickers_param_masks_type_true' => 'Get mask stickers',
+  'method_messages.getArchivedStickers_param_offset_id_type_long' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)',
+  'method_messages.getArchivedStickers_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)',
+  'method_messages.getMaskStickers' => 'Get installed mask stickers',
+  'method_messages.getMaskStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_messages.getAttachedStickers' => 'Get stickers attached to a photo or video',
+  'method_messages.getAttachedStickers_param_media_type_InputStickeredMedia' => 'Stickered media',
+  'method_messages.setGameScore' => 'Use this method to set the score of the specified user in a game sent as a normal message (bots only).',
+  'method_messages.setGameScore_param_edit_message_type_true' => 'Set this flag if the game message should be automatically edited to include the current scoreboard',
+  'method_messages.setGameScore_param_force_type_true' => 'Set this flag if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters',
+  'method_messages.setGameScore_param_peer_type_InputPeer' => 'Unique identifier of target chat',
+  'method_messages.setGameScore_param_id_type_int' => 'Identifier of the sent message',
+  'method_messages.setGameScore_param_user_id_type_InputUser' => 'User identifier',
+  'method_messages.setGameScore_param_score_type_int' => 'New score',
+  'method_messages.setInlineGameScore' => 'Use this method to set the score of the specified user in a game sent as an inline message (bots only).',
+  'method_messages.setInlineGameScore_param_edit_message_type_true' => 'Set this flag if the game message should be automatically edited to include the current scoreboard',
+  'method_messages.setInlineGameScore_param_force_type_true' => 'Set this flag if the high score is allowed to decrease. This can be useful when fixing mistakes or banning cheaters',
+  'method_messages.setInlineGameScore_param_id_type_InputBotInlineMessageID' => 'ID of the inline message',
+  'method_messages.setInlineGameScore_param_user_id_type_InputUser' => 'User identifier',
+  'method_messages.setInlineGameScore_param_score_type_int' => 'New score',
+  'method_messages.getGameHighScores' => 'Get highscores of a game',
+  'method_messages.getGameHighScores_param_peer_type_InputPeer' => 'Where was the game sent',
+  'method_messages.getGameHighScores_param_id_type_int' => 'ID of message with game media attachment',
+  'method_messages.getGameHighScores_param_user_id_type_InputUser' => 'Get high scores made by a certain user',
+  'method_messages.getInlineGameHighScores' => 'Get highscores of a game sent using an inline bot',
+  'method_messages.getInlineGameHighScores_param_id_type_InputBotInlineMessageID' => 'ID of inline message',
+  'method_messages.getInlineGameHighScores_param_user_id_type_InputUser' => 'Get high scores of a certain user',
   'method_messages.getCommonChats' => 'Get chats in common with a user',
-  'method_messages.getCommonChats_param_user_id_type_InputUser' => 'The user',
-  'method_messages.getCommonChats_param_max_id_type_int' => 'The maximum chat ID to fetch',
-  'method_messages.getCommonChats_param_limit_type_int' => 'Number of results to fetch',
-  'method_messages.getAllChats' => 'Get all chats (not supergroups or channels)',
+  'method_messages.getCommonChats_param_user_id_type_InputUser' => 'User ID',
+  'method_messages.getCommonChats_param_max_id_type_int' => 'Maximum ID of chat to return (see [pagination](https://core.telegram.org/api/offsets))',
+  'method_messages.getCommonChats_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)',
+  'method_messages.getAllChats' => 'Get all chats, channels and supergroups',
   'method_messages.getAllChats_param_except_ids_type_Vector t' => 'Do not fetch these chats (MTProto id)',
-  'method_messages.getWebPage' => 'Get webpage preview',
-  'method_messages.getWebPage_param_url_type_string' => 'URL',
-  'method_messages.getWebPage_param_hash_type_int' => '0 or $result[\'hash\']',
-  'method_messages.toggleDialogPin' => 'Pin or unpin dialog',
-  'method_messages.toggleDialogPin_param_pinned_type_true' => 'Pin or unpin the dialog?',
+  'method_messages.getWebPage' => 'Get [instant view](https://instantview.telegram.org) page',
+  'method_messages.getWebPage_param_url_type_string' => 'URL of IV page to fetch',
+  'method_messages.getWebPage_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_messages.toggleDialogPin' => 'Pin/unpin a dialog',
+  'method_messages.toggleDialogPin_param_pinned_type_true' => 'Whether to pin or unpin the dialog',
   'method_messages.toggleDialogPin_param_peer_type_InputPeer' => 'The peer to pin',
   'method_messages.reorderPinnedDialogs' => 'Reorder pinned dialogs',
-  'method_messages.reorderPinnedDialogs_param_force_type_true' => 'Force reordering',
+  'method_messages.reorderPinnedDialogs_param_force_type_true' => 'If set, dialogs pinned server-side but not present in the `order` field will be unpinned.',
   'method_messages.reorderPinnedDialogs_param_order_type_Vector t' => 'New order',
   'method_messages.getPinnedDialogs' => 'Get pinned dialogs',
-  'method_messages.setBotShippingResults' => 'Bots only: set shipping results',
-  'method_messages.setBotShippingResults_param_query_id_type_long' => 'Query ID',
-  'method_messages.setBotShippingResults_param_error_type_string' => 'Error',
+  'method_messages.setBotShippingResults' => 'If you sent an invoice requesting a shipping address and the parameter is\\_flexible was specified, the bot will receive an [updateBotShippingQuery](../constructors/updateBotShippingQuery.md) update. Use this method to reply to shipping queries.',
+  'method_messages.setBotShippingResults_param_query_id_type_long' => 'Unique identifier for the query to be answered',
+  'method_messages.setBotShippingResults_param_error_type_string' => 'Error message in human readable form that explains why it is impossible to complete the order (e.g. "Sorry, delivery to your desired address is unavailable\'). Telegram will display this message to the user.',
   'method_messages.setBotShippingResults_param_shipping_options_type_Vector t' => 'Shipping options',
-  'method_messages.setBotPrecheckoutResults' => 'Bots only: set precheckout results',
-  'method_messages.setBotPrecheckoutResults_param_success_type_true' => 'Success?',
-  'method_messages.setBotPrecheckoutResults_param_query_id_type_long' => 'Query ID',
-  'method_messages.setBotPrecheckoutResults_param_error_type_string' => 'Error',
-  'method_messages.uploadMedia' => 'Upload a file without sending it to anyone',
-  'method_messages.uploadMedia_param_peer_type_InputPeer' => 'Nothing',
-  'method_messages.uploadMedia_param_media_type_InputMedia' => 'The media to upload',
-  'method_messages.sendScreenshotNotification' => 'Send screenshot notification',
-  'method_messages.sendScreenshotNotification_param_peer_type_InputPeer' => 'Where to send the notification',
-  'method_messages.sendScreenshotNotification_param_reply_to_msg_id_type_int' => 'Reply to message by ID',
-  'method_messages.getFavedStickers' => 'Get favorite stickers',
-  'method_messages.getFavedStickers_param_hash_type_int' => '0 or $result[\'hash\']',
-  'method_messages.faveSticker' => 'Add a sticker to favorites',
-  'method_messages.faveSticker_param_id_type_InputDocument' => 'The sticker to add to favorites',
-  'method_messages.faveSticker_param_unfave_type_Bool' => 'Remove it from favorites?',
-  'method_messages.getUnreadMentions' => 'Get unread mentions',
-  'method_messages.getUnreadMentions_param_peer_type_InputPeer' => 'The chat where to get unread mentions',
-  'method_messages.getUnreadMentions_param_offset_id_type_int' => 'The offset',
-  'method_messages.getUnreadMentions_param_add_offset_type_int' => 'The additional offset',
-  'method_messages.getUnreadMentions_param_limit_type_int' => 'The number of results to fetch',
-  'method_messages.getUnreadMentions_param_max_id_type_int' => 'The maximum message ID to fetch',
-  'method_messages.getUnreadMentions_param_min_id_type_int' => 'The minumum message ID to fetch',
+  'method_messages.setBotPrecheckoutResults' => 'Once the user has confirmed their payment and shipping details, the bot receives an [updateBotPrecheckoutQuery](../constructors/updateBotPrecheckoutQuery.md) update.  
+Use this method to respond to such pre-checkout queries.  
+**Note**: Telegram must receive an answer within 10 seconds after the pre-checkout query was sent.',
+  'method_messages.setBotPrecheckoutResults_param_success_type_true' => 'Set this flag if everything is alright (goods are available, etc.) and the bot is ready to proceed with the order, otherwise do not set it, and set the `error` field, instead',
+  'method_messages.setBotPrecheckoutResults_param_query_id_type_long' => 'Unique identifier for the query to be answered',
+  'method_messages.setBotPrecheckoutResults_param_error_type_string' => 'Required if the `success` isn\'t set. Error message in human readable form that explains the reason for failure to proceed with the checkout (e.g. "Sorry, somebody just bought the last of our amazing black T-shirts while you were busy filling out your payment details. Please choose a different color or garment!"). Telegram will display this message to the user.',
+  'method_messages.uploadMedia' => 'Upload a file and associate it to a chat (without actually sending it to the chat)',
+  'method_messages.uploadMedia_param_peer_type_InputPeer' => 'The chat, can be an [inputPeerEmpty](../constructors/inputPeerEmpty.md) for bots',
+  'method_messages.uploadMedia_param_media_type_InputMedia' => 'File uploaded in chunks as described in [files »](https://core.telegram.org/api/files)',
+  'method_messages.sendScreenshotNotification' => 'Notify the other user in a private chat that a screenshot of the chat was taken',
+  'method_messages.sendScreenshotNotification_param_peer_type_InputPeer' => 'Other user',
+  'method_messages.sendScreenshotNotification_param_reply_to_msg_id_type_int' => 'ID of message that was screenshotted, can be 0',
+  'method_messages.getFavedStickers' => 'Get faved stickers',
+  'method_messages.getFavedStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_messages.faveSticker' => 'Mark a sticker as favorite',
+  'method_messages.faveSticker_param_id_type_InputDocument' => 'Sticker to mark as favorite',
+  'method_messages.faveSticker_param_unfave_type_Bool' => 'Unfavorite',
+  'method_messages.getUnreadMentions' => 'Get unread messages where we were mentioned',
+  'method_messages.getUnreadMentions_param_peer_type_InputPeer' => 'Peer where to look for mentions',
+  'method_messages.getUnreadMentions_param_offset_id_type_int' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)',
+  'method_messages.getUnreadMentions_param_add_offset_type_int' => '[Offsets for pagination, for more info click here](https://core.telegram.org/api/offsets)',
+  'method_messages.getUnreadMentions_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)',
+  'method_messages.getUnreadMentions_param_max_id_type_int' => 'Maximum message ID to return, [see pagination](https://core.telegram.org/api/offsets)',
+  'method_messages.getUnreadMentions_param_min_id_type_int' => 'Minimum message ID to return, [see pagination](https://core.telegram.org/api/offsets)',
   'method_messages.readMentions' => 'Mark mentions as read',
-  'method_messages.readMentions_param_peer_type_InputPeer' => 'The chat',
-  'method_messages.getRecentLocations' => 'Get recent locations',
-  'method_messages.getRecentLocations_param_peer_type_InputPeer' => 'The chat where to search locations',
-  'method_messages.getRecentLocations_param_limit_type_int' => 'Number of results to return',
-  'method_messages.sendMultiMedia' => 'Send an album',
-  'method_messages.sendMultiMedia_param_silent_type_true' => 'Disable notifications?',
-  'method_messages.sendMultiMedia_param_background_type_true' => 'Disable background notification?',
-  'method_messages.sendMultiMedia_param_clear_draft_type_true' => 'Clear draft?',
-  'method_messages.sendMultiMedia_param_peer_type_InputPeer' => 'Where to send the album',
-  'method_messages.sendMultiMedia_param_reply_to_msg_id_type_int' => 'Reply to message by ID',
+  'method_messages.readMentions_param_peer_type_InputPeer' => 'Dialog',
+  'method_messages.getRecentLocations' => 'Get live location history of a certain user',
+  'method_messages.getRecentLocations_param_peer_type_InputPeer' => 'User',
+  'method_messages.getRecentLocations_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)',
+  'method_messages.sendMultiMedia' => 'Send an album of media',
+  'method_messages.sendMultiMedia_param_silent_type_true' => 'Whether to send the album silently (no notification triggered)',
+  'method_messages.sendMultiMedia_param_background_type_true' => 'Send in background?',
+  'method_messages.sendMultiMedia_param_clear_draft_type_true' => 'Whether to clear [drafts](https://core.telegram.org/api/drafts)',
+  'method_messages.sendMultiMedia_param_peer_type_InputPeer' => 'The destination chat',
+  'method_messages.sendMultiMedia_param_reply_to_msg_id_type_int' => 'The message to reply to',
   'method_messages.sendMultiMedia_param_multi_media_type_Vector t' => 'The album',
-  'method_messages.uploadEncryptedFile' => 'Upload a secret chat file without sending it to anyone',
-  'method_messages.uploadEncryptedFile_param_peer_type_InputEncryptedChat' => 'The chat where to upload the media',
+  'method_messages.uploadEncryptedFile' => 'Upload encrypted file and associate it to a secret chat',
+  'method_messages.uploadEncryptedFile_param_peer_type_InputEncryptedChat' => 'The secret chat to associate the file to',
   'method_messages.uploadEncryptedFile_param_file_type_InputEncryptedFile' => 'The file',
-  'method_updates.getState' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates',
-  'method_updates.getDifference' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates',
-  'method_updates.getDifference_param_pts_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates',
-  'method_updates.getDifference_param_pts_total_limit_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates',
-  'method_updates.getDifference_param_date_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates',
-  'method_updates.getDifference_param_qts_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates',
-  'method_updates.getChannelDifference' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates',
-  'method_updates.getChannelDifference_param_force_type_true' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates',
-  'method_updates.getChannelDifference_param_channel_type_InputChannel' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates',
-  'method_updates.getChannelDifference_param_filter_type_ChannelMessagesFilter' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates',
-  'method_updates.getChannelDifference_param_pts_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates',
-  'method_updates.getChannelDifference_param_limit_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz for more info on handling updates',
-  'method_photos.updateProfilePhoto' => 'Change the profile photo',
-  'method_photos.updateProfilePhoto_param_id_type_InputPhoto' => 'The photo to use',
-  'method_photos.uploadProfilePhoto' => 'Upload profile photo',
-  'method_photos.uploadProfilePhoto_param_file_type_InputFile' => 'The photo',
-  'method_photos.deletePhotos' => 'Delete profile photos',
+  'method_updates.getState' => 'Returns a current state of updates.',
+  'method_updates.getDifference' => 'Get new [updates](https://core.telegram.org/api/updates).',
+  'method_updates.getDifference_param_pts_type_int' => 'PTS, see [updates](https://core.telegram.org/api/updates).',
+  'method_updates.getDifference_param_pts_total_limit_type_int' => 'For fast updating: if provided and `pts + pts_total_limit < remote pts`, [updates.differenceTooLong](../constructors/updates.differenceTooLong.md) will be returned.
Simply tells the server to not return the difference if it is bigger than `pts_total_limit`
If the remote pts is too big (> ~4000000), this field will default to 1000000',
+  'method_updates.getDifference_param_date_type_int' => 'date, see [updates](https://core.telegram.org/api/updates).',
+  'method_updates.getDifference_param_qts_type_int' => 'QTS, see [updates](https://core.telegram.org/api/updates).',
+  'method_updates.getChannelDifference' => 'Returns the difference between the current state of updates of a certain channel and transmitted.',
+  'method_updates.getChannelDifference_param_force_type_true' => 'Set to true to skip some possibly unneeded updates and reduce server-side load',
+  'method_updates.getChannelDifference_param_channel_type_InputChannel' => 'The channel',
+  'method_updates.getChannelDifference_param_filter_type_ChannelMessagesFilter' => 'Messsage filter',
+  'method_updates.getChannelDifference_param_pts_type_int' => 'Persistent timestamp (see [updates](https://core.telegram.org/api/updates))',
+  'method_updates.getChannelDifference_param_limit_type_int' => 'How many updates to fetch, max `100000`
Ordinary (non-bot) users are supposed to pass `10-100`',
+  'method_photos.updateProfilePhoto' => 'Installs a previously uploaded photo as a profile photo.',
+  'method_photos.updateProfilePhoto_param_id_type_InputPhoto' => 'Input photo',
+  'method_photos.uploadProfilePhoto' => 'Updates current user profile photo.',
+  'method_photos.uploadProfilePhoto_param_file_type_InputFile' => 'File saved in parts by means of [upload.saveFilePart](../methods/upload.saveFilePart.md) method',
+  'method_photos.deletePhotos' => 'Deletes profile photos.',
   'method_photos.deletePhotos_param_id_type_Vector t' => 'The profile photos to delete',
-  'method_photos.getUserPhotos' => 'Get the profile photos of a user',
-  'method_photos.getUserPhotos_param_user_id_type_InputUser' => 'The user',
-  'method_photos.getUserPhotos_param_offset_type_int' => 'Offset',
-  'method_photos.getUserPhotos_param_max_id_type_long' => 'Maximum ID of photo to return',
-  'method_photos.getUserPhotos_param_limit_type_int' => 'Number of photos to return',
-  'method_upload.saveFilePart' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.saveFilePart_param_file_id_type_long' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.saveFilePart_param_file_part_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.saveFilePart_param_bytes_type_bytes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.getFile' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.getFile_param_location_type_InputFileLocation' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.getFile_param_offset_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.getFile_param_limit_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.saveBigFilePart' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.saveBigFilePart_param_file_id_type_long' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.saveBigFilePart_param_file_part_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.saveBigFilePart_param_file_total_parts_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.saveBigFilePart_param_bytes_type_bytes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.getWebFile' => 'Download a file through telegram',
-  'method_upload.getWebFile_param_location_type_InputWebFileLocation' => 'The file',
-  'method_upload.getWebFile_param_offset_type_int' => 'The offset in bytes',
-  'method_upload.getWebFile_param_limit_type_int' => 'The number of bytes to fetch',
-  'method_upload.getCdnFile' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.getCdnFile_param_file_token_type_bytes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.getCdnFile_param_offset_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.getCdnFile_param_limit_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.reuploadCdnFile' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.reuploadCdnFile_param_file_token_type_bytes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.reuploadCdnFile_param_request_token_type_bytes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.getCdnFileHashes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.getCdnFileHashes_param_file_token_type_bytes' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_upload.getCdnFileHashes_param_offset_type_int' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_help.getConfig' => 'Get server configuration',
-  'method_help.getNearestDc' => 'Get nearest datacenter',
-  'method_help.getAppUpdate' => 'Get info about app updates',
-  'method_help.saveAppLog' => 'Log data for developer of this app',
+  'method_photos.getUserPhotos' => 'Returns the list of user photos.',
+  'method_photos.getUserPhotos_param_user_id_type_InputUser' => 'User ID',
+  'method_photos.getUserPhotos_param_offset_type_int' => 'Number of list elements to be skipped',
+  'method_photos.getUserPhotos_param_max_id_type_long' => 'If a positive value was transferred, the method will return only photos with IDs less than the set one',
+  'method_photos.getUserPhotos_param_limit_type_int' => 'Number of list elements to be returned',
+  'method_upload.saveFilePart' => 'Saves a part of file for futher sending to one of the methods.',
+  'method_upload.saveFilePart_param_file_id_type_long' => 'Random file identifier created by the client',
+  'method_upload.saveFilePart_param_file_part_type_int' => 'Numerical order of a part',
+  'method_upload.saveFilePart_param_bytes_type_bytes' => 'Binary data, contend of a part',
+  'method_upload.getFile' => 'Returns content of a whole file or its part.',
+  'method_upload.getFile_param_location_type_InputFileLocation' => 'File location',
+  'method_upload.getFile_param_offset_type_int' => 'Number of bytes to be skipped',
+  'method_upload.getFile_param_limit_type_int' => 'Number of bytes to be returned',
+  'method_upload.saveBigFilePart' => 'Saves a part of a large file (over 10Mb in size) to be later passed to one of the methods.',
+  'method_upload.saveBigFilePart_param_file_id_type_long' => 'Random file id, created by the client',
+  'method_upload.saveBigFilePart_param_file_part_type_int' => 'Part sequence number',
+  'method_upload.saveBigFilePart_param_file_total_parts_type_int' => 'Total number of parts',
+  'method_upload.saveBigFilePart_param_bytes_type_bytes' => 'Binary data, part contents',
+  'method_upload.getWebFile' => 'Returns content of an HTTP file or a part, by proxying the request through telegram.',
+  'method_upload.getWebFile_param_location_type_InputWebFileLocation' => 'The file to download',
+  'method_upload.getWebFile_param_offset_type_int' => 'Number of bytes to be skipped',
+  'method_upload.getWebFile_param_limit_type_int' => 'Number of bytes to be returned',
+  'method_upload.getCdnFile' => 'Download a [CDN](https://core.telegram.org/cdn) file.',
+  'method_upload.getCdnFile_param_file_token_type_bytes' => 'File token',
+  'method_upload.getCdnFile_param_offset_type_int' => 'Offset of chunk to download',
+  'method_upload.getCdnFile_param_limit_type_int' => 'Length of chunk to download',
+  'method_upload.reuploadCdnFile' => 'Request a reupload of a certain file to a [CDN DC](https://core.telegram.org/cdn).',
+  'method_upload.reuploadCdnFile_param_file_token_type_bytes' => 'File token',
+  'method_upload.reuploadCdnFile_param_request_token_type_bytes' => 'Request token',
+  'method_upload.getCdnFileHashes' => 'Get SHA256 hashes for verifying downloaded [CDN](https://core.telegram.org/cdn) files',
+  'method_upload.getCdnFileHashes_param_file_token_type_bytes' => 'File',
+  'method_upload.getCdnFileHashes_param_offset_type_int' => 'Offset from which to start getting hashes',
+  'method_help.getConfig' => 'Returns current configuration, icluding data center configuration.',
+  'method_help.getNearestDc' => 'Returns info on data centre nearest to the user.',
+  'method_help.getAppUpdate' => 'Returns information on update availability for the current application.',
+  'method_help.saveAppLog' => 'Saves logs of application on the server.',
   'method_help.saveAppLog_param_events_type_Vector t' => 'Event list',
-  'method_help.getInviteText' => 'Get invitation text',
-  'method_help.getSupport' => 'Get info of support user',
-  'method_help.getAppChangelog' => 'Get the changelog of this app',
+  'method_help.getInviteText' => 'Returns text of a text message with an invitation.',
+  'method_help.getSupport' => 'Returns the support user for the \'ask a question\' feature.',
+  'method_help.getAppChangelog' => 'Get changelog of current app',
   'method_help.getAppChangelog_param_prev_app_version_type_string' => 'Previous app version',
   'method_help.getTermsOfService' => 'Get terms of service',
-  'method_help.setBotUpdatesStatus' => 'Set the update status of webhook',
-  'method_help.setBotUpdatesStatus_param_pending_updates_count_type_int' => 'Pending update count',
-  'method_help.setBotUpdatesStatus_param_message_type_string' => 'Message',
-  'method_help.getCdnConfig' => 'Get CDN configuration',
-  'method_help.getRecentMeUrls' => 'Get recent t.me URLs',
-  'method_help.getRecentMeUrls_param_referer_type_string' => 'Referrer',
-  'method_channels.readHistory' => 'Mark channel/supergroup history as read',
-  'method_channels.readHistory_param_channel_type_InputChannel' => 'The channel/supergroup',
-  'method_channels.readHistory_param_max_id_type_int' => 'Maximum message ID to mark as read',
-  'method_channels.deleteMessages' => 'Delete channel/supergroup messages',
-  'method_channels.deleteMessages_param_channel_type_InputChannel' => 'The channel/supergroup',
+  'method_help.setBotUpdatesStatus' => 'Informs the server about the number of pending bot updates if they haven\'t been processed for a long time; for bots only',
+  'method_help.setBotUpdatesStatus_param_pending_updates_count_type_int' => 'Number of pending updates',
+  'method_help.setBotUpdatesStatus_param_message_type_string' => 'Error message, if present',
+  'method_help.getCdnConfig' => 'Get configuration for [CDN](https://core.telegram.org/cdn) file downloads.',
+  'method_help.getRecentMeUrls' => 'Get recently used `t.me` links',
+  'method_help.getRecentMeUrls_param_referer_type_string' => 'Referer',
+  'method_channels.readHistory' => 'Mark [channel/supergroup](https://core.telegram.org/api/channel) history as read',
+  'method_channels.readHistory_param_channel_type_InputChannel' => '[Channel/supergroup](https://core.telegram.org/api/channel)',
+  'method_channels.readHistory_param_max_id_type_int' => 'ID of message up to which messages should be marked as read',
+  'method_channels.deleteMessages' => 'Delete messages in a [channel/supergroup](https://core.telegram.org/api/channel)',
+  'method_channels.deleteMessages_param_channel_type_InputChannel' => '[Channel/supergroup](https://core.telegram.org/api/channel)',
   'method_channels.deleteMessages_param_id_type_Vector t' => 'The IDs of messages to delete',
-  'method_channels.deleteUserHistory' => 'Delete all messages of a user in a channel/supergroup',
-  'method_channels.deleteUserHistory_param_channel_type_InputChannel' => 'The channel/supergroup',
-  'method_channels.deleteUserHistory_param_user_id_type_InputUser' => 'The user',
-  'method_channels.reportSpam' => 'Report a message in a supergroup/channel for spam',
-  'method_channels.reportSpam_param_channel_type_InputChannel' => 'The channel',
-  'method_channels.reportSpam_param_user_id_type_InputUser' => 'The user that sent the messages',
+  'method_channels.deleteUserHistory' => 'Delete all messages sent by a certain user in a [supergroup](https://core.telegram.org/api/channel)',
+  'method_channels.deleteUserHistory_param_channel_type_InputChannel' => '[Supergroup](https://core.telegram.org/api/channel)',
+  'method_channels.deleteUserHistory_param_user_id_type_InputUser' => 'User whose messages should be deleted',
+  'method_channels.reportSpam' => 'Reports some messages from a user in a supergroup as spam; requires administrator rights in the supergroup',
+  'method_channels.reportSpam_param_channel_type_InputChannel' => 'Supergroup',
+  'method_channels.reportSpam_param_user_id_type_InputUser' => 'ID of the user that sent the spam messages',
   'method_channels.reportSpam_param_id_type_Vector t' => 'The IDs of messages to report',
-  'method_channels.getMessages' => 'Get channel/supergroup messages',
-  'method_channels.getMessages_param_channel_type_InputChannel' => 'The channel/supergroup',
+  'method_channels.getMessages' => 'Get [channel/supergroup](https://core.telegram.org/api/channel) messages',
+  'method_channels.getMessages_param_channel_type_InputChannel' => 'Channel/supergroup',
   'method_channels.getMessages_param_id_type_Vector t' => 'The message IDs',
-  'method_channels.getParticipants' => 'Get channel/supergroup participants (you should use `$MadelineProto->getPwrChat($id)` instead)',
-  'method_channels.getParticipants_param_channel_type_InputChannel' => 'The channel',
-  'method_channels.getParticipants_param_filter_type_ChannelParticipantsFilter' => 'Member filter',
-  'method_channels.getParticipants_param_offset_type_int' => 'Offset',
-  'method_channels.getParticipants_param_limit_type_int' => 'Limit',
-  'method_channels.getParticipants_param_hash_type_int' => 'Sorted list of IDs of participants you already fetched',
-  'method_channels.getParticipant' => 'Get info about a certain channel/supergroup participant',
-  'method_channels.getParticipant_param_channel_type_InputChannel' => 'The channel/supergroup',
-  'method_channels.getParticipant_param_user_id_type_InputUser' => 'The user to fetch info about',
-  'method_channels.getChannels' => 'Get info about multiple channels/supergroups',
+  'method_channels.getParticipants' => 'Get the participants of a channel',
+  'method_channels.getParticipants_param_channel_type_InputChannel' => 'Channel',
+  'method_channels.getParticipants_param_filter_type_ChannelParticipantsFilter' => 'Which participant types to fetch',
+  'method_channels.getParticipants_param_offset_type_int' => '[Offset](https://core.telegram.org/api/offsets)',
+  'method_channels.getParticipants_param_limit_type_int' => '[Limit](https://core.telegram.org/api/offsets)',
+  'method_channels.getParticipants_param_hash_type_int' => '[Hash](https://core.telegram.org/api/offsets)',
+  'method_channels.getParticipant' => 'Get info about a [channel/supergroup](https://core.telegram.org/api/channel) participant',
+  'method_channels.getParticipant_param_channel_type_InputChannel' => 'Channel/supergroup',
+  'method_channels.getParticipant_param_user_id_type_InputUser' => 'ID of participant to get info about',
+  'method_channels.getChannels' => 'Get info about [channels/supergroups](https://core.telegram.org/api/channel)',
   'method_channels.getChannels_param_id_type_Vector t' => 'The channel/supergroup MTProto IDs',
-  'method_channels.getFullChannel' => 'You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)',
-  'method_channels.getFullChannel_param_channel_type_InputChannel' => 'You cannot use this method directly, use the getPwrChat, getInfo, getFullInfo methods instead (see https://docs.madelineproto.xyz for more info)',
-  'method_channels.createChannel' => 'Create channel/supergroup',
-  'method_channels.createChannel_param_broadcast_type_true' => 'Set this to true to create a channel',
-  'method_channels.createChannel_param_megagroup_type_true' => 'Set this to true to create a supergroup',
-  'method_channels.createChannel_param_title_type_string' => 'Supergroup/channel title',
-  'method_channels.createChannel_param_about_type_string' => 'About text',
+  'method_channels.getFullChannel' => 'Get full info about a channel',
+  'method_channels.getFullChannel_param_channel_type_InputChannel' => 'The channel to get info about',
+  'method_channels.createChannel' => 'Create a [supergroup/channel](https://core.telegram.org/api/channel).',
+  'method_channels.createChannel_param_broadcast_type_true' => 'Whether to create a [channel](https://core.telegram.org/api/channel)',
+  'method_channels.createChannel_param_megagroup_type_true' => 'Whether to create a [supergroup](https://core.telegram.org/api/channel)',
+  'method_channels.createChannel_param_title_type_string' => 'Channel title',
+  'method_channels.createChannel_param_about_type_string' => 'Channel description',
   'method_channels.editAbout' => 'Edit the about text of a channel/supergroup',
   'method_channels.editAbout_param_channel_type_InputChannel' => 'The channel',
   'method_channels.editAbout_param_about_type_string' => 'The new about text',
-  'method_channels.editAdmin' => 'Edit admin permissions of a user in a channel/supergroup',
-  'method_channels.editAdmin_param_channel_type_InputChannel' => 'The channel',
-  'method_channels.editAdmin_param_user_id_type_InputUser' => 'The user',
+  'method_channels.editAdmin' => 'Modify the admin rights of a user in a [supergroup/channel](https://core.telegram.org/api/channel).',
+  'method_channels.editAdmin_param_channel_type_InputChannel' => 'The [supergroup/channel](https://core.telegram.org/api/channel).',
+  'method_channels.editAdmin_param_user_id_type_InputUser' => 'The ID of the user whose admin rights should be modified',
   'method_channels.editAdmin_param_admin_rights_type_ChannelAdminRights' => 'The new admin rights',
-  'method_channels.editTitle' => 'Edit the title of a supergroup/channel',
-  'method_channels.editTitle_param_channel_type_InputChannel' => 'The channel',
-  'method_channels.editTitle_param_title_type_string' => 'The new channel/supergroup title',
-  'method_channels.editPhoto' => 'Edit the photo of a supergroup/channel',
-  'method_channels.editPhoto_param_channel_type_InputChannel' => 'The channel',
-  'method_channels.editPhoto_param_photo_type_InputChatPhoto' => 'The new photo',
-  'method_channels.checkUsername' => 'Check if this username is free and can be assigned to a channel/supergroup',
-  'method_channels.checkUsername_param_channel_type_InputChannel' => 'The channel/supergroup',
-  'method_channels.checkUsername_param_username_type_string' => 'The new username for this channel/supergroup',
-  'method_channels.updateUsername' => 'Update the username of a supergroup/channel',
-  'method_channels.updateUsername_param_channel_type_InputChannel' => 'The channel/supergroup',
-  'method_channels.updateUsername_param_username_type_string' => 'The new username',
+  'method_channels.editTitle' => 'Edit the name of a [channel/supergroup](https://core.telegram.org/api/channel)',
+  'method_channels.editTitle_param_channel_type_InputChannel' => 'Channel/supergroup',
+  'method_channels.editTitle_param_title_type_string' => 'New name',
+  'method_channels.editPhoto' => 'Change the photo of a [channel/supergroup](https://core.telegram.org/api/channel)',
+  'method_channels.editPhoto_param_channel_type_InputChannel' => 'Channel/supergroup whose photo should be edited',
+  'method_channels.editPhoto_param_photo_type_InputChatPhoto' => 'New photo',
+  'method_channels.checkUsername' => 'Check if a username is free and can be assigned to a channel/supergroup',
+  'method_channels.checkUsername_param_channel_type_InputChannel' => 'The [channel/supergroup](https://core.telegram.org/api/channel) that will assigned the specified username',
+  'method_channels.checkUsername_param_username_type_string' => 'The username to check',
+  'method_channels.updateUsername' => 'Change the username of a supergroup/channel',
+  'method_channels.updateUsername_param_channel_type_InputChannel' => 'Channel',
+  'method_channels.updateUsername_param_username_type_string' => 'New username',
   'method_channels.joinChannel' => 'Join a channel/supergroup',
-  'method_channels.joinChannel_param_channel_type_InputChannel' => 'The channel/supergroup to join',
-  'method_channels.leaveChannel' => 'Leave a channel/supergroup',
-  'method_channels.leaveChannel_param_channel_type_InputChannel' => 'The channel/supergroup to leave',
-  'method_channels.inviteToChannel' => 'Add users to channel/supergroup',
-  'method_channels.inviteToChannel_param_channel_type_InputChannel' => 'The channel/supergroup',
+  'method_channels.joinChannel_param_channel_type_InputChannel' => 'Channel/supergroup to join',
+  'method_channels.leaveChannel' => 'Leave a [channel/supergroup](https://core.telegram.org/api/channel)',
+  'method_channels.leaveChannel_param_channel_type_InputChannel' => '[Channel/supergroup](https://core.telegram.org/api/channel) to leave',
+  'method_channels.inviteToChannel' => 'Invite users to a channel/supergroup',
+  'method_channels.inviteToChannel_param_channel_type_InputChannel' => 'Channel/supergroup',
   'method_channels.inviteToChannel_param_users_type_Vector t' => 'The users to add',
   'method_channels.exportInvite' => 'Export the invite link of a channel',
   'method_channels.exportInvite_param_channel_type_InputChannel' => 'The channel',
-  'method_channels.deleteChannel' => 'Delete a channel/supergroup',
-  'method_channels.deleteChannel_param_channel_type_InputChannel' => 'The channel/supergroup to delete',
+  'method_channels.deleteChannel' => 'Delete a [channel/supergroup](https://core.telegram.org/api/channel)',
+  'method_channels.deleteChannel_param_channel_type_InputChannel' => '[Channel/supergroup](https://core.telegram.org/api/channel) to delete',
   'method_channels.toggleInvites' => 'Allow or disallow any user to invite users to this channel/supergroup',
   'method_channels.toggleInvites_param_channel_type_InputChannel' => 'The channel/supergroup',
   'method_channels.toggleInvites_param_enabled_type_Bool' => 'Allow or disallow',
-  'method_channels.exportMessageLink' => 'Get the link of a message in a channel',
-  'method_channels.exportMessageLink_param_channel_type_InputChannel' => 'The channel/supergroup',
-  'method_channels.exportMessageLink_param_id_type_int' => 'The ID of the message',
-  'method_channels.exportMessageLink_param_grouped_type_Bool' => 'Is this an album?',
-  'method_channels.toggleSignatures' => 'Toggle channel signatures',
-  'method_channels.toggleSignatures_param_channel_type_InputChannel' => 'The channel/supergroup',
-  'method_channels.toggleSignatures_param_enabled_type_Bool' => 'Enable or disable channel signatures?',
+  'method_channels.exportMessageLink' => 'Get link and embed info of a message in a [channel/supergroup](https://core.telegram.org/api/channel)',
+  'method_channels.exportMessageLink_param_channel_type_InputChannel' => 'Channel',
+  'method_channels.exportMessageLink_param_id_type_int' => 'Message ID',
+  'method_channels.exportMessageLink_param_grouped_type_Bool' => 'Whether to include other grouped media (for albums)',
+  'method_channels.toggleSignatures' => 'Enable/disable message signatures in channels',
+  'method_channels.toggleSignatures_param_channel_type_InputChannel' => 'Channel',
+  'method_channels.toggleSignatures_param_enabled_type_Bool' => 'Value',
   'method_channels.updatePinnedMessage' => 'Set the pinned message of a channel/supergroup',
   'method_channels.updatePinnedMessage_param_silent_type_true' => 'Pin silently',
   'method_channels.updatePinnedMessage_param_channel_type_InputChannel' => 'The channel/supergroup',
   'method_channels.updatePinnedMessage_param_id_type_int' => 'The ID of the message to pin',
-  'method_channels.getAdminedPublicChannels' => 'Get all supergroups/channels where you\'re admin',
-  'method_channels.editBanned' => 'Kick or ban a user from a channel/supergroup',
-  'method_channels.editBanned_param_channel_type_InputChannel' => 'The channel/supergroup',
-  'method_channels.editBanned_param_user_id_type_InputUser' => 'The user to kick/ban',
+  'method_channels.getAdminedPublicChannels' => 'Get [channels/supergroups/geogroups](https://core.telegram.org/api/channel) we\'re admin in. Usually called when the user exceeds the [limit](../constructors/config.md) for owned public [channels/supergroups/geogroups](https://core.telegram.org/api/channel), and the user is given the choice to remove one of his channels/supergroups/geogroups.',
+  'method_channels.editBanned' => 'Ban/unban/kick a user in a [supergroup/channel](https://core.telegram.org/api/channel).',
+  'method_channels.editBanned_param_channel_type_InputChannel' => 'The [supergroup/channel](https://core.telegram.org/api/channel).',
+  'method_channels.editBanned_param_user_id_type_InputUser' => 'The ID of the user whose banned rights should be modified',
   'method_channels.editBanned_param_banned_rights_type_ChannelBannedRights' => 'Banned/kicked permissions',
-  'method_channels.getAdminLog' => 'Get admin log of a channel/supergroup',
-  'method_channels.getAdminLog_param_channel_type_InputChannel' => 'The channel/supergroup',
-  'method_channels.getAdminLog_param_q_type_string' => 'Search query',
+  'method_channels.getAdminLog' => 'Get the admin log of a [channel/supergroup](https://core.telegram.org/api/channel)',
+  'method_channels.getAdminLog_param_channel_type_InputChannel' => 'Channel',
+  'method_channels.getAdminLog_param_q_type_string' => 'Search query, can be empty',
   'method_channels.getAdminLog_param_events_filter_type_ChannelAdminLogEventsFilter' => 'Event filter',
   'method_channels.getAdminLog_param_admins_type_Vector t' => 'Fetch only actions from these admins',
-  'method_channels.getAdminLog_param_max_id_type_long' => 'Maximum message ID to fetch',
-  'method_channels.getAdminLog_param_min_id_type_long' => 'Minimum message ID to fetch',
-  'method_channels.getAdminLog_param_limit_type_int' => 'Number of results to fetch',
-  'method_channels.setStickers' => 'Set the supergroup/channel stickerpack',
-  'method_channels.setStickers_param_channel_type_InputChannel' => 'The channel/supergoup',
-  'method_channels.setStickers_param_stickerset_type_InputStickerSet' => 'The stickerset',
-  'method_channels.readMessageContents' => 'Mark channel/supergroup messages as read',
-  'method_channels.readMessageContents_param_channel_type_InputChannel' => 'The channel',
+  'method_channels.getAdminLog_param_max_id_type_long' => 'Maximum ID of message to return (see [pagination](https://core.telegram.org/api/offsets))',
+  'method_channels.getAdminLog_param_min_id_type_long' => 'Minimum ID of message to return (see [pagination](https://core.telegram.org/api/offsets))',
+  'method_channels.getAdminLog_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)',
+  'method_channels.setStickers' => 'Associate a stickerset to the supergroup',
+  'method_channels.setStickers_param_channel_type_InputChannel' => 'Supergroup',
+  'method_channels.setStickers_param_stickerset_type_InputStickerSet' => 'The stickerset to associate',
+  'method_channels.readMessageContents' => 'Mark [channel/supergroup](https://core.telegram.org/api/channel) message contents as read',
+  'method_channels.readMessageContents_param_channel_type_InputChannel' => '[Channel/supergroup](https://core.telegram.org/api/channel)',
   'method_channels.readMessageContents_param_id_type_Vector t' => 'List of message IDs',
-  'method_channels.deleteHistory' => 'Delete the history of a supergroup/channel',
-  'method_channels.deleteHistory_param_channel_type_InputChannel' => 'The channel/supergroup',
-  'method_channels.deleteHistory_param_max_id_type_int' => 'Maximum message ID to delete',
-  'method_channels.togglePreHistoryHidden' => 'Enable or disable hidden history for new channel/supergroup users',
-  'method_channels.togglePreHistoryHidden_param_channel_type_InputChannel' => 'The channel/supergroup',
-  'method_channels.togglePreHistoryHidden_param_enabled_type_Bool' => 'Enable or disable hidden history for new channel/supergroup users',
-  'method_bots.sendCustomRequest' => 'Send a custom request to the bot API',
-  'method_bots.sendCustomRequest_param_custom_method_type_string' => 'The method to call',
-  'method_bots.sendCustomRequest_param_params_type_DataJSON' => 'Method parameters',
-  'method_bots.answerWebhookJSONQuery' => 'Send webhook request via bot API',
-  'method_bots.answerWebhookJSONQuery_param_query_id_type_long' => 'The query ID',
-  'method_bots.answerWebhookJSONQuery_param_data_type_DataJSON' => 'The parameters',
-  'method_payments.getPaymentForm' => 'Get payment form',
-  'method_payments.getPaymentForm_param_msg_id_type_int' => 'Message ID',
+  'method_channels.deleteHistory' => 'Delete the history of a [supergroup](https://core.telegram.org/api/channel)',
+  'method_channels.deleteHistory_param_channel_type_InputChannel' => '[Supergroup](https://core.telegram.org/api/channel) whose history must be deleted',
+  'method_channels.deleteHistory_param_max_id_type_int' => 'ID of message **up to which** the history must be deleted',
+  'method_channels.togglePreHistoryHidden' => 'Hide/unhide message history for new channel/supergroup users',
+  'method_channels.togglePreHistoryHidden_param_channel_type_InputChannel' => 'Channel/supergroup',
+  'method_channels.togglePreHistoryHidden_param_enabled_type_Bool' => 'Hide/unhide',
+  'method_bots.sendCustomRequest' => 'Sends a custom request; for bots only',
+  'method_bots.sendCustomRequest_param_custom_method_type_string' => 'The method name',
+  'method_bots.sendCustomRequest_param_params_type_DataJSON' => 'JSON-serialized method parameters',
+  'method_bots.answerWebhookJSONQuery' => 'Answers a custom query; for bots only',
+  'method_bots.answerWebhookJSONQuery_param_query_id_type_long' => 'Identifier of a custom query',
+  'method_bots.answerWebhookJSONQuery_param_data_type_DataJSON' => 'JSON-serialized answer to the query',
+  'method_payments.getPaymentForm' => 'Get a payment form',
+  'method_payments.getPaymentForm_param_msg_id_type_int' => 'Message ID of payment form',
   'method_payments.getPaymentReceipt' => 'Get payment receipt',
-  'method_payments.getPaymentReceipt_param_msg_id_type_int' => 'The message ID',
-  'method_payments.validateRequestedInfo' => 'Validate requested payment info',
-  'method_payments.validateRequestedInfo_param_save_type_true' => 'Save payment info?',
-  'method_payments.validateRequestedInfo_param_msg_id_type_int' => 'The message ID',
-  'method_payments.validateRequestedInfo_param_info_type_PaymentRequestedInfo' => 'The requested payment info',
-  'method_payments.sendPaymentForm' => 'Bots only: send payment form',
-  'method_payments.sendPaymentForm_param_msg_id_type_int' => 'Message ID',
-  'method_payments.sendPaymentForm_param_requested_info_id_type_string' => 'ID of requested info',
-  'method_payments.sendPaymentForm_param_shipping_option_id_type_string' => 'Shipping option ID',
+  'method_payments.getPaymentReceipt_param_msg_id_type_int' => 'Message ID of receipt',
+  'method_payments.validateRequestedInfo' => 'Submit requested order information for validation',
+  'method_payments.validateRequestedInfo_param_save_type_true' => 'Save order information to re-use it for future orders',
+  'method_payments.validateRequestedInfo_param_msg_id_type_int' => 'Message ID of payment form',
+  'method_payments.validateRequestedInfo_param_info_type_PaymentRequestedInfo' => 'Requested order information',
+  'method_payments.sendPaymentForm' => 'Send compiled payment form',
+  'method_payments.sendPaymentForm_param_msg_id_type_int' => 'Message ID of form',
+  'method_payments.sendPaymentForm_param_requested_info_id_type_string' => 'ID of saved and validated [order info](../constructors/payments.validatedRequestedInfo.md)',
+  'method_payments.sendPaymentForm_param_shipping_option_id_type_string' => 'Chosen shipping option ID',
   'method_payments.sendPaymentForm_param_credentials_type_InputPaymentCredentials' => 'Payment credentials',
-  'method_payments.getSavedInfo' => 'Get saved payments info',
-  'method_payments.clearSavedInfo' => 'Clear saved payments info',
-  'method_payments.clearSavedInfo_param_credentials_type_true' => 'Clear credentials?',
-  'method_payments.clearSavedInfo_param_info_type_true' => 'Clear payment info?',
-  'method_stickers.createStickerSet' => 'Create stickerset',
-  'method_stickers.createStickerSet_param_masks_type_true' => 'Masks?',
-  'method_stickers.createStickerSet_param_user_id_type_InputUser' => 'The user ID associated to this stickerset',
-  'method_stickers.createStickerSet_param_title_type_string' => 'The stickerset title',
-  'method_stickers.createStickerSet_param_short_name_type_string' => 'The stickerset short name',
+  'method_payments.getSavedInfo' => 'Get saved payment information',
+  'method_payments.clearSavedInfo' => 'Clear saved payment information',
+  'method_payments.clearSavedInfo_param_credentials_type_true' => 'Remove saved payment credentials',
+  'method_payments.clearSavedInfo_param_info_type_true' => 'Clear the last order settings saved by the user',
+  'method_stickers.createStickerSet' => 'Create a stickerset, bots only.',
+  'method_stickers.createStickerSet_param_masks_type_true' => 'Whether this is a mask stickerset',
+  'method_stickers.createStickerSet_param_user_id_type_InputUser' => 'Stickerset owner',
+  'method_stickers.createStickerSet_param_title_type_string' => 'Stickerset name, `1-64` chars',
+  'method_stickers.createStickerSet_param_short_name_type_string' => 'Sticker set name. Can contain only English letters, digits and underscores. Must end with *"*by*"* (** is case insensitive); 1-64 characters',
   'method_stickers.createStickerSet_param_stickers_type_Vector t' => 'The stickers to add',
-  'method_stickers.removeStickerFromSet' => 'Remove sticker from stickerset',
+  'method_stickers.removeStickerFromSet' => 'Remove a sticker from the set where it belongs, bots only. The sticker set must have been created by the bot.',
   'method_stickers.removeStickerFromSet_param_sticker_type_InputDocument' => 'The sticker to remove',
-  'method_stickers.changeStickerPosition' => 'Change sticker position in photo',
+  'method_stickers.changeStickerPosition' => 'Changes the absolute position of a sticker in the set to which it belongs; for bots only. The sticker set must have been created by the bot',
   'method_stickers.changeStickerPosition_param_sticker_type_InputDocument' => 'The sticker',
-  'method_stickers.changeStickerPosition_param_position_type_int' => 'New position',
-  'method_stickers.addStickerToSet' => 'Add sticker to stickerset',
+  'method_stickers.changeStickerPosition_param_position_type_int' => 'The new position of the sticker, zero-based',
+  'method_stickers.addStickerToSet' => 'Add a sticker to a stickerset, bots only. The sticker set must have been created by the bot.',
   'method_stickers.addStickerToSet_param_stickerset_type_InputStickerSet' => 'The stickerset',
   'method_stickers.addStickerToSet_param_sticker_type_InputStickerSetItem' => 'The sticker',
-  'method_phone.getCallConfig' => 'Get call configuration',
-  'method_phone.requestCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.requestCall_param_user_id_type_InputUser' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.requestCall_param_g_a_hash_type_bytes' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.requestCall_param_protocol_type_PhoneCallProtocol' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.acceptCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.acceptCall_param_peer_type_InputPhoneCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.acceptCall_param_g_b_type_bytes' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.acceptCall_param_protocol_type_PhoneCallProtocol' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.confirmCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.confirmCall_param_peer_type_InputPhoneCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.confirmCall_param_g_a_type_bytes' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.confirmCall_param_key_fingerprint_type_long' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.confirmCall_param_protocol_type_PhoneCallProtocol' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.receivedCall' => 'Notify server that you received a call (server will refuse all incoming calls until the current call is over)',
-  'method_phone.receivedCall_param_peer_type_InputPhoneCall' => 'The phone call you received',
-  'method_phone.discardCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.discardCall_param_peer_type_InputPhoneCall' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.discardCall_param_duration_type_int' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.discardCall_param_reason_type_PhoneCallDiscardReason' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.discardCall_param_connection_id_type_long' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.setCallRating' => 'Set phone call rating',
-  'method_phone.setCallRating_param_peer_type_InputPhoneCall' => 'The phone call',
-  'method_phone.setCallRating_param_rating_type_int' => 'Rating (1-5 stars)',
-  'method_phone.setCallRating_param_comment_type_string' => 'An optional comment',
-  'method_phone.saveCallDebug' => 'Save call debugging info',
-  'method_phone.saveCallDebug_param_peer_type_InputPhoneCall' => 'The call',
-  'method_phone.saveCallDebug_param_debug_type_DataJSON' => 'Debugging info',
-  'method_langpack.getLangPack' => 'Get language pack',
+  'method_phone.getCallConfig' => 'Get phone call configuration to be passed to libtgvoip\'s shared config',
+  'method_phone.requestCall' => 'Start a telegram phone call',
+  'method_phone.requestCall_param_user_id_type_InputUser' => 'Destination of the phone call',
+  'method_phone.requestCall_param_g_a_hash_type_bytes' => '[Parameter for E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls)',
+  'method_phone.requestCall_param_protocol_type_PhoneCallProtocol' => 'Phone call settings',
+  'method_phone.acceptCall' => 'Accept incoming call',
+  'method_phone.acceptCall_param_peer_type_InputPhoneCall' => 'The call to accept',
+  'method_phone.acceptCall_param_g_b_type_bytes' => '[Parameter for E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls)',
+  'method_phone.acceptCall_param_protocol_type_PhoneCallProtocol' => 'Phone call settings',
+  'method_phone.confirmCall' => '[Complete phone call E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls)',
+  'method_phone.confirmCall_param_peer_type_InputPhoneCall' => 'The phone call',
+  'method_phone.confirmCall_param_g_a_type_bytes' => '[Parameter for E2E encryption key exchange »](https://core.telegram.org/api/end-to-end/voice-calls)',
+  'method_phone.confirmCall_param_key_fingerprint_type_long' => 'Key fingerprint',
+  'method_phone.confirmCall_param_protocol_type_PhoneCallProtocol' => 'Phone call settings',
+  'method_phone.receivedCall' => 'Optional: notify the server that the user is currently busy in a call: this will automatically refuse all incoming phone calls until the current phone call is ended.',
+  'method_phone.receivedCall_param_peer_type_InputPhoneCall' => 'The phone call we\'re currently in',
+  'method_phone.discardCall' => 'Refuse or end running call',
+  'method_phone.discardCall_param_peer_type_InputPhoneCall' => 'The phone call',
+  'method_phone.discardCall_param_duration_type_int' => 'Call duration',
+  'method_phone.discardCall_param_reason_type_PhoneCallDiscardReason' => 'Why was the call discarded',
+  'method_phone.discardCall_param_connection_id_type_long' => 'Preferred libtgvoip relay ID',
+  'method_phone.setCallRating' => 'Rate a call',
+  'method_phone.setCallRating_param_peer_type_InputPhoneCall' => 'The call to rate',
+  'method_phone.setCallRating_param_rating_type_int' => 'Rating in `1-5` stars',
+  'method_phone.setCallRating_param_comment_type_string' => 'An additional comment',
+  'method_phone.saveCallDebug' => 'Send phone call debug data to server',
+  'method_phone.saveCallDebug_param_peer_type_InputPhoneCall' => 'Phone call',
+  'method_phone.saveCallDebug_param_debug_type_DataJSON' => 'Debug statistics obtained from libtgvoip',
+  'method_langpack.getLangPack' => 'Get localization pack strings',
   'method_langpack.getLangPack_param_lang_code_type_string' => 'Language code',
-  'method_langpack.getStrings' => 'Get language pack strings',
+  'method_langpack.getStrings' => 'Get strings from a language pack',
   'method_langpack.getStrings_param_lang_code_type_string' => 'Language code',
   'method_langpack.getStrings_param_keys_type_Vector t' => 'Keys',
-  'method_langpack.getDifference' => 'Get language pack updates',
-  'method_langpack.getDifference_param_from_version_type_int' => 'Previous version',
-  'method_langpack.getLanguages' => 'Get available languages',
+  'method_langpack.getDifference' => 'Get new strings in languagepack',
+  'method_langpack.getDifference_param_from_version_type_int' => 'Previous localization pack version',
+  'method_langpack.getLanguages' => 'Get information about all languages in a localization pack',
   'method_auth.sendCode_param_sms_type_type_int' => 'You cannot use this method directly, use the phoneLogin method instead (see https://docs.madelineproto.xyz for more info)',
   'method_auth.sendCode_param_lang_code_type_string' => 'You cannot use this method directly, use the phoneLogin method instead (see https://docs.madelineproto.xyz for more info)',
   'method_auth.sendCall' => 'Send verification phone call',
@@ -6363,7 +6750,7 @@ class Lang
   'method_auth.importBotAuthorization_param_b_type_true' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)',
   'method_auth.importBotAuthorization_param_c_type_true' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)',
   'method_auth.importBotAuthorization_param_d_type_true' => 'You cannot use this method directly, use the botLogin method instead (see https://docs.madelineproto.xyz for more info)',
-  'object_vector' => 'Array',
+  'object_vector' => 'A universal vector constructor.',
   'object_resPQ' => 'Contains pq to factorize',
   'object_resPQ_param_nonce_type_int128' => 'Nonce',
   'object_resPQ_param_server_nonce_type_int128' => 'Server nonce',
@@ -6494,142 +6881,142 @@ class Lang
   'object_bind_auth_key_inner_param_perm_auth_key_id_type_long' => 'Perm auth key ID',
   'object_bind_auth_key_inner_param_temp_session_id_type_long' => 'Temp session ID',
   'object_bind_auth_key_inner_param_expires_at_type_int' => 'Expires at',
-  'object_boolFalse' => 'Bool false',
-  'object_boolTrue' => 'Bool true',
-  'object_true' => 'True',
-  'object_error' => 'Error',
-  'object_error_param_code_type_int' => 'Code',
-  'object_error_param_text_type_string' => 'Text',
-  'object_null' => 'Null',
-  'object_inputPeerEmpty' => 'Empty input peer',
-  'object_inputPeerSelf' => 'Peer self',
-  'object_inputPeerChat' => 'Peer chat',
-  'object_inputPeerChat_param_chat_id_type_int' => 'Chat ID',
-  'object_inputPeerUser' => 'Peer user',
-  'object_inputPeerUser_param_user_id_type_int' => 'User ID',
-  'object_inputPeerUser_param_access_hash_type_long' => 'Access hash',
-  'object_inputPeerChannel' => 'Peer channel',
-  'object_inputPeerChannel_param_channel_id_type_int' => 'Channel ID',
-  'object_inputPeerChannel_param_access_hash_type_long' => 'Access hash',
-  'object_inputUserEmpty' => 'Empty input user',
-  'object_inputUserSelf' => 'User self',
-  'object_inputUser' => 'User',
-  'object_inputUser_param_user_id_type_int' => 'User ID',
-  'object_inputUser_param_access_hash_type_long' => 'Access hash',
-  'object_inputPhoneContact' => 'Phone contact',
-  'object_inputPhoneContact_param_client_id_type_long' => 'Client ID',
-  'object_inputPhoneContact_param_phone_type_string' => 'Phone',
-  'object_inputPhoneContact_param_first_name_type_string' => 'First name',
-  'object_inputPhoneContact_param_last_name_type_string' => 'Last name',
-  'object_inputFile' => 'File',
-  'object_inputFile_param_id_type_long' => 'ID',
-  'object_inputFile_param_parts_type_int' => 'Parts',
-  'object_inputFile_param_name_type_string' => 'Name',
-  'object_inputFile_param_md5_checksum_type_string' => 'Md5 checksum',
-  'object_inputFileBig' => 'File big',
-  'object_inputFileBig_param_id_type_long' => 'ID',
-  'object_inputFileBig_param_parts_type_int' => 'Parts',
-  'object_inputFileBig_param_name_type_string' => 'Name',
-  'object_inputMediaEmpty' => 'Empty input media',
-  'object_inputMediaUploadedPhoto' => 'Media uploaded photo',
-  'object_inputMediaUploadedPhoto_param_file_type_InputFile' => 'File',
+  'object_boolFalse' => 'Constructor may be interpreted as a **boolean**`false` value.',
+  'object_boolTrue' => 'The constructor can be interpreted as a **boolean**`true` value.',
+  'object_true' => 'See [predefined identifiers](https://core.telegram.org/mtproto/TL-formal#predefined-identifiers).',
+  'object_error' => 'Error.',
+  'object_error_param_code_type_int' => 'Error code',
+  'object_error_param_text_type_string' => 'Message',
+  'object_null' => 'Corresponds to an arbitrary empty object.',
+  'object_inputPeerEmpty' => 'An empty constructor, no user or chat is defined.',
+  'object_inputPeerSelf' => 'Defines the current user.',
+  'object_inputPeerChat' => 'Defines a chat for further interaction.',
+  'object_inputPeerChat_param_chat_id_type_int' => 'Chat idientifier',
+  'object_inputPeerUser' => 'Defines a user for further interaction.',
+  'object_inputPeerUser_param_user_id_type_int' => 'User identifier',
+  'object_inputPeerUser_param_access_hash_type_long' => '**access\\_hash** value from the [user](../constructors/user.md) constructor',
+  'object_inputPeerChannel' => 'Defines a channel for further interaction.',
+  'object_inputPeerChannel_param_channel_id_type_int' => 'Channel identifier',
+  'object_inputPeerChannel_param_access_hash_type_long' => '**access\\_hash** value from the [channel](../constructors/channel.md) constructor',
+  'object_inputUserEmpty' => 'Empty constructor, does not define a user.',
+  'object_inputUserSelf' => 'Defines the current user.',
+  'object_inputUser' => 'Defines a user for further interaction.',
+  'object_inputUser_param_user_id_type_int' => 'User identifier',
+  'object_inputUser_param_access_hash_type_long' => '**access\\_hash** value from the [user](../constructors/user.md) constructor',
+  'object_inputPhoneContact' => 'Phone contact. The `client_id` is just an arbitrary contact ID: it should be set, for example, to an incremental number when using [contacts.importContacts](../methods/contacts.importContacts.md), in order to retry importing only the contacts that weren\'t imported successfully.',
+  'object_inputPhoneContact_param_client_id_type_long' => 'User identifier on the client',
+  'object_inputPhoneContact_param_phone_type_string' => 'Phone number',
+  'object_inputPhoneContact_param_first_name_type_string' => 'Contact\'s first name',
+  'object_inputPhoneContact_param_last_name_type_string' => 'Contact\'s last name',
+  'object_inputFile' => 'Defines a file saved in parts using the method [upload.saveFilePart](../methods/upload.saveFilePart.md).',
+  'object_inputFile_param_id_type_long' => 'Random file identifier created by the client',
+  'object_inputFile_param_parts_type_int' => 'Number of parts saved',
+  'object_inputFile_param_name_type_string' => 'Full name of the file',
+  'object_inputFile_param_md5_checksum_type_string' => 'In case the file\'s [md5-hash](https://en.wikipedia.org/wiki/MD5#MD5_hashes) was passed, contents of the file will be checked prior to use',
+  'object_inputFileBig' => 'Assigns a big file (over 10Mb in size), saved in part using the method [upload.saveBigFilePart](../methods/upload.saveBigFilePart.md).',
+  'object_inputFileBig_param_id_type_long' => 'Random file id, created by the client',
+  'object_inputFileBig_param_parts_type_int' => 'Number of parts saved',
+  'object_inputFileBig_param_name_type_string' => 'Full file name',
+  'object_inputMediaEmpty' => 'Empty media content of a message.',
+  'object_inputMediaUploadedPhoto' => 'Photo',
+  'object_inputMediaUploadedPhoto_param_file_type_InputFile' => 'The [uploaded file](https://core.telegram.org/api/files)',
   'object_inputMediaUploadedPhoto_param_stickers_type_Vector t' => 'Stickers',
-  'object_inputMediaUploadedPhoto_param_ttl_seconds_type_int' => 'Ttl seconds',
-  'object_inputMediaPhoto' => 'Media photo',
-  'object_inputMediaPhoto_param_id_type_InputPhoto' => 'ID',
-  'object_inputMediaPhoto_param_ttl_seconds_type_int' => 'Ttl seconds',
-  'object_inputMediaGeoPoint' => 'Media geo point',
-  'object_inputMediaGeoPoint_param_geo_point_type_InputGeoPoint' => 'Geo point',
-  'object_inputMediaContact' => 'Media contact',
+  'object_inputMediaUploadedPhoto_param_ttl_seconds_type_int' => 'Time to live in seconds of self-destructing photo',
+  'object_inputMediaPhoto' => 'Forwarded photo',
+  'object_inputMediaPhoto_param_id_type_InputPhoto' => 'Photo to be forwarded',
+  'object_inputMediaPhoto_param_ttl_seconds_type_int' => 'Time to live in seconds of self-destructing photo',
+  'object_inputMediaGeoPoint' => 'Map.',
+  'object_inputMediaGeoPoint_param_geo_point_type_InputGeoPoint' => 'GeoPoint',
+  'object_inputMediaContact' => 'Phonebook contact',
   'object_inputMediaContact_param_phone_number_type_string' => 'Phone number',
-  'object_inputMediaContact_param_first_name_type_string' => 'First name',
-  'object_inputMediaContact_param_last_name_type_string' => 'Last name',
-  'object_inputMediaUploadedDocument' => 'Media uploaded document',
-  'object_inputMediaUploadedDocument_param_nosound_video_type_true' => 'Nosound video?',
-  'object_inputMediaUploadedDocument_param_file_type_InputFile' => 'File',
-  'object_inputMediaUploadedDocument_param_thumb_type_InputFile' => 'Thumbnail',
-  'object_inputMediaUploadedDocument_param_mime_type_type_string' => 'Mime type',
+  'object_inputMediaContact_param_first_name_type_string' => 'Contact\'s first name',
+  'object_inputMediaContact_param_last_name_type_string' => 'Contact\'s last name',
+  'object_inputMediaUploadedDocument' => 'New document',
+  'object_inputMediaUploadedDocument_param_nosound_video_type_true' => 'Whether the specified document is a video file with no audio tracks (a GIF animation (even as MPEG4), for example)',
+  'object_inputMediaUploadedDocument_param_file_type_InputFile' => 'The [uploaded file](https://core.telegram.org/api/files)',
+  'object_inputMediaUploadedDocument_param_thumb_type_InputFile' => 'Thumbnail of the document, uploaded as for the file',
+  'object_inputMediaUploadedDocument_param_mime_type_type_string' => 'MIME type of document',
   'object_inputMediaUploadedDocument_param_attributes_type_Vector t' => 'Attributes',
   'object_inputMediaUploadedDocument_param_stickers_type_Vector t' => 'Stickers',
-  'object_inputMediaUploadedDocument_param_ttl_seconds_type_int' => 'Ttl seconds',
-  'object_inputMediaDocument' => 'Media document',
-  'object_inputMediaDocument_param_id_type_InputDocument' => 'ID',
-  'object_inputMediaDocument_param_ttl_seconds_type_int' => 'Ttl seconds',
-  'object_inputMediaVenue' => 'Media venue',
-  'object_inputMediaVenue_param_geo_point_type_InputGeoPoint' => 'Geo point',
-  'object_inputMediaVenue_param_title_type_string' => 'Title',
-  'object_inputMediaVenue_param_address_type_string' => 'Address',
-  'object_inputMediaVenue_param_provider_type_string' => 'Provider',
-  'object_inputMediaVenue_param_venue_id_type_string' => 'Venue ID',
-  'object_inputMediaVenue_param_venue_type_type_string' => 'Venue type',
-  'object_inputMediaGifExternal' => 'Media gif external',
+  'object_inputMediaUploadedDocument_param_ttl_seconds_type_int' => 'Time to live in seconds of self-destructing document',
+  'object_inputMediaDocument' => 'Forwarded document',
+  'object_inputMediaDocument_param_id_type_InputDocument' => 'The document to be forwarded.',
+  'object_inputMediaDocument_param_ttl_seconds_type_int' => 'Time to live of self-destructing document',
+  'object_inputMediaVenue' => 'Can be used to send a venue geolocation.',
+  'object_inputMediaVenue_param_geo_point_type_InputGeoPoint' => 'Geolocation',
+  'object_inputMediaVenue_param_title_type_string' => 'Venue name',
+  'object_inputMediaVenue_param_address_type_string' => 'Physical address of the venue',
+  'object_inputMediaVenue_param_provider_type_string' => 'Venue provider: currently only "foursquare" needs to be supported',
+  'object_inputMediaVenue_param_venue_id_type_string' => 'Venue ID in the provider\'s database',
+  'object_inputMediaVenue_param_venue_type_type_string' => 'Venue type in the provider\'s database',
+  'object_inputMediaGifExternal' => 'New GIF animation that will be uploaded by the server using the specified URL',
   'object_inputMediaGifExternal_param_url_type_string' => 'URL',
-  'object_inputMediaGifExternal_param_q_type_string' => 'Q',
-  'object_inputMediaPhotoExternal' => 'Media photo external',
-  'object_inputMediaPhotoExternal_param_url_type_string' => 'URL',
-  'object_inputMediaPhotoExternal_param_ttl_seconds_type_int' => 'Ttl seconds',
-  'object_inputMediaDocumentExternal' => 'Media document external',
-  'object_inputMediaDocumentExternal_param_url_type_string' => 'URL',
-  'object_inputMediaDocumentExternal_param_ttl_seconds_type_int' => 'Ttl seconds',
-  'object_inputMediaGame' => 'Media game',
-  'object_inputMediaGame_param_id_type_InputGame' => 'ID',
-  'object_inputMediaInvoice' => 'Media invoice',
-  'object_inputMediaInvoice_param_title_type_string' => 'Title',
-  'object_inputMediaInvoice_param_description_type_string' => 'Description',
-  'object_inputMediaInvoice_param_photo_type_InputWebDocument' => 'Photo',
-  'object_inputMediaInvoice_param_invoice_type_Invoice' => 'Invoice',
-  'object_inputMediaInvoice_param_payload_type_bytes' => 'Payload',
-  'object_inputMediaInvoice_param_provider_type_string' => 'Provider',
-  'object_inputMediaInvoice_param_provider_data_type_DataJSON' => 'Provider data',
-  'object_inputMediaInvoice_param_start_param_type_string' => 'Start param',
-  'object_inputMediaGeoLive' => 'Media geo live',
-  'object_inputMediaGeoLive_param_geo_point_type_InputGeoPoint' => 'Geo point',
-  'object_inputMediaGeoLive_param_period_type_int' => 'Period',
-  'object_inputChatPhotoEmpty' => 'Empty input chat photo',
-  'object_inputChatUploadedPhoto' => 'Chat uploaded photo',
-  'object_inputChatUploadedPhoto_param_file_type_InputFile' => 'File',
-  'object_inputChatPhoto' => 'Chat photo',
-  'object_inputChatPhoto_param_id_type_InputPhoto' => 'ID',
-  'object_inputGeoPointEmpty' => 'Empty input geo point',
-  'object_inputGeoPoint' => 'Geo point',
-  'object_inputGeoPoint_param_lat_type_double' => 'Lat',
-  'object_inputGeoPoint_param_long_type_double' => 'Long',
-  'object_inputPhotoEmpty' => 'Empty input photo',
-  'object_inputPhoto' => 'Photo',
-  'object_inputPhoto_param_id_type_long' => 'ID',
-  'object_inputPhoto_param_access_hash_type_long' => 'Access hash',
-  'object_inputFileLocation' => 'File location',
-  'object_inputFileLocation_param_volume_id_type_long' => 'Volume ID',
-  'object_inputFileLocation_param_local_id_type_int' => 'Local ID',
-  'object_inputFileLocation_param_secret_type_long' => 'Secret',
-  'object_inputEncryptedFileLocation' => 'Encrypted file location',
-  'object_inputEncryptedFileLocation_param_id_type_long' => 'ID',
-  'object_inputEncryptedFileLocation_param_access_hash_type_long' => 'Access hash',
-  'object_inputDocumentFileLocation' => 'Document file location',
-  'object_inputDocumentFileLocation_param_id_type_long' => 'ID',
-  'object_inputDocumentFileLocation_param_access_hash_type_long' => 'Access hash',
+  'object_inputMediaGifExternal_param_q_type_string' => 'Query',
+  'object_inputMediaPhotoExternal' => 'New photo that will be uploaded by the server using the specified URL',
+  'object_inputMediaPhotoExternal_param_url_type_string' => 'URL of the photo',
+  'object_inputMediaPhotoExternal_param_ttl_seconds_type_int' => 'Self-destruct time to live of photo',
+  'object_inputMediaDocumentExternal' => 'Document that will be downloaded by the telegram servers',
+  'object_inputMediaDocumentExternal_param_url_type_string' => 'URL of the document',
+  'object_inputMediaDocumentExternal_param_ttl_seconds_type_int' => 'Self-destruct time to live of document',
+  'object_inputMediaGame' => 'A game',
+  'object_inputMediaGame_param_id_type_InputGame' => 'The game to forward',
+  'object_inputMediaInvoice' => 'Generated invoice of a [bot payment](https://core.telegram.org/bots/payments)',
+  'object_inputMediaInvoice_param_title_type_string' => 'Product name, 1-32 characters',
+  'object_inputMediaInvoice_param_description_type_string' => 'Product description, 1-255 characters',
+  'object_inputMediaInvoice_param_photo_type_InputWebDocument' => 'URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. People like it better when they see what they are paying for.',
+  'object_inputMediaInvoice_param_invoice_type_Invoice' => 'The actual invoice',
+  'object_inputMediaInvoice_param_payload_type_bytes' => 'Bot-defined invoice payload, 1-128 bytes. This will not be displayed to the user, use for your internal processes.',
+  'object_inputMediaInvoice_param_provider_type_string' => 'Payments provider token, obtained via [Botfather](https://t.me/botfather)',
+  'object_inputMediaInvoice_param_provider_data_type_DataJSON' => 'JSON-encoded data about the invoice, which will be shared with the payment provider. A detailed description of required fields should be provided by the payment provider.',
+  'object_inputMediaInvoice_param_start_param_type_string' => 'Start parameter',
+  'object_inputMediaGeoLive' => 'Live geographical location',
+  'object_inputMediaGeoLive_param_geo_point_type_InputGeoPoint' => 'Current geolocation',
+  'object_inputMediaGeoLive_param_period_type_int' => 'Validity period of the current location',
+  'object_inputChatPhotoEmpty' => 'Empty constructor, remove group photo.',
+  'object_inputChatUploadedPhoto' => 'New photo to be set as group profile photo.',
+  'object_inputChatUploadedPhoto_param_file_type_InputFile' => 'File saved in parts using the method [upload.saveFilePart](../methods/upload.saveFilePart.md)',
+  'object_inputChatPhoto' => 'Existing photo to be set as a chat profile photo.',
+  'object_inputChatPhoto_param_id_type_InputPhoto' => 'Existing photo',
+  'object_inputGeoPointEmpty' => 'Empty GeoPoint constructor.',
+  'object_inputGeoPoint' => 'Defines a GeoPoint by its coordinates.',
+  'object_inputGeoPoint_param_lat_type_double' => 'Latitide',
+  'object_inputGeoPoint_param_long_type_double' => 'Longtitude',
+  'object_inputPhotoEmpty' => 'Empty constructor.',
+  'object_inputPhoto' => 'Defines a photo for further interaction.',
+  'object_inputPhoto_param_id_type_long' => 'Photo identifier',
+  'object_inputPhoto_param_access_hash_type_long' => '**access\\_hash** value from the [photo](../constructors/photo.md) constructor',
+  'object_inputFileLocation' => 'DEPRECATED location of a photo',
+  'object_inputFileLocation_param_volume_id_type_long' => 'Server volume',
+  'object_inputFileLocation_param_local_id_type_int' => 'File identifier',
+  'object_inputFileLocation_param_secret_type_long' => 'Check sum to access the file',
+  'object_inputEncryptedFileLocation' => 'Location of encrypted secret chat file.',
+  'object_inputEncryptedFileLocation_param_id_type_long' => 'File ID, **id** parameter value from [encryptedFile](../constructors/encryptedFile.md)',
+  'object_inputEncryptedFileLocation_param_access_hash_type_long' => 'Checksum, **access\\_hash** parameter value from [encryptedFile](../constructors/encryptedFile.md)',
+  'object_inputDocumentFileLocation' => 'Document location (video, voice, audio, basically every type except photo)',
+  'object_inputDocumentFileLocation_param_id_type_long' => 'Document ID',
+  'object_inputDocumentFileLocation_param_access_hash_type_long' => '**access\\_hash** parameter from the [document](../constructors/document.md) constructor',
   'object_inputDocumentFileLocation_param_version_type_int' => 'Version',
-  'object_inputAppEvent' => 'App event',
-  'object_inputAppEvent_param_time_type_double' => 'Time',
-  'object_inputAppEvent_param_type_type_string' => 'Type',
-  'object_inputAppEvent_param_peer_type_long' => 'Peer',
+  'object_inputAppEvent' => 'Event that occured in the application.',
+  'object_inputAppEvent_param_time_type_double' => 'Client\'s exact timestamp for the event',
+  'object_inputAppEvent_param_type_type_string' => 'Type of event',
+  'object_inputAppEvent_param_peer_type_long' => 'Arbitrary numeric value for more convenient selection of certain event types, or events referring to a certain object',
   'object_inputAppEvent_param_data_type_string' => 'Data',
-  'object_peerUser' => 'Peer user',
-  'object_peerUser_param_user_id_type_int' => 'User ID',
-  'object_peerChat' => 'Peer chat',
-  'object_peerChat_param_chat_id_type_int' => 'Chat ID',
-  'object_peerChannel' => 'Peer channel',
+  'object_peerUser' => 'Chat partner',
+  'object_peerUser_param_user_id_type_int' => 'User identifier',
+  'object_peerChat' => 'Group.',
+  'object_peerChat_param_chat_id_type_int' => 'Group identifier',
+  'object_peerChannel' => 'Channel/supergroup',
   'object_peerChannel_param_channel_id_type_int' => 'Channel ID',
-  'object_storage.fileUnknown' => 'File unknown',
-  'object_storage.filePartial' => 'File partial',
-  'object_storage.fileJpeg' => 'File jpeg',
-  'object_storage.fileGif' => 'File gif',
-  'object_storage.filePng' => 'File png',
-  'object_storage.filePdf' => 'File pdf',
-  'object_storage.fileMp3' => 'File mp3',
-  'object_storage.fileMov' => 'File mov',
-  'object_storage.fileMp4' => 'File mp4',
-  'object_storage.fileWebp' => 'File webp',
+  'object_storage.fileUnknown' => 'Unknown type.',
+  'object_storage.filePartial' => 'Part of a bigger file.',
+  'object_storage.fileJpeg' => 'JPEG image. MIME type: `image/jpeg`.',
+  'object_storage.fileGif' => 'GIF image. MIME type: `image/gif`.',
+  'object_storage.filePng' => 'PNG image. MIME type: `image/png`.',
+  'object_storage.filePdf' => 'PDF document image. MIME type: `application/pdf`.',
+  'object_storage.fileMp3' => 'Mp3 audio. MIME type: `audio/mpeg`.',
+  'object_storage.fileMov' => 'Quicktime video. MIME type: `video/quicktime`.',
+  'object_storage.fileMp4' => 'MPEG-4 video. MIME type: `video/mp4`.',
+  'object_storage.fileWebp' => 'WEBP image. MIME type: `image/webp`.',
   'object_fileLocationUnavailable' => 'File location unavailable',
   'object_fileLocationUnavailable_param_volume_id_type_long' => 'Volume ID',
   'object_fileLocationUnavailable_param_local_id_type_int' => 'Local ID',
@@ -6639,328 +7026,328 @@ class Lang
   'object_fileLocation_param_volume_id_type_long' => 'Volume ID',
   'object_fileLocation_param_local_id_type_int' => 'Local ID',
   'object_fileLocation_param_secret_type_long' => 'Secret',
-  'object_userEmpty' => 'Empty user',
-  'object_userEmpty_param_id_type_int' => 'ID',
-  'object_user' => 'User',
-  'object_user_param_self_type_true' => 'Self?',
-  'object_user_param_contact_type_true' => 'Contact?',
-  'object_user_param_mutual_contact_type_true' => 'Mutual contact?',
-  'object_user_param_deleted_type_true' => 'Deleted?',
-  'object_user_param_bot_type_true' => 'Bot?',
-  'object_user_param_bot_chat_history_type_true' => 'Bot chat history?',
-  'object_user_param_bot_nochats_type_true' => 'Bot nochats?',
-  'object_user_param_verified_type_true' => 'Verified?',
-  'object_user_param_restricted_type_true' => 'Restricted?',
-  'object_user_param_min_type_true' => 'Min?',
-  'object_user_param_bot_inline_geo_type_true' => 'Bot inline geo?',
-  'object_user_param_id_type_int' => 'ID',
-  'object_user_param_access_hash_type_long' => 'Access hash',
+  'object_userEmpty' => 'Empty constructor, non-existent user.',
+  'object_userEmpty_param_id_type_int' => 'User identifier or `0`',
+  'object_user' => 'Indicates info about a certain user',
+  'object_user_param_self_type_true' => 'Whether this user indicates the currently logged in user',
+  'object_user_param_contact_type_true' => 'Whether this user is a contact',
+  'object_user_param_mutual_contact_type_true' => 'Whether this user is a mutual contact',
+  'object_user_param_deleted_type_true' => 'Whether the account of this user was deleted',
+  'object_user_param_bot_type_true' => 'Is this user a bot?',
+  'object_user_param_bot_chat_history_type_true' => 'Can the bot see all messages in groups?',
+  'object_user_param_bot_nochats_type_true' => 'Can the bot be added to groups?',
+  'object_user_param_verified_type_true' => 'Whether this user is verified',
+  'object_user_param_restricted_type_true' => 'Access to this user must be restricted for the reason specified in `restriction_reason`',
+  'object_user_param_min_type_true' => 'See [min](https://core.telegram.org/api/min)',
+  'object_user_param_bot_inline_geo_type_true' => 'Whether the bot can request our geolocation in inline mode',
+  'object_user_param_id_type_int' => 'ID of the user',
+  'object_user_param_access_hash_type_long' => 'Access hash of the user',
   'object_user_param_first_name_type_string' => 'First name',
   'object_user_param_last_name_type_string' => 'Last name',
   'object_user_param_username_type_string' => 'Username',
-  'object_user_param_phone_type_string' => 'Phone',
-  'object_user_param_photo_type_UserProfilePhoto' => 'Photo',
-  'object_user_param_status_type_UserStatus' => 'Status',
-  'object_user_param_bot_info_version_type_int' => 'Bot info version',
+  'object_user_param_phone_type_string' => 'Phone number',
+  'object_user_param_photo_type_UserProfilePhoto' => 'Profile picture of user',
+  'object_user_param_status_type_UserStatus' => 'Online status of user',
+  'object_user_param_bot_info_version_type_int' => 'Version of the [bot\\_info field in userFull](../constructors/userFull.md), incremented every time it changes',
   'object_user_param_restriction_reason_type_string' => 'Restriction reason',
-  'object_user_param_bot_inline_placeholder_type_string' => 'Bot inline placeholder',
-  'object_user_param_lang_code_type_string' => 'Lang code',
-  'object_userProfilePhotoEmpty' => 'Empty user profile photo',
-  'object_userProfilePhoto' => 'User profile photo',
-  'object_userProfilePhoto_param_photo_id_type_long' => 'Photo ID',
-  'object_userProfilePhoto_param_photo_small_type_FileLocation' => 'Photo small',
-  'object_userProfilePhoto_param_photo_big_type_FileLocation' => 'Photo big',
-  'object_chatEmpty' => 'Empty chat',
-  'object_chatEmpty_param_id_type_int' => 'ID',
-  'object_chat' => 'Chat',
-  'object_chat_param_creator_type_true' => 'Creator?',
-  'object_chat_param_kicked_type_true' => 'Kicked?',
-  'object_chat_param_left_type_true' => 'Left?',
+  'object_user_param_bot_inline_placeholder_type_string' => 'Inline placeholder for this inline bot',
+  'object_user_param_lang_code_type_string' => 'Language code of the user',
+  'object_userProfilePhotoEmpty' => 'Profile photo has not been set, or was hidden.',
+  'object_userProfilePhoto' => 'User profile photo.',
+  'object_userProfilePhoto_param_photo_id_type_long' => 'Identifier of the respective photo
Parameter added in [Layer 2](https://core.telegram.org/api/layers#layer-2)',
+  'object_userProfilePhoto_param_photo_small_type_FileLocation' => 'Location of the file, corresponding to the small profile photo thumbnail',
+  'object_userProfilePhoto_param_photo_big_type_FileLocation' => 'Location of the file, corresponding to the big profile photo thumbnail',
+  'object_chatEmpty' => 'Empty constructor, group doesn\'t exist',
+  'object_chatEmpty_param_id_type_int' => 'Group identifier',
+  'object_chat' => 'Info about a group',
+  'object_chat_param_creator_type_true' => 'Whether the current user is the creator of the group',
+  'object_chat_param_kicked_type_true' => 'Whether the current user was kicked from the group',
+  'object_chat_param_left_type_true' => 'Whether the current user has left the group',
   'object_chat_param_admins_enabled_type_true' => 'Admins enabled?',
   'object_chat_param_admin_type_true' => 'Admin?',
-  'object_chat_param_deactivated_type_true' => 'Deactivated?',
-  'object_chat_param_id_type_int' => 'ID',
+  'object_chat_param_deactivated_type_true' => 'Whether the group was [migrated](https://core.telegram.org/api/channel)',
+  'object_chat_param_id_type_int' => 'ID of the group',
   'object_chat_param_title_type_string' => 'Title',
-  'object_chat_param_photo_type_ChatPhoto' => 'Photo',
-  'object_chat_param_participants_count_type_int' => 'Participants count',
-  'object_chat_param_date_type_int' => 'Date',
-  'object_chat_param_version_type_int' => 'Version',
-  'object_chat_param_migrated_to_type_InputChannel' => 'Migrated to',
-  'object_chatForbidden' => 'Chat forbidden',
-  'object_chatForbidden_param_id_type_int' => 'ID',
-  'object_chatForbidden_param_title_type_string' => 'Title',
-  'object_channel' => 'Channel',
-  'object_channel_param_creator_type_true' => 'Creator?',
-  'object_channel_param_left_type_true' => 'Left?',
+  'object_chat_param_photo_type_ChatPhoto' => 'Chat photo',
+  'object_chat_param_participants_count_type_int' => 'Participant count',
+  'object_chat_param_date_type_int' => 'Date of creation of the group',
+  'object_chat_param_version_type_int' => 'Used in basic groups to reorder updates and make sure that all of them were received.',
+  'object_chat_param_migrated_to_type_InputChannel' => 'Means this chat was [upgraded](https://core.telegram.org/api/channel) to a supergroup',
+  'object_chatForbidden' => 'A group to which the user has no access. E.g., because the user was kicked from the group.',
+  'object_chatForbidden_param_id_type_int' => 'User identifier',
+  'object_chatForbidden_param_title_type_string' => 'Group name',
+  'object_channel' => 'Channel/supergroup info',
+  'object_channel_param_creator_type_true' => 'Whether the current user is the creator of this channel',
+  'object_channel_param_left_type_true' => 'Whether the current user has left this channel',
   'object_channel_param_editor_type_true' => 'Editor?',
-  'object_channel_param_broadcast_type_true' => 'Broadcast?',
-  'object_channel_param_verified_type_true' => 'Verified?',
-  'object_channel_param_megagroup_type_true' => 'Megagroup?',
-  'object_channel_param_restricted_type_true' => 'Restricted?',
+  'object_channel_param_broadcast_type_true' => 'Is this a channel?',
+  'object_channel_param_verified_type_true' => 'Is this channel verified by telegram?',
+  'object_channel_param_megagroup_type_true' => 'Is this a supergroup?',
+  'object_channel_param_restricted_type_true' => 'Whether viewing/writing in this channel for a reason (see `restriction_reason`',
   'object_channel_param_democracy_type_true' => 'Democracy?',
-  'object_channel_param_signatures_type_true' => 'Signatures?',
-  'object_channel_param_min_type_true' => 'Min?',
-  'object_channel_param_id_type_int' => 'ID',
+  'object_channel_param_signatures_type_true' => 'Whether signatures are enabled (channels)',
+  'object_channel_param_min_type_true' => 'See [min](https://core.telegram.org/api/min)',
+  'object_channel_param_id_type_int' => 'ID of the channel',
   'object_channel_param_access_hash_type_long' => 'Access hash',
   'object_channel_param_title_type_string' => 'Title',
   'object_channel_param_username_type_string' => 'Username',
-  'object_channel_param_photo_type_ChatPhoto' => 'Photo',
-  'object_channel_param_date_type_int' => 'Date',
-  'object_channel_param_version_type_int' => 'Version',
+  'object_channel_param_photo_type_ChatPhoto' => 'Profile photo',
+  'object_channel_param_date_type_int' => 'Creation date',
+  'object_channel_param_version_type_int' => 'Version of the channel (always `0`)',
   'object_channel_param_restriction_reason_type_string' => 'Restriction reason',
   'object_channel_param_admin_rights_type_ChannelAdminRights' => 'Admin rights',
   'object_channel_param_banned_rights_type_ChannelBannedRights' => 'Banned rights',
-  'object_channel_param_participants_count_type_int' => 'Participants count',
-  'object_channelForbidden' => 'Forbidden channel',
-  'object_channelForbidden_param_broadcast_type_true' => 'Broadcast?',
-  'object_channelForbidden_param_megagroup_type_true' => 'Megagroup?',
-  'object_channelForbidden_param_id_type_int' => 'ID',
+  'object_channel_param_participants_count_type_int' => 'Participant count',
+  'object_channelForbidden' => 'Indicates a channel/supergroup we can\'t access because we were banned, or for some other reason.',
+  'object_channelForbidden_param_broadcast_type_true' => 'Is this a channel',
+  'object_channelForbidden_param_megagroup_type_true' => 'Is this a supergroup',
+  'object_channelForbidden_param_id_type_int' => 'Channel ID',
   'object_channelForbidden_param_access_hash_type_long' => 'Access hash',
   'object_channelForbidden_param_title_type_string' => 'Title',
-  'object_channelForbidden_param_until_date_type_int' => 'Until date',
-  'object_chatFull' => 'Chat full',
-  'object_chatFull_param_id_type_int' => 'ID',
-  'object_chatFull_param_participants_type_ChatParticipants' => 'Participants',
+  'object_channelForbidden_param_until_date_type_int' => 'The ban is valid until the specified date',
+  'object_chatFull' => 'Detailed chat info',
+  'object_chatFull_param_id_type_int' => 'ID of the chat',
+  'object_chatFull_param_participants_type_ChatParticipants' => 'Participant list',
   'object_chatFull_param_chat_photo_type_Photo' => 'Chat photo',
-  'object_chatFull_param_notify_settings_type_PeerNotifySettings' => 'Notify settings',
-  'object_chatFull_param_exported_invite_type_ExportedChatInvite' => 'Exported invite',
+  'object_chatFull_param_notify_settings_type_PeerNotifySettings' => 'Notification settings',
+  'object_chatFull_param_exported_invite_type_ExportedChatInvite' => 'Chat invite',
   'object_chatFull_param_bot_info_type_Vector t' => 'Bot info',
-  'object_channelFull' => 'Full channel',
-  'object_channelFull_param_can_view_participants_type_true' => 'Can view participants?',
-  'object_channelFull_param_can_set_username_type_true' => 'Can set username?',
-  'object_channelFull_param_can_set_stickers_type_true' => 'Can set group stickerset?',
-  'object_channelFull_param_hidden_prehistory_type_true' => 'Hidden prehistory?',
-  'object_channelFull_param_id_type_int' => 'ID',
-  'object_channelFull_param_about_type_string' => 'About',
-  'object_channelFull_param_participants_count_type_int' => 'Participants count',
-  'object_channelFull_param_admins_count_type_int' => 'Admins count',
-  'object_channelFull_param_kicked_count_type_int' => 'Kicked count',
-  'object_channelFull_param_banned_count_type_int' => 'Banned count',
-  'object_channelFull_param_read_inbox_max_id_type_int' => 'Read inbox max ID',
-  'object_channelFull_param_read_outbox_max_id_type_int' => 'Read outbox max ID',
-  'object_channelFull_param_unread_count_type_int' => 'Unread count',
-  'object_channelFull_param_chat_photo_type_Photo' => 'Chat photo',
-  'object_channelFull_param_notify_settings_type_PeerNotifySettings' => 'Notify settings',
-  'object_channelFull_param_exported_invite_type_ExportedChatInvite' => 'Exported invite',
+  'object_channelFull' => 'Full info about a [channel/supergroup](https://core.telegram.org/api/channel)',
+  'object_channelFull_param_can_view_participants_type_true' => 'Can we vew the participant list?',
+  'object_channelFull_param_can_set_username_type_true' => 'Can we set the channel\'s username?',
+  'object_channelFull_param_can_set_stickers_type_true' => 'Can we [associate](../methods/channels.setStickers.md) a stickerpack to the supergroup?',
+  'object_channelFull_param_hidden_prehistory_type_true' => 'Is the history before we joined hidden to us?',
+  'object_channelFull_param_id_type_int' => 'ID of the channel',
+  'object_channelFull_param_about_type_string' => 'Info about the channel',
+  'object_channelFull_param_participants_count_type_int' => 'Number of participants of the channel',
+  'object_channelFull_param_admins_count_type_int' => 'Number of channel admins',
+  'object_channelFull_param_kicked_count_type_int' => 'Number of users [kicked](https://core.telegram.org/api/rights) from the channel',
+  'object_channelFull_param_banned_count_type_int' => 'Number of users [banned](https://core.telegram.org/api/rights) from the channel',
+  'object_channelFull_param_read_inbox_max_id_type_int' => 'Position up to which all incoming messages are read.',
+  'object_channelFull_param_read_outbox_max_id_type_int' => 'Position up to which all outgoing messages are read.',
+  'object_channelFull_param_unread_count_type_int' => 'Count of unread messages',
+  'object_channelFull_param_chat_photo_type_Photo' => 'Channel picture',
+  'object_channelFull_param_notify_settings_type_PeerNotifySettings' => 'Notification settings',
+  'object_channelFull_param_exported_invite_type_ExportedChatInvite' => 'Invite link',
   'object_channelFull_param_bot_info_type_Vector t' => 'Bot info',
-  'object_channelFull_param_migrated_from_chat_id_type_int' => 'Migrated from chat ID',
-  'object_channelFull_param_migrated_from_max_id_type_int' => 'Migrated from max ID',
-  'object_channelFull_param_pinned_msg_id_type_int' => 'Pinned msg ID',
-  'object_channelFull_param_stickerset_type_StickerSet' => 'Stickerset',
-  'object_channelFull_param_available_min_id_type_int' => 'Available min ID',
-  'object_chatParticipant' => 'Chat participant',
-  'object_chatParticipant_param_user_id_type_int' => 'User ID',
-  'object_chatParticipant_param_inviter_id_type_int' => 'Inviter ID',
-  'object_chatParticipant_param_date_type_int' => 'Date',
-  'object_chatParticipantCreator' => 'Chat participant creator',
-  'object_chatParticipantCreator_param_user_id_type_int' => 'User ID',
-  'object_chatParticipantAdmin' => 'Chat participant admin',
-  'object_chatParticipantAdmin_param_user_id_type_int' => 'User ID',
-  'object_chatParticipantAdmin_param_inviter_id_type_int' => 'Inviter ID',
-  'object_chatParticipantAdmin_param_date_type_int' => 'Date',
-  'object_chatParticipantsForbidden' => 'Chat participants forbidden',
-  'object_chatParticipantsForbidden_param_chat_id_type_int' => 'Chat ID',
-  'object_chatParticipantsForbidden_param_self_participant_type_ChatParticipant' => 'Self participant',
-  'object_chatParticipants' => 'Chat participants',
-  'object_chatParticipants_param_chat_id_type_int' => 'Chat ID',
+  'object_channelFull_param_migrated_from_chat_id_type_int' => 'The chat ID from which this group was [migrated](https://core.telegram.org/api/channel)',
+  'object_channelFull_param_migrated_from_max_id_type_int' => 'The message ID in the original chat at which this group was [migrated](https://core.telegram.org/api/channel)',
+  'object_channelFull_param_pinned_msg_id_type_int' => 'Message ID of the pinned message',
+  'object_channelFull_param_stickerset_type_StickerSet' => 'Associated stickerset',
+  'object_channelFull_param_available_min_id_type_int' => 'Identifier of a maximum unavailable message in a channel due to hidden history.',
+  'object_chatParticipant' => 'Group member.',
+  'object_chatParticipant_param_user_id_type_int' => 'Member user ID',
+  'object_chatParticipant_param_inviter_id_type_int' => 'ID of the user that added the member to the group',
+  'object_chatParticipant_param_date_type_int' => 'Date added to the group',
+  'object_chatParticipantCreator' => 'Represents the creator of the group',
+  'object_chatParticipantCreator_param_user_id_type_int' => 'ID of the user that created the group',
+  'object_chatParticipantAdmin' => 'Chat admin',
+  'object_chatParticipantAdmin_param_user_id_type_int' => 'ID of a group member that is admin',
+  'object_chatParticipantAdmin_param_inviter_id_type_int' => 'ID of the user that added the member to the group',
+  'object_chatParticipantAdmin_param_date_type_int' => 'Date when the user was added',
+  'object_chatParticipantsForbidden' => 'Info on members is unavailable',
+  'object_chatParticipantsForbidden_param_chat_id_type_int' => 'Group ID',
+  'object_chatParticipantsForbidden_param_self_participant_type_ChatParticipant' => 'Info about the group membership of the current user',
+  'object_chatParticipants' => 'Group members.',
+  'object_chatParticipants_param_chat_id_type_int' => 'Group identifier',
   'object_chatParticipants_param_participants_type_Vector t' => 'Participants',
-  'object_chatParticipants_param_version_type_int' => 'Version',
-  'object_chatPhotoEmpty' => 'Empty chat photo',
-  'object_chatPhoto' => 'Chat photo',
-  'object_chatPhoto_param_photo_small_type_FileLocation' => 'Photo small',
-  'object_chatPhoto_param_photo_big_type_FileLocation' => 'Photo big',
-  'object_messageEmpty' => 'Empty message',
-  'object_messageEmpty_param_id_type_int' => 'ID',
-  'object_message' => 'Message',
-  'object_message_param_out_type_true' => 'Out?',
-  'object_message_param_mentioned_type_true' => 'Mentioned?',
-  'object_message_param_media_unread_type_true' => 'Media unread?',
-  'object_message_param_silent_type_true' => 'Silent?',
-  'object_message_param_post_type_true' => 'Post?',
-  'object_message_param_id_type_int' => 'ID',
-  'object_message_param_from_id_type_int' => 'From ID',
-  'object_message_param_to_id_type_Peer' => 'To ID',
-  'object_message_param_fwd_from_type_MessageFwdHeader' => 'Forwarded from',
-  'object_message_param_via_bot_id_type_int' => 'Via bot ID',
-  'object_message_param_reply_to_msg_id_type_int' => 'Reply to msg ID',
-  'object_message_param_date_type_int' => 'Date',
-  'object_message_param_message_type_string' => 'Message',
-  'object_message_param_media_type_MessageMedia' => 'Media',
-  'object_message_param_reply_markup_type_ReplyMarkup' => 'Reply markup',
+  'object_chatParticipants_param_version_type_int' => 'Group version number',
+  'object_chatPhotoEmpty' => 'Group photo is not set.',
+  'object_chatPhoto' => 'Group profile photo.',
+  'object_chatPhoto_param_photo_small_type_FileLocation' => 'Location of the file corresponding to the small thumbnail for group profile photo',
+  'object_chatPhoto_param_photo_big_type_FileLocation' => 'Location of the file corresponding to the small thumbnail for group profile photo',
+  'object_messageEmpty' => 'Empty constructor, non-existent message.',
+  'object_messageEmpty_param_id_type_int' => 'Message identifier',
+  'object_message' => 'A message',
+  'object_message_param_out_type_true' => 'Is this an outgoing message',
+  'object_message_param_mentioned_type_true' => 'Whether we were mentioned in this message',
+  'object_message_param_media_unread_type_true' => 'Whether there are unread media attachments in this message',
+  'object_message_param_silent_type_true' => 'Whether this is a silent message (no notification triggered)',
+  'object_message_param_post_type_true' => 'Whether this is a channel post',
+  'object_message_param_id_type_int' => 'ID of the message',
+  'object_message_param_from_id_type_int' => 'ID of the sender of the message',
+  'object_message_param_to_id_type_Peer' => 'ID of the chat were the message was sent',
+  'object_message_param_fwd_from_type_MessageFwdHeader' => 'Info about forwarded messages',
+  'object_message_param_via_bot_id_type_int' => 'ID of the inline bot that generated the message',
+  'object_message_param_reply_to_msg_id_type_int' => 'ID of the message this message replies to',
+  'object_message_param_date_type_int' => 'Date of the message',
+  'object_message_param_message_type_string' => 'The message',
+  'object_message_param_media_type_MessageMedia' => 'Media attachment',
+  'object_message_param_reply_markup_type_ReplyMarkup' => 'Reply markup (bot/inline keyboards)',
   'object_message_param_entities_type_Vector t' => 'Entities',
-  'object_message_param_views_type_int' => 'Views',
-  'object_message_param_edit_date_type_int' => 'Edit date',
-  'object_message_param_post_author_type_string' => 'Post author',
-  'object_message_param_grouped_id_type_long' => 'Grouped ID',
-  'object_messageService' => 'Message service',
-  'object_messageService_param_out_type_true' => 'Out?',
-  'object_messageService_param_mentioned_type_true' => 'Mentioned?',
-  'object_messageService_param_media_unread_type_true' => 'Media unread?',
-  'object_messageService_param_silent_type_true' => 'Silent?',
-  'object_messageService_param_post_type_true' => 'Post?',
-  'object_messageService_param_id_type_int' => 'ID',
-  'object_messageService_param_from_id_type_int' => 'From ID',
-  'object_messageService_param_to_id_type_Peer' => 'To ID',
-  'object_messageService_param_reply_to_msg_id_type_int' => 'Reply to msg ID',
-  'object_messageService_param_date_type_int' => 'Date',
-  'object_messageService_param_action_type_MessageAction' => 'Action',
-  'object_messageMediaEmpty' => 'Empty message media',
-  'object_messageMediaPhoto' => 'Message media photo',
+  'object_message_param_views_type_int' => 'View count for channel posts',
+  'object_message_param_edit_date_type_int' => 'Last edit date of this message',
+  'object_message_param_post_author_type_string' => 'Name of the author of this message for channel posts (with signatures enabled)',
+  'object_message_param_grouped_id_type_long' => 'Multiple media messages sent using [messages.sendMultiMedia](../methods/messages.sendMultiMedia.md) with the same grouped ID indicate an album',
+  'object_messageService' => 'Indicates a service message',
+  'object_messageService_param_out_type_true' => 'Whether the message is outgoing',
+  'object_messageService_param_mentioned_type_true' => 'Whether we were mentioned in the message',
+  'object_messageService_param_media_unread_type_true' => 'Whether the message contains unread media',
+  'object_messageService_param_silent_type_true' => 'Whether the message is silent',
+  'object_messageService_param_post_type_true' => 'Whether it\'s a channel post',
+  'object_messageService_param_id_type_int' => 'Message ID',
+  'object_messageService_param_from_id_type_int' => 'Id of te sender of the message',
+  'object_messageService_param_to_id_type_Peer' => 'ID of the destination of the message',
+  'object_messageService_param_reply_to_msg_id_type_int' => 'ID of the message this message replies to',
+  'object_messageService_param_date_type_int' => 'Message date',
+  'object_messageService_param_action_type_MessageAction' => 'Event connected with the service message',
+  'object_messageMediaEmpty' => 'Empty constructor.',
+  'object_messageMediaPhoto' => 'Attached photo.',
   'object_messageMediaPhoto_param_photo_type_Photo' => 'Photo',
-  'object_messageMediaPhoto_param_ttl_seconds_type_int' => 'Ttl seconds',
-  'object_messageMediaGeo' => 'Message media geo',
-  'object_messageMediaGeo_param_geo_type_GeoPoint' => 'Geo',
-  'object_messageMediaContact' => 'Message media contact',
+  'object_messageMediaPhoto_param_ttl_seconds_type_int' => 'Time to live in seconds of self-destructing photo',
+  'object_messageMediaGeo' => 'Attached map.',
+  'object_messageMediaGeo_param_geo_type_GeoPoint' => 'GeoPoint',
+  'object_messageMediaContact' => 'Attached contact.',
   'object_messageMediaContact_param_phone_number_type_string' => 'Phone number',
-  'object_messageMediaContact_param_first_name_type_string' => 'First name',
-  'object_messageMediaContact_param_last_name_type_string' => 'Last name',
-  'object_messageMediaContact_param_user_id_type_int' => 'User ID',
-  'object_messageMediaUnsupported' => 'Message media unsupported',
-  'object_messageMediaDocument' => 'Message media document',
-  'object_messageMediaDocument_param_document_type_Document' => 'Document',
-  'object_messageMediaDocument_param_ttl_seconds_type_int' => 'Ttl seconds',
-  'object_messageMediaWebPage' => 'Message media web page',
-  'object_messageMediaWebPage_param_webpage_type_WebPage' => 'Webpage',
-  'object_messageMediaVenue' => 'Message media venue',
-  'object_messageMediaVenue_param_geo_type_GeoPoint' => 'Geo',
-  'object_messageMediaVenue_param_title_type_string' => 'Title',
+  'object_messageMediaContact_param_first_name_type_string' => 'Contact\'s first name',
+  'object_messageMediaContact_param_last_name_type_string' => 'Contact\'s last name',
+  'object_messageMediaContact_param_user_id_type_int' => 'User identifier or `0`, if the user with the given phone number is not registered',
+  'object_messageMediaUnsupported' => 'Current version of the client does not support this media type.',
+  'object_messageMediaDocument' => 'Document (video, audio, voice, sticker, any media type except photo)',
+  'object_messageMediaDocument_param_document_type_Document' => 'Attached document',
+  'object_messageMediaDocument_param_ttl_seconds_type_int' => 'Time to live of self-destructing document',
+  'object_messageMediaWebPage' => 'Preview of webpage',
+  'object_messageMediaWebPage_param_webpage_type_WebPage' => 'Webpage preview',
+  'object_messageMediaVenue' => 'Venue',
+  'object_messageMediaVenue_param_geo_type_GeoPoint' => 'Geolocation of venue',
+  'object_messageMediaVenue_param_title_type_string' => 'Venue name',
   'object_messageMediaVenue_param_address_type_string' => 'Address',
-  'object_messageMediaVenue_param_provider_type_string' => 'Provider',
-  'object_messageMediaVenue_param_venue_id_type_string' => 'Venue ID',
-  'object_messageMediaVenue_param_venue_type_type_string' => 'Venue type',
-  'object_messageMediaGame' => 'Message media game',
+  'object_messageMediaVenue_param_provider_type_string' => 'Venue provider: currently only "foursquare" needs to be supported',
+  'object_messageMediaVenue_param_venue_id_type_string' => 'Venue ID in the provider\'s database',
+  'object_messageMediaVenue_param_venue_type_type_string' => 'Venue type in the provider\'s database',
+  'object_messageMediaGame' => 'Telegram game',
   'object_messageMediaGame_param_game_type_Game' => 'Game',
-  'object_messageMediaInvoice' => 'Message media invoice',
-  'object_messageMediaInvoice_param_shipping_address_requested_type_true' => 'Shipping address requested?',
-  'object_messageMediaInvoice_param_test_type_true' => 'Test?',
-  'object_messageMediaInvoice_param_title_type_string' => 'Title',
-  'object_messageMediaInvoice_param_description_type_string' => 'Description',
-  'object_messageMediaInvoice_param_photo_type_WebDocument' => 'Photo',
-  'object_messageMediaInvoice_param_receipt_msg_id_type_int' => 'Receipt msg ID',
-  'object_messageMediaInvoice_param_currency_type_string' => 'Currency',
-  'object_messageMediaInvoice_param_total_amount_type_long' => 'Total amount',
-  'object_messageMediaInvoice_param_start_param_type_string' => 'Start param',
-  'object_messageMediaGeoLive' => 'Message media geo live',
-  'object_messageMediaGeoLive_param_geo_type_GeoPoint' => 'Geo',
-  'object_messageMediaGeoLive_param_period_type_int' => 'Period',
-  'object_messageActionEmpty' => 'Empty message action',
-  'object_messageActionChatCreate' => 'Message action chat create',
-  'object_messageActionChatCreate_param_title_type_string' => 'Title',
+  'object_messageMediaInvoice' => 'Invoice',
+  'object_messageMediaInvoice_param_shipping_address_requested_type_true' => 'Whether the shipping address was requested',
+  'object_messageMediaInvoice_param_test_type_true' => 'Whether this is an example invoice',
+  'object_messageMediaInvoice_param_title_type_string' => 'Product name, 1-32 characters',
+  'object_messageMediaInvoice_param_description_type_string' => 'Product description, 1-255 characters',
+  'object_messageMediaInvoice_param_photo_type_WebDocument' => 'URL of the product photo for the invoice. Can be a photo of the goods or a marketing image for a service. People like it better when they see what they are paying for.',
+  'object_messageMediaInvoice_param_receipt_msg_id_type_int' => 'Message ID of receipt: if set, clients should change the text of the first [keyboardButtonBuy](../constructors/keyboardButtonBuy.md) button always attached to the [message](../constructors/message.md) to a localized version of the word `Receipt`',
+  'object_messageMediaInvoice_param_currency_type_string' => 'Three-letter ISO 4217 [currency](https://core.telegram.org/bots/payments#supported-currencies) code',
+  'object_messageMediaInvoice_param_total_amount_type_long' => 'Total price in the smallest units of the currency (integer, not float/double). For example, for a price of `US$ 1.45` pass `amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).',
+  'object_messageMediaInvoice_param_start_param_type_string' => 'Unique bot deep-linking parameter that can be used to generate this invoice',
+  'object_messageMediaGeoLive' => 'Indicates a live geolocation',
+  'object_messageMediaGeoLive_param_geo_type_GeoPoint' => 'Geolocation',
+  'object_messageMediaGeoLive_param_period_type_int' => 'Validity period of provided geolocation',
+  'object_messageActionEmpty' => 'Empty constructor.',
+  'object_messageActionChatCreate' => 'Group created',
+  'object_messageActionChatCreate_param_title_type_string' => 'Group name',
   'object_messageActionChatCreate_param_users_type_Vector t' => 'Users',
-  'object_messageActionChatEditTitle' => 'Message action chat edit title',
-  'object_messageActionChatEditTitle_param_title_type_string' => 'Title',
-  'object_messageActionChatEditPhoto' => 'Message action chat edit photo',
-  'object_messageActionChatEditPhoto_param_photo_type_Photo' => 'Photo',
-  'object_messageActionChatDeletePhoto' => 'Message action chat delete photo',
-  'object_messageActionChatAddUser' => 'Message action chat add user',
+  'object_messageActionChatEditTitle' => 'Group name changed.',
+  'object_messageActionChatEditTitle_param_title_type_string' => 'New group name',
+  'object_messageActionChatEditPhoto' => 'Group profile changed',
+  'object_messageActionChatEditPhoto_param_photo_type_Photo' => 'New group pofile photo',
+  'object_messageActionChatDeletePhoto' => 'Group profile photo removed.',
+  'object_messageActionChatAddUser' => 'New member in the group',
   'object_messageActionChatAddUser_param_users_type_Vector t' => 'Users',
-  'object_messageActionChatDeleteUser' => 'Message action chat delete user',
-  'object_messageActionChatDeleteUser_param_user_id_type_int' => 'User ID',
-  'object_messageActionChatJoinedByLink' => 'Message action chat joined by link',
-  'object_messageActionChatJoinedByLink_param_inviter_id_type_int' => 'Inviter ID',
-  'object_messageActionChannelCreate' => 'Message action channel create',
-  'object_messageActionChannelCreate_param_title_type_string' => 'Title',
-  'object_messageActionChatMigrateTo' => 'Message action chat migrate to',
-  'object_messageActionChatMigrateTo_param_channel_id_type_int' => 'Channel ID',
-  'object_messageActionChannelMigrateFrom' => 'Message action channel migrate from',
-  'object_messageActionChannelMigrateFrom_param_title_type_string' => 'Title',
-  'object_messageActionChannelMigrateFrom_param_chat_id_type_int' => 'Chat ID',
-  'object_messageActionPinMessage' => 'Message action pin message',
-  'object_messageActionHistoryClear' => 'Message action history clear',
-  'object_messageActionGameScore' => 'Message action game score',
+  'object_messageActionChatDeleteUser' => 'User left the group.',
+  'object_messageActionChatDeleteUser_param_user_id_type_int' => 'Leaving user ID',
+  'object_messageActionChatJoinedByLink' => 'A user joined the chat via an invite link',
+  'object_messageActionChatJoinedByLink_param_inviter_id_type_int' => 'ID of the user that created the invite link',
+  'object_messageActionChannelCreate' => 'The channel was created',
+  'object_messageActionChannelCreate_param_title_type_string' => 'Original channel/supergroup title',
+  'object_messageActionChatMigrateTo' => 'Indicates the chat was [migrated](https://core.telegram.org/api/channel) to the specified supergroup',
+  'object_messageActionChatMigrateTo_param_channel_id_type_int' => 'The supergroup it was migrated to',
+  'object_messageActionChannelMigrateFrom' => 'Indicates the channel was [migrated](https://core.telegram.org/api/channel) from the specified chat',
+  'object_messageActionChannelMigrateFrom_param_title_type_string' => 'The old chat tite',
+  'object_messageActionChannelMigrateFrom_param_chat_id_type_int' => 'The old chat ID',
+  'object_messageActionPinMessage' => 'A message was pinned',
+  'object_messageActionHistoryClear' => 'Chat history was cleared',
+  'object_messageActionGameScore' => 'Someone scored in a game',
   'object_messageActionGameScore_param_game_id_type_long' => 'Game ID',
   'object_messageActionGameScore_param_score_type_int' => 'Score',
-  'object_messageActionPaymentSentMe' => 'Message action payment sent me',
-  'object_messageActionPaymentSentMe_param_currency_type_string' => 'Currency',
-  'object_messageActionPaymentSentMe_param_total_amount_type_long' => 'Total amount',
-  'object_messageActionPaymentSentMe_param_payload_type_bytes' => 'Payload',
-  'object_messageActionPaymentSentMe_param_info_type_PaymentRequestedInfo' => 'Info',
-  'object_messageActionPaymentSentMe_param_shipping_option_id_type_string' => 'Shipping option ID',
-  'object_messageActionPaymentSentMe_param_charge_type_PaymentCharge' => 'Charge',
-  'object_messageActionPaymentSent' => 'Message action payment sent',
-  'object_messageActionPaymentSent_param_currency_type_string' => 'Currency',
-  'object_messageActionPaymentSent_param_total_amount_type_long' => 'Total amount',
-  'object_messageActionPhoneCall' => 'Message action phone call',
+  'object_messageActionPaymentSentMe' => 'A user just sent a payment to me (a bot)',
+  'object_messageActionPaymentSentMe_param_currency_type_string' => 'Three-letter ISO 4217 [currency](https://core.telegram.org/bots/payments#supported-currencies) code',
+  'object_messageActionPaymentSentMe_param_total_amount_type_long' => 'Price of the product in the smallest units of the currency (integer, not float/double). For example, for a price of `US$ 1.45` pass `amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).',
+  'object_messageActionPaymentSentMe_param_payload_type_bytes' => 'Bot specified invoice payload',
+  'object_messageActionPaymentSentMe_param_info_type_PaymentRequestedInfo' => 'Order info provided by the user',
+  'object_messageActionPaymentSentMe_param_shipping_option_id_type_string' => 'Identifier of the shipping option chosen by the user',
+  'object_messageActionPaymentSentMe_param_charge_type_PaymentCharge' => 'Provider payment identifier',
+  'object_messageActionPaymentSent' => 'A payment was sent',
+  'object_messageActionPaymentSent_param_currency_type_string' => 'Three-letter ISO 4217 [currency](https://core.telegram.org/bots/payments#supported-currencies) code',
+  'object_messageActionPaymentSent_param_total_amount_type_long' => 'Price of the product in the smallest units of the currency (integer, not float/double). For example, for a price of `US$ 1.45` pass `amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).',
+  'object_messageActionPhoneCall' => 'A phone call',
   'object_messageActionPhoneCall_param_call_id_type_long' => 'Call ID',
-  'object_messageActionPhoneCall_param_reason_type_PhoneCallDiscardReason' => 'Reason',
-  'object_messageActionPhoneCall_param_duration_type_int' => 'Duration',
-  'object_messageActionScreenshotTaken' => 'Message action screenshot taken',
-  'object_messageActionCustomAction' => 'Message action custom action',
-  'object_messageActionCustomAction_param_message_type_string' => 'Message',
-  'object_dialog' => 'Dialog',
-  'object_dialog_param_pinned_type_true' => 'Pinned?',
-  'object_dialog_param_peer_type_Peer' => 'Peer',
-  'object_dialog_param_top_message_type_int' => 'Top message',
-  'object_dialog_param_read_inbox_max_id_type_int' => 'Read inbox max ID',
-  'object_dialog_param_read_outbox_max_id_type_int' => 'Read outbox max ID',
-  'object_dialog_param_unread_count_type_int' => 'Unread count',
-  'object_dialog_param_unread_mentions_count_type_int' => 'Unread mentions count',
-  'object_dialog_param_notify_settings_type_PeerNotifySettings' => 'Notify settings',
-  'object_dialog_param_pts_type_int' => 'Pts',
-  'object_dialog_param_draft_type_DraftMessage' => 'Draft',
-  'object_photoEmpty' => 'Empty photo',
-  'object_photoEmpty_param_id_type_long' => 'ID',
+  'object_messageActionPhoneCall_param_reason_type_PhoneCallDiscardReason' => 'If the call has ended, the reason why it ended',
+  'object_messageActionPhoneCall_param_duration_type_int' => 'Duration of the call in seconds',
+  'object_messageActionScreenshotTaken' => 'A screenshot of the chat was taken',
+  'object_messageActionCustomAction' => 'Custom action (most likely not supported by the current layer, an upgrade might be needed)',
+  'object_messageActionCustomAction_param_message_type_string' => 'Action message',
+  'object_dialog' => 'Chat',
+  'object_dialog_param_pinned_type_true' => 'Is the dialog pinned',
+  'object_dialog_param_peer_type_Peer' => 'The chat',
+  'object_dialog_param_top_message_type_int' => 'The latest message ID',
+  'object_dialog_param_read_inbox_max_id_type_int' => 'Position up to which all incoming messages are read.',
+  'object_dialog_param_read_outbox_max_id_type_int' => 'Position up to which all outgoing messages are read.',
+  'object_dialog_param_unread_count_type_int' => 'Number of unread messages',
+  'object_dialog_param_unread_mentions_count_type_int' => 'Number of unread mentions',
+  'object_dialog_param_notify_settings_type_PeerNotifySettings' => 'Notification settings',
+  'object_dialog_param_pts_type_int' => '[PTS](https://core.telegram.org/api/updates)',
+  'object_dialog_param_draft_type_DraftMessage' => 'Message draft',
+  'object_photoEmpty' => 'Empty constructor, non-existent photo',
+  'object_photoEmpty_param_id_type_long' => 'Photo identifier',
   'object_photo' => 'Photo',
-  'object_photo_param_has_stickers_type_true' => 'Has stickers?',
+  'object_photo_param_has_stickers_type_true' => 'Whether the photo has mask stickers attached to it',
   'object_photo_param_id_type_long' => 'ID',
   'object_photo_param_access_hash_type_long' => 'Access hash',
-  'object_photo_param_date_type_int' => 'Date',
+  'object_photo_param_date_type_int' => 'Date of upload',
   'object_photo_param_sizes_type_Vector t' => 'Sizes',
-  'object_photoSizeEmpty' => 'Empty photo size',
-  'object_photoSizeEmpty_param_type_type_string' => 'Type',
-  'object_photoSize' => 'Photo size',
-  'object_photoSize_param_type_type_string' => 'Type',
-  'object_photoSize_param_location_type_FileLocation' => 'Location',
-  'object_photoSize_param_w_type_int' => 'Width',
-  'object_photoSize_param_h_type_int' => 'Height',
-  'object_photoSize_param_size_type_int' => 'Size',
-  'object_photoCachedSize' => 'Photo cached size',
-  'object_photoCachedSize_param_type_type_string' => 'Type',
-  'object_photoCachedSize_param_location_type_FileLocation' => 'Location',
-  'object_photoCachedSize_param_w_type_int' => 'Width',
-  'object_photoCachedSize_param_h_type_int' => 'Height',
-  'object_photoCachedSize_param_bytes_type_bytes' => 'Bytes',
-  'object_geoPointEmpty' => 'Empty geo point',
-  'object_geoPoint' => 'Geo point',
-  'object_geoPoint_param_long_type_double' => 'Long',
-  'object_geoPoint_param_lat_type_double' => 'Lat',
+  'object_photoSizeEmpty' => 'Empty constructor. Image with this thumbnail is unavailable.',
+  'object_photoSizeEmpty_param_type_type_string' => 'Thumbnail type (see. [photoSize](../constructors/photoSize.md))',
+  'object_photoSize' => 'Image description.',
+  'object_photoSize_param_type_type_string' => 'Thumbnail type',
+  'object_photoSize_param_location_type_FileLocation' => 'File location',
+  'object_photoSize_param_w_type_int' => 'Image width',
+  'object_photoSize_param_h_type_int' => 'Image height',
+  'object_photoSize_param_size_type_int' => 'File size',
+  'object_photoCachedSize' => 'Description of an image and its content.',
+  'object_photoCachedSize_param_type_type_string' => 'Thumbnail type',
+  'object_photoCachedSize_param_location_type_FileLocation' => 'File location',
+  'object_photoCachedSize_param_w_type_int' => 'Image width',
+  'object_photoCachedSize_param_h_type_int' => 'Image height',
+  'object_photoCachedSize_param_bytes_type_bytes' => 'Binary data, file content',
+  'object_geoPointEmpty' => 'Empty constructor.',
+  'object_geoPoint' => 'GeoPoint.',
+  'object_geoPoint_param_long_type_double' => 'Longtitude',
+  'object_geoPoint_param_lat_type_double' => 'Latitude',
   'object_auth.checkedPhone' => 'Checked phone',
   'object_auth.checkedPhone_param_phone_registered_type_Bool' => 'Phone registered?',
-  'object_auth.sentCode' => 'Sent code',
+  'object_auth.sentCode' => 'Contains info about a sent verification code.',
   'object_auth.sentCode_param_phone_registered_type_true' => 'Phone registered?',
-  'object_auth.sentCode_param_type_type_auth.SentCodeType' => 'Type',
-  'object_auth.sentCode_param_phone_code_hash_type_string' => 'Phone code hash',
-  'object_auth.sentCode_param_next_type_type_auth.CodeType' => 'Next type',
-  'object_auth.sentCode_param_timeout_type_int' => 'Timeout',
-  'object_auth.authorization' => 'Authorization',
-  'object_auth.authorization_param_tmp_sessions_type_int' => 'Temporary sessions',
-  'object_auth.authorization_param_user_type_User' => 'User',
-  'object_auth.exportedAuthorization' => 'Exported authorization',
-  'object_auth.exportedAuthorization_param_id_type_int' => 'ID',
-  'object_auth.exportedAuthorization_param_bytes_type_bytes' => 'Bytes',
-  'object_inputNotifyPeer' => 'Notify peer',
-  'object_inputNotifyPeer_param_peer_type_InputPeer' => 'Peer',
-  'object_inputNotifyUsers' => 'Notify users',
-  'object_inputNotifyChats' => 'Notify chats',
+  'object_auth.sentCode_param_type_type_auth.SentCodeType' => 'Phone code type',
+  'object_auth.sentCode_param_phone_code_hash_type_string' => 'Phone code hash, to be stored and later re-used with [auth.signIn](../methods/auth.signIn.md)',
+  'object_auth.sentCode_param_next_type_type_auth.CodeType' => 'Phone code type that will be sent next, if the phone code is not received within `timeout` seconds: to send it use [auth.resendCode](../methods/auth.resendCode.md)',
+  'object_auth.sentCode_param_timeout_type_int' => 'Timeout for reception of the phone code',
+  'object_auth.authorization' => 'Contains user authorization info.',
+  'object_auth.authorization_param_tmp_sessions_type_int' => 'Temporary [passport](https://core.telegram.org/passport) sessions',
+  'object_auth.authorization_param_user_type_User' => 'Info on authorized user',
+  'object_auth.exportedAuthorization' => 'Data for copying of authorization between data centres.',
+  'object_auth.exportedAuthorization_param_id_type_int' => 'current user identifier',
+  'object_auth.exportedAuthorization_param_bytes_type_bytes' => 'authorizes key',
+  'object_inputNotifyPeer' => 'Notifications generated by a certain user or group.',
+  'object_inputNotifyPeer_param_peer_type_InputPeer' => 'User or group',
+  'object_inputNotifyUsers' => 'Notifications generated by all users.',
+  'object_inputNotifyChats' => 'Notifications generated by all groups.',
   'object_inputNotifyAll' => 'Notify all',
   'object_inputPeerNotifyEventsEmpty' => 'Empty input peer notify events',
   'object_inputPeerNotifyEventsAll' => 'Peer notify events all',
-  'object_inputPeerNotifySettings' => 'Peer notify settings',
+  'object_inputPeerNotifySettings' => 'Notification settings.',
   'object_inputPeerNotifySettings_param_show_previews_type_true' => 'Show previews?',
   'object_inputPeerNotifySettings_param_silent_type_true' => 'Silent?',
-  'object_inputPeerNotifySettings_param_mute_until_type_int' => 'Mute until',
-  'object_inputPeerNotifySettings_param_sound_type_string' => 'Sound',
+  'object_inputPeerNotifySettings_param_mute_until_type_int' => 'Date until which all notifications shall be switched off',
+  'object_inputPeerNotifySettings_param_sound_type_string' => 'Name of an audio file for notification',
   'object_peerNotifyEventsEmpty' => 'Empty peer notify events',
   'object_peerNotifyEventsAll' => 'Peer notify events all',
   'object_peerNotifySettingsEmpty' => 'Empty peer notify settings',
-  'object_peerNotifySettings' => 'Peer notify settings',
+  'object_peerNotifySettings' => 'Notification settings.',
   'object_peerNotifySettings_param_show_previews_type_true' => 'Show previews?',
   'object_peerNotifySettings_param_silent_type_true' => 'Silent?',
-  'object_peerNotifySettings_param_mute_until_type_int' => 'Mute until',
-  'object_peerNotifySettings_param_sound_type_string' => 'Sound',
+  'object_peerNotifySettings_param_mute_until_type_int' => 'Mute all notifications until this date',
+  'object_peerNotifySettings_param_sound_type_string' => 'Audio file name for notifications',
   'object_peerSettings' => 'Peer settings',
-  'object_peerSettings_param_report_spam_type_true' => 'Report spam?',
-  'object_wallPaper' => 'Wall paper',
+  'object_peerSettings_param_report_spam_type_true' => 'Whether we can still report the user for spam',
+  'object_wallPaper' => 'Wallpaper settings.',
   'object_wallPaper_param_id_type_int' => 'ID',
   'object_wallPaper_param_title_type_string' => 'Title',
   'object_wallPaper_param_sizes_type_Vector t' => 'Sizes',
@@ -6970,142 +7357,142 @@ class Lang
   'object_wallPaperSolid_param_title_type_string' => 'Title',
   'object_wallPaperSolid_param_bg_color_type_int' => 'Bg color',
   'object_wallPaperSolid_param_color_type_int' => 'Color',
-  'object_inputReportReasonSpam' => 'Report reason spam',
-  'object_inputReportReasonViolence' => 'Report reason violence',
-  'object_inputReportReasonPornography' => 'Report reason pornography',
-  'object_inputReportReasonOther' => 'Report reason other',
-  'object_inputReportReasonOther_param_text_type_string' => 'Text',
-  'object_userFull' => 'User full',
-  'object_userFull_param_blocked_type_true' => 'Blocked?',
-  'object_userFull_param_phone_calls_available_type_true' => 'Phone calls available?',
-  'object_userFull_param_phone_calls_private_type_true' => 'Phone calls private?',
-  'object_userFull_param_user_type_User' => 'User',
-  'object_userFull_param_about_type_string' => 'About',
+  'object_inputReportReasonSpam' => 'Report for spam',
+  'object_inputReportReasonViolence' => 'Report for violence',
+  'object_inputReportReasonPornography' => 'Report for pornography',
+  'object_inputReportReasonOther' => 'Other',
+  'object_inputReportReasonOther_param_text_type_string' => 'Other report reason',
+  'object_userFull' => 'Extended user info',
+  'object_userFull_param_blocked_type_true' => 'Whether you have blocked this user',
+  'object_userFull_param_phone_calls_available_type_true' => 'Whether this user can make VoIP calls',
+  'object_userFull_param_phone_calls_private_type_true' => 'Whether this user\'s privacy settings allow you to call him',
+  'object_userFull_param_user_type_User' => 'Remaining user info',
+  'object_userFull_param_about_type_string' => 'Bio of the user',
   'object_userFull_param_link_type_contacts.Link' => 'Link',
   'object_userFull_param_profile_photo_type_Photo' => 'Profile photo',
-  'object_userFull_param_notify_settings_type_PeerNotifySettings' => 'Notify settings',
-  'object_userFull_param_bot_info_type_BotInfo' => 'Bot info',
-  'object_userFull_param_common_chats_count_type_int' => 'Common chats count',
-  'object_contact' => 'Contact',
-  'object_contact_param_user_id_type_int' => 'User ID',
-  'object_contact_param_mutual_type_Bool' => 'Mutual?',
-  'object_importedContact' => 'Imported contact',
-  'object_importedContact_param_user_id_type_int' => 'User ID',
-  'object_importedContact_param_client_id_type_long' => 'Client ID',
-  'object_contactBlocked' => 'Contact blocked',
-  'object_contactBlocked_param_user_id_type_int' => 'User ID',
-  'object_contactBlocked_param_date_type_int' => 'Date',
-  'object_contactStatus' => 'Contact status',
-  'object_contactStatus_param_user_id_type_int' => 'User ID',
-  'object_contactStatus_param_status_type_UserStatus' => 'Status',
+  'object_userFull_param_notify_settings_type_PeerNotifySettings' => 'Notification settings',
+  'object_userFull_param_bot_info_type_BotInfo' => 'For bots, info about the bot (bot commands, etc)',
+  'object_userFull_param_common_chats_count_type_int' => 'Chats in common with this user',
+  'object_contact' => 'A contact of the current user that is registered in the system.',
+  'object_contact_param_user_id_type_int' => 'User identifier',
+  'object_contact_param_mutual_type_Bool' => 'Current user is in the user\'s contact list',
+  'object_importedContact' => 'Successfully imported contact.',
+  'object_importedContact_param_user_id_type_int' => 'User identifier',
+  'object_importedContact_param_client_id_type_long' => 'The contact\'s client identifier (passed to one of the [InputContact](../types/InputContact.md) constructors)',
+  'object_contactBlocked' => 'A blocked user.',
+  'object_contactBlocked_param_user_id_type_int' => 'User identifier',
+  'object_contactBlocked_param_date_type_int' => 'Date blacklisted',
+  'object_contactStatus' => 'Contact status: online / offline.',
+  'object_contactStatus_param_user_id_type_int' => 'User identifier',
+  'object_contactStatus_param_status_type_UserStatus' => 'Online status',
   'object_contacts.link' => 'Link',
   'object_contacts.link_param_my_link_type_ContactLink' => 'My link',
   'object_contacts.link_param_foreign_link_type_ContactLink' => 'Foreign link',
   'object_contacts.link_param_user_type_User' => 'User',
-  'object_contacts.contactsNotModified' => 'Contacts not modified',
-  'object_contacts.contacts' => 'Contacts',
+  'object_contacts.contactsNotModified' => 'Contact list on the server is the same as the list on the client.',
+  'object_contacts.contacts' => 'The current user\'s contact list and info on users.',
   'object_contacts.contacts_param_contacts_type_Vector t' => 'Contacts',
-  'object_contacts.contacts_param_saved_count_type_int' => 'Saved count',
+  'object_contacts.contacts_param_saved_count_type_int' => 'Number of contacts that were saved successfully',
   'object_contacts.contacts_param_users_type_Vector t' => 'Users',
-  'object_contacts.importedContacts' => 'Imported contacts',
+  'object_contacts.importedContacts' => 'Info on succesfully imported contacts.',
   'object_contacts.importedContacts_param_imported_type_Vector t' => 'Imported',
   'object_contacts.importedContacts_param_popular_invites_type_Vector t' => 'Popular invites',
   'object_contacts.importedContacts_param_retry_contacts_type_Vector t' => 'Retry importing contacts whose client IDs appear here',
   'object_contacts.importedContacts_param_users_type_Vector t' => 'Users',
-  'object_contacts.blocked' => 'Blocked',
+  'object_contacts.blocked' => 'Full list of blocked users.',
   'object_contacts.blocked_param_blocked_type_Vector t' => 'Blocked',
   'object_contacts.blocked_param_users_type_Vector t' => 'Users',
-  'object_contacts.blockedSlice' => 'Blocked slice',
-  'object_contacts.blockedSlice_param_count_type_int' => 'Count',
+  'object_contacts.blockedSlice' => 'Incomplete list of blocked users.',
+  'object_contacts.blockedSlice_param_count_type_int' => 'Total number of elements in the list',
   'object_contacts.blockedSlice_param_blocked_type_Vector t' => 'Blocked',
   'object_contacts.blockedSlice_param_users_type_Vector t' => 'Users',
-  'object_messages.dialogs' => 'Dialogs',
+  'object_messages.dialogs' => 'Full list of chats with messages and auxiliary data.',
   'object_messages.dialogs_param_dialogs_type_Vector t' => 'Dialogs',
   'object_messages.dialogs_param_messages_type_Vector t' => 'Messages',
   'object_messages.dialogs_param_chats_type_Vector t' => 'Chats',
   'object_messages.dialogs_param_users_type_Vector t' => 'Users',
-  'object_messages.dialogsSlice' => 'Dialogs slice',
-  'object_messages.dialogsSlice_param_count_type_int' => 'Count',
+  'object_messages.dialogsSlice' => 'Incomplete list of dialogs with messages and auxiliary data.',
+  'object_messages.dialogsSlice_param_count_type_int' => 'Total number of dialogs',
   'object_messages.dialogsSlice_param_dialogs_type_Vector t' => 'Dialogs',
   'object_messages.dialogsSlice_param_messages_type_Vector t' => 'Messages',
   'object_messages.dialogsSlice_param_chats_type_Vector t' => 'Chats',
   'object_messages.dialogsSlice_param_users_type_Vector t' => 'Users',
-  'object_messages.messages' => 'Messages',
+  'object_messages.messages' => 'Full list of messages with auxilary data.',
   'object_messages.messages_param_messages_type_Vector t' => 'Messages',
   'object_messages.messages_param_chats_type_Vector t' => 'Chats',
   'object_messages.messages_param_users_type_Vector t' => 'Users',
-  'object_messages.messagesSlice' => 'Messages slice',
-  'object_messages.messagesSlice_param_count_type_int' => 'Count',
+  'object_messages.messagesSlice' => 'Incomplete list of messages and auxiliary data.',
+  'object_messages.messagesSlice_param_count_type_int' => 'Total number of messages in the list',
   'object_messages.messagesSlice_param_messages_type_Vector t' => 'Messages',
   'object_messages.messagesSlice_param_chats_type_Vector t' => 'Chats',
   'object_messages.messagesSlice_param_users_type_Vector t' => 'Users',
   'object_messages.channelMessages' => 'Channel messages',
-  'object_messages.channelMessages_param_pts_type_int' => 'Pts',
-  'object_messages.channelMessages_param_count_type_int' => 'Count',
+  'object_messages.channelMessages_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+  'object_messages.channelMessages_param_count_type_int' => 'Total number of results were found server-side (may not be all included here)',
   'object_messages.channelMessages_param_messages_type_Vector t' => 'Messages',
   'object_messages.channelMessages_param_chats_type_Vector t' => 'Chats',
   'object_messages.channelMessages_param_users_type_Vector t' => 'Users',
-  'object_messages.messagesNotModified' => 'Messages not modified',
-  'object_messages.messagesNotModified_param_count_type_int' => 'Count',
-  'object_messages.chats' => 'Chats',
+  'object_messages.messagesNotModified' => 'No new messages matching the query were found',
+  'object_messages.messagesNotModified_param_count_type_int' => 'Number of results found server-side by the given query',
+  'object_messages.chats' => 'List of chats with auxiliary data.',
   'object_messages.chats_param_chats_type_Vector t' => 'Chats',
-  'object_messages.chatsSlice' => 'Chats slice',
-  'object_messages.chatsSlice_param_count_type_int' => 'Count',
+  'object_messages.chatsSlice' => 'Partial list of chats, more would have to be fetched with [pagination](https://core.telegram.org/api/offsets)',
+  'object_messages.chatsSlice_param_count_type_int' => 'Total number of results that were found server-side (not all are included in `chats`)',
   'object_messages.chatsSlice_param_chats_type_Vector t' => 'Chats',
-  'object_messages.chatFull' => 'Chat full',
-  'object_messages.chatFull_param_full_chat_type_ChatFull' => 'Full chat',
+  'object_messages.chatFull' => 'Extended info on chat and auxiliary data.',
+  'object_messages.chatFull_param_full_chat_type_ChatFull' => 'Extended info on a chat',
   'object_messages.chatFull_param_chats_type_Vector t' => 'Chats',
   'object_messages.chatFull_param_users_type_Vector t' => 'Users',
-  'object_messages.affectedHistory' => 'Affected history',
-  'object_messages.affectedHistory_param_pts_type_int' => 'Pts',
-  'object_messages.affectedHistory_param_pts_count_type_int' => 'Pts count',
-  'object_messages.affectedHistory_param_offset_type_int' => 'Offset',
-  'object_inputMessagesFilterEmpty' => 'Empty input messages filter',
-  'object_inputMessagesFilterPhotos' => 'Messages filter photos',
-  'object_inputMessagesFilterVideo' => 'Messages filter video',
-  'object_inputMessagesFilterPhotoVideo' => 'Messages filter photo video',
-  'object_inputMessagesFilterDocument' => 'Messages filter document',
-  'object_inputMessagesFilterUrl' => 'Messages filter URL',
-  'object_inputMessagesFilterGif' => 'Messages filter gif',
-  'object_inputMessagesFilterVoice' => 'Messages filter voice',
-  'object_inputMessagesFilterMusic' => 'Messages filter music',
-  'object_inputMessagesFilterChatPhotos' => 'Messages filter chat photos',
-  'object_inputMessagesFilterPhoneCalls' => 'Messages filter phone calls',
-  'object_inputMessagesFilterPhoneCalls_param_missed_type_true' => 'Missed?',
-  'object_inputMessagesFilterRoundVoice' => 'Messages filter round voice',
-  'object_inputMessagesFilterRoundVideo' => 'Messages filter round video',
-  'object_inputMessagesFilterMyMentions' => 'Messages filter my mentions',
-  'object_inputMessagesFilterGeo' => 'Messages filter geo',
-  'object_inputMessagesFilterContacts' => 'Messages filter contacts',
-  'object_updateNewMessage' => 'Update new message',
+  'object_messages.affectedHistory' => 'Affected part of communication history with the user or in a chat.',
+  'object_messages.affectedHistory_param_pts_type_int' => 'Number of events occured in a text box',
+  'object_messages.affectedHistory_param_pts_count_type_int' => 'Number of affected events',
+  'object_messages.affectedHistory_param_offset_type_int' => 'If a parameter contains positive value, it is necessary to repeat the method call using the given value; during the proceeding of all the history the value itself shall gradually decrease',
+  'object_inputMessagesFilterEmpty' => 'Filter is absent.',
+  'object_inputMessagesFilterPhotos' => 'Filter for messages containing photos.',
+  'object_inputMessagesFilterVideo' => 'Filter for messages containing videos.',
+  'object_inputMessagesFilterPhotoVideo' => 'Filter for messages containing photos or videos.',
+  'object_inputMessagesFilterDocument' => 'Filter for messages containing documents.',
+  'object_inputMessagesFilterUrl' => 'Return only messages containing URLs',
+  'object_inputMessagesFilterGif' => 'Return only messages containing gifs',
+  'object_inputMessagesFilterVoice' => 'Return only messages containing voice notes',
+  'object_inputMessagesFilterMusic' => 'Return only messages containing audio files',
+  'object_inputMessagesFilterChatPhotos' => 'Return only chat photo changes',
+  'object_inputMessagesFilterPhoneCalls' => 'Return only phone calls',
+  'object_inputMessagesFilterPhoneCalls_param_missed_type_true' => 'Return only missed phone calls',
+  'object_inputMessagesFilterRoundVoice' => 'Return only round videos and voice notes',
+  'object_inputMessagesFilterRoundVideo' => 'Return only round videos',
+  'object_inputMessagesFilterMyMentions' => 'Return only messages where the current user was mentioned',
+  'object_inputMessagesFilterGeo' => 'Return only messages containing geolocations',
+  'object_inputMessagesFilterContacts' => 'Return only messages containing contacts',
+  'object_updateNewMessage' => 'New message.',
   'object_updateNewMessage_param_message_type_Message' => 'Message',
-  'object_updateNewMessage_param_pts_type_int' => 'Pts',
-  'object_updateNewMessage_param_pts_count_type_int' => 'Pts count',
-  'object_updateMessageID' => 'Update message ID',
-  'object_updateMessageID_param_id_type_int' => 'ID',
-  'object_updateDeleteMessages' => 'Update delete messages',
+  'object_updateNewMessage_param_pts_type_int' => 'New quantity of actions in a message box',
+  'object_updateNewMessage_param_pts_count_type_int' => 'Number of generated events',
+  'object_updateMessageID' => 'Sent message with **random\\_id** client identifier was assigned an identifier.',
+  'object_updateMessageID_param_id_type_int' => '**id** identifier of a respective [Message](../types/Message.md)',
+  'object_updateDeleteMessages' => 'Messages were deleted.',
   'object_updateDeleteMessages_param_messages_type_Vector t' => 'Messages',
-  'object_updateDeleteMessages_param_pts_type_int' => 'Pts',
-  'object_updateDeleteMessages_param_pts_count_type_int' => 'Pts count',
-  'object_updateUserTyping' => 'Update user typing',
-  'object_updateUserTyping_param_user_id_type_int' => 'User ID',
-  'object_updateUserTyping_param_action_type_SendMessageAction' => 'Action',
-  'object_updateChatUserTyping' => 'Update chat user typing',
-  'object_updateChatUserTyping_param_chat_id_type_int' => 'Chat ID',
-  'object_updateChatUserTyping_param_user_id_type_int' => 'User ID',
-  'object_updateChatUserTyping_param_action_type_SendMessageAction' => 'Action',
-  'object_updateChatParticipants' => 'Update chat participants',
-  'object_updateChatParticipants_param_participants_type_ChatParticipants' => 'Participants',
-  'object_updateUserName' => 'Update user name',
-  'object_updateUserName_param_user_id_type_int' => 'User ID',
-  'object_updateUserName_param_first_name_type_string' => 'First name',
-  'object_updateUserName_param_last_name_type_string' => 'Last name',
-  'object_updateUserName_param_username_type_string' => 'Username',
-  'object_updateUserPhoto' => 'Update user photo',
-  'object_updateUserPhoto_param_user_id_type_int' => 'User ID',
-  'object_updateUserPhoto_param_date_type_int' => 'Date',
-  'object_updateUserPhoto_param_photo_type_UserProfilePhoto' => 'Photo',
-  'object_updateUserPhoto_param_previous_type_Bool' => 'Previous?',
+  'object_updateDeleteMessages_param_pts_type_int' => 'New quality of actions in a message box',
+  'object_updateDeleteMessages_param_pts_count_type_int' => 'Number of generated [events](https://core.telegram.org/api/updates)',
+  'object_updateUserTyping' => 'The user is preparing a message; typing, recording, uploading, etc. This update is valid for 6 seconds. If no repeated update received after 6 seconds, it should be considered that the user stopped doing whatever he\'s been doing.',
+  'object_updateUserTyping_param_user_id_type_int' => 'User id',
+  'object_updateUserTyping_param_action_type_SendMessageAction' => 'Action type
Param added in [Layer 17](https://core.telegram.org/api/layers#layer-17).',
+  'object_updateChatUserTyping' => 'The user is preparing a message in a group; typing, recording, uploading, etc. This update is valid for 6 seconds. If no repeated update received after 6 seconds, it should be considered that the user stopped doing whatever he\'s been doing.',
+  'object_updateChatUserTyping_param_chat_id_type_int' => 'Group id',
+  'object_updateChatUserTyping_param_user_id_type_int' => 'User id',
+  'object_updateChatUserTyping_param_action_type_SendMessageAction' => 'Type of action
Parameter added in [Layer 17](https://core.telegram.org/api/layers#layer-17).',
+  'object_updateChatParticipants' => 'Composition of chat participants changed.',
+  'object_updateChatParticipants_param_participants_type_ChatParticipants' => 'Updated chat participants',
+  'object_updateUserName' => 'Changes the user\'s first name, last name and username.',
+  'object_updateUserName_param_user_id_type_int' => 'User identifier',
+  'object_updateUserName_param_first_name_type_string' => 'New first name. Corresponds to the new value of **real\\_first\\_name** field of the [userFull](../constructors/userFull.md) constructor.',
+  'object_updateUserName_param_last_name_type_string' => 'New last name. Corresponds to the new value of **real\\_last\\_name** field of the [userFull](../constructors/userFull.md) constructor.',
+  'object_updateUserName_param_username_type_string' => 'New username.
Parameter added in [Layer 18](https://core.telegram.org/api/layers#layer-18).',
+  'object_updateUserPhoto' => 'Change of contact\'s profile photo.',
+  'object_updateUserPhoto_param_user_id_type_int' => 'User identifier',
+  'object_updateUserPhoto_param_date_type_int' => 'Date of photo update.
Parameter was added in [second layer](?layer=2).',
+  'object_updateUserPhoto_param_photo_type_UserProfilePhoto' => 'New profile photo',
+  'object_updateUserPhoto_param_previous_type_Bool' => '([boolTrue](../constructors/boolTrue.md)), if one of the previously used photos is set a profile photo.
Parameter was added in [second layer](?layer=2).',
   'object_updateContactRegistered' => 'Update contact registered',
   'object_updateContactRegistered_param_user_id_type_int' => 'User ID',
   'object_updateContactRegistered_param_date_type_int' => 'Date',
@@ -7113,733 +7500,741 @@ class Lang
   'object_updateContactLink_param_user_id_type_int' => 'User ID',
   'object_updateContactLink_param_my_link_type_ContactLink' => 'My link',
   'object_updateContactLink_param_foreign_link_type_ContactLink' => 'Foreign link',
-  'object_updateNewEncryptedMessage' => 'Update new encrypted message',
+  'object_updateNewEncryptedMessage' => 'New encrypted message.',
   'object_updateNewEncryptedMessage_param_message_type_EncryptedMessage' => 'Message',
-  'object_updateNewEncryptedMessage_param_qts_type_int' => 'Qts',
-  'object_updateEncryptedChatTyping' => 'Update encrypted chat typing',
+  'object_updateNewEncryptedMessage_param_qts_type_int' => 'New **qts** value',
+  'object_updateEncryptedChatTyping' => 'Interlocutor is typing a message in an encrypted chat. Update period is 6 second. If upon this time there is no repeated update, it shall be considered that the interlocutor stopped typing.',
   'object_updateEncryptedChatTyping_param_chat_id_type_int' => 'Chat ID',
-  'object_updateEncryption' => 'Update encryption',
-  'object_updateEncryption_param_chat_type_EncryptedChat' => 'Chat',
-  'object_updateEncryption_param_date_type_int' => 'Date',
-  'object_updateEncryptedMessagesRead' => 'Update encrypted messages read',
+  'object_updateEncryption' => 'Change of state in an encrypted chat.',
+  'object_updateEncryption_param_chat_type_EncryptedChat' => 'Encrypted chat',
+  'object_updateEncryption_param_date_type_int' => 'Date of change',
+  'object_updateEncryptedMessagesRead' => 'Communication history in an encrypted chat was marked as read.',
   'object_updateEncryptedMessagesRead_param_chat_id_type_int' => 'Chat ID',
-  'object_updateEncryptedMessagesRead_param_max_date_type_int' => 'Max date',
-  'object_updateEncryptedMessagesRead_param_date_type_int' => 'Date',
-  'object_updateChatParticipantAdd' => 'Update chat participant add',
-  'object_updateChatParticipantAdd_param_chat_id_type_int' => 'Chat ID',
-  'object_updateChatParticipantAdd_param_user_id_type_int' => 'User ID',
-  'object_updateChatParticipantAdd_param_inviter_id_type_int' => 'Inviter ID',
-  'object_updateChatParticipantAdd_param_date_type_int' => 'Date',
-  'object_updateChatParticipantAdd_param_version_type_int' => 'Version',
-  'object_updateChatParticipantDelete' => 'Update chat participant delete',
-  'object_updateChatParticipantDelete_param_chat_id_type_int' => 'Chat ID',
-  'object_updateChatParticipantDelete_param_user_id_type_int' => 'User ID',
-  'object_updateChatParticipantDelete_param_version_type_int' => 'Version',
-  'object_updateDcOptions' => 'Update DC options',
+  'object_updateEncryptedMessagesRead_param_max_date_type_int' => 'Maximum value of data for read messages',
+  'object_updateEncryptedMessagesRead_param_date_type_int' => 'Time when messages were read',
+  'object_updateChatParticipantAdd' => 'New group member.',
+  'object_updateChatParticipantAdd_param_chat_id_type_int' => 'Group ID',
+  'object_updateChatParticipantAdd_param_user_id_type_int' => 'ID of the new member',
+  'object_updateChatParticipantAdd_param_inviter_id_type_int' => 'ID of the user, who added member to the group',
+  'object_updateChatParticipantAdd_param_date_type_int' => 'When was the participant added',
+  'object_updateChatParticipantAdd_param_version_type_int' => 'Chat version number',
+  'object_updateChatParticipantDelete' => 'A member has left the group.',
+  'object_updateChatParticipantDelete_param_chat_id_type_int' => 'Group ID',
+  'object_updateChatParticipantDelete_param_user_id_type_int' => 'ID of the user',
+  'object_updateChatParticipantDelete_param_version_type_int' => 'Used in basic groups to reorder updates and make sure that all of them was received.',
+  'object_updateDcOptions' => 'Changes in the data center configuration options.',
   'object_updateDcOptions_param_dc_options_type_Vector t' => 'DC options',
-  'object_updateUserBlocked' => 'Update user blocked',
-  'object_updateUserBlocked_param_user_id_type_int' => 'User ID',
-  'object_updateUserBlocked_param_blocked_type_Bool' => 'Blocked?',
-  'object_updateNotifySettings' => 'Update notify settings',
-  'object_updateNotifySettings_param_peer_type_NotifyPeer' => 'Peer',
-  'object_updateNotifySettings_param_notify_settings_type_PeerNotifySettings' => 'Notify settings',
-  'object_updateServiceNotification' => 'Update service notification',
-  'object_updateServiceNotification_param_popup_type_true' => 'Popup?',
-  'object_updateServiceNotification_param_inbox_date_type_int' => 'Inbox date',
-  'object_updateServiceNotification_param_type_type_string' => 'Type',
-  'object_updateServiceNotification_param_message_type_string' => 'Message',
-  'object_updateServiceNotification_param_media_type_MessageMedia' => 'Media',
+  'object_updateUserBlocked' => 'User was added to the blacklist (method [contacts.block](../methods/contacts.block.md)) or removed from the blacklist (method [contacts.unblock](../methods/contacts.unblock.md)).',
+  'object_updateUserBlocked_param_user_id_type_int' => 'User id',
+  'object_updateUserBlocked_param_blocked_type_Bool' => '([boolTrue](../constructors/boolTrue.md)) if the the user is blocked',
+  'object_updateNotifySettings' => 'Changes in notification settings.',
+  'object_updateNotifySettings_param_peer_type_NotifyPeer' => 'Nofication source',
+  'object_updateNotifySettings_param_notify_settings_type_PeerNotifySettings' => 'New notification settings',
+  'object_updateServiceNotification' => 'A service message for the user.
+
+The app must show the message to the user upon receiving this update. In case the **popup** parameter was passed, the text message must be displayed in a popup alert immediately upon receipt. It is recommended to handle the text as you would an ordinary message in terms of highlighting links, etc. The message must also be stored locally as part of the message history with the user id `777000` (Telegram Notifications).',
+  'object_updateServiceNotification_param_popup_type_true' => '(boolTrue) if the message must be displayed in a popup.',
+  'object_updateServiceNotification_param_inbox_date_type_int' => 'When was the notification received
The message must also be stored locally as part of the message history with the user id `777000` (Telegram Notifications).',
+  'object_updateServiceNotification_param_type_type_string' => 'String, identical in format and contents to the [**type**](https://core.telegram.org/api/errors#error-type) field in API errors. Describes type of service message. It is acceptable to ignore repeated messages of the same **type** within a short period of time (15 minutes).',
+  'object_updateServiceNotification_param_message_type_string' => 'Message text',
+  'object_updateServiceNotification_param_media_type_MessageMedia' => 'Media content (optional)',
   'object_updateServiceNotification_param_entities_type_Vector t' => 'Entities',
-  'object_updatePrivacy' => 'Update privacy',
-  'object_updatePrivacy_param_key_type_PrivacyKey' => 'Key',
+  'object_updatePrivacy' => 'Privacy rules were changed',
+  'object_updatePrivacy_param_key_type_PrivacyKey' => 'Peers to which the privacy rules apply',
   'object_updatePrivacy_param_rules_type_Vector t' => 'Rules',
-  'object_updateUserPhone' => 'Update user phone',
+  'object_updateUserPhone' => 'A user\'s phone number was changed',
   'object_updateUserPhone_param_user_id_type_int' => 'User ID',
-  'object_updateUserPhone_param_phone_type_string' => 'Phone',
-  'object_updateReadHistoryInbox' => 'Update read history inbox',
+  'object_updateUserPhone_param_phone_type_string' => 'New phone number',
+  'object_updateReadHistoryInbox' => 'Incoming messages were read',
   'object_updateReadHistoryInbox_param_peer_type_Peer' => 'Peer',
-  'object_updateReadHistoryInbox_param_max_id_type_int' => 'Max ID',
-  'object_updateReadHistoryInbox_param_pts_type_int' => 'Pts',
-  'object_updateReadHistoryInbox_param_pts_count_type_int' => 'Pts count',
-  'object_updateReadHistoryOutbox' => 'Update read history outbox',
+  'object_updateReadHistoryInbox_param_max_id_type_int' => 'Maximum ID of messages read',
+  'object_updateReadHistoryInbox_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+  'object_updateReadHistoryInbox_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)',
+  'object_updateReadHistoryOutbox' => 'Outgoing messages were read',
   'object_updateReadHistoryOutbox_param_peer_type_Peer' => 'Peer',
-  'object_updateReadHistoryOutbox_param_max_id_type_int' => 'Max ID',
-  'object_updateReadHistoryOutbox_param_pts_type_int' => 'Pts',
-  'object_updateReadHistoryOutbox_param_pts_count_type_int' => 'Pts count',
-  'object_updateWebPage' => 'Update web page',
-  'object_updateWebPage_param_webpage_type_WebPage' => 'Webpage',
-  'object_updateWebPage_param_pts_type_int' => 'Pts',
-  'object_updateWebPage_param_pts_count_type_int' => 'Pts count',
-  'object_updateReadMessagesContents' => 'Update read messages contents',
+  'object_updateReadHistoryOutbox_param_max_id_type_int' => 'Maximum ID of read outgoing messages',
+  'object_updateReadHistoryOutbox_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+  'object_updateReadHistoryOutbox_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)',
+  'object_updateWebPage' => 'An [instant view](https://instantview.telegram.org) webpage preview was generated',
+  'object_updateWebPage_param_webpage_type_WebPage' => 'Webpage preview',
+  'object_updateWebPage_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+  'object_updateWebPage_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)',
+  'object_updateReadMessagesContents' => 'Contents of messages in the common [message box](https://core.telegram.org/api/updates) were read',
   'object_updateReadMessagesContents_param_messages_type_Vector t' => 'Messages',
-  'object_updateReadMessagesContents_param_pts_type_int' => 'Pts',
-  'object_updateReadMessagesContents_param_pts_count_type_int' => 'Pts count',
-  'object_updateChannelTooLong' => 'Update channel too long',
-  'object_updateChannelTooLong_param_channel_id_type_int' => 'Channel ID',
-  'object_updateChannelTooLong_param_pts_type_int' => 'Pts',
-  'object_updateChannel' => 'Update channel',
+  'object_updateReadMessagesContents_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+  'object_updateReadMessagesContents_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)',
+  'object_updateChannelTooLong' => 'There are new updates in the specified channel, the client must fetch them, eventually starting the specified pts if the difference is too long or if the channel isn\'t currently in the states.',
+  'object_updateChannelTooLong_param_channel_id_type_int' => 'The channel',
+  'object_updateChannelTooLong_param_pts_type_int' => 'The [PTS](https://core.telegram.org/api/updates).',
+  'object_updateChannel' => 'A new channel is available',
   'object_updateChannel_param_channel_id_type_int' => 'Channel ID',
-  'object_updateNewChannelMessage' => 'Update new channel message',
-  'object_updateNewChannelMessage_param_message_type_Message' => 'Message',
-  'object_updateNewChannelMessage_param_pts_type_int' => 'Pts',
-  'object_updateNewChannelMessage_param_pts_count_type_int' => 'Pts count',
-  'object_updateReadChannelInbox' => 'Update read channel inbox',
-  'object_updateReadChannelInbox_param_channel_id_type_int' => 'Channel ID',
-  'object_updateReadChannelInbox_param_max_id_type_int' => 'Max ID',
-  'object_updateDeleteChannelMessages' => 'Update delete channel messages',
+  'object_updateNewChannelMessage' => 'A new message was sent in a [channel/supergroup](https://core.telegram.org/api/channel)',
+  'object_updateNewChannelMessage_param_message_type_Message' => 'New message',
+  'object_updateNewChannelMessage_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+  'object_updateNewChannelMessage_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)',
+  'object_updateReadChannelInbox' => 'Incoming messages in a [channel/supergroup](https://core.telegram.org/api/channel) were read',
+  'object_updateReadChannelInbox_param_channel_id_type_int' => 'Channel/supergroup ID',
+  'object_updateReadChannelInbox_param_max_id_type_int' => 'Position up to which all incoming messages are read.',
+  'object_updateDeleteChannelMessages' => 'Some messages in a [supergroup/channel](https://core.telegram.org/api/channel) were deleted',
   'object_updateDeleteChannelMessages_param_channel_id_type_int' => 'Channel ID',
   'object_updateDeleteChannelMessages_param_messages_type_Vector t' => 'Messages',
-  'object_updateDeleteChannelMessages_param_pts_type_int' => 'Pts',
-  'object_updateDeleteChannelMessages_param_pts_count_type_int' => 'Pts count',
-  'object_updateChannelMessageViews' => 'Update channel message views',
+  'object_updateDeleteChannelMessages_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+  'object_updateDeleteChannelMessages_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)',
+  'object_updateChannelMessageViews' => 'The view counter of a message in a channel has changed',
   'object_updateChannelMessageViews_param_channel_id_type_int' => 'Channel ID',
-  'object_updateChannelMessageViews_param_id_type_int' => 'ID',
-  'object_updateChannelMessageViews_param_views_type_int' => 'Views',
+  'object_updateChannelMessageViews_param_id_type_int' => 'ID of the message',
+  'object_updateChannelMessageViews_param_views_type_int' => 'New view counter',
   'object_updateChatAdmins' => 'Update chat admins',
   'object_updateChatAdmins_param_chat_id_type_int' => 'Chat ID',
   'object_updateChatAdmins_param_enabled_type_Bool' => 'Enabled?',
   'object_updateChatAdmins_param_version_type_int' => 'Version',
-  'object_updateChatParticipantAdmin' => 'Update chat participant admin',
+  'object_updateChatParticipantAdmin' => 'Admin permissions of a user in a [legacy group](https://core.telegram.org/api/channel) were changed',
   'object_updateChatParticipantAdmin_param_chat_id_type_int' => 'Chat ID',
-  'object_updateChatParticipantAdmin_param_user_id_type_int' => 'User ID',
-  'object_updateChatParticipantAdmin_param_is_admin_type_Bool' => 'Is admin?',
-  'object_updateChatParticipantAdmin_param_version_type_int' => 'Version',
-  'object_updateNewStickerSet' => 'Update new sticker set',
-  'object_updateNewStickerSet_param_stickerset_type_messages.StickerSet' => 'Stickerset',
-  'object_updateStickerSetsOrder' => 'Update sticker sets order',
-  'object_updateStickerSetsOrder_param_masks_type_true' => 'Masks?',
+  'object_updateChatParticipantAdmin_param_user_id_type_int' => 'ID of the (de)admined user',
+  'object_updateChatParticipantAdmin_param_is_admin_type_Bool' => 'Whether the user was rendered admin',
+  'object_updateChatParticipantAdmin_param_version_type_int' => 'Used in basic groups to reorder updates and make sure that all of them was received.',
+  'object_updateNewStickerSet' => 'A new stickerset was installed',
+  'object_updateNewStickerSet_param_stickerset_type_messages.StickerSet' => 'The installed stickerset',
+  'object_updateStickerSetsOrder' => 'The order of stickersets was changed',
+  'object_updateStickerSetsOrder_param_masks_type_true' => 'Whether the updated stickers are mask stickers',
   'object_updateStickerSetsOrder_param_order_type_Vector t' => 'Order',
-  'object_updateStickerSets' => 'Update sticker sets',
-  'object_updateSavedGifs' => 'Update saved gifs',
-  'object_updateBotInlineQuery' => 'Update bot inline query',
+  'object_updateStickerSets' => 'Installed stickersets have changed, the client should refetch them using [messages.getAllStickers](https://core.telegram.org/method/messages.getAllStickers)',
+  'object_updateSavedGifs' => 'The saved gif list has changed, the client should refetch it using [messages.getSavedGifs](https://core.telegram.org/method/messages.getSavedGifs)',
+  'object_updateBotInlineQuery' => 'An incoming inline query',
   'object_updateBotInlineQuery_param_query_id_type_long' => 'Query ID',
-  'object_updateBotInlineQuery_param_user_id_type_int' => 'User ID',
-  'object_updateBotInlineQuery_param_query_type_string' => 'Query',
-  'object_updateBotInlineQuery_param_geo_type_GeoPoint' => 'Geo',
-  'object_updateBotInlineQuery_param_offset_type_string' => 'Offset',
-  'object_updateBotInlineSend' => 'Update bot inline send',
-  'object_updateBotInlineSend_param_user_id_type_int' => 'User ID',
-  'object_updateBotInlineSend_param_query_type_string' => 'Query',
-  'object_updateBotInlineSend_param_geo_type_GeoPoint' => 'Geo',
-  'object_updateBotInlineSend_param_id_type_string' => 'ID',
-  'object_updateBotInlineSend_param_msg_id_type_InputBotInlineMessageID' => 'Msg ID',
-  'object_updateEditChannelMessage' => 'Update edit channel message',
-  'object_updateEditChannelMessage_param_message_type_Message' => 'Message',
-  'object_updateEditChannelMessage_param_pts_type_int' => 'Pts',
-  'object_updateEditChannelMessage_param_pts_count_type_int' => 'Pts count',
-  'object_updateChannelPinnedMessage' => 'Update channel pinned message',
-  'object_updateChannelPinnedMessage_param_channel_id_type_int' => 'Channel ID',
-  'object_updateChannelPinnedMessage_param_id_type_int' => 'ID',
-  'object_updateBotCallbackQuery' => 'Update bot callback query',
+  'object_updateBotInlineQuery_param_user_id_type_int' => 'User that sent the query',
+  'object_updateBotInlineQuery_param_query_type_string' => 'Text of query',
+  'object_updateBotInlineQuery_param_geo_type_GeoPoint' => 'Attached geolocation',
+  'object_updateBotInlineQuery_param_offset_type_string' => 'Offset to navigate through results',
+  'object_updateBotInlineSend' => 'The result of an inline query that was chosen by a user and sent to their chat partner. Please see our documentation on the [feedback collecting](https://core.telegram.org/bots/inline#collecting-feedback) for details on how to enable these updates for your bot.',
+  'object_updateBotInlineSend_param_user_id_type_int' => 'The user that chose the result',
+  'object_updateBotInlineSend_param_query_type_string' => 'The query that was used to obtain the result',
+  'object_updateBotInlineSend_param_geo_type_GeoPoint' => 'Optional. Sender location, only for bots that require user location',
+  'object_updateBotInlineSend_param_id_type_string' => 'The unique identifier for the result that was chosen',
+  'object_updateBotInlineSend_param_msg_id_type_InputBotInlineMessageID' => 'Identifier of the sent inline message. Available only if there is an inline keyboard attached to the message. Will be also received in callback queries and can be used to edit the message.',
+  'object_updateEditChannelMessage' => 'A message was edited in a [channel/supergroup](https://core.telegram.org/api/channel)',
+  'object_updateEditChannelMessage_param_message_type_Message' => 'The new message',
+  'object_updateEditChannelMessage_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+  'object_updateEditChannelMessage_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)',
+  'object_updateChannelPinnedMessage' => 'A message was pinned in a [channel/supergroup](https://core.telegram.org/api/channel).',
+  'object_updateChannelPinnedMessage_param_channel_id_type_int' => 'Channel/supergroup ID',
+  'object_updateChannelPinnedMessage_param_id_type_int' => 'ID of pinned message',
+  'object_updateBotCallbackQuery' => 'A callback button was pressed, and the button data was sent to the bot that created the button',
   'object_updateBotCallbackQuery_param_query_id_type_long' => 'Query ID',
-  'object_updateBotCallbackQuery_param_user_id_type_int' => 'User ID',
-  'object_updateBotCallbackQuery_param_peer_type_Peer' => 'Peer',
-  'object_updateBotCallbackQuery_param_msg_id_type_int' => 'Msg ID',
-  'object_updateBotCallbackQuery_param_chat_instance_type_long' => 'Chat instance',
-  'object_updateBotCallbackQuery_param_data_type_bytes' => 'Data',
-  'object_updateBotCallbackQuery_param_game_short_name_type_string' => 'Game short name',
-  'object_updateEditMessage' => 'Update edit message',
-  'object_updateEditMessage_param_message_type_Message' => 'Message',
-  'object_updateEditMessage_param_pts_type_int' => 'Pts',
-  'object_updateEditMessage_param_pts_count_type_int' => 'Pts count',
-  'object_updateInlineBotCallbackQuery' => 'Update inline bot callback query',
+  'object_updateBotCallbackQuery_param_user_id_type_int' => 'ID of the user that pressed the button',
+  'object_updateBotCallbackQuery_param_peer_type_Peer' => 'Chat where the inline keyboard was sent',
+  'object_updateBotCallbackQuery_param_msg_id_type_int' => 'Message ID',
+  'object_updateBotCallbackQuery_param_chat_instance_type_long' => 'Global identifier, uniquely corresponding to the chat to which the message with the callback button was sent. Useful for high scores in games.',
+  'object_updateBotCallbackQuery_param_data_type_bytes' => 'Callback data',
+  'object_updateBotCallbackQuery_param_game_short_name_type_string' => 'Short name of a Game to be returned, serves as the unique identifier for the game',
+  'object_updateEditMessage' => 'A message was edited',
+  'object_updateEditMessage_param_message_type_Message' => 'The new edited message',
+  'object_updateEditMessage_param_pts_type_int' => '[PTS](https://core.telegram.org/api/updates)',
+  'object_updateEditMessage_param_pts_count_type_int' => '[PTS count](https://core.telegram.org/api/updates)',
+  'object_updateInlineBotCallbackQuery' => 'This notification is received by bots when a button is pressed',
   'object_updateInlineBotCallbackQuery_param_query_id_type_long' => 'Query ID',
-  'object_updateInlineBotCallbackQuery_param_user_id_type_int' => 'User ID',
-  'object_updateInlineBotCallbackQuery_param_msg_id_type_InputBotInlineMessageID' => 'Msg ID',
-  'object_updateInlineBotCallbackQuery_param_chat_instance_type_long' => 'Chat instance',
-  'object_updateInlineBotCallbackQuery_param_data_type_bytes' => 'Data',
-  'object_updateInlineBotCallbackQuery_param_game_short_name_type_string' => 'Game short name',
-  'object_updateReadChannelOutbox' => 'Update read channel outbox',
-  'object_updateReadChannelOutbox_param_channel_id_type_int' => 'Channel ID',
-  'object_updateReadChannelOutbox_param_max_id_type_int' => 'Max ID',
-  'object_updateDraftMessage' => 'Update draft message',
-  'object_updateDraftMessage_param_peer_type_Peer' => 'Peer',
-  'object_updateDraftMessage_param_draft_type_DraftMessage' => 'Draft',
-  'object_updateReadFeaturedStickers' => 'Update read featured stickers',
-  'object_updateRecentStickers' => 'Update recent stickers',
-  'object_updateConfig' => 'Update config',
-  'object_updatePtsChanged' => 'Update pts changed',
-  'object_updateChannelWebPage' => 'Update channel web page',
-  'object_updateChannelWebPage_param_channel_id_type_int' => 'Channel ID',
-  'object_updateChannelWebPage_param_webpage_type_WebPage' => 'Webpage',
-  'object_updateChannelWebPage_param_pts_type_int' => 'Pts',
-  'object_updateChannelWebPage_param_pts_count_type_int' => 'Pts count',
-  'object_updateDialogPinned' => 'Update dialog pinned',
-  'object_updateDialogPinned_param_pinned_type_true' => 'Pinned?',
+  'object_updateInlineBotCallbackQuery_param_user_id_type_int' => 'ID of the user that pressed the button',
+  'object_updateInlineBotCallbackQuery_param_msg_id_type_InputBotInlineMessageID' => 'ID of the inline message with the button',
+  'object_updateInlineBotCallbackQuery_param_chat_instance_type_long' => 'Global identifier, uniquely corresponding to the chat to which the message with the callback button was sent. Useful for high scores in games.',
+  'object_updateInlineBotCallbackQuery_param_data_type_bytes' => 'Data associated with the callback button. Be aware that a bad client can send arbitrary data in this field.',
+  'object_updateInlineBotCallbackQuery_param_game_short_name_type_string' => 'Short name of a Game to be returned, serves as the unique identifier for the game',
+  'object_updateReadChannelOutbox' => 'Outgoing messages in a [channel/supergroup](https://core.telegram.org/api/channel) were read',
+  'object_updateReadChannelOutbox_param_channel_id_type_int' => 'Channel/supergroup ID',
+  'object_updateReadChannelOutbox_param_max_id_type_int' => 'Position up to which all outgoing messages are read.',
+  'object_updateDraftMessage' => 'Notifies a change of a message [draft](https://core.telegram.org/api/drafts).',
+  'object_updateDraftMessage_param_peer_type_Peer' => 'The peer to which the draft is associated',
+  'object_updateDraftMessage_param_draft_type_DraftMessage' => 'The draft',
+  'object_updateReadFeaturedStickers' => 'Some featured stickers were marked as read',
+  'object_updateRecentStickers' => 'The recent sticker list was updated',
+  'object_updateConfig' => 'The server-side configuration has changed; the client should re-fetch the config using [help.getConfig](../methods/help.getConfig.md)',
+  'object_updatePtsChanged' => '[Common message box sequence PTS](https://core.telegram.org/api/updates) has changed, [state has to be refetched using updates.getState](https://core.telegram.org/api/updates#fetching-state)',
+  'object_updateChannelWebPage' => 'A webpage preview of a link in a [channel/supergroup](https://core.telegram.org/api/channel) message was generated',
+  'object_updateChannelWebPage_param_channel_id_type_int' => '[Channel/supergroup](https://core.telegram.org/api/channel) ID',
+  'object_updateChannelWebPage_param_webpage_type_WebPage' => 'Generated webpage preview',
+  'object_updateChannelWebPage_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+  'object_updateChannelWebPage_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)',
+  'object_updateDialogPinned' => 'A dialog was pinned/unpinned',
+  'object_updateDialogPinned_param_pinned_type_true' => 'Whether the dialog was pinned',
   'object_updateDialogPinned_param_peer_type_Peer' => 'Peer',
-  'object_updatePinnedDialogs' => 'Update pinned dialogs',
+  'object_updatePinnedDialogs' => 'Pinned dialogs were updated',
   'object_updatePinnedDialogs_param_order_type_Vector t' => 'Order',
-  'object_updateBotWebhookJSON' => 'Update bot webhook json',
-  'object_updateBotWebhookJSON_param_data_type_DataJSON' => 'Data',
-  'object_updateBotWebhookJSONQuery' => 'Update bot webhook json query',
-  'object_updateBotWebhookJSONQuery_param_query_id_type_long' => 'Query ID',
-  'object_updateBotWebhookJSONQuery_param_data_type_DataJSON' => 'Data',
-  'object_updateBotWebhookJSONQuery_param_timeout_type_int' => 'Timeout',
-  'object_updateBotShippingQuery' => 'Update bot shipping query',
-  'object_updateBotShippingQuery_param_query_id_type_long' => 'Query ID',
-  'object_updateBotShippingQuery_param_user_id_type_int' => 'User ID',
-  'object_updateBotShippingQuery_param_payload_type_bytes' => 'Payload',
-  'object_updateBotShippingQuery_param_shipping_address_type_PostAddress' => 'Shipping address',
-  'object_updateBotPrecheckoutQuery' => 'Update bot precheckout query',
-  'object_updateBotPrecheckoutQuery_param_query_id_type_long' => 'Query ID',
-  'object_updateBotPrecheckoutQuery_param_user_id_type_int' => 'User ID',
-  'object_updateBotPrecheckoutQuery_param_payload_type_bytes' => 'Payload',
-  'object_updateBotPrecheckoutQuery_param_info_type_PaymentRequestedInfo' => 'Info',
-  'object_updateBotPrecheckoutQuery_param_shipping_option_id_type_string' => 'Shipping option ID',
-  'object_updateBotPrecheckoutQuery_param_currency_type_string' => 'Currency',
-  'object_updateBotPrecheckoutQuery_param_total_amount_type_long' => 'Total amount',
-  'object_updatePhoneCall' => 'Update phone call',
+  'object_updateBotWebhookJSON' => 'A new incoming event; for bots only',
+  'object_updateBotWebhookJSON_param_data_type_DataJSON' => 'The event',
+  'object_updateBotWebhookJSONQuery' => 'A new incoming query; for bots only',
+  'object_updateBotWebhookJSONQuery_param_query_id_type_long' => 'Query identifier',
+  'object_updateBotWebhookJSONQuery_param_data_type_DataJSON' => 'Query data',
+  'object_updateBotWebhookJSONQuery_param_timeout_type_int' => 'Query timeout',
+  'object_updateBotShippingQuery' => 'This object contains information about an incoming shipping query.',
+  'object_updateBotShippingQuery_param_query_id_type_long' => 'Unique query identifier',
+  'object_updateBotShippingQuery_param_user_id_type_int' => 'User who sent the query',
+  'object_updateBotShippingQuery_param_payload_type_bytes' => 'Bot specified invoice payload',
+  'object_updateBotShippingQuery_param_shipping_address_type_PostAddress' => 'User specified shipping address',
+  'object_updateBotPrecheckoutQuery' => 'This object contains information about an incoming pre-checkout query.',
+  'object_updateBotPrecheckoutQuery_param_query_id_type_long' => 'Unique query identifier',
+  'object_updateBotPrecheckoutQuery_param_user_id_type_int' => 'User who sent the query',
+  'object_updateBotPrecheckoutQuery_param_payload_type_bytes' => 'Bot specified invoice payload',
+  'object_updateBotPrecheckoutQuery_param_info_type_PaymentRequestedInfo' => 'Order info provided by the user',
+  'object_updateBotPrecheckoutQuery_param_shipping_option_id_type_string' => 'Identifier of the shipping option chosen by the user',
+  'object_updateBotPrecheckoutQuery_param_currency_type_string' => 'Three-letter ISO 4217 [currency](https://core.telegram.org/bots/payments#supported-currencies) code',
+  'object_updateBotPrecheckoutQuery_param_total_amount_type_long' => 'Total amount in the smallest units of the currency (integer, not float/double). For example, for a price of `US$ 1.45` pass `amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).',
+  'object_updatePhoneCall' => 'An incoming phone call',
   'object_updatePhoneCall_param_phone_call_type_PhoneCall' => 'Phone call',
-  'object_updateLangPackTooLong' => 'Update lang pack too long',
-  'object_updateLangPack' => 'Update lang pack',
-  'object_updateLangPack_param_difference_type_LangPackDifference' => 'Difference',
-  'object_updateFavedStickers' => 'Update faved stickers',
-  'object_updateChannelReadMessagesContents' => 'Update channel read messages contents',
-  'object_updateChannelReadMessagesContents_param_channel_id_type_int' => 'Channel ID',
+  'object_updateLangPackTooLong' => 'A language pack has changed, the client should manually fetch the changed strings using [langpack.getDifference](../methods/langpack.getDifference.md)',
+  'object_updateLangPack' => 'Language pack updated',
+  'object_updateLangPack_param_difference_type_LangPackDifference' => 'Changed strings',
+  'object_updateFavedStickers' => 'The list of favorited stickers was changed, the client should call [messages.getFavedStickers](../methods/messages.getFavedStickers.md) to refetch the new list',
+  'object_updateChannelReadMessagesContents' => 'The specified [channel/supergroup](https://core.telegram.org/api/channel) messages were read',
+  'object_updateChannelReadMessagesContents_param_channel_id_type_int' => '[Channel/supergroup](https://core.telegram.org/api/channel) ID',
   'object_updateChannelReadMessagesContents_param_messages_type_Vector t' => 'Messages',
-  'object_updateContactsReset' => 'Update contacts reset',
-  'object_updateChannelAvailableMessages' => 'Update channel available messages',
-  'object_updateChannelAvailableMessages_param_channel_id_type_int' => 'Channel ID',
-  'object_updateChannelAvailableMessages_param_available_min_id_type_int' => 'Available min ID',
-  'object_updates.state' => 'State',
-  'object_updates.state_param_pts_type_int' => 'Pts',
-  'object_updates.state_param_qts_type_int' => 'Qts',
-  'object_updates.state_param_date_type_int' => 'Date',
-  'object_updates.state_param_seq_type_int' => 'Seq',
-  'object_updates.state_param_unread_count_type_int' => 'Unread count',
-  'object_updates.differenceEmpty' => 'Empty difference',
-  'object_updates.differenceEmpty_param_date_type_int' => 'Date',
-  'object_updates.differenceEmpty_param_seq_type_int' => 'Seq',
-  'object_updates.difference' => 'Difference',
+  'object_updateContactsReset' => 'All contacts were deleted',
+  'object_updateChannelAvailableMessages' => 'The history of a [channel/supergroup](https://core.telegram.org/api/channel) was hidden.',
+  'object_updateChannelAvailableMessages_param_channel_id_type_int' => 'Channel/supergroup ID',
+  'object_updateChannelAvailableMessages_param_available_min_id_type_int' => 'Identifier of a maximum unavailable message in a channel due to hidden history.',
+  'object_updates.state' => 'Updates state.',
+  'object_updates.state_param_pts_type_int' => 'Number of events occured in a text box',
+  'object_updates.state_param_qts_type_int' => 'Position in a sequence of updates in secret chats. For further detailes refer to article [secret chats](https://core.telegram.org/api/end-to-end)
Parameter was added in [eigth layer](https://core.telegram.org/api/layers#layer-8).',
+  'object_updates.state_param_date_type_int' => 'Date of condition',
+  'object_updates.state_param_seq_type_int' => 'Number of sent updates',
+  'object_updates.state_param_unread_count_type_int' => 'Number of unread messages',
+  'object_updates.differenceEmpty' => 'No events.',
+  'object_updates.differenceEmpty_param_date_type_int' => 'Current date',
+  'object_updates.differenceEmpty_param_seq_type_int' => 'Number of sent updates',
+  'object_updates.difference' => 'Full list of occurred events.',
   'object_updates.difference_param_new_messages_type_Vector t' => 'New messages',
   'object_updates.difference_param_new_encrypted_messages_type_Vector t' => 'New encrypted messages',
   'object_updates.difference_param_other_updates_type_Vector t' => 'Other updates',
   'object_updates.difference_param_chats_type_Vector t' => 'Chats',
   'object_updates.difference_param_users_type_Vector t' => 'Users',
-  'object_updates.difference_param_state_type_updates.State' => 'State',
-  'object_updates.differenceSlice' => 'Difference slice',
+  'object_updates.difference_param_state_type_updates.State' => 'Current state',
+  'object_updates.differenceSlice' => 'Incomplete list of occurred events.',
   'object_updates.differenceSlice_param_new_messages_type_Vector t' => 'New messages',
   'object_updates.differenceSlice_param_new_encrypted_messages_type_Vector t' => 'New encrypted messages',
   'object_updates.differenceSlice_param_other_updates_type_Vector t' => 'Other updates',
   'object_updates.differenceSlice_param_chats_type_Vector t' => 'Chats',
   'object_updates.differenceSlice_param_users_type_Vector t' => 'Users',
-  'object_updates.differenceSlice_param_intermediate_state_type_updates.State' => 'Intermediate state',
-  'object_updates.differenceTooLong' => 'Difference too long',
-  'object_updates.differenceTooLong_param_pts_type_int' => 'Pts',
-  'object_updatesTooLong' => 'Updates too long',
-  'object_updateShortMessage' => 'Update short message',
-  'object_updateShortMessage_param_out_type_true' => 'Out?',
-  'object_updateShortMessage_param_mentioned_type_true' => 'Mentioned?',
-  'object_updateShortMessage_param_media_unread_type_true' => 'Media unread?',
-  'object_updateShortMessage_param_silent_type_true' => 'Silent?',
-  'object_updateShortMessage_param_id_type_int' => 'ID',
-  'object_updateShortMessage_param_user_id_type_int' => 'User ID',
-  'object_updateShortMessage_param_message_type_string' => 'Message',
-  'object_updateShortMessage_param_pts_type_int' => 'Pts',
-  'object_updateShortMessage_param_pts_count_type_int' => 'Pts count',
-  'object_updateShortMessage_param_date_type_int' => 'Date',
-  'object_updateShortMessage_param_fwd_from_type_MessageFwdHeader' => 'Fwd from',
-  'object_updateShortMessage_param_via_bot_id_type_int' => 'Via bot ID',
-  'object_updateShortMessage_param_reply_to_msg_id_type_int' => 'Reply to msg ID',
+  'object_updates.differenceSlice_param_intermediate_state_type_updates.State' => 'Intermediary state',
+  'object_updates.differenceTooLong' => 'The difference is [too long](https://core.telegram.org/api/updates#recovering-gaps), and the specified state must be used to refetch updates.',
+  'object_updates.differenceTooLong_param_pts_type_int' => 'The new state to use.',
+  'object_updatesTooLong' => 'Too many updates, it is necessary to execute [updates.getDifference](../methods/updates.getDifference.md).',
+  'object_updateShortMessage' => 'Info about a message sent to (received from) another user',
+  'object_updateShortMessage_param_out_type_true' => 'Whether the message is outgoing',
+  'object_updateShortMessage_param_mentioned_type_true' => 'Whether we were mentioned in the message',
+  'object_updateShortMessage_param_media_unread_type_true' => 'Whether there are some **unread** mentions in this message',
+  'object_updateShortMessage_param_silent_type_true' => 'If true, the message is a silent message, no notifications should be triggered',
+  'object_updateShortMessage_param_id_type_int' => 'The message ID',
+  'object_updateShortMessage_param_user_id_type_int' => 'The ID of the sender (if `outgoing` will be the ID of the destination) of the message',
+  'object_updateShortMessage_param_message_type_string' => 'The message',
+  'object_updateShortMessage_param_pts_type_int' => '[PTS](https://core.telegram.org/api/updates)',
+  'object_updateShortMessage_param_pts_count_type_int' => '[PTS count](https://core.telegram.org/api/updates)',
+  'object_updateShortMessage_param_date_type_int' => '[date](https://core.telegram.org/api/updates)',
+  'object_updateShortMessage_param_fwd_from_type_MessageFwdHeader' => 'Info about a forwarded message',
+  'object_updateShortMessage_param_via_bot_id_type_int' => 'Info about the inline bot used to generate this message',
+  'object_updateShortMessage_param_reply_to_msg_id_type_int' => 'ID of the message this message replies to',
   'object_updateShortMessage_param_entities_type_Vector t' => 'Entities',
-  'object_updateShortChatMessage' => 'Update short chat message',
-  'object_updateShortChatMessage_param_out_type_true' => 'Out?',
-  'object_updateShortChatMessage_param_mentioned_type_true' => 'Mentioned?',
-  'object_updateShortChatMessage_param_media_unread_type_true' => 'Media unread?',
-  'object_updateShortChatMessage_param_silent_type_true' => 'Silent?',
-  'object_updateShortChatMessage_param_id_type_int' => 'ID',
-  'object_updateShortChatMessage_param_from_id_type_int' => 'From ID',
-  'object_updateShortChatMessage_param_chat_id_type_int' => 'Chat ID',
+  'object_updateShortChatMessage' => 'Shortened constructor containing info on one new incoming text message from a chat',
+  'object_updateShortChatMessage_param_out_type_true' => 'Whether the message is outgoing',
+  'object_updateShortChatMessage_param_mentioned_type_true' => 'Whether we were mentioned in this message',
+  'object_updateShortChatMessage_param_media_unread_type_true' => 'Whether the message contains some **unread** mentions',
+  'object_updateShortChatMessage_param_silent_type_true' => 'If true, the message is a silent message, no notifications should be triggered',
+  'object_updateShortChatMessage_param_id_type_int' => 'ID of the message',
+  'object_updateShortChatMessage_param_from_id_type_int' => 'ID of the sender of the message',
+  'object_updateShortChatMessage_param_chat_id_type_int' => 'ID of the chat where the message was sent',
   'object_updateShortChatMessage_param_message_type_string' => 'Message',
-  'object_updateShortChatMessage_param_pts_type_int' => 'Pts',
-  'object_updateShortChatMessage_param_pts_count_type_int' => 'Pts count',
-  'object_updateShortChatMessage_param_date_type_int' => 'Date',
-  'object_updateShortChatMessage_param_fwd_from_type_MessageFwdHeader' => 'Fwd from',
-  'object_updateShortChatMessage_param_via_bot_id_type_int' => 'Via bot ID',
-  'object_updateShortChatMessage_param_reply_to_msg_id_type_int' => 'Reply to msg ID',
+  'object_updateShortChatMessage_param_pts_type_int' => '[PTS](https://core.telegram.org/api/updates)',
+  'object_updateShortChatMessage_param_pts_count_type_int' => '[PTS count](https://core.telegram.org/api/updates)',
+  'object_updateShortChatMessage_param_date_type_int' => '[date](https://core.telegram.org/api/updates)',
+  'object_updateShortChatMessage_param_fwd_from_type_MessageFwdHeader' => 'Info about a forwarded message',
+  'object_updateShortChatMessage_param_via_bot_id_type_int' => 'Info about the inline bot used to generate this message',
+  'object_updateShortChatMessage_param_reply_to_msg_id_type_int' => 'ID of the message this message replies to',
   'object_updateShortChatMessage_param_entities_type_Vector t' => 'Entities',
-  'object_updateShort' => 'Update short',
+  'object_updateShort' => 'Shortened constructor containing info on one update not requiring auxiliary data',
   'object_updateShort_param_update_type_Update' => 'Update',
-  'object_updateShort_param_date_type_int' => 'Date',
-  'object_updatesCombined' => 'Updates combined',
+  'object_updateShort_param_date_type_int' => 'Date of event',
+  'object_updatesCombined' => 'Constructor for a group of updates.',
   'object_updatesCombined_param_updates_type_Vector t' => 'Updates',
   'object_updatesCombined_param_users_type_Vector t' => 'Users',
   'object_updatesCombined_param_chats_type_Vector t' => 'Chats',
-  'object_updatesCombined_param_date_type_int' => 'Date',
-  'object_updatesCombined_param_seq_start_type_int' => 'Seq start',
-  'object_updatesCombined_param_seq_type_int' => 'Seq',
-  'object_updates' => 'Updates',
+  'object_updatesCombined_param_date_type_int' => 'Current date',
+  'object_updatesCombined_param_seq_start_type_int' => 'Value **seq** for the earliest update in a group',
+  'object_updatesCombined_param_seq_type_int' => 'Value **seq** for the latest update in a group',
+  'object_updates' => 'Full constructor of updates',
   'object_updates_param_updates_type_Vector t' => 'Updates',
   'object_updates_param_users_type_Vector t' => 'Users',
   'object_updates_param_chats_type_Vector t' => 'Chats',
-  'object_updates_param_date_type_int' => 'Date',
-  'object_updates_param_seq_type_int' => 'Seq',
-  'object_updateShortSentMessage' => 'Update short sent message',
-  'object_updateShortSentMessage_param_out_type_true' => 'Out?',
-  'object_updateShortSentMessage_param_id_type_int' => 'ID',
-  'object_updateShortSentMessage_param_pts_type_int' => 'Pts',
-  'object_updateShortSentMessage_param_pts_count_type_int' => 'Pts count',
-  'object_updateShortSentMessage_param_date_type_int' => 'Date',
-  'object_updateShortSentMessage_param_media_type_MessageMedia' => 'Media',
+  'object_updates_param_date_type_int' => 'Current date',
+  'object_updates_param_seq_type_int' => 'Total number of sent updates',
+  'object_updateShortSentMessage' => 'Shortened constructor containing info on one outgoing message to a contact (the destination chat has to be extracted from the method call that returned this object).',
+  'object_updateShortSentMessage_param_out_type_true' => 'Whether the message is outgoing',
+  'object_updateShortSentMessage_param_id_type_int' => 'ID of the sent message',
+  'object_updateShortSentMessage_param_pts_type_int' => '[PTS](https://core.telegram.org/api/updates)',
+  'object_updateShortSentMessage_param_pts_count_type_int' => '[PTS count](https://core.telegram.org/api/updates)',
+  'object_updateShortSentMessage_param_date_type_int' => '[date](https://core.telegram.org/api/updates)',
+  'object_updateShortSentMessage_param_media_type_MessageMedia' => 'Attached media',
   'object_updateShortSentMessage_param_entities_type_Vector t' => 'Entities',
-  'object_photos.photos' => 'Photos',
+  'object_photos.photos' => 'Full list of photos with auxiliary data.',
   'object_photos.photos_param_photos_type_Vector t' => 'Photos',
   'object_photos.photos_param_users_type_Vector t' => 'Users',
-  'object_photos.photosSlice' => 'Photos slice',
-  'object_photos.photosSlice_param_count_type_int' => 'Count',
+  'object_photos.photosSlice' => 'Incomplete list of photos with auxiliary data.',
+  'object_photos.photosSlice_param_count_type_int' => 'Total number of photos',
   'object_photos.photosSlice_param_photos_type_Vector t' => 'Photos',
   'object_photos.photosSlice_param_users_type_Vector t' => 'Users',
-  'object_photos.photo' => 'Photo',
+  'object_photos.photo' => 'Photo with auxiliary data.',
   'object_photos.photo_param_photo_type_Photo' => 'Photo',
   'object_photos.photo_param_users_type_Vector t' => 'Users',
-  'object_upload.file' => 'File',
-  'object_upload.file_param_type_type_storage.FileType' => 'Type',
-  'object_upload.file_param_mtime_type_int' => 'Mtime',
-  'object_upload.file_param_bytes_type_bytes' => 'Bytes',
-  'object_upload.fileCdnRedirect' => 'File cdn redirect',
-  'object_upload.fileCdnRedirect_param_dc_id_type_int' => 'DC ID',
-  'object_upload.fileCdnRedirect_param_file_token_type_bytes' => 'File token',
-  'object_upload.fileCdnRedirect_param_encryption_key_type_bytes' => 'Encryption key',
-  'object_upload.fileCdnRedirect_param_encryption_iv_type_bytes' => 'Encryption iv',
+  'object_upload.file' => 'File content.',
+  'object_upload.file_param_type_type_storage.FileType' => 'File type',
+  'object_upload.file_param_mtime_type_int' => 'Modification type',
+  'object_upload.file_param_bytes_type_bytes' => 'Binary data, file content',
+  'object_upload.fileCdnRedirect' => 'The file must be downloaded from a [CDN DC](https://core.telegram.org/cdn).',
+  'object_upload.fileCdnRedirect_param_dc_id_type_int' => '[CDN DC](https://core.telegram.org/cdn) ID',
+  'object_upload.fileCdnRedirect_param_file_token_type_bytes' => 'File token (see [CDN files](https://core.telegram.org/cdn)',
+  'object_upload.fileCdnRedirect_param_encryption_key_type_bytes' => 'Encryption key (see [CDN files](https://core.telegram.org/cdn)',
+  'object_upload.fileCdnRedirect_param_encryption_iv_type_bytes' => 'Encryption IV (see [CDN files](https://core.telegram.org/cdn)',
   'object_upload.fileCdnRedirect_param_cdn_file_hashes_type_Vector t' => 'Cdn file hashes',
-  'object_dcOption' => 'DC option',
-  'object_dcOption_param_ipv6_type_true' => 'Ipv6?',
-  'object_dcOption_param_media_only_type_true' => 'Media only?',
-  'object_dcOption_param_tcpo_only_type_true' => 'Tcpo only?',
-  'object_dcOption_param_cdn_type_true' => 'Cdn?',
-  'object_dcOption_param_static_type_true' => 'Static?',
-  'object_dcOption_param_id_type_int' => 'ID',
-  'object_dcOption_param_ip_address_type_string' => 'Ip address',
+  'object_dcOption' => 'Data centre',
+  'object_dcOption_param_ipv6_type_true' => 'Whether the specified IP is an IPv6 address',
+  'object_dcOption_param_media_only_type_true' => 'Whether this DC should only be used to [download or upload files](https://core.telegram.org/api/files)',
+  'object_dcOption_param_tcpo_only_type_true' => 'Whether this DC only supports connection with [transport obfuscation](https://core.telegram.org/mtproto/mtproto-transports#transport-obfuscation)',
+  'object_dcOption_param_cdn_type_true' => 'Whether this is a [CDN DC](https://core.telegram.org/cdn).',
+  'object_dcOption_param_static_type_true' => 'If set, this IP should be used when connecting through a proxy',
+  'object_dcOption_param_id_type_int' => 'DC ID',
+  'object_dcOption_param_ip_address_type_string' => 'IP address of DC',
   'object_dcOption_param_port_type_int' => 'Port',
-  'object_config' => 'Config',
-  'object_config_param_phonecalls_enabled_type_true' => 'Phonecalls enabled?',
-  'object_config_param_default_p2p_contacts_type_true' => 'Default p2p contacts?',
-  'object_config_param_date_type_int' => 'Date',
-  'object_config_param_expires_type_int' => 'Expires',
-  'object_config_param_test_mode_type_Bool' => 'Test mode?',
-  'object_config_param_this_dc_type_int' => 'This DC',
+  'object_config' => 'Current configuration',
+  'object_config_param_phonecalls_enabled_type_true' => 'Whether phone calls can be used',
+  'object_config_param_default_p2p_contacts_type_true' => 'Whether the client should use P2P by default for phone calls with contacts',
+  'object_config_param_date_type_int' => 'Current date at the server',
+  'object_config_param_expires_type_int' => 'Expiration date of this config: when it expires it\'ll have to be refetched using [help.getConfig](../methods/help.getConfig.md)',
+  'object_config_param_test_mode_type_Bool' => 'Whether we\'re connected to the test DCs',
+  'object_config_param_this_dc_type_int' => 'ID of the DC that returned the reply',
   'object_config_param_dc_options_type_Vector t' => 'DC options',
-  'object_config_param_chat_size_max_type_int' => 'Chat size max',
-  'object_config_param_megagroup_size_max_type_int' => 'Megagroup size max',
-  'object_config_param_forwarded_count_max_type_int' => 'Forwarded count max',
-  'object_config_param_online_update_period_ms_type_int' => 'Online update period ms',
-  'object_config_param_offline_blur_timeout_ms_type_int' => 'Offline blur timeout ms',
-  'object_config_param_offline_idle_timeout_ms_type_int' => 'Offline IDle timeout ms',
-  'object_config_param_online_cloud_timeout_ms_type_int' => 'Online cloud timeout ms',
-  'object_config_param_notify_cloud_delay_ms_type_int' => 'Notify cloud delay ms',
-  'object_config_param_notify_default_delay_ms_type_int' => 'Notify default delay ms',
+  'object_config_param_chat_size_max_type_int' => 'Maximum member count for normal [groups](https://core.telegram.org/api/channel)',
+  'object_config_param_megagroup_size_max_type_int' => 'Maximum member count for [supergroups](https://core.telegram.org/api/channel)',
+  'object_config_param_forwarded_count_max_type_int' => 'Maximum number of messages that can be forwarded at once using [messages.forwardMessages](../methods/messages.forwardMessages.md).',
+  'object_config_param_online_update_period_ms_type_int' => 'The client should [update its online status](../methods/account.updateStatus.md) every N milliseconds',
+  'object_config_param_offline_blur_timeout_ms_type_int' => 'Delay before offline status needs to be sent to the server',
+  'object_config_param_offline_idle_timeout_ms_type_int' => 'Time without any user activity after which it should be treated offline',
+  'object_config_param_online_cloud_timeout_ms_type_int' => 'If we are offline, but were online from some other client in last `online_cloud_timeout_ms` milliseconds after we had gone offline, then delay offline notification for `notify_cloud_delay_ms` milliseconds.',
+  'object_config_param_notify_cloud_delay_ms_type_int' => 'If we are offline, but online from some other client then delay sending the offline notification for `notify_cloud_delay_ms` milliseconds.',
+  'object_config_param_notify_default_delay_ms_type_int' => 'If some other client is online, then delay notification for `notification_default_delay_ms` milliseconds',
   'object_config_param_chat_big_size_type_int' => 'Chat big size',
-  'object_config_param_push_chat_period_ms_type_int' => 'Push chat period ms',
-  'object_config_param_push_chat_limit_type_int' => 'Push chat limit',
-  'object_config_param_saved_gifs_limit_type_int' => 'Saved gifs limit',
-  'object_config_param_edit_time_limit_type_int' => 'Edit time limit',
-  'object_config_param_rating_e_decay_type_int' => 'Rating e decay',
-  'object_config_param_stickers_recent_limit_type_int' => 'Stickers recent limit',
-  'object_config_param_stickers_faved_limit_type_int' => 'Stickers faved limit',
-  'object_config_param_channels_read_media_period_type_int' => 'Channels read media period',
-  'object_config_param_tmp_sessions_type_int' => 'Tmp sessions',
-  'object_config_param_pinned_dialogs_count_max_type_int' => 'Pinned dialogs count max',
-  'object_config_param_call_receive_timeout_ms_type_int' => 'Call receive timeout ms',
-  'object_config_param_call_ring_timeout_ms_type_int' => 'Call ring timeout ms',
-  'object_config_param_call_connect_timeout_ms_type_int' => 'Call connect timeout ms',
-  'object_config_param_call_packet_timeout_ms_type_int' => 'Call packet timeout ms',
-  'object_config_param_me_url_prefix_type_string' => 'Me URL prefix',
-  'object_config_param_suggested_lang_code_type_string' => 'Suggested lang code',
-  'object_config_param_lang_pack_version_type_int' => 'Lang pack version',
+  'object_config_param_push_chat_period_ms_type_int' => 'Not for client use',
+  'object_config_param_push_chat_limit_type_int' => 'Not for client use',
+  'object_config_param_saved_gifs_limit_type_int' => 'Maximum count of saved gifs',
+  'object_config_param_edit_time_limit_type_int' => 'Only messages with age smaller than the one specified can be edited',
+  'object_config_param_rating_e_decay_type_int' => 'Exponential decay rate for computing [top peer rating](https://core.telegram.org/api/top-rating)',
+  'object_config_param_stickers_recent_limit_type_int' => 'Maximum number of recent stickers',
+  'object_config_param_stickers_faved_limit_type_int' => 'Maximum number of faved stickers',
+  'object_config_param_channels_read_media_period_type_int' => 'Indicates that round videos (video notes) and voice messages sent in channels and older than the specified period must be marked as read',
+  'object_config_param_tmp_sessions_type_int' => 'Temporary [passport](https://core.telegram.org/passport) sessions',
+  'object_config_param_pinned_dialogs_count_max_type_int' => 'Maximum count of pinned dialogs',
+  'object_config_param_call_receive_timeout_ms_type_int' => 'Maximum allowed outgoing ring time in VoIP calls: if the user we\'re calling doesn\'t reply within the specified time (in milliseconds), we should hang up the call',
+  'object_config_param_call_ring_timeout_ms_type_int' => 'Maximum allowed incoming ring time in VoIP calls: if the current user doesn\'t reply within the specified time (in milliseconds), the call will be automatically refused',
+  'object_config_param_call_connect_timeout_ms_type_int' => 'VoIP connection timeout: if the instance of libtgvoip on the other side of the call doesn\'t connect to our instance of libtgvoip within the specified time (in milliseconds), the call must be aborted',
+  'object_config_param_call_packet_timeout_ms_type_int' => 'If during a VoIP call a packet isn\'t received for the specified period of time, the call must be aborted',
+  'object_config_param_me_url_prefix_type_string' => 'The domain to use to parse in-app links.
For example t.me indicates that t.me/username links should parsed to @username, t.me/addsticker/name should be parsed to the appropriate stickerset and so on...',
+  'object_config_param_suggested_lang_code_type_string' => 'Suggested language code',
+  'object_config_param_lang_pack_version_type_int' => 'Language pack version',
   'object_config_param_disabled_features_type_Vector t' => 'Disabled features',
-  'object_nearestDc' => 'Nearest DC',
-  'object_nearestDc_param_country_type_string' => 'Country',
-  'object_nearestDc_param_this_dc_type_int' => 'This DC',
-  'object_nearestDc_param_nearest_dc_type_int' => 'Nearest DC',
-  'object_help.appUpdate' => 'App update',
-  'object_help.appUpdate_param_id_type_int' => 'ID',
+  'object_nearestDc' => 'Nearest data centre, according to geo-ip.',
+  'object_nearestDc_param_country_type_string' => 'Country code determined by geo-ip',
+  'object_nearestDc_param_this_dc_type_int' => 'Number of current data centre',
+  'object_nearestDc_param_nearest_dc_type_int' => 'Number of nearest data centre',
+  'object_help.appUpdate' => 'An update is available for the application.',
+  'object_help.appUpdate_param_id_type_int' => 'Update ID',
   'object_help.appUpdate_param_critical_type_Bool' => 'Critical?',
-  'object_help.appUpdate_param_url_type_string' => 'URL',
-  'object_help.appUpdate_param_text_type_string' => 'Text',
-  'object_help.noAppUpdate' => 'No app update',
-  'object_help.inviteText' => 'Invite text',
-  'object_help.inviteText_param_message_type_string' => 'Message',
-  'object_encryptedChatEmpty' => 'Empty encrypted chat',
-  'object_encryptedChatEmpty_param_id_type_int' => 'ID',
-  'object_encryptedChatWaiting' => 'Encrypted chat waiting',
-  'object_encryptedChatWaiting_param_id_type_int' => 'ID',
-  'object_encryptedChatWaiting_param_access_hash_type_long' => 'Access hash',
-  'object_encryptedChatWaiting_param_date_type_int' => 'Date',
-  'object_encryptedChatWaiting_param_admin_id_type_int' => 'Admin ID',
-  'object_encryptedChatWaiting_param_participant_id_type_int' => 'Participant ID',
-  'object_encryptedChatRequested' => 'Encrypted chat requested',
-  'object_encryptedChatRequested_param_id_type_int' => 'ID',
-  'object_encryptedChatRequested_param_access_hash_type_long' => 'Access hash',
-  'object_encryptedChatRequested_param_date_type_int' => 'Date',
-  'object_encryptedChatRequested_param_admin_id_type_int' => 'Admin ID',
-  'object_encryptedChatRequested_param_participant_id_type_int' => 'Participant ID',
-  'object_encryptedChatRequested_param_g_a_type_bytes' => 'G a',
+  'object_help.appUpdate_param_url_type_string' => 'Application download URL',
+  'object_help.appUpdate_param_text_type_string' => 'Text description of the update',
+  'object_help.noAppUpdate' => 'No updates are available for the application.',
+  'object_help.inviteText' => 'Text of a text message with an invitation to install application.',
+  'object_help.inviteText_param_message_type_string' => 'Text of a message',
+  'object_encryptedChatEmpty' => 'Empty constructor.',
+  'object_encryptedChatEmpty_param_id_type_int' => 'Chat ID',
+  'object_encryptedChatWaiting' => 'Chat waiting for approval of second participant.',
+  'object_encryptedChatWaiting_param_id_type_int' => 'Chat ID',
+  'object_encryptedChatWaiting_param_access_hash_type_long' => 'Checking sum depending on user ID',
+  'object_encryptedChatWaiting_param_date_type_int' => 'Date of chat creation',
+  'object_encryptedChatWaiting_param_admin_id_type_int' => 'Chat creator ID',
+  'object_encryptedChatWaiting_param_participant_id_type_int' => 'ID of second chat participant',
+  'object_encryptedChatRequested' => 'Request to create an encrypted chat.',
+  'object_encryptedChatRequested_param_id_type_int' => 'Chat ID',
+  'object_encryptedChatRequested_param_access_hash_type_long' => 'Check sum depending on user ID',
+  'object_encryptedChatRequested_param_date_type_int' => 'Chat creation date',
+  'object_encryptedChatRequested_param_admin_id_type_int' => 'Chat creator ID',
+  'object_encryptedChatRequested_param_participant_id_type_int' => 'ID of second chat participant',
+  'object_encryptedChatRequested_param_g_a_type_bytes' => '`A = g ^ a mod p`, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange)',
   'object_encryptedChat' => 'Encrypted chat',
-  'object_encryptedChat_param_id_type_int' => 'ID',
-  'object_encryptedChat_param_access_hash_type_long' => 'Access hash',
-  'object_encryptedChat_param_date_type_int' => 'Date',
-  'object_encryptedChat_param_admin_id_type_int' => 'Admin ID',
-  'object_encryptedChat_param_participant_id_type_int' => 'Participant ID',
-  'object_encryptedChat_param_g_a_or_b_type_bytes' => 'G a or b',
-  'object_encryptedChat_param_key_fingerprint_type_long' => 'Key fingerprint',
-  'object_encryptedChatDiscarded' => 'Encrypted chat discarded',
-  'object_encryptedChatDiscarded_param_id_type_int' => 'ID',
-  'object_inputEncryptedChat' => 'Encrypted chat',
+  'object_encryptedChat_param_id_type_int' => 'Chat ID',
+  'object_encryptedChat_param_access_hash_type_long' => 'Check sum dependant on the user ID',
+  'object_encryptedChat_param_date_type_int' => 'Date chat was created',
+  'object_encryptedChat_param_admin_id_type_int' => 'Chat creator ID',
+  'object_encryptedChat_param_participant_id_type_int' => 'ID of the second chat participant',
+  'object_encryptedChat_param_g_a_or_b_type_bytes' => '`B = g ^ b mod p`, if the currently authorized user is the chat\'s creator,
or `A = g ^ a mod p` otherwise
See [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange) for more info',
+  'object_encryptedChat_param_key_fingerprint_type_long' => '64-bit fingerprint of received key',
+  'object_encryptedChatDiscarded' => 'Discarded or deleted chat.',
+  'object_encryptedChatDiscarded_param_id_type_int' => 'Chat ID',
+  'object_inputEncryptedChat' => 'Creates an encrypted chat.',
   'object_inputEncryptedChat_param_chat_id_type_int' => 'Chat ID',
-  'object_inputEncryptedChat_param_access_hash_type_long' => 'Access hash',
-  'object_encryptedFileEmpty' => 'Empty encrypted file',
-  'object_encryptedFile' => 'Encrypted file',
-  'object_encryptedFile_param_id_type_long' => 'ID',
-  'object_encryptedFile_param_access_hash_type_long' => 'Access hash',
-  'object_encryptedFile_param_size_type_int' => 'Size',
-  'object_encryptedFile_param_dc_id_type_int' => 'DC ID',
-  'object_encryptedFile_param_key_fingerprint_type_int' => 'Key fingerprint',
-  'object_inputEncryptedFileEmpty' => 'Empty input encrypted file',
-  'object_inputEncryptedFileUploaded' => 'Encrypted file uploaded',
-  'object_inputEncryptedFileUploaded_param_id_type_long' => 'ID',
-  'object_inputEncryptedFileUploaded_param_parts_type_int' => 'Parts',
-  'object_inputEncryptedFileUploaded_param_md5_checksum_type_string' => 'Md5 checksum',
-  'object_inputEncryptedFileUploaded_param_key_fingerprint_type_int' => 'Key fingerprint',
-  'object_inputEncryptedFile' => 'Encrypted file',
-  'object_inputEncryptedFile_param_id_type_long' => 'ID',
-  'object_inputEncryptedFile_param_access_hash_type_long' => 'Access hash',
-  'object_inputEncryptedFileBigUploaded' => 'Encrypted file big uploaded',
-  'object_inputEncryptedFileBigUploaded_param_id_type_long' => 'ID',
-  'object_inputEncryptedFileBigUploaded_param_parts_type_int' => 'Parts',
-  'object_inputEncryptedFileBigUploaded_param_key_fingerprint_type_int' => 'Key fingerprint',
-  'object_encryptedMessage' => 'Encrypted message',
-  'object_encryptedMessage_param_chat_id_type_int' => 'Chat ID',
-  'object_encryptedMessage_param_date_type_int' => 'Date',
+  'object_inputEncryptedChat_param_access_hash_type_long' => 'Checking sum from constructor [encryptedChat](../constructors/encryptedChat.md), [encryptedChatWaiting](../constructors/encryptedChatWaiting.md) or [encryptedChatRequested](../constructors/encryptedChatRequested.md)',
+  'object_encryptedFileEmpty' => 'Empty constructor, unexisitng file.',
+  'object_encryptedFile' => 'Encrypted file.',
+  'object_encryptedFile_param_id_type_long' => 'File ID',
+  'object_encryptedFile_param_access_hash_type_long' => 'Checking sum depending on user ID',
+  'object_encryptedFile_param_size_type_int' => 'File size in bytes',
+  'object_encryptedFile_param_dc_id_type_int' => 'Number of data centre',
+  'object_encryptedFile_param_key_fingerprint_type_int' => '32-bit fingerprint of key used for file encryption',
+  'object_inputEncryptedFileEmpty' => 'Empty constructor.',
+  'object_inputEncryptedFileUploaded' => 'Sets new encrypted file saved by parts using upload.saveFilePart method.',
+  'object_inputEncryptedFileUploaded_param_id_type_long' => 'Random file ID created by clien',
+  'object_inputEncryptedFileUploaded_param_parts_type_int' => 'Number of saved parts',
+  'object_inputEncryptedFileUploaded_param_md5_checksum_type_string' => 'In case [md5-HASH](https://en.wikipedia.org/wiki/MD5) of the (already encrypted) file was transmitted, file content will be checked prior to use',
+  'object_inputEncryptedFileUploaded_param_key_fingerprint_type_int' => '32-bit fingerprint of the key used to encrypt a file',
+  'object_inputEncryptedFile' => 'Sets forwarded encrypted file for attachment.',
+  'object_inputEncryptedFile_param_id_type_long' => 'File ID, value of **id** parameter from [encryptedFile](../constructors/encryptedFile.md)',
+  'object_inputEncryptedFile_param_access_hash_type_long' => 'Checking sum, value of **access\\_hash** parameter from [encryptedFile](../constructors/encryptedFile.md)',
+  'object_inputEncryptedFileBigUploaded' => 'Assigns a new big encrypted file (over 10Mb in size), saved in parts using the method [upload.saveBigFilePart](../methods/upload.saveBigFilePart.md).',
+  'object_inputEncryptedFileBigUploaded_param_id_type_long' => 'Random file id, created by the client',
+  'object_inputEncryptedFileBigUploaded_param_parts_type_int' => 'Number of saved parts',
+  'object_inputEncryptedFileBigUploaded_param_key_fingerprint_type_int' => '32-bit imprint of the key used to encrypt the file',
+  'object_encryptedMessage' => 'Encrypted message.',
+  'object_encryptedMessage_param_chat_id_type_int' => 'ID of encrypted chat',
+  'object_encryptedMessage_param_date_type_int' => 'Date of sending',
   'object_encryptedMessage_param_decrypted_message_type_DecryptedMessage' => 'Decrypted message',
-  'object_encryptedMessage_param_file_type_EncryptedFile' => 'File',
-  'object_encryptedMessageService' => 'Encrypted message service',
-  'object_encryptedMessageService_param_chat_id_type_int' => 'Chat ID',
-  'object_encryptedMessageService_param_date_type_int' => 'Date',
+  'object_encryptedMessage_param_file_type_EncryptedFile' => 'Attached encrypted file',
+  'object_encryptedMessageService' => 'Encrypted service message',
+  'object_encryptedMessageService_param_chat_id_type_int' => 'ID of encrypted chat',
+  'object_encryptedMessageService_param_date_type_int' => 'Date of sending',
   'object_encryptedMessageService_param_decrypted_message_type_DecryptedMessage' => 'Decrypted message',
-  'object_messages.dhConfigNotModified' => 'Dh config not modified',
-  'object_messages.dhConfigNotModified_param_random_type_bytes' => 'Random',
-  'object_messages.dhConfig' => 'Dh config',
-  'object_messages.dhConfig_param_g_type_int' => 'G',
-  'object_messages.dhConfig_param_p_type_bytes' => 'P',
-  'object_messages.dhConfig_param_version_type_int' => 'Version',
-  'object_messages.dhConfig_param_random_type_bytes' => 'Random',
-  'object_messages.sentEncryptedMessage' => 'Sent encrypted message',
-  'object_messages.sentEncryptedMessage_param_date_type_int' => 'Date',
-  'object_messages.sentEncryptedFile' => 'Sent encrypted file',
-  'object_messages.sentEncryptedFile_param_date_type_int' => 'Date',
-  'object_messages.sentEncryptedFile_param_file_type_EncryptedFile' => 'File',
-  'object_inputDocumentEmpty' => 'Empty input document',
-  'object_inputDocument' => 'Document',
-  'object_inputDocument_param_id_type_long' => 'ID',
-  'object_inputDocument_param_access_hash_type_long' => 'Access hash',
-  'object_documentEmpty' => 'Empty document',
-  'object_documentEmpty_param_id_type_long' => 'ID',
+  'object_messages.dhConfigNotModified' => 'Configuring parameters did not change.',
+  'object_messages.dhConfigNotModified_param_random_type_bytes' => 'Random sequence of bytes of assigned length',
+  'object_messages.dhConfig' => 'New set of configuring parameters.',
+  'object_messages.dhConfig_param_g_type_int' => 'New value **prime**, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange)',
+  'object_messages.dhConfig_param_p_type_bytes' => 'New value **primitive root**, see [Wikipedia](https://en.wikipedia.org/wiki/Diffie%E2%80%93Hellman_key_exchange)',
+  'object_messages.dhConfig_param_version_type_int' => 'Vestion of set of parameters',
+  'object_messages.dhConfig_param_random_type_bytes' => 'Random sequence of bytes of assigned length',
+  'object_messages.sentEncryptedMessage' => 'Message without file attachemts sent to an encrypted file.',
+  'object_messages.sentEncryptedMessage_param_date_type_int' => 'Date of sending',
+  'object_messages.sentEncryptedFile' => 'Message with a file enclosure sent to a protected chat',
+  'object_messages.sentEncryptedFile_param_date_type_int' => 'Sending date',
+  'object_messages.sentEncryptedFile_param_file_type_EncryptedFile' => 'Attached file',
+  'object_inputDocumentEmpty' => 'Empty constructor.',
+  'object_inputDocument' => 'Defines a video for subsequent interaction.',
+  'object_inputDocument_param_id_type_long' => 'Document ID',
+  'object_inputDocument_param_access_hash_type_long' => '**access\\_hash** parameter from the [document](../constructors/document.md) constructor',
+  'object_documentEmpty' => 'Empty constructor, document doesn\'t exist.',
+  'object_documentEmpty_param_id_type_long' => 'Document ID or `0`',
   'object_document' => 'Document',
-  'object_document_param_id_type_long' => 'ID',
-  'object_document_param_access_hash_type_long' => 'Access hash',
-  'object_document_param_date_type_int' => 'Date',
-  'object_document_param_mime_type_type_string' => 'Mime type',
+  'object_document_param_id_type_long' => 'Document ID',
+  'object_document_param_access_hash_type_long' => 'Check sum, dependant on document ID',
+  'object_document_param_date_type_int' => 'Creation date',
+  'object_document_param_mime_type_type_string' => 'MIME type',
   'object_document_param_size_type_int' => 'Size',
   'object_document_param_thumb_type_PhotoSize' => 'Thumbnail',
   'object_document_param_dc_id_type_int' => 'DC ID',
   'object_document_param_version_type_int' => 'Version',
   'object_document_param_attributes_type_Vector t' => 'Attributes',
-  'object_help.support' => 'Support',
+  'object_help.support' => 'Info on support user.',
   'object_help.support_param_phone_number_type_string' => 'Phone number',
   'object_help.support_param_user_type_User' => 'User',
-  'object_notifyPeer' => 'Notify peer',
-  'object_notifyPeer_param_peer_type_Peer' => 'Peer',
-  'object_notifyUsers' => 'Notify users',
-  'object_notifyChats' => 'Notify chats',
+  'object_notifyPeer' => 'Notifications generated by a certain user or group.',
+  'object_notifyPeer_param_peer_type_Peer' => 'user or group',
+  'object_notifyUsers' => 'Notifications generated by all users.',
+  'object_notifyChats' => 'Notifications generated by all groups.',
   'object_notifyAll' => 'Notify all',
-  'object_sendMessageTypingAction' => 'Send message typing action',
-  'object_sendMessageCancelAction' => 'Send message cancel action',
-  'object_sendMessageRecordVideoAction' => 'Send message record video action',
-  'object_sendMessageUploadVideoAction' => 'Send message upload video action',
-  'object_sendMessageUploadVideoAction_param_progress_type_int' => 'Progress',
-  'object_sendMessageRecordAudioAction' => 'Send message record audio action',
-  'object_sendMessageUploadAudioAction' => 'Send message upload audio action',
-  'object_sendMessageUploadAudioAction_param_progress_type_int' => 'Progress',
-  'object_sendMessageUploadPhotoAction' => 'Send message upload photo action',
-  'object_sendMessageUploadPhotoAction_param_progress_type_int' => 'Progress',
-  'object_sendMessageUploadDocumentAction' => 'Send message upload document action',
-  'object_sendMessageUploadDocumentAction_param_progress_type_int' => 'Progress',
-  'object_sendMessageGeoLocationAction' => 'Send message geo location action',
-  'object_sendMessageChooseContactAction' => 'Send message choose contact action',
-  'object_sendMessageGamePlayAction' => 'Send message game play action',
-  'object_sendMessageRecordRoundAction' => 'Send message record round action',
-  'object_sendMessageUploadRoundAction' => 'Send message upload round action',
-  'object_sendMessageUploadRoundAction_param_progress_type_int' => 'Progress',
-  'object_contacts.found' => 'Found',
+  'object_sendMessageTypingAction' => 'User is typing.',
+  'object_sendMessageCancelAction' => 'Invalidate all previous action updates. E.g. when user deletes entered text or aborts a video upload.',
+  'object_sendMessageRecordVideoAction' => 'User is recording a video.',
+  'object_sendMessageUploadVideoAction' => 'User is uploading a video.',
+  'object_sendMessageUploadVideoAction_param_progress_type_int' => 'Progress percentage',
+  'object_sendMessageRecordAudioAction' => 'User is recording a voice message.',
+  'object_sendMessageUploadAudioAction' => 'User is uploading a voice message.',
+  'object_sendMessageUploadAudioAction_param_progress_type_int' => 'Progress percentage',
+  'object_sendMessageUploadPhotoAction' => 'User is uploading a photo.',
+  'object_sendMessageUploadPhotoAction_param_progress_type_int' => 'Progress percentage',
+  'object_sendMessageUploadDocumentAction' => 'User is uploading a file.',
+  'object_sendMessageUploadDocumentAction_param_progress_type_int' => 'Progress percentage',
+  'object_sendMessageGeoLocationAction' => 'User is selecting a location to share.',
+  'object_sendMessageChooseContactAction' => 'User is selecting a contact to share.',
+  'object_sendMessageGamePlayAction' => 'User is playing a game',
+  'object_sendMessageRecordRoundAction' => 'User is recording a round video to share',
+  'object_sendMessageUploadRoundAction' => 'User is uploading a round video',
+  'object_sendMessageUploadRoundAction_param_progress_type_int' => 'Progress percentage',
+  'object_contacts.found' => 'Users found by name substring and auxiliary data.',
   'object_contacts.found_param_my_results_type_Vector t' => 'My results',
   'object_contacts.found_param_results_type_Vector t' => 'Results',
   'object_contacts.found_param_chats_type_Vector t' => 'Chats',
   'object_contacts.found_param_users_type_Vector t' => 'Users',
-  'object_inputPrivacyKeyStatusTimestamp' => 'Privacy key status timestamp',
-  'object_inputPrivacyKeyChatInvite' => 'Privacy key chat invite',
-  'object_inputPrivacyKeyPhoneCall' => 'Privacy key phone call',
-  'object_privacyKeyStatusTimestamp' => 'Privacy key status timestamp',
-  'object_privacyKeyPhoneCall' => 'Privacy key phone call',
-  'object_inputPrivacyValueAllowContacts' => 'Privacy value allow contacts',
-  'object_inputPrivacyValueAllowAll' => 'Privacy value allow all',
-  'object_inputPrivacyValueAllowUsers' => 'Privacy value allow users',
+  'object_inputPrivacyKeyStatusTimestamp' => 'Whether we can see the exact last online timestamp of the user',
+  'object_inputPrivacyKeyChatInvite' => 'Whether the user can be invited to chats',
+  'object_inputPrivacyKeyPhoneCall' => 'Whether the user will accept phone calls',
+  'object_privacyKeyStatusTimestamp' => 'Whether we can see the last online timestamp',
+  'object_privacyKeyPhoneCall' => 'Whether the user accepts phone calls',
+  'object_inputPrivacyValueAllowContacts' => 'Allow only contacts',
+  'object_inputPrivacyValueAllowAll' => 'Allow all users',
+  'object_inputPrivacyValueAllowUsers' => 'Allow only certain users',
   'object_inputPrivacyValueAllowUsers_param_users_type_Vector t' => 'Users',
-  'object_inputPrivacyValueDisallowContacts' => 'Privacy value disallow contacts',
-  'object_inputPrivacyValueDisallowAll' => 'Privacy value disallow all',
-  'object_inputPrivacyValueDisallowUsers' => 'Privacy value disallow users',
+  'object_inputPrivacyValueDisallowContacts' => 'Disallow only contacts',
+  'object_inputPrivacyValueDisallowAll' => 'Disallow all',
+  'object_inputPrivacyValueDisallowUsers' => 'Disallow only certain users',
   'object_inputPrivacyValueDisallowUsers_param_users_type_Vector t' => 'Users',
-  'object_privacyValueAllowContacts' => 'Privacy value allow contacts',
-  'object_privacyValueAllowAll' => 'Privacy value allow all',
-  'object_privacyValueAllowUsers' => 'Privacy value allow users',
+  'object_privacyValueAllowContacts' => 'Allow all contacts',
+  'object_privacyValueAllowAll' => 'Allow all users',
+  'object_privacyValueAllowUsers' => 'Allow only certain users',
   'object_privacyValueAllowUsers_param_users_type_Vector t' => 'Users',
-  'object_privacyValueDisallowContacts' => 'Privacy value disallow contacts',
-  'object_privacyValueDisallowAll' => 'Privacy value disallow all',
-  'object_privacyValueDisallowUsers' => 'Privacy value disallow users',
+  'object_privacyValueDisallowContacts' => 'Disallow only contacts',
+  'object_privacyValueDisallowAll' => 'Disallow all users',
+  'object_privacyValueDisallowUsers' => 'Disallow only certain users',
   'object_privacyValueDisallowUsers_param_users_type_Vector t' => 'Users',
   'object_account.privacyRules' => 'Privacy rules',
   'object_account.privacyRules_param_rules_type_Vector t' => 'Rules',
   'object_account.privacyRules_param_users_type_Vector t' => 'Users',
-  'object_accountDaysTTL' => 'Account TTL in days',
-  'object_accountDaysTTL_param_days_type_int' => 'Days',
-  'object_documentAttributeImageSize' => 'Document attribute image size',
-  'object_documentAttributeImageSize_param_w_type_int' => 'Width',
-  'object_documentAttributeImageSize_param_h_type_int' => 'Height',
-  'object_documentAttributeAnimated' => 'Document attribute animated',
-  'object_documentAttributeSticker' => 'Document attribute sticker',
-  'object_documentAttributeSticker_param_mask_type_true' => 'Mask?',
-  'object_documentAttributeSticker_param_alt_type_string' => 'Alt',
-  'object_documentAttributeSticker_param_stickerset_type_InputStickerSet' => 'Stickerset',
-  'object_documentAttributeSticker_param_mask_coords_type_MaskCoords' => 'Mask coords',
-  'object_documentAttributeVideo' => 'Document attribute video',
-  'object_documentAttributeVideo_param_round_message_type_true' => 'Round message?',
-  'object_documentAttributeVideo_param_supports_streaming_type_true' => 'Supports streaming?',
-  'object_documentAttributeVideo_param_duration_type_int' => 'Duration',
-  'object_documentAttributeVideo_param_w_type_int' => 'Width',
-  'object_documentAttributeVideo_param_h_type_int' => 'Height',
-  'object_documentAttributeAudio' => 'Document attribute audio',
-  'object_documentAttributeAudio_param_voice_type_true' => 'Voice?',
-  'object_documentAttributeAudio_param_duration_type_int' => 'Duration',
-  'object_documentAttributeAudio_param_title_type_string' => 'Title',
+  'object_accountDaysTTL' => 'Time to live in days of the current account',
+  'object_accountDaysTTL_param_days_type_int' => 'This account will self-destruct in the specified number of days',
+  'object_documentAttributeImageSize' => 'Defines the width and height of an image uploaded as document',
+  'object_documentAttributeImageSize_param_w_type_int' => 'Width of image',
+  'object_documentAttributeImageSize_param_h_type_int' => 'Height of image',
+  'object_documentAttributeAnimated' => 'Defines an animated GIF',
+  'object_documentAttributeSticker' => 'Defines a sticker',
+  'object_documentAttributeSticker_param_mask_type_true' => 'Whether this is a mask sticker',
+  'object_documentAttributeSticker_param_alt_type_string' => 'Alternative emoji representation of sticker',
+  'object_documentAttributeSticker_param_stickerset_type_InputStickerSet' => 'Associated stickerset',
+  'object_documentAttributeSticker_param_mask_coords_type_MaskCoords' => 'Mask coordinates (if this is a mask sticker, attached to a photo)',
+  'object_documentAttributeVideo' => 'Defines a video',
+  'object_documentAttributeVideo_param_round_message_type_true' => 'Whether this is a round video',
+  'object_documentAttributeVideo_param_supports_streaming_type_true' => 'Whether the video supports streaming',
+  'object_documentAttributeVideo_param_duration_type_int' => 'Duration in seconds',
+  'object_documentAttributeVideo_param_w_type_int' => 'Video width',
+  'object_documentAttributeVideo_param_h_type_int' => 'Video height',
+  'object_documentAttributeAudio' => 'Represents an audio file',
+  'object_documentAttributeAudio_param_voice_type_true' => 'Whether this is a voice message',
+  'object_documentAttributeAudio_param_duration_type_int' => 'Duration in seconds',
+  'object_documentAttributeAudio_param_title_type_string' => 'Name of song',
   'object_documentAttributeAudio_param_performer_type_string' => 'Performer',
   'object_documentAttributeAudio_param_waveform_type_bytes' => 'Waveform',
-  'object_documentAttributeFilename' => 'Document attribute filename',
-  'object_documentAttributeFilename_param_file_name_type_string' => 'File name',
-  'object_documentAttributeHasStickers' => 'Document attribute has stickers',
-  'object_messages.stickersNotModified' => 'Stickers not modified',
-  'object_messages.stickers' => 'Stickers',
+  'object_documentAttributeFilename' => 'A simple document with a file name',
+  'object_documentAttributeFilename_param_file_name_type_string' => 'The file name',
+  'object_documentAttributeHasStickers' => 'Whether the current document has stickers attached',
+  'object_messages.stickersNotModified' => 'No new stickers were found for the given query',
+  'object_messages.stickers' => 'Found stickers',
   'object_messages.stickers_param_hash_type_string' => 'Hash',
   'object_messages.stickers_param_stickers_type_Vector t' => 'Stickers',
-  'object_stickerPack' => 'Sticker pack',
-  'object_stickerPack_param_emoticon_type_string' => 'Emoticon',
+  'object_stickerPack' => 'A stickerpack is a group of stickers associated to the same emoji.  
+It is **not** a sticker pack the way it is usually intended, you may be looking for a [StickerSet](../types/StickerSet.md).',
+  'object_stickerPack_param_emoticon_type_string' => 'Emoji',
   'object_stickerPack_param_documents_type_Vector t' => 'Documents',
-  'object_messages.allStickersNotModified' => 'All stickers not modified',
-  'object_messages.allStickers' => 'All stickers',
-  'object_messages.allStickers_param_hash_type_int' => 'Hash',
+  'object_messages.allStickersNotModified' => 'Info about all installed stickers hasn\'t changed',
+  'object_messages.allStickers' => 'Info about all installed stickers',
+  'object_messages.allStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
   'object_messages.allStickers_param_sets_type_Vector t' => 'Sets',
   'object_disabledFeature' => 'Disabled feature',
   'object_disabledFeature_param_feature_type_string' => 'Feature',
   'object_disabledFeature_param_description_type_string' => 'Description',
-  'object_messages.affectedMessages' => 'Affected messages',
-  'object_messages.affectedMessages_param_pts_type_int' => 'Pts',
-  'object_messages.affectedMessages_param_pts_count_type_int' => 'Pts count',
+  'object_messages.affectedMessages' => 'Events affected by operation',
+  'object_messages.affectedMessages_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+  'object_messages.affectedMessages_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)',
   'object_contactLinkUnknown' => 'Contact link unknown',
   'object_contactLinkNone' => 'Contact link none',
   'object_contactLinkHasPhone' => 'Contact link has phone',
   'object_contactLinkContact' => 'Contact link contact',
-  'object_webPageEmpty' => 'Empty web page',
-  'object_webPageEmpty_param_id_type_long' => 'ID',
-  'object_webPagePending' => 'Web page pending',
-  'object_webPagePending_param_id_type_long' => 'ID',
-  'object_webPagePending_param_date_type_int' => 'Date',
-  'object_webPage' => 'Web page',
-  'object_webPage_param_id_type_long' => 'ID',
-  'object_webPage_param_url_type_string' => 'URL',
-  'object_webPage_param_display_url_type_string' => 'Display URL',
-  'object_webPage_param_hash_type_int' => 'Hash',
-  'object_webPage_param_type_type_string' => 'Type',
-  'object_webPage_param_site_name_type_string' => 'Site name',
-  'object_webPage_param_title_type_string' => 'Title',
-  'object_webPage_param_description_type_string' => 'Description',
-  'object_webPage_param_photo_type_Photo' => 'Photo',
-  'object_webPage_param_embed_url_type_string' => 'Embed URL',
-  'object_webPage_param_embed_type_type_string' => 'Embed type',
-  'object_webPage_param_embed_width_type_int' => 'Embed width',
-  'object_webPage_param_embed_height_type_int' => 'Embed height',
-  'object_webPage_param_duration_type_int' => 'Duration',
-  'object_webPage_param_author_type_string' => 'Author',
-  'object_webPage_param_document_type_Document' => 'Document',
-  'object_webPage_param_cached_page_type_Page' => 'Cached page',
-  'object_webPageNotModified' => 'Web page not modified',
-  'object_authorization' => 'Authorization',
-  'object_authorization_param_hash_type_long' => 'Hash',
+  'object_webPageEmpty' => 'No preview is available for the webpage',
+  'object_webPageEmpty_param_id_type_long' => 'Preview ID',
+  'object_webPagePending' => 'A preview of the webpage is currently being generated',
+  'object_webPagePending_param_id_type_long' => 'ID of preview',
+  'object_webPagePending_param_date_type_int' => 'When was the processing started',
+  'object_webPage' => 'Webpage preview',
+  'object_webPage_param_id_type_long' => 'Preview ID',
+  'object_webPage_param_url_type_string' => 'URL of previewed webpage',
+  'object_webPage_param_display_url_type_string' => 'Webpage URL to be displayed to the user',
+  'object_webPage_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'object_webPage_param_type_type_string' => 'Type of the web page. Can be: article, photo, audio, video, document, profile, app, or something else',
+  'object_webPage_param_site_name_type_string' => 'Short name of the site (e.g., Google Docs, App Store)',
+  'object_webPage_param_title_type_string' => 'Title of the content',
+  'object_webPage_param_description_type_string' => 'Content description',
+  'object_webPage_param_photo_type_Photo' => 'Image representing the content',
+  'object_webPage_param_embed_url_type_string' => 'URL to show in the embedded preview',
+  'object_webPage_param_embed_type_type_string' => 'MIME type of the embedded preview, (e.g., text/html or video/mp4)',
+  'object_webPage_param_embed_width_type_int' => 'Width of the embedded preview',
+  'object_webPage_param_embed_height_type_int' => 'Height of the embedded preview',
+  'object_webPage_param_duration_type_int' => 'Duration of the content, in seconds',
+  'object_webPage_param_author_type_string' => 'Author of the content',
+  'object_webPage_param_document_type_Document' => 'Preview of the content as a media file',
+  'object_webPage_param_cached_page_type_Page' => 'Page contents in [instant view](https://instantview.telegram.org) format',
+  'object_webPageNotModified' => 'The preview of the webpage hasn\'t changed',
+  'object_authorization' => 'Logged-in session',
+  'object_authorization_param_hash_type_long' => 'Identifier',
   'object_authorization_param_device_model_type_string' => 'Device model',
   'object_authorization_param_platform_type_string' => 'Platform',
   'object_authorization_param_system_version_type_string' => 'System version',
-  'object_authorization_param_api_id_type_int' => 'Api ID',
+  'object_authorization_param_api_id_type_int' => '[API ID](https://core.telegram.org/api/obtaining_api_id)',
   'object_authorization_param_app_name_type_string' => 'App name',
   'object_authorization_param_app_version_type_string' => 'App version',
-  'object_authorization_param_date_created_type_int' => 'Date created',
-  'object_authorization_param_date_active_type_int' => 'Date active',
-  'object_authorization_param_ip_type_string' => 'Ip',
-  'object_authorization_param_country_type_string' => 'Country',
-  'object_authorization_param_region_type_string' => 'Region',
-  'object_account.authorizations' => 'Authorized clients for this account',
+  'object_authorization_param_date_created_type_int' => 'When was the session created',
+  'object_authorization_param_date_active_type_int' => 'When was the session last active',
+  'object_authorization_param_ip_type_string' => 'Last known IP',
+  'object_authorization_param_country_type_string' => 'Country determined from IP',
+  'object_authorization_param_region_type_string' => 'Region determined from IP',
+  'object_account.authorizations' => 'Logged-in sessions',
   'object_account.authorizations_param_authorizations_type_Vector t' => 'Authorizations',
   'object_account.noPassword' => 'No password',
   'object_account.noPassword_param_new_salt_type_bytes' => 'New salt',
   'object_account.noPassword_param_email_unconfirmed_pattern_type_string' => 'Email unconfirmed pattern',
-  'object_account.password' => 'Password',
+  'object_account.password' => 'Configuration for two-factor authorization',
   'object_account.password_param_current_salt_type_bytes' => 'Current salt',
   'object_account.password_param_new_salt_type_bytes' => 'New salt',
-  'object_account.password_param_hint_type_string' => 'Hint',
+  'object_account.password_param_hint_type_string' => 'Text hint for the password',
   'object_account.password_param_has_recovery_type_Bool' => 'Has recovery?',
-  'object_account.password_param_email_unconfirmed_pattern_type_string' => 'Email unconfirmed pattern',
-  'object_account.passwordSettings' => 'Password settings',
-  'object_account.passwordSettings_param_email_type_string' => 'Email',
-  'object_account.passwordInputSettings' => '2FA password settings',
+  'object_account.password_param_email_unconfirmed_pattern_type_string' => 'A [password recovery email](https://core.telegram.org/api/srp#email-verification) with the specified [pattern](https://core.telegram.org/api/pattern) is still awaiting verification',
+  'object_account.passwordSettings' => 'Private info associated to the password info (recovery email, telegram [passport](https://core.telegram.org/passport) info & so on)',
+  'object_account.passwordSettings_param_email_type_string' => '[2FA Recovery email](https://core.telegram.org/api/srp#email-verification)',
+  'object_account.passwordInputSettings' => 'Settings for setting up a new password',
   'object_account.passwordInputSettings_param_new_salt_type_bytes' => '`$new_salt = $MadelineProto->account->getPassword()[\'new_salt\'].$MadelineProto->random(8);`',
-  'object_account.passwordInputSettings_param_new_password_hash_type_bytes' => '`hash(\'sha256\', $new_salt.$new_password.$new_salt, true)`',
-  'object_account.passwordInputSettings_param_hint_type_string' => 'Hint',
-  'object_account.passwordInputSettings_param_email_type_string' => 'Email',
-  'object_auth.passwordRecovery' => 'Password recovery',
-  'object_auth.passwordRecovery_param_email_pattern_type_string' => 'Email pattern',
-  'object_receivedNotifyMessage' => 'Received notify message',
-  'object_receivedNotifyMessage_param_id_type_int' => 'ID',
-  'object_chatInviteEmpty' => 'Empty chat invite',
+  'object_account.passwordInputSettings_param_new_password_hash_type_bytes' => 'The [computed password hash](https://core.telegram.org/api/srp)',
+  'object_account.passwordInputSettings_param_hint_type_string' => 'Text hint for the password',
+  'object_account.passwordInputSettings_param_email_type_string' => 'Password recovery email',
+  'object_auth.passwordRecovery' => 'Recovery info of a [2FA password](https://core.telegram.org/api/srp), only for accounts with a [recovery email configured](https://core.telegram.org/api/srp#email-verification).',
+  'object_auth.passwordRecovery_param_email_pattern_type_string' => 'The email to which the recovery code was sent must match this [pattern](https://core.telegram.org/api/pattern).',
+  'object_receivedNotifyMessage' => 'Message ID, for which PUSH-notifications were cancelled.',
+  'object_receivedNotifyMessage_param_id_type_int' => 'Message ID, for which PUSH-notifications were canceled',
+  'object_chatInviteEmpty' => 'No info is associated to the chat invite',
   'object_chatInviteExported' => 'Exported chat invite',
-  'object_chatInviteExported_param_link_type_string' => 'Link',
-  'object_chatInviteAlready' => 'Invite of a chat of which I am already member ',
-  'object_chatInviteAlready_param_chat_type_Chat' => 'Chat',
-  'object_chatInvite' => 'Chat invite',
-  'object_chatInvite_param_channel_type_true' => 'Channel?',
-  'object_chatInvite_param_broadcast_type_true' => 'Broadcast?',
-  'object_chatInvite_param_public_type_true' => 'Public?',
-  'object_chatInvite_param_megagroup_type_true' => 'Megagroup?',
-  'object_chatInvite_param_title_type_string' => 'Title',
+  'object_chatInviteExported_param_link_type_string' => 'Chat invitation link',
+  'object_chatInviteAlready' => 'The user has already joined this chat',
+  'object_chatInviteAlready_param_chat_type_Chat' => 'The chat connected to the invite',
+  'object_chatInvite' => 'Chat invite info',
+  'object_chatInvite_param_channel_type_true' => 'Whether this is a [channel/supergroup](https://core.telegram.org/api/channel) or a [normal group](https://core.telegram.org/api/channel)',
+  'object_chatInvite_param_broadcast_type_true' => 'Whether this is a [channel](https://core.telegram.org/api/channel)',
+  'object_chatInvite_param_public_type_true' => 'Whether this is a public [channel/supergroup](https://core.telegram.org/api/channel)',
+  'object_chatInvite_param_megagroup_type_true' => 'Whether this is a [supergroup](https://core.telegram.org/api/channel)',
+  'object_chatInvite_param_title_type_string' => 'Chat/supergroup/channel title',
   'object_chatInvite_param_photo_type_ChatPhoto' => 'Photo',
-  'object_chatInvite_param_participants_count_type_int' => 'Participants count',
+  'object_chatInvite_param_participants_count_type_int' => 'Participant count',
   'object_chatInvite_param_participants_type_Vector t' => 'Participants',
-  'object_inputStickerSetEmpty' => 'Empty input sticker set',
-  'object_inputStickerSetID' => 'Sticker set ID',
+  'object_inputStickerSetEmpty' => 'Empty constructor',
+  'object_inputStickerSetID' => 'Stickerset by ID',
   'object_inputStickerSetID_param_id_type_long' => 'ID',
   'object_inputStickerSetID_param_access_hash_type_long' => 'Access hash',
-  'object_inputStickerSetShortName' => 'Sticker set short name',
-  'object_inputStickerSetShortName_param_short_name_type_string' => 'Short name',
-  'object_stickerSet' => 'Sticker set',
+  'object_inputStickerSetShortName' => 'Stickerset by short name, from `tg://addstickers?set=short_name`',
+  'object_inputStickerSetShortName_param_short_name_type_string' => 'From `tg://addstickers?set=short_name`',
+  'object_stickerSet' => 'Represents a stickerset (stickerpack)',
   'object_stickerSet_param_installed_type_true' => 'Installed?',
-  'object_stickerSet_param_archived_type_true' => 'Archived?',
-  'object_stickerSet_param_official_type_true' => 'Official?',
-  'object_stickerSet_param_masks_type_true' => 'Masks?',
-  'object_stickerSet_param_id_type_long' => 'ID',
-  'object_stickerSet_param_access_hash_type_long' => 'Access hash',
-  'object_stickerSet_param_title_type_string' => 'Title',
-  'object_stickerSet_param_short_name_type_string' => 'Short name',
-  'object_stickerSet_param_count_type_int' => 'Count',
+  'object_stickerSet_param_archived_type_true' => 'Whether this stickerset was archived (due to too many saved stickers in the current account)',
+  'object_stickerSet_param_official_type_true' => 'Is this stickerset official',
+  'object_stickerSet_param_masks_type_true' => 'Is this a mask stickerset',
+  'object_stickerSet_param_id_type_long' => 'ID of the stickerset',
+  'object_stickerSet_param_access_hash_type_long' => 'Access hash of stickerset',
+  'object_stickerSet_param_title_type_string' => 'Title of stickerset',
+  'object_stickerSet_param_short_name_type_string' => 'Short name of stickerset to use in `tg://addstickers?set=short_name`',
+  'object_stickerSet_param_count_type_int' => 'Number of stickers in pack',
   'object_stickerSet_param_hash_type_int' => 'Hash',
-  'object_messages.stickerSet' => 'Sticker set',
-  'object_messages.stickerSet_param_set_type_StickerSet' => 'Set',
+  'object_messages.stickerSet' => 'Stickerset and stickers inside it',
+  'object_messages.stickerSet_param_set_type_StickerSet' => 'The stickerset',
   'object_messages.stickerSet_param_packs_type_Vector t' => 'Packs',
   'object_messages.stickerSet_param_documents_type_Vector t' => 'Documents',
-  'object_botInfo' => 'Bot info',
-  'object_botInfo_param_user_id_type_int' => 'User ID',
-  'object_botInfo_param_description_type_string' => 'Description',
+  'object_botInfo' => 'Info about bots (available bot commands, etc)',
+  'object_botInfo_param_user_id_type_int' => 'ID of the bot',
+  'object_botInfo_param_description_type_string' => 'Description of the bot',
   'object_botInfo_param_commands_type_Vector t' => 'Commands',
-  'object_keyboardButton' => 'Keyboard button',
-  'object_keyboardButton_param_text_type_string' => 'Text',
-  'object_keyboardButtonUrl' => 'Keyboard button URL',
-  'object_keyboardButtonUrl_param_text_type_string' => 'Text',
+  'object_keyboardButton' => 'Bot keyboard button',
+  'object_keyboardButton_param_text_type_string' => 'Button text',
+  'object_keyboardButtonUrl' => 'URL button',
+  'object_keyboardButtonUrl_param_text_type_string' => 'Button label',
   'object_keyboardButtonUrl_param_url_type_string' => 'URL',
-  'object_keyboardButtonCallback' => 'Keyboard button callback',
-  'object_keyboardButtonCallback_param_text_type_string' => 'Text',
-  'object_keyboardButtonCallback_param_data_type_bytes' => 'Data',
-  'object_keyboardButtonRequestPhone' => 'Keyboard button request phone',
-  'object_keyboardButtonRequestPhone_param_text_type_string' => 'Text',
-  'object_keyboardButtonRequestGeoLocation' => 'Keyboard button request geo location',
-  'object_keyboardButtonRequestGeoLocation_param_text_type_string' => 'Text',
-  'object_keyboardButtonSwitchInline' => 'Keyboard button switch inline',
-  'object_keyboardButtonSwitchInline_param_same_peer_type_true' => 'Same peer?',
-  'object_keyboardButtonSwitchInline_param_text_type_string' => 'Text',
-  'object_keyboardButtonSwitchInline_param_query_type_string' => 'Query',
-  'object_keyboardButtonGame' => 'Keyboard button game',
-  'object_keyboardButtonGame_param_text_type_string' => 'Text',
-  'object_keyboardButtonBuy' => 'Keyboard button buy',
-  'object_keyboardButtonBuy_param_text_type_string' => 'Text',
-  'object_keyboardButtonRow' => 'Keyboard button row',
+  'object_keyboardButtonCallback' => 'Callback button',
+  'object_keyboardButtonCallback_param_text_type_string' => 'Button text',
+  'object_keyboardButtonCallback_param_data_type_bytes' => 'Callback data',
+  'object_keyboardButtonRequestPhone' => 'Button to request a user\'s phone number',
+  'object_keyboardButtonRequestPhone_param_text_type_string' => 'Button text',
+  'object_keyboardButtonRequestGeoLocation' => 'Button to request a user\'s geolocation',
+  'object_keyboardButtonRequestGeoLocation_param_text_type_string' => 'Button text',
+  'object_keyboardButtonSwitchInline' => 'Button to force a user to switch to inline mode Pressing the button will prompt the user to select one of their chats, open that chat and insert the bot‘s username and the specified inline query in the input field.',
+  'object_keyboardButtonSwitchInline_param_same_peer_type_true' => 'If set, pressing the button will insert the bot‘s username and the specified inline `query` in the current chat\'s input field.',
+  'object_keyboardButtonSwitchInline_param_text_type_string' => 'Button label',
+  'object_keyboardButtonSwitchInline_param_query_type_string' => 'The inline query to use',
+  'object_keyboardButtonGame' => 'Button to start a game',
+  'object_keyboardButtonGame_param_text_type_string' => 'Button text',
+  'object_keyboardButtonBuy' => 'Button to buy a product',
+  'object_keyboardButtonBuy_param_text_type_string' => 'Button text',
+  'object_keyboardButtonRow' => 'Inline keyboard row',
   'object_keyboardButtonRow_param_buttons_type_Vector t' => 'Buttons',
-  'object_replyKeyboardHide' => 'Reply keyboard hide',
-  'object_replyKeyboardHide_param_selective_type_true' => 'Selective?',
-  'object_replyKeyboardForceReply' => 'Reply keyboard force reply',
-  'object_replyKeyboardForceReply_param_single_use_type_true' => 'Single use?',
-  'object_replyKeyboardForceReply_param_selective_type_true' => 'Selective?',
-  'object_replyKeyboardMarkup' => 'Reply keyboard markup',
-  'object_replyKeyboardMarkup_param_resize_type_true' => 'Resize?',
-  'object_replyKeyboardMarkup_param_single_use_type_true' => 'Single use?',
-  'object_replyKeyboardMarkup_param_selective_type_true' => 'Selective?',
+  'object_replyKeyboardHide' => 'Hide sent bot keyboard',
+  'object_replyKeyboardHide_param_selective_type_true' => 'Use this flag if you want to remove the keyboard for specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot\'s message is a reply (has reply\\_to\\_message\\_id), sender of the original message.

Example: A user votes in a poll, bot returns confirmation message in reply to the vote and removes the keyboard for that user, while still showing the keyboard with poll options to users who haven\'t voted yet',
+  'object_replyKeyboardForceReply' => 'Force the user to send a reply',
+  'object_replyKeyboardForceReply_param_single_use_type_true' => 'Requests clients to hide the keyboard as soon as it\'s been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat – the user can press a special button in the input field to see the custom keyboard again.',
+  'object_replyKeyboardForceReply_param_selective_type_true' => 'Use this parameter if you want to show the keyboard to specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot\'s message is a reply (has reply\\_to\\_message\\_id), sender of the original message. 
Example: A user requests to change the bot‘s language, bot replies to the request with a keyboard to select the new language. Other users in the group don’t see the keyboard.',
+  'object_replyKeyboardMarkup' => 'Bot keyboard',
+  'object_replyKeyboardMarkup_param_resize_type_true' => 'Requests clients to resize the keyboard vertically for optimal fit (e.g., make the keyboard smaller if there are just two rows of buttons). If not set, the custom keyboard is always of the same height as the app\'s standard keyboard.',
+  'object_replyKeyboardMarkup_param_single_use_type_true' => 'Requests clients to hide the keyboard as soon as it\'s been used. The keyboard will still be available, but clients will automatically display the usual letter-keyboard in the chat – the user can press a special button in the input field to see the custom keyboard again.',
+  'object_replyKeyboardMarkup_param_selective_type_true' => 'Use this parameter if you want to show the keyboard to specific users only. Targets: 1) users that are @mentioned in the text of the Message object; 2) if the bot\'s message is a reply (has reply\\_to\\_message\\_id), sender of the original message.

Example: A user requests to change the bot‘s language, bot replies to the request with a keyboard to select the new language. Other users in the group don’t see the keyboard.',
   'object_replyKeyboardMarkup_param_rows_type_Vector t' => 'Rows',
-  'object_replyInlineMarkup' => 'Reply inline markup',
+  'object_replyInlineMarkup' => 'Bot or inline keyboard',
   'object_replyInlineMarkup_param_rows_type_Vector t' => 'Rows',
-  'object_messageEntityUnknown' => 'Message entity unknown',
-  'object_messageEntityUnknown_param_offset_type_int' => 'Offset',
-  'object_messageEntityUnknown_param_length_type_int' => 'Length',
-  'object_messageEntityMention' => 'Message entity mention',
-  'object_messageEntityMention_param_offset_type_int' => 'Offset',
-  'object_messageEntityMention_param_length_type_int' => 'Length',
-  'object_messageEntityHashtag' => 'Message entity hashtag',
-  'object_messageEntityHashtag_param_offset_type_int' => 'Offset',
-  'object_messageEntityHashtag_param_length_type_int' => 'Length',
-  'object_messageEntityBotCommand' => 'Message entity bot command',
-  'object_messageEntityBotCommand_param_offset_type_int' => 'Offset',
-  'object_messageEntityBotCommand_param_length_type_int' => 'Length',
-  'object_messageEntityUrl' => 'Message entity URL',
-  'object_messageEntityUrl_param_offset_type_int' => 'Offset',
-  'object_messageEntityUrl_param_length_type_int' => 'Length',
-  'object_messageEntityEmail' => 'Message entity email',
-  'object_messageEntityEmail_param_offset_type_int' => 'Offset',
-  'object_messageEntityEmail_param_length_type_int' => 'Length',
-  'object_messageEntityBold' => 'Message entity bold',
-  'object_messageEntityBold_param_offset_type_int' => 'Offset',
-  'object_messageEntityBold_param_length_type_int' => 'Length',
-  'object_messageEntityItalic' => 'Message entity italic',
-  'object_messageEntityItalic_param_offset_type_int' => 'Offset',
-  'object_messageEntityItalic_param_length_type_int' => 'Length',
-  'object_messageEntityCode' => 'Message entity code',
-  'object_messageEntityCode_param_offset_type_int' => 'Offset',
-  'object_messageEntityCode_param_length_type_int' => 'Length',
-  'object_messageEntityPre' => 'Message entity pre',
-  'object_messageEntityPre_param_offset_type_int' => 'Offset',
-  'object_messageEntityPre_param_length_type_int' => 'Length',
-  'object_messageEntityPre_param_language_type_string' => 'Language',
-  'object_messageEntityTextUrl' => 'Message entity text URL',
-  'object_messageEntityTextUrl_param_offset_type_int' => 'Offset',
-  'object_messageEntityTextUrl_param_length_type_int' => 'Length',
-  'object_messageEntityTextUrl_param_url_type_string' => 'URL',
-  'object_messageEntityMentionName' => 'Message entity mention name',
-  'object_messageEntityMentionName_param_offset_type_int' => 'Offset',
-  'object_messageEntityMentionName_param_length_type_int' => 'Length',
-  'object_messageEntityMentionName_param_user_id_type_int' => 'User ID',
-  'object_inputMessageEntityMentionName' => 'Message entity mention name',
-  'object_inputMessageEntityMentionName_param_offset_type_int' => 'Offset',
-  'object_inputMessageEntityMentionName_param_length_type_int' => 'Length',
-  'object_inputMessageEntityMentionName_param_user_id_type_InputUser' => 'User ID',
-  'object_inputChannelEmpty' => 'Empty input channel',
-  'object_inputChannel' => 'Channel',
+  'object_messageEntityUnknown' => 'Unknown message entity',
+  'object_messageEntityUnknown_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityUnknown_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityMention' => 'Message entity mentioning the current user',
+  'object_messageEntityMention_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityMention_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityHashtag' => '**\\#hashtag** message entity',
+  'object_messageEntityHashtag_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityHashtag_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityBotCommand' => 'Message entity representing a bot /command',
+  'object_messageEntityBotCommand_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityBotCommand_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityUrl' => 'Message entity representing an in-text url: ; for [text urls](https://google.com), use [messageEntityTextUrl](../constructors/messageEntityTextUrl.md).',
+  'object_messageEntityUrl_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityUrl_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityEmail' => 'Message entity representing an .',
+  'object_messageEntityEmail_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityEmail_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityBold' => 'Message entity representing **bold text**.',
+  'object_messageEntityBold_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityBold_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityItalic' => 'Message entity representing *italic text*.',
+  'object_messageEntityItalic_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityItalic_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityCode' => 'Message entity representing a `codeblock`.',
+  'object_messageEntityCode_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityCode_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityPre' => 'Message entity representing a preformatted `codeblock`, allowing the user to specify a programming language for the codeblock.',
+  'object_messageEntityPre_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityPre_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityPre_param_language_type_string' => 'Programming language of the code',
+  'object_messageEntityTextUrl' => 'Message entity representing a [text url](https://google.com): for in-text urls like  use [messageEntityUrl](../constructors/messageEntityUrl.md).',
+  'object_messageEntityTextUrl_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityTextUrl_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityTextUrl_param_url_type_string' => 'The actual URL',
+  'object_messageEntityMentionName' => 'Message entity representing a [user mention](https://t.me/test): for *creating* a mention use [inputMessageEntityMentionName](../constructors/inputMessageEntityMentionName.md).',
+  'object_messageEntityMentionName_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityMentionName_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityMentionName_param_user_id_type_int' => 'Identifier of the user that was mentioned',
+  'object_inputMessageEntityMentionName' => 'Message entity that can be used to create a user [user mention](https://t.me/test): received mentions use the [messageEntityMentionName](../constructors/messageEntityMentionName.md) constructor, instead.',
+  'object_inputMessageEntityMentionName_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_inputMessageEntityMentionName_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_inputMessageEntityMentionName_param_user_id_type_InputUser' => 'Identifier of the user that was mentioned',
+  'object_inputChannelEmpty' => 'Represents the absence of a channel',
+  'object_inputChannel' => 'Represents a channel',
   'object_inputChannel_param_channel_id_type_int' => 'Channel ID',
-  'object_inputChannel_param_access_hash_type_long' => 'Access hash',
+  'object_inputChannel_param_access_hash_type_long' => 'Access hash taken from the [channel](../constructors/channel.md) constructor',
   'object_contacts.resolvedPeer' => 'Resolved peer',
-  'object_contacts.resolvedPeer_param_peer_type_Peer' => 'Peer',
+  'object_contacts.resolvedPeer_param_peer_type_Peer' => 'The peer',
   'object_contacts.resolvedPeer_param_chats_type_Vector t' => 'Chats',
   'object_contacts.resolvedPeer_param_users_type_Vector t' => 'Users',
-  'object_messageRange' => 'Message range',
-  'object_messageRange_param_min_id_type_int' => 'Min ID',
-  'object_messageRange_param_max_id_type_int' => 'Max ID',
-  'object_updates.channelDifferenceEmpty' => 'Empty channel difference',
-  'object_updates.channelDifferenceEmpty_param_final_type_true' => 'Final?',
-  'object_updates.channelDifferenceEmpty_param_pts_type_int' => 'Pts',
-  'object_updates.channelDifferenceEmpty_param_timeout_type_int' => 'Timeout',
-  'object_updates.channelDifferenceTooLong' => 'Channel difference too long',
-  'object_updates.channelDifferenceTooLong_param_final_type_true' => 'Final?',
+  'object_messageRange' => 'Indicates a range of chat messages',
+  'object_messageRange_param_min_id_type_int' => 'Start of range (message ID)',
+  'object_messageRange_param_max_id_type_int' => 'End of range (message ID)',
+  'object_updates.channelDifferenceEmpty' => 'There are no new updates',
+  'object_updates.channelDifferenceEmpty_param_final_type_true' => 'Whether there are more updates that must be fetched (always false)',
+  'object_updates.channelDifferenceEmpty_param_pts_type_int' => 'The latest [PTS](https://core.telegram.org/api/updates)',
+  'object_updates.channelDifferenceEmpty_param_timeout_type_int' => 'Clients are supposed to refetch the channel difference after timeout seconds have elapsed',
+  'object_updates.channelDifferenceTooLong' => 'The provided `pts + limit < remote pts`. Simply, there are too many updates to be fetched (more than `limit`), the client has to resolve the update gap in one of the following ways:
+
+1. Delete all known messages in the chat, begin from scratch by refetching all messages manually with [getHistory](../methods/messages.getHistory.md). It is easy to implement, but suddenly disappearing messages looks awful for the user.
+2. Save all messages loaded in the memory until application restart, but delete all messages from database. Messages left in the memory must be lazily updated using calls to [getHistory](../methods/messages.getHistory.md). It looks much smoothly for the user, he will need to redownload messages only after client restart. Unsynchronized messages left in the memory shouldn\'t be saved to database, results of [getHistory](../methods/messages.getHistory.md) and [getMessages](../methods/messages.getMessages.md) must be used to update state of deleted and edited messages left in the memory.
+3. Save all messages loaded in the memory and stored in the database without saving that some messages form continuous ranges. Messages in the database will be excluded from results of getChatHistory and searchChatMessages after application restart and will be available only through getMessage. Every message should still be checked using getHistory. It has more disadvantages over 2) than advantages.
+4. Save all messages with saving all data about continuous message ranges. Messages from the database may be used as results of getChatHistory and (if implemented continuous ranges support for searching shared media) searchChatMessages. The messages should still be lazily checked using getHistory, but they are still available offline. It is the best way for gaps support, but it is pretty hard to implement correctly. It should be also noted that some messages like live location messages shouldn\'t be deleted.',
+  'object_updates.channelDifferenceTooLong_param_final_type_true' => 'Whether there are more updates that must be fetched (always false)',
   'object_updates.channelDifferenceTooLong_param_pts_type_int' => 'Pts',
-  'object_updates.channelDifferenceTooLong_param_timeout_type_int' => 'Timeout',
+  'object_updates.channelDifferenceTooLong_param_timeout_type_int' => 'Clients are supposed to refetch the channel difference after timeout seconds have elapsed',
   'object_updates.channelDifferenceTooLong_param_top_message_type_int' => 'Top message',
   'object_updates.channelDifferenceTooLong_param_read_inbox_max_id_type_int' => 'Read inbox max ID',
   'object_updates.channelDifferenceTooLong_param_read_outbox_max_id_type_int' => 'Read outbox max ID',
@@ -7848,110 +8243,110 @@ class Lang
   'object_updates.channelDifferenceTooLong_param_messages_type_Vector t' => 'Messages',
   'object_updates.channelDifferenceTooLong_param_chats_type_Vector t' => 'Chats',
   'object_updates.channelDifferenceTooLong_param_users_type_Vector t' => 'Users',
-  'object_updates.channelDifference' => 'Channel difference',
-  'object_updates.channelDifference_param_final_type_true' => 'Final?',
-  'object_updates.channelDifference_param_pts_type_int' => 'Pts',
-  'object_updates.channelDifference_param_timeout_type_int' => 'Timeout',
+  'object_updates.channelDifference' => 'The new updates',
+  'object_updates.channelDifference_param_final_type_true' => 'Whether there are more updates to be fetched using getDifference, starting from the provided `pts`',
+  'object_updates.channelDifference_param_pts_type_int' => 'The [PTS](https://core.telegram.org/api/updates) from which to start getting updates the next time',
+  'object_updates.channelDifference_param_timeout_type_int' => 'Clients are supposed to refetch the channel difference after timeout seconds have elapsed',
   'object_updates.channelDifference_param_new_messages_type_Vector t' => 'New messages',
   'object_updates.channelDifference_param_other_updates_type_Vector t' => 'Other updates',
   'object_updates.channelDifference_param_chats_type_Vector t' => 'Chats',
   'object_updates.channelDifference_param_users_type_Vector t' => 'Users',
-  'object_channelMessagesFilterEmpty' => 'Empty channel messages filter',
-  'object_channelMessagesFilter' => 'Channel messages filter',
-  'object_channelMessagesFilter_param_exclude_new_messages_type_true' => 'Exclude new messages?',
+  'object_channelMessagesFilterEmpty' => 'No filter',
+  'object_channelMessagesFilter' => 'Filter for getting only certain types of channel messages',
+  'object_channelMessagesFilter_param_exclude_new_messages_type_true' => 'Whether to exclude new messages from the search',
   'object_channelMessagesFilter_param_ranges_type_Vector t' => 'Ranges',
-  'object_channelParticipant' => 'Channel participant',
-  'object_channelParticipant_param_user_id_type_int' => 'User ID',
-  'object_channelParticipant_param_date_type_int' => 'Date',
-  'object_channelParticipantSelf' => 'Channel participant self',
+  'object_channelParticipant' => 'Channel/supergroup participant',
+  'object_channelParticipant_param_user_id_type_int' => 'Pariticipant user ID',
+  'object_channelParticipant_param_date_type_int' => 'Date joined',
+  'object_channelParticipantSelf' => 'Myself',
   'object_channelParticipantSelf_param_user_id_type_int' => 'User ID',
-  'object_channelParticipantSelf_param_inviter_id_type_int' => 'Inviter ID',
-  'object_channelParticipantSelf_param_date_type_int' => 'Date',
-  'object_channelParticipantCreator' => 'Channel participant creator',
+  'object_channelParticipantSelf_param_inviter_id_type_int' => 'User that invited me to the channel/supergroup',
+  'object_channelParticipantSelf_param_date_type_int' => 'When did I join the channel/supergroup',
+  'object_channelParticipantCreator' => 'Channel/supergroup creator',
   'object_channelParticipantCreator_param_user_id_type_int' => 'User ID',
-  'object_channelParticipantAdmin' => 'Channel participant admin',
-  'object_channelParticipantAdmin_param_can_edit_type_true' => 'Can edit?',
-  'object_channelParticipantAdmin_param_user_id_type_int' => 'User ID',
-  'object_channelParticipantAdmin_param_inviter_id_type_int' => 'Inviter ID',
-  'object_channelParticipantAdmin_param_promoted_by_type_int' => 'Promoted by',
-  'object_channelParticipantAdmin_param_date_type_int' => 'Date',
+  'object_channelParticipantAdmin' => 'Admin',
+  'object_channelParticipantAdmin_param_can_edit_type_true' => 'Can this admin promote other admins with the same permissions?',
+  'object_channelParticipantAdmin_param_user_id_type_int' => 'Admin user ID',
+  'object_channelParticipantAdmin_param_inviter_id_type_int' => 'User that invited the admin to the channel/group',
+  'object_channelParticipantAdmin_param_promoted_by_type_int' => 'User that promoted the user to admin',
+  'object_channelParticipantAdmin_param_date_type_int' => 'When did the user join',
   'object_channelParticipantAdmin_param_admin_rights_type_ChannelAdminRights' => 'Admin rights',
-  'object_channelParticipantBanned' => 'Channel participant banned',
-  'object_channelParticipantBanned_param_left_type_true' => 'Left?',
+  'object_channelParticipantBanned' => 'Banned/kicked user',
+  'object_channelParticipantBanned_param_left_type_true' => 'Whether the user has left the group',
   'object_channelParticipantBanned_param_user_id_type_int' => 'User ID',
-  'object_channelParticipantBanned_param_kicked_by_type_int' => 'Kicked by',
-  'object_channelParticipantBanned_param_date_type_int' => 'Date',
+  'object_channelParticipantBanned_param_kicked_by_type_int' => 'User was kicked by the specified admin',
+  'object_channelParticipantBanned_param_date_type_int' => 'When did the user join the group',
   'object_channelParticipantBanned_param_banned_rights_type_ChannelBannedRights' => 'Banned rights',
-  'object_channelParticipantsRecent' => 'Channel participants recent',
-  'object_channelParticipantsAdmins' => 'Channel participants admins',
-  'object_channelParticipantsKicked' => 'Channel participants kicked',
-  'object_channelParticipantsKicked_param_q_type_string' => 'Query',
-  'object_channelParticipantsBots' => 'Channel participants bots',
-  'object_channelParticipantsBanned' => 'Channel participants banned',
-  'object_channelParticipantsBanned_param_q_type_string' => 'Query',
-  'object_channelParticipantsSearch' => 'Channel participants search',
-  'object_channelParticipantsSearch_param_q_type_string' => 'Query',
-  'object_channels.channelParticipants' => 'Channel participants',
-  'object_channels.channelParticipants_param_count_type_int' => 'Count',
+  'object_channelParticipantsRecent' => 'Fetch only recent participants',
+  'object_channelParticipantsAdmins' => 'Fetch only admin participants',
+  'object_channelParticipantsKicked' => 'Fetch only kicked participants',
+  'object_channelParticipantsKicked_param_q_type_string' => 'Optional filter for searching kicked participants by name (otherwise empty)',
+  'object_channelParticipantsBots' => 'Fetch only bot participants',
+  'object_channelParticipantsBanned' => 'Fetch only banned participants',
+  'object_channelParticipantsBanned_param_q_type_string' => 'Optional filter for searching banned participants by name (otherwise empty)',
+  'object_channelParticipantsSearch' => 'Query participants by name',
+  'object_channelParticipantsSearch_param_q_type_string' => 'Search query',
+  'object_channels.channelParticipants' => 'Represents multiple channel participants',
+  'object_channels.channelParticipants_param_count_type_int' => 'Total number of participants that correspond to the given query',
   'object_channels.channelParticipants_param_participants_type_Vector t' => 'Participants',
   'object_channels.channelParticipants_param_users_type_Vector t' => 'Users',
-  'object_channels.channelParticipantsNotModified' => 'Channel participants not modified',
-  'object_channels.channelParticipant' => 'Channel participant',
-  'object_channels.channelParticipant_param_participant_type_ChannelParticipant' => 'Participant',
+  'object_channels.channelParticipantsNotModified' => 'No new participant info could be found',
+  'object_channels.channelParticipant' => 'Represents a channel participant',
+  'object_channels.channelParticipant_param_participant_type_ChannelParticipant' => 'The channel participant',
   'object_channels.channelParticipant_param_users_type_Vector t' => 'Users',
-  'object_help.termsOfService' => 'Terms of service',
-  'object_help.termsOfService_param_text_type_string' => 'Text',
-  'object_foundGif' => 'Found gif',
-  'object_foundGif_param_url_type_string' => 'URL',
+  'object_help.termsOfService' => 'Info about the latest telegram Terms Of Service',
+  'object_help.termsOfService_param_text_type_string' => 'Text of the new terms',
+  'object_foundGif' => 'Found GIF',
+  'object_foundGif_param_url_type_string' => 'GIF URL',
   'object_foundGif_param_thumb_url_type_string' => 'Thumbnail URL',
-  'object_foundGif_param_content_url_type_string' => 'Content URL',
-  'object_foundGif_param_content_type_type_string' => 'Content type',
-  'object_foundGif_param_w_type_int' => 'Width',
-  'object_foundGif_param_h_type_int' => 'Height',
-  'object_foundGifCached' => 'Found gif cached',
-  'object_foundGifCached_param_url_type_string' => 'URL',
-  'object_foundGifCached_param_photo_type_Photo' => 'Photo',
-  'object_foundGifCached_param_document_type_Document' => 'Document',
-  'object_messages.foundGifs' => 'Found gifs',
-  'object_messages.foundGifs_param_next_offset_type_int' => 'Next offset',
+  'object_foundGif_param_content_url_type_string' => 'Actual URL of the content to send',
+  'object_foundGif_param_content_type_type_string' => 'Content-type of media',
+  'object_foundGif_param_w_type_int' => 'Width of GIF',
+  'object_foundGif_param_h_type_int' => 'Height of GIF',
+  'object_foundGifCached' => 'Found cached results',
+  'object_foundGifCached_param_url_type_string' => 'GIF URL',
+  'object_foundGifCached_param_photo_type_Photo' => 'Thumbnail',
+  'object_foundGifCached_param_document_type_Document' => 'Actual GIF document to send',
+  'object_messages.foundGifs' => 'Found GIFs',
+  'object_messages.foundGifs_param_next_offset_type_int' => 'Next offset to use when trying to [load more results](../methods/messages.searchGifs.md)',
   'object_messages.foundGifs_param_results_type_Vector t' => 'Results',
-  'object_messages.savedGifsNotModified' => 'Saved gifs not modified',
+  'object_messages.savedGifsNotModified' => 'No new saved gifs were found',
   'object_messages.savedGifs' => 'Saved gifs',
-  'object_messages.savedGifs_param_hash_type_int' => 'Hash',
+  'object_messages.savedGifs_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
   'object_messages.savedGifs_param_gifs_type_Vector t' => 'Gifs',
-  'object_inputBotInlineMessageMediaAuto' => 'Bot inline message media auto',
-  'object_inputBotInlineMessageMediaAuto_param_message_type_string' => 'Message',
+  'object_inputBotInlineMessageMediaAuto' => 'A media',
+  'object_inputBotInlineMessageMediaAuto_param_message_type_string' => 'Caption',
   'object_inputBotInlineMessageMediaAuto_param_entities_type_Vector t' => 'Entities',
-  'object_inputBotInlineMessageMediaAuto_param_reply_markup_type_ReplyMarkup' => 'Reply markup',
-  'object_inputBotInlineMessageText' => 'Bot inline message text',
-  'object_inputBotInlineMessageText_param_no_webpage_type_true' => 'No webpage?',
+  'object_inputBotInlineMessageMediaAuto_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard',
+  'object_inputBotInlineMessageText' => 'Simple text message',
+  'object_inputBotInlineMessageText_param_no_webpage_type_true' => 'Disable webpage preview',
   'object_inputBotInlineMessageText_param_message_type_string' => 'Message',
   'object_inputBotInlineMessageText_param_entities_type_Vector t' => 'Entities',
-  'object_inputBotInlineMessageText_param_reply_markup_type_ReplyMarkup' => 'Reply markup',
-  'object_inputBotInlineMessageMediaGeo' => 'Bot inline message media geo',
-  'object_inputBotInlineMessageMediaGeo_param_geo_point_type_InputGeoPoint' => 'Geo point',
-  'object_inputBotInlineMessageMediaGeo_param_period_type_int' => 'Period',
-  'object_inputBotInlineMessageMediaGeo_param_reply_markup_type_ReplyMarkup' => 'Reply markup',
-  'object_inputBotInlineMessageMediaVenue' => 'Bot inline message media venue',
-  'object_inputBotInlineMessageMediaVenue_param_geo_point_type_InputGeoPoint' => 'Geo point',
-  'object_inputBotInlineMessageMediaVenue_param_title_type_string' => 'Title',
+  'object_inputBotInlineMessageText_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard',
+  'object_inputBotInlineMessageMediaGeo' => 'Geolocation',
+  'object_inputBotInlineMessageMediaGeo_param_geo_point_type_InputGeoPoint' => 'Geolocation',
+  'object_inputBotInlineMessageMediaGeo_param_period_type_int' => 'Validity period',
+  'object_inputBotInlineMessageMediaGeo_param_reply_markup_type_ReplyMarkup' => 'Reply markup for bot/inline keyboards',
+  'object_inputBotInlineMessageMediaVenue' => 'Venue',
+  'object_inputBotInlineMessageMediaVenue_param_geo_point_type_InputGeoPoint' => 'Geolocation',
+  'object_inputBotInlineMessageMediaVenue_param_title_type_string' => 'Venue name',
   'object_inputBotInlineMessageMediaVenue_param_address_type_string' => 'Address',
-  'object_inputBotInlineMessageMediaVenue_param_provider_type_string' => 'Provider',
-  'object_inputBotInlineMessageMediaVenue_param_venue_id_type_string' => 'Venue ID',
-  'object_inputBotInlineMessageMediaVenue_param_reply_markup_type_ReplyMarkup' => 'Reply markup',
-  'object_inputBotInlineMessageMediaContact' => 'Bot inline message media contact',
+  'object_inputBotInlineMessageMediaVenue_param_provider_type_string' => 'Venue provider: currently only "foursquare" needs to be supported',
+  'object_inputBotInlineMessageMediaVenue_param_venue_id_type_string' => 'Venue ID in the provider\'s database',
+  'object_inputBotInlineMessageMediaVenue_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard',
+  'object_inputBotInlineMessageMediaContact' => 'A contact',
   'object_inputBotInlineMessageMediaContact_param_phone_number_type_string' => 'Phone number',
   'object_inputBotInlineMessageMediaContact_param_first_name_type_string' => 'First name',
   'object_inputBotInlineMessageMediaContact_param_last_name_type_string' => 'Last name',
-  'object_inputBotInlineMessageMediaContact_param_reply_markup_type_ReplyMarkup' => 'Reply markup',
-  'object_inputBotInlineMessageGame' => 'Bot inline message game',
-  'object_inputBotInlineMessageGame_param_reply_markup_type_ReplyMarkup' => 'Reply markup',
-  'object_inputBotInlineResult' => 'Bot inline result',
-  'object_inputBotInlineResult_param_id_type_string' => 'ID',
-  'object_inputBotInlineResult_param_type_type_string' => 'Type',
-  'object_inputBotInlineResult_param_title_type_string' => 'Title',
-  'object_inputBotInlineResult_param_description_type_string' => 'Description',
-  'object_inputBotInlineResult_param_url_type_string' => 'URL',
+  'object_inputBotInlineMessageMediaContact_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard',
+  'object_inputBotInlineMessageGame' => 'A game',
+  'object_inputBotInlineMessageGame_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard',
+  'object_inputBotInlineResult' => 'An inline bot result',
+  'object_inputBotInlineResult_param_id_type_string' => 'ID of result',
+  'object_inputBotInlineResult_param_type_type_string' => 'Result type (see [bot API docs](https://core.telegram.org/bots/api#inlinequeryresult))',
+  'object_inputBotInlineResult_param_title_type_string' => 'Result title',
+  'object_inputBotInlineResult_param_description_type_string' => 'Result description',
+  'object_inputBotInlineResult_param_url_type_string' => 'URL of result',
   'object_inputBotInlineResult_param_thumb_url_type_string' => 'Thumbnail URL',
   'object_inputBotInlineResult_param_content_url_type_string' => 'Content URL',
   'object_inputBotInlineResult_param_content_type_type_string' => 'Content type',
@@ -7959,53 +8354,53 @@ class Lang
   'object_inputBotInlineResult_param_h_type_int' => 'Height',
   'object_inputBotInlineResult_param_duration_type_int' => 'Duration',
   'object_inputBotInlineResult_param_sendMessage_type_InputBotInlineMessage' => 'Message to send',
-  'object_inputBotInlineResultPhoto' => 'Bot inline result photo',
-  'object_inputBotInlineResultPhoto_param_id_type_string' => 'ID',
-  'object_inputBotInlineResultPhoto_param_type_type_string' => 'Type',
-  'object_inputBotInlineResultPhoto_param_photo_type_InputPhoto' => 'Photo',
+  'object_inputBotInlineResultPhoto' => 'Photo',
+  'object_inputBotInlineResultPhoto_param_id_type_string' => 'Result ID',
+  'object_inputBotInlineResultPhoto_param_type_type_string' => 'Result type (see [bot API docs](https://core.telegram.org/bots/api#inlinequeryresult))',
+  'object_inputBotInlineResultPhoto_param_photo_type_InputPhoto' => 'Photo to send',
   'object_inputBotInlineResultPhoto_param_sendMessage_type_InputBotInlineMessage' => 'Message to send',
-  'object_inputBotInlineResultDocument' => 'Bot inline result document',
-  'object_inputBotInlineResultDocument_param_id_type_string' => 'ID',
-  'object_inputBotInlineResultDocument_param_type_type_string' => 'Type',
-  'object_inputBotInlineResultDocument_param_title_type_string' => 'Title',
-  'object_inputBotInlineResultDocument_param_description_type_string' => 'Description',
-  'object_inputBotInlineResultDocument_param_document_type_InputDocument' => 'Document',
+  'object_inputBotInlineResultDocument' => 'Document (media of any type except for photos)',
+  'object_inputBotInlineResultDocument_param_id_type_string' => 'Result ID',
+  'object_inputBotInlineResultDocument_param_type_type_string' => 'Result type (see [bot API docs](https://core.telegram.org/bots/api#inlinequeryresult))',
+  'object_inputBotInlineResultDocument_param_title_type_string' => 'Result title',
+  'object_inputBotInlineResultDocument_param_description_type_string' => 'Result description',
+  'object_inputBotInlineResultDocument_param_document_type_InputDocument' => 'Document to send',
   'object_inputBotInlineResultDocument_param_sendMessage_type_InputBotInlineMessage' => 'Message to send',
-  'object_inputBotInlineResultGame' => 'Bot inline result game',
-  'object_inputBotInlineResultGame_param_id_type_string' => 'ID',
-  'object_inputBotInlineResultGame_param_short_name_type_string' => 'Short name',
+  'object_inputBotInlineResultGame' => 'Game',
+  'object_inputBotInlineResultGame_param_id_type_string' => 'Result ID',
+  'object_inputBotInlineResultGame_param_short_name_type_string' => 'Game short name',
   'object_inputBotInlineResultGame_param_sendMessage_type_InputBotInlineMessage' => 'Message to send',
-  'object_botInlineMessageMediaAuto' => 'Bot inline message media auto',
-  'object_botInlineMessageMediaAuto_param_message_type_string' => 'Message',
+  'object_botInlineMessageMediaAuto' => 'Send whatever media is attached to the [botInlineMediaResult](../constructors/botInlineMediaResult.md)',
+  'object_botInlineMessageMediaAuto_param_message_type_string' => 'Caption',
   'object_botInlineMessageMediaAuto_param_entities_type_Vector t' => 'Entities',
-  'object_botInlineMessageMediaAuto_param_reply_markup_type_ReplyMarkup' => 'Reply markup',
-  'object_botInlineMessageText' => 'Bot inline message text',
-  'object_botInlineMessageText_param_no_webpage_type_true' => 'No webpage?',
-  'object_botInlineMessageText_param_message_type_string' => 'Message',
+  'object_botInlineMessageMediaAuto_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard',
+  'object_botInlineMessageText' => 'Send a simple text message',
+  'object_botInlineMessageText_param_no_webpage_type_true' => 'Disable webpage preview',
+  'object_botInlineMessageText_param_message_type_string' => 'The message',
   'object_botInlineMessageText_param_entities_type_Vector t' => 'Entities',
-  'object_botInlineMessageText_param_reply_markup_type_ReplyMarkup' => 'Reply markup',
-  'object_botInlineMessageMediaGeo' => 'Bot inline message media geo',
-  'object_botInlineMessageMediaGeo_param_geo_type_GeoPoint' => 'Geo',
-  'object_botInlineMessageMediaGeo_param_period_type_int' => 'Period',
-  'object_botInlineMessageMediaGeo_param_reply_markup_type_ReplyMarkup' => 'Reply markup',
-  'object_botInlineMessageMediaVenue' => 'Bot inline message media venue',
-  'object_botInlineMessageMediaVenue_param_geo_type_GeoPoint' => 'Geo',
-  'object_botInlineMessageMediaVenue_param_title_type_string' => 'Title',
+  'object_botInlineMessageText_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard',
+  'object_botInlineMessageMediaGeo' => 'Send a geolocation',
+  'object_botInlineMessageMediaGeo_param_geo_type_GeoPoint' => 'Geolocation',
+  'object_botInlineMessageMediaGeo_param_period_type_int' => 'Validity period',
+  'object_botInlineMessageMediaGeo_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard',
+  'object_botInlineMessageMediaVenue' => 'Send a venue',
+  'object_botInlineMessageMediaVenue_param_geo_type_GeoPoint' => 'Geolocation of venue',
+  'object_botInlineMessageMediaVenue_param_title_type_string' => 'Venue name',
   'object_botInlineMessageMediaVenue_param_address_type_string' => 'Address',
-  'object_botInlineMessageMediaVenue_param_provider_type_string' => 'Provider',
-  'object_botInlineMessageMediaVenue_param_venue_id_type_string' => 'Venue ID',
-  'object_botInlineMessageMediaVenue_param_reply_markup_type_ReplyMarkup' => 'Reply markup',
-  'object_botInlineMessageMediaContact' => 'Bot inline message media contact',
+  'object_botInlineMessageMediaVenue_param_provider_type_string' => 'Venue provider: currently only "foursquare" needs to be supported',
+  'object_botInlineMessageMediaVenue_param_venue_id_type_string' => 'Venue ID in the provider\'s database',
+  'object_botInlineMessageMediaVenue_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard',
+  'object_botInlineMessageMediaContact' => 'Send a contact',
   'object_botInlineMessageMediaContact_param_phone_number_type_string' => 'Phone number',
   'object_botInlineMessageMediaContact_param_first_name_type_string' => 'First name',
   'object_botInlineMessageMediaContact_param_last_name_type_string' => 'Last name',
-  'object_botInlineMessageMediaContact_param_reply_markup_type_ReplyMarkup' => 'Reply markup',
-  'object_botInlineResult' => 'Bot inline result',
-  'object_botInlineResult_param_id_type_string' => 'ID',
-  'object_botInlineResult_param_type_type_string' => 'Type',
-  'object_botInlineResult_param_title_type_string' => 'Title',
-  'object_botInlineResult_param_description_type_string' => 'Description',
-  'object_botInlineResult_param_url_type_string' => 'URL',
+  'object_botInlineMessageMediaContact_param_reply_markup_type_ReplyMarkup' => 'Inline keyboard',
+  'object_botInlineResult' => 'Generic result',
+  'object_botInlineResult_param_id_type_string' => 'Result ID',
+  'object_botInlineResult_param_type_type_string' => 'Result type (see [bot API docs](https://core.telegram.org/bots/api#inlinequeryresult))',
+  'object_botInlineResult_param_title_type_string' => 'Result title',
+  'object_botInlineResult_param_description_type_string' => 'Result description',
+  'object_botInlineResult_param_url_type_string' => 'URL of article or webpage',
   'object_botInlineResult_param_thumb_url_type_string' => 'Thumbnail URL',
   'object_botInlineResult_param_content_url_type_string' => 'Content URL',
   'object_botInlineResult_param_content_type_type_string' => 'Content type',
@@ -8013,222 +8408,229 @@ class Lang
   'object_botInlineResult_param_h_type_int' => 'Height',
   'object_botInlineResult_param_duration_type_int' => 'Duration',
   'object_botInlineResult_param_sendMessage_type_BotInlineMessage' => 'Message to send',
-  'object_botInlineMediaResult' => 'Bot inline media result',
-  'object_botInlineMediaResult_param_id_type_string' => 'ID',
-  'object_botInlineMediaResult_param_type_type_string' => 'Type',
-  'object_botInlineMediaResult_param_photo_type_Photo' => 'Photo',
-  'object_botInlineMediaResult_param_document_type_Document' => 'Document',
-  'object_botInlineMediaResult_param_title_type_string' => 'Title',
+  'object_botInlineMediaResult' => 'Media result',
+  'object_botInlineMediaResult_param_id_type_string' => 'Result ID',
+  'object_botInlineMediaResult_param_type_type_string' => 'Result type (see [bot API docs](https://core.telegram.org/bots/api#inlinequeryresult))',
+  'object_botInlineMediaResult_param_photo_type_Photo' => 'If type is `photo`, the photo to send',
+  'object_botInlineMediaResult_param_document_type_Document' => 'If type is `document`, the document to send',
+  'object_botInlineMediaResult_param_title_type_string' => 'Result title',
   'object_botInlineMediaResult_param_description_type_string' => 'Description',
   'object_botInlineMediaResult_param_sendMessage_type_BotInlineMessage' => 'Send message',
-  'object_messages.botResults' => 'Bot results',
-  'object_messages.botResults_param_gallery_type_true' => 'Gallery?',
+  'object_messages.botResults' => 'Result of a query to an inline bot',
+  'object_messages.botResults_param_gallery_type_true' => 'Whether the result is a picture gallery',
   'object_messages.botResults_param_query_id_type_long' => 'Query ID',
-  'object_messages.botResults_param_next_offset_type_string' => 'Next offset',
-  'object_messages.botResults_param_switch_pm_type_InlineBotSwitchPM' => 'Switch pm',
+  'object_messages.botResults_param_next_offset_type_string' => 'The next offset to use when navigating through results',
+  'object_messages.botResults_param_switch_pm_type_InlineBotSwitchPM' => 'Whether the bot requested the user to message him in private',
   'object_messages.botResults_param_results_type_Vector t' => 'Results',
-  'object_messages.botResults_param_cache_time_type_int' => 'Cache time',
+  'object_messages.botResults_param_cache_time_type_int' => 'Caching validity of the results',
   'object_messages.botResults_param_users_type_Vector t' => 'Users',
-  'object_exportedMessageLink' => 'Exported message link',
-  'object_exportedMessageLink_param_link_type_string' => 'Link',
-  'object_exportedMessageLink_param_html_type_string' => 'Html',
-  'object_messageFwdHeader' => 'Forwarded message info',
-  'object_messageFwdHeader_param_from_id_type_int' => 'From ID',
-  'object_messageFwdHeader_param_date_type_int' => 'Date',
-  'object_messageFwdHeader_param_channel_id_type_int' => 'Channel ID',
-  'object_messageFwdHeader_param_channel_post_type_int' => 'Channel post',
-  'object_messageFwdHeader_param_post_author_type_string' => 'Post author',
-  'object_messageFwdHeader_param_saved_from_peer_type_Peer' => 'Saved from peer',
-  'object_messageFwdHeader_param_saved_from_msg_id_type_int' => 'Saved from msg ID',
-  'object_auth.codeTypeSms' => 'Auth code type: SMS',
-  'object_auth.codeTypeCall' => 'Auth code type: call',
-  'object_auth.codeTypeFlashCall' => 'Auth code type: flash call',
-  'object_auth.sentCodeTypeApp' => 'Sent code type app',
-  'object_auth.sentCodeTypeApp_param_length_type_int' => 'Length',
-  'object_auth.sentCodeTypeSms' => 'Sent code type sms',
-  'object_auth.sentCodeTypeSms_param_length_type_int' => 'Length',
-  'object_auth.sentCodeTypeCall' => 'Sent code type call',
-  'object_auth.sentCodeTypeCall_param_length_type_int' => 'Length',
-  'object_auth.sentCodeTypeFlashCall' => 'Sent code type flash call',
-  'object_auth.sentCodeTypeFlashCall_param_pattern_type_string' => 'Pattern',
-  'object_messages.botCallbackAnswer' => 'Bot callback answer',
-  'object_messages.botCallbackAnswer_param_alert_type_true' => 'Alert?',
-  'object_messages.botCallbackAnswer_param_has_url_type_true' => 'Has URL?',
-  'object_messages.botCallbackAnswer_param_native_ui_type_true' => 'Native ui?',
-  'object_messages.botCallbackAnswer_param_message_type_string' => 'Message',
-  'object_messages.botCallbackAnswer_param_url_type_string' => 'URL',
-  'object_messages.botCallbackAnswer_param_cache_time_type_int' => 'Cache time',
-  'object_messages.messageEditData' => 'Message edit data',
-  'object_messages.messageEditData_param_caption_type_true' => 'Caption?',
-  'object_inputBotInlineMessageID' => 'Bot inline message ID',
-  'object_inputBotInlineMessageID_param_dc_id_type_int' => 'DC ID',
-  'object_inputBotInlineMessageID_param_id_type_long' => 'ID',
-  'object_inputBotInlineMessageID_param_access_hash_type_long' => 'Access hash',
-  'object_inlineBotSwitchPM' => 'Inline bot switch pm',
-  'object_inlineBotSwitchPM_param_text_type_string' => 'Text',
-  'object_inlineBotSwitchPM_param_start_param_type_string' => 'Start param',
-  'object_messages.peerDialogs' => 'Peer dialogs',
+  'object_exportedMessageLink' => 'Link to a message in a supergroup/channel',
+  'object_exportedMessageLink_param_link_type_string' => 'URL',
+  'object_exportedMessageLink_param_html_type_string' => 'Embed code',
+  'object_messageFwdHeader' => 'Info about a forwarded message',
+  'object_messageFwdHeader_param_from_id_type_int' => 'The ID of the user that originally sent the message',
+  'object_messageFwdHeader_param_date_type_int' => 'When was the message originally sent',
+  'object_messageFwdHeader_param_channel_id_type_int' => 'ID of the channel from which the message was forwarded',
+  'object_messageFwdHeader_param_channel_post_type_int' => 'ID of the channel message that was forwarded',
+  'object_messageFwdHeader_param_post_author_type_string' => 'For channels and if signatures are enabled, author of the channel message',
+  'object_messageFwdHeader_param_saved_from_peer_type_Peer' => 'Only for messages forwarded to the current user (inputPeerSelf), full info about the user/channel that originally sent the message',
+  'object_messageFwdHeader_param_saved_from_msg_id_type_int' => 'Only for messages forwarded to the current user (inputPeerSelf), ID of the message that was forwarded from the original user/channel',
+  'object_auth.codeTypeSms' => 'Type of verification code that will be sent next if you call the resendCode method: SMS code',
+  'object_auth.codeTypeCall' => 'Type of verification code that will be sent next if you call the resendCode method: SMS code',
+  'object_auth.codeTypeFlashCall' => 'Type of verification code that will be sent next if you call the resendCode method: SMS code',
+  'object_auth.sentCodeTypeApp' => 'The code was sent through the telegram app',
+  'object_auth.sentCodeTypeApp_param_length_type_int' => 'Length of the code in bytes',
+  'object_auth.sentCodeTypeSms' => 'The code was sent via SMS',
+  'object_auth.sentCodeTypeSms_param_length_type_int' => 'Length of the code in bytes',
+  'object_auth.sentCodeTypeCall' => 'The code will be sent via a phone call: a synthesized voice will tell the user which verification code to input.',
+  'object_auth.sentCodeTypeCall_param_length_type_int' => 'Length of the verification code',
+  'object_auth.sentCodeTypeFlashCall' => 'The code will be sent via a flash phone call, that will be closed immediately. The phone code will then be the phone number itself, just make sure that the phone number matches the specified pattern.',
+  'object_auth.sentCodeTypeFlashCall_param_pattern_type_string' => '[pattern](https://core.telegram.org/api/pattern) to match',
+  'object_messages.botCallbackAnswer' => 'Callback answer sent by the bot in response to a button press',
+  'object_messages.botCallbackAnswer_param_alert_type_true' => 'Whether an alert should be shown to the user instead of a toast notification',
+  'object_messages.botCallbackAnswer_param_has_url_type_true' => 'Whether an URL is present',
+  'object_messages.botCallbackAnswer_param_native_ui_type_true' => 'Whether to show games in WebView or in native UI.',
+  'object_messages.botCallbackAnswer_param_message_type_string' => 'Alert to show',
+  'object_messages.botCallbackAnswer_param_url_type_string' => 'URL to open',
+  'object_messages.botCallbackAnswer_param_cache_time_type_int' => 'For how long should this answer be cached',
+  'object_messages.messageEditData' => 'Message edit data for media',
+  'object_messages.messageEditData_param_caption_type_true' => 'Media caption, if the specified media\'s caption can be edited',
+  'object_inputBotInlineMessageID' => 'Represents a sent inline message from the perspective of a bot',
+  'object_inputBotInlineMessageID_param_dc_id_type_int' => 'DC ID to use when working with this inline message',
+  'object_inputBotInlineMessageID_param_id_type_long' => 'ID of message',
+  'object_inputBotInlineMessageID_param_access_hash_type_long' => 'Access hash of message',
+  'object_inlineBotSwitchPM' => 'The bot requested the user to message him in private',
+  'object_inlineBotSwitchPM_param_text_type_string' => 'Text for the button that switches the user to a private chat with the bot and sends the bot a start message with the parameter `start_parameter` (can be empty)',
+  'object_inlineBotSwitchPM_param_start_param_type_string' => 'The parameter for the `/start parameter`',
+  'object_messages.peerDialogs' => 'Dialog info of multiple peers',
   'object_messages.peerDialogs_param_dialogs_type_Vector t' => 'Dialogs',
   'object_messages.peerDialogs_param_messages_type_Vector t' => 'Messages',
   'object_messages.peerDialogs_param_chats_type_Vector t' => 'Chats',
   'object_messages.peerDialogs_param_users_type_Vector t' => 'Users',
-  'object_messages.peerDialogs_param_state_type_updates.State' => 'State',
+  'object_messages.peerDialogs_param_state_type_updates.State' => 'Current [update state of dialog](https://core.telegram.org/api/updates)',
   'object_topPeer' => 'Top peer',
   'object_topPeer_param_peer_type_Peer' => 'Peer',
-  'object_topPeer_param_rating_type_double' => 'Rating',
-  'object_topPeerCategoryBotsPM' => 'Top peer category bots pm',
-  'object_topPeerCategoryBotsInline' => 'Top peer category bots inline',
-  'object_topPeerCategoryCorrespondents' => 'Top peer category correspondents',
-  'object_topPeerCategoryGroups' => 'Top peer category groups',
-  'object_topPeerCategoryChannels' => 'Top peer category channels',
-  'object_topPeerCategoryPhoneCalls' => 'Top peer category phone calls',
-  'object_topPeerCategoryPeers' => 'Top peer category peers',
-  'object_topPeerCategoryPeers_param_category_type_TopPeerCategory' => 'Category',
-  'object_topPeerCategoryPeers_param_count_type_int' => 'Count',
+  'object_topPeer_param_rating_type_double' => 'Rating as computer in [top peer rating »](https://core.telegram.org/api/top-rating)',
+  'object_topPeerCategoryBotsPM' => 'Most used bots',
+  'object_topPeerCategoryBotsInline' => 'Most used inline bots',
+  'object_topPeerCategoryCorrespondents' => 'Users we\'ve chatted most frequently with',
+  'object_topPeerCategoryGroups' => 'Often-opened groups and supergroups',
+  'object_topPeerCategoryChannels' => 'Most frequently visited channels',
+  'object_topPeerCategoryPhoneCalls' => 'Most frequently called users',
+  'object_topPeerCategoryPeers' => 'Top peer category',
+  'object_topPeerCategoryPeers_param_category_type_TopPeerCategory' => 'Top peer category of peers',
+  'object_topPeerCategoryPeers_param_count_type_int' => 'Count of peers',
   'object_topPeerCategoryPeers_param_peers_type_Vector t' => 'Peers',
-  'object_contacts.topPeersNotModified' => 'Top peers not modified',
+  'object_contacts.topPeersNotModified' => 'Top peer info hasn\'t changed',
   'object_contacts.topPeers' => 'Top peers',
   'object_contacts.topPeers_param_categories_type_Vector t' => 'Categories',
   'object_contacts.topPeers_param_chats_type_Vector t' => 'Chats',
   'object_contacts.topPeers_param_users_type_Vector t' => 'Users',
-  'object_draftMessageEmpty' => 'Empty draft message',
-  'object_draftMessage' => 'Draft message',
-  'object_draftMessage_param_no_webpage_type_true' => 'No webpage?',
-  'object_draftMessage_param_reply_to_msg_id_type_int' => 'Reply to msg ID',
-  'object_draftMessage_param_message_type_string' => 'Message',
+  'object_draftMessageEmpty' => 'Empty draft',
+  'object_draftMessage' => 'Represents a message [draft](https://core.telegram.org/api/drafts).',
+  'object_draftMessage_param_no_webpage_type_true' => 'Whether no webpage preview will be generated',
+  'object_draftMessage_param_reply_to_msg_id_type_int' => 'The message this message will reply to',
+  'object_draftMessage_param_message_type_string' => 'The draft',
   'object_draftMessage_param_entities_type_Vector t' => 'Entities',
-  'object_draftMessage_param_date_type_int' => 'Date',
-  'object_messages.featuredStickersNotModified' => 'Featured stickers not modified',
-  'object_messages.featuredStickers' => 'Featured stickers',
-  'object_messages.featuredStickers_param_hash_type_int' => 'Hash',
+  'object_draftMessage_param_date_type_int' => 'Date of last update of the draft.',
+  'object_messages.featuredStickersNotModified' => 'Featured stickers haven\'t changed',
+  'object_messages.featuredStickers' => 'Featured stickersets',
+  'object_messages.featuredStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
   'object_messages.featuredStickers_param_sets_type_Vector t' => 'Sets',
   'object_messages.featuredStickers_param_unread_type_Vector t' => 'Unread',
-  'object_messages.recentStickersNotModified' => 'Recent stickers not modified',
-  'object_messages.recentStickers' => 'Recent stickers',
-  'object_messages.recentStickers_param_hash_type_int' => 'Hash',
+  'object_messages.recentStickersNotModified' => 'No new recent sticker was found',
+  'object_messages.recentStickers' => 'Recently used stickers',
+  'object_messages.recentStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
   'object_messages.recentStickers_param_stickers_type_Vector t' => 'Stickers',
-  'object_messages.archivedStickers' => 'Archived stickers',
-  'object_messages.archivedStickers_param_count_type_int' => 'Count',
+  'object_messages.archivedStickers' => 'Archived stickersets',
+  'object_messages.archivedStickers_param_count_type_int' => 'Number of archived stickers',
   'object_messages.archivedStickers_param_sets_type_Vector t' => 'Sets',
-  'object_messages.stickerSetInstallResultSuccess' => 'Sticker set install result success',
-  'object_messages.stickerSetInstallResultArchive' => 'Sticker set install result archive',
+  'object_messages.stickerSetInstallResultSuccess' => 'The stickerset was installed successfully',
+  'object_messages.stickerSetInstallResultArchive' => 'The stickerset was installed, but since there are too many stickersets some were archived',
   'object_messages.stickerSetInstallResultArchive_param_sets_type_Vector t' => 'Sets',
-  'object_stickerSetCovered' => 'Sticker set covered',
-  'object_stickerSetCovered_param_set_type_StickerSet' => 'Set',
-  'object_stickerSetCovered_param_cover_type_Document' => 'Cover',
-  'object_stickerSetMultiCovered' => 'Sticker set multi covered',
-  'object_stickerSetMultiCovered_param_set_type_StickerSet' => 'Set',
+  'object_stickerSetCovered' => 'Stickerset, with a specific sticker as preview',
+  'object_stickerSetCovered_param_set_type_StickerSet' => 'Stickerset',
+  'object_stickerSetCovered_param_cover_type_Document' => 'Preview',
+  'object_stickerSetMultiCovered' => 'Stickerset, with a specific stickers as preview',
+  'object_stickerSetMultiCovered_param_set_type_StickerSet' => 'Stickerset',
   'object_stickerSetMultiCovered_param_covers_type_Vector t' => 'Covers',
-  'object_maskCoords' => 'Mask coords',
-  'object_maskCoords_param_n_type_int' => 'N',
-  'object_maskCoords_param_x_type_double' => 'X',
-  'object_maskCoords_param_y_type_double' => 'Y',
-  'object_maskCoords_param_zoom_type_double' => 'Zoom',
-  'object_inputStickeredMediaPhoto' => 'Stickered media photo',
-  'object_inputStickeredMediaPhoto_param_id_type_InputPhoto' => 'ID',
-  'object_inputStickeredMediaDocument' => 'Stickered media document',
-  'object_inputStickeredMediaDocument_param_id_type_InputDocument' => 'ID',
-  'object_game' => 'Game',
-  'object_game_param_id_type_long' => 'ID',
-  'object_game_param_access_hash_type_long' => 'Access hash',
-  'object_game_param_short_name_type_string' => 'Short name',
-  'object_game_param_title_type_string' => 'Title',
-  'object_game_param_description_type_string' => 'Description',
-  'object_game_param_photo_type_Photo' => 'Photo',
-  'object_game_param_document_type_Document' => 'Document',
-  'object_inputGameID' => 'Game ID',
-  'object_inputGameID_param_id_type_long' => 'ID',
-  'object_inputGameID_param_access_hash_type_long' => 'Access hash',
-  'object_inputGameShortName' => 'Game short name',
-  'object_inputGameShortName_param_bot_id_type_InputUser' => 'Bot ID',
-  'object_inputGameShortName_param_short_name_type_string' => 'Short name',
-  'object_highScore' => 'High score',
-  'object_highScore_param_pos_type_int' => 'Pos',
+  'object_maskCoords' => 'Position on a photo where a mask should be placed
+
+The `n` position indicates where the mask should be placed:
+
+- 0 => Relative to the forehead
+- 1 => Relative to the eyes
+- 2 => Relative to the mouth
+- 3 => Relative to the chin',
+  'object_maskCoords_param_n_type_int' => 'Part of the face, relative to which the mask should be placed',
+  'object_maskCoords_param_x_type_double' => 'Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. (For example, -1.0 will place the mask just to the left of the default mask position)',
+  'object_maskCoords_param_y_type_double' => 'Shift by Y-axis measured in widths of the mask scaled to the face size, from left to right. (For example, -1.0 will place the mask just to the left of the default mask position)',
+  'object_maskCoords_param_zoom_type_double' => 'Mask scaling coefficient. (For example, 2.0 means a doubled size)',
+  'object_inputStickeredMediaPhoto' => 'A photo with stickers attached',
+  'object_inputStickeredMediaPhoto_param_id_type_InputPhoto' => 'The photo',
+  'object_inputStickeredMediaDocument' => 'A document with stickers attached',
+  'object_inputStickeredMediaDocument_param_id_type_InputDocument' => 'The document',
+  'object_game' => 'Indicates an already sent game',
+  'object_game_param_id_type_long' => 'ID of the game',
+  'object_game_param_access_hash_type_long' => 'Access hash of the game',
+  'object_game_param_short_name_type_string' => 'Short name for the game',
+  'object_game_param_title_type_string' => 'Title of the game',
+  'object_game_param_description_type_string' => 'Game description',
+  'object_game_param_photo_type_Photo' => 'Game preview',
+  'object_game_param_document_type_Document' => 'Optional attached document',
+  'object_inputGameID' => 'Indicates an already sent game',
+  'object_inputGameID_param_id_type_long' => 'game ID from [Game](../types/Game.md) constructor',
+  'object_inputGameID_param_access_hash_type_long' => 'access hash from [Game](../types/Game.md) constructor',
+  'object_inputGameShortName' => 'Game by short name',
+  'object_inputGameShortName_param_bot_id_type_InputUser' => 'The bot that provides the game',
+  'object_inputGameShortName_param_short_name_type_string' => 'The game\'s short name',
+  'object_highScore' => 'Game highscore',
+  'object_highScore_param_pos_type_int' => 'Position in highscore list',
   'object_highScore_param_user_id_type_int' => 'User ID',
   'object_highScore_param_score_type_int' => 'Score',
-  'object_messages.highScores' => 'High scores',
+  'object_messages.highScores' => 'Highscores in a game',
   'object_messages.highScores_param_scores_type_Vector t' => 'Scores',
   'object_messages.highScores_param_users_type_Vector t' => 'Users',
-  'object_textEmpty' => 'Empty text',
-  'object_textPlain' => 'Text plain',
+  'object_textEmpty' => 'Empty rich text element',
+  'object_textPlain' => 'Plain text',
   'object_textPlain_param_text_type_string' => 'Text',
-  'object_textBold' => 'Text bold',
+  'object_textBold' => '**Bold** text',
   'object_textBold_param_text_type_RichText' => 'Text',
-  'object_textItalic' => 'Text italic',
+  'object_textItalic' => '*Italic* text',
   'object_textItalic_param_text_type_RichText' => 'Text',
-  'object_textUnderline' => 'Text underline',
+  'object_textUnderline' => 'Underlined text',
   'object_textUnderline_param_text_type_RichText' => 'Text',
-  'object_textStrike' => 'Text strike',
+  'object_textStrike' => 'Strikethrough text',
   'object_textStrike_param_text_type_RichText' => 'Text',
-  'object_textFixed' => 'Text fixed',
+  'object_textFixed' => '`fixed-width` rich text',
   'object_textFixed_param_text_type_RichText' => 'Text',
-  'object_textUrl' => 'Text URL',
-  'object_textUrl_param_text_type_RichText' => 'Text',
-  'object_textUrl_param_url_type_string' => 'URL',
-  'object_textUrl_param_webpage_id_type_long' => 'Webpage ID',
-  'object_textEmail' => 'Text email',
-  'object_textEmail_param_text_type_RichText' => 'Text',
-  'object_textEmail_param_email_type_string' => 'Email',
-  'object_textConcat' => 'Text concat',
+  'object_textUrl' => 'Link',
+  'object_textUrl_param_text_type_RichText' => 'Text of link',
+  'object_textUrl_param_url_type_string' => 'Webpage HTTP URL',
+  'object_textUrl_param_webpage_id_type_long' => 'If a preview was already generated for the page, the page ID',
+  'object_textEmail' => 'Rich text email link',
+  'object_textEmail_param_text_type_RichText' => 'Link text',
+  'object_textEmail_param_email_type_string' => 'Email address',
+  'object_textConcat' => 'Concatenation of rich texts',
   'object_textConcat_param_texts_type_Vector t' => 'Texts',
-  'object_pageBlockUnsupported' => 'Page block unsupported',
-  'object_pageBlockTitle' => 'Page block title',
-  'object_pageBlockTitle_param_text_type_RichText' => 'Text',
-  'object_pageBlockSubtitle' => 'Page block subtitle',
+  'object_pageBlockUnsupported' => 'Unsupported IV element',
+  'object_pageBlockTitle' => 'Title',
+  'object_pageBlockTitle_param_text_type_RichText' => 'Title',
+  'object_pageBlockSubtitle' => 'Subtitle',
   'object_pageBlockSubtitle_param_text_type_RichText' => 'Text',
-  'object_pageBlockAuthorDate' => 'Page block author date',
-  'object_pageBlockAuthorDate_param_author_type_RichText' => 'Author',
-  'object_pageBlockAuthorDate_param_published_date_type_int' => 'Published date',
-  'object_pageBlockHeader' => 'Page block header',
-  'object_pageBlockHeader_param_text_type_RichText' => 'Text',
-  'object_pageBlockSubheader' => 'Page block subheader',
-  'object_pageBlockSubheader_param_text_type_RichText' => 'Text',
-  'object_pageBlockFooter' => 'Page block footer',
-  'object_pageBlockFooter_param_text_type_RichText' => 'Text',
-  'object_pageBlockList' => 'Page block list',
+  'object_pageBlockAuthorDate' => 'Author and date of creation of article',
+  'object_pageBlockAuthorDate_param_author_type_RichText' => 'Author name',
+  'object_pageBlockAuthorDate_param_published_date_type_int' => 'Date of pubblication',
+  'object_pageBlockHeader' => 'Page header',
+  'object_pageBlockHeader_param_text_type_RichText' => 'Contents',
+  'object_pageBlockSubheader' => 'Subheader',
+  'object_pageBlockSubheader_param_text_type_RichText' => 'Subheader',
+  'object_pageBlockFooter' => 'Page footer',
+  'object_pageBlockFooter_param_text_type_RichText' => 'Contents',
+  'object_pageBlockList' => 'Unordered list of IV blocks',
   'object_pageBlockList_param_ordered_type_Bool' => 'Ordered?',
   'object_pageBlockList_param_items_type_Vector t' => 'Items',
-  'object_pageBlockBlockquote' => 'Page block blockquote',
-  'object_pageBlockBlockquote_param_text_type_RichText' => 'Text',
+  'object_pageBlockBlockquote' => 'Quote (equivalent to the HTML `
`)',
+  'object_pageBlockBlockquote_param_text_type_RichText' => 'Quote contents',
   'object_pageBlockBlockquote_param_caption_type_RichText' => 'Caption',
-  'object_pageBlockPullquote' => 'Page block pullquote',
+  'object_pageBlockPullquote' => 'Pullquote',
   'object_pageBlockPullquote_param_text_type_RichText' => 'Text',
   'object_pageBlockPullquote_param_caption_type_RichText' => 'Caption',
-  'object_pageBlockPhoto' => 'Page block photo',
+  'object_pageBlockPhoto' => 'A photo',
   'object_pageBlockPhoto_param_photo_id_type_long' => 'Photo ID',
   'object_pageBlockPhoto_param_caption_type_RichText' => 'Caption',
-  'object_pageBlockVideo' => 'Page block video',
-  'object_pageBlockVideo_param_autoplay_type_true' => 'Autoplay?',
-  'object_pageBlockVideo_param_loop_type_true' => 'Loop?',
+  'object_pageBlockVideo' => 'Video',
+  'object_pageBlockVideo_param_autoplay_type_true' => 'Whether the video is set to autoplay',
+  'object_pageBlockVideo_param_loop_type_true' => 'Whether the video is set to loop',
   'object_pageBlockVideo_param_video_id_type_long' => 'Video ID',
   'object_pageBlockVideo_param_caption_type_RichText' => 'Caption',
-  'object_pageBlockEmbed' => 'Page block embed',
-  'object_pageBlockEmbed_param_full_width_type_true' => 'Full width?',
-  'object_pageBlockEmbed_param_allow_scrolling_type_true' => 'Allow scrolling?',
-  'object_pageBlockEmbed_param_url_type_string' => 'URL',
-  'object_pageBlockEmbed_param_html_type_string' => 'Html',
-  'object_pageBlockEmbed_param_poster_photo_id_type_long' => 'Poster photo ID',
-  'object_pageBlockEmbed_param_w_type_int' => 'Width',
-  'object_pageBlockEmbed_param_h_type_int' => 'Height',
+  'object_pageBlockEmbed' => 'An embedded webpage',
+  'object_pageBlockEmbed_param_full_width_type_true' => 'Whether the block should be full width',
+  'object_pageBlockEmbed_param_allow_scrolling_type_true' => 'Whether scrolling should be allowed',
+  'object_pageBlockEmbed_param_url_type_string' => 'Web page URL, if available',
+  'object_pageBlockEmbed_param_html_type_string' => 'HTML-markup of the embedded page',
+  'object_pageBlockEmbed_param_poster_photo_id_type_long' => 'Poster photo, if available',
+  'object_pageBlockEmbed_param_w_type_int' => 'Block width, if known',
+  'object_pageBlockEmbed_param_h_type_int' => 'Block height, if known',
   'object_pageBlockEmbed_param_caption_type_RichText' => 'Caption',
-  'object_pageBlockEmbedPost' => 'Page block embed post',
-  'object_pageBlockEmbedPost_param_url_type_string' => 'URL',
-  'object_pageBlockEmbedPost_param_webpage_id_type_long' => 'Webpage ID',
-  'object_pageBlockEmbedPost_param_author_photo_id_type_long' => 'Author photo ID',
-  'object_pageBlockEmbedPost_param_author_type_string' => 'Author',
-  'object_pageBlockEmbedPost_param_date_type_int' => 'Date',
+  'object_pageBlockEmbedPost' => 'An embedded post',
+  'object_pageBlockEmbedPost_param_url_type_string' => 'Web page URL',
+  'object_pageBlockEmbedPost_param_webpage_id_type_long' => 'ID of generated webpage preview',
+  'object_pageBlockEmbedPost_param_author_photo_id_type_long' => 'ID of the author\'s photo',
+  'object_pageBlockEmbedPost_param_author_type_string' => 'Author name',
+  'object_pageBlockEmbedPost_param_date_type_int' => 'Creation date',
   'object_pageBlockEmbedPost_param_blocks_type_Vector t' => 'Blocks',
   'object_pageBlockEmbedPost_param_caption_type_RichText' => 'Caption',
-  'object_pageBlockCollage' => 'Page block collage',
+  'object_pageBlockCollage' => 'Collage of media',
   'object_pageBlockCollage_param_items_type_Vector t' => 'Items',
   'object_pageBlockCollage_param_caption_type_RichText' => 'Caption',
-  'object_pageBlockSlideshow' => 'Page block slideshow',
+  'object_pageBlockSlideshow' => 'Slideshow',
   'object_pageBlockSlideshow_param_items_type_Vector t' => 'Items',
   'object_pageBlockSlideshow_param_caption_type_RichText' => 'Caption',
-  'object_pageBlockChannel' => 'Page block channel',
-  'object_pageBlockChannel_param_channel_type_Chat' => 'Channel',
-  'object_pageBlockAudio' => 'Page block audio',
-  'object_pageBlockAudio_param_audio_id_type_long' => 'Audio ID',
+  'object_pageBlockChannel' => 'Reference to a telegram channel',
+  'object_pageBlockChannel_param_channel_type_Chat' => 'The channel/supergroup/chat',
+  'object_pageBlockAudio' => 'Audio',
+  'object_pageBlockAudio_param_audio_id_type_long' => 'Audio ID (to be fetched from the container [page](../constructors/page.md) constructor',
   'object_pageBlockAudio_param_caption_type_RichText' => 'Caption',
   'object_pagePart' => 'Page part',
   'object_pagePart_param_blocks_type_Vector t' => 'Blocks',
@@ -8238,212 +8640,212 @@ class Lang
   'object_pageFull_param_blocks_type_Vector t' => 'Blocks',
   'object_pageFull_param_photos_type_Vector t' => 'Photos',
   'object_pageFull_param_documents_type_Vector t' => 'Documents',
-  'object_phoneCallDiscardReasonMissed' => 'Phone call discard reason missed',
-  'object_phoneCallDiscardReasonDisconnect' => 'Phone call discard reason disconnect',
-  'object_phoneCallDiscardReasonHangup' => 'Phone call discard reason hangup',
-  'object_phoneCallDiscardReasonBusy' => 'Phone call discard reason busy',
-  'object_dataJSON' => 'Data json',
-  'object_dataJSON_param_data_type_string' => 'Data',
-  'object_labeledPrice' => 'Labeled price',
-  'object_labeledPrice_param_label_type_string' => 'Label',
-  'object_labeledPrice_param_amount_type_long' => 'Amount',
+  'object_phoneCallDiscardReasonMissed' => 'The phone call was missed',
+  'object_phoneCallDiscardReasonDisconnect' => 'The phone call was disconnected',
+  'object_phoneCallDiscardReasonHangup' => 'The phone call was ended normally',
+  'object_phoneCallDiscardReasonBusy' => 'The phone call was discared because the user is busy in another call',
+  'object_dataJSON' => 'Represents a json-encoded object',
+  'object_dataJSON_param_data_type_string' => 'JSON-encoded object',
+  'object_labeledPrice' => 'This object represents a portion of the price for goods or services.',
+  'object_labeledPrice_param_label_type_string' => 'Portion label',
+  'object_labeledPrice_param_amount_type_long' => 'Price of the product in the smallest units of the currency (integer, not float/double). For example, for a price of `US$ 1.45` pass `amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).',
   'object_invoice' => 'Invoice',
-  'object_invoice_param_test_type_true' => 'Test?',
-  'object_invoice_param_name_requested_type_true' => 'Name requested?',
-  'object_invoice_param_phone_requested_type_true' => 'Phone requested?',
-  'object_invoice_param_email_requested_type_true' => 'Email requested?',
-  'object_invoice_param_shipping_address_requested_type_true' => 'Shipping address requested?',
-  'object_invoice_param_flexible_type_true' => 'Flexible?',
-  'object_invoice_param_phone_to_provider_type_true' => 'Phone to provider?',
-  'object_invoice_param_email_to_provider_type_true' => 'Email to provider?',
-  'object_invoice_param_currency_type_string' => 'Currency',
+  'object_invoice_param_test_type_true' => 'Test invoice',
+  'object_invoice_param_name_requested_type_true' => 'Set this flag if you require the user\'s full name to complete the order',
+  'object_invoice_param_phone_requested_type_true' => 'Set this flag if you require the user\'s phone number to complete the order',
+  'object_invoice_param_email_requested_type_true' => 'Set this flag if you require the user\'s email address to complete the order',
+  'object_invoice_param_shipping_address_requested_type_true' => 'Set this flag if you require the user\'s shipping address to complete the order',
+  'object_invoice_param_flexible_type_true' => 'Set this flag if the final price depends on the shipping method',
+  'object_invoice_param_phone_to_provider_type_true' => 'Set this flag if user\'s phone number should be sent to provider',
+  'object_invoice_param_email_to_provider_type_true' => 'Set this flag if user\'s email address should be sent to provider',
+  'object_invoice_param_currency_type_string' => 'Three-letter ISO 4217 [currency](https://core.telegram.org/bots/payments#supported-currencies) code',
   'object_invoice_param_prices_type_Vector t' => 'Prices',
-  'object_paymentCharge' => 'Payment charge',
-  'object_paymentCharge_param_id_type_string' => 'ID',
-  'object_paymentCharge_param_provider_charge_id_type_string' => 'Provider charge ID',
-  'object_postAddress' => 'Post address',
-  'object_postAddress_param_street_line1_type_string' => 'Street line1',
-  'object_postAddress_param_street_line2_type_string' => 'Street line2',
+  'object_paymentCharge' => 'Payment identifier',
+  'object_paymentCharge_param_id_type_string' => 'Telegram payment identifier',
+  'object_paymentCharge_param_provider_charge_id_type_string' => 'Provider payment identifier',
+  'object_postAddress' => 'Shipping address',
+  'object_postAddress_param_street_line1_type_string' => 'First line for the address',
+  'object_postAddress_param_street_line2_type_string' => 'Second line for the address',
   'object_postAddress_param_city_type_string' => 'City',
-  'object_postAddress_param_state_type_string' => 'State',
-  'object_postAddress_param_country_iso2_type_string' => 'Country iso2',
-  'object_postAddress_param_post_code_type_string' => 'Post code',
-  'object_paymentRequestedInfo' => 'Payment requested info',
-  'object_paymentRequestedInfo_param_name_type_string' => 'Name',
-  'object_paymentRequestedInfo_param_phone_type_string' => 'Phone',
-  'object_paymentRequestedInfo_param_email_type_string' => 'Email',
-  'object_paymentRequestedInfo_param_shipping_address_type_PostAddress' => 'Shipping address',
-  'object_paymentSavedCredentialsCard' => 'Payment saved credentials card',
-  'object_paymentSavedCredentialsCard_param_id_type_string' => 'ID',
+  'object_postAddress_param_state_type_string' => 'State, if applicable (empty otherwise)',
+  'object_postAddress_param_country_iso2_type_string' => 'ISO 3166-1 alpha-2 country code',
+  'object_postAddress_param_post_code_type_string' => 'Address post code',
+  'object_paymentRequestedInfo' => 'Order info provided by the user',
+  'object_paymentRequestedInfo_param_name_type_string' => 'User\'s full name',
+  'object_paymentRequestedInfo_param_phone_type_string' => 'User\'s phone number',
+  'object_paymentRequestedInfo_param_email_type_string' => 'User\'s email address',
+  'object_paymentRequestedInfo_param_shipping_address_type_PostAddress' => 'User\'s shipping address',
+  'object_paymentSavedCredentialsCard' => 'Saved credit card',
+  'object_paymentSavedCredentialsCard_param_id_type_string' => 'Card ID',
   'object_paymentSavedCredentialsCard_param_title_type_string' => 'Title',
-  'object_webDocument' => 'Web document',
-  'object_webDocument_param_url_type_string' => 'URL',
+  'object_webDocument' => 'Remote document',
+  'object_webDocument_param_url_type_string' => 'Document URL',
   'object_webDocument_param_access_hash_type_long' => 'Access hash',
-  'object_webDocument_param_size_type_int' => 'Size',
-  'object_webDocument_param_mime_type_type_string' => 'Mime type',
+  'object_webDocument_param_size_type_int' => 'File size',
+  'object_webDocument_param_mime_type_type_string' => 'MIME type',
   'object_webDocument_param_attributes_type_Vector t' => 'Attributes',
   'object_webDocument_param_dc_id_type_int' => 'DC ID',
-  'object_inputWebDocument' => 'Web document',
-  'object_inputWebDocument_param_url_type_string' => 'URL',
-  'object_inputWebDocument_param_size_type_int' => 'Size',
+  'object_inputWebDocument' => 'The document',
+  'object_inputWebDocument_param_url_type_string' => 'Remote document URL to be downloaded using the appropriate [method](https://core.telegram.org/api/files)',
+  'object_inputWebDocument_param_size_type_int' => 'Remote file size',
   'object_inputWebDocument_param_mime_type_type_string' => 'Mime type',
   'object_inputWebDocument_param_attributes_type_Vector t' => 'Attributes',
-  'object_inputWebFileLocation' => 'Web file location',
-  'object_inputWebFileLocation_param_url_type_string' => 'URL',
+  'object_inputWebFileLocation' => 'Location of a remote HTTP(s) file',
+  'object_inputWebFileLocation_param_url_type_string' => 'HTTP URL of file',
   'object_inputWebFileLocation_param_access_hash_type_long' => 'Access hash',
-  'object_upload.webFile' => 'Web file',
-  'object_upload.webFile_param_size_type_int' => 'Size',
+  'object_upload.webFile' => 'Represents a chunk of an [HTTP webfile](https://core.telegram.org/api/files) downloaded through telegram\'s secure MTProto servers',
+  'object_upload.webFile_param_size_type_int' => 'File size',
   'object_upload.webFile_param_mime_type_type_string' => 'Mime type',
   'object_upload.webFile_param_file_type_type_storage.FileType' => 'File type',
-  'object_upload.webFile_param_mtime_type_int' => 'Mtime',
-  'object_upload.webFile_param_bytes_type_bytes' => 'Bytes',
+  'object_upload.webFile_param_mtime_type_int' => 'Modified time',
+  'object_upload.webFile_param_bytes_type_bytes' => 'Data',
   'object_payments.paymentForm' => 'Payment form',
-  'object_payments.paymentForm_param_can_save_credentials_type_true' => 'Can save credentials?',
-  'object_payments.paymentForm_param_password_missing_type_true' => 'Password missing?',
+  'object_payments.paymentForm_param_can_save_credentials_type_true' => 'Whether the user can choose to save credentials.',
+  'object_payments.paymentForm_param_password_missing_type_true' => 'Indicates that the user can save payment credentials, but only after setting up a [2FA password](https://core.telegram.org/api/srp) (currently the account doesn\'t have a [2FA password](https://core.telegram.org/api/srp))',
   'object_payments.paymentForm_param_bot_id_type_int' => 'Bot ID',
   'object_payments.paymentForm_param_invoice_type_Invoice' => 'Invoice',
-  'object_payments.paymentForm_param_provider_id_type_int' => 'Provider ID',
-  'object_payments.paymentForm_param_url_type_string' => 'URL',
-  'object_payments.paymentForm_param_native_provider_type_string' => 'Native provider',
-  'object_payments.paymentForm_param_native_params_type_DataJSON' => 'Native params',
-  'object_payments.paymentForm_param_saved_info_type_PaymentRequestedInfo' => 'Saved info',
-  'object_payments.paymentForm_param_saved_credentials_type_PaymentSavedCredentials' => 'Saved credentials',
+  'object_payments.paymentForm_param_provider_id_type_int' => 'Payment provider ID.',
+  'object_payments.paymentForm_param_url_type_string' => 'Payment form URL',
+  'object_payments.paymentForm_param_native_provider_type_string' => 'Payment provider name.
One of the following:
\\- `stripe`',
+  'object_payments.paymentForm_param_native_params_type_DataJSON' => 'Contains information about the payment provider, if available, to support it natively without the need for opening the URL.
A JSON object that can contain the following fields:

\\- `publishable_key`: Stripe API publishable key
\\- `apple_pay_merchant_id`: Apple Pay merchant ID
\\- `android_pay_public_key`: Android Pay public key
\\- `android_pay_bgcolor`: Android Pay form background color
\\- `android_pay_inverse`: Whether to use the dark theme in the Android Pay form
\\- `need_country`: True, if the user country must be provided,
\\- `need_zip`: True, if the user ZIP/postal code must be provided,
\\- `need_cardholder_name`: True, if the cardholder name must be provided
',
+  'object_payments.paymentForm_param_saved_info_type_PaymentRequestedInfo' => 'Saved server-side order information',
+  'object_payments.paymentForm_param_saved_credentials_type_PaymentSavedCredentials' => 'Contains information about saved card credentials',
   'object_payments.paymentForm_param_users_type_Vector t' => 'Users',
-  'object_payments.validatedRequestedInfo' => 'Validated requested info',
+  'object_payments.validatedRequestedInfo' => 'Validated user-provided info',
   'object_payments.validatedRequestedInfo_param_id_type_string' => 'ID',
   'object_payments.validatedRequestedInfo_param_shipping_options_type_Vector t' => 'Shipping options',
   'object_payments.paymentResult' => 'Payment result',
-  'object_payments.paymentResult_param_updates_type_Updates' => 'Updates',
+  'object_payments.paymentResult_param_updates_type_Updates' => 'Info about the payment',
   'object_payments.paymentVerficationNeeded' => 'Payment verfication needed',
   'object_payments.paymentVerficationNeeded_param_url_type_string' => 'URL',
-  'object_payments.paymentReceipt' => 'Payment receipt',
-  'object_payments.paymentReceipt_param_date_type_int' => 'Date',
+  'object_payments.paymentReceipt' => 'Receipt',
+  'object_payments.paymentReceipt_param_date_type_int' => 'Date of generation',
   'object_payments.paymentReceipt_param_bot_id_type_int' => 'Bot ID',
   'object_payments.paymentReceipt_param_invoice_type_Invoice' => 'Invoice',
   'object_payments.paymentReceipt_param_provider_id_type_int' => 'Provider ID',
   'object_payments.paymentReceipt_param_info_type_PaymentRequestedInfo' => 'Info',
-  'object_payments.paymentReceipt_param_shipping_type_ShippingOption' => 'Shipping',
-  'object_payments.paymentReceipt_param_currency_type_string' => 'Currency',
-  'object_payments.paymentReceipt_param_total_amount_type_long' => 'Total amount',
-  'object_payments.paymentReceipt_param_credentials_title_type_string' => 'Credentials title',
+  'object_payments.paymentReceipt_param_shipping_type_ShippingOption' => 'Selected shipping option',
+  'object_payments.paymentReceipt_param_currency_type_string' => 'Three-letter ISO 4217 [currency](https://core.telegram.org/bots/payments#supported-currencies) code',
+  'object_payments.paymentReceipt_param_total_amount_type_long' => 'Total amount in the smallest units of the currency (integer, not float/double). For example, for a price of `US$ 1.45` pass `amount = 145`. See the exp parameter in [currencies.json](https://core.telegram.org/bots/payments/currencies.json), it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).',
+  'object_payments.paymentReceipt_param_credentials_title_type_string' => 'Payment credential name',
   'object_payments.paymentReceipt_param_users_type_Vector t' => 'Users',
-  'object_payments.savedInfo' => 'Saved info',
-  'object_payments.savedInfo_param_has_saved_credentials_type_true' => 'Has saved credentials?',
-  'object_payments.savedInfo_param_saved_info_type_PaymentRequestedInfo' => 'Saved info',
-  'object_inputPaymentCredentialsSaved' => 'Payment credentials saved',
-  'object_inputPaymentCredentialsSaved_param_id_type_string' => 'ID',
-  'object_inputPaymentCredentialsSaved_param_tmp_password_type_bytes' => 'Tmp password',
+  'object_payments.savedInfo' => 'Saved server-side order information',
+  'object_payments.savedInfo_param_has_saved_credentials_type_true' => 'Whether the user has some saved payment credentials',
+  'object_payments.savedInfo_param_saved_info_type_PaymentRequestedInfo' => 'Saved server-side order information',
+  'object_inputPaymentCredentialsSaved' => 'Saved payment credentials',
+  'object_inputPaymentCredentialsSaved_param_id_type_string' => 'Credential ID',
+  'object_inputPaymentCredentialsSaved_param_tmp_password_type_bytes' => 'Temporary password',
   'object_inputPaymentCredentials' => 'Payment credentials',
-  'object_inputPaymentCredentials_param_save_type_true' => 'Save?',
-  'object_inputPaymentCredentials_param_data_type_DataJSON' => 'Data',
-  'object_inputPaymentCredentialsApplePay' => 'Payment credentials apple pay',
+  'object_inputPaymentCredentials_param_save_type_true' => 'Save payment credential for future use',
+  'object_inputPaymentCredentials_param_data_type_DataJSON' => 'Payment credentials',
+  'object_inputPaymentCredentialsApplePay' => 'Apple pay payment credentials',
   'object_inputPaymentCredentialsApplePay_param_payment_data_type_DataJSON' => 'Payment data',
-  'object_inputPaymentCredentialsAndroidPay' => 'Payment credentials android pay',
-  'object_inputPaymentCredentialsAndroidPay_param_payment_token_type_DataJSON' => 'Payment token',
+  'object_inputPaymentCredentialsAndroidPay' => 'Android pay payment credentials',
+  'object_inputPaymentCredentialsAndroidPay_param_payment_token_type_DataJSON' => 'Android pay payment token',
   'object_inputPaymentCredentialsAndroidPay_param_google_transaction_id_type_string' => 'Google transaction ID',
-  'object_account.tmpPassword' => 'Tmp password',
-  'object_account.tmpPassword_param_tmp_password_type_bytes' => 'Tmp password',
-  'object_account.tmpPassword_param_valid_until_type_int' => 'Valid until',
+  'object_account.tmpPassword' => 'Temporary payment password',
+  'object_account.tmpPassword_param_tmp_password_type_bytes' => 'Temporary password',
+  'object_account.tmpPassword_param_valid_until_type_int' => 'Validity period',
   'object_shippingOption' => 'Shipping option',
-  'object_shippingOption_param_id_type_string' => 'ID',
+  'object_shippingOption_param_id_type_string' => 'Option ID',
   'object_shippingOption_param_title_type_string' => 'Title',
   'object_shippingOption_param_prices_type_Vector t' => 'Prices',
-  'object_inputStickerSetItem' => 'Sticker set item',
-  'object_inputStickerSetItem_param_document_type_InputDocument' => 'Document',
-  'object_inputStickerSetItem_param_emoji_type_string' => 'Emoji',
-  'object_inputStickerSetItem_param_mask_coords_type_MaskCoords' => 'Mask coords',
+  'object_inputStickerSetItem' => 'Sticker in a stickerset',
+  'object_inputStickerSetItem_param_document_type_InputDocument' => 'The sticker',
+  'object_inputStickerSetItem_param_emoji_type_string' => 'Associated emoji',
+  'object_inputStickerSetItem_param_mask_coords_type_MaskCoords' => 'Coordinates for mask sticker',
   'object_inputPhoneCall' => 'Phone call',
-  'object_inputPhoneCall_param_id_type_long' => 'ID',
+  'object_inputPhoneCall_param_id_type_long' => 'Call ID',
   'object_inputPhoneCall_param_access_hash_type_long' => 'Access hash',
-  'object_phoneCallEmpty' => 'Empty phone call',
-  'object_phoneCallEmpty_param_id_type_long' => 'ID',
-  'object_phoneCallWaiting' => 'Phone call waiting',
-  'object_phoneCallWaiting_param_id_type_long' => 'ID',
+  'object_phoneCallEmpty' => 'Empty constructor',
+  'object_phoneCallEmpty_param_id_type_long' => 'Call ID',
+  'object_phoneCallWaiting' => 'Incoming phone call',
+  'object_phoneCallWaiting_param_id_type_long' => 'Call ID',
   'object_phoneCallWaiting_param_access_hash_type_long' => 'Access hash',
   'object_phoneCallWaiting_param_date_type_int' => 'Date',
   'object_phoneCallWaiting_param_admin_id_type_int' => 'Admin ID',
   'object_phoneCallWaiting_param_participant_id_type_int' => 'Participant ID',
-  'object_phoneCallWaiting_param_protocol_type_PhoneCallProtocol' => 'Protocol',
-  'object_phoneCallWaiting_param_receive_date_type_int' => 'Receive date',
-  'object_phoneCallRequested' => 'Phone call requested',
-  'object_phoneCallRequested_param_id_type_long' => 'ID',
+  'object_phoneCallWaiting_param_protocol_type_PhoneCallProtocol' => 'Phone call protocol info',
+  'object_phoneCallWaiting_param_receive_date_type_int' => 'When was the phone call received',
+  'object_phoneCallRequested' => 'Requested phone call',
+  'object_phoneCallRequested_param_id_type_long' => 'Phone call ID',
   'object_phoneCallRequested_param_access_hash_type_long' => 'Access hash',
-  'object_phoneCallRequested_param_date_type_int' => 'Date',
-  'object_phoneCallRequested_param_admin_id_type_int' => 'Admin ID',
-  'object_phoneCallRequested_param_participant_id_type_int' => 'Participant ID',
-  'object_phoneCallRequested_param_g_a_hash_type_bytes' => 'G a hash',
-  'object_phoneCallRequested_param_protocol_type_PhoneCallProtocol' => 'Protocol',
-  'object_phoneCallAccepted' => 'Phone call accepted',
-  'object_phoneCallAccepted_param_id_type_long' => 'ID',
-  'object_phoneCallAccepted_param_access_hash_type_long' => 'Access hash',
-  'object_phoneCallAccepted_param_date_type_int' => 'Date',
-  'object_phoneCallAccepted_param_admin_id_type_int' => 'Admin ID',
-  'object_phoneCallAccepted_param_participant_id_type_int' => 'Participant ID',
-  'object_phoneCallAccepted_param_g_b_type_bytes' => 'G b',
-  'object_phoneCallAccepted_param_protocol_type_PhoneCallProtocol' => 'Protocol',
+  'object_phoneCallRequested_param_date_type_int' => 'When was the phone call created',
+  'object_phoneCallRequested_param_admin_id_type_int' => 'ID of the creator of the phone call',
+  'object_phoneCallRequested_param_participant_id_type_int' => 'ID of the other participant of the phone call',
+  'object_phoneCallRequested_param_g_a_hash_type_bytes' => '[Parameter for key exchange](https://core.telegram.org/api/end-to-end/voice-calls)',
+  'object_phoneCallRequested_param_protocol_type_PhoneCallProtocol' => 'Call protocol info to be passed to libtgvoip',
+  'object_phoneCallAccepted' => 'An accepted phone call',
+  'object_phoneCallAccepted_param_id_type_long' => 'ID of accepted phone call',
+  'object_phoneCallAccepted_param_access_hash_type_long' => 'Access hash of phone call',
+  'object_phoneCallAccepted_param_date_type_int' => 'When was the call accepted',
+  'object_phoneCallAccepted_param_admin_id_type_int' => 'ID of the call creator',
+  'object_phoneCallAccepted_param_participant_id_type_int' => 'ID of the other user in the call',
+  'object_phoneCallAccepted_param_g_b_type_bytes' => 'B parameter for [secure E2E phone call key exchange](https://core.telegram.org/api/end-to-end/voice-calls)',
+  'object_phoneCallAccepted_param_protocol_type_PhoneCallProtocol' => 'Protocol to use for phone call',
   'object_phoneCall' => 'Phone call',
-  'object_phoneCall_param_id_type_long' => 'ID',
+  'object_phoneCall_param_id_type_long' => 'Call ID',
   'object_phoneCall_param_access_hash_type_long' => 'Access hash',
-  'object_phoneCall_param_date_type_int' => 'Date',
-  'object_phoneCall_param_admin_id_type_int' => 'Admin ID',
-  'object_phoneCall_param_participant_id_type_int' => 'Participant ID',
-  'object_phoneCall_param_g_a_or_b_type_bytes' => 'G a or b',
-  'object_phoneCall_param_key_fingerprint_type_long' => 'Key fingerprint',
-  'object_phoneCall_param_protocol_type_PhoneCallProtocol' => 'Protocol',
+  'object_phoneCall_param_date_type_int' => 'Date of creation of the call',
+  'object_phoneCall_param_admin_id_type_int' => 'User ID of the creator of the call',
+  'object_phoneCall_param_participant_id_type_int' => 'User ID of the other participant in the call',
+  'object_phoneCall_param_g_a_or_b_type_bytes' => '[Parameter for key exchange](https://core.telegram.org/api/end-to-end/voice-calls)',
+  'object_phoneCall_param_key_fingerprint_type_long' => '[Key fingerprint](https://core.telegram.org/api/end-to-end/voice-calls)',
+  'object_phoneCall_param_protocol_type_PhoneCallProtocol' => 'Call protocol info to be passed to libtgvoip',
   'object_phoneCall_param_connection_type_PhoneConnection' => 'Connection',
   'object_phoneCall_param_alternative_connections_type_Vector t' => 'Alternative connections',
-  'object_phoneCall_param_start_date_type_int' => 'Start date',
-  'object_phoneCallDiscarded' => 'Phone call discarded',
-  'object_phoneCallDiscarded_param_need_rating_type_true' => 'Need rating?',
-  'object_phoneCallDiscarded_param_need_debug_type_true' => 'Need debug?',
-  'object_phoneCallDiscarded_param_id_type_long' => 'ID',
-  'object_phoneCallDiscarded_param_reason_type_PhoneCallDiscardReason' => 'Reason',
-  'object_phoneCallDiscarded_param_duration_type_int' => 'Duration',
-  'object_phoneConnection' => 'Phone connection',
-  'object_phoneConnection_param_id_type_long' => 'ID',
-  'object_phoneConnection_param_ip_type_string' => 'Ip',
-  'object_phoneConnection_param_ipv6_type_string' => 'Ipv6',
-  'object_phoneConnection_param_port_type_int' => 'Port',
-  'object_phoneConnection_param_peer_tag_type_bytes' => 'Peer tag',
-  'object_phoneCallProtocol' => 'Phone call protocol',
-  'object_phoneCallProtocol_param_udp_p2p_type_true' => 'Udp p2p?',
-  'object_phoneCallProtocol_param_udp_reflector_type_true' => 'Udp reflector?',
-  'object_phoneCallProtocol_param_min_layer_type_int' => 'Min layer',
-  'object_phoneCallProtocol_param_max_layer_type_int' => 'Max layer',
-  'object_phone.phoneCall' => 'Phone call',
-  'object_phone.phoneCall_param_phone_call_type_PhoneCall' => 'Phone call',
+  'object_phoneCall_param_start_date_type_int' => 'When was the call actually started',
+  'object_phoneCallDiscarded' => 'Indicates a discarded phone call',
+  'object_phoneCallDiscarded_param_need_rating_type_true' => 'Whether the server required the user to [rate](../methods/phone.setCallRating.md) the call',
+  'object_phoneCallDiscarded_param_need_debug_type_true' => 'Whether the server required the client to [send](../methods/phone.saveCallDebug.md) the libtgvoip call debug data',
+  'object_phoneCallDiscarded_param_id_type_long' => 'Call ID',
+  'object_phoneCallDiscarded_param_reason_type_PhoneCallDiscardReason' => 'Why was the phone call discarded',
+  'object_phoneCallDiscarded_param_duration_type_int' => 'Duration of the phone call in seconds',
+  'object_phoneConnection' => 'Identifies an endpoint that can be used to connect to the other user in a phone call',
+  'object_phoneConnection_param_id_type_long' => 'Endpoint ID',
+  'object_phoneConnection_param_ip_type_string' => 'IP address of endpoint',
+  'object_phoneConnection_param_ipv6_type_string' => 'IPv6 address of endpoint',
+  'object_phoneConnection_param_port_type_int' => 'Port ID',
+  'object_phoneConnection_param_peer_tag_type_bytes' => 'Our peer tag',
+  'object_phoneCallProtocol' => 'Protocol info for libtgvoip',
+  'object_phoneCallProtocol_param_udp_p2p_type_true' => 'Whether to allow P2P connection to the other participant',
+  'object_phoneCallProtocol_param_udp_reflector_type_true' => 'Whether to allow connection to the other participants through the reflector servers',
+  'object_phoneCallProtocol_param_min_layer_type_int' => 'Minimum layer for remote libtgvoip',
+  'object_phoneCallProtocol_param_max_layer_type_int' => 'Maximum layer for remote libtgvoip',
+  'object_phone.phoneCall' => 'A VoIP phone call',
+  'object_phone.phoneCall_param_phone_call_type_PhoneCall' => 'The VoIP phone call',
   'object_phone.phoneCall_param_users_type_Vector t' => 'Users',
-  'object_upload.cdnFileReuploadNeeded' => 'Cdn file reupload needed',
-  'object_upload.cdnFileReuploadNeeded_param_request_token_type_bytes' => 'Request token',
-  'object_upload.cdnFile' => 'Cdn file',
-  'object_upload.cdnFile_param_bytes_type_bytes' => 'Bytes',
-  'object_cdnPublicKey' => 'Cdn public key',
-  'object_cdnPublicKey_param_dc_id_type_int' => 'DC ID',
-  'object_cdnPublicKey_param_public_key_type_string' => 'Public key',
-  'object_cdnConfig' => 'CDN configuration',
+  'object_upload.cdnFileReuploadNeeded' => 'The file was cleared from the temporary RAM cache of the [CDN](https://core.telegram.org/cdn) and has to be reuploaded.',
+  'object_upload.cdnFileReuploadNeeded_param_request_token_type_bytes' => 'Request token (see [CDN](https://core.telegram.org/cdn))',
+  'object_upload.cdnFile' => 'Represent a chunk of a [CDN](https://core.telegram.org/cdn) file.',
+  'object_upload.cdnFile_param_bytes_type_bytes' => 'The data',
+  'object_cdnPublicKey' => 'Public key to use **only** during handshakes to [CDN](https://core.telegram.org/cdn) DCs.',
+  'object_cdnPublicKey_param_dc_id_type_int' => '[CDN DC](https://core.telegram.org/cdn) ID',
+  'object_cdnPublicKey_param_public_key_type_string' => 'RSA public key',
+  'object_cdnConfig' => 'Configuration for [CDN](https://core.telegram.org/cdn) file downloads.',
   'object_cdnConfig_param_public_keys_type_Vector t' => 'Public keys',
-  'object_langPackString' => 'Lang pack string',
-  'object_langPackString_param_key_type_string' => 'Key',
+  'object_langPackString' => 'Translated localization string',
+  'object_langPackString_param_key_type_string' => 'Language key',
   'object_langPackString_param_value_type_string' => 'Value',
-  'object_langPackStringPluralized' => 'Lang pack string pluralized',
-  'object_langPackStringPluralized_param_key_type_string' => 'Key',
-  'object_langPackStringPluralized_param_zero_value_type_string' => 'Zero value',
-  'object_langPackStringPluralized_param_one_value_type_string' => 'One value',
-  'object_langPackStringPluralized_param_two_value_type_string' => 'Two value',
-  'object_langPackStringPluralized_param_few_value_type_string' => 'Few value',
-  'object_langPackStringPluralized_param_many_value_type_string' => 'Many value',
-  'object_langPackStringPluralized_param_other_value_type_string' => 'Other value',
-  'object_langPackStringDeleted' => 'Lang pack string deleted',
-  'object_langPackStringDeleted_param_key_type_string' => 'Key',
-  'object_langPackDifference' => 'Lang pack difference',
-  'object_langPackDifference_param_lang_code_type_string' => 'Lang code',
-  'object_langPackDifference_param_from_version_type_int' => 'From version',
-  'object_langPackDifference_param_version_type_int' => 'Version',
+  'object_langPackStringPluralized' => 'A language pack string which has different forms based on the number of some object it mentions. See [https://www.unicode.org/cldr/charts/latest/supplemental/language\\_plural\\_rules.html](https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html) for more info',
+  'object_langPackStringPluralized_param_key_type_string' => 'Localization key',
+  'object_langPackStringPluralized_param_zero_value_type_string' => 'Value for zero objects',
+  'object_langPackStringPluralized_param_one_value_type_string' => 'Value for one object',
+  'object_langPackStringPluralized_param_two_value_type_string' => 'Value for two objects',
+  'object_langPackStringPluralized_param_few_value_type_string' => 'Value for a few objects',
+  'object_langPackStringPluralized_param_many_value_type_string' => 'Value for many objects',
+  'object_langPackStringPluralized_param_other_value_type_string' => 'Default value',
+  'object_langPackStringDeleted' => 'Deleted localization string',
+  'object_langPackStringDeleted_param_key_type_string' => 'Localization key',
+  'object_langPackDifference' => 'Changes to the app\'s localization pack',
+  'object_langPackDifference_param_lang_code_type_string' => 'Language code',
+  'object_langPackDifference_param_from_version_type_int' => 'Previous version number',
+  'object_langPackDifference_param_version_type_int' => 'New version number',
   'object_langPackDifference_param_strings_type_Vector t' => 'Strings',
-  'object_langPackLanguage' => 'Lang pack language',
-  'object_langPackLanguage_param_name_type_string' => 'Name',
-  'object_langPackLanguage_param_native_name_type_string' => 'Native name',
-  'object_langPackLanguage_param_lang_code_type_string' => 'Lang code',
+  'object_langPackLanguage' => 'Identifies a localization pack',
+  'object_langPackLanguage_param_name_type_string' => 'Language name',
+  'object_langPackLanguage_param_native_name_type_string' => 'Language name in the language itself',
+  'object_langPackLanguage_param_lang_code_type_string' => 'Language code (pack identifier)',
   'object_channelAdminRights' => 'Admin rights',
   'object_channelAdminRights_param_change_info_type_true' => 'Change info',
   'object_channelAdminRights_param_post_messages_type_true' => 'Post messages',
@@ -8464,120 +8866,120 @@ class Lang
   'object_channelBannedRights_param_send_inline_type_true' => 'Disallow sending inline keyboards',
   'object_channelBannedRights_param_embed_links_type_true' => 'Disallow embedding links',
   'object_channelBannedRights_param_until_date_type_int' => 'Until date',
-  'object_channelAdminLogEventActionChangeTitle' => 'Change title',
-  'object_channelAdminLogEventActionChangeTitle_param_prev_value_type_string' => 'Previous value',
-  'object_channelAdminLogEventActionChangeTitle_param_new_value_type_string' => 'New value',
-  'object_channelAdminLogEventActionChangeAbout' => 'Change about text',
-  'object_channelAdminLogEventActionChangeAbout_param_prev_value_type_string' => 'Previous value',
-  'object_channelAdminLogEventActionChangeAbout_param_new_value_type_string' => 'New value',
-  'object_channelAdminLogEventActionChangeUsername' => 'Change username',
-  'object_channelAdminLogEventActionChangeUsername_param_prev_value_type_string' => 'Prev value',
-  'object_channelAdminLogEventActionChangeUsername_param_new_value_type_string' => 'New value',
-  'object_channelAdminLogEventActionChangePhoto' => 'Change photo',
+  'object_channelAdminLogEventActionChangeTitle' => 'Channel/supergroup title was changed',
+  'object_channelAdminLogEventActionChangeTitle_param_prev_value_type_string' => 'Previous title',
+  'object_channelAdminLogEventActionChangeTitle_param_new_value_type_string' => 'New title',
+  'object_channelAdminLogEventActionChangeAbout' => 'The description was changed',
+  'object_channelAdminLogEventActionChangeAbout_param_prev_value_type_string' => 'Previous description',
+  'object_channelAdminLogEventActionChangeAbout_param_new_value_type_string' => 'New description',
+  'object_channelAdminLogEventActionChangeUsername' => 'Channel/supergroup username was changed',
+  'object_channelAdminLogEventActionChangeUsername_param_prev_value_type_string' => 'Old username',
+  'object_channelAdminLogEventActionChangeUsername_param_new_value_type_string' => 'New username',
+  'object_channelAdminLogEventActionChangePhoto' => 'The channel/supergroup\'s picture was changed',
   'object_channelAdminLogEventActionChangePhoto_param_prev_photo_type_ChatPhoto' => 'Previous photo',
   'object_channelAdminLogEventActionChangePhoto_param_new_photo_type_ChatPhoto' => 'New photo',
-  'object_channelAdminLogEventActionToggleInvites' => 'Invite setting toggled',
+  'object_channelAdminLogEventActionToggleInvites' => 'Invites were enabled/disabled',
   'object_channelAdminLogEventActionToggleInvites_param_new_value_type_Bool' => 'New value',
-  'object_channelAdminLogEventActionToggleSignatures' => 'Toggle channel signatures',
-  'object_channelAdminLogEventActionToggleSignatures_param_new_value_type_Bool' => 'New value?',
-  'object_channelAdminLogEventActionUpdatePinned' => 'Message pinned',
-  'object_channelAdminLogEventActionUpdatePinned_param_message_type_Message' => 'Message',
-  'object_channelAdminLogEventActionEditMessage' => 'Edit message',
-  'object_channelAdminLogEventActionEditMessage_param_prev_message_type_Message' => 'Prev message',
+  'object_channelAdminLogEventActionToggleSignatures' => 'Channel signatures were enabled/disabled',
+  'object_channelAdminLogEventActionToggleSignatures_param_new_value_type_Bool' => 'New value',
+  'object_channelAdminLogEventActionUpdatePinned' => 'A message was pinned',
+  'object_channelAdminLogEventActionUpdatePinned_param_message_type_Message' => 'The message that was pinned',
+  'object_channelAdminLogEventActionEditMessage' => 'A message was edited',
+  'object_channelAdminLogEventActionEditMessage_param_prev_message_type_Message' => 'Old message',
   'object_channelAdminLogEventActionEditMessage_param_new_message_type_Message' => 'New message',
-  'object_channelAdminLogEventActionDeleteMessage' => 'Delete message',
-  'object_channelAdminLogEventActionDeleteMessage_param_message_type_Message' => 'Message',
-  'object_channelAdminLogEventActionParticipantJoin' => 'Joined participant',
-  'object_channelAdminLogEventActionParticipantLeave' => 'Left participant',
-  'object_channelAdminLogEventActionParticipantInvite' => 'Invite participant',
-  'object_channelAdminLogEventActionParticipantInvite_param_participant_type_ChannelParticipant' => 'Participant',
-  'object_channelAdminLogEventActionParticipantToggleBan' => 'User banned',
-  'object_channelAdminLogEventActionParticipantToggleBan_param_prev_participant_type_ChannelParticipant' => 'Prev participant',
-  'object_channelAdminLogEventActionParticipantToggleBan_param_new_participant_type_ChannelParticipant' => 'New participant',
-  'object_channelAdminLogEventActionParticipantToggleAdmin' => 'Admin toggled',
-  'object_channelAdminLogEventActionParticipantToggleAdmin_param_prev_participant_type_ChannelParticipant' => 'Prev participant',
-  'object_channelAdminLogEventActionParticipantToggleAdmin_param_new_participant_type_ChannelParticipant' => 'New participant',
-  'object_channelAdminLogEventActionChangeStickerSet' => 'Change stickerset',
+  'object_channelAdminLogEventActionDeleteMessage' => 'A message was deleted',
+  'object_channelAdminLogEventActionDeleteMessage_param_message_type_Message' => 'The message that was deleted',
+  'object_channelAdminLogEventActionParticipantJoin' => 'A user has joined the group (in the case of big groups, info of the user that has joined isn\'t shown)',
+  'object_channelAdminLogEventActionParticipantLeave' => 'A user left the channel/supergroup (in the case of big groups, info of the user that has joined isn\'t shown)',
+  'object_channelAdminLogEventActionParticipantInvite' => 'A user was invited to the group',
+  'object_channelAdminLogEventActionParticipantInvite_param_participant_type_ChannelParticipant' => 'The user that was invited',
+  'object_channelAdminLogEventActionParticipantToggleBan' => 'The banned [rights](https://core.telegram.org/api/rights) of a user were changed',
+  'object_channelAdminLogEventActionParticipantToggleBan_param_prev_participant_type_ChannelParticipant' => 'Old banned rights of user',
+  'object_channelAdminLogEventActionParticipantToggleBan_param_new_participant_type_ChannelParticipant' => 'New banned rights of user',
+  'object_channelAdminLogEventActionParticipantToggleAdmin' => 'The admin [rights](https://core.telegram.org/api/rights) of a user were changed',
+  'object_channelAdminLogEventActionParticipantToggleAdmin_param_prev_participant_type_ChannelParticipant' => 'Previous admin rights',
+  'object_channelAdminLogEventActionParticipantToggleAdmin_param_new_participant_type_ChannelParticipant' => 'New admin rights',
+  'object_channelAdminLogEventActionChangeStickerSet' => 'The supergroup\'s stickerset was changed',
   'object_channelAdminLogEventActionChangeStickerSet_param_prev_stickerset_type_InputStickerSet' => 'Previous stickerset',
   'object_channelAdminLogEventActionChangeStickerSet_param_new_stickerset_type_InputStickerSet' => 'New stickerset',
-  'object_channelAdminLogEventActionTogglePreHistoryHidden' => 'Previous history hidden',
+  'object_channelAdminLogEventActionTogglePreHistoryHidden' => 'The hidden prehistory setting was [changed](../methods/channels.togglePreHistoryHidden.md)',
   'object_channelAdminLogEventActionTogglePreHistoryHidden_param_new_value_type_Bool' => 'New value',
-  'object_channelAdminLogEvent' => 'Channel admin log event',
-  'object_channelAdminLogEvent_param_id_type_long' => 'ID',
+  'object_channelAdminLogEvent' => 'Admin log event',
+  'object_channelAdminLogEvent_param_id_type_long' => 'Event ID',
   'object_channelAdminLogEvent_param_date_type_int' => 'Date',
   'object_channelAdminLogEvent_param_user_id_type_int' => 'User ID',
   'object_channelAdminLogEvent_param_action_type_ChannelAdminLogEventAction' => 'Action',
-  'object_channels.adminLogResults' => 'Admin log results',
+  'object_channels.adminLogResults' => 'Admin log events',
   'object_channels.adminLogResults_param_events_type_Vector t' => 'Events',
   'object_channels.adminLogResults_param_chats_type_Vector t' => 'Chats',
   'object_channels.adminLogResults_param_users_type_Vector t' => 'Users',
-  'object_channelAdminLogEventsFilter' => 'Event filter',
-  'object_channelAdminLogEventsFilter_param_join_type_true' => 'Join users events',
-  'object_channelAdminLogEventsFilter_param_leave_type_true' => 'Left users events',
-  'object_channelAdminLogEventsFilter_param_invite_type_true' => 'Invite users events',
-  'object_channelAdminLogEventsFilter_param_ban_type_true' => 'Ban events',
-  'object_channelAdminLogEventsFilter_param_unban_type_true' => 'Unban events',
-  'object_channelAdminLogEventsFilter_param_kick_type_true' => 'Kicked users events',
-  'object_channelAdminLogEventsFilter_param_unkick_type_true' => 'Unkick events',
-  'object_channelAdminLogEventsFilter_param_promote_type_true' => 'Admin promotion events',
-  'object_channelAdminLogEventsFilter_param_demote_type_true' => 'Demote admin events',
-  'object_channelAdminLogEventsFilter_param_info_type_true' => 'Change info events',
-  'object_channelAdminLogEventsFilter_param_settings_type_true' => 'Setting changes',
-  'object_channelAdminLogEventsFilter_param_pinned_type_true' => 'Pinned message events',
-  'object_channelAdminLogEventsFilter_param_edit_type_true' => 'Edit message events',
-  'object_channelAdminLogEventsFilter_param_delete_type_true' => 'Delete message events',
+  'object_channelAdminLogEventsFilter' => 'Filter only certain admin log events',
+  'object_channelAdminLogEventsFilter_param_join_type_true' => '[Join events](../constructors/channelAdminLogEventActionParticipantJoin.md)',
+  'object_channelAdminLogEventsFilter_param_leave_type_true' => '[Leave events](../constructors/channelAdminLogEventActionParticipantLeave.md)',
+  'object_channelAdminLogEventsFilter_param_invite_type_true' => '[Invite events](../constructors/channelAdminLogEventActionParticipantInvite.md)',
+  'object_channelAdminLogEventsFilter_param_ban_type_true' => '[Ban events](../constructors/channelAdminLogEventActionParticipantToggleBan.md)',
+  'object_channelAdminLogEventsFilter_param_unban_type_true' => '[Unban events](../constructors/channelAdminLogEventActionParticipantToggleBan.md)',
+  'object_channelAdminLogEventsFilter_param_kick_type_true' => '[Kick events](../constructors/channelAdminLogEventActionParticipantToggleBan.md)',
+  'object_channelAdminLogEventsFilter_param_unkick_type_true' => '[Unkick events](../constructors/channelAdminLogEventActionParticipantToggleBan.md)',
+  'object_channelAdminLogEventsFilter_param_promote_type_true' => '[Admin promotion events](../constructors/channelAdminLogEventActionParticipantToggleAdmin.md)',
+  'object_channelAdminLogEventsFilter_param_demote_type_true' => '[Admin demotion events](../constructors/channelAdminLogEventActionParticipantToggleAdmin.md)',
+  'object_channelAdminLogEventsFilter_param_info_type_true' => 'Info change events (when [about](../constructors/channelAdminLogEventActionChangeAbout.md), [linked chat](../constructors/channelAdminLogEventActionChangeLinkedChat.md), [location](../constructors/channelAdminLogEventActionChangeLocation.md), [photo](../constructors/channelAdminLogEventActionChangePhoto.md), [stickerset](../constructors/channelAdminLogEventActionChangeStickerSet.md), [title](../constructors/channelAdminLogEventActionChangeTitle.md) or [username](../constructors/channelAdminLogEventActionChangeUsername.md) data of a channel gets modified)',
+  'object_channelAdminLogEventsFilter_param_settings_type_true' => 'Settings change events ([invites](../constructors/channelAdminLogEventActionToggleInvites.md), [hidden prehistory](../constructors/channelAdminLogEventActionTogglePreHistoryHidden.md), [signatures](../constructors/channelAdminLogEventActionToggleSignatures.md), [default banned rights](../constructors/channelAdminLogEventActionDefaultBannedRights.md))',
+  'object_channelAdminLogEventsFilter_param_pinned_type_true' => '[Message pin events](../constructors/channelAdminLogEventActionUpdatePinned.md)',
+  'object_channelAdminLogEventsFilter_param_edit_type_true' => '[Message edit events](../constructors/channelAdminLogEventActionEditMessage.md)',
+  'object_channelAdminLogEventsFilter_param_delete_type_true' => '[Message deletion events](../constructors/channelAdminLogEventActionDeleteMessage.md)',
   'object_popularContact' => 'Popular contact',
-  'object_popularContact_param_client_id_type_long' => 'Client ID',
-  'object_popularContact_param_importers_type_int' => 'Importers',
+  'object_popularContact_param_client_id_type_long' => 'Contact identifier',
+  'object_popularContact_param_importers_type_int' => 'How many people imported this contact',
   'object_cdnFileHash' => 'CDN file hash',
   'object_cdnFileHash_param_offset_type_int' => 'Offset',
   'object_cdnFileHash_param_limit_type_int' => 'Limit',
   'object_cdnFileHash_param_hash_type_bytes' => 'Hash',
-  'object_messages.favedStickersNotModified' => 'Faved stickers not modified',
-  'object_messages.favedStickers' => 'Faved stickers',
-  'object_messages.favedStickers_param_hash_type_int' => 'Hash',
+  'object_messages.favedStickersNotModified' => 'No new favorited stickers were found',
+  'object_messages.favedStickers' => 'Favorited stickers',
+  'object_messages.favedStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
   'object_messages.favedStickers_param_packs_type_Vector t' => 'Packs',
   'object_messages.favedStickers_param_stickers_type_Vector t' => 'Stickers',
-  'object_recentMeUrlUnknown' => 'Recent me URL unknown',
+  'object_recentMeUrlUnknown' => 'Unknown t.me url',
   'object_recentMeUrlUnknown_param_url_type_string' => 'URL',
-  'object_recentMeUrlUser' => 'Recent me URL user',
+  'object_recentMeUrlUser' => 'Recent t.me link to a user',
   'object_recentMeUrlUser_param_url_type_string' => 'URL',
   'object_recentMeUrlUser_param_user_id_type_int' => 'User ID',
-  'object_recentMeUrlChat' => 'Recent me URL chat',
-  'object_recentMeUrlChat_param_url_type_string' => 'URL',
+  'object_recentMeUrlChat' => 'Recent t.me link to a chat',
+  'object_recentMeUrlChat_param_url_type_string' => 't.me URL',
   'object_recentMeUrlChat_param_chat_id_type_int' => 'Chat ID',
-  'object_recentMeUrlChatInvite' => 'Recent me URL chat invite',
-  'object_recentMeUrlChatInvite_param_url_type_string' => 'URL',
-  'object_recentMeUrlChatInvite_param_chat_invite_type_ChatInvite' => 'Chat invite',
-  'object_recentMeUrlStickerSet' => 'Recent me URL sticker set',
-  'object_recentMeUrlStickerSet_param_url_type_string' => 'URL',
-  'object_recentMeUrlStickerSet_param_set_type_StickerSetCovered' => 'Set',
-  'object_help.recentMeUrls' => 'Recent me URLs',
+  'object_recentMeUrlChatInvite' => 'Recent t.me invite link to a chat',
+  'object_recentMeUrlChatInvite_param_url_type_string' => 't.me URL',
+  'object_recentMeUrlChatInvite_param_chat_invite_type_ChatInvite' => 'Chat invitation',
+  'object_recentMeUrlStickerSet' => 'Recent t.me stickerset installation URL',
+  'object_recentMeUrlStickerSet_param_url_type_string' => 't.me URL',
+  'object_recentMeUrlStickerSet_param_set_type_StickerSetCovered' => 'Stickerset',
+  'object_help.recentMeUrls' => 'Recent t.me URLs',
   'object_help.recentMeUrls_param_urls_type_Vector t' => 'URLs',
   'object_help.recentMeUrls_param_chats_type_Vector t' => 'Chats',
   'object_help.recentMeUrls_param_users_type_Vector t' => 'Users',
-  'object_inputSingleMedia' => 'Single media',
-  'object_inputSingleMedia_param_media_type_InputMedia' => 'Media',
-  'object_inputSingleMedia_param_message_type_string' => 'Message',
+  'object_inputSingleMedia' => 'A single media in an album sent with [messages.sendMultiMedia](../methods/messages.sendMultiMedia.md).',
+  'object_inputSingleMedia_param_media_type_InputMedia' => 'The media',
+  'object_inputSingleMedia_param_message_type_string' => 'A caption for the media',
   'object_inputSingleMedia_param_entities_type_Vector t' => 'Entities',
-  'object_webAuthorization' => 'Web authorization',
-  'object_webAuthorization_param_hash_type_long' => 'Hash',
+  'object_webAuthorization' => 'Represents a bot logged in using the [Telegram login widget](https://core.telegram.org/widgets/login)',
+  'object_webAuthorization_param_hash_type_long' => 'Authorization hash',
   'object_webAuthorization_param_bot_id_type_int' => 'Bot ID',
-  'object_webAuthorization_param_domain_type_string' => 'Domain',
-  'object_webAuthorization_param_browser_type_string' => 'Browser',
+  'object_webAuthorization_param_domain_type_string' => 'The domain name of the website on which the user has logged in.',
+  'object_webAuthorization_param_browser_type_string' => 'Browser user-agent',
   'object_webAuthorization_param_platform_type_string' => 'Platform',
-  'object_webAuthorization_param_date_created_type_int' => 'Date created',
-  'object_webAuthorization_param_date_active_type_int' => 'Date active',
-  'object_webAuthorization_param_ip_type_string' => 'Ip',
-  'object_webAuthorization_param_region_type_string' => 'Region',
-  'object_account.webAuthorizations' => 'Telegram login authorizations',
+  'object_webAuthorization_param_date_created_type_int' => 'When was the web session created',
+  'object_webAuthorization_param_date_active_type_int' => 'When was the web session last active',
+  'object_webAuthorization_param_ip_type_string' => 'IP address',
+  'object_webAuthorization_param_region_type_string' => 'Region, determined from IP address',
+  'object_account.webAuthorizations' => 'Web authorizations',
   'object_account.webAuthorizations_param_authorizations_type_Vector t' => 'Authorizations',
   'object_account.webAuthorizations_param_users_type_Vector t' => 'Users',
-  'object_inputMessageID' => 'Message ID',
-  'object_inputMessageID_param_id_type_int' => 'ID',
-  'object_inputMessageReplyTo' => 'Message reply to',
-  'object_inputMessageReplyTo_param_id_type_int' => 'ID',
-  'object_inputMessagePinned' => 'Message pinned',
+  'object_inputMessageID' => 'Message by ID',
+  'object_inputMessageID_param_id_type_int' => 'Message ID',
+  'object_inputMessageReplyTo' => 'Message to which the specified message replies to',
+  'object_inputMessageReplyTo_param_id_type_int' => 'ID of the message that replies to the message we need',
+  'object_inputMessagePinned' => 'Pinned message',
   'object_decryptedDataBlock' => 'Decrypted data block',
   'object_decryptedDataBlock_param_voice_call_id_type_int128' => 'Voice call ID',
   'object_decryptedDataBlock_param_in_seq_no_type_int' => 'In seq no',
@@ -8588,85 +8990,87 @@ class Lang
   'object_decryptedDataBlock_param_raw_data_type_string' => 'Raw data',
   'object_simpleDataBlock' => 'Simple data block',
   'object_simpleDataBlock_param_raw_data_type_string' => 'Raw data',
-  'object_decryptedMessage' => 'Decrypted message',
-  'object_decryptedMessage_param_message_type_string' => 'Message',
-  'object_decryptedMessage_param_media_type_DecryptedMessageMedia' => 'Media',
-  'object_decryptedMessageService' => 'Decrypted message service',
-  'object_decryptedMessageService_param_action_type_DecryptedMessageAction' => 'Action',
-  'object_decryptedMessageMediaEmpty' => 'Empty decrypted message media',
-  'object_decryptedMessageMediaPhoto' => 'Decrypted message media photo',
-  'object_decryptedMessageMediaPhoto_param_thumb_type_bytes' => 'Thumbnail',
+  'object_decryptedMessage' => 'Contents of an encrypted message.',
+  'object_decryptedMessage_param_message_type_string' => 'Message text',
+  'object_decryptedMessage_param_media_type_DecryptedMessageMedia' => 'Media content',
+  'object_decryptedMessageService' => 'Contents of an encrypted service message.',
+  'object_decryptedMessageService_param_action_type_DecryptedMessageAction' => 'Action relevant to the service message',
+  'object_decryptedMessageMediaEmpty' => 'Empty constructor, no media content.',
+  'object_decryptedMessageMediaPhoto' => 'Photo attached to an encrypted message.',
+  'object_decryptedMessageMediaPhoto_param_thumb_type_bytes' => 'Content of thumbnail file (JPEGfile, quality 55, set in a square 90x90)',
   'object_decryptedMessageMediaPhoto_param_thumb_w_type_int' => 'Thumbnail width',
   'object_decryptedMessageMediaPhoto_param_thumb_h_type_int' => 'Thumbnail height',
-  'object_decryptedMessageMediaPhoto_param_w_type_int' => 'Width',
-  'object_decryptedMessageMediaPhoto_param_h_type_int' => 'Height',
-  'object_decryptedMessageMediaPhoto_param_size_type_int' => 'Size',
-  'object_decryptedMessageMediaVideo' => 'Decrypted message media video',
-  'object_decryptedMessageMediaVideo_param_thumb_type_bytes' => 'Thumbnail',
+  'object_decryptedMessageMediaPhoto_param_w_type_int' => 'Photo width',
+  'object_decryptedMessageMediaPhoto_param_h_type_int' => 'Photo height',
+  'object_decryptedMessageMediaPhoto_param_size_type_int' => 'Size of the photo in bytes',
+  'object_decryptedMessageMediaVideo' => 'Video attached to an encrypted message.',
+  'object_decryptedMessageMediaVideo_param_thumb_type_bytes' => 'Content of thumbnail file (JPEG file, quality 55, set in a square 90x90)',
   'object_decryptedMessageMediaVideo_param_thumb_w_type_int' => 'Thumbnail width',
   'object_decryptedMessageMediaVideo_param_thumb_h_type_int' => 'Thumbnail height',
-  'object_decryptedMessageMediaVideo_param_duration_type_int' => 'Duration',
-  'object_decryptedMessageMediaVideo_param_w_type_int' => 'Width',
-  'object_decryptedMessageMediaVideo_param_h_type_int' => 'Height',
-  'object_decryptedMessageMediaVideo_param_size_type_int' => 'Size',
-  'object_decryptedMessageMediaGeoPoint' => 'Decrypted message media geo point',
-  'object_decryptedMessageMediaGeoPoint_param_lat_type_double' => 'Lat',
-  'object_decryptedMessageMediaGeoPoint_param_long_type_double' => 'Long',
-  'object_decryptedMessageMediaContact' => 'Decrypted message media contact',
+  'object_decryptedMessageMediaVideo_param_duration_type_int' => 'Duration of video in seconds',
+  'object_decryptedMessageMediaVideo_param_w_type_int' => 'Image width',
+  'object_decryptedMessageMediaVideo_param_h_type_int' => 'Image height',
+  'object_decryptedMessageMediaVideo_param_size_type_int' => 'File size',
+  'object_decryptedMessageMediaGeoPoint' => 'GeoPont attached to an encrypted message.',
+  'object_decryptedMessageMediaGeoPoint_param_lat_type_double' => 'Latitude of point',
+  'object_decryptedMessageMediaGeoPoint_param_long_type_double' => 'Longtitude of point',
+  'object_decryptedMessageMediaContact' => 'Contact attached to an encrypted message.',
   'object_decryptedMessageMediaContact_param_phone_number_type_string' => 'Phone number',
-  'object_decryptedMessageMediaContact_param_first_name_type_string' => 'First name',
-  'object_decryptedMessageMediaContact_param_last_name_type_string' => 'Last name',
-  'object_decryptedMessageMediaContact_param_user_id_type_int' => 'User ID',
-  'object_decryptedMessageActionSetMessageTTL' => 'Decrypted message action set message ttl',
-  'object_decryptedMessageActionSetMessageTTL_param_ttl_seconds_type_int' => 'Ttl seconds',
-  'object_decryptedMessageMediaDocument' => 'Decrypted message media document',
-  'object_decryptedMessageMediaDocument_param_thumb_type_bytes' => 'Thumbnail',
-  'object_decryptedMessageMediaDocument_param_thumb_w_type_int' => 'Thumbnail w',
-  'object_decryptedMessageMediaDocument_param_thumb_h_type_int' => 'Thumbnail h',
+  'object_decryptedMessageMediaContact_param_first_name_type_string' => 'Contact\'s first name',
+  'object_decryptedMessageMediaContact_param_last_name_type_string' => 'Contact\'s last name',
+  'object_decryptedMessageMediaContact_param_user_id_type_int' => 'Telegram User ID of signed-up contact',
+  'object_decryptedMessageActionSetMessageTTL' => 'Setting of a message lifetime after reading.
+
+Upon receiving such message the client shall start deleting of all messages of an encrypted chat **ttl\\_seconds** seconds after the messages were read by user.',
+  'object_decryptedMessageActionSetMessageTTL_param_ttl_seconds_type_int' => 'Lifetime in seconds',
+  'object_decryptedMessageMediaDocument' => 'Document attached to a message in a secret chat.',
+  'object_decryptedMessageMediaDocument_param_thumb_type_bytes' => 'Thumbnail-file contents (JPEG-file, quality 55, set in a 90x90 square)',
+  'object_decryptedMessageMediaDocument_param_thumb_w_type_int' => 'Thumbnail width',
+  'object_decryptedMessageMediaDocument_param_thumb_h_type_int' => 'Thumbnail height',
   'object_decryptedMessageMediaDocument_param_file_name_type_string' => 'File name',
-  'object_decryptedMessageMediaDocument_param_mime_type_type_string' => 'Mime type',
-  'object_decryptedMessageMediaDocument_param_size_type_int' => 'Size',
-  'object_decryptedMessageMediaAudio' => 'Decrypted message media audio',
-  'object_decryptedMessageMediaAudio_param_duration_type_int' => 'Duration',
-  'object_decryptedMessageMediaAudio_param_size_type_int' => 'Size',
-  'object_decryptedMessageActionReadMessages' => 'Decrypted message action read messages',
+  'object_decryptedMessageMediaDocument_param_mime_type_type_string' => 'File MIME-type',
+  'object_decryptedMessageMediaDocument_param_size_type_int' => 'Document size',
+  'object_decryptedMessageMediaAudio' => 'Audio file attached to a secret chat message.',
+  'object_decryptedMessageMediaAudio_param_duration_type_int' => 'Audio duration in seconds',
+  'object_decryptedMessageMediaAudio_param_size_type_int' => 'File size',
+  'object_decryptedMessageActionReadMessages' => 'Messages marked as read.',
   'object_decryptedMessageActionReadMessages_param_random_ids_type_Vector t' => 'Random IDs',
-  'object_decryptedMessageActionDeleteMessages' => 'Decrypted message action delete messages',
+  'object_decryptedMessageActionDeleteMessages' => 'Deleted messages.',
   'object_decryptedMessageActionDeleteMessages_param_random_ids_type_Vector t' => 'Random IDs',
-  'object_decryptedMessageActionScreenshotMessages' => 'Decrypted message action screenshot messages',
+  'object_decryptedMessageActionScreenshotMessages' => 'A screenshot was taken.',
   'object_decryptedMessageActionScreenshotMessages_param_random_ids_type_Vector t' => 'Random IDs',
-  'object_decryptedMessageActionFlushHistory' => 'Decrypted message action flush history',
-  'object_decryptedMessage_param_ttl_type_int' => 'Ttl',
-  'object_decryptedMessageMediaVideo_param_mime_type_type_string' => 'Mime type',
-  'object_decryptedMessageMediaAudio_param_mime_type_type_string' => 'Mime type',
-  'object_decryptedMessageLayer' => 'Decrypted message layer',
-  'object_decryptedMessageLayer_param_layer_type_int' => 'Layer',
-  'object_decryptedMessageLayer_param_in_seq_no_type_int' => 'In seq no',
-  'object_decryptedMessageLayer_param_out_seq_no_type_int' => 'Out seq no',
-  'object_decryptedMessageLayer_param_message_type_DecryptedMessage' => 'Message',
-  'object_decryptedMessageActionResend' => 'Decrypted message action resend',
-  'object_decryptedMessageActionResend_param_start_seq_no_type_int' => 'Start seq no',
-  'object_decryptedMessageActionResend_param_end_seq_no_type_int' => 'End seq no',
-  'object_decryptedMessageActionNotifyLayer' => 'Decrypted message action notify layer',
-  'object_decryptedMessageActionNotifyLayer_param_layer_type_int' => 'Layer',
-  'object_decryptedMessageActionTyping' => 'Decrypted message action typing',
-  'object_decryptedMessageActionTyping_param_action_type_SendMessageAction' => 'Action',
-  'object_decryptedMessageActionRequestKey' => 'Decrypted message action request key',
+  'object_decryptedMessageActionFlushHistory' => 'The entire message history has been deleted.',
+  'object_decryptedMessage_param_ttl_type_int' => 'Message lifetime. Has higher priority than [decryptedMessageActionSetMessageTTL](../constructors/decryptedMessageActionSetMessageTTL.md).
Parameter added in [Layer 17](https://core.telegram.org/api/layers#layer-17).',
+  'object_decryptedMessageMediaVideo_param_mime_type_type_string' => 'MIME-type of the video file
Parameter added in [Layer 17](https://core.telegram.org/api/layers#layer-17).',
+  'object_decryptedMessageMediaAudio_param_mime_type_type_string' => 'MIME-type of the audio file
Parameter added in [Layer 13](https://core.telegram.org/api/layers#layer-13).',
+  'object_decryptedMessageLayer' => 'Sets the layer number for the contents of an encrypted message.',
+  'object_decryptedMessageLayer_param_layer_type_int' => 'Layer number. Mimimal value - **17** (the layer in which the constructor was added).',
+  'object_decryptedMessageLayer_param_in_seq_no_type_int' => '2x the number of messages in the sender\'s inbox (including deleted and service messages), incremented by 1 if current user was not the chat creator
Parameter added in [Layer 17](https://core.telegram.org/api/layers#layer-17).',
+  'object_decryptedMessageLayer_param_out_seq_no_type_int' => '2x the number of messages in the recipient\'s inbox (including deleted and service messages), incremented by 1 if current user was the chat creator
Parameter added in [Layer 17](https://core.telegram.org/api/layers#layer-17).',
+  'object_decryptedMessageLayer_param_message_type_DecryptedMessage' => 'The content of message itself',
+  'object_decryptedMessageActionResend' => 'Request for the other party in a Secret Chat to automatically resend a contiguous range of previously sent messages, as explained in [Sequence number is Secret Chats](https://core.telegram.org/api/end-to-end/seq_no).',
+  'object_decryptedMessageActionResend_param_start_seq_no_type_int' => '`out_seq_no` of the first message to be resent, with correct parity',
+  'object_decryptedMessageActionResend_param_end_seq_no_type_int' => '`out_seq_no` of the last message to be resent, with same parity.',
+  'object_decryptedMessageActionNotifyLayer' => 'A notification stating the API layer that is used by the client. You should use your current layer and take notice of the layer used on the other side of a conversation when sending messages.',
+  'object_decryptedMessageActionNotifyLayer_param_layer_type_int' => 'Layer number, must be **17** or higher (this contructor was introduced in [Layer 17](https://core.telegram.org/api/layers#layer-17)).',
+  'object_decryptedMessageActionTyping' => 'User is preparing a message: typing, recording, uploading, etc.',
+  'object_decryptedMessageActionTyping_param_action_type_SendMessageAction' => 'Type of action',
+  'object_decryptedMessageActionRequestKey' => 'Request rekeying, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)',
   'object_decryptedMessageActionRequestKey_param_exchange_id_type_long' => 'Exchange ID',
-  'object_decryptedMessageActionRequestKey_param_g_a_type_bytes' => 'G a',
-  'object_decryptedMessageActionAcceptKey' => 'Decrypted message action accept key',
+  'object_decryptedMessageActionRequestKey_param_g_a_type_bytes' => 'g\\_a, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)',
+  'object_decryptedMessageActionAcceptKey' => 'Accept new key',
   'object_decryptedMessageActionAcceptKey_param_exchange_id_type_long' => 'Exchange ID',
-  'object_decryptedMessageActionAcceptKey_param_g_b_type_bytes' => 'G b',
-  'object_decryptedMessageActionAcceptKey_param_key_fingerprint_type_long' => 'Key fingerprint',
-  'object_decryptedMessageActionAbortKey' => 'Decrypted message action abort key',
+  'object_decryptedMessageActionAcceptKey_param_g_b_type_bytes' => 'B parameter, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)',
+  'object_decryptedMessageActionAcceptKey_param_key_fingerprint_type_long' => 'Key fingerprint, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)',
+  'object_decryptedMessageActionAbortKey' => 'Abort rekeying',
   'object_decryptedMessageActionAbortKey_param_exchange_id_type_long' => 'Exchange ID',
-  'object_decryptedMessageActionCommitKey' => 'Decrypted message action commit key',
-  'object_decryptedMessageActionCommitKey_param_exchange_id_type_long' => 'Exchange ID',
-  'object_decryptedMessageActionCommitKey_param_key_fingerprint_type_long' => 'Key fingerprint',
-  'object_decryptedMessageActionNoop' => 'Decrypted message action noop',
-  'object_decryptedMessageMediaExternalDocument' => 'Decrypted message media external document',
-  'object_decryptedMessageMediaExternalDocument_param_id_type_long' => 'ID',
-  'object_decryptedMessageMediaExternalDocument_param_access_hash_type_long' => 'Access hash',
+  'object_decryptedMessageActionCommitKey' => 'Commit new key, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)',
+  'object_decryptedMessageActionCommitKey_param_exchange_id_type_long' => 'Exchange ID, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)',
+  'object_decryptedMessageActionCommitKey_param_key_fingerprint_type_long' => 'Key fingerprint, see [rekeying process](https://core.telegram.org/api/end-to-end/pfs)',
+  'object_decryptedMessageActionNoop' => 'NOOP action',
+  'object_decryptedMessageMediaExternalDocument' => 'Non-e2e documented forwarded from non-secret chat',
+  'object_decryptedMessageMediaExternalDocument_param_id_type_long' => 'Document ID',
+  'object_decryptedMessageMediaExternalDocument_param_access_hash_type_long' => 'access hash',
   'object_decryptedMessageMediaExternalDocument_param_date_type_int' => 'Date',
   'object_decryptedMessageMediaExternalDocument_param_mime_type_type_string' => 'Mime type',
   'object_decryptedMessageMediaExternalDocument_param_size_type_int' => 'Size',
@@ -8674,22 +9078,22 @@ class Lang
   'object_decryptedMessageMediaExternalDocument_param_dc_id_type_int' => 'DC ID',
   'object_decryptedMessageMediaExternalDocument_param_attributes_type_Vector t' => 'Attributes',
   'object_decryptedMessage_param_entities_type_Vector t' => 'Entities',
-  'object_decryptedMessage_param_via_bot_name_type_string' => 'Via bot name',
-  'object_decryptedMessage_param_reply_to_random_id_type_long' => 'Reply to random ID',
+  'object_decryptedMessage_param_via_bot_name_type_string' => 'Specifies the ID of the inline bot that generated the message (parameter added in layer 45)',
+  'object_decryptedMessage_param_reply_to_random_id_type_long' => 'Random message ID of the message this message replies to (parameter added in layer 45)',
   'object_decryptedMessageMediaPhoto_param_caption_type_string' => 'Caption',
   'object_decryptedMessageMediaVideo_param_caption_type_string' => 'Caption',
   'object_decryptedMessageMediaDocument_param_attributes_type_Vector t' => 'Attributes',
   'object_decryptedMessageMediaDocument_param_caption_type_string' => 'Caption',
-  'object_decryptedMessageMediaVenue' => 'Decrypted message media venue',
-  'object_decryptedMessageMediaVenue_param_lat_type_double' => 'Lat',
-  'object_decryptedMessageMediaVenue_param_long_type_double' => 'Long',
-  'object_decryptedMessageMediaVenue_param_title_type_string' => 'Title',
+  'object_decryptedMessageMediaVenue' => 'Venue',
+  'object_decryptedMessageMediaVenue_param_lat_type_double' => 'Latitude of venue',
+  'object_decryptedMessageMediaVenue_param_long_type_double' => 'Longitude of venue',
+  'object_decryptedMessageMediaVenue_param_title_type_string' => 'Venue name',
   'object_decryptedMessageMediaVenue_param_address_type_string' => 'Address',
-  'object_decryptedMessageMediaVenue_param_provider_type_string' => 'Provider',
-  'object_decryptedMessageMediaVenue_param_venue_id_type_string' => 'Venue ID',
-  'object_decryptedMessageMediaWebPage' => 'Decrypted message media web page',
-  'object_decryptedMessageMediaWebPage_param_url_type_string' => 'URL',
-  'object_decryptedMessage_param_grouped_id_type_long' => 'Grouped ID',
+  'object_decryptedMessageMediaVenue_param_provider_type_string' => 'Venue provider: currently only "foursquare" needs to be supported',
+  'object_decryptedMessageMediaVenue_param_venue_id_type_string' => 'Venue ID in the provider\'s database',
+  'object_decryptedMessageMediaWebPage' => 'Webpage preview',
+  'object_decryptedMessageMediaWebPage_param_url_type_string' => 'URL of webpage',
+  'object_decryptedMessage_param_grouped_id_type_long' => 'Random group ID, assigned by the author of message.
Multiple encrypted messages with a photo attached and with the same group ID indicate an album (parameter added in layer 45)',
   'object_inputPeerContact' => 'Peer contact',
   'object_inputPeerContact_param_user_id_type_int' => 'User ID',
   'object_inputPeerForeign' => 'Peer foreign',
@@ -8769,11 +9173,11 @@ class Lang
   'object_userDeleted_param_first_name_type_string' => 'First name',
   'object_userDeleted_param_last_name_type_string' => 'Last name',
   'object_userDeleted_param_username_type_string' => 'Username',
-  'object_userStatusEmpty' => 'Empty user status',
-  'object_userStatusOnline' => 'User status online',
-  'object_userStatusOnline_param_expires_type_int' => 'Expires',
-  'object_userStatusOffline' => 'User status offline',
-  'object_userStatusOffline_param_was_online_type_int' => 'Was online',
+  'object_userStatusEmpty' => 'User status has not been set yet.',
+  'object_userStatusOnline' => 'Online status of the user.',
+  'object_userStatusOnline_param_expires_type_int' => 'Time to expiration of the current online status',
+  'object_userStatusOffline' => 'The user\'s offline status.',
+  'object_userStatusOffline_param_was_online_type_int' => 'Time the user was last seen online',
   'object_chat_param_left_type_Bool' => 'Left?',
   'object_chatForbidden_param_date_type_int' => 'Date',
   'object_chatParticipants_param_admin_id_type_int' => 'Admin ID',
@@ -8813,9 +9217,9 @@ class Lang
   'object_auth.sentCode_param_send_call_timeout_type_int' => 'Send call timeout',
   'object_auth.sentCode_param_is_password_type_Bool' => 'Is password?',
   'object_auth.authorization_param_expires_type_int' => 'Expiration date',
-  'object_inputPeerNotifySettings_param_show_previews_type_Bool' => 'Show previews?',
+  'object_inputPeerNotifySettings_param_show_previews_type_Bool' => 'If the text of the message shall be displayed in notification',
   'object_inputPeerNotifySettings_param_events_mask_type_int' => 'Events mask',
-  'object_peerNotifySettings_param_show_previews_type_Bool' => 'Show previews?',
+  'object_peerNotifySettings_param_show_previews_type_Bool' => 'Display text in notifications',
   'object_peerNotifySettings_param_events_mask_type_int' => 'Events mask',
   'object_userFull_param_blocked_type_Bool' => 'Blocked?',
   'object_userFull_param_real_first_name_type_string' => 'Real first name',
@@ -8862,9 +9266,9 @@ class Lang
   'object_updateReadMessages' => 'Update read messages',
   'object_updateReadMessages_param_messages_type_Vector t' => 'Messages',
   'object_updateReadMessages_param_pts_type_int' => 'Pts',
-  'object_updateUserStatus' => 'Update user status',
-  'object_updateUserStatus_param_user_id_type_int' => 'User ID',
-  'object_updateUserStatus_param_status_type_UserStatus' => 'Status',
+  'object_updateUserStatus' => 'Contact status update.',
+  'object_updateUserStatus_param_user_id_type_int' => 'User identifier',
+  'object_updateUserStatus_param_status_type_UserStatus' => 'New status',
   'object_updateContactLink_param_my_link_type_contacts.MyLink' => 'My link',
   'object_updateContactLink_param_foreign_link_type_contacts.ForeignLink' => 'Foreign link',
   'object_updateNewAuthorization' => 'Update new authorization',
@@ -8940,9 +9344,9 @@ class Lang
   'object_contactFound_param_user_id_type_int' => 'User ID',
   'object_updateServiceNotification_param_popup_type_Bool' => 'Popup?',
   'object_inputMediaUploadedThumbDocument_param_attributes_type_Vector t' => 'Attributes',
-  'object_userStatusRecently' => 'User status recently',
-  'object_userStatusLastWeek' => 'User status last week',
-  'object_userStatusLastMonth' => 'User status last month',
+  'object_userStatusRecently' => 'Online status: last seen recently',
+  'object_userStatusLastWeek' => 'Online status: last seen last week',
+  'object_userStatusLastMonth' => 'Online status: last seen last month',
   'object_account.sentChangePhoneCode' => 'Sent change phone code',
   'object_account.sentChangePhoneCode_param_phone_code_hash_type_string' => 'Phone code hash',
   'object_account.sentChangePhoneCode_param_send_call_timeout_type_int' => 'Send call timeout',
@@ -9033,9 +9437,9 @@ class Lang
   'object_inputMediaVideo_param_caption_type_string' => 'Caption',
   'object_messageMediaPhoto_param_caption_type_string' => 'Caption',
   'object_messageMediaVideo_param_caption_type_string' => 'Caption',
-  'object_botCommand' => 'Bot command',
-  'object_botCommand_param_command_type_string' => 'Command',
-  'object_botCommand_param_description_type_string' => 'Description',
+  'object_botCommand' => 'Describes a bot command that can be used in a chat',
+  'object_botCommand_param_command_type_string' => '`/command` name',
+  'object_botCommand_param_description_type_string' => 'Description of the command',
   'object_botInfoEmpty' => 'Empty bot info',
   'object_botInfo_param_version_type_int' => 'Version',
   'object_botInfo_param_share_text_type_string' => 'Share text',
@@ -9146,7 +9550,7 @@ class Lang
   'object_updates.channelDifferenceEmpty_param_channel_pts_type_int' => 'Channel pts',
   'object_updates.channelDifferenceTooLong_param_channel_pts_type_int' => 'Channel pts',
   'object_updates.channelDifference_param_channel_pts_type_int' => 'Channel pts',
-  'object_privacyKeyChatInvite' => 'Privacy key chat invite',
+  'object_privacyKeyChatInvite' => 'Whether the user can be invited to chats',
   'object_inputMediaUploadedThumbDocument_param_stickers_type_Vector t' => 'Stickers',
   'object_inputMediaPhotoExternal_param_caption_type_string' => 'Caption',
   'object_inputMediaDocumentExternal_param_caption_type_string' => 'Caption',
@@ -9156,15 +9560,15 @@ class Lang
   'object_help.appChangelog_param_message_type_string' => 'Message',
   'object_help.appChangelog_param_media_type_MessageMedia' => 'Media',
   'object_help.appChangelog_param_entities_type_Vector t' => 'Entities',
-  'object_pageBlockParagraph' => 'Page block paragraph',
+  'object_pageBlockParagraph' => 'A paragraph',
   'object_pageBlockParagraph_param_text_type_RichText' => 'Text',
-  'object_pageBlockPreformatted' => 'Page block preformatted',
+  'object_pageBlockPreformatted' => 'Preformatted (`
` text)',
   'object_pageBlockPreformatted_param_text_type_RichText' => 'Text',
-  'object_pageBlockPreformatted_param_language_type_string' => 'Language',
-  'object_pageBlockDivider' => 'Page block divider',
-  'object_pageBlockAnchor' => 'Page block anchor',
-  'object_pageBlockAnchor_param_name_type_string' => 'Name',
-  'object_pageBlockCover' => 'Page block cover',
+  'object_pageBlockPreformatted_param_language_type_string' => 'Programming language of preformatted text',
+  'object_pageBlockDivider' => 'An empty block separating a page',
+  'object_pageBlockAnchor' => 'Link to section within the page itself (like `anchor`)',
+  'object_pageBlockAnchor_param_name_type_string' => 'Name of target section',
+  'object_pageBlockCover' => 'A page cover',
   'object_pageBlockCover_param_cover_type_PageBlock' => 'Cover',
   'object_pagePart_param_videos_type_Vector t' => 'Videos',
   'object_pageFull_param_videos_type_Vector t' => 'Videos',
@@ -9192,131 +9596,133 @@ class Lang
   'object_help.configSimple_param_dc_id_type_int' => 'DC ID',
   'object_help.configSimple_param_ip_port_list_type_Vector t' => 'Ip port list',
   'object_inputMessagesFilterMyMentionsUnread' => 'Messages filter my mentions unread',
-  'method_initConnection_param_proxy_type_InputClientProxy' => 'The current proxy',
-  'method_account.registerDevice_param_secret_type_bytes' => 'Secret',
-  'method_account.getAllSecureValues' => 'Get all secure telegram passport values',
-  'method_account.getSecureValue' => 'Get secure value for telegram passport',
+  'method_initConnection_param_proxy_type_InputClientProxy' => 'Info about an MTProto proxy',
+  'method_account.registerDevice_param_secret_type_bytes' => 'For FCM and APNS VoIP, optional encryption key used to encrypt push notifications',
+  'method_account.getAllSecureValues' => 'Get all saved [Telegram Passport](https://core.telegram.org/passport) documents, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
+  'method_account.getSecureValue' => 'Get saved [Telegram Passport](https://core.telegram.org/passport) document, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
   'method_account.getSecureValue_param_types_type_Vector t' => 'Get telegram passport secure parameters',
-  'method_account.saveSecureValue' => 'Save telegram passport secure value',
-  'method_account.saveSecureValue_param_value_type_InputSecureValue' => 'Encrypted value',
-  'method_account.saveSecureValue_param_secure_secret_id_type_long' => 'Secret',
-  'method_account.deleteSecureValue' => 'Delete secure telegram passport value',
+  'method_account.saveSecureValue' => 'Securely save [Telegram Passport](https://core.telegram.org/passport) document, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
+  'method_account.saveSecureValue_param_value_type_InputSecureValue' => 'Secure value, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
+  'method_account.saveSecureValue_param_secure_secret_id_type_long' => 'Passport secret hash, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
+  'method_account.deleteSecureValue' => 'Delete stored [Telegram Passport](https://core.telegram.org/passport) documents, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
   'method_account.deleteSecureValue_param_types_type_Vector t' => 'The values to delete',
-  'method_account.getAuthorizationForm' => 'Bots only: get telegram passport authorization form',
-  'method_account.getAuthorizationForm_param_bot_id_type_int' => 'Bot ID',
-  'method_account.getAuthorizationForm_param_scope_type_string' => 'Scope',
-  'method_account.getAuthorizationForm_param_public_key_type_string' => 'Bot\'s public key',
-  'method_account.acceptAuthorization' => 'Accept telegram passport authorization',
+  'method_account.getAuthorizationForm' => 'Returns a Telegram Passport authorization form for sharing data with a service',
+  'method_account.getAuthorizationForm_param_bot_id_type_int' => 'User identifier of the service\'s bot',
+  'method_account.getAuthorizationForm_param_scope_type_string' => 'Telegram Passport element types requested by the service',
+  'method_account.getAuthorizationForm_param_public_key_type_string' => 'Service\'s public key',
+  'method_account.acceptAuthorization' => 'Sends a Telegram Passport authorization form, effectively sharing data with the service',
   'method_account.acceptAuthorization_param_bot_id_type_int' => 'Bot ID',
-  'method_account.acceptAuthorization_param_scope_type_string' => 'Scope',
-  'method_account.acceptAuthorization_param_public_key_type_string' => 'The bot\'s RSA public key',
+  'method_account.acceptAuthorization_param_scope_type_string' => 'Telegram Passport element types requested by the service',
+  'method_account.acceptAuthorization_param_public_key_type_string' => 'Service\'s public key',
   'method_account.acceptAuthorization_param_value_hashes_type_Vector t' => 'Hashes of the encrypted credentials',
-  'method_account.acceptAuthorization_param_credentials_type_SecureCredentialsEncrypted' => 'Encrypted secure credentials',
-  'method_account.sendVerifyPhoneCode' => 'Send phone verification code',
+  'method_account.acceptAuthorization_param_credentials_type_SecureCredentialsEncrypted' => 'Encrypted values',
+  'method_account.sendVerifyPhoneCode' => 'Send the verification phone code for telegram [passport](https://core.telegram.org/passport).',
   'method_account.sendVerifyPhoneCode_param_allow_flashcall_type_true' => 'Allow phone calls?',
-  'method_account.sendVerifyPhoneCode_param_phone_number_type_string' => 'The phone number',
+  'method_account.sendVerifyPhoneCode_param_phone_number_type_string' => 'The phone number to verify',
   'method_account.sendVerifyPhoneCode_param_current_number_type_Bool' => 'Is this the current number?',
-  'method_account.verifyPhone' => 'Verify phone number',
-  'method_account.verifyPhone_param_phone_number_type_string' => 'The phone number',
-  'method_account.verifyPhone_param_phone_code_hash_type_string' => 'The phone code hash returned by account.sendVerifyPhoneCode',
-  'method_account.verifyPhone_param_phone_code_type_string' => 'The phone code type returned by account.sendVerifyPhoneCode',
-  'method_account.sendVerifyEmailCode' => 'Send email verification code',
-  'method_account.sendVerifyEmailCode_param_email_type_string' => 'Email',
-  'method_account.verifyEmail' => 'Verify email address',
-  'method_account.verifyEmail_param_email_type_string' => 'The email address',
-  'method_account.verifyEmail_param_code_type_string' => 'The received code',
-  'method_users.setSecureValueErrors' => 'Set secure value error for telegram passport',
-  'method_users.setSecureValueErrors_param_id_type_InputUser' => 'The user ID',
+  'method_account.verifyPhone' => 'Verify a phone number for telegram [passport](https://core.telegram.org/passport).',
+  'method_account.verifyPhone_param_phone_number_type_string' => 'Phone number',
+  'method_account.verifyPhone_param_phone_code_hash_type_string' => 'Phone code hash received from the call to [account.sendVerifyPhoneCode](../methods/account.sendVerifyPhoneCode.md)',
+  'method_account.verifyPhone_param_phone_code_type_string' => 'Code received after the call to [account.sendVerifyPhoneCode](../methods/account.sendVerifyPhoneCode.md)',
+  'method_account.sendVerifyEmailCode' => 'Send the verification email code for telegram [passport](https://core.telegram.org/passport).',
+  'method_account.sendVerifyEmailCode_param_email_type_string' => 'The email where to send the code',
+  'method_account.verifyEmail' => 'Verify an email address for telegram [passport](https://core.telegram.org/passport).',
+  'method_account.verifyEmail_param_email_type_string' => 'The email to verify',
+  'method_account.verifyEmail_param_code_type_string' => 'The verification code that was received',
+  'method_users.setSecureValueErrors' => 'Notify the user that the sent [passport](https://core.telegram.org/passport) data contains some errors The user will not be able to re-submit their Passport data to you until the errors are fixed (the contents of the field for which you returned the error must change).
+
+Use this if the data submitted by the user doesn\'t satisfy the standards your service requires for any reason. For example, if a birthday date seems invalid, a submitted document is blurry, a scan shows evidence of tampering, etc. Supply some details in the error message to make sure the user knows how to correct the issues.',
+  'method_users.setSecureValueErrors_param_id_type_InputUser' => 'The user',
   'method_users.setSecureValueErrors_param_errors_type_Vector t' => 'The errors',
-  'method_messages.search_param_hash_type_int' => 'IDs of messages you already fetched',
-  'method_messages.report' => 'Report a message',
-  'method_messages.report_param_peer_type_InputPeer' => 'The user that sent the messages',
+  'method_messages.search_param_hash_type_int' => '[Hash](https://core.telegram.org/api/offsets)',
+  'method_messages.report' => 'Report a message in a chat for violation of telegram\'s Terms of Service',
+  'method_messages.report_param_peer_type_InputPeer' => 'Peer',
   'method_messages.report_param_id_type_Vector t' => 'The messages to report',
-  'method_messages.report_param_reason_type_ReportReason' => 'The reason why you\'re sending this report',
-  'method_messages.getStickers_param_hash_type_int' => 'IDs of previously fetched stickers',
-  'method_messages.editMessage_param_media_type_InputMedia' => 'The media to substitute',
-  'method_messages.editInlineBotMessage_param_media_type_InputMedia' => 'The media to substitute',
+  'method_messages.report_param_reason_type_ReportReason' => 'Why are these messages being reported',
+  'method_messages.getStickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_messages.editMessage_param_media_type_InputMedia' => 'New attached media',
+  'method_messages.editInlineBotMessage_param_media_type_InputMedia' => 'Media',
   'method_messages.toggleDialogPin_param_peer_type_InputDialogPeer' => 'The dialog to pin',
-  'method_messages.getRecentLocations_param_hash_type_int' => 'IDs of previously fetched locations',
-  'method_messages.searchStickerSets' => 'Find a sticker set',
-  'method_messages.searchStickerSets_param_exclude_featured_type_true' => 'Exclude featured sticker sets from the search?',
-  'method_messages.searchStickerSets_param_q_type_string' => 'The search query',
-  'method_messages.searchStickerSets_param_hash_type_int' => 'Ids of stickers you already cached',
-  'method_upload.getFileHashes' => 'Get file hashes',
-  'method_upload.getFileHashes_param_location_type_InputFileLocation' => 'The file',
-  'method_upload.getFileHashes_param_offset_type_int' => 'Offset',
-  'method_help.getProxyData' => 'Get information about the current proxy',
-  'method_help.getTermsOfServiceUpdate' => 'Get updated TOS',
-  'method_help.acceptTermsOfService' => 'Accept telegram\'s TOS',
-  'method_help.acceptTermsOfService_param_id_type_DataJSON' => 'TOS',
-  'method_help.getDeepLinkInfo' => 'Get deep link info',
-  'method_help.getDeepLinkInfo_param_path_type_string' => 'Deep link',
-  'object_inputSecureFileLocation' => 'Secure file location',
-  'object_inputSecureFileLocation_param_id_type_long' => 'ID',
-  'object_inputSecureFileLocation_param_access_hash_type_long' => 'Access hash',
-  'object_messageActionBotAllowed' => 'Message action bot allowed',
-  'object_messageActionBotAllowed_param_domain_type_string' => 'Domain',
-  'object_messageActionSecureValuesSentMe' => 'Message action secure values sent me',
+  'method_messages.getRecentLocations_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_messages.searchStickerSets' => 'Search for stickersets',
+  'method_messages.searchStickerSets_param_exclude_featured_type_true' => 'Exclude featured stickersets from results',
+  'method_messages.searchStickerSets_param_q_type_string' => 'Query string',
+  'method_messages.searchStickerSets_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_upload.getFileHashes' => 'Get SHA256 hashes for verifying downloaded files',
+  'method_upload.getFileHashes_param_location_type_InputFileLocation' => 'File',
+  'method_upload.getFileHashes_param_offset_type_int' => 'Offset from which to get file hashes',
+  'method_help.getProxyData' => 'Get promotion info of the currently-used MTProxy',
+  'method_help.getTermsOfServiceUpdate' => 'Look for updates of telegram\'s terms of service',
+  'method_help.acceptTermsOfService' => 'Accept the new terms of service',
+  'method_help.acceptTermsOfService_param_id_type_DataJSON' => 'ID of terms of service',
+  'method_help.getDeepLinkInfo' => 'Get info about a `t.me` link',
+  'method_help.getDeepLinkInfo_param_path_type_string' => 'Path in `t.me/path`',
+  'object_inputSecureFileLocation' => 'Location of encrypted telegram [passport](https://core.telegram.org/passport) file.',
+  'object_inputSecureFileLocation_param_id_type_long' => 'File ID, **id** parameter value from [secureFile](../constructors/secureFile.md)',
+  'object_inputSecureFileLocation_param_access_hash_type_long' => 'Checksum, **access\\_hash** parameter value from [secureFile](../constructors/secureFile.md)',
+  'object_messageActionBotAllowed' => 'The domain name of the website on which the user has logged in. [More about Telegram Login »](https://core.telegram.org/widgets/login)',
+  'object_messageActionBotAllowed_param_domain_type_string' => 'The domain name of the website on which the user has logged in.',
+  'object_messageActionSecureValuesSentMe' => 'Secure [telegram passport](https://core.telegram.org/passport) values were received',
   'object_messageActionSecureValuesSentMe_param_values_type_Vector t' => 'Values',
-  'object_messageActionSecureValuesSentMe_param_credentials_type_SecureCredentialsEncrypted' => 'Credentials',
-  'object_messageActionSecureValuesSent' => 'Message action secure values sent',
+  'object_messageActionSecureValuesSentMe_param_credentials_type_SecureCredentialsEncrypted' => 'Encrypted credentials required to decrypt the data',
+  'object_messageActionSecureValuesSent' => 'Request for secure [telegram passport](https://core.telegram.org/passport) values was sent',
   'object_messageActionSecureValuesSent_param_types_type_Vector t' => 'Types',
   'object_auth.sentCode_param_terms_of_service_type_help.TermsOfService' => 'Terms of service',
-  'object_inputPeerNotifySettings_param_silent_type_Bool' => 'Silent?',
-  'object_peerNotifySettings_param_silent_type_Bool' => 'Silent?',
-  'object_updateDialogPinned_param_peer_type_DialogPeer' => 'Peer',
+  'object_inputPeerNotifySettings_param_silent_type_Bool' => 'Peer was muted?',
+  'object_peerNotifySettings_param_silent_type_Bool' => 'Mute peer?',
+  'object_updateDialogPinned_param_peer_type_DialogPeer' => 'The dialog',
   'object_upload.fileCdnRedirect_param_file_hashes_type_Vector t' => 'File hashes',
-  'object_dcOption_param_secret_type_bytes' => 'Secret',
-  'object_config_param_preload_featured_stickers_type_true' => 'Preload featured stickers?',
-  'object_config_param_ignore_phone_entities_type_true' => 'Ignore phone entities?',
-  'object_config_param_revoke_pm_inbox_type_true' => 'Revoke pm inbox?',
-  'object_config_param_blocked_mode_type_true' => 'Blocked mode?',
-  'object_config_param_revoke_time_limit_type_int' => 'Revoke time limit',
-  'object_config_param_revoke_pm_time_limit_type_int' => 'Revoke pm time limit',
-  'object_config_param_autoupdate_url_prefix_type_string' => 'Autoupdate URL prefix',
-  'object_messages.stickers_param_hash_type_int' => 'Hash',
+  'object_dcOption_param_secret_type_bytes' => 'If the `tcpo_only` flag is set, specifies the secret to use when connecting using [transport obfuscation](https://core.telegram.org/mtproto/mtproto-transports#transport-obfuscation)',
+  'object_config_param_preload_featured_stickers_type_true' => 'Whether the client should preload featured stickers',
+  'object_config_param_ignore_phone_entities_type_true' => 'Whether the client should ignore phone [entities](https://core.telegram.org/api/entities)',
+  'object_config_param_revoke_pm_inbox_type_true' => 'Whether incoming private messages can be deleted for both participants',
+  'object_config_param_blocked_mode_type_true' => 'Indicates that telegram is *probably* censored by governments/ISPs in the current region',
+  'object_config_param_revoke_time_limit_type_int' => 'Only channel/supergroup messages with age smaller than the specified can be deleted',
+  'object_config_param_revoke_pm_time_limit_type_int' => 'Only private messages with age smaller than the specified can be deleted',
+  'object_config_param_autoupdate_url_prefix_type_string' => 'URL to use to auto-update the current app',
+  'object_messages.stickers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
   'object_account.noPassword_param_new_secure_salt_type_bytes' => 'New secure salt',
   'object_account.noPassword_param_secure_random_type_bytes' => 'Secure random',
-  'object_account.password_param_has_recovery_type_true' => 'Has recovery?',
-  'object_account.password_param_has_secure_values_type_true' => 'Has secure values?',
+  'object_account.password_param_has_recovery_type_true' => 'Whether the user has a recovery method configured',
+  'object_account.password_param_has_secure_values_type_true' => 'Whether telegram [passport](https://core.telegram.org/passport) is enabled',
   'object_account.password_param_new_secure_salt_type_bytes' => 'New secure salt',
-  'object_account.password_param_secure_random_type_bytes' => 'Secure random',
+  'object_account.password_param_secure_random_type_bytes' => 'Secure random string',
   'object_account.passwordSettings_param_secure_salt_type_bytes' => 'Secure salt',
   'object_account.passwordSettings_param_secure_secret_type_bytes' => 'Secure secret',
   'object_account.passwordSettings_param_secure_secret_id_type_long' => 'Secure secret ID',
   'object_account.passwordInputSettings_param_new_secure_salt_type_bytes' => 'New secure salt',
   'object_account.passwordInputSettings_param_new_secure_secret_type_bytes' => 'New secure secret',
   'object_account.passwordInputSettings_param_new_secure_secret_id_type_long' => 'New secure secret ID',
-  'object_stickerSet_param_installed_date_type_int' => 'Installed date',
-  'object_messageEntityPhone' => 'Message entity phone',
-  'object_messageEntityPhone_param_offset_type_int' => 'Offset',
-  'object_messageEntityPhone_param_length_type_int' => 'Length',
-  'object_messageEntityCashtag' => 'Message entity cashtag',
-  'object_messageEntityCashtag_param_offset_type_int' => 'Offset',
-  'object_messageEntityCashtag_param_length_type_int' => 'Length',
-  'object_help.termsOfService_param_popup_type_true' => 'Popup?',
-  'object_help.termsOfService_param_id_type_DataJSON' => 'ID',
+  'object_stickerSet_param_installed_date_type_int' => 'When was this stickerset installed',
+  'object_messageEntityPhone' => 'Message entity representing a phone number.',
+  'object_messageEntityPhone_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityPhone_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityCashtag' => 'Message entity representing a **$cashtag**.',
+  'object_messageEntityCashtag_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityCashtag_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_help.termsOfService_param_popup_type_true' => 'Whether a prompt must be showed to the user, in order to accept the new terms.',
+  'object_help.termsOfService_param_id_type_DataJSON' => 'ID of the new terms',
   'object_help.termsOfService_param_entities_type_Vector t' => 'Entities',
-  'object_help.termsOfService_param_min_age_confirm_type_int' => 'Min age confirm',
-  'object_inputBotInlineMessageMediaVenue_param_venue_type_type_string' => 'Venue type',
-  'object_inputBotInlineResult_param_thumb_type_InputWebDocument' => 'Thumbnail',
-  'object_inputBotInlineResult_param_content_type_InputWebDocument' => 'Content',
-  'object_botInlineMessageMediaVenue_param_venue_type_type_string' => 'Venue type',
-  'object_botInlineResult_param_thumb_type_WebDocument' => 'Thumbnailnail',
-  'object_botInlineResult_param_content_type_WebDocument' => 'Content',
+  'object_help.termsOfService_param_min_age_confirm_type_int' => 'Minimum age required to sign up to telegram, the user must confirm that they is older than the minimum age.',
+  'object_inputBotInlineMessageMediaVenue_param_venue_type_type_string' => 'Venue type in the provider\'s database',
+  'object_inputBotInlineResult_param_thumb_type_InputWebDocument' => 'Thumbnail for result',
+  'object_inputBotInlineResult_param_content_type_InputWebDocument' => 'Result contents',
+  'object_botInlineMessageMediaVenue_param_venue_type_type_string' => 'Venue type in the provider\'s database',
+  'object_botInlineResult_param_thumb_type_WebDocument' => 'Thumbnail for the result',
+  'object_botInlineResult_param_content_type_WebDocument' => 'Content of the result',
   'object_messages.recentStickers_param_packs_type_Vector t' => 'Packs',
   'object_messages.recentStickers_param_dates_type_Vector t' => 'Dates',
-  'object_webDocumentNoProxy' => 'Web document no proxy',
-  'object_webDocumentNoProxy_param_url_type_string' => 'URL',
-  'object_webDocumentNoProxy_param_size_type_int' => 'Size',
-  'object_webDocumentNoProxy_param_mime_type_type_string' => 'Mime type',
+  'object_webDocumentNoProxy' => 'Remote document that can be downloaded without [proxying through telegram](https://core.telegram.org/api/files)',
+  'object_webDocumentNoProxy_param_url_type_string' => 'Document URL',
+  'object_webDocumentNoProxy_param_size_type_int' => 'File size',
+  'object_webDocumentNoProxy_param_mime_type_type_string' => 'MIME type',
   'object_webDocumentNoProxy_param_attributes_type_Vector t' => 'Attributes',
-  'object_inputWebFileGeoPointLocation' => 'Web file geo point location',
-  'object_inputWebFileGeoPointLocation_param_geo_point_type_InputGeoPoint' => 'Geo point',
-  'object_inputWebFileGeoPointLocation_param_w_type_int' => 'Width',
-  'object_inputWebFileGeoPointLocation_param_h_type_int' => 'Height',
-  'object_inputWebFileGeoPointLocation_param_zoom_type_int' => 'Zoom',
-  'object_inputWebFileGeoPointLocation_param_scale_type_int' => 'Scale',
+  'object_inputWebFileGeoPointLocation' => 'Geolocation',
+  'object_inputWebFileGeoPointLocation_param_geo_point_type_InputGeoPoint' => 'Geolocation',
+  'object_inputWebFileGeoPointLocation_param_w_type_int' => 'Map width in pixels before applying scale; 16-1024',
+  'object_inputWebFileGeoPointLocation_param_h_type_int' => 'Map height in pixels before applying scale; 16-1024',
+  'object_inputWebFileGeoPointLocation_param_zoom_type_int' => 'Map zoom level; 13-20',
+  'object_inputWebFileGeoPointLocation_param_scale_type_int' => 'Map scale; 1-3',
   'object_inputWebFileGeoMessageLocation' => 'Web file geo message location',
   'object_inputWebFileGeoMessageLocation_param_peer_type_InputPeer' => 'Peer',
   'object_inputWebFileGeoMessageLocation_param_msg_id_type_int' => 'Msg ID',
@@ -9325,156 +9731,156 @@ class Lang
   'object_inputWebFileGeoMessageLocation_param_zoom_type_int' => 'Zoom',
   'object_inputWebFileGeoMessageLocation_param_scale_type_int' => 'Scale',
   'object_channelAdminRights_param_manage_call_type_true' => 'Manage group calls',
-  'object_inputDialogPeer' => 'Dialog peer',
+  'object_inputDialogPeer' => 'A peer',
   'object_inputDialogPeer_param_peer_type_InputPeer' => 'Peer',
-  'object_dialogPeer' => 'Dialog peer',
+  'object_dialogPeer' => 'Peer',
   'object_dialogPeer_param_peer_type_Peer' => 'Peer',
-  'object_messages.foundStickerSetsNotModified' => 'Found sticker sets not modified',
-  'object_messages.foundStickerSets' => 'Found sticker sets',
-  'object_messages.foundStickerSets_param_hash_type_int' => 'Hash',
+  'object_messages.foundStickerSetsNotModified' => 'No further results were found',
+  'object_messages.foundStickerSets' => 'Found stickersets',
+  'object_messages.foundStickerSets_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
   'object_messages.foundStickerSets_param_sets_type_Vector t' => 'Sets',
-  'object_fileHash' => 'File hash',
-  'object_fileHash_param_offset_type_int' => 'Offset',
-  'object_fileHash_param_limit_type_int' => 'Limit',
-  'object_fileHash_param_hash_type_bytes' => 'Hash',
-  'object_inputClientProxy' => 'Client proxy',
-  'object_inputClientProxy_param_address_type_string' => 'Address',
-  'object_inputClientProxy_param_port_type_int' => 'Port',
-  'object_help.proxyDataEmpty' => 'Empty proxy data',
-  'object_help.proxyDataEmpty_param_expires_type_int' => 'Expires',
-  'object_help.proxyDataPromo' => 'Proxy data promo',
-  'object_help.proxyDataPromo_param_expires_type_int' => 'Expires',
-  'object_help.proxyDataPromo_param_peer_type_Peer' => 'Peer',
+  'object_fileHash' => 'SHA256 Hash of an uploaded file, to be checked for validity after download',
+  'object_fileHash_param_offset_type_int' => 'Offset from where to start computing SHA-256 hash',
+  'object_fileHash_param_limit_type_int' => 'Length',
+  'object_fileHash_param_hash_type_bytes' => 'SHA-256 Hash of file chunk, to be checked for validity after download',
+  'object_inputClientProxy' => 'Info about an [MTProxy](https://core.telegram.org/mtproto/mtproto-transports#transport-obfuscation) used to connect.',
+  'object_inputClientProxy_param_address_type_string' => 'Proxy address',
+  'object_inputClientProxy_param_port_type_int' => 'Proxy port',
+  'object_help.proxyDataEmpty' => 'No proxy was used to connect to tg (or none was provided to [initConnection](../methods/initConnection.md), or the used proxy doesn\'t have a promotion channel associated to it)',
+  'object_help.proxyDataEmpty_param_expires_type_int' => 'Expiration date of proxy info, will have to be refetched in `expires` seconds',
+  'object_help.proxyDataPromo' => 'Promotion channel associated to a certain MTProxy',
+  'object_help.proxyDataPromo_param_expires_type_int' => 'Expiration date of proxy info, will have to be refetched in `expires` seconds',
+  'object_help.proxyDataPromo_param_peer_type_Peer' => 'The promoted channel',
   'object_help.proxyDataPromo_param_chats_type_Vector t' => 'Chats',
   'object_help.proxyDataPromo_param_users_type_Vector t' => 'Users',
-  'object_help.termsOfServiceUpdateEmpty' => 'Empty terms of service update',
-  'object_help.termsOfServiceUpdateEmpty_param_expires_type_int' => 'Expires',
-  'object_help.termsOfServiceUpdate' => 'Terms of service update',
-  'object_help.termsOfServiceUpdate_param_expires_type_int' => 'Expires',
-  'object_help.termsOfServiceUpdate_param_terms_of_service_type_help.TermsOfService' => 'Terms of service',
-  'object_inputSecureFileUploaded' => 'Secure file uploaded',
-  'object_inputSecureFileUploaded_param_id_type_long' => 'ID',
-  'object_inputSecureFileUploaded_param_parts_type_int' => 'Parts',
-  'object_inputSecureFileUploaded_param_md5_checksum_type_string' => 'Md5 checksum',
+  'object_help.termsOfServiceUpdateEmpty' => 'No changes were made to telegram\'s terms of service',
+  'object_help.termsOfServiceUpdateEmpty_param_expires_type_int' => 'New TOS updates will have to be queried using [help.getTermsOfServiceUpdate](../methods/help.getTermsOfServiceUpdate.md) in `expires` seconds',
+  'object_help.termsOfServiceUpdate' => 'Info about an update of telegram\'s terms of service. If the terms of service are declined, then the [account.deleteAccount](../methods/account.deleteAccount.md) method should be called with the reason "Decline ToS update"',
+  'object_help.termsOfServiceUpdate_param_expires_type_int' => 'New TOS updates will have to be queried using [help.getTermsOfServiceUpdate](../methods/help.getTermsOfServiceUpdate.md) in `expires` seconds',
+  'object_help.termsOfServiceUpdate_param_terms_of_service_type_help.TermsOfService' => 'New terms of service',
+  'object_inputSecureFileUploaded' => 'Uploaded secure file, for more info [see the passport docs »](https://core.telegram.org/passport/encryption#inputsecurefile)',
+  'object_inputSecureFileUploaded_param_id_type_long' => 'Secure file ID',
+  'object_inputSecureFileUploaded_param_parts_type_int' => 'Secure file part count',
+  'object_inputSecureFileUploaded_param_md5_checksum_type_string' => 'MD5 hash of encrypted uploaded file, to be checked server-side',
   'object_inputSecureFileUploaded_param_file_hash_type_bytes' => 'File hash',
   'object_inputSecureFileUploaded_param_secret_type_bytes' => 'Secret',
-  'object_inputSecureFile' => 'Secure file',
-  'object_inputSecureFile_param_id_type_long' => 'ID',
-  'object_inputSecureFile_param_access_hash_type_long' => 'Access hash',
-  'object_secureFileEmpty' => 'Empty secure file',
-  'object_secureFile' => 'Secure file',
+  'object_inputSecureFile' => 'Preuploaded [passport](https://core.telegram.org/passport) file, for more info [see the passport docs »](https://core.telegram.org/passport/encryption#inputsecurefile)',
+  'object_inputSecureFile_param_id_type_long' => 'Secure file ID',
+  'object_inputSecureFile_param_access_hash_type_long' => 'Secure file access hash',
+  'object_secureFileEmpty' => 'Empty constructor',
+  'object_secureFile' => 'Secure [passport](https://core.telegram.org/passport) file, for more info [see the passport docs »](https://core.telegram.org/passport/encryption#inputsecurefile)',
   'object_secureFile_param_id_type_long' => 'ID',
   'object_secureFile_param_access_hash_type_long' => 'Access hash',
-  'object_secureFile_param_size_type_int' => 'Size',
+  'object_secureFile_param_size_type_int' => 'File size',
   'object_secureFile_param_dc_id_type_int' => 'DC ID',
-  'object_secureFile_param_date_type_int' => 'Date',
+  'object_secureFile_param_date_type_int' => 'Date of upload',
   'object_secureFile_param_file_hash_type_bytes' => 'File hash',
   'object_secureFile_param_secret_type_bytes' => 'Secret',
-  'object_secureData' => 'Secure data',
+  'object_secureData' => 'Secure [passport](https://core.telegram.org/passport) data, for more info [see the passport docs »](https://core.telegram.org/passport/encryption#securedata)',
   'object_secureData_param_data_type_bytes' => 'Data',
   'object_secureData_param_data_hash_type_bytes' => 'Data hash',
   'object_secureData_param_secret_type_bytes' => 'Secret',
-  'object_securePlainPhone' => 'Secure plain phone',
-  'object_securePlainPhone_param_phone_type_string' => 'Phone',
-  'object_securePlainEmail' => 'Secure plain email',
-  'object_securePlainEmail_param_email_type_string' => 'Email',
-  'object_secureValueTypePersonalDetails' => 'Secure value type personal details',
-  'object_secureValueTypePassport' => 'Secure value type passport',
-  'object_secureValueTypeDriverLicense' => 'Secure value type driver license',
-  'object_secureValueTypeIdentityCard' => 'Secure value type IDentity card',
-  'object_secureValueTypeInternalPassport' => 'Secure value type internal passport',
-  'object_secureValueTypeAddress' => 'Secure value type address',
-  'object_secureValueTypeUtilityBill' => 'Secure value type utility bill',
-  'object_secureValueTypeBankStatement' => 'Secure value type bank statement',
-  'object_secureValueTypeRentalAgreement' => 'Secure value type rental agreement',
-  'object_secureValueTypePassportRegistration' => 'Secure value type passport registration',
-  'object_secureValueTypeTemporaryRegistration' => 'Secure value type temporary registration',
-  'object_secureValueTypePhone' => 'Secure value type phone',
-  'object_secureValueTypeEmail' => 'Secure value type email',
+  'object_securePlainPhone' => 'Phone number to use in [telegram passport](https://core.telegram.org/passport): [it must be verified, first »](https://core.telegram.org/passport/encryption#secureplaindata).',
+  'object_securePlainPhone_param_phone_type_string' => 'Phone number',
+  'object_securePlainEmail' => 'Email address to use in [telegram passport](https://core.telegram.org/passport): [it must be verified, first »](https://core.telegram.org/passport/encryption#secureplaindata).',
+  'object_securePlainEmail_param_email_type_string' => 'Email address',
+  'object_secureValueTypePersonalDetails' => 'Personal details',
+  'object_secureValueTypePassport' => 'Passport',
+  'object_secureValueTypeDriverLicense' => 'Driver\'s license',
+  'object_secureValueTypeIdentityCard' => 'Identity card',
+  'object_secureValueTypeInternalPassport' => 'Internal [passport](https://core.telegram.org/passport)',
+  'object_secureValueTypeAddress' => 'Address',
+  'object_secureValueTypeUtilityBill' => 'Utility bill',
+  'object_secureValueTypeBankStatement' => 'Bank statement',
+  'object_secureValueTypeRentalAgreement' => 'Rental agreement',
+  'object_secureValueTypePassportRegistration' => 'Internal registration [passport](https://core.telegram.org/passport)',
+  'object_secureValueTypeTemporaryRegistration' => 'Temporary registration',
+  'object_secureValueTypePhone' => 'Phone',
+  'object_secureValueTypeEmail' => 'Email',
   'object_secureValue' => 'Secure value',
-  'object_secureValue_param_type_type_SecureValueType' => 'Type',
-  'object_secureValue_param_data_type_SecureData' => 'Data',
-  'object_secureValue_param_front_side_type_SecureFile' => 'Front side',
-  'object_secureValue_param_reverse_side_type_SecureFile' => 'Reverse side',
-  'object_secureValue_param_selfie_type_SecureFile' => 'Selfie',
+  'object_secureValue_param_type_type_SecureValueType' => 'Secure [passport](https://core.telegram.org/passport) value type',
+  'object_secureValue_param_data_type_SecureData' => 'Encrypted [Telegram Passport](https://core.telegram.org/passport) element data',
+  'object_secureValue_param_front_side_type_SecureFile' => 'Encrypted [passport](https://core.telegram.org/passport) file with the front side of the document',
+  'object_secureValue_param_reverse_side_type_SecureFile' => 'Encrypted [passport](https://core.telegram.org/passport) file with the reverse side of the document',
+  'object_secureValue_param_selfie_type_SecureFile' => 'Encrypted [passport](https://core.telegram.org/passport) file with a selfie of the user holding the document',
   'object_secureValue_param_files_type_Vector t' => 'Files',
-  'object_secureValue_param_plain_data_type_SecurePlainData' => 'Plain data',
-  'object_secureValue_param_hash_type_bytes' => 'Hash',
-  'object_inputSecureValue' => 'Secure value',
-  'object_inputSecureValue_param_type_type_SecureValueType' => 'Type',
-  'object_inputSecureValue_param_data_type_SecureData' => 'Data',
-  'object_inputSecureValue_param_front_side_type_InputSecureFile' => 'Front side',
-  'object_inputSecureValue_param_reverse_side_type_InputSecureFile' => 'Reverse side',
-  'object_inputSecureValue_param_selfie_type_InputSecureFile' => 'Selfie',
+  'object_secureValue_param_plain_data_type_SecurePlainData' => 'Plaintext verified [passport](https://core.telegram.org/passport) data',
+  'object_secureValue_param_hash_type_bytes' => 'Data hash',
+  'object_inputSecureValue' => 'Secure value, [for more info see the passport docs »](https://core.telegram.org/passport/encryption#encryption)',
+  'object_inputSecureValue_param_type_type_SecureValueType' => 'Secure [passport](https://core.telegram.org/passport) value type',
+  'object_inputSecureValue_param_data_type_SecureData' => 'Encrypted [Telegram Passport](https://core.telegram.org/passport) element data',
+  'object_inputSecureValue_param_front_side_type_InputSecureFile' => 'Encrypted [passport](https://core.telegram.org/passport) file with the front side of the document',
+  'object_inputSecureValue_param_reverse_side_type_InputSecureFile' => 'Encrypted [passport](https://core.telegram.org/passport) file with the reverse side of the document',
+  'object_inputSecureValue_param_selfie_type_InputSecureFile' => 'Encrypted [passport](https://core.telegram.org/passport) file with a selfie of the user holding the document',
   'object_inputSecureValue_param_files_type_Vector t' => 'Files',
-  'object_inputSecureValue_param_plain_data_type_SecurePlainData' => 'Plain data',
+  'object_inputSecureValue_param_plain_data_type_SecurePlainData' => 'Plaintext verified [passport](https://core.telegram.org/passport) data',
   'object_secureValueHash' => 'Secure value hash',
-  'object_secureValueHash_param_type_type_SecureValueType' => 'Type',
+  'object_secureValueHash_param_type_type_SecureValueType' => 'Secure value type',
   'object_secureValueHash_param_hash_type_bytes' => 'Hash',
-  'object_secureValueErrorData' => 'Secure value error data',
-  'object_secureValueErrorData_param_type_type_SecureValueType' => 'Type',
+  'object_secureValueErrorData' => 'Represents an issue in one of the data fields that was provided by the user. The error is considered resolved when the field\'s value changes.',
+  'object_secureValueErrorData_param_type_type_SecureValueType' => 'The section of the user\'s Telegram Passport which has the error, one of [secureValueTypePersonalDetails](../constructors/secureValueTypePersonalDetails.md), [secureValueTypePassport](../constructors/secureValueTypePassport.md), [secureValueTypeDriverLicense](../constructors/secureValueTypeDriverLicense.md), [secureValueTypeIdentityCard](../constructors/secureValueTypeIdentityCard.md), [secureValueTypeInternalPassport](../constructors/secureValueTypeInternalPassport.md), [secureValueTypeAddress](../constructors/secureValueTypeAddress.md)',
   'object_secureValueErrorData_param_data_hash_type_bytes' => 'Data hash',
-  'object_secureValueErrorData_param_field_type_string' => 'Field',
-  'object_secureValueErrorData_param_text_type_string' => 'Text',
-  'object_secureValueErrorFrontSide' => 'Secure value error front side',
-  'object_secureValueErrorFrontSide_param_type_type_SecureValueType' => 'Type',
+  'object_secureValueErrorData_param_field_type_string' => 'Name of the data field which has the error',
+  'object_secureValueErrorData_param_text_type_string' => 'Error message',
+  'object_secureValueErrorFrontSide' => 'Represents an issue with the front side of a document. The error is considered resolved when the file with the front side of the document changes.',
+  'object_secureValueErrorFrontSide_param_type_type_SecureValueType' => 'One of [secureValueTypePassport](../constructors/secureValueTypePassport.md), [secureValueTypeDriverLicense](../constructors/secureValueTypeDriverLicense.md), [secureValueTypeIdentityCard](../constructors/secureValueTypeIdentityCard.md), [secureValueTypeInternalPassport](../constructors/secureValueTypeInternalPassport.md)',
   'object_secureValueErrorFrontSide_param_file_hash_type_bytes' => 'File hash',
-  'object_secureValueErrorFrontSide_param_text_type_string' => 'Text',
-  'object_secureValueErrorReverseSide' => 'Secure value error reverse side',
-  'object_secureValueErrorReverseSide_param_type_type_SecureValueType' => 'Type',
+  'object_secureValueErrorFrontSide_param_text_type_string' => 'Error message',
+  'object_secureValueErrorReverseSide' => 'Represents an issue with the reverse side of a document. The error is considered resolved when the file with reverse side of the document changes.',
+  'object_secureValueErrorReverseSide_param_type_type_SecureValueType' => 'One of [secureValueTypeDriverLicense](../constructors/secureValueTypeDriverLicense.md), [secureValueTypeIdentityCard](../constructors/secureValueTypeIdentityCard.md)',
   'object_secureValueErrorReverseSide_param_file_hash_type_bytes' => 'File hash',
-  'object_secureValueErrorReverseSide_param_text_type_string' => 'Text',
-  'object_secureValueErrorSelfie' => 'Secure value error selfie',
-  'object_secureValueErrorSelfie_param_type_type_SecureValueType' => 'Type',
+  'object_secureValueErrorReverseSide_param_text_type_string' => 'Error message',
+  'object_secureValueErrorSelfie' => 'Represents an issue with the selfie with a document. The error is considered resolved when the file with the selfie changes.',
+  'object_secureValueErrorSelfie_param_type_type_SecureValueType' => 'One of [secureValueTypePassport](../constructors/secureValueTypePassport.md), [secureValueTypeDriverLicense](../constructors/secureValueTypeDriverLicense.md), [secureValueTypeIdentityCard](../constructors/secureValueTypeIdentityCard.md), [secureValueTypeInternalPassport](../constructors/secureValueTypeInternalPassport.md)',
   'object_secureValueErrorSelfie_param_file_hash_type_bytes' => 'File hash',
-  'object_secureValueErrorSelfie_param_text_type_string' => 'Text',
-  'object_secureValueErrorFile' => 'Secure value error file',
-  'object_secureValueErrorFile_param_type_type_SecureValueType' => 'Type',
+  'object_secureValueErrorSelfie_param_text_type_string' => 'Error message',
+  'object_secureValueErrorFile' => 'Represents an issue with a document scan. The error is considered resolved when the file with the document scan changes.',
+  'object_secureValueErrorFile_param_type_type_SecureValueType' => 'One of [secureValueTypeUtilityBill](../constructors/secureValueTypeUtilityBill.md), [secureValueTypeBankStatement](../constructors/secureValueTypeBankStatement.md), [secureValueTypeRentalAgreement](../constructors/secureValueTypeRentalAgreement.md), [secureValueTypePassportRegistration](../constructors/secureValueTypePassportRegistration.md), [secureValueTypeTemporaryRegistration](../constructors/secureValueTypeTemporaryRegistration.md)',
   'object_secureValueErrorFile_param_file_hash_type_bytes' => 'File hash',
-  'object_secureValueErrorFile_param_text_type_string' => 'Text',
-  'object_secureValueErrorFiles' => 'Secure value error files',
-  'object_secureValueErrorFiles_param_type_type_SecureValueType' => 'Type',
+  'object_secureValueErrorFile_param_text_type_string' => 'Error message',
+  'object_secureValueErrorFiles' => 'Represents an issue with a list of scans. The error is considered resolved when the list of files containing the scans changes.',
+  'object_secureValueErrorFiles_param_type_type_SecureValueType' => 'One of [secureValueTypeUtilityBill](../constructors/secureValueTypeUtilityBill.md), [secureValueTypeBankStatement](../constructors/secureValueTypeBankStatement.md), [secureValueTypeRentalAgreement](../constructors/secureValueTypeRentalAgreement.md), [secureValueTypePassportRegistration](../constructors/secureValueTypePassportRegistration.md), [secureValueTypeTemporaryRegistration](../constructors/secureValueTypeTemporaryRegistration.md)',
   'object_secureValueErrorFiles_param_file_hash_type_Vector t' => 'File hash',
-  'object_secureValueErrorFiles_param_text_type_string' => 'Text',
-  'object_secureCredentialsEncrypted' => 'Secure credentials encrypted',
-  'object_secureCredentialsEncrypted_param_data_type_bytes' => 'Data',
-  'object_secureCredentialsEncrypted_param_hash_type_bytes' => 'Hash',
-  'object_secureCredentialsEncrypted_param_secret_type_bytes' => 'Secret',
-  'object_account.authorizationForm' => 'Telegram passport authorization form',
+  'object_secureValueErrorFiles_param_text_type_string' => 'Error message',
+  'object_secureCredentialsEncrypted' => 'Encrypted credentials required to decrypt [telegram passport](https://core.telegram.org/passport) data.',
+  'object_secureCredentialsEncrypted_param_data_type_bytes' => 'Encrypted JSON-serialized data with unique user\'s payload, data hashes and secrets required for EncryptedPassportElement decryption and authentication, as described in [decrypting data »](https://core.telegram.org/passport#decrypting-data)',
+  'object_secureCredentialsEncrypted_param_hash_type_bytes' => 'Data hash for data authentication as described in [decrypting data »](https://core.telegram.org/passport#decrypting-data)',
+  'object_secureCredentialsEncrypted_param_secret_type_bytes' => 'Secret, encrypted with the bot\'s public RSA key, required for data decryption as described in [decrypting data »](https://core.telegram.org/passport#decrypting-data)',
+  'object_account.authorizationForm' => '[Telegram Passport](https://core.telegram.org/passport) authorization form',
   'object_account.authorizationForm_param_selfie_required_type_true' => 'Selfie required?',
   'object_account.authorizationForm_param_required_types_type_Vector t' => 'Required types',
   'object_account.authorizationForm_param_values_type_Vector t' => 'Values',
   'object_account.authorizationForm_param_errors_type_Vector t' => 'Errors',
   'object_account.authorizationForm_param_users_type_Vector t' => 'Users',
-  'object_account.authorizationForm_param_privacy_policy_url_type_string' => 'Privacy policy URL',
-  'object_account.sentEmailCode' => 'Sent email code',
-  'object_account.sentEmailCode_param_email_pattern_type_string' => 'Email pattern',
-  'object_account.sentEmailCode_param_length_type_int' => 'Length',
-  'object_help.deepLinkInfoEmpty' => 'Empty deep link info',
-  'object_help.deepLinkInfo' => 'Deep link info',
-  'object_help.deepLinkInfo_param_update_app_type_true' => 'Update app?',
-  'object_help.deepLinkInfo_param_message_type_string' => 'Message',
+  'object_account.authorizationForm_param_privacy_policy_url_type_string' => 'URL of the service\'s privacy policy',
+  'object_account.sentEmailCode' => 'The sent email code',
+  'object_account.sentEmailCode_param_email_pattern_type_string' => 'The email (to which the code was sent) must match this [pattern](https://core.telegram.org/api/pattern)',
+  'object_account.sentEmailCode_param_length_type_int' => 'The length of the verification code',
+  'object_help.deepLinkInfoEmpty' => 'Deep link info empty',
+  'object_help.deepLinkInfo' => 'Deep linking info',
+  'object_help.deepLinkInfo_param_update_app_type_true' => 'An update of the app is required to parse this link',
+  'object_help.deepLinkInfo_param_message_type_string' => 'Message to show to the user',
   'object_help.deepLinkInfo_param_entities_type_Vector t' => 'Entities',
-  'method_invokeWithMessagesRange' => 'Invoke with messages range',
-  'method_invokeWithMessagesRange_param_range_type_MessageRange' => 'The range',
-  'method_invokeWithMessagesRange_param_query_type_!X' => 'The query',
-  'method_invokeWithTakeout' => 'Invoke method from takeout session',
-  'method_invokeWithTakeout_param_takeout_id_type_long' => 'The takeout session ID',
-  'method_invokeWithTakeout_param_query_type_!X' => 'The query',
-  'method_account.initTakeoutSession' => 'Start account exporting session',
-  'method_account.initTakeoutSession_param_contacts_type_true' => 'Export contacts?',
-  'method_account.initTakeoutSession_param_message_users_type_true' => 'Export users?',
-  'method_account.initTakeoutSession_param_message_chats_type_true' => 'Export chats?',
-  'method_account.initTakeoutSession_param_message_megagroups_type_true' => 'Export supergroups?',
-  'method_account.initTakeoutSession_param_message_channels_type_true' => 'Export channel messages?',
-  'method_account.initTakeoutSession_param_files_type_true' => 'Export files?',
-  'method_account.initTakeoutSession_param_file_max_size_type_int' => 'Export only files smaller than this size',
-  'method_account.finishTakeoutSession' => 'Finish account exporting session',
-  'method_account.finishTakeoutSession_param_success_type_true' => 'Did the data export succeed?',
-  'method_contacts.getSaved' => 'Get saved contacts',
-  'method_messages.getSplitRanges' => 'Get message ranges to fetch',
-  'method_channels.getLeftChannels' => 'Get all channels you left',
-  'method_channels.getLeftChannels_param_offset_type_int' => 'Offset',
+  'method_invokeWithMessagesRange' => 'Invoke with the given message range',
+  'method_invokeWithMessagesRange_param_range_type_MessageRange' => 'Message range',
+  'method_invokeWithMessagesRange_param_query_type_!X' => 'Query',
+  'method_invokeWithTakeout' => 'Invoke a method within a takeout session',
+  'method_invokeWithTakeout_param_takeout_id_type_long' => 'Takeout session ID',
+  'method_invokeWithTakeout_param_query_type_!X' => 'Query',
+  'method_account.initTakeoutSession' => 'Intialize account takeout session',
+  'method_account.initTakeoutSession_param_contacts_type_true' => 'Whether to export contacts',
+  'method_account.initTakeoutSession_param_message_users_type_true' => 'Whether to export messages in private chats',
+  'method_account.initTakeoutSession_param_message_chats_type_true' => 'Whether to export messages in [legacy groups](https://core.telegram.org/api/channel)',
+  'method_account.initTakeoutSession_param_message_megagroups_type_true' => 'Whether to export messages in [supergroups](https://core.telegram.org/api/channel)',
+  'method_account.initTakeoutSession_param_message_channels_type_true' => 'Whether to export messages in [channels](https://core.telegram.org/api/channel)',
+  'method_account.initTakeoutSession_param_files_type_true' => 'Whether to export files',
+  'method_account.initTakeoutSession_param_file_max_size_type_int' => 'Maximum size of files to export',
+  'method_account.finishTakeoutSession' => 'Finish account takeout session',
+  'method_account.finishTakeoutSession_param_success_type_true' => 'Data exported successfully',
+  'method_contacts.getSaved' => 'Get all contacts',
+  'method_messages.getSplitRanges' => 'Get message ranges for saving the user\'s chat history',
+  'method_channels.getLeftChannels' => 'Get a list of [channels/supergroups](https://core.telegram.org/api/channel) we left',
+  'method_channels.getLeftChannels_param_offset_type_int' => 'Offset for [pagination](https://core.telegram.org/api/offsets)',
   'object_ipPortSecret' => 'Ip port secret',
   'object_ipPortSecret_param_ipv4_type_int' => 'Ipv4',
   'object_ipPortSecret_param_port_type_int' => 'Port',
@@ -9484,42 +9890,42 @@ class Lang
   'object_accessPointRule_param_dc_id_type_int' => 'DC ID',
   'object_accessPointRule_param_ips_type_vector' => 'Ips',
   'object_help.configSimple_param_rules_type_vector' => 'Rules',
-  'object_inputTakeoutFileLocation' => 'Takeout file location',
-  'object_savedPhoneContact' => 'Saved phone contact',
-  'object_savedPhoneContact_param_phone_type_string' => 'Phone',
+  'object_inputTakeoutFileLocation' => 'Empty constructor for takeout',
+  'object_savedPhoneContact' => 'Saved contact',
+  'object_savedPhoneContact_param_phone_type_string' => 'Phone number',
   'object_savedPhoneContact_param_first_name_type_string' => 'First name',
   'object_savedPhoneContact_param_last_name_type_string' => 'Last name',
-  'object_savedPhoneContact_param_date_type_int' => 'Date',
-  'object_account.takeout' => 'Takeout',
-  'object_account.takeout_param_id_type_long' => 'ID',
-  'method_contacts.toggleTopPeers' => 'Toggle top peers',
-  'method_contacts.toggleTopPeers_param_enabled_type_Bool' => 'Enable or disable top peer',
-  'method_messages.getDialogs_param_hash_type_int' => 'IDs of previously fetched dialogs',
-  'method_messages.markDialogUnread' => 'Mark dialog as unread ',
-  'method_messages.markDialogUnread_param_unread_type_true' => 'Should it be marked or unmarked as read',
-  'method_messages.markDialogUnread_param_peer_type_InputDialogPeer' => 'The dialog to mark as unread',
-  'method_messages.getDialogUnreadMarks' => 'Get dialogs marked as unread manually',
-  'object_inputMediaContact_param_vcard_type_string' => 'Vcard',
-  'object_messageMediaContact_param_vcard_type_string' => 'Vcard',
-  'object_dialog_param_unread_mark_type_true' => 'Unread mark?',
+  'object_savedPhoneContact_param_date_type_int' => 'Date added',
+  'object_account.takeout' => 'Takout info',
+  'object_account.takeout_param_id_type_long' => 'Takeout ID',
+  'method_contacts.toggleTopPeers' => 'Enable/disable [top peers](https://core.telegram.org/api/top-rating)',
+  'method_contacts.toggleTopPeers_param_enabled_type_Bool' => 'Enable/disable',
+  'method_messages.getDialogs_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_messages.markDialogUnread' => 'Manually mark dialog as unread',
+  'method_messages.markDialogUnread_param_unread_type_true' => 'Mark as unread/read',
+  'method_messages.markDialogUnread_param_peer_type_InputDialogPeer' => 'Dialog',
+  'method_messages.getDialogUnreadMarks' => 'Get dialogs manually marked as unread',
+  'object_inputMediaContact_param_vcard_type_string' => 'Contact vcard',
+  'object_messageMediaContact_param_vcard_type_string' => 'VCARD of contact',
+  'object_dialog_param_unread_mark_type_true' => 'Whether the chat was manually marked as unread',
   'object_geoPoint_param_access_hash_type_long' => 'Access hash',
-  'object_messages.dialogsNotModified' => 'Dialogs not modified',
-  'object_messages.dialogsNotModified_param_count_type_int' => 'Count',
-  'object_updateDialogUnreadMark' => 'Update dialog unread mark',
-  'object_updateDialogUnreadMark_param_unread_type_true' => 'Unread?',
-  'object_updateDialogUnreadMark_param_peer_type_DialogPeer' => 'Peer',
-  'object_config_param_dc_txt_domain_name_type_string' => 'DC txt domain name',
-  'object_config_param_gif_search_username_type_string' => 'Gif search username',
-  'object_config_param_venue_search_username_type_string' => 'Venue search username',
-  'object_config_param_img_search_username_type_string' => 'Img search username',
-  'object_config_param_static_maps_provider_type_string' => 'Static maps provider',
-  'object_config_param_caption_length_max_type_int' => 'Caption length max',
-  'object_config_param_message_length_max_type_int' => 'Message length max',
-  'object_config_param_webfile_dc_id_type_int' => 'Webfile DC ID',
-  'object_inputBotInlineMessageMediaContact_param_vcard_type_string' => 'Vcard',
-  'object_botInlineMessageMediaContact_param_vcard_type_string' => 'Vcard',
+  'object_messages.dialogsNotModified' => 'Dialogs haven\'t changed',
+  'object_messages.dialogsNotModified_param_count_type_int' => 'Number of dialogs found server-side by the query',
+  'object_updateDialogUnreadMark' => 'The manual unread mark of a chat was changed',
+  'object_updateDialogUnreadMark_param_unread_type_true' => 'Was the chat marked or unmarked as read',
+  'object_updateDialogUnreadMark_param_peer_type_DialogPeer' => 'The dialog',
+  'object_config_param_dc_txt_domain_name_type_string' => 'Domain name for fetching encrypted DC list from DNS TXT record',
+  'object_config_param_gif_search_username_type_string' => 'Username of the bot to use to search for GIFs',
+  'object_config_param_venue_search_username_type_string' => 'Username of the bot to use to search for venues',
+  'object_config_param_img_search_username_type_string' => 'Username of the bot to use for image search',
+  'object_config_param_static_maps_provider_type_string' => 'ID of the map provider to use for venues',
+  'object_config_param_caption_length_max_type_int' => 'Maximum length of caption (length in utf8 codepoints)',
+  'object_config_param_message_length_max_type_int' => 'Maximum length of messages (length in utf8 codepoints)',
+  'object_config_param_webfile_dc_id_type_int' => 'DC ID to use to download [webfiles](https://core.telegram.org/api/files)',
+  'object_inputBotInlineMessageMediaContact_param_vcard_type_string' => 'VCard info',
+  'object_botInlineMessageMediaContact_param_vcard_type_string' => 'VCard info',
   'object_contacts.topPeersDisabled' => 'Top peers disabled',
-  'object_draftMessageEmpty_param_date_type_int' => 'Date',
+  'object_draftMessageEmpty_param_date_type_int' => 'When was the draft last updated',
   'object_inputWebFileGeoPointLocation_param_access_hash_type_long' => 'Access hash',
   'method_contacts.getContacts_param_hash_type_Vector t' => 'User IDs of previously cached contacts',
   'method_contacts.getTopPeers_param_hash_type_Vector t' => 'Peer IDs of previously cached peers',
@@ -9537,710 +9943,712 @@ class Lang
   'method_messages.getRecentLocations_param_hash_type_Vector t' => 'IDs of locations you already fetched',
   'method_messages.searchStickerSets_param_hash_type_Vector t' => 'The IDs of stickersets you already fetched',
   'method_channels.getParticipants_param_hash_type_Vector t' => 'IDs of previously fetched participants',
-  'method_auth.checkPassword_param_password_type_InputCheckPasswordSRP' => 'You cannot use this method directly, use the complete_2fa_login method instead (see https://docs.madelineproto.xyz for more info)',
-  'method_account.getPasswordSettings_param_password_type_InputCheckPasswordSRP' => 'You cannot use this method directly; use $MadelineProto->update_2fa($params), instead (see https://docs.madelineproto.xyz for more info)',
-  'method_account.updatePasswordSettings_param_password_type_InputCheckPasswordSRP' => 'You cannot use this method directly; use $MadelineProto->update_2fa($params), instead (see https://docs.madelineproto.xyz for more info)',
-  'method_account.getTmpPassword_param_password_type_InputCheckPasswordSRP' => 'Password',
-  'method_account.confirmPasswordEmail' => 'Confirm password recovery using email',
-  'method_account.confirmPasswordEmail_param_code_type_string' => 'Code',
-  'method_account.resendPasswordEmail' => 'Resend password recovery email',
-  'method_account.cancelPasswordEmail' => 'Cancel password recovery email',
-  'method_account.getContactSignUpNotification' => 'Contact signup notification setting value',
-  'method_account.setContactSignUpNotification' => 'Set contact sign up notification',
-  'method_account.setContactSignUpNotification_param_silent_type_Bool' => 'Silent?',
-  'method_account.getNotifyExceptions' => 'Get notification exceptions',
-  'method_account.getNotifyExceptions_param_compare_sound_type_true' => 'Compare sound?',
-  'method_account.getNotifyExceptions_param_peer_type_InputNotifyPeer' => 'Peer',
-  'method_contacts.getContactIDs' => 'Get contacts by IDs',
+  'method_auth.checkPassword_param_password_type_InputCheckPasswordSRP' => 'The account\'s password (see [SRP](https://core.telegram.org/api/srp))',
+  'method_account.getPasswordSettings_param_password_type_InputCheckPasswordSRP' => 'The password (see [SRP](https://core.telegram.org/api/srp))',
+  'method_account.updatePasswordSettings_param_password_type_InputCheckPasswordSRP' => 'The old password (see [SRP](https://core.telegram.org/api/srp))',
+  'method_account.getTmpPassword_param_password_type_InputCheckPasswordSRP' => 'SRP password parameters',
+  'method_account.confirmPasswordEmail' => 'Verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp).',
+  'method_account.confirmPasswordEmail_param_code_type_string' => 'The phone code that was received after [setting a recovery email](https://core.telegram.org/api/srp#email-verification)',
+  'method_account.resendPasswordEmail' => 'Resend the code to verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp).',
+  'method_account.cancelPasswordEmail' => 'Cancel the code that was sent to verify an email to use as [2FA recovery method](https://core.telegram.org/api/srp).',
+  'method_account.getContactSignUpNotification' => 'Whether the user will receive notifications when contacts sign up',
+  'method_account.setContactSignUpNotification' => 'Toggle contact sign up notifications',
+  'method_account.setContactSignUpNotification_param_silent_type_Bool' => 'Whether to disable contact sign up notifications',
+  'method_account.getNotifyExceptions' => 'Returns list of chats with non-default notification settings',
+  'method_account.getNotifyExceptions_param_compare_sound_type_true' => 'If true, chats with non-default sound will also be returned',
+  'method_account.getNotifyExceptions_param_peer_type_InputNotifyPeer' => 'If specified, only chats of the specified category will be returned',
+  'method_contacts.getContactIDs' => 'Get contact by telegram IDs',
   'method_contacts.getContactIDs_param_hash_type_Vector t' => 'Previously fetched IDs',
-  'method_contacts.deleteByPhones' => 'Delete contacts by phones',
+  'method_contacts.deleteByPhones' => 'Delete contacts by phone number',
   'method_contacts.deleteByPhones_param_phones_type_Vector t' => 'Phones',
-  'method_messages.sendInlineBotResult_param_hide_via_type_true' => 'Hide "via @bot"',
-  'method_messages.clearAllDrafts' => 'Clear all drafts',
-  'method_messages.updatePinnedMessage' => 'Update pinned message',
-  'method_messages.updatePinnedMessage_param_silent_type_true' => 'Silent?',
-  'method_messages.updatePinnedMessage_param_peer_type_InputPeer' => 'Peer',
-  'method_messages.updatePinnedMessage_param_id_type_int' => 'Message ID',
-  'method_messages.sendVote' => 'Send vote',
-  'method_messages.sendVote_param_peer_type_InputPeer' => 'Peer',
-  'method_messages.sendVote_param_msg_id_type_int' => 'Message ID',
+  'method_messages.sendInlineBotResult_param_hide_via_type_true' => 'Whether to hide the `via @botname` in the resulting message (only for bot usernames encountered in the [config](../constructors/config.md))',
+  'method_messages.clearAllDrafts' => 'Clear all [drafts](https://core.telegram.org/api/drafts).',
+  'method_messages.updatePinnedMessage' => 'Pin a message',
+  'method_messages.updatePinnedMessage_param_silent_type_true' => 'Pin the message silently, without triggering a notification',
+  'method_messages.updatePinnedMessage_param_peer_type_InputPeer' => 'The peer where to pin the message',
+  'method_messages.updatePinnedMessage_param_id_type_int' => 'The message to pin, can be 0 to unpin any currently pinned messages',
+  'method_messages.sendVote' => 'Vote in a [poll](../constructors/poll.md)',
+  'method_messages.sendVote_param_peer_type_InputPeer' => 'The chat where the poll was sent',
+  'method_messages.sendVote_param_msg_id_type_int' => 'The message ID of the poll',
   'method_messages.sendVote_param_options_type_Vector t' => 'Options',
   'method_messages.getPollResults' => 'Get poll results',
-  'method_messages.getPollResults_param_peer_type_InputPeer' => 'Peer',
-  'method_messages.getPollResults_param_msg_id_type_int' => 'Message ID',
-  'method_messages.getOnlines' => 'Get online users',
-  'method_messages.getOnlines_param_peer_type_InputPeer' => 'Peer',
-  'method_messages.getStatsURL' => 'Get stats URL',
-  'method_messages.getStatsURL_param_peer_type_InputPeer' => 'Peer',
+  'method_messages.getPollResults_param_peer_type_InputPeer' => 'Peer where the poll was found',
+  'method_messages.getPollResults_param_msg_id_type_int' => 'Message ID of poll message',
+  'method_messages.getOnlines' => 'Get count of online users in a chat',
+  'method_messages.getOnlines_param_peer_type_InputPeer' => 'The chat',
+  'method_messages.getStatsURL' => 'Returns URL with the chat statistics. Currently this method can be used only for channels',
+  'method_messages.getStatsURL_param_peer_type_InputPeer' => 'Chat identifier',
   'method_help.getAppUpdate_param_source_type_string' => 'Source',
-  'method_help.getAppConfig' => 'Get app config',
-  'method_help.getPassportConfig' => 'Get passport config',
+  'method_help.getAppConfig' => 'Get app-specific configuration',
+  'method_help.getPassportConfig' => 'Get [passport](https://core.telegram.org/passport) configuration',
   'method_help.getPassportConfig_param_hash_type_Vector t' => 'Hash',
-  'method_help.getSupportName' => 'Get support name',
-  'method_help.getUserInfo' => 'Get user info',
+  'method_help.getSupportName' => 'Get localized name of the telegram support user',
+  'method_help.getUserInfo' => 'Internal use',
   'method_help.getUserInfo_param_user_id_type_InputUser' => 'User ID',
-  'method_help.editUserInfo' => 'Edit user info',
-  'method_help.editUserInfo_param_user_id_type_InputUser' => 'User ID',
+  'method_help.editUserInfo' => 'Internal use',
+  'method_help.editUserInfo_param_user_id_type_InputUser' => 'User',
   'method_help.editUserInfo_param_message_type_string' => 'Message',
   'method_help.editUserInfo_param_entities_type_Vector t' => 'Entities',
-  'method_langpack.getLangPack_param_lang_pack_type_string' => 'Lang pack',
-  'method_langpack.getStrings_param_lang_pack_type_string' => 'Lang pack',
-  'method_langpack.getDifference_param_lang_code_type_string' => 'Lang code',
-  'method_langpack.getLanguages_param_lang_pack_type_string' => 'Lang pack',
-  'method_langpack.getLanguage' => 'Get language',
-  'method_langpack.getLanguage_param_lang_pack_type_string' => 'Lang pack',
-  'method_langpack.getLanguage_param_lang_code_type_string' => 'Lang code',
-  'object_inputMediaGeoLive_param_stopped_type_true' => 'Stopped?',
-  'object_inputMediaPoll' => 'Media poll',
-  'object_inputMediaPoll_param_poll_type_Poll' => 'Poll',
-  'object_inputPhoto_param_file_reference_type_bytes' => 'File reference',
-  'object_inputFileLocation_param_file_reference_type_bytes' => 'File reference',
-  'object_inputDocumentFileLocation_param_file_reference_type_bytes' => 'File reference',
+  'method_langpack.getLangPack_param_lang_pack_type_string' => 'Language pack name',
+  'method_langpack.getStrings_param_lang_pack_type_string' => 'Language pack name',
+  'method_langpack.getDifference_param_lang_code_type_string' => 'Language code',
+  'method_langpack.getLanguages_param_lang_pack_type_string' => 'Language pack',
+  'method_langpack.getLanguage' => 'Get information about a language in a localization pack',
+  'method_langpack.getLanguage_param_lang_pack_type_string' => 'Language pack name',
+  'method_langpack.getLanguage_param_lang_code_type_string' => 'Language code',
+  'object_inputMediaGeoLive_param_stopped_type_true' => 'Whether sending of the geolocation was stopped',
+  'object_inputMediaPoll' => 'A poll',
+  'object_inputMediaPoll_param_poll_type_Poll' => 'The poll to send',
+  'object_inputPhoto_param_file_reference_type_bytes' => '[File reference](https://core.telegram.org/api/file_reference)',
+  'object_inputFileLocation_param_file_reference_type_bytes' => '[File reference](https://core.telegram.org/api/file_reference)',
+  'object_inputDocumentFileLocation_param_file_reference_type_bytes' => '[File reference](https://core.telegram.org/api/file_reference)',
   'object_fileLocation_param_file_reference_type_bytes' => 'File reference',
-  'object_chatFull_param_pinned_msg_id_type_int' => 'Pinned msg ID',
-  'object_channelFull_param_can_view_stats_type_true' => 'Can view stats?',
-  'object_channelFull_param_online_count_type_int' => 'Online count',
-  'object_message_param_from_scheduled_type_true' => 'From scheduled?',
-  'object_messageMediaPoll' => 'Message media poll',
-  'object_messageMediaPoll_param_poll_type_Poll' => 'Poll',
-  'object_messageMediaPoll_param_results_type_PollResults' => 'Results',
-  'object_messageActionContactSignUp' => 'Message action contact sign up',
-  'object_photo_param_file_reference_type_bytes' => 'File reference',
-  'object_inputNotifyBroadcasts' => 'Notify broadcasts',
-  'object_inputReportReasonChildAbuse' => 'Report reason child abuse',
-  'object_inputReportReasonCopyright' => 'Report reason copyright',
-  'object_userFull_param_can_pin_message_type_true' => 'Can pin message?',
-  'object_userFull_param_pinned_msg_id_type_int' => 'Pinned msg ID',
-  'object_messages.channelMessages_param_inexact_type_true' => 'Inexact?',
-  'object_updateLangPackTooLong_param_lang_code_type_string' => 'Lang code',
-  'object_updateUserPinnedMessage' => 'Update user pinned message',
-  'object_updateUserPinnedMessage_param_user_id_type_int' => 'User ID',
-  'object_updateUserPinnedMessage_param_id_type_int' => 'ID',
-  'object_updateChatPinnedMessage' => 'Update chat pinned message',
-  'object_updateChatPinnedMessage_param_chat_id_type_int' => 'Chat ID',
-  'object_updateChatPinnedMessage_param_id_type_int' => 'ID',
-  'object_updateMessagePoll' => 'Update message poll',
+  'object_chatFull_param_pinned_msg_id_type_int' => 'Message ID of the pinned message',
+  'object_channelFull_param_can_view_stats_type_true' => 'Can the user call [messages.getStatsURL](../methods/messages.getStatsURL.md) on this channel',
+  'object_channelFull_param_online_count_type_int' => 'Number of users currently online',
+  'object_message_param_from_scheduled_type_true' => 'Whether this is a scheduled post',
+  'object_messageMediaPoll' => 'Poll',
+  'object_messageMediaPoll_param_poll_type_Poll' => 'The poll',
+  'object_messageMediaPoll_param_results_type_PollResults' => 'The results of the poll',
+  'object_messageActionContactSignUp' => 'A contact just signed up to telegram',
+  'object_photo_param_file_reference_type_bytes' => '[file reference](https://core.telegram.org/api/file_reference)',
+  'object_inputNotifyBroadcasts' => 'All [channels](https://core.telegram.org/api/channel)',
+  'object_inputReportReasonChildAbuse' => 'Report for child abuse',
+  'object_inputReportReasonCopyright' => 'Report for copyrighted content',
+  'object_userFull_param_can_pin_message_type_true' => 'Whether you can pin messages in the chat with this user, you can do this only for a chat with yourself',
+  'object_userFull_param_pinned_msg_id_type_int' => 'Pinned message ID, you can only pin messages in a chat with yourself',
+  'object_messages.channelMessages_param_inexact_type_true' => 'If set, returned results may be inexact',
+  'object_updateLangPackTooLong_param_lang_code_type_string' => 'Language code',
+  'object_updateUserPinnedMessage' => 'A message was pinned in a private chat with a user',
+  'object_updateUserPinnedMessage_param_user_id_type_int' => 'User that pinned the message',
+  'object_updateUserPinnedMessage_param_id_type_int' => 'Message ID that was pinned',
+  'object_updateChatPinnedMessage' => 'A message was pinned in a [legacy group](https://core.telegram.org/api/channel)',
+  'object_updateChatPinnedMessage_param_chat_id_type_int' => '[Legacy group](https://core.telegram.org/api/channel) ID',
+  'object_updateChatPinnedMessage_param_id_type_int' => 'ID of pinned message',
+  'object_updateMessagePoll' => 'The results of a poll have changed',
   'object_updateMessagePoll_param_poll_id_type_long' => 'Poll ID',
-  'object_updateMessagePoll_param_poll_type_Poll' => 'Poll',
-  'object_updateMessagePoll_param_results_type_PollResults' => 'Results',
-  'object_config_param_pfs_enabled_type_true' => 'Pfs enabled?',
-  'object_config_param_base_lang_pack_version_type_int' => 'Base lang pack version',
+  'object_updateMessagePoll_param_poll_type_Poll' => 'If the server knows the client hasn\'t cached this poll yet, the poll itself',
+  'object_updateMessagePoll_param_results_type_PollResults' => 'New poll results',
+  'object_config_param_pfs_enabled_type_true' => 'Whether [pfs](https://core.telegram.org/api/pfs) was used',
+  'object_config_param_base_lang_pack_version_type_int' => 'Basic language pack version',
   'object_help.appUpdate_param_popup_type_true' => 'Popup?',
-  'object_help.appUpdate_param_version_type_string' => 'Version',
+  'object_help.appUpdate_param_version_type_string' => 'New version name',
   'object_help.appUpdate_param_entities_type_Vector t' => 'Entities',
-  'object_help.appUpdate_param_document_type_Document' => 'Document',
-  'object_inputDocument_param_file_reference_type_bytes' => 'File reference',
-  'object_document_param_file_reference_type_bytes' => 'File reference',
-  'object_notifyBroadcasts' => 'Notify broadcasts',
-  'object_inputPrivacyKeyPhoneP2P' => 'Privacy key phone p2p',
-  'object_privacyKeyPhoneP2P' => 'Privacy key phone p2p',
-  'object_authorization_param_current_type_true' => 'Current?',
-  'object_authorization_param_official_app_type_true' => 'Official app?',
-  'object_authorization_param_password_pending_type_true' => 'Password pending?',
-  'object_account.password_param_has_password_type_true' => 'Has password?',
-  'object_account.password_param_current_algo_type_PasswordKdfAlgo' => 'Current algo',
-  'object_account.password_param_srp_B_type_bytes' => 'Srp b',
-  'object_account.password_param_srp_id_type_long' => 'Srp ID',
-  'object_account.password_param_new_algo_type_PasswordKdfAlgo' => 'New algo',
-  'object_account.password_param_new_secure_algo_type_SecurePasswordKdfAlgo' => 'New secure algo',
-  'object_account.passwordSettings_param_secure_settings_type_SecureSecretSettings' => 'Secure settings',
-  'object_account.passwordInputSettings_param_new_algo_type_PasswordKdfAlgo' => 'New algo',
-  'object_account.passwordInputSettings_param_new_secure_settings_type_SecureSecretSettings' => 'New secure settings',
-  'object_textSubscript' => 'Text subscript',
+  'object_help.appUpdate_param_document_type_Document' => 'Attached document',
+  'object_inputDocument_param_file_reference_type_bytes' => '[File reference](https://core.telegram.org/api/file_reference)',
+  'object_document_param_file_reference_type_bytes' => '[File reference](https://core.telegram.org/api/file_reference)',
+  'object_notifyBroadcasts' => 'Channel notification settings',
+  'object_inputPrivacyKeyPhoneP2P' => 'Whether the user allows P2P communication during VoIP calls',
+  'object_privacyKeyPhoneP2P' => 'Whether P2P connections in phone calls are allowed',
+  'object_authorization_param_current_type_true' => 'Whether this is the current session',
+  'object_authorization_param_official_app_type_true' => 'Whether the session is from an official app',
+  'object_authorization_param_password_pending_type_true' => 'Whether the session is still waiting for a 2FA password',
+  'object_account.password_param_has_password_type_true' => 'Whether the user has a password',
+  'object_account.password_param_current_algo_type_PasswordKdfAlgo' => 'The [KDF algorithm for SRP two-factor authentication](https://core.telegram.org/api/srp) of the current password',
+  'object_account.password_param_srp_B_type_bytes' => 'Srp B param for [SRP authorization](https://core.telegram.org/api/srp)',
+  'object_account.password_param_srp_id_type_long' => 'Srp ID param for [SRP authorization](https://core.telegram.org/api/srp)',
+  'object_account.password_param_new_algo_type_PasswordKdfAlgo' => 'The [KDF algorithm for SRP two-factor authentication](https://core.telegram.org/api/srp) to use when creating new passwords',
+  'object_account.password_param_new_secure_algo_type_SecurePasswordKdfAlgo' => 'The KDF algorithm for telegram [passport](https://core.telegram.org/passport)',
+  'object_account.passwordSettings_param_secure_settings_type_SecureSecretSettings' => 'Telegram [passport](https://core.telegram.org/passport) settings',
+  'object_account.passwordInputSettings_param_new_algo_type_PasswordKdfAlgo' => 'The [SRP algorithm](https://core.telegram.org/api/srp) to use',
+  'object_account.passwordInputSettings_param_new_secure_settings_type_SecureSecretSettings' => 'Telegram [passport](https://core.telegram.org/passport) settings',
+  'object_textSubscript' => 'Subscript text',
   'object_textSubscript_param_text_type_RichText' => 'Text',
-  'object_textSuperscript' => 'Text superscript',
+  'object_textSuperscript' => 'Superscript text',
   'object_textSuperscript_param_text_type_RichText' => 'Text',
-  'object_textMarked' => 'Text marked',
+  'object_textMarked' => 'Highlighted text',
   'object_textMarked_param_text_type_RichText' => 'Text',
-  'object_textPhone' => 'Text phone',
+  'object_textPhone' => 'Rich text linked to a phone number',
   'object_textPhone_param_text_type_RichText' => 'Text',
-  'object_textPhone_param_phone_type_string' => 'Phone',
-  'object_textImage' => 'Text image',
+  'object_textPhone_param_phone_type_string' => 'Phone number',
+  'object_textImage' => 'Inline image',
   'object_textImage_param_document_id_type_long' => 'Document ID',
   'object_textImage_param_w_type_int' => 'Width',
   'object_textImage_param_h_type_int' => 'Height',
-  'object_textAnchor' => 'Text anchor',
+  'object_textAnchor' => 'Text linking to another section of the page',
   'object_textAnchor_param_text_type_RichText' => 'Text',
-  'object_textAnchor_param_name_type_string' => 'Name',
+  'object_textAnchor_param_name_type_string' => 'Section name',
   'object_pageBlockPhoto_param_caption_type_PageCaption' => 'Caption',
-  'object_pageBlockPhoto_param_url_type_string' => 'URL',
-  'object_pageBlockPhoto_param_webpage_id_type_long' => 'Webpage ID',
+  'object_pageBlockPhoto_param_url_type_string' => 'HTTP URL of page the photo leads to when clicked',
+  'object_pageBlockPhoto_param_webpage_id_type_long' => 'ID of preview of the page the photo leads to when clicked',
   'object_pageBlockVideo_param_caption_type_PageCaption' => 'Caption',
   'object_pageBlockEmbed_param_caption_type_PageCaption' => 'Caption',
   'object_pageBlockEmbedPost_param_caption_type_PageCaption' => 'Caption',
   'object_pageBlockCollage_param_caption_type_PageCaption' => 'Caption',
   'object_pageBlockSlideshow_param_caption_type_PageCaption' => 'Caption',
-  'object_pageBlockAudio_param_caption_type_PageCaption' => 'Caption',
-  'object_pageBlockKicker' => 'Page block kicker',
-  'object_pageBlockKicker_param_text_type_RichText' => 'Text',
-  'object_pageBlockTable' => 'Page block table',
-  'object_pageBlockTable_param_bordered_type_true' => 'Bordered?',
-  'object_pageBlockTable_param_striped_type_true' => 'Striped?',
+  'object_pageBlockAudio_param_caption_type_PageCaption' => 'Audio caption',
+  'object_pageBlockKicker' => 'Kicker',
+  'object_pageBlockKicker_param_text_type_RichText' => 'Contents',
+  'object_pageBlockTable' => 'Table',
+  'object_pageBlockTable_param_bordered_type_true' => 'Does the table have a visible border?',
+  'object_pageBlockTable_param_striped_type_true' => 'Is the table striped?',
   'object_pageBlockTable_param_title_type_RichText' => 'Title',
   'object_pageBlockTable_param_rows_type_Vector t' => 'Rows',
-  'object_pageBlockOrderedList' => 'Page block ordered list',
+  'object_pageBlockOrderedList' => 'Ordered list of IV blocks',
   'object_pageBlockOrderedList_param_items_type_Vector t' => 'Items',
-  'object_pageBlockDetails' => 'Page block details',
-  'object_pageBlockDetails_param_open_type_true' => 'Open?',
+  'object_pageBlockDetails' => 'A collapsible details block',
+  'object_pageBlockDetails_param_open_type_true' => 'Whether the block is open by default',
   'object_pageBlockDetails_param_blocks_type_Vector t' => 'Blocks',
-  'object_pageBlockDetails_param_title_type_RichText' => 'Title',
-  'object_pageBlockRelatedArticles' => 'Page block related articles',
+  'object_pageBlockDetails_param_title_type_RichText' => 'Always visible heading for the block',
+  'object_pageBlockRelatedArticles' => 'Related articles',
   'object_pageBlockRelatedArticles_param_title_type_RichText' => 'Title',
   'object_pageBlockRelatedArticles_param_articles_type_Vector t' => 'Articles',
-  'object_pageBlockMap' => 'Page block map',
-  'object_pageBlockMap_param_geo_type_GeoPoint' => 'Geo',
-  'object_pageBlockMap_param_zoom_type_int' => 'Zoom',
-  'object_pageBlockMap_param_w_type_int' => 'Width',
-  'object_pageBlockMap_param_h_type_int' => 'Height',
+  'object_pageBlockMap' => 'A map',
+  'object_pageBlockMap_param_geo_type_GeoPoint' => 'Location of the map center',
+  'object_pageBlockMap_param_zoom_type_int' => 'Map zoom level; 13-20',
+  'object_pageBlockMap_param_w_type_int' => 'Map width in pixels before applying scale; 16-102',
+  'object_pageBlockMap_param_h_type_int' => 'Map height in pixels before applying scale; 16-1024',
   'object_pageBlockMap_param_caption_type_PageCaption' => 'Caption',
-  'object_phoneCall_param_p2p_allowed_type_true' => 'P2p allowed?',
-  'object_langPackLanguage_param_official_type_true' => 'Official?',
-  'object_langPackLanguage_param_rtl_type_true' => 'Rtl?',
-  'object_langPackLanguage_param_beta_type_true' => 'Beta?',
-  'object_langPackLanguage_param_base_lang_code_type_string' => 'Base lang code',
-  'object_langPackLanguage_param_plural_code_type_string' => 'Plural code',
-  'object_langPackLanguage_param_strings_count_type_int' => 'Strings count',
-  'object_langPackLanguage_param_translated_count_type_int' => 'Translated count',
-  'object_langPackLanguage_param_translations_url_type_string' => 'Translations URL',
+  'object_phoneCall_param_p2p_allowed_type_true' => 'Whether P2P connection to the other peer is allowed',
+  'object_langPackLanguage_param_official_type_true' => 'Whether the language pack is official',
+  'object_langPackLanguage_param_rtl_type_true' => 'Is this a localization pack for an RTL language',
+  'object_langPackLanguage_param_beta_type_true' => 'Is this a beta localization pack?',
+  'object_langPackLanguage_param_base_lang_code_type_string' => 'Identifier of a base language pack; may be empty. If a string is missed in the language pack, then it should be fetched from base language pack. Unsupported in custom language packs',
+  'object_langPackLanguage_param_plural_code_type_string' => 'A language code to be used to apply plural forms. See [https://www.unicode.org/cldr/charts/latest/supplemental/language\\_plural\\_rules.html](https://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html) for more info',
+  'object_langPackLanguage_param_strings_count_type_int' => 'Total number of non-deleted strings from the language pack',
+  'object_langPackLanguage_param_translated_count_type_int' => 'Total number of translated strings from the language pack',
+  'object_langPackLanguage_param_translations_url_type_string' => 'Link to language translation interface; empty for custom local language packs',
   'object_secureValue_param_translation_type_Vector t' => 'Translation',
   'object_inputSecureValue_param_translation_type_Vector t' => 'Translation',
   'object_secureValueError' => 'Secure value error',
-  'object_secureValueError_param_type_type_SecureValueType' => 'Type',
+  'object_secureValueError_param_type_type_SecureValueType' => 'Type of element which has the issue',
   'object_secureValueError_param_hash_type_bytes' => 'Hash',
-  'object_secureValueError_param_text_type_string' => 'Text',
-  'object_secureValueErrorTranslationFile' => 'Secure value error translation file',
-  'object_secureValueErrorTranslationFile_param_type_type_SecureValueType' => 'Type',
+  'object_secureValueError_param_text_type_string' => 'Error message',
+  'object_secureValueErrorTranslationFile' => 'Represents an issue with one of the files that constitute the translation of a document. The error is considered resolved when the file changes.',
+  'object_secureValueErrorTranslationFile_param_type_type_SecureValueType' => 'One of [secureValueTypePersonalDetails](../constructors/secureValueTypePersonalDetails.md), [secureValueTypePassport](../constructors/secureValueTypePassport.md), [secureValueTypeDriverLicense](../constructors/secureValueTypeDriverLicense.md), [secureValueTypeIdentityCard](../constructors/secureValueTypeIdentityCard.md), [secureValueTypeInternalPassport](../constructors/secureValueTypeInternalPassport.md), [secureValueTypeUtilityBill](../constructors/secureValueTypeUtilityBill.md), [secureValueTypeBankStatement](../constructors/secureValueTypeBankStatement.md), [secureValueTypeRentalAgreement](../constructors/secureValueTypeRentalAgreement.md), [secureValueTypePassportRegistration](../constructors/secureValueTypePassportRegistration.md), [secureValueTypeTemporaryRegistration](../constructors/secureValueTypeTemporaryRegistration.md)',
   'object_secureValueErrorTranslationFile_param_file_hash_type_bytes' => 'File hash',
-  'object_secureValueErrorTranslationFile_param_text_type_string' => 'Text',
-  'object_secureValueErrorTranslationFiles' => 'Secure value error translation files',
-  'object_secureValueErrorTranslationFiles_param_type_type_SecureValueType' => 'Type',
+  'object_secureValueErrorTranslationFile_param_text_type_string' => 'Error message',
+  'object_secureValueErrorTranslationFiles' => 'Represents an issue with the translated version of a document. The error is considered resolved when a file with the document translation changes.',
+  'object_secureValueErrorTranslationFiles_param_type_type_SecureValueType' => 'One of [secureValueTypePersonalDetails](../constructors/secureValueTypePersonalDetails.md), [secureValueTypePassport](../constructors/secureValueTypePassport.md), [secureValueTypeDriverLicense](../constructors/secureValueTypeDriverLicense.md), [secureValueTypeIdentityCard](../constructors/secureValueTypeIdentityCard.md), [secureValueTypeInternalPassport](../constructors/secureValueTypeInternalPassport.md), [secureValueTypeUtilityBill](../constructors/secureValueTypeUtilityBill.md), [secureValueTypeBankStatement](../constructors/secureValueTypeBankStatement.md), [secureValueTypeRentalAgreement](../constructors/secureValueTypeRentalAgreement.md), [secureValueTypePassportRegistration](../constructors/secureValueTypePassportRegistration.md), [secureValueTypeTemporaryRegistration](../constructors/secureValueTypeTemporaryRegistration.md)',
   'object_secureValueErrorTranslationFiles_param_file_hash_type_Vector t' => 'File hash',
-  'object_secureValueErrorTranslationFiles_param_text_type_string' => 'Text',
-  'object_passwordKdfAlgoUnknown' => 'Password kdf algo unknown',
-  'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow' => 'Password kdf algo sha256sha256pbkdf2hmacsh a512iter100000 sha256 mod pow',
-  'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_salt1_type_bytes' => 'Salt1',
-  'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_salt2_type_bytes' => 'Salt2',
-  'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_g_type_int' => 'G',
-  'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_p_type_bytes' => 'P',
-  'object_securePasswordKdfAlgoUnknown' => 'Secure password kdf algo unknown',
-  'object_securePasswordKdfAlgoPBKDF2HMACSHA512iter100000' => 'Secure password kdf algo pbkdf2hmacsh a512iter100000',
+  'object_secureValueErrorTranslationFiles_param_text_type_string' => 'Error message',
+  'object_passwordKdfAlgoUnknown' => 'Unknown KDF (most likely, the client is outdated and does not support the specified KDF algorithm)',
+  'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow' => 'This key derivation algorithm defines that [SRP 2FA login](https://core.telegram.org/api/srp) must be used',
+  'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_salt1_type_bytes' => 'One of two salts used by the derivation function (see [SRP 2FA login](https://core.telegram.org/api/srp))',
+  'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_salt2_type_bytes' => 'One of two salts used by the derivation function (see [SRP 2FA login](https://core.telegram.org/api/srp))',
+  'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_g_type_int' => 'Base (see [SRP 2FA login](https://core.telegram.org/api/srp))',
+  'object_passwordKdfAlgoSHA256SHA256PBKDF2HMACSHA512iter100000SHA256ModPow_param_p_type_bytes' => '2048-bit modulus (see [SRP 2FA login](https://core.telegram.org/api/srp))',
+  'object_securePasswordKdfAlgoUnknown' => 'Unknown KDF algo (most likely the client has to be updated)',
+  'object_securePasswordKdfAlgoPBKDF2HMACSHA512iter100000' => 'PBKDF2 with SHA512 and 100000 iterations KDF algo',
   'object_securePasswordKdfAlgoPBKDF2HMACSHA512iter100000_param_salt_type_bytes' => 'Salt',
-  'object_securePasswordKdfAlgoSHA512' => 'Secure password kdf algo sha512',
+  'object_securePasswordKdfAlgoSHA512' => 'SHA512 KDF algo',
   'object_securePasswordKdfAlgoSHA512_param_salt_type_bytes' => 'Salt',
-  'object_secureSecretSettings' => 'Secure secret settings',
-  'object_secureSecretSettings_param_secure_algo_type_SecurePasswordKdfAlgo' => 'Secure algo',
+  'object_secureSecretSettings' => 'Secure settings',
+  'object_secureSecretSettings_param_secure_algo_type_SecurePasswordKdfAlgo' => 'Secure KDF algo',
   'object_secureSecretSettings_param_secure_secret_type_bytes' => 'Secure secret',
-  'object_secureSecretSettings_param_secure_secret_id_type_long' => 'Secure secret ID',
-  'object_inputCheckPasswordEmpty' => 'Empty input check password',
-  'object_inputCheckPasswordSRP' => 'Check password srp',
-  'object_inputCheckPasswordSRP_param_srp_id_type_long' => 'Srp ID',
-  'object_inputCheckPasswordSRP_param_A_type_bytes' => 'A',
-  'object_inputCheckPasswordSRP_param_M1_type_bytes' => 'M1',
-  'object_secureRequiredType' => 'Secure required type',
-  'object_secureRequiredType_param_native_names_type_true' => 'Native names?',
-  'object_secureRequiredType_param_selfie_required_type_true' => 'Selfie required?',
-  'object_secureRequiredType_param_translation_required_type_true' => 'Translation required?',
-  'object_secureRequiredType_param_type_type_SecureValueType' => 'Type',
-  'object_secureRequiredTypeOneOf' => 'Secure required type one of',
+  'object_secureSecretSettings_param_secure_secret_id_type_long' => 'Secret ID',
+  'object_inputCheckPasswordEmpty' => 'There is no password',
+  'object_inputCheckPasswordSRP' => 'Constructor for checking the validity of a 2FA SRP password (see [SRP](https://core.telegram.org/api/srp))',
+  'object_inputCheckPasswordSRP_param_srp_id_type_long' => '[SRP ID](https://core.telegram.org/api/srp)',
+  'object_inputCheckPasswordSRP_param_A_type_bytes' => '`A` parameter (see [SRP](https://core.telegram.org/api/srp))',
+  'object_inputCheckPasswordSRP_param_M1_type_bytes' => '`M1` parameter (see [SRP](https://core.telegram.org/api/srp))',
+  'object_secureRequiredType' => 'Required type',
+  'object_secureRequiredType_param_native_names_type_true' => 'Native names',
+  'object_secureRequiredType_param_selfie_required_type_true' => 'Is a selfie required',
+  'object_secureRequiredType_param_translation_required_type_true' => 'Is a translation required',
+  'object_secureRequiredType_param_type_type_SecureValueType' => 'Secure value type',
+  'object_secureRequiredTypeOneOf' => 'One of',
   'object_secureRequiredTypeOneOf_param_types_type_Vector t' => 'Types',
-  'object_help.passportConfigNotModified' => 'Passport config not modified',
-  'object_help.passportConfig' => 'Passport config',
-  'object_help.passportConfig_param_hash_type_int' => 'Hash',
-  'object_help.passportConfig_param_countries_langs_type_DataJSON' => 'Countries langs',
-  'object_inputAppEvent_param_data_type_JSONValue' => 'Data',
-  'object_jsonObjectValue' => 'Json object value',
+  'object_help.passportConfigNotModified' => 'Password configuration not modified',
+  'object_help.passportConfig' => 'Telegram [passport](https://core.telegram.org/passport) configuration',
+  'object_help.passportConfig_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'object_help.passportConfig_param_countries_langs_type_DataJSON' => 'Localization',
+  'object_inputAppEvent_param_data_type_JSONValue' => 'Details of the event',
+  'object_jsonObjectValue' => 'JSON key: value pair',
   'object_jsonObjectValue_param_key_type_string' => 'Key',
   'object_jsonObjectValue_param_value_type_JSONValue' => 'Value',
-  'object_jsonNull' => 'Json null',
-  'object_jsonBool' => 'Json bool',
-  'object_jsonBool_param_value_type_Bool' => 'Value?',
-  'object_jsonNumber' => 'Json number',
+  'object_jsonNull' => 'null JSON value',
+  'object_jsonBool' => 'JSON boolean value',
+  'object_jsonBool_param_value_type_Bool' => 'Value',
+  'object_jsonNumber' => 'JSON numeric value',
   'object_jsonNumber_param_value_type_double' => 'Value',
-  'object_jsonString' => 'Json string',
+  'object_jsonString' => 'JSON string',
   'object_jsonString_param_value_type_string' => 'Value',
-  'object_jsonArray' => 'Json array',
+  'object_jsonArray' => 'JSON array',
   'object_jsonArray_param_value_type_Vector t' => 'Value',
-  'object_jsonObject' => 'Json object',
+  'object_jsonObject' => 'JSON object value',
   'object_jsonObject_param_value_type_Vector t' => 'Value',
-  'object_pageTableCell' => 'Page table cell',
-  'object_pageTableCell_param_header_type_true' => 'Header?',
-  'object_pageTableCell_param_align_center_type_true' => 'Align center?',
-  'object_pageTableCell_param_align_right_type_true' => 'Align right?',
-  'object_pageTableCell_param_valign_middle_type_true' => 'Valign middle?',
-  'object_pageTableCell_param_valign_bottom_type_true' => 'Valign bottom?',
-  'object_pageTableCell_param_text_type_RichText' => 'Text',
-  'object_pageTableCell_param_colspan_type_int' => 'Colspan',
-  'object_pageTableCell_param_rowspan_type_int' => 'Rowspan',
-  'object_pageTableRow' => 'Page table row',
+  'object_pageTableCell' => 'Table cell',
+  'object_pageTableCell_param_header_type_true' => 'Is this element part of the column header',
+  'object_pageTableCell_param_align_center_type_true' => 'Horizontally centered block',
+  'object_pageTableCell_param_align_right_type_true' => 'Right-aligned block',
+  'object_pageTableCell_param_valign_middle_type_true' => 'Vertically centered block',
+  'object_pageTableCell_param_valign_bottom_type_true' => 'Block vertically-alligned to the bottom',
+  'object_pageTableCell_param_text_type_RichText' => 'Content',
+  'object_pageTableCell_param_colspan_type_int' => 'For how many columns should this cell extend',
+  'object_pageTableCell_param_rowspan_type_int' => 'For how many rows should this cell extend',
+  'object_pageTableRow' => 'Table row',
   'object_pageTableRow_param_cells_type_Vector t' => 'Cells',
   'object_pageCaption' => 'Page caption',
-  'object_pageCaption_param_text_type_RichText' => 'Text',
-  'object_pageCaption_param_credit_type_RichText' => 'Credit',
-  'object_pageListItemText' => 'Page list item text',
+  'object_pageCaption_param_text_type_RichText' => 'Caption',
+  'object_pageCaption_param_credit_type_RichText' => 'Credits',
+  'object_pageListItemText' => 'List item',
   'object_pageListItemText_param_text_type_RichText' => 'Text',
-  'object_pageListItemBlocks' => 'Page list item blocks',
+  'object_pageListItemBlocks' => 'List item',
   'object_pageListItemBlocks_param_blocks_type_Vector t' => 'Blocks',
-  'object_pageListOrderedItemText' => 'Page list ordered item text',
-  'object_pageListOrderedItemText_param_num_type_string' => 'Num',
+  'object_pageListOrderedItemText' => 'Ordered list of text items',
+  'object_pageListOrderedItemText_param_num_type_string' => 'Number of element within ordered list',
   'object_pageListOrderedItemText_param_text_type_RichText' => 'Text',
-  'object_pageListOrderedItemBlocks' => 'Page list ordered item blocks',
-  'object_pageListOrderedItemBlocks_param_num_type_string' => 'Num',
+  'object_pageListOrderedItemBlocks' => 'Ordered list of [IV](https://instantview.telegram.org) blocks',
+  'object_pageListOrderedItemBlocks_param_num_type_string' => 'Number of element within ordered list',
   'object_pageListOrderedItemBlocks_param_blocks_type_Vector t' => 'Blocks',
-  'object_pageRelatedArticle' => 'Page related article',
-  'object_pageRelatedArticle_param_url_type_string' => 'URL',
-  'object_pageRelatedArticle_param_webpage_id_type_long' => 'Webpage ID',
+  'object_pageRelatedArticle' => 'Related article',
+  'object_pageRelatedArticle_param_url_type_string' => 'URL of article',
+  'object_pageRelatedArticle_param_webpage_id_type_long' => 'Webpage ID of generated IV preview',
   'object_pageRelatedArticle_param_title_type_string' => 'Title',
   'object_pageRelatedArticle_param_description_type_string' => 'Description',
-  'object_pageRelatedArticle_param_photo_id_type_long' => 'Photo ID',
-  'object_pageRelatedArticle_param_author_type_string' => 'Author',
-  'object_pageRelatedArticle_param_published_date_type_int' => 'Published date',
-  'object_page' => 'Page',
-  'object_page_param_part_type_true' => 'Part?',
-  'object_page_param_rtl_type_true' => 'Rtl?',
-  'object_page_param_v2_type_true' => 'V2?',
-  'object_page_param_url_type_string' => 'URL',
+  'object_pageRelatedArticle_param_photo_id_type_long' => 'ID of preview photo',
+  'object_pageRelatedArticle_param_author_type_string' => 'Author name',
+  'object_pageRelatedArticle_param_published_date_type_int' => 'Date of pubblication',
+  'object_page' => '[Instant view](https://instantview.telegram.org) page',
+  'object_page_param_part_type_true' => 'Indicates that not full page preview is available to the client and it will need to fetch full Instant View from the server using [messages.getWebPagePreview](../methods/messages.getWebPagePreview.md).',
+  'object_page_param_rtl_type_true' => 'Whether the page contains RTL text',
+  'object_page_param_v2_type_true' => 'Whether this is an [IV v2](https://instantview.telegram.org/docs#what-39s-new-in-2-0) page',
+  'object_page_param_url_type_string' => 'Original page HTTP URL',
   'object_page_param_blocks_type_Vector t' => 'Blocks',
   'object_page_param_photos_type_Vector t' => 'Photos',
   'object_page_param_documents_type_Vector t' => 'Documents',
-  'object_help.supportName' => 'Support name',
-  'object_help.supportName_param_name_type_string' => 'Name',
-  'object_help.userInfoEmpty' => 'Empty user info',
-  'object_help.userInfo' => 'User info',
-  'object_help.userInfo_param_message_type_string' => 'Message',
+  'object_help.supportName' => 'Localized name for telegram support',
+  'object_help.supportName_param_name_type_string' => 'Localized name',
+  'object_help.userInfoEmpty' => 'Internal use',
+  'object_help.userInfo' => 'Internal use',
+  'object_help.userInfo_param_message_type_string' => 'Info',
   'object_help.userInfo_param_entities_type_Vector t' => 'Entities',
   'object_help.userInfo_param_author_type_string' => 'Author',
   'object_help.userInfo_param_date_type_int' => 'Date',
-  'object_pollAnswer' => 'Poll answer',
-  'object_pollAnswer_param_text_type_string' => 'Text',
-  'object_pollAnswer_param_option_type_bytes' => 'Option',
+  'object_pollAnswer' => 'A possible answer of a poll',
+  'object_pollAnswer_param_text_type_string' => 'Textual representation of the answer',
+  'object_pollAnswer_param_option_type_bytes' => 'The param that has to be passed to [messages.sendVote](../methods/messages.sendVote.md).',
   'object_poll' => 'Poll',
-  'object_poll_param_id_type_long' => 'ID',
-  'object_poll_param_closed_type_true' => 'Closed?',
-  'object_poll_param_question_type_string' => 'Question',
+  'object_poll_param_id_type_long' => 'ID of the poll',
+  'object_poll_param_closed_type_true' => 'Whether the poll is closed and doesn\'t accept any more answers',
+  'object_poll_param_question_type_string' => 'The question of the poll',
   'object_poll_param_answers_type_Vector t' => 'Answers',
-  'object_pollAnswerVoters' => 'Poll answer voters',
-  'object_pollAnswerVoters_param_chosen_type_true' => 'Chosen?',
-  'object_pollAnswerVoters_param_option_type_bytes' => 'Option',
-  'object_pollAnswerVoters_param_voters_type_int' => 'Voters',
-  'object_pollResults' => 'Poll results',
-  'object_pollResults_param_min_type_true' => 'Min?',
+  'object_pollAnswerVoters' => 'A poll answer, and how users voted on it',
+  'object_pollAnswerVoters_param_chosen_type_true' => 'Whether we have chosen this answer',
+  'object_pollAnswerVoters_param_option_type_bytes' => 'The param that has to be passed to [messages.sendVote](../methods/messages.sendVote.md).',
+  'object_pollAnswerVoters_param_voters_type_int' => 'How many users voted for this option',
+  'object_pollResults' => 'Results of poll',
+  'object_pollResults_param_min_type_true' => 'Similar to [min](https://core.telegram.org/api/min) objects, used for poll constructors that are the same for all users so they don\'t have option chosen by the current user (you can use [messages.getPollResults](../methods/messages.getPollResults.md) to get the full poll results).',
   'object_pollResults_param_results_type_Vector t' => 'Results',
-  'object_pollResults_param_total_voters_type_int' => 'Total voters',
-  'object_chatOnlines' => 'Chat onlines',
-  'object_chatOnlines_param_onlines_type_int' => 'Onlines',
-  'object_statsURL' => 'Stats URL',
-  'object_statsURL_param_url_type_string' => 'URL',
-  'method_auth.sendCode_param_settings_type_CodeSettings' => 'You cannot use this method directly, use the phoneLogin method instead (see https://docs.madelineproto.xyz for more info)',
+  'object_pollResults_param_total_voters_type_int' => 'Total number of people that voted in the poll',
+  'object_chatOnlines' => 'Number of online users in a chat',
+  'object_chatOnlines_param_onlines_type_int' => 'Number of online users',
+  'object_statsURL' => 'URL with chat statistics',
+  'object_statsURL_param_url_type_string' => 'Chat statistics',
+  'method_auth.sendCode_param_settings_type_CodeSettings' => 'Settings for the code type to send',
   'method_account.getWallPapers_param_hash_type_Vector t' => 'IDs of previously fetched wallpapers',
-  'method_account.sendChangePhoneCode_param_settings_type_CodeSettings' => 'Code settings',
-  'method_account.sendConfirmPhoneCode_param_settings_type_CodeSettings' => 'Code settings',
-  'method_account.sendVerifyPhoneCode_param_settings_type_CodeSettings' => 'Code settings',
-  'method_account.getWallPaper' => 'Get wallpaper info',
-  'method_account.getWallPaper_param_wallpaper_type_InputWallPaper' => 'Wallpaper',
-  'method_account.uploadWallPaper' => 'Upload wallpaper',
-  'method_account.uploadWallPaper_param_file_type_InputFile' => 'Image',
-  'method_account.uploadWallPaper_param_mime_type_type_string' => 'Mime type',
+  'method_account.sendChangePhoneCode_param_settings_type_CodeSettings' => 'Phone code settings',
+  'method_account.sendConfirmPhoneCode_param_settings_type_CodeSettings' => 'Phone code settings',
+  'method_account.sendVerifyPhoneCode_param_settings_type_CodeSettings' => 'Phone code settings',
+  'method_account.getWallPaper' => 'Get info about a certain wallpaper',
+  'method_account.getWallPaper_param_wallpaper_type_InputWallPaper' => 'The wallpaper to get info about',
+  'method_account.uploadWallPaper' => 'Create and upload a new wallpaper',
+  'method_account.uploadWallPaper_param_file_type_InputFile' => 'The JPG/PNG wallpaper',
+  'method_account.uploadWallPaper_param_mime_type_type_string' => 'MIME type of uploaded wallpaper',
   'method_account.uploadWallPaper_param_settings_type_WallPaperSettings' => 'Wallpaper settings',
-  'method_account.saveWallPaper' => 'Save wallpaper',
-  'method_account.saveWallPaper_param_wallpaper_type_InputWallPaper' => 'The wallpaper to save',
-  'method_account.saveWallPaper_param_unsave_type_Bool' => 'Delete saved wallpaper',
-  'method_account.saveWallPaper_param_settings_type_WallPaperSettings' => 'The wallpaper to save',
+  'method_account.saveWallPaper' => 'Install/uninstall wallpaper',
+  'method_account.saveWallPaper_param_wallpaper_type_InputWallPaper' => 'Wallpaper to save',
+  'method_account.saveWallPaper_param_unsave_type_Bool' => 'Uninstall wallpaper?',
+  'method_account.saveWallPaper_param_settings_type_WallPaperSettings' => 'Wallpaper settings',
   'method_account.installWallPaper' => 'Install wallpaper',
   'method_account.installWallPaper_param_wallpaper_type_InputWallPaper' => 'Wallpaper to install',
   'method_account.installWallPaper_param_settings_type_WallPaperSettings' => 'Wallpaper settings',
-  'method_account.resetWallPapers' => 'Reset wallpapers',
-  'method_messages.exportChatInvite_param_peer_type_InputPeer' => 'Export invite only for this user',
-  'method_messages.editChatAbout' => 'Edit chat info',
-  'method_messages.editChatAbout_param_peer_type_InputPeer' => 'Chat',
-  'method_messages.editChatAbout_param_about_type_string' => 'Info',
-  'method_messages.editChatDefaultBannedRights' => 'Edit default rights of chat',
-  'method_messages.editChatDefaultBannedRights_param_peer_type_InputPeer' => 'Chat',
-  'method_messages.editChatDefaultBannedRights_param_banned_rights_type_ChatBannedRights' => 'Global chat rights',
-  'method_channels.editAdmin_param_admin_rights_type_ChatAdminRights' => 'Admin rights',
-  'method_channels.editBanned_param_banned_rights_type_ChatBannedRights' => 'Banned rights',
-  'object_chat_param_admin_rights_type_ChatAdminRights' => 'Admin rights of current user',
-  'object_chat_param_default_banned_rights_type_ChatBannedRights' => 'Global chat banned rights',
-  'object_channel_param_admin_rights_type_ChatAdminRights' => 'Admin rights of current user',
-  'object_channel_param_banned_rights_type_ChatBannedRights' => 'Banned rights of current user',
-  'object_channel_param_default_banned_rights_type_ChatBannedRights' => 'Global chat banned rights',
-  'object_chatFull_param_can_set_username_type_true' => 'Can set username?',
-  'object_chatFull_param_about_type_string' => 'Chat about',
-  'object_photoStrippedSize' => 'Stripped size',
-  'object_photoStrippedSize_param_type_type_string' => 'Stripped size',
-  'object_photoStrippedSize_param_bytes_type_bytes' => 'Bytes',
-  'object_wallPaper_param_id_type_long' => 'ID',
-  'object_wallPaper_param_creator_type_true' => 'Am I the creator?',
-  'object_wallPaper_param_default_type_true' => 'Default?',
+  'method_account.resetWallPapers' => 'Delete installed wallpapers',
+  'method_messages.exportChatInvite_param_peer_type_InputPeer' => 'Chat',
+  'method_messages.editChatAbout' => 'Edit the description of a [group/supergroup/channel](https://core.telegram.org/api/channel).',
+  'method_messages.editChatAbout_param_peer_type_InputPeer' => 'The [group/supergroup/channel](https://core.telegram.org/api/channel).',
+  'method_messages.editChatAbout_param_about_type_string' => 'The new description',
+  'method_messages.editChatDefaultBannedRights' => 'Edit the default banned rights of a [channel/supergroup/group](https://core.telegram.org/api/channel).',
+  'method_messages.editChatDefaultBannedRights_param_peer_type_InputPeer' => 'The peer',
+  'method_messages.editChatDefaultBannedRights_param_banned_rights_type_ChatBannedRights' => 'The new global rights',
+  'method_channels.editAdmin_param_admin_rights_type_ChatAdminRights' => 'The admin rights',
+  'method_channels.editBanned_param_banned_rights_type_ChatBannedRights' => 'The banned rights',
+  'object_chat_param_admin_rights_type_ChatAdminRights' => '[Admin rights](https://core.telegram.org/api/rights) of the user in the group',
+  'object_chat_param_default_banned_rights_type_ChatBannedRights' => '[Default banned rights](https://core.telegram.org/api/rights) of all users in the group',
+  'object_channel_param_admin_rights_type_ChatAdminRights' => 'Admin rights of the user in this channel (see [rights](https://core.telegram.org/api/rights))',
+  'object_channel_param_banned_rights_type_ChatBannedRights' => 'Banned rights of the user in this channel (see [rights](https://core.telegram.org/api/rights))',
+  'object_channel_param_default_banned_rights_type_ChatBannedRights' => 'Default chat rights (see [rights](https://core.telegram.org/api/rights))',
+  'object_chatFull_param_can_set_username_type_true' => 'Can we change the username of this chat',
+  'object_chatFull_param_about_type_string' => 'About string for this chat',
+  'object_photoStrippedSize' => 'Just the image\'s content',
+  'object_photoStrippedSize_param_type_type_string' => 'Thumbnail type',
+  'object_photoStrippedSize_param_bytes_type_bytes' => 'Thumbnail data',
+  'object_wallPaper_param_id_type_long' => 'Identifier',
+  'object_wallPaper_param_creator_type_true' => 'Creator of the wallpaper',
+  'object_wallPaper_param_default_type_true' => 'Whether this is the default wallpaper',
   'object_wallPaper_param_pattern_type_true' => 'Pattern',
-  'object_wallPaper_param_dark_type_true' => 'Dark?',
-  'object_wallPaper_param_access_hash_type_long' => 'Hash',
-  'object_wallPaper_param_slug_type_string' => 'Slug?',
-  'object_wallPaper_param_document_type_Document' => 'Wallpaper',
+  'object_wallPaper_param_dark_type_true' => 'Dark mode',
+  'object_wallPaper_param_access_hash_type_long' => 'Access hash',
+  'object_wallPaper_param_slug_type_string' => 'Unique wallpaper ID',
+  'object_wallPaper_param_document_type_Document' => 'The actual wallpaper',
   'object_wallPaper_param_settings_type_WallPaperSettings' => 'Wallpaper settings',
-  'object_messages.messagesSlice_param_inexact_type_true' => 'Inexact?',
-  'object_updateChatDefaultBannedRights' => 'Global chat rights updated',
-  'object_updateChatDefaultBannedRights_param_peer_type_Peer' => 'Peer',
-  'object_updateChatDefaultBannedRights_param_default_banned_rights_type_ChatBannedRights' => 'Global chat rights',
+  'object_messages.messagesSlice_param_inexact_type_true' => 'If set, indicates that the results may be inexact',
+  'object_updateChatDefaultBannedRights' => 'Default banned rights in a [normal chat](https://core.telegram.org/api/channel) were updated',
+  'object_updateChatDefaultBannedRights_param_peer_type_Peer' => 'The chat',
+  'object_updateChatDefaultBannedRights_param_default_banned_rights_type_ChatBannedRights' => 'New default banned rights',
   'object_updateChatDefaultBannedRights_param_version_type_int' => 'Version',
   'object_document_param_thumbs_type_Vector t' => 'Thumbnails',
-  'object_channelParticipantAdmin_param_self_type_true' => 'Is this the current user?',
-  'object_channelParticipantAdmin_param_admin_rights_type_ChatAdminRights' => 'Admin rights',
-  'object_channelParticipantBanned_param_banned_rights_type_ChatBannedRights' => 'Banned rights',
-  'object_channelParticipantsContacts' => 'Contacts',
-  'object_channelParticipantsContacts_param_q_type_string' => 'Query',
-  'object_channelAdminLogEventActionDefaultBannedRights' => 'Changed global chat rights',
-  'object_channelAdminLogEventActionDefaultBannedRights_param_prev_banned_rights_type_ChatBannedRights' => 'Previous Banned rights of current user',
-  'object_channelAdminLogEventActionDefaultBannedRights_param_new_banned_rights_type_ChatBannedRights' => 'New Banned rights of current user',
-  'object_channelAdminLogEventActionStopPoll' => 'Stopped poll',
-  'object_channelAdminLogEventActionStopPoll_param_message_type_Message' => 'Message',
-  'object_chatAdminRights' => 'Admin rights',
-  'object_chatAdminRights_param_change_info_type_true' => 'Can change info?',
-  'object_chatAdminRights_param_post_messages_type_true' => 'Can post messages?',
-  'object_chatAdminRights_param_edit_messages_type_true' => 'Can edit messages?',
-  'object_chatAdminRights_param_delete_messages_type_true' => 'Can delete messages?',
-  'object_chatAdminRights_param_ban_users_type_true' => 'Can ban users?',
-  'object_chatAdminRights_param_invite_users_type_true' => 'Can invite users?',
-  'object_chatAdminRights_param_pin_messages_type_true' => 'Can pin messages?',
-  'object_chatAdminRights_param_add_admins_type_true' => 'Can add other admins?',
-  'object_chatBannedRights' => 'Banned rights (when true, the user will NOT be able to do that thing)',
-  'object_chatBannedRights_param_view_messages_type_true' => 'Can view messages?',
+  'object_channelParticipantAdmin_param_self_type_true' => 'Is this the current user',
+  'object_channelParticipantAdmin_param_admin_rights_type_ChatAdminRights' => 'Admin [rights](https://core.telegram.org/api/rights)',
+  'object_channelParticipantBanned_param_banned_rights_type_ChatBannedRights' => 'Banned [rights](https://core.telegram.org/api/rights)',
+  'object_channelParticipantsContacts' => 'Fetch only participants that are also contacts',
+  'object_channelParticipantsContacts_param_q_type_string' => 'Optional search query for searching contact participants by name',
+  'object_channelAdminLogEventActionDefaultBannedRights' => 'The default banned rights were modified',
+  'object_channelAdminLogEventActionDefaultBannedRights_param_prev_banned_rights_type_ChatBannedRights' => 'Previous global [banned rights](https://core.telegram.org/api/rights)',
+  'object_channelAdminLogEventActionDefaultBannedRights_param_new_banned_rights_type_ChatBannedRights' => 'New glboal [banned rights](https://core.telegram.org/api/rights).',
+  'object_channelAdminLogEventActionStopPoll' => 'A poll was stopped',
+  'object_channelAdminLogEventActionStopPoll_param_message_type_Message' => 'The poll that was stopped',
+  'object_chatAdminRights' => 'Represents the rights of an admin in a [channel/supergroup](https://core.telegram.org/api/channel).',
+  'object_chatAdminRights_param_change_info_type_true' => 'If set, allows the admin to modify the description of the [channel/supergroup](https://core.telegram.org/api/channel)',
+  'object_chatAdminRights_param_post_messages_type_true' => 'If set, allows the admin to post messages in the [channel](https://core.telegram.org/api/channel)',
+  'object_chatAdminRights_param_edit_messages_type_true' => 'If set, allows the admin to also edit messages from other admins in the [channel](https://core.telegram.org/api/channel)',
+  'object_chatAdminRights_param_delete_messages_type_true' => 'If set, allows the admin to also delete messages from other admins in the [channel](https://core.telegram.org/api/channel)',
+  'object_chatAdminRights_param_ban_users_type_true' => 'If set, allows the admin to ban users from the [channel/supergroup](https://core.telegram.org/api/channel)',
+  'object_chatAdminRights_param_invite_users_type_true' => 'If set, allows the admin to invite users in the [channel/supergroup](https://core.telegram.org/api/channel)',
+  'object_chatAdminRights_param_pin_messages_type_true' => 'If set, allows the admin to pin messages in the [channel/supergroup](https://core.telegram.org/api/channel)',
+  'object_chatAdminRights_param_add_admins_type_true' => 'If set, allows the admin to add other admins with the same (or more limited) permissions in the [channel/supergroup](https://core.telegram.org/api/channel)',
+  'object_chatBannedRights' => 'Represents the rights of a normal user in a [supergroup/channel/chat](https://core.telegram.org/api/channel). In this case, the flags are inverted: if set, a flag **does not allow** a user to do X.',
+  'object_chatBannedRights_param_view_messages_type_true' => 'If set, does not allow a user to view messages in a [supergroup/channel/chat](https://core.telegram.org/api/channel)',
   'object_chatBannedRights_param_sendMessages_type_true' => 'Can send messages?',
-  'object_chatBannedRights_param_send_media_type_true' => 'Can send media?',
-  'object_chatBannedRights_param_send_stickers_type_true' => 'Can send stickers?',
-  'object_chatBannedRights_param_send_gifs_type_true' => 'Can send gifs?',
-  'object_chatBannedRights_param_send_games_type_true' => 'Can send games?',
-  'object_chatBannedRights_param_send_inline_type_true' => 'Can use inline bots?',
-  'object_chatBannedRights_param_embed_links_type_true' => 'Can embed links?',
-  'object_chatBannedRights_param_send_polls_type_true' => 'Can send polls?',
-  'object_chatBannedRights_param_change_info_type_true' => 'Can change info?',
-  'object_chatBannedRights_param_invite_users_type_true' => 'Can invite users?',
-  'object_chatBannedRights_param_pin_messages_type_true' => 'Can pin messages?',
-  'object_chatBannedRights_param_until_date_type_int' => 'Until date (0 = forever)',
+  'object_chatBannedRights_param_send_media_type_true' => 'If set, does not allow a user to send any media in a [supergroup/chat](https://core.telegram.org/api/channel)',
+  'object_chatBannedRights_param_send_stickers_type_true' => 'If set, does not allow a user to send stickers in a [supergroup/chat](https://core.telegram.org/api/channel)',
+  'object_chatBannedRights_param_send_gifs_type_true' => 'If set, does not allow a user to send gifs in a [supergroup/chat](https://core.telegram.org/api/channel)',
+  'object_chatBannedRights_param_send_games_type_true' => 'If set, does not allow a user to send games in a [supergroup/chat](https://core.telegram.org/api/channel)',
+  'object_chatBannedRights_param_send_inline_type_true' => 'If set, does not allow a user to use inline bots in a [supergroup/chat](https://core.telegram.org/api/channel)',
+  'object_chatBannedRights_param_embed_links_type_true' => 'If set, does not allow a user to embed links in the messages of a [supergroup/chat](https://core.telegram.org/api/channel)',
+  'object_chatBannedRights_param_send_polls_type_true' => 'If set, does not allow a user to send stickers in a [supergroup/chat](https://core.telegram.org/api/channel)',
+  'object_chatBannedRights_param_change_info_type_true' => 'If set, does not allow any user to change the description of a [supergroup/chat](https://core.telegram.org/api/channel)',
+  'object_chatBannedRights_param_invite_users_type_true' => 'If set, does not allow any user to invite users in a [supergroup/chat](https://core.telegram.org/api/channel)',
+  'object_chatBannedRights_param_pin_messages_type_true' => 'If set, does not allow any user to pin messages in a [supergroup/chat](https://core.telegram.org/api/channel)',
+  'object_chatBannedRights_param_until_date_type_int' => 'Validity of said permissions (0 = forever, forever = 2^31-1 for now).',
   'object_inputWallPaper' => 'Wallpaper',
-  'object_inputWallPaper_param_id_type_long' => 'ID',
+  'object_inputWallPaper_param_id_type_long' => 'Wallpaper ID',
   'object_inputWallPaper_param_access_hash_type_long' => 'Access hash',
-  'object_inputWallPaperSlug' => 'Wallpaper slug',
-  'object_inputWallPaperSlug_param_slug_type_string' => 'Type',
-  'object_account.wallPapersNotModified' => 'No wallpapers were modified',
-  'object_account.wallPapers' => 'Wallpapers',
-  'object_account.wallPapers_param_hash_type_int' => 'Hash',
+  'object_inputWallPaperSlug' => 'Wallpaper by slug (a unique ID)',
+  'object_inputWallPaperSlug_param_slug_type_string' => 'Unique wallpaper ID',
+  'object_account.wallPapersNotModified' => 'No new wallpapers were found',
+  'object_account.wallPapers' => 'Installed wallpapers',
+  'object_account.wallPapers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
   'object_account.wallPapers_param_wallpapers_type_Vector t' => 'Wallpapers',
-  'object_codeSettings' => 'Code settings',
-  'object_codeSettings_param_allow_flashcall_type_true' => 'Allow flashcal?',
-  'object_codeSettings_param_current_number_type_true' => 'Current number?',
+  'object_codeSettings' => 'Settings used by telegram servers for sending the confirm code.
+
+Example implementations: [telegram for android](https://github.com/DrKLO/Telegram/blob/master/TMessagesProj/src/main/java/org/telegram/ui/LoginActivity.java), [tdlib](https://github.com/tdlib/td/tree/master/td/telegram/SendCodeHelper.cpp).',
+  'object_codeSettings_param_allow_flashcall_type_true' => 'Whether to allow phone verification via [phone calls](https://core.telegram.org/api/auth).',
+  'object_codeSettings_param_current_number_type_true' => 'Pass true if the phone number is used on the current device. Ignored if allow\\_flashcall is not set.',
   'object_codeSettings_param_app_hash_persistent_type_true' => 'Persistent hash?',
   'object_codeSettings_param_app_hash_type_string' => 'Hash type',
   'object_wallPaperSettings' => 'Wallpaper settings',
-  'object_wallPaperSettings_param_blur_type_true' => 'Blur?',
-  'object_wallPaperSettings_param_motion_type_true' => 'Motion?',
-  'object_wallPaperSettings_param_background_color_type_int' => 'Background color',
-  'object_wallPaperSettings_param_intensity_type_int' => 'Intensity',
-  'object_inputPrivacyKeyProfilePhoto' => 'Can his profile photo be viewed?',
-  'object_inputPrivacyKeyForwards' => 'Can his messages be forwarded?',
-  'method_account.getAutoDownloadSettings' => 'Get autodownload settings',
-  'method_account.saveAutoDownloadSettings' => 'Save autodownload settings',
-  'method_account.saveAutoDownloadSettings_param_low_type_true' => 'Low preset',
-  'method_account.saveAutoDownloadSettings_param_high_type_true' => 'High preset',
-  'method_account.saveAutoDownloadSettings_param_settings_type_AutoDownloadSettings' => 'Autodownload settings',
-  'method_messages.deleteHistory_param_revoke_type_true' => 'Delete messages for the other user',
-  'method_messages.getStatsURL_param_dark_type_true' => 'Dark?',
-  'method_messages.getStatsURL_param_params_type_string' => 'Params',
-  'method_messages.getEmojiKeywords' => 'Get emoji keywords',
+  'object_wallPaperSettings_param_blur_type_true' => 'If set, the wallpaper must be downscaled to fit in 450x450 square and then box-blurred with radius 12',
+  'object_wallPaperSettings_param_motion_type_true' => 'If set, the background needs to be slightly moved when device is rotated',
+  'object_wallPaperSettings_param_background_color_type_int' => 'If set, a PNG pattern is to be combined with the `color` chosen by the user: the main color of the background in RGB24 format',
+  'object_wallPaperSettings_param_intensity_type_int' => 'Intensity of the pattern when it is shown above the main background color, 0-100',
+  'object_inputPrivacyKeyProfilePhoto' => 'Whether people will be able to see the user\'s profile picture',
+  'object_inputPrivacyKeyForwards' => 'Whether messages forwarded from this user will be [anonymous](https://telegram.org/blog/unsend-privacy-emoji#anonymous-forwarding)',
+  'method_account.getAutoDownloadSettings' => 'Get media autodownload settings',
+  'method_account.saveAutoDownloadSettings' => 'Change media autodownload settings',
+  'method_account.saveAutoDownloadSettings_param_low_type_true' => 'Whether to save settings in the low data usage preset',
+  'method_account.saveAutoDownloadSettings_param_high_type_true' => 'Whether to save settings in the high data usage preset',
+  'method_account.saveAutoDownloadSettings_param_settings_type_AutoDownloadSettings' => 'Media autodownload settings',
+  'method_messages.deleteHistory_param_revoke_type_true' => 'Whether to delete the message history for all chat participants',
+  'method_messages.getStatsURL_param_dark_type_true' => 'Pass true if a URL with the dark theme must be returned',
+  'method_messages.getStatsURL_param_params_type_string' => 'Parameters from `tg://statsrefresh?params=******` link',
+  'method_messages.getEmojiKeywords' => 'Get localized emoji keywords',
   'method_messages.getEmojiKeywords_param_lang_code_type_string' => 'Language code',
-  'method_messages.getEmojiKeywordsDifference' => 'Get emoji keyword difference',
+  'method_messages.getEmojiKeywordsDifference' => 'Get changed emoji keywords',
   'method_messages.getEmojiKeywordsDifference_param_lang_code_type_string' => 'Language code',
-  'method_messages.getEmojiKeywordsDifference_param_from_version_type_int' => 'From version',
-  'method_messages.getEmojiURL' => 'Get emoji URL',
-  'method_messages.getEmojiURL_param_lang_code_type_string' => 'Language code',
-  'method_phone.setCallRating_param_user_initiative_type_true' => 'User initiative',
+  'method_messages.getEmojiKeywordsDifference_param_from_version_type_int' => 'Previous emoji keyword localization version',
+  'method_messages.getEmojiURL' => 'Returns an HTTP URL which can be used to automatically log in into translation platform and suggest new emoji replacements. The URL will be valid for 30 seconds after generation',
+  'method_messages.getEmojiURL_param_lang_code_type_string' => 'Language code for which the emoji replacements will be suggested',
+  'method_phone.setCallRating_param_user_initiative_type_true' => 'Whether the user decided on their own initiative to rate the call',
   'method_langpack.getDifference_param_lang_pack_type_string' => 'Language pack',
-  'object_user_param_support_type_true' => 'Is this a support user?',
-  'object_updateChatPinnedMessage_param_version_type_int' => 'Version',
-  'object_privacyKeyForwards' => 'Forwards privacy key',
-  'object_privacyKeyProfilePhoto' => 'Show profile photo?',
-  'object_stickerSet_param_thumb_type_PhotoSize' => 'Thumbnail',
-  'object_messageFwdHeader_param_from_name_type_string' => 'Author of the original message',
+  'object_user_param_support_type_true' => 'Whether this is an official support user',
+  'object_updateChatPinnedMessage_param_version_type_int' => 'Used to reorder updates in legacy groups',
+  'object_privacyKeyForwards' => 'Whether messages forwarded from the user will be [anonymously forwarded](https://telegram.org/blog/unsend-privacy-emoji#anonymous-forwarding)',
+  'object_privacyKeyProfilePhoto' => 'Whether the profile picture of the user is visible',
+  'object_stickerSet_param_thumb_type_PhotoSize' => 'Thumbnail for stickerset',
+  'object_messageFwdHeader_param_from_name_type_string' => 'The name of the user that originally sent the message',
   'object_autoDownloadSettings' => 'Autodownload settings',
-  'object_autoDownloadSettings_param_disabled_type_true' => 'Disabled?',
-  'object_autoDownloadSettings_param_video_preload_large_type_true' => 'Preload large videos?',
-  'object_autoDownloadSettings_param_audio_preload_next_type_true' => 'Preload audios?',
-  'object_autoDownloadSettings_param_phonecalls_less_data_type_true' => 'Use less data in phonecalls?',
-  'object_autoDownloadSettings_param_photo_size_max_type_int' => 'Maximum photo file size to preload',
-  'object_autoDownloadSettings_param_video_size_max_type_int' => 'Maximum video file size to preload',
-  'object_autoDownloadSettings_param_file_size_max_type_int' => 'Maximum file size to preload',
-  'object_account.autoDownloadSettings' => 'Autodownload settings',
-  'object_account.autoDownloadSettings_param_low_type_AutoDownloadSettings' => 'Low preset?',
-  'object_account.autoDownloadSettings_param_medium_type_AutoDownloadSettings' => 'Medium preset?',
-  'object_account.autoDownloadSettings_param_high_type_AutoDownloadSettings' => 'High preset?',
+  'object_autoDownloadSettings_param_disabled_type_true' => 'Disable automatic media downloads?',
+  'object_autoDownloadSettings_param_video_preload_large_type_true' => 'Whether to preload the first seconds of videos larger than the specified limit',
+  'object_autoDownloadSettings_param_audio_preload_next_type_true' => 'Whether to preload the next audio track when you\'re listening to music',
+  'object_autoDownloadSettings_param_phonecalls_less_data_type_true' => 'Whether to enable data saving mode in phone calls',
+  'object_autoDownloadSettings_param_photo_size_max_type_int' => 'Maximum size of photos to preload',
+  'object_autoDownloadSettings_param_video_size_max_type_int' => 'Maximum size of videos to preload',
+  'object_autoDownloadSettings_param_file_size_max_type_int' => 'Maximum size of other files to preload',
+  'object_account.autoDownloadSettings' => 'Media autodownload settings',
+  'object_account.autoDownloadSettings_param_low_type_AutoDownloadSettings' => 'Low data usage preset',
+  'object_account.autoDownloadSettings_param_medium_type_AutoDownloadSettings' => 'Medium data usage preset',
+  'object_account.autoDownloadSettings_param_high_type_AutoDownloadSettings' => 'High data usage preset',
   'object_emojiKeyword' => 'Emoji keyword',
   'object_emojiKeyword_param_keyword_type_string' => 'Keyword',
   'object_emojiKeyword_param_emoticons_type_Vector t' => 'Emoticons',
   'object_emojiKeywordDeleted' => 'Deleted emoji keyword',
   'object_emojiKeywordDeleted_param_keyword_type_string' => 'Keyword',
   'object_emojiKeywordDeleted_param_emoticons_type_Vector t' => 'Emoticons',
-  'object_emojiKeywordsDifference' => 'Emoji keword difference',
-  'object_emojiKeywordsDifference_param_lang_code_type_string' => 'Language code',
-  'object_emojiKeywordsDifference_param_from_version_type_int' => 'Previous version',
-  'object_emojiKeywordsDifference_param_version_type_int' => 'Current version',
+  'object_emojiKeywordsDifference' => 'Changes to emoji keywords',
+  'object_emojiKeywordsDifference_param_lang_code_type_string' => 'Language code for keywords',
+  'object_emojiKeywordsDifference_param_from_version_type_int' => 'Previous emoji keyword list version',
+  'object_emojiKeywordsDifference_param_version_type_int' => 'Current version of emoji keyword list',
   'object_emojiKeywordsDifference_param_keywords_type_Vector t' => 'Keywords',
-  'object_emojiURL' => 'Emoji URL',
-  'object_emojiURL_param_url_type_string' => 'URL',
-  'method_contacts.getTopPeers_param_forward_users_type_true' => 'Forward users?',
-  'method_contacts.getTopPeers_param_forward_chats_type_true' => 'Forward chats?',
+  'object_emojiURL' => 'An HTTP URL which can be used to automatically log in into translation platform and suggest new emoji replacements. The URL will be valid for 30 seconds after generation',
+  'object_emojiURL_param_url_type_string' => 'An HTTP URL which can be used to automatically log in into translation platform and suggest new emoji replacements. The URL will be valid for 30 seconds after generation',
+  'method_contacts.getTopPeers_param_forward_users_type_true' => 'Users to which the users often forwards messages to',
+  'method_contacts.getTopPeers_param_forward_chats_type_true' => 'Chats to which the users often forwards messages to',
   'method_messages.getDialogs_param_folder_id_type_int' => 'Folder ID',
-  'method_messages.searchGlobal_param_offset_rate_type_int' => 'Offset rate',
+  'method_messages.searchGlobal_param_offset_rate_type_int' => 'Initially 0, then set to the [`next_rate` parameter of messages.messagesSlice](../constructors/messages.messagesSlice.md)',
   'method_messages.reorderPinnedDialogs_param_folder_id_type_int' => 'Folder ID',
   'method_messages.getPinnedDialogs_param_folder_id_type_int' => 'Folder ID',
-  'method_messages.getEmojiKeywordsLanguages' => 'Get emoji keyword languages',
+  'method_messages.getEmojiKeywordsLanguages' => 'Get info about an emoji keyword localization',
   'method_messages.getEmojiKeywordsLanguages_param_lang_codes_type_Vector t' => 'Language codes',
-  'method_messages.getSearchCounters' => 'Get search counter',
-  'method_messages.getSearchCounters_param_peer_type_InputPeer' => 'Peer',
+  'method_messages.getSearchCounters' => 'Get the number of results that would be found by a [messages.search](../methods/messages.search.md) call with the same parameters',
+  'method_messages.getSearchCounters_param_peer_type_InputPeer' => 'Peer where to search',
   'method_messages.getSearchCounters_param_filters_type_Vector t' => 'Filters',
-  'method_messages.requestUrlAuth' => 'Request URL authorization',
-  'method_messages.requestUrlAuth_param_peer_type_InputPeer' => 'Peer',
-  'method_messages.requestUrlAuth_param_msg_id_type_int' => 'Message ID',
-  'method_messages.requestUrlAuth_param_button_id_type_int' => 'Button ID',
-  'method_messages.acceptUrlAuth' => 'Accept URL authorization',
-  'method_messages.acceptUrlAuth_param_write_allowed_type_true' => 'Write allowed?',
-  'method_messages.acceptUrlAuth_param_peer_type_InputPeer' => 'Peer',
-  'method_messages.acceptUrlAuth_param_msg_id_type_int' => 'Message ID',
-  'method_messages.acceptUrlAuth_param_button_id_type_int' => 'Button ID',
-  'method_channels.getGroupsForDiscussion' => 'Get groups for discussion',
+  'method_messages.requestUrlAuth' => 'Get more info about a Seamless Telegram Login authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization)',
+  'method_messages.requestUrlAuth_param_peer_type_InputPeer' => 'Peer where the message is located',
+  'method_messages.requestUrlAuth_param_msg_id_type_int' => 'The message',
+  'method_messages.requestUrlAuth_param_button_id_type_int' => 'The ID of the button with the authorization request',
+  'method_messages.acceptUrlAuth' => 'Use this to accept a Seamless Telegram Login authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization)',
+  'method_messages.acceptUrlAuth_param_write_allowed_type_true' => 'Set this flag to allow the bot to send messages to you (if requested)',
+  'method_messages.acceptUrlAuth_param_peer_type_InputPeer' => 'The location of the message',
+  'method_messages.acceptUrlAuth_param_msg_id_type_int' => 'Message ID of the message with the login button',
+  'method_messages.acceptUrlAuth_param_button_id_type_int' => 'ID of the login button',
+  'method_channels.getGroupsForDiscussion' => 'Get all groups that can be used as [discussion groups](https://telegram.org/blog/privacy-discussions-web-bots)',
   'method_channels.getBroadcastsForDiscussion' => 'Get channels for discussion',
-  'method_channels.setDiscussionGroup' => 'Set discussion group of channel',
-  'method_channels.setDiscussionGroup_param_broadcast_type_InputChannel' => 'The channel',
-  'method_channels.setDiscussionGroup_param_group_type_InputChannel' => 'The group',
-  'method_phone.requestCall_param_video_type_true' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_phone.discardCall_param_video_type_true' => 'You cannot use this method directly, see https://docs.madelineproto.xyz#calls for more info on handling calls',
-  'method_folders.editPeerFolders' => 'Edit folder',
+  'method_channels.setDiscussionGroup' => 'Associate a group to a channel as [discussion group](https://telegram.org/blog/privacy-discussions-web-bots) for that channel',
+  'method_channels.setDiscussionGroup_param_broadcast_type_InputChannel' => 'Channel',
+  'method_channels.setDiscussionGroup_param_group_type_InputChannel' => 'Discussion group to associate to the channel',
+  'method_phone.requestCall_param_video_type_true' => 'Whether to start a video call',
+  'method_phone.discardCall_param_video_type_true' => 'Whether this is a video call',
+  'method_folders.editPeerFolders' => 'Edit peers in folder',
   'method_folders.editPeerFolders_param_folder_peers_type_Vector t' => 'New folder peers',
-  'method_folders.deleteFolder' => 'Delete folder',
-  'method_folders.deleteFolder_param_folder_id_type_int' => 'Folder ID',
-  'object_inputPeerUserFromMessage' => 'User from message',
-  'object_inputPeerUserFromMessage_param_peer_type_InputPeer' => 'Chat',
-  'object_inputPeerUserFromMessage_param_msg_id_type_int' => 'Message ID',
-  'object_inputPeerUserFromMessage_param_user_id_type_int' => 'User ID',
-  'object_inputPeerChannelFromMessage' => 'Channel from message',
-  'object_inputPeerChannelFromMessage_param_peer_type_InputPeer' => 'Peer',
-  'object_inputPeerChannelFromMessage_param_msg_id_type_int' => 'Message ID',
-  'object_inputPeerChannelFromMessage_param_channel_id_type_int' => 'Channel ID',
-  'object_inputUserFromMessage' => 'User from message',
-  'object_inputUserFromMessage_param_peer_type_InputPeer' => 'Peer',
-  'object_inputUserFromMessage_param_msg_id_type_int' => 'Message ID',
-  'object_inputUserFromMessage_param_user_id_type_int' => 'User ID',
-  'object_inputDocumentFileLocation_param_thumb_size_type_string' => 'Thumb size',
-  'object_inputPhotoFileLocation' => 'Photo file location',
-  'object_inputPhotoFileLocation_param_id_type_long' => 'ID',
-  'object_inputPhotoFileLocation_param_access_hash_type_long' => 'Access hash',
-  'object_inputPhotoFileLocation_param_file_reference_type_bytes' => 'File reference',
-  'object_inputPhotoFileLocation_param_thumb_size_type_string' => 'Thumb size',
-  'object_inputPeerPhotoFileLocation' => 'Profile picture location',
-  'object_inputPeerPhotoFileLocation_param_big_type_true' => 'Big?',
-  'object_inputPeerPhotoFileLocation_param_peer_type_InputPeer' => 'Peer',
-  'object_inputPeerPhotoFileLocation_param_volume_id_type_long' => 'Volume ID',
-  'object_inputPeerPhotoFileLocation_param_local_id_type_int' => 'Local ID',
-  'object_inputStickerSetThumb' => 'Stickerset thumbnail',
-  'object_inputStickerSetThumb_param_stickerset_type_InputStickerSet' => 'Stickerset',
+  'method_folders.deleteFolder' => 'Delete a folder',
+  'method_folders.deleteFolder_param_folder_id_type_int' => 'Folder to delete',
+  'object_inputPeerUserFromMessage' => 'Defines a [min](https://core.telegram.org/api/min) user that was seen in a certain message of a certain chat.',
+  'object_inputPeerUserFromMessage_param_peer_type_InputPeer' => 'The chat where the user was seen',
+  'object_inputPeerUserFromMessage_param_msg_id_type_int' => 'The message ID',
+  'object_inputPeerUserFromMessage_param_user_id_type_int' => 'The identifier of the user that was seen',
+  'object_inputPeerChannelFromMessage' => 'Defines a [min](https://core.telegram.org/api/min) channel that was seen in a certain message of a certain chat.',
+  'object_inputPeerChannelFromMessage_param_peer_type_InputPeer' => 'The chat where the channel\'s message was seen',
+  'object_inputPeerChannelFromMessage_param_msg_id_type_int' => 'The message ID',
+  'object_inputPeerChannelFromMessage_param_channel_id_type_int' => 'The identifier of the channel that was seen',
+  'object_inputUserFromMessage' => 'Defines a [min](https://core.telegram.org/api/min) user that was seen in a certain message of a certain chat.',
+  'object_inputUserFromMessage_param_peer_type_InputPeer' => 'The chat where the user was seen',
+  'object_inputUserFromMessage_param_msg_id_type_int' => 'The message ID',
+  'object_inputUserFromMessage_param_user_id_type_int' => 'The identifier of the user that was seen',
+  'object_inputDocumentFileLocation_param_thumb_size_type_string' => 'Thumbnail size to download the thumbnail',
+  'object_inputPhotoFileLocation' => 'Use this object to download a photo with [upload.getFile](../methods/upload.getFile.md) method',
+  'object_inputPhotoFileLocation_param_id_type_long' => 'Photo ID, obtained from the [photo](../constructors/photo.md) object',
+  'object_inputPhotoFileLocation_param_access_hash_type_long' => 'Photo\'s access hash, obtained from the [photo](../constructors/photo.md) object',
+  'object_inputPhotoFileLocation_param_file_reference_type_bytes' => '[File reference](https://core.telegram.org/api/file_reference)',
+  'object_inputPhotoFileLocation_param_thumb_size_type_string' => 'The [PhotoSize](../types/PhotoSize.md) to download: must be set to the `type` field of the desired PhotoSize object of the [photo](../constructors/photo.md)',
+  'object_inputPeerPhotoFileLocation' => 'Location of profile photo of channel/group/supergroup/user',
+  'object_inputPeerPhotoFileLocation_param_big_type_true' => 'Whether to download the high-quality version of the picture',
+  'object_inputPeerPhotoFileLocation_param_peer_type_InputPeer' => 'The peer whose profile picture should be downloaded',
+  'object_inputPeerPhotoFileLocation_param_volume_id_type_long' => 'Volume ID from [FileLocation](../types/FileLocation.md) met in the profile photo container.',
+  'object_inputPeerPhotoFileLocation_param_local_id_type_int' => 'Local ID from [FileLocation](../types/FileLocation.md) met in the profile photo container.',
+  'object_inputStickerSetThumb' => 'Location of stickerset thumbnail (see [files](https://core.telegram.org/api/files))',
+  'object_inputStickerSetThumb_param_stickerset_type_InputStickerSet' => 'Sticker set',
   'object_inputStickerSetThumb_param_volume_id_type_long' => 'Volume ID',
   'object_inputStickerSetThumb_param_local_id_type_int' => 'Local ID',
-  'object_user_param_scam_type_true' => 'Scam?',
-  'object_userProfilePhoto_param_dc_id_type_int' => 'DC ID',
-  'object_channel_param_scam_type_true' => 'Scam channel',
-  'object_channel_param_has_link_type_true' => 'Has linked chat?',
+  'object_user_param_scam_type_true' => 'This may be a scam user',
+  'object_userProfilePhoto_param_dc_id_type_int' => 'DC ID where the photo is stored',
+  'object_channel_param_scam_type_true' => 'This channel/supergroup is probably a scam',
+  'object_channel_param_has_link_type_true' => 'Whether this channel has a private join link',
   'object_chatFull_param_folder_id_type_int' => 'Folder ID',
   'object_channelFull_param_folder_id_type_int' => 'Folder ID',
-  'object_channelFull_param_linked_chat_id_type_int' => 'Linked chat ID',
-  'object_channelFull_param_pts_type_int' => 'PTS',
-  'object_chatPhoto_param_dc_id_type_int' => 'DC ID',
-  'object_message_param_legacy_type_true' => 'Legacy message',
-  'object_messageService_param_legacy_type_true' => 'Legacy message',
-  'object_messageActionPhoneCall_param_video_type_true' => 'Video call?',
+  'object_channelFull_param_linked_chat_id_type_int' => 'ID of the linked discussion chat for channels',
+  'object_channelFull_param_pts_type_int' => 'Latest [PTS](https://core.telegram.org/api/updates) for this channel',
+  'object_chatPhoto_param_dc_id_type_int' => 'DC where this photo is stored',
+  'object_message_param_legacy_type_true' => 'This is a legacy message: it has to be refetched with the new layer',
+  'object_messageService_param_legacy_type_true' => 'This is a legacy message: it has to be refetched with the new layer',
+  'object_messageActionPhoneCall_param_video_type_true' => 'Is this a video call?',
   'object_dialog_param_folder_id_type_int' => 'Folder ID',
-  'object_dialogFolder' => 'Dialog folder',
-  'object_dialogFolder_param_pinned_type_true' => 'Pinned?',
-  'object_dialogFolder_param_folder_type_Folder' => 'Folder',
-  'object_dialogFolder_param_peer_type_Peer' => 'Peer',
-  'object_dialogFolder_param_top_message_type_int' => 'Top message',
-  'object_dialogFolder_param_unread_muted_peers_count_type_int' => 'Unread muted peers count',
-  'object_dialogFolder_param_unread_unmuted_peers_count_type_int' => 'Unread unmuted peer count',
-  'object_dialogFolder_param_unread_muted_messages_count_type_int' => 'Unread muted messages count',
-  'object_dialogFolder_param_unread_unmuted_messages_count_type_int' => 'Unread unmuted messages count',
-  'object_photo_param_dc_id_type_int' => 'DC ID',
+  'object_dialogFolder' => 'Dialog in folder',
+  'object_dialogFolder_param_pinned_type_true' => 'Is this folder pinned',
+  'object_dialogFolder_param_folder_type_Folder' => 'The folder',
+  'object_dialogFolder_param_peer_type_Peer' => 'Peer in folder',
+  'object_dialogFolder_param_top_message_type_int' => 'Latest message ID of dialog',
+  'object_dialogFolder_param_unread_muted_peers_count_type_int' => 'Number of unread muted peers in folder',
+  'object_dialogFolder_param_unread_unmuted_peers_count_type_int' => 'Number of unread unmuted peers in folder',
+  'object_dialogFolder_param_unread_muted_messages_count_type_int' => 'Number of unread messages from muted peers in folder',
+  'object_dialogFolder_param_unread_unmuted_messages_count_type_int' => 'Number of unread messages from unmuted peers in folder',
+  'object_photo_param_dc_id_type_int' => 'DC ID to use for download',
   'object_userFull_param_folder_id_type_int' => 'Folder ID',
-  'object_messages.messagesSlice_param_next_rate_type_int' => 'Next rate',
+  'object_messages.messagesSlice_param_next_rate_type_int' => 'Rate to use in the `offset_rate` parameter in the next call to [messages.searchGlobal](../methods/messages.searchGlobal.md)',
   'object_updateReadHistoryInbox_param_folder_id_type_int' => 'Folder ID',
-  'object_updateReadHistoryInbox_param_still_unread_count_type_int' => 'Still unread count',
-  'object_updateReadChannelInbox_param_folder_id_type_int' => 'Folder ID',
-  'object_updateReadChannelInbox_param_still_unread_count_type_int' => 'Still unread count',
-  'object_updateReadChannelInbox_param_pts_type_int' => 'PTS',
-  'object_updateDialogPinned_param_folder_id_type_int' => 'Folder ID',
-  'object_updatePinnedDialogs_param_folder_id_type_int' => 'Folder ID',
-  'object_updateFolderPeers' => 'Folder update',
+  'object_updateReadHistoryInbox_param_still_unread_count_type_int' => 'Number of messages that are still unread',
+  'object_updateReadChannelInbox_param_folder_id_type_int' => 'ID of folder for peers in folders',
+  'object_updateReadChannelInbox_param_still_unread_count_type_int' => 'Count of messages weren\'t read yet',
+  'object_updateReadChannelInbox_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+  'object_updateDialogPinned_param_folder_id_type_int' => 'If the dialog is in a folder, the folder ID',
+  'object_updatePinnedDialogs_param_folder_id_type_int' => 'If the dialogs are in a folder, the folder ID',
+  'object_updateFolderPeers' => 'The dialog list of a folder was changed',
   'object_updateFolderPeers_param_folder_peers_type_Vector t' => 'New folder peers',
-  'object_updateFolderPeers_param_pts_type_int' => 'PTS',
-  'object_updateFolderPeers_param_pts_count_type_int' => 'PTS',
-  'object_config_param_pinned_infolder_count_max_type_int' => 'Pinned infolder count max_type',
-  'object_inputPrivacyKeyPhoneNumber' => 'Phone number',
-  'object_privacyKeyPhoneNumber' => 'Phone number',
-  'object_inputPrivacyValueAllowChatParticipants' => 'Allow chat participant?',
+  'object_updateFolderPeers_param_pts_type_int' => '[Event count after generation](https://core.telegram.org/api/updates)',
+  'object_updateFolderPeers_param_pts_count_type_int' => '[Number of events that were generated](https://core.telegram.org/api/updates)',
+  'object_config_param_pinned_infolder_count_max_type_int' => 'Maximum count of dialogs per folder',
+  'object_inputPrivacyKeyPhoneNumber' => 'Whether people will be able to see the user\'s phone number',
+  'object_privacyKeyPhoneNumber' => 'Whether the user allows us to see his phone number',
+  'object_inputPrivacyValueAllowChatParticipants' => 'Allow only participants of certain chats',
   'object_inputPrivacyValueAllowChatParticipants_param_chats_type_Vector t' => 'Chats',
-  'object_inputPrivacyValueDisallowChatParticipants' => 'Disallowed chats',
+  'object_inputPrivacyValueDisallowChatParticipants' => 'Disallow only participants of certain chats',
   'object_inputPrivacyValueDisallowChatParticipants_param_chats_type_Vector t' => 'CHats',
-  'object_privacyValueAllowChatParticipants' => 'Allow chat participants?',
+  'object_privacyValueAllowChatParticipants' => 'Allow all participants of certain chats',
   'object_privacyValueAllowChatParticipants_param_chats_type_Vector t' => 'Allowed chats',
-  'object_privacyValueDisallowChatParticipants' => 'Diallowed chats',
+  'object_privacyValueDisallowChatParticipants' => 'Disallow only participants of certain chats',
   'object_privacyValueDisallowChatParticipants_param_chats_type_Vector t' => 'Disallowed chats',
   'object_account.privacyRules_param_chats_type_Vector t' => 'Chats allowed?',
-  'object_chatInvite_param_photo_type_Photo' => 'Photo',
-  'object_stickerSet_param_thumb_dc_id_type_int' => 'DC ID',
-  'object_keyboardButtonUrlAuth' => 'Url authorization request',
-  'object_keyboardButtonUrlAuth_param_text_type_string' => 'Text',
-  'object_keyboardButtonUrlAuth_param_fwd_text_type_string' => 'Forward text',
-  'object_keyboardButtonUrlAuth_param_url_type_string' => 'URL',
-  'object_keyboardButtonUrlAuth_param_button_id_type_int' => 'Button ID',
-  'object_inputKeyboardButtonUrlAuth' => 'Request authorization',
-  'object_inputKeyboardButtonUrlAuth_param_request_write_access_type_true' => 'Request write access?',
-  'object_inputKeyboardButtonUrlAuth_param_text_type_string' => 'Text',
-  'object_inputKeyboardButtonUrlAuth_param_fwd_text_type_string' => 'Forward text',
-  'object_inputKeyboardButtonUrlAuth_param_url_type_string' => 'URL',
-  'object_inputKeyboardButtonUrlAuth_param_bot_type_InputUser' => 'Bot',
-  'object_inputChannelFromMessage' => 'Channel from message',
-  'object_inputChannelFromMessage_param_peer_type_InputPeer' => 'Peer',
-  'object_inputChannelFromMessage_param_msg_id_type_int' => 'Message ID',
-  'object_inputChannelFromMessage_param_channel_id_type_int' => 'Channel ID',
-  'object_updates.channelDifferenceTooLong_param_dialog_type_Dialog' => 'Dialog',
-  'object_topPeerCategoryForwardUsers' => 'Top peer category: forward users',
-  'object_topPeerCategoryForwardChats' => 'Top peer category: forward chats',
-  'object_phoneCallWaiting_param_video_type_true' => 'Video call?',
-  'object_phoneCallRequested_param_video_type_true' => 'Video call?',
-  'object_phoneCallAccepted_param_video_type_true' => 'Video call?',
+  'object_chatInvite_param_photo_type_Photo' => 'Chat/supergroup/channel photo',
+  'object_stickerSet_param_thumb_dc_id_type_int' => 'DC ID of thumbnail',
+  'object_keyboardButtonUrlAuth' => 'Button to request a user to authorize via URL using [Seamless Telegram Login](https://telegram.org/blog/privacy-discussions-web-bots#meet-seamless-web-bots). When the user clicks on such a button, [messages.requestUrlAuth](../methods/messages.requestUrlAuth.md) should be called, providing the `button_id` and the ID of the container message. The returned [urlAuthResultRequest](../constructors/urlAuthResultRequest.md) object will contain more details about the authorization request (`request_write_access` if the bot would like to send messages to the user along with the username of the bot which will be used for user authorization). Finally, the user can choose to call [messages.acceptUrlAuth](../methods/messages.acceptUrlAuth.md) to get a [urlAuthResultAccepted](../constructors/urlAuthResultAccepted.md) with the URL to open instead of the `url` of this constructor, or a [urlAuthResultDefault](../constructors/urlAuthResultDefault.md), in which case the `url` of this constructor must be opened, instead. If the user refuses the authorization request but still wants to open the link, the `url` of this constructor must be used.',
+  'object_keyboardButtonUrlAuth_param_text_type_string' => 'Button label',
+  'object_keyboardButtonUrlAuth_param_fwd_text_type_string' => 'New text of the button in forwarded messages.',
+  'object_keyboardButtonUrlAuth_param_url_type_string' => 'An HTTP URL to be opened with user authorization data added to the query string when the button is pressed. If the user refuses to provide authorization data, the original URL without information about the user will be opened. The data added is the same as described in [Receiving authorization data](https://core.telegram.org/widgets/login#receiving-authorization-data).

**NOTE**: Services must **always** check the hash of the received data to verify the authentication and the integrity of the data as described in [Checking authorization](https://core.telegram.org/widgets/login#checking-authorization).',
+  'object_keyboardButtonUrlAuth_param_button_id_type_int' => 'ID of the button to pass to [messages.requestUrlAuth](../methods/messages.requestUrlAuth.md)',
+  'object_inputKeyboardButtonUrlAuth' => 'Button to request a user to [authorize](../methods/messages.acceptUrlAuth.md) via URL using [Seamless Telegram Login](https://telegram.org/blog/privacy-discussions-web-bots#meet-seamless-web-bots).',
+  'object_inputKeyboardButtonUrlAuth_param_request_write_access_type_true' => 'Set this flag to request the permission for your bot to send messages to the user.',
+  'object_inputKeyboardButtonUrlAuth_param_text_type_string' => 'Button text',
+  'object_inputKeyboardButtonUrlAuth_param_fwd_text_type_string' => 'New text of the button in forwarded messages.',
+  'object_inputKeyboardButtonUrlAuth_param_url_type_string' => 'An HTTP URL to be opened with user authorization data added to the query string when the button is pressed. If the user refuses to provide authorization data, the original URL without information about the user will be opened. The data added is the same as described in [Receiving authorization data](https://core.telegram.org/widgets/login#receiving-authorization-data).
NOTE: You must always check the hash of the received data to verify the authentication and the integrity of the data as described in [Checking authorization](https://core.telegram.org/widgets/login#checking-authorization).',
+  'object_inputKeyboardButtonUrlAuth_param_bot_type_InputUser' => 'Username of a bot, which will be used for user authorization. See [Setting up a bot](https://core.telegram.org/widgets/login#setting-up-a-bot) for more details. If not specified, the current bot\'s username will be assumed. The url\'s domain must be the same as the domain linked with the bot. See [Linking your domain to the bot](https://core.telegram.org/widgets/login#linking-your-domain-to-the-bot) for more details.',
+  'object_inputChannelFromMessage' => 'Defines a [min](https://core.telegram.org/api/min) channel that was seen in a certain message of a certain chat.',
+  'object_inputChannelFromMessage_param_peer_type_InputPeer' => 'The chat where the channel was seen',
+  'object_inputChannelFromMessage_param_msg_id_type_int' => 'The message ID in the chat where the channel was seen',
+  'object_inputChannelFromMessage_param_channel_id_type_int' => 'The channel ID',
+  'object_updates.channelDifferenceTooLong_param_dialog_type_Dialog' => 'Dialog containing the latest [PTS](https://core.telegram.org/api/updates) that can be used to reset the channel state',
+  'object_topPeerCategoryForwardUsers' => 'Users to which the users often forwards messages to',
+  'object_topPeerCategoryForwardChats' => 'Chats to which the users often forwards messages to',
+  'object_phoneCallWaiting_param_video_type_true' => 'Is this a video call',
+  'object_phoneCallRequested_param_video_type_true' => 'Whether this is a video call',
+  'object_phoneCallAccepted_param_video_type_true' => 'Whether this is a video call',
   'object_phoneCall_param_connections_type_Vector t' => 'Phone connections',
-  'object_phoneCallDiscarded_param_video_type_true' => 'Video call?',
-  'object_channelAdminLogEventActionChangePhoto_param_prev_photo_type_Photo' => 'Old photo',
-  'object_channelAdminLogEventActionChangePhoto_param_new_photo_type_Photo' => 'New photo',
-  'object_channelAdminLogEventActionChangeLinkedChat' => 'Linked chat was changed',
-  'object_channelAdminLogEventActionChangeLinkedChat_param_prev_value_type_int' => 'Old linked chat',
+  'object_phoneCallDiscarded_param_video_type_true' => 'Whether the call was a video call',
+  'object_channelAdminLogEventActionChangePhoto_param_prev_photo_type_Photo' => 'Previous picture',
+  'object_channelAdminLogEventActionChangePhoto_param_new_photo_type_Photo' => 'New picture',
+  'object_channelAdminLogEventActionChangeLinkedChat' => 'The linked chat was changed',
+  'object_channelAdminLogEventActionChangeLinkedChat_param_prev_value_type_int' => 'Previous linked chat',
   'object_channelAdminLogEventActionChangeLinkedChat_param_new_value_type_int' => 'New linked chat',
-  'object_inputDialogPeerFolder' => 'Dialog peer folder',
+  'object_inputDialogPeerFolder' => 'All peers in a folder',
   'object_inputDialogPeerFolder_param_folder_id_type_int' => 'Folder ID',
-  'object_dialogPeerFolder' => 'Dialog peer folder',
+  'object_dialogPeerFolder' => 'Folder',
   'object_dialogPeerFolder_param_folder_id_type_int' => 'Folder ID',
   'object_emojiLanguage' => 'Emoji language',
   'object_emojiLanguage_param_lang_code_type_string' => 'Language code',
-  'object_fileLocationToBeDeprecated' => 'File location (deprecated)',
+  'object_fileLocationToBeDeprecated' => 'Indicates the location of a photo, will be deprecated soon',
   'object_fileLocationToBeDeprecated_param_volume_id_type_long' => 'Volume ID',
   'object_fileLocationToBeDeprecated_param_local_id_type_int' => 'Local ID',
   'object_folder' => 'Folder',
-  'object_folder_param_autofill_new_broadcasts_type_true' => 'New broadcasts?',
-  'object_folder_param_autofill_public_groups_type_true' => 'Autofill public groups?',
-  'object_folder_param_autofill_new_correspondents_type_true' => 'New correspondents',
-  'object_folder_param_id_type_int' => 'ID',
-  'object_folder_param_title_type_string' => 'Title',
-  'object_folder_param_photo_type_ChatPhoto' => 'Photo',
-  'object_inputFolderPeer' => 'Folder peer',
+  'object_folder_param_autofill_new_broadcasts_type_true' => 'Automatically add new channels to this folder',
+  'object_folder_param_autofill_public_groups_type_true' => 'Automatically add joined new public supergroups to this folder',
+  'object_folder_param_autofill_new_correspondents_type_true' => 'Automatically add new private chats to this folder',
+  'object_folder_param_id_type_int' => 'Folder ID',
+  'object_folder_param_title_type_string' => 'Folder title',
+  'object_folder_param_photo_type_ChatPhoto' => 'Folder picture',
+  'object_inputFolderPeer' => 'Peer in a folder',
   'object_inputFolderPeer_param_peer_type_InputPeer' => 'Peer',
   'object_inputFolderPeer_param_folder_id_type_int' => 'Folder ID',
-  'object_folderPeer' => 'Peer',
-  'object_folderPeer_param_peer_type_Peer' => 'Peer',
+  'object_folderPeer' => 'Peer in a folder',
+  'object_folderPeer_param_peer_type_Peer' => 'Folder peer info',
   'object_folderPeer_param_folder_id_type_int' => 'Folder ID',
-  'object_messages.searchCounter' => 'Search counter',
-  'object_messages.searchCounter_param_inexact_type_true' => 'Inexact?',
-  'object_messages.searchCounter_param_filter_type_MessagesFilter' => 'Filter',
-  'object_messages.searchCounter_param_count_type_int' => 'Count',
-  'object_urlAuthResultRequest' => 'Request',
-  'object_urlAuthResultRequest_param_request_write_access_type_true' => 'Request write access?',
-  'object_urlAuthResultRequest_param_bot_type_User' => 'Bot',
-  'object_urlAuthResultRequest_param_domain_type_string' => 'Doamin',
-  'object_urlAuthResultAccepted' => 'URL authorization accepted',
-  'object_urlAuthResultAccepted_param_url_type_string' => 'URL',
-  'object_urlAuthResultDefault' => 'Default result',
-  'method_contacts.addContact' => 'Add contact',
-  'method_contacts.addContact_param_add_phone_privacy_exception_type_true' => 'Phone privacy exception?',
-  'method_contacts.addContact_param_id_type_InputUser' => 'ID',
+  'object_messages.searchCounter' => 'Indicates how many results would be found by a [messages.search](../methods/messages.search.md) call with the same parameters',
+  'object_messages.searchCounter_param_inexact_type_true' => 'If set, the results may be inexact',
+  'object_messages.searchCounter_param_filter_type_MessagesFilter' => 'Provided message filter',
+  'object_messages.searchCounter_param_count_type_int' => 'Number of results that were found server-side',
+  'object_urlAuthResultRequest' => 'Details about the authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization)',
+  'object_urlAuthResultRequest_param_request_write_access_type_true' => 'Whether the bot would like to send messages to the user',
+  'object_urlAuthResultRequest_param_bot_type_User' => 'Username of a bot, which will be used for user authorization. If not specified, the current bot\'s username will be assumed. The url\'s domain must be the same as the domain linked with the bot. See [Linking your domain to the bot](https://core.telegram.org/widgets/login#linking-your-domain-to-the-bot) for more details.',
+  'object_urlAuthResultRequest_param_domain_type_string' => 'The domain name of the website on which the user will log in.',
+  'object_urlAuthResultAccepted' => 'Details about an accepted authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization)',
+  'object_urlAuthResultAccepted_param_url_type_string' => 'The URL name of the website on which the user has logged in.',
+  'object_urlAuthResultDefault' => 'Details about an accepted authorization request, for more info [click here »](https://core.telegram.org/api/url-authorization)',
+  'method_contacts.addContact' => 'Add an existing telegram user as contact',
+  'method_contacts.addContact_param_add_phone_privacy_exception_type_true' => 'Allow the other user to see our phone number?',
+  'method_contacts.addContact_param_id_type_InputUser' => 'Telegram ID of the other user',
   'method_contacts.addContact_param_first_name_type_string' => 'First name',
   'method_contacts.addContact_param_last_name_type_string' => 'Last name',
-  'method_contacts.addContact_param_phone_type_string' => 'Phone number',
-  'method_contacts.acceptContact' => 'Accept contact',
-  'method_contacts.acceptContact_param_id_type_InputUser' => 'ID',
-  'method_contacts.getLocated' => 'Get people nearby (geochats)',
-  'method_contacts.getLocated_param_geo_point_type_InputGeoPoint' => 'Current location',
-  'method_messages.searchGlobal_param_folder_id_type_int' => 'Folder ID',
-  'method_messages.hidePeerSettingsBar' => 'Hide peer settings bar',
+  'method_contacts.addContact_param_phone_type_string' => 'User\'s phone number',
+  'method_contacts.acceptContact' => 'If the [peer settings](../constructors/peerSettings.md) of a new user allow us to add him as contact, add that user as contact',
+  'method_contacts.acceptContact_param_id_type_InputUser' => 'The user to add as contact',
+  'method_contacts.getLocated' => 'Get contacts near you',
+  'method_contacts.getLocated_param_geo_point_type_InputGeoPoint' => 'Geolocation',
+  'method_messages.searchGlobal_param_folder_id_type_int' => 'Folder where to search',
+  'method_messages.hidePeerSettingsBar' => 'Should be called after the user hides the report spam/add as contact bar of a new chat, effectively prevents the user from executing the actions specified in the [peer\'s settings](../constructors/peerSettings.md).',
   'method_messages.hidePeerSettingsBar_param_peer_type_InputPeer' => 'Peer',
-  'method_channels.createChannel_param_geo_point_type_InputGeoPoint' => 'Geopoint (geochats)',
-  'method_channels.createChannel_param_address_type_string' => 'Physical address (geochats)',
-  'method_channels.getAdminedPublicChannels_param_by_location_type_true' => 'Get channels by location',
-  'method_channels.getAdminedPublicChannels_param_check_limit_type_true' => 'Check limit',
-  'method_channels.editCreator' => 'Edit creator of channel',
+  'method_channels.createChannel_param_geo_point_type_InputGeoPoint' => 'Geogroup location',
+  'method_channels.createChannel_param_address_type_string' => 'Geogroup address',
+  'method_channels.getAdminedPublicChannels_param_by_location_type_true' => 'Get geogroups',
+  'method_channels.getAdminedPublicChannels_param_check_limit_type_true' => 'If set and the user has reached the limit of owned public [channels/supergroups/geogroups](https://core.telegram.org/api/channel), instead of returning the channel list one of the specified [errors](#possible-errors) will be returned.
Useful to check if a new public channel can indeed be created, even before asking the user to enter a channel username to use in [channels.checkUsername](../methods/channels.checkUsername.md)/[channels.updateUsername](../methods/channels.updateUsername.md).',
+  'method_channels.editCreator' => 'Transfer channel ownership',
   'method_channels.editCreator_param_channel_type_InputChannel' => 'Channel',
-  'method_channels.editCreator_param_user_id_type_InputUser' => 'User ID',
-  'method_channels.editCreator_param_password_type_InputCheckPasswordSRP' => 'Password',
-  'method_channels.editLocation' => 'Edit location (geochats)',
-  'method_channels.editLocation_param_channel_type_InputChannel' => 'Channel',
-  'method_channels.editLocation_param_geo_point_type_InputGeoPoint' => 'Geo point',
-  'method_channels.editLocation_param_address_type_string' => 'Physical location (geochats)',
-  'object_channelFull_param_can_set_location_type_true' => 'Can set location?',
-  'object_channelFull_param_location_type_ChannelLocation' => 'Location',
-  'object_peerSettings_param_add_contact_type_true' => 'Can add as a contact?',
-  'object_peerSettings_param_block_contact_type_true' => 'Block contact',
-  'object_peerSettings_param_share_contact_type_true' => 'Share contact',
-  'object_peerSettings_param_need_contacts_exception_type_true' => 'Contact exception',
-  'object_peerSettings_param_report_geo_type_true' => 'Geotype',
-  'object_inputReportReasonGeoIrrelevant' => 'Irrelevant geochat',
+  'method_channels.editCreator_param_user_id_type_InputUser' => 'New channel owner',
+  'method_channels.editCreator_param_password_type_InputCheckPasswordSRP' => '[2FA password](https://core.telegram.org/api/srp) of account',
+  'method_channels.editLocation' => 'Edit location of geogroup',
+  'method_channels.editLocation_param_channel_type_InputChannel' => '[Geogroup](https://core.telegram.org/api/channel)',
+  'method_channels.editLocation_param_geo_point_type_InputGeoPoint' => 'New geolocation',
+  'method_channels.editLocation_param_address_type_string' => 'Address string',
+  'object_channelFull_param_can_set_location_type_true' => 'Can we set the geolocation of this group (for geogroups)',
+  'object_channelFull_param_location_type_ChannelLocation' => 'Location of the geogroup',
+  'object_peerSettings_param_add_contact_type_true' => 'Whether we can add the user as contact',
+  'object_peerSettings_param_block_contact_type_true' => 'Whether we can block the user',
+  'object_peerSettings_param_share_contact_type_true' => 'Whether we can share the user\'s contact',
+  'object_peerSettings_param_need_contacts_exception_type_true' => 'Whether a special exception for contacts is needed',
+  'object_peerSettings_param_report_geo_type_true' => 'Whether we can report a geogroup is irrelevant for this location',
+  'object_inputReportReasonGeoIrrelevant' => 'Report an irrelevant geogroup',
   'object_userFull_param_settings_type_PeerSettings' => 'Peer settings',
-  'object_updatePeerSettings' => 'Peer settings updated',
-  'object_updatePeerSettings_param_peer_type_Peer' => 'Peer',
-  'object_updatePeerSettings_param_settings_type_PeerSettings' => 'Settings',
-  'object_updatePeerLocated' => 'Peer location updated',
+  'object_updatePeerSettings' => 'Settings of a certain peer have changed',
+  'object_updatePeerSettings_param_peer_type_Peer' => 'The peer',
+  'object_updatePeerSettings_param_settings_type_PeerSettings' => 'Associated peer settings',
+  'object_updatePeerLocated' => 'List of peers near you was updated',
   'object_updatePeerLocated_param_peers_type_Vector t' => 'Peers',
-  'object_stickerSet_param_animated_type_true' => 'Animated stickerset?',
-  'object_messageEntityUnderline' => 'Underline',
-  'object_messageEntityUnderline_param_offset_type_int' => 'Offset',
-  'object_messageEntityUnderline_param_length_type_int' => 'Length',
-  'object_messageEntityStrike' => 'Strikethrough',
-  'object_messageEntityStrike_param_offset_type_int' => 'Offset',
-  'object_messageEntityStrike_param_length_type_int' => 'Length',
-  'object_messageEntityBlockquote' => 'Quote',
-  'object_messageEntityBlockquote_param_offset_type_int' => 'Offset',
-  'object_messageEntityBlockquote_param_length_type_int' => 'Length',
-  'object_channelAdminLogEventActionChangeLocation' => 'Channel location changed',
-  'object_channelAdminLogEventActionChangeLocation_param_prev_value_type_ChannelLocation' => 'Previous value',
-  'object_channelAdminLogEventActionChangeLocation_param_new_value_type_ChannelLocation' => 'New value',
-  'object_channelLocationEmpty' => 'No physical location (normal chat/channel)',
-  'object_channelLocation' => 'Physical location (getchats)',
-  'object_channelLocation_param_geo_point_type_GeoPoint' => 'Geo point',
-  'object_channelLocation_param_address_type_string' => 'Physical address',
-  'object_peerLocated' => 'Located peer',
+  'object_stickerSet_param_animated_type_true' => 'Is this an animated stickerpack',
+  'object_messageEntityUnderline' => 'Message entity representing underlined text.',
+  'object_messageEntityUnderline_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityUnderline_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityStrike' => 'Message entity representing strikethrough text.',
+  'object_messageEntityStrike_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityStrike_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityBlockquote' => 'Message entity representing a block quote.',
+  'object_messageEntityBlockquote_param_offset_type_int' => 'Offset of message entity within message (in UTF-8 codepoints)',
+  'object_messageEntityBlockquote_param_length_type_int' => 'Length of message entity within message (in UTF-8 codepoints)',
+  'object_channelAdminLogEventActionChangeLocation' => 'The geogroup location was changed',
+  'object_channelAdminLogEventActionChangeLocation_param_prev_value_type_ChannelLocation' => 'Previous location',
+  'object_channelAdminLogEventActionChangeLocation_param_new_value_type_ChannelLocation' => 'New location',
+  'object_channelLocationEmpty' => 'No location (normal supergroup)',
+  'object_channelLocation' => 'Geographical location of supergroup (geogroups)',
+  'object_channelLocation_param_geo_point_type_GeoPoint' => 'Geographical location of supergrup',
+  'object_channelLocation_param_address_type_string' => 'Textual description of the address',
+  'object_peerLocated' => 'Peer geolocated nearby',
   'object_peerLocated_param_peer_type_Peer' => 'Peer',
-  'object_peerLocated_param_expires_type_int' => 'Expiry date',
-  'object_peerLocated_param_distance_type_int' => 'Distance',
-  'method_account.registerDevice_param_no_muted_type_true' => 'Idk yet',
-  'method_upload.getFile_param_precise_type_true' => 'You cannot use this method directly, use the upload, downloadToStream, downloadToFile, downloadToDir methods instead; see https://docs.madelineproto.xyz for more info',
-  'method_channels.editAdmin_param_rank_type_string' => 'Admin rank, an arbitrary string',
-  'method_channels.toggleSlowMode' => 'Toggle slow mode',
-  'method_channels.toggleSlowMode_param_channel_type_InputChannel' => 'Supergroup',
-  'method_channels.toggleSlowMode_param_seconds_type_int' => 'Users will only be able to send one message every `seconds` seconds, `0` to disable the limitation ',
-  'object_channel_param_has_geo_type_true' => 'Whether this is a geogroup',
-  'object_channel_param_slowmode_enabled_type_true' => 'Whether slowmode is enabled',
+  'object_peerLocated_param_expires_type_int' => 'Validity period of current data',
+  'object_peerLocated_param_distance_type_int' => 'Distance from the peer in meters',
+  'method_account.registerDevice_param_no_muted_type_true' => 'Avoid receiving (silent and invisible background) notifications. Useful to save battery.',
+  'method_upload.getFile_param_precise_type_true' => 'Disable some checks on limit and offset values, useful for example to stream videos by keyframes',
+  'method_channels.editAdmin_param_rank_type_string' => 'Indicates the role (rank) of the admin in the group: just an arbitrary string',
+  'method_channels.toggleSlowMode' => 'Toggle supergroup slow mode: if enabled, users will only be able to send one message every `seconds` seconds',
+  'method_channels.toggleSlowMode_param_channel_type_InputChannel' => 'The [supergroup](https://core.telegram.org/api/channel)',
+  'method_channels.toggleSlowMode_param_seconds_type_int' => 'Users will only be able to send one message every `seconds` seconds, `0` to disable the limitation',
+  'object_channel_param_has_geo_type_true' => 'Whether this chanel has a geoposition',
+  'object_channel_param_slowmode_enabled_type_true' => 'Whether slow mode is enabled for groups to prevent flood in chat',
   'object_channelFull_param_slowmode_seconds_type_int' => 'If specified, users in supergroups will only be able to send one message every `slowmode_seconds` seconds',
-  'object_auth.authorizationSignUpRequired' => 'Signup is required',
-  'object_auth.authorizationSignUpRequired_param_terms_of_service_type_help.TermsOfService' => 'Telegram\'s Terms of Service',
-  'object_help.appUpdate_param_can_not_skip_type_true' => 'Whether the update is skippable',
+  'object_auth.authorizationSignUpRequired' => 'An account with this phone number doesn\'t exist on telegram: the user has to [enter basic information and sign up](https://core.telegram.org/api/auth)',
+  'object_auth.authorizationSignUpRequired_param_terms_of_service_type_help.TermsOfService' => 'Telegram\'s terms of service: the user must read and accept the terms of service before signing up to telegram',
+  'object_help.appUpdate_param_can_not_skip_type_true' => 'Unskippable, the new info must be shown to the user (with a popup or something else)',
   'object_inputStickerSetAnimatedEmoji' => 'Animated emojis stickerset',
-  'object_channelParticipantCreator_param_rank_type_string' => 'Creator rank, an arbitrary string',
-  'object_channelParticipantAdmin_param_rank_type_string' => 'Admin\'s rank, an arbitrary string',
-  'object_payments.paymentVerificationNeeded' => 'Payment verification needed',
-  'object_payments.paymentVerificationNeeded_param_url_type_string' => '3dsecure URL',
-  'object_channelAdminLogEventActionToggleSlowMode' => 'Channel admin log event action toggle slow mode',
-  'object_channelAdminLogEventActionToggleSlowMode_param_prev_value_type_int' => 'Prev value',
-  'object_channelAdminLogEventActionToggleSlowMode_param_new_value_type_int' => 'New value',
-  'object_codeSettings_param_allow_app_hash_type_true' => 'Whether to allow a persistent app hash',
-  'object_channelFull_param_slowmode_next_send_date_type_int' => ' Indicates when the user will be allowed to send another message in the supergroup (unixdate)',
+  'object_channelParticipantCreator_param_rank_type_string' => 'The role (rank) of the group creator in the group: just an arbitrary string, `admin` by default',
+  'object_channelParticipantAdmin_param_rank_type_string' => 'The role (rank) of the admin in the group: just an arbitrary string, `admin` by default',
+  'object_payments.paymentVerificationNeeded' => 'Payment was not successful, additional verification is needed',
+  'object_payments.paymentVerificationNeeded_param_url_type_string' => 'URL for additional payment credentials verification',
+  'object_channelAdminLogEventActionToggleSlowMode' => '[Slow mode setting for supergroups was changed](../methods/channels.toggleSlowMode.md)',
+  'object_channelAdminLogEventActionToggleSlowMode_param_prev_value_type_int' => 'Previous slow mode value',
+  'object_channelAdminLogEventActionToggleSlowMode_param_new_value_type_int' => 'New slow mode value',
+  'object_codeSettings_param_allow_app_hash_type_true' => 'If a token that will be included in eventually sent SMSs is required: required in newer versions of android, to use the [android SMS receiver APIs](https://developers.google.com/identity/sms-retriever/overview)',
+  'object_channelFull_param_slowmode_next_send_date_type_int' => 'Indicates when the user will be allowed to send another message in the supergroup (unixdate)',
   'method_account.uploadTheme' => 'Upload theme',
-  'method_account.uploadTheme_param_file_type_InputFile' => 'File',
-  'method_account.uploadTheme_param_thumb_type_InputFile' => 'Thumb',
+  'method_account.uploadTheme_param_file_type_InputFile' => 'Theme file uploaded as described in [files »](https://core.telegram.org/api/files)',
+  'method_account.uploadTheme_param_thumb_type_InputFile' => 'Thumbnail',
   'method_account.uploadTheme_param_file_name_type_string' => 'File name',
-  'method_account.uploadTheme_param_mime_type_type_string' => 'Mime type',
+  'method_account.uploadTheme_param_mime_type_type_string' => 'MIME type, must be `application/x-tgtheme-{format}`, where `format` depends on the client',
   'method_account.createTheme' => 'Create a theme',
   'method_account.createTheme_param_slug_type_string' => 'Unique theme ID',
   'method_account.createTheme_param_title_type_string' => 'Theme name',
@@ -10253,8 +10661,8 @@ class Lang
   'method_account.updateTheme_param_document_type_InputDocument' => 'Theme file',
   'method_account.saveTheme_param_theme_type_InputTheme' => 'Theme to save',
   'method_account.saveTheme_param_unsave_type_Bool' => 'Unsave',
-  'method_account.installTheme' => 'Install theme',
-  'method_account.installTheme_param_format_type_string' => 'Format',
+  'method_account.installTheme' => 'Install a theme',
+  'method_account.installTheme_param_format_type_string' => 'Theme format, a string that identifies the theming engines supported by the client',
   'method_account.installTheme_param_theme_type_InputTheme' => 'Theme to install',
   'method_account.getTheme' => 'Get theme information',
   'method_account.getTheme_param_format_type_string' => 'Theme format, a string that identifies the theming engines supported by the client',
@@ -10262,19 +10670,19 @@ class Lang
   'method_account.getTheme_param_document_id_type_long' => 'Document ID',
   'method_account.getThemes_param_format_type_string' => 'Theme format, a string that identifies the theming engines supported by the client',
   'method_account.getThemes_param_hash_type_Vector t' => 'Hash for pagination',
-  'method_messages.sendMessage_param_schedule_date_type_int' => 'Schedule date',
-  'method_messages.sendMedia_param_schedule_date_type_int' => 'Schedule date',
-  'method_messages.forwardMessages_param_schedule_date_type_int' => 'Schedule date',
-  'method_messages.sendInlineBotResult_param_schedule_date_type_int' => 'Schedule date',
-  'method_messages.editMessage_param_schedule_date_type_int' => 'Schedule date',
-  'method_messages.sendMultiMedia_param_schedule_date_type_int' => 'Schedule date',
-  'method_messages.getScheduledHistory' => 'Get scheduled history',
+  'method_messages.sendMessage_param_schedule_date_type_int' => 'Scheduled message date for scheduled messages',
+  'method_messages.sendMedia_param_schedule_date_type_int' => 'Scheduled message date for scheduled messages',
+  'method_messages.forwardMessages_param_schedule_date_type_int' => 'Scheduled message date for scheduled messages',
+  'method_messages.sendInlineBotResult_param_schedule_date_type_int' => 'Scheduled message date for scheduled messages',
+  'method_messages.editMessage_param_schedule_date_type_int' => 'Scheduled message date for scheduled messages',
+  'method_messages.sendMultiMedia_param_schedule_date_type_int' => 'Scheduled message date for scheduled messages',
+  'method_messages.getScheduledHistory' => 'Get scheduled messages',
   'method_messages.getScheduledHistory_param_peer_type_InputPeer' => 'Peer',
   'method_messages.getScheduledHistory_param_hash_type_Vector t' => 'Hash',
   'method_messages.getScheduledMessages' => 'Get scheduled messages',
   'method_messages.getScheduledMessages_param_peer_type_InputPeer' => 'Peer',
   'method_messages.getScheduledMessages_param_id_type_Vector t' => 'ID',
-  'method_messages.sendScheduledMessages' => 'Send scheduled messages',
+  'method_messages.sendScheduledMessages' => 'Send scheduled messages right away',
   'method_messages.sendScheduledMessages_param_peer_type_InputPeer' => 'Peer',
   'method_messages.sendScheduledMessages_param_id_type_Vector t' => 'ID',
   'method_messages.deleteScheduledMessages' => 'Delete scheduled messages',
@@ -10282,54 +10690,408 @@ class Lang
   'method_messages.deleteScheduledMessages_param_id_type_Vector t' => 'ID',
   'object_user_param_restriction_reason_type_Vector t' => 'Restriction reason',
   'object_channel_param_restriction_reason_type_Vector t' => 'Restriction reason',
-  'object_chatFull_param_has_scheduled_type_true' => 'Has scheduled messages?',
-  'object_channelFull_param_has_scheduled_type_true' => 'Has scheduled messages?',
-  'object_message_param_edit_hide_type_true' => 'Whether to hide that the message was edited?',
+  'object_chatFull_param_has_scheduled_type_true' => 'Whether scheduled messages are available',
+  'object_channelFull_param_has_scheduled_type_true' => 'Whether scheduled messages are available',
+  'object_message_param_edit_hide_type_true' => 'Whether the message should be shown as not modified to the user, even if an edit date is present',
   'object_message_param_restriction_reason_type_Vector t' => 'Restriction reason',
-  'object_userFull_param_has_scheduled_type_true' => 'Has scheduled messages?',
-  'object_updateNewScheduledMessage' => 'Update new scheduled message',
+  'object_userFull_param_has_scheduled_type_true' => 'Whether scheduled messages are available',
+  'object_updateNewScheduledMessage' => 'New incoming scheduled message',
   'object_updateNewScheduledMessage_param_message_type_Message' => 'Message',
-  'object_updateDeleteScheduledMessages' => 'Update delete scheduled messages',
+  'object_updateDeleteScheduledMessages' => 'Some scheduled messages were deleted',
   'object_updateDeleteScheduledMessages_param_peer_type_Peer' => 'Peer',
   'object_updateDeleteScheduledMessages_param_messages_type_Vector t' => 'Messages',
-  'object_updateTheme' => 'Update theme',
+  'object_updateTheme' => 'A cloud theme was updated',
   'object_updateTheme_param_theme_type_Theme' => 'Theme',
-  'object_inputPrivacyKeyAddedByPhone' => 'Input privacy key added by phone',
-  'object_privacyKeyAddedByPhone' => 'Privacy key added by phone',
+  'object_inputPrivacyKeyAddedByPhone' => 'Whether people can add you to their contact list by your phone number',
+  'object_privacyKeyAddedByPhone' => 'Whether people can add you to their contact list by your phone number',
   'object_webPage_param_documents_type_Vector t' => 'Documents',
-  'object_restrictionReason' => 'Restriction reason',
-  'object_restrictionReason_param_platform_type_string' => 'Platform',
-  'object_restrictionReason_param_reason_type_string' => 'Reason',
-  'object_restrictionReason_param_text_type_string' => 'Text',
-  'object_inputTheme' => 'Input theme',
+  'object_restrictionReason' => 'Restriction reason.
+
+Contains the reason why access to a certain object must be restricted. Clients are supposed to deny access to the channel if the `platform` field is equal to `all` or to the current platform (`ios`, `android`, `wp`, etc.). Platforms can be concatenated (`ios-android`, `ios-wp`), unknown platforms are to be ignored. The `text` is the error message that should be shown to the user.',
+  'object_restrictionReason_param_platform_type_string' => 'Platform identifier (ios, android, wp, all, etc.), can be concatenated with a dash as separator (`android-ios`, `ios-wp`, etc)',
+  'object_restrictionReason_param_reason_type_string' => 'Restriction reason (`porno`, `terms`, etc.)',
+  'object_restrictionReason_param_text_type_string' => 'Error message to be shown to the user',
+  'object_inputTheme' => 'Theme',
   'object_inputTheme_param_id_type_long' => 'ID',
   'object_inputTheme_param_access_hash_type_long' => 'Access hash',
-  'object_inputThemeSlug' => 'Input theme slug',
-  'object_inputThemeSlug_param_slug_type_string' => 'Slug',
-  'object_themeDocumentNotModified' => 'Theme document not modified',
+  'object_inputThemeSlug' => 'Theme by theme ID',
+  'object_inputThemeSlug_param_slug_type_string' => 'Unique theme ID',
+  'object_themeDocumentNotModified' => 'Theme background hasn\'t changed',
   'object_theme' => 'Theme',
-  'object_theme_param_creator_type_true' => 'Creator?',
-  'object_theme_param_default_type_true' => 'Default?',
-  'object_theme_param_id_type_long' => 'ID',
-  'object_theme_param_access_hash_type_long' => 'Access hash',
-  'object_theme_param_slug_type_string' => 'Slug',
-  'object_theme_param_title_type_string' => 'Title',
-  'object_theme_param_document_type_Document' => 'Document',
-  'object_theme_param_installs_count_type_int' => 'Installs count',
-  'object_account.themesNotModified' => 'Themes not modified',
-  'object_account.themes' => 'Themes',
-  'object_account.themes_param_hash_type_int' => 'Hash',
+  'object_theme_param_creator_type_true' => 'Whether the current user is the creator of this theme',
+  'object_theme_param_default_type_true' => 'Whether this is the default theme',
+  'object_theme_param_id_type_long' => 'Theme ID',
+  'object_theme_param_access_hash_type_long' => 'Theme access hash',
+  'object_theme_param_slug_type_string' => 'Unique theme ID',
+  'object_theme_param_title_type_string' => 'Theme name',
+  'object_theme_param_document_type_Document' => 'Theme',
+  'object_theme_param_installs_count_type_int' => 'Installation count',
+  'object_account.themesNotModified' => 'No new themes were installed',
+  'object_account.themes' => 'Installed themes',
+  'object_account.themes_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
   'object_account.themes_param_themes_type_Vector t' => 'Themes',
   'method_account.installTheme_param_dark_type_true' => 'Whether to install the dark version',
   'method_account.getThemes' => 'Get installed themes',
-  'method_account.saveTheme' => 'Save theme',
-  'object_inputBotInlineResult_param_send_message_type_InputBotInlineMessage' => '',
-  'object_inputBotInlineResultPhoto_param_send_message_type_InputBotInlineMessage' => '',
-  'object_inputBotInlineResultDocument_param_send_message_type_InputBotInlineMessage' => '',
-  'object_inputBotInlineResultGame_param_send_message_type_InputBotInlineMessage' => '',
-  'object_botInlineResult_param_send_message_type_BotInlineMessage' => '',
-  'object_botInlineMediaResult_param_send_message_type_BotInlineMessage' => '',
-  'object_chatBannedRights_param_send_messages_type_true' => '',
+  'method_account.saveTheme' => 'Save a theme',
+  'object_inputBotInlineResult_param_send_message_type_InputBotInlineMessage' => 'Message to send when the result is selected',
+  'object_inputBotInlineResultPhoto_param_send_message_type_InputBotInlineMessage' => 'Message to send when the result is selected',
+  'object_inputBotInlineResultDocument_param_send_message_type_InputBotInlineMessage' => 'Message to send when the result is selected',
+  'object_inputBotInlineResultGame_param_send_message_type_InputBotInlineMessage' => 'Message to send when the result is selected',
+  'object_botInlineResult_param_send_message_type_BotInlineMessage' => 'Message to send',
+  'object_botInlineMediaResult_param_send_message_type_BotInlineMessage' => 'Depending on the `type` and on the [constructor](../types/BotInlineMessage.md), contains the caption of the media or the content of the message to be sent **instead** of the media',
+  'object_chatBannedRights_param_send_messages_type_true' => 'If set, does not allow a user to send messages in a [supergroup/chat](https://core.telegram.org/api/channel)',
+  'object_updateStickerSetsOrder_param_order_type_Vector long' => 'New sticker order by sticker ID',
+  'object_pageBlockList_param_items_type_Vector PageListItem' => 'List of blocks in an IV page',
+  'object_topPeerCategoryPeers_param_peers_type_Vector TopPeer' => 'Peers',
+  'object_stickerPack_param_documents_type_Vector long' => 'Stickers',
+  'object_updateDeleteChannelMessages_param_messages_type_Vector int' => 'IDs of messages that were deleted',
+  'object_photos.photos_param_photos_type_Vector Photo' => 'List of photos',
+  'object_photos.photos_param_users_type_Vector User' => 'List of mentioned users',
+  'object_updatePeerLocated_param_peers_type_Vector PeerLocated' => 'Geolocated peer list update',
+  'object_messages.savedGifs_param_gifs_type_Vector Document' => 'List of saved gifs',
+  'object_pageBlockRelatedArticles_param_articles_type_Vector PageRelatedArticle' => 'Related articles',
+  'object_inputSingleMedia_param_random_id_type_long' => 'Unique client media ID required to prevent message resending',
+  'object_inputSingleMedia_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for styled text',
+  'object_updatePinnedDialogs_param_order_type_Vector DialogPeer' => 'New order of pinned dialogs',
+  'object_messages.chatsSlice_param_chats_type_Vector Chat' => 'Chats',
+  'object_messages.stickerSetInstallResultArchive_param_sets_type_Vector StickerSetCovered' => 'Archived stickersets',
+  'object_upload.fileCdnRedirect_param_file_hashes_type_Vector FileHash' => 'File hashes (see [CDN files](https://core.telegram.org/cdn)',
+  'object_help.deepLinkInfo_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+  'object_inputPrivacyValueDisallowChatParticipants_param_chats_type_Vector int' => 'Disallowed chat IDs',
+  'object_updateServiceNotification_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+  'object_pageListOrderedItemBlocks_param_blocks_type_Vector PageBlock' => 'Item contents',
+  'object_channels.adminLogResults_param_events_type_Vector ChannelAdminLogEvent' => 'Admin log events',
+  'object_channels.adminLogResults_param_chats_type_Vector Chat' => 'Chats mentioned in events',
+  'object_channels.adminLogResults_param_users_type_Vector User' => 'Users mentioned in events',
+  'object_messages.channelMessages_param_messages_type_Vector Message' => 'Found messages',
+  'object_messages.channelMessages_param_chats_type_Vector Chat' => 'Chats',
+  'object_messages.channelMessages_param_users_type_Vector User' => 'Users',
+  'object_message_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for styled text',
+  'object_message_param_restriction_reason_type_Vector RestrictionReason' => 'Contains the reason why access to this message must be restricted.',
+  'object_messages.favedStickers_param_packs_type_Vector StickerPack' => 'Emojis associated to stickers',
+  'object_messages.favedStickers_param_stickers_type_Vector Document' => 'Favorited stickers',
+  'object_messages.foundStickerSets_param_sets_type_Vector StickerSetCovered' => 'Found stickersets',
+  'object_account.authorizationForm_param_required_types_type_Vector SecureRequiredType' => 'Required [Telegram Passport](https://core.telegram.org/passport) documents',
+  'object_account.authorizationForm_param_values_type_Vector SecureValue' => 'Already submitted [Telegram Passport](https://core.telegram.org/passport) documents',
+  'object_account.authorizationForm_param_errors_type_Vector SecureValueError' => '[Telegram Passport](https://core.telegram.org/passport) errors',
+  'object_account.authorizationForm_param_users_type_Vector User' => 'Info about the bot to which the form will be submitted',
+  'object_messageActionChatAddUser_param_users_type_Vector int' => 'Users that were invited to the chat',
+  'object_shippingOption_param_prices_type_Vector LabeledPrice' => 'List of price portions',
+  'object_inputBotInlineMessageMediaAuto_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+  'object_photos.photosSlice_param_photos_type_Vector Photo' => 'List of photos',
+  'object_photos.photosSlice_param_users_type_Vector User' => 'List of mentioned users',
+  'object_pageBlockCollage_param_items_type_Vector PageBlock' => 'Media elements',
+  'object_updatesCombined_param_updates_type_Vector Update' => 'List of updates',
+  'object_updatesCombined_param_users_type_Vector User' => 'List of users mentioned in updates',
+  'object_updatesCombined_param_chats_type_Vector Chat' => 'List of chats mentioned in updates',
+  'object_pageBlockOrderedList_param_items_type_Vector PageListOrderedItem' => 'List items',
+  'object_privacyValueAllowChatParticipants_param_chats_type_Vector int' => 'Allowed chats',
+  'object_emojiKeyword_param_emoticons_type_Vector string' => 'Emojis associated to keyword',
+  'object_botInlineMessageMediaAuto_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+  'object_messageReactions' => 'Message reactions',
+  'object_messageReactions_param_min_type_true' => 'Similar to [min](https://core.telegram.org/api/min) objects, used for message reaction constructors that are the same for all users so they don\'t have the reactions sent by the current user (you can use [messages.getMessagesReactions](../methods/messages.getMessagesReactions.md) to get the full reaction info).',
+  'object_messageReactions_param_results_type_Vector ReactionCount' => 'Reactions',
+  'object_decryptedMessageMediaDocument_param_attributes_type_Vector DocumentAttribute' => 'Document attributes for media types',
+  'object_messageActionSecureValuesSent_param_types_type_Vector SecureValueType' => 'Secure value types',
+  'object_pollResults_param_results_type_Vector PollAnswerVoters' => 'Poll results',
+  'object_messages.stickers_param_stickers_type_Vector Document' => 'Stickers',
+  'object_photo_param_sizes_type_Vector PhotoSize' => 'Available sizes for download',
+  'object_inputPrivacyValueAllowChatParticipants_param_chats_type_Vector int' => 'Allowed chat IDs',
+  'object_contacts.found_param_my_results_type_Vector Peer' => 'Personalized results',
+  'object_contacts.found_param_results_type_Vector Peer' => 'List of found user identifiers',
+  'object_contacts.found_param_chats_type_Vector Chat' => 'Found chats',
+  'object_contacts.found_param_users_type_Vector User' => 'List of users',
+  'object_chatInvite_param_participants_type_Vector User' => 'A few of the participants that are in the group',
+  'object_messages.dialogs_param_dialogs_type_Vector Dialog' => 'List of chats',
+  'object_messages.dialogs_param_messages_type_Vector Message' => 'List of last messages from each chat',
+  'object_messages.dialogs_param_chats_type_Vector Chat' => 'List of groups mentioned in the chats',
+  'object_messages.dialogs_param_users_type_Vector User' => 'List of users mentioned in messages and groups',
+  'object_textConcat_param_texts_type_Vector RichText' => 'Concatenated rich texts',
+  'object_messages.allStickers_param_sets_type_Vector StickerSet' => 'All stickersets',
+  'object_phone.phoneCall_param_users_type_Vector User' => 'VoIP phone call participants',
+  'object_updatePrivacy_param_rules_type_Vector PrivacyRule' => 'New privacy rules',
+  'object_channelMessagesFilter_param_ranges_type_Vector MessageRange' => 'A range of messages to fetch',
+  'object_updateShortMessage_param_entities_type_Vector MessageEntity' => '[Entities](https://core.telegram.org/api/entities) for styled text',
+  'object_pageListItemBlocks_param_blocks_type_Vector PageBlock' => 'Blocks',
+  'object_inputWebDocument_param_attributes_type_Vector DocumentAttribute' => 'Attributes for media types',
+  'object_inputMediaUploadedPhoto_param_stickers_type_Vector InputDocument' => 'Attached mask stickers',
+  'object_contacts.topPeers_param_categories_type_Vector TopPeerCategoryPeers' => 'Top peers by top peer category',
+  'object_contacts.topPeers_param_chats_type_Vector Chat' => 'Chats',
+  'object_contacts.topPeers_param_users_type_Vector User' => 'Users',
+  'object_user_param_restriction_reason_type_Vector RestrictionReason' => 'Contains the reason why access to this user must be restricted.',
+  'object_messages.botResults_param_results_type_Vector BotInlineResult' => 'The results',
+  'object_messages.botResults_param_users_type_Vector User' => 'Users mentioned in the results',
+  'object_pageBlockDetails_param_blocks_type_Vector PageBlock' => 'Block contents',
+  'object_inputPrivacyValueAllowUsers_param_users_type_Vector InputUser' => 'Allowed users',
+  'object_messages.chatFull_param_chats_type_Vector Chat' => 'List containing basic info on chat',
+  'object_messages.chatFull_param_users_type_Vector User' => 'List of users mentioned above',
+  'object_privacyValueDisallowChatParticipants_param_chats_type_Vector int' => 'Disallowed chats',
+  'object_replyInlineMarkup_param_rows_type_Vector KeyboardButtonRow' => 'Bot or inline keyboard rows',
+  'object_updates.differenceSlice_param_new_messages_type_Vector Message' => 'List of new messgaes',
+  'object_updates.differenceSlice_param_new_encrypted_messages_type_Vector EncryptedMessage' => 'New messages from the [encrypted event sequence](https://core.telegram.org/api/updates)',
+  'object_updates.differenceSlice_param_other_updates_type_Vector Update' => 'List of updates',
+  'object_updates.differenceSlice_param_chats_type_Vector Chat' => 'List of chats mentioned in events',
+  'object_updates.differenceSlice_param_users_type_Vector User' => 'List of users mentioned in events',
+  'object_channelFull_param_bot_info_type_Vector BotInfo' => 'Info about bots in the channel/supergrup',
+  'object_messages.foundGifs_param_results_type_Vector FoundGif' => 'Found GIFs',
+  'object_messageUserReaction' => 'Message reaction',
+  'object_messageUserReaction_param_user_id_type_int' => 'ID of user that reacted this way',
+  'object_messageUserReaction_param_reaction_type_string' => 'Reaction (UTF8 emoji)',
+  'object_updates.channelDifference_param_new_messages_type_Vector Message' => 'New messages',
+  'object_updates.channelDifference_param_other_updates_type_Vector Update' => 'Other updates',
+  'object_updates.channelDifference_param_chats_type_Vector Chat' => 'Chats',
+  'object_updates.channelDifference_param_users_type_Vector User' => 'Users',
+  'object_decryptedMessageActionDeleteMessages_param_random_ids_type_Vector long' => 'List of deleted message IDs',
+  'object_jsonObject_param_value_type_Vector JSONObjectValue' => 'Values',
+  'object_photos.photo_param_users_type_Vector User' => 'Users',
+  'object_account.webAuthorizations_param_authorizations_type_Vector WebAuthorization' => 'Web authorization list',
+  'object_account.webAuthorizations_param_users_type_Vector User' => 'Users',
+  'object_account.wallPapers_param_wallpapers_type_Vector WallPaper' => 'Wallpapers',
+  'object_inputBotInlineMessageText_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+  'object_invoice_param_prices_type_Vector LabeledPrice' => 'Price breakdown, a list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.)',
+  'object_replyKeyboardMarkup_param_rows_type_Vector KeyboardButtonRow' => 'Button row',
+  'object_payments.paymentForm_param_users_type_Vector User' => 'Users',
+  'object_contacts.resolvedPeer_param_chats_type_Vector Chat' => 'Chats',
+  'object_contacts.resolvedPeer_param_users_type_Vector User' => 'Users',
+  'object_config_param_dc_options_type_Vector DcOption' => 'DC IP list',
+  'object_contacts.importedContacts_param_imported_type_Vector ImportedContact' => 'List of succesfully imported contacts',
+  'object_contacts.importedContacts_param_popular_invites_type_Vector PopularContact' => 'Popular contacts',
+  'object_contacts.importedContacts_param_retry_contacts_type_Vector long' => 'List of contact ids that could not be imported due to system limitation and will need to be imported at a later date.
Parameter added in [Layer 13](https://core.telegram.org/api/layers#layer-13)',
+  'object_contacts.importedContacts_param_users_type_Vector User' => 'List of users',
+  'object_inputMediaUploadedDocument_param_attributes_type_Vector DocumentAttribute' => 'Attributes that specify the type of the document (video, audio, voice, sticker, etc.)',
+  'object_inputMediaUploadedDocument_param_stickers_type_Vector InputDocument' => 'Attached stickers',
+  'object_messages.stickerSet_param_packs_type_Vector StickerPack' => 'Emoji info for stickers',
+  'object_messages.stickerSet_param_documents_type_Vector Document' => 'Stickers in stickerset',
+  'object_contacts.contacts_param_contacts_type_Vector Contact' => 'Contact list',
+  'object_contacts.contacts_param_users_type_Vector User' => 'User list',
+  'object_pageBlockTable_param_rows_type_Vector PageTableRow' => 'Table rows',
+  'object_account.themes_param_themes_type_Vector Theme' => 'Themes',
+  'object_help.proxyDataPromo_param_chats_type_Vector Chat' => 'Chats',
+  'object_help.proxyDataPromo_param_users_type_Vector User' => 'Users',
+  'object_messages.peerDialogs_param_dialogs_type_Vector Dialog' => 'Dialog info',
+  'object_messages.peerDialogs_param_messages_type_Vector Message' => 'Messages mentioned in dialog info',
+  'object_messages.peerDialogs_param_chats_type_Vector Chat' => 'Chats',
+  'object_messages.peerDialogs_param_users_type_Vector User' => 'Users',
+  'object_updates.channelDifferenceTooLong_param_messages_type_Vector Message' => 'The latest messages',
+  'object_updates.channelDifferenceTooLong_param_chats_type_Vector Chat' => 'Chats from messages',
+  'object_updates.channelDifferenceTooLong_param_users_type_Vector User' => 'Users from messages',
+  'object_messages.recentStickers_param_packs_type_Vector StickerPack' => 'Emojis associated to stickers',
+  'object_messages.recentStickers_param_stickers_type_Vector Document' => 'Recent stickers',
+  'object_messages.recentStickers_param_dates_type_Vector int' => 'When was each sticker last used',
+  'object_inputPhotoLegacyFileLocation' => 'Legacy file location',
+  'object_inputPhotoLegacyFileLocation_param_id_type_long' => 'Photo ID',
+  'object_inputPhotoLegacyFileLocation_param_access_hash_type_long' => 'Access hash',
+  'object_inputPhotoLegacyFileLocation_param_file_reference_type_bytes' => 'File reference',
+  'object_inputPhotoLegacyFileLocation_param_volume_id_type_long' => 'Volume ID',
+  'object_inputPhotoLegacyFileLocation_param_local_id_type_int' => 'Local ID',
+  'object_inputPhotoLegacyFileLocation_param_secret_type_long' => 'Secret',
+  'object_draftMessage_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for styled text.',
+  'object_help.termsOfService_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+  'object_contacts.blocked_param_blocked_type_Vector ContactBlocked' => 'List of blocked users',
+  'object_contacts.blocked_param_users_type_Vector User' => 'List of users',
+  'object_pageBlockSlideshow_param_items_type_Vector PageBlock' => 'Slideshow items',
+  'object_keyboardButtonRow_param_buttons_type_Vector KeyboardButton' => 'Bot or inline keyboard buttons',
+  'object_updateFolderPeers_param_folder_peers_type_Vector FolderPeer' => 'New peer list',
+  'object_channels.channelParticipants_param_participants_type_Vector ChannelParticipant' => 'Participants',
+  'object_channels.channelParticipants_param_users_type_Vector User' => 'Users mentioned in participant info',
+  'object_emojiKeywordsDifference_param_keywords_type_Vector EmojiKeyword' => 'Emojis associated to keywords',
+  'object_page_param_blocks_type_Vector PageBlock' => 'Page elements (like with HTML elements, only as TL constructors)',
+  'object_page_param_photos_type_Vector Photo' => 'Photos in page',
+  'object_page_param_documents_type_Vector Document' => 'Media in page',
+  'object_webDocumentNoProxy_param_attributes_type_Vector DocumentAttribute' => 'Attributes for media types',
+  'object_messageActionSecureValuesSentMe_param_values_type_Vector SecureValue' => 'Vector with information about documents and other Telegram Passport elements that were shared with the bot',
+  'object_reactionCount' => 'Reactions',
+  'object_reactionCount_param_chosen_type_true' => 'Whether the current user sent this reaction',
+  'object_reactionCount_param_reaction_type_string' => 'Reaction (a UTF8 emoji)',
+  'object_reactionCount_param_count_type_int' => 'NUmber of users that reacted with this emoji',
+  'object_emojiKeywordDeleted_param_emoticons_type_Vector string' => 'Emojis that were associated to keyword',
+  'object_decryptedMessageService_param_random_id_type_long' => 'Random message ID, assigned by the message author.
Must be equal to the ID passed to the sending method.',
+  'object_messages.highScores_param_scores_type_Vector HighScore' => 'Highscores',
+  'object_messages.highScores_param_users_type_Vector User' => 'Users, associated to the highscores',
+  'object_stickerSetMultiCovered_param_covers_type_Vector Document' => 'Preview stickers',
+  'object_inputSecureValue_param_translation_type_Vector InputSecureFile' => 'Array of encrypted [passport](https://core.telegram.org/passport) files with translated versions of the provided documents',
+  'object_inputSecureValue_param_files_type_Vector InputSecureFile' => 'Array of encrypted [passport](https://core.telegram.org/passport) files with photos the of the documents',
+  'object_updates_param_updates_type_Vector Update' => 'List of updates',
+  'object_updates_param_users_type_Vector User' => 'List of users mentioned in updates',
+  'object_updates_param_chats_type_Vector Chat' => 'List of chats mentioned in updates',
+  'object_updateReadMessagesContents_param_messages_type_Vector int' => 'IDs of read messages',
+  'object_decryptedMessageLayer_param_random_bytes_type_bytes' => 'Set of random bytes to prevent content recognition in short encrypted messages.
Clients are required to check that there are at least 15 random bytes included in each message. Messages with less than 15 random bytes must be ignored.
Parameter moved here from [decryptedMessage](../constructors/decryptedMessage.md) in [Layer 17](https://core.telegram.org/api/layers#layer-17).',
+  'object_decryptedMessage_param_random_id_type_long' => 'Random message ID, assigned by the author of message.
Must be equal to the ID passed to sending method.',
+  'object_decryptedMessage_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for styled text (parameter added in layer 45)',
+  'object_chatFull_param_bot_info_type_Vector BotInfo' => 'Info about bots that are in this chat',
+  'object_messages.featuredStickers_param_sets_type_Vector StickerSetCovered' => 'Featured stickersets',
+  'object_messages.featuredStickers_param_unread_type_Vector long' => 'IDs of new featured stickersets',
+  'object_decryptedMessageMediaExternalDocument_param_attributes_type_Vector DocumentAttribute' => 'Attributes for media types',
+  'object_document_param_thumbs_type_Vector PhotoSize' => 'Thumbnails',
+  'object_document_param_attributes_type_Vector DocumentAttribute' => 'Attributes',
+  'object_help.appUpdate_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+  'object_updates.difference_param_new_messages_type_Vector Message' => 'List of new messages',
+  'object_updates.difference_param_new_encrypted_messages_type_Vector EncryptedMessage' => 'List of new encrypted secret chat messages',
+  'object_updates.difference_param_other_updates_type_Vector Update' => 'List of updates',
+  'object_updates.difference_param_chats_type_Vector Chat' => 'List of chats mentioned in events',
+  'object_updates.difference_param_users_type_Vector User' => 'List of users mentioned in events',
+  'object_webPage_param_documents_type_Vector Document' => 'Attached webpage documents',
+  'object_decryptedMessageActionReadMessages_param_random_ids_type_Vector long' => 'List of message IDs',
+  'object_messageActionChatCreate_param_users_type_Vector int' => 'List of group members',
+  'object_botInlineMessageText_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+  'object_account.authorizations_param_authorizations_type_Vector Authorization' => 'Logged-in sessions',
+  'object_langPackDifference_param_strings_type_Vector LangPackString' => 'Localized strings',
+  'object_updateDeleteScheduledMessages_param_messages_type_Vector int' => 'Deleted scheduled messages',
+  'object_encryptedMessage_param_random_id_type_long' => 'Random message ID, assigned by the author of message',
+  'object_encryptedMessage_param_bytes_type_bytes' => 'TL-serialising of [DecryptedMessage](../types/DecryptedMessage.md) type, encrypted with the key creatied at stage of chat initialization',
+  'object_account.privacyRules_param_rules_type_Vector PrivacyRule' => 'Privacy rules',
+  'object_account.privacyRules_param_chats_type_Vector Chat' => 'Chats to which the rules apply',
+  'object_account.privacyRules_param_users_type_Vector User' => 'Users to which the rules apply',
+  'object_phoneCall_param_connections_type_Vector PhoneConnection' => 'List of endpoints the user can connect to to exchange call data',
+  'object_secureValueErrorFiles_param_file_hash_type_Vector bytes' => 'File hash',
+  'object_chatParticipants_param_participants_type_Vector ChatParticipant' => 'List of group members',
+  'object_secureValueErrorTranslationFiles_param_file_hash_type_Vector bytes' => 'Hash',
+  'object_pageBlockEmbedPost_param_blocks_type_Vector PageBlock' => 'Post contents',
+  'object_decryptedMessageActionScreenshotMessages_param_random_ids_type_Vector long' => 'List of affected message ids (that appeared on the screenshot)',
+  'object_channel_param_restriction_reason_type_Vector RestrictionReason' => 'Contains the reason why access to this channel must be restricted.',
+  'object_updateChannelReadMessagesContents_param_messages_type_Vector int' => 'IDs of messages that were read',
+  'object_messages.chats_param_chats_type_Vector Chat' => 'List of chats',
+  'object_contacts.blockedSlice_param_blocked_type_Vector ContactBlocked' => 'List of blocked users',
+  'object_contacts.blockedSlice_param_users_type_Vector User' => 'List of users',
+  'object_encryptedMessageService_param_random_id_type_long' => 'Random message ID, assigned by the author of message',
+  'object_encryptedMessageService_param_bytes_type_bytes' => 'TL-serialising of [DecryptedMessage](../types/DecryptedMessage.md) type, encrypted with the key creatied at stage of chat initialization',
+  'object_messages.dialogsSlice_param_dialogs_type_Vector Dialog' => 'List of dialogs',
+  'object_messages.dialogsSlice_param_messages_type_Vector Message' => 'List of last messages from dialogs',
+  'object_messages.dialogsSlice_param_chats_type_Vector Chat' => 'List of chats mentioned in dialogs',
+  'object_messages.dialogsSlice_param_users_type_Vector User' => 'List of users mentioned in messages and chats',
+  'object_cdnConfig_param_public_keys_type_Vector CdnPublicKey' => 'Vector of public keys to use **only** during handshakes to [CDN](https://core.telegram.org/cdn) DCs.',
+  'object_jsonArray_param_value_type_Vector JSONValue' => 'JSON values',
+  'object_messages.messages_param_messages_type_Vector Message' => 'List of messages',
+  'object_messages.messages_param_chats_type_Vector Chat' => 'List of chats mentioned in dialogs',
+  'object_messages.messages_param_users_type_Vector User' => 'List of users mentioned in messages and chats',
+  'object_help.recentMeUrls_param_urls_type_Vector RecentMeUrl' => 'URLs',
+  'object_help.recentMeUrls_param_chats_type_Vector Chat' => 'Chats',
+  'object_help.recentMeUrls_param_users_type_Vector User' => 'Users',
+  'object_botInfo_param_commands_type_Vector BotCommand' => 'Bot commands that can be used in the chat',
+  'object_pageTableRow_param_cells_type_Vector PageTableCell' => 'Table cells',
+  'object_help.userInfo_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+  'object_inputPrivacyValueDisallowUsers_param_users_type_Vector InputUser' => 'Users to disallow',
+  'object_secureValue_param_translation_type_Vector SecureFile' => 'Array of encrypted [passport](https://core.telegram.org/passport) files with translated versions of the provided documents',
+  'object_secureValue_param_files_type_Vector SecureFile' => 'Array of encrypted [passport](https://core.telegram.org/passport) files with photos the of the documents',
+  'object_payments.validatedRequestedInfo_param_shipping_options_type_Vector ShippingOption' => 'Shipping options',
+  'object_privacyValueAllowUsers_param_users_type_Vector int' => 'Allowed users',
+  'object_webDocument_param_attributes_type_Vector DocumentAttribute' => 'Attributes for media types',
+  'object_secureRequiredTypeOneOf_param_types_type_Vector SecureRequiredType' => 'Secure required value types',
+  'object_updateShortSentMessage_param_entities_type_Vector MessageEntity' => '[Entities](https://core.telegram.org/api/entities) for styled text',
+  'object_updateShortChatMessage_param_entities_type_Vector MessageEntity' => '[Entities](https://core.telegram.org/api/entities) for styled text',
+  'object_updateMessageID_param_random_id_type_long' => 'Previuosly transferred client **random\\_id** identifier',
+  'object_messages.archivedStickers_param_sets_type_Vector StickerSetCovered' => 'Archived stickersets',
+  'object_messages.messagesSlice_param_messages_type_Vector Message' => 'List of messages',
+  'object_messages.messagesSlice_param_chats_type_Vector Chat' => 'List of chats mentioned in messages',
+  'object_messages.messagesSlice_param_users_type_Vector User' => 'List of users mentioned in messages and chats',
+  'object_privacyValueDisallowUsers_param_users_type_Vector int' => 'Disallowed users',
+  'object_updateDcOptions_param_dc_options_type_Vector DcOption' => 'New connection options',
+  'object_payments.paymentReceipt_param_users_type_Vector User' => 'Users',
+  'object_updateMessageReactions' => 'New message reactions are available',
+  'object_updateMessageReactions_param_peer_type_Peer' => 'Peer',
+  'object_updateMessageReactions_param_msg_id_type_int' => 'Message ID',
+  'object_updateMessageReactions_param_reactions_type_MessageReactions' => 'Reactions',
+  'object_channels.channelParticipant_param_users_type_Vector User' => 'Users',
+  'object_poll_param_answers_type_Vector PollAnswer' => 'The possible answers, vote using [messages.sendVote](../methods/messages.sendVote.md).',
+  'object_updateDeleteMessages_param_messages_type_Vector int' => 'List of identifiers of deleted messages',
+  'object_messageReactionsList' => 'List of message reactions',
+  'object_messageReactionsList_param_count_type_int' => 'Total number of reactions',
+  'object_messageReactionsList_param_reactions_type_Vector MessageUserReaction' => 'Reactions',
+  'object_messageReactionsList_param_users_type_Vector User' => 'Users that reacted like this',
+  'object_messageReactionsList_param_next_offset_type_string' => 'Next offset to use when fetching reactions using [messages.getMessageReactionsList](../methods/messages.getMessageReactionsList.md)',
+  'method_messages.sendEncryptedFile_param_random_id_type_long' => 'Unique client message ID necessary to prevent message resending',
+  'method_messages.sendEncryptedFile_param_data_type_bytes' => 'TL-serialization of [DecryptedMessage](../types/DecryptedMessage.md) type, encrypted with a key generated during chat initialization',
+  'method_channels.getChannels_param_id_type_Vector InputChannel' => 'IDs of channels/supergroups to get info about',
+  'method_users.getUsers_param_id_type_Vector InputUser' => 'List of user identifiers',
+  'method_channels.getMessages_param_id_type_Vector InputMessage' => 'IDs of messages to get',
+  'method_channels.readMessageContents_param_id_type_Vector int' => 'IDs of messages whose contents should be marked as read',
+  'method_channels.inviteToChannel_param_users_type_Vector InputUser' => 'Users to invite',
+  'method_messages.sendVote_param_options_type_Vector bytes' => 'The options that were chosen',
+  'method_messages.getEmojiKeywordsLanguages_param_lang_codes_type_Vector string' => 'Language codes',
+  'method_messages.sendScheduledMessages_param_id_type_Vector int' => 'Scheduled message IDs',
+  'method_help.getPassportConfig_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_langpack.getStrings_param_keys_type_Vector string' => 'Strings to get',
+  'method_account.setPrivacy_param_rules_type_Vector InputPrivacyRule' => 'New privacy rules',
+  'method_messages.sendScreenshotNotification_param_random_id_type_long' => 'Random ID to avoid message resending',
+  'method_messages.startBot_param_random_id_type_long' => 'Random ID to avoid resending the same message',
+  'method_messages.deleteChatUser_param_chat_id_type_int' => 'Chat ID',
+  'method_messages.sendMessage_param_random_id_type_long' => 'Unique client message ID required to prevent message resending',
+  'method_messages.sendMessage_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for sending styled text',
+  'method_messages.getWebPagePreview_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+  'method_account.getWallPapers_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_messages.readMessageContents_param_id_type_Vector int' => 'Message ID list',
+  'method_messages.getScheduledHistory_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_phone.requestCall_param_random_id_type_int' => 'Random ID to avoid resending the same object',
+  'method_messages.setInlineBotResults_param_results_type_Vector InputBotInlineResult' => 'Vector of results for the inline query',
+  'method_messages.sendMedia_param_random_id_type_long' => 'Random ID to avoid resending the same message',
+  'method_messages.sendMedia_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for styled text',
+  'method_messages.editMessage_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+  'method_messages.getMessagesReactions' => 'Get message reactions',
+  'method_messages.getMessagesReactions_param_peer_type_InputPeer' => 'Peer',
+  'method_messages.getMessagesReactions_param_id_type_Vector int' => 'Message IDs',
+  'method_users.setSecureValueErrors_param_errors_type_Vector SecureValueError' => 'Errors',
+  'method_contacts.getContactIDs_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_messages.getSearchCounters_param_filters_type_Vector MessagesFilter' => 'Search filters',
+  'method_contacts.deleteByPhones_param_phones_type_Vector string' => 'Phone numbers',
+  'method_messages.readFeaturedStickers_param_id_type_Vector long' => 'IDs of stickersets to mark as read',
+  'method_messages.saveDraft_param_entities_type_Vector MessageEntity' => 'Message [entities](https://core.telegram.org/api/entities) for styled text',
+  'method_account.unregisterDevice_param_other_uids_type_Vector int' => 'List of user identifiers of other users currently using the client',
+  'method_messages.report_param_id_type_Vector int' => 'IDs of messages to report',
+  'method_account.deleteSecureValue_param_types_type_Vector SecureValueType' => 'Document types to delete',
+  'method_messages.getChats_param_id_type_Vector int' => 'List of chat IDs',
+  'method_messages.reorderStickerSets_param_order_type_Vector long' => 'New stickerset order by stickerset IDs',
+  'method_messages.sendInlineBotResult_param_random_id_type_long' => 'Random ID to avoid resending the same query',
+  'method_messages.getAllChats_param_except_ids_type_Vector int' => 'Except these chats/channels/supergroups',
+  'method_messages.requestEncryption_param_random_id_type_int' => 'Unique client request ID required to prevent resending. This also doubles as the chat ID.',
+  'method_channels.reportSpam_param_id_type_Vector int' => 'IDs of spam messages',
+  'method_messages.createChat_param_users_type_Vector InputUser' => 'List of user IDs to be invited',
+  'method_account.acceptAuthorization_param_value_hashes_type_Vector SecureValueHash' => 'Types of values sent and their hashes',
+  'method_folders.editPeerFolders_param_folder_peers_type_Vector InputFolderPeer' => 'New peer list',
+  'method_messages.setBotShippingResults_param_shipping_options_type_Vector ShippingOption' => 'A vector of available shipping options.',
+  'method_messages.deleteScheduledMessages_param_id_type_Vector int' => 'Scheduled message IDs',
+  'method_messages.editChatTitle_param_chat_id_type_int' => 'Chat ID',
+  'method_account.registerDevice_param_other_uids_type_Vector int' => 'List of user identifiers of other users currently using the client',
+  'method_messages.addChatUser_param_chat_id_type_int' => 'Chat ID',
+  'method_messages.migrateChat_param_chat_id_type_int' => 'Legacy group to migrate',
+  'method_messages.sendReaction' => 'Send reaction to message',
+  'method_messages.sendReaction_param_peer_type_InputPeer' => 'Peer',
+  'method_messages.sendReaction_param_msg_id_type_int' => 'Message ID to react to',
+  'method_messages.sendReaction_param_reaction_type_string' => 'Reaction (a UTF8 emoji)',
+  'method_channels.deleteMessages_param_id_type_Vector int' => 'IDs of messages to delete',
+  'method_messages.deleteMessages_param_id_type_Vector int' => 'Message ID list',
+  'method_messages.getFullChat_param_chat_id_type_int' => 'Chat ID',
+  'method_account.getSecureValue_param_types_type_Vector SecureValueType' => 'Requested value types',
+  'method_messages.getMessagesViews_param_id_type_Vector int' => 'ID of message',
+  'method_account.getThemes_param_hash_type_int' => '[Hash for pagination, for more info click here](https://core.telegram.org/api/offsets#hash-generation)',
+  'method_messages.sendEncrypted_param_random_id_type_long' => 'Unique client message ID, necessary to avoid message resending',
+  'method_messages.sendEncrypted_param_data_type_bytes' => 'TL-serialization of [DecryptedMessage](../types/DecryptedMessage.md) type, encrypted with a key that was created during chat initialization',
+  'method_auth.dropTempAuthKeys_param_except_auth_keys_type_Vector long' => 'The auth keys that **shouldn\'t** be dropped.',
+  'method_messages.reorderPinnedDialogs_param_order_type_Vector InputDialogPeer' => 'New dialog order',
+  'method_help.saveAppLog_param_events_type_Vector InputAppEvent' => 'List of input events',
+  'method_messages.getScheduledMessages_param_id_type_Vector int' => 'IDs of scheduled messages',
+  'method_photos.deletePhotos_param_id_type_Vector InputPhoto' => 'Input photos to delete',
+  'method_messages.sendEncryptedService_param_random_id_type_long' => 'Unique client message ID required to prevent message resending',
+  'method_messages.sendEncryptedService_param_data_type_bytes' => 'TL-serialization of  [DecryptedMessage](../types/DecryptedMessage.md) type, encrypted with a key generated during chat initialization',
+  'method_messages.sendMultiMedia_param_multi_media_type_Vector InputSingleMedia' => 'The medias to send',
+  'method_contacts.importContacts_param_contacts_type_Vector InputContact' => 'List of contacts to import',
+  'method_contacts.deleteContacts_param_id_type_Vector InputUser' => 'User ID list',
+  'method_stickers.createStickerSet_param_stickers_type_Vector InputStickerSetItem' => 'Stickers',
+  'method_channels.getAdminLog_param_admins_type_Vector InputUser' => 'Only show events from these admins',
+  'method_help.editUserInfo_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+  'method_messages.editChatPhoto_param_chat_id_type_int' => 'Chat ID',
+  'method_messages.getMessages_param_id_type_Vector InputMessage' => 'Message ID list',
+  'method_messages.editInlineBotMessage_param_entities_type_Vector MessageEntity' => '[Message entities for styled text](https://core.telegram.org/api/entities)',
+  'method_messages.getPeerDialogs_param_peers_type_Vector InputDialogPeer' => 'Peers',
+  'method_messages.forwardMessages_param_id_type_Vector int' => 'IDs of messages',
+  'method_messages.forwardMessages_param_random_id_type_Vector long' => 'Random ID to prevent resending of messages',
+  'method_messages.getMessageReactionsList' => 'Get full message reaction list',
+  'method_messages.getMessageReactionsList_param_peer_type_InputPeer' => 'Peer',
+  'method_messages.getMessageReactionsList_param_id_type_int' => 'Message ID',
+  'method_messages.getMessageReactionsList_param_reaction_type_string' => 'Get only reactions of this type (UTF8 emoji)',
+  'method_messages.getMessageReactionsList_param_offset_type_string' => 'Offset (typically taken from the `next_offset` field of the returned [MessageReactionsList](../types/MessageReactionsList.md))',
+  'method_messages.getMessageReactionsList_param_limit_type_int' => 'Maximum number of results to return, [see pagination](https://core.telegram.org/api/offsets)',
+  'method_messages.editChatAdmin_param_chat_id_type_int' => 'The ID of the group',
+  'method_invokeAfterMsgs_param_msg_ids_type_Vector long' => 'List of messages on which a current query depends',
   'object_botInlineMediaResultDocument_param_send_message_type_BotInlineMessage' => '',
   'object_botInlineMediaResultPhoto_param_send_message_type_BotInlineMessage' => '',
   'object_channelBannedRights_param_send_messages_type_true' => '',
diff --git a/src/danog/MadelineProto/TON/InternalDoc.php b/src/danog/MadelineProto/TON/InternalDoc.php
index bd6343d7..8a5c3b72 100644
--- a/src/danog/MadelineProto/TON/InternalDoc.php
+++ b/src/danog/MadelineProto/TON/InternalDoc.php
@@ -874,6 +874,13 @@ class InternalDoc extends APIFactory
     {
         return $this->__call(__FUNCTION__, [$config, $extra]);
     }
+
+    public function methodCall(string $methodName, array $args = [
+    ], array $aargs = [
+    ], array $extra = [])
+    {
+        return $this->__call(__FUNCTION__, [$methodName, $args, $aargs, $extra]);
+    }
     /**
      * Asynchronously run async callable.
      *
@@ -885,4 +892,24 @@ class InternalDoc extends APIFactory
     {
         return $this->__call(__FUNCTION__, [$func, $extra]);
     }
+    /**
+     * Convert parameters.
+     *
+     * @param array $parameters Parameters
+     *
+     * @return void
+     */
+    public function botAPItoMTProto(array $parameters, array $extra = [])
+    {
+        return $this->__call(__FUNCTION__, [$parameters, $extra]);
+    }
+    /**
+     * Get TL method namespaces.
+     *
+     * @return void
+     */
+    public function getMethodNamespaces(array $extra = [])
+    {
+        return $this->__call(__FUNCTION__, [$extra]);
+    }
 }
diff --git a/tools/build_docs.php b/tools/build_docs.php
index d899a8e9..949cfc16 100755
--- a/tools/build_docs.php
+++ b/tools/build_docs.php
@@ -14,9 +14,9 @@
 use danog\MadelineProto\API;
 use danog\MadelineProto\APIFactory;
 use danog\MadelineProto\MTProto;
-use danog\MadelineProto\TON\ADNL;
 use danog\MadelineProto\TON\API as TONAPI;
 use danog\MadelineProto\TON\APIFactory as TONAPIFactory;
+use danog\MadelineProto\TON\Lite;
 
 \chdir($d=__DIR__.'/..');
 
@@ -113,7 +113,7 @@ $doc = new \danog\MadelineProto\AnnotationsBuilder(
     [
         'API' => TONAPI::class,
         'APIFactory' => TONAPIFactory::class,
-        'MTProto' => ADNL::class
+        'MTProto' => Lite::class
     ],
     'danog\\MadelineProto\\TON'
 );
diff --git a/tools/merge.php b/tools/merge.php
new file mode 100644
index 00000000..1084cf17
--- /dev/null
+++ b/tools/merge.php
@@ -0,0 +1,16 @@
+ $value) {
+    $key = \preg_replace(['|flags\.\d+[?]|', '|[<]|', '|[>]|'], ['', ' ', ''], $key);
+    Lang::$lang['en'][$key] = $value;
+}
+foreach (Lang::$lang['en'] as $key => $value) {
+    if ($value === '') {
+        unset(Lang::$lang['en'][$key]);
+    }
+}
+DocsBuilder::addToLang($key, $value, true);
diff --git a/tools/translator.php b/tools/translator.php
index 766710cb..59768854 100644
--- a/tools/translator.php
+++ b/tools/translator.php
@@ -54,6 +54,7 @@ foreach (\danog\MadelineProto\Lang::$current_lang as $key => $value) {
     if (!isset(\danog\MadelineProto\Lang::$lang[$lang_code][$key])) {
         \danog\MadelineProto\Lang::$lang[$lang_code][$key] = $value;
     }
+
     if (\danog\MadelineProto\Lang::$lang[$lang_code][$key] === $value && (
         $lang_code !== 'en' || $value == '' ||
         \strpos($value, 'You cannot use this method directly') === 0 ||
@@ -66,7 +67,7 @@ foreach (\danog\MadelineProto\Lang::$current_lang as $key => $value) {
         }
         if ($value == '') {
             $value = $key;
-        }
+        }/*
         \preg_match('/^[^_]+_(.*?)(?:_param_(.*)_type_(.*))?$/', $key, $matches);
         $method_name = isset($matches[1]) ? $matches[1] : '';
         $param_name = isset($matches[2]) ? $matches[2] : '';
@@ -109,7 +110,7 @@ foreach (\danog\MadelineProto\Lang::$current_lang as $key => $value) {
                 \danog\MadelineProto\Lang::$lang[$lang_code][$key] = $l;
                 echo 'Using default value '.\danog\MadelineProto\Lang::$lang[$lang_code][$key].PHP_EOL;
             }
-        }
+        }*/
         \danog\MadelineProto\Lang::$lang[$lang_code][$key] = \ucfirst(\danog\MadelineProto\Lang::$lang[$lang_code][$key]);
         if (\in_array($key, ['v_error', 'v_tgerror'])) {
             \danog\MadelineProto\Lang::$lang[$lang_code][$key] = \bin2hex(\danog\MadelineProto\Lang::$lang[$lang_code][$key]);