ton-community · klpx · Sep 1, 2025 · Sep 2, 2025
@@ -9,5 +9,6 @@ module.exports = {
     'remark-lint-rule-style',
     'remark-gfm',
     ['remark-lint-unordered-list-marker-style', '-'],
+    'remark-lint-docusaurus-empty-lines-around-admonition-content'
   ],
 };
@@ -89,7 +89,9 @@ When the wallet smart contract receives the message, it processes it and deliver
 We can represent the sequence of transactions as a chain. In this representation, each smart contract has its transactions, which means that each contract has its blockchain, so the network can process the transactions independently.
 
 :::info
+
 Read more in [Blockchain of blockchain](/v3/concepts/dive-into-ton/ton-blockchain/blockchain-of-blockchains).
+
 :::
 
 ### Gas
@@ -126,7 +128,9 @@ In TON, the calculation of transaction fees is complex. It includes several type
 The price of gas and some other parameters can be changed by voting on the main network. Unlike Ethereum, TON users cannot set the gas price themselves. Also, the developer needs to return the remaining gas funds to the owner manually, otherwise they will remain locked. Smart contract storage also affects the price: if a wallet's smart contract remains unused for a long time, the next transaction will incur higher costs.
 
 :::info
+
 Read more about [gas](/v3/documentation/smart-contracts/transaction-fees/fees).
+
 :::
 
 ### Architecture

@@ -16,7 +16,9 @@ Each account consists of:
 - **Code** — the logic that determines how the account reacts to incoming messages and generates outgoing ones. This defines the account’s behavior on the blockchain.
 
 :::note
+
 Accounts that include both **code** and **data**, in addition to their properties, are considered **smart contracts** on the blockchain.
+
 :::
 
 

@@ -37,7 +37,9 @@ The exotic types are the following:
 - Merkle update cell
 
 :::tip
+
 See [**Exotic cells**](https://ton.org/tvm.pdf).
+
 :::
 
 ## Cell flavors

@@ -137,8 +137,10 @@ Below is a selection of prominent non-custodial software wallets.
 </table>
 
 :::warning
+
 [TONDevWallet](https://github.com/TonDevWallet/TonDevWallet) is for development and testing only.
 Do **NOT** use it to store real funds — it is **insecure** and does **NOT** provide adequate protection.
+
 :::
 
 

@@ -1,7 +1,9 @@
 # How to contribute
 
 :::info
+
 Learn how to submit content to TON documentation here.
+
 :::
 
 ## Contribute rules
@@ -17,7 +19,9 @@ We aim to educate users about TON through explicit, easily searchable content th
 ### How to contribute
 
 :::info
+
 This documentation is written in English. Please refer to [localization program](/v3/contribute/localization-program/how-to-contribute/) for other languages.
+
 :::
 
 1. Clone a current version from the [ton-docs](https://github.com/ton-community/ton-docs) GitHub repository.
@@ -46,7 +50,9 @@ Closes [link to issue].
 4. Before submitting your pull request, complete and verify each milestone in the description checklist.
 
 :::info
+
 To avoid excessive rework, read the contribution guidelines in the [Style guide](/v3/contribute/style-guide/), [Content standardization](/v3/contribute/content-standardization/), and [Typography](/v3/contribute/typography/) before contributing. Don't worry about minor issues; maintainers will help you fix them during the review process.
+
 :::
 
 ### Development

@@ -3,8 +3,10 @@ import Feedback from '@site/src/components/Feedback';
 # Contribution Guidelines
 
 :::danger
+
 This page is outdated and will be deleted soon.
 See the [How to contribute](/v3/contribute/).
+
 :::
 
 Before contributing any docs.ton.org page, please review the following list of general and important requirements to guarantee a smooth experience.
@@ -15,11 +17,13 @@ Before contributing any docs.ton.org page, please review the following list of g
 - We write _TON_ with regular nouns, and if it requires _THE_ according to English grammar, we use it. For instance: "_The_ TON Connect _protocol_ is a..."
 
 :::info
+
 TON Blockchain...
 
 TON Ecosystem...
 
 The TON Connect protocol...
+
 :::
 
 Please refer to the actual TON brand assets [here](https://ton.org/en/brand-assets).

@@ -3,8 +3,10 @@ import Feedback from '@site/src/components/Feedback';
 # Common Documentation Principals
 
 :::danger
+
 This page is outdated and will be deleted soon.
 See the [How to contribute](/v3/contribute/).
+
 :::
 
 For optimal user experience and clarity, please keep in mind the list of general and important requirements that we aim to apply to all documentation on docs.ton.org while creating new content.

@@ -6,8 +6,10 @@ import ThemedImage from '@theme/ThemedImage';
 # Graphic Explanations Guidelines
 
 :::danger
+
 This page is outdated and will be deleted soon.
 See the [How to contribute](/v3/contribute/).
+
 :::
 
 Maintaining consistency in documentation is crucial, and to achieve this, a specific standard for visualizing processes in smart contracts has been developed.

@@ -14,7 +14,9 @@ Within this system, we integrate several applications to function seamlessly as
 - **Customized Glossary**: This glossary guides translators and ensures AI generates accurate translations based on the project’s context. Users can also upload their glossaries as needed.
 
 :::info
+
 This guide won't cover the entire process but will highlight the key components that make the TownSquare Labs Localization Program unique. You can explore the program further on your own.
+
 :::
 
 ## GitHub synchronization for documentation and translations

@@ -15,7 +15,9 @@ Localization contribution is open to everyone. Here are a few steps you need to
 5. Preview all translation results on the website after proofreading.
 
 :::info
+
 Before contributing, read the guidelines below to ensure standardization and quality, speeding up the review process.
+
 :::
 
 ## Side-by-side mode
@@ -82,9 +84,11 @@ Click on a file to enter the editing interface.
 ![proofread approved](/img/localizationProgramGuideline/proofread-approved.png)
 
 :::info
+
 You can also review the approved lines:
   1. Filter by **Approved**.
   2. If an approved line has issues, click the ☑️ button to revert it to needing proofreading.
+
 :::
 
 3. To move to the following file, click the file name at the top, select the new file from the pop-up window, and continue proofreading.

@@ -64,7 +64,9 @@ Some strings contain titles of external articles. Most of our developer document
 Crowdin has a built-in feature that warns translators when they are about to make a mistake. Crowdin will automatically alert you before saving your translation if you forget to include a tag from the source, translate elements that should not be translated, add several consecutive spaces, forget end punctuation, etc. If you see a warning like this, please double-check the suggested translation.
 
 :::warning
+
 Never ignore these warnings, as they usually mean something is wrong or the translation lacks a key part of the source text.
+
 :::
 
 ## Short vs. complete forms and abbreviations

@@ -4,14 +4,18 @@ import Feedback from '@site/src/components/Feedback';
 # Contribution Guide
 
 :::danger
+
 This page is outdated and will be deleted soon.
 See the [How to contribute](/v3/contribute/).
+
 :::
 
 Here is a step-by-step guide of contributing to TON Documentation with Tutorials.
 
 :::tip opportunity
+
 You're lucky! It's a good opportunity to improve TON Ecosystem here.
+
 :::
 
 If you decide to write tutorial, you can get some reward for outstanding materials:

@@ -142,7 +142,9 @@ TON Documentation aims to serve as a credible, neutral source of truth that info
     - Example: _"This political party is better for decentralization because..."_
 
 :::warning
+
 Any proposed content that does not align with the platform's objectives will be rejected without additional explanation. Spam and inappropriate behavior in comments will result in a ban.
+
 :::
 
 ### Consistency

@@ -3,8 +3,10 @@ import Feedback from '@site/src/components/Feedback';
 # Tutorial Styling Guidelines
 
 :::danger
+
 This page is outdated and will be updated soon.
 See the [How to contribute](/v3/contribute/).
+
 :::
 
 So you've decided to write a tutorial for TON Documentation?
@@ -16,7 +18,9 @@ It is important that you take some time to become familiar with the tutorial str
 ## Process
 
 :::info IMPORTANT
+
 Before you start writing, *read the guidelines below*! They will help you ensure the level of standardization and quality that will make the review process much faster.
+
 :::
 
 Also, be sure to refer to the [**sample tutorial structure**](/v3/contribute/tutorials/sample-tutorial) we have provided.
@@ -65,7 +69,9 @@ Regarding other word combinations like "TON + noun" (e.g., "the TON world," "the
 ## How to structure your tutorial
 
 :::info Sample tutorial structure
+
 Feel free to check out the [sample tutorial structure](/v3/contribute/tutorials/sample-tutorial) to see it with your own eyes.
+
 :::
 
 - The **Title** should be direct and clear, summarizing the tutorial's goal. Do not add the tutorial title as a heading inside the document; instead, use the markdown document filename. 

@@ -3,8 +3,10 @@ import Feedback from '@site/src/components/Feedback';
 # Principles of a good tutorial
 
 :::danger
+
 This page is outdated and will be updated soon.
 See the [How to contribute](/v3/contribute/).
+
 :::
 
 Original comment with these principles by [talkol](https://github.com/talkol):

@@ -3,8 +3,10 @@ import Feedback from '@site/src/components/Feedback';
 # Sample tutorial structure
 
 :::danger
+
 This page is outdated and will be updated soon.
 See the [How to contribute](/v3/contribute/).
+
 :::
 
 ## Introduction

@@ -122,7 +122,9 @@ The navigation menus should remain minimalistic in both the left sidebar and the
 - Use short, clear labels of two or three words.
 
 :::info
+
 Specify the left side menu with [sidebars](https://github.com/ton-community/ton-docs/tree/main/sidebars) configuration files.
+
 :::
 
 #### Navigation bar menu:
@@ -131,7 +133,9 @@ Specify the left side menu with [sidebars](https://github.com/ton-community/ton-
 - Use broad, descriptive terms to categorize content, ensuring users can quickly identify the main section they need.
 
 :::info
+
 Specify the navigation bar menu with the [navbar.js](https://github.com/ton-community/ton-docs/blob/main/navbar.js) configuration file.
+
 :::
 
 #### Consistency between menu and in-page headers

@@ -38,7 +38,9 @@ To motivate the community to contribute to open source projects in the TON Ecosy
 </div>
 
 :::info IMPORTANT!
+
 TON Foundation will mint a collection in November to all wallet addresses submitted to the [@toncontests_bot](https://t.me/toncontests_bot). It will happen after the calculation and validation of all contribution results.
+
 :::
 
 You have plenty of time to participate in the event. Let's build decentralized Internet of the future with thousands of contributors from all over the world!

@@ -3,7 +3,9 @@ import Feedback from '@site/src/components/Feedback';
 # TON mining guide
 
 :::warning deprecated
+
 This information may be outdated and no longer relevant. You can skip it.
+
 :::
 
 

@@ -3,7 +3,9 @@ import Feedback from '@site/src/components/Feedback';
 # POW Givers
 
 :::warning deprecated
+
 This information may be outdated and no longer relevant. You can skip it.
+
 :::
 
 The aim of this text is to describe how to interact with Proof-of-Work Giver smart contracts to obtain Toncoin. We assume familiarity with TON Blockchain Lite Client as explained in `Getting Started`, and with the procedure required to compile the Lite Client and other software. For obtaining the larger amount of Toncoin required for running a validator, we also assume acquaintance with the `Full Node` and `Validator` pages. You will also need a dedicated server powerful enough for running a Full Node in order to obtain the larger amount of Toncoin. Obtaining small amounts of Toncoin does not require a dedicated server and may be done in several minutes on a home computer.
@@ -120,7 +122,9 @@ Then you can use the Lite Client to send an external message from file `mined.bo
 You can wait for several seconds and check the state of your wallet:
 
 :::info
+
 Please note here and further that the code, comments, and/or documentation may contain parameters, methods, and definitions such as “gram”, “nanogram”, etc. That is a legacy of the original TON code, developed by the Telegram. Gram cryptocurrency was never issued. The currency of TON is Toncoin and the currency of the TON testnet is Test Toncoin.
+
 :::
 
 ```

@@ -7,7 +7,9 @@ import Button from '@site/src/components/button'
 # Precompiled binaries
 
 :::caution important
+
 You no longer need to manually install binaries with Blueprint SDK.
+
 :::
 
 All binaries for development and testing are provided with the Blueprint SDK.
@@ -85,7 +87,9 @@ padding: '0.2rem',
        4. In the "_Variable value_" field, specify the path to the files: **`/%USERNAME%/ton/lib/fiftlib`** and click <Highlight color="#1877F2">OK</Highlight>. Done.
 
 :::caution important
+
 Instead of the `%USERNAME%` keyword, you must insert your own `username`.
+
 :::
 
   </TabItem>
@@ -122,7 +126,9 @@ Instead of the `%USERNAME%` keyword, you must insert your own `username`.
     ```
 
 :::info Hey, you're almost finished :)
+
 Remember to set the [environment variable](https://stackoverflow.com/questions/14637979/how-to-permanently-set-path-on-linux-unix) `FIFTPATH` to point to this directory.
+
 :::
 
   </TabItem>

@@ -5,7 +5,9 @@ import Button from '@site/src/components/button'
 # TON Connect for Telegram Bots - Python
 
 :::warning deprecated
+
 This guide explains an outdated method of integrating TON Connect with Telegram bots. For a more secure and modern approach, consider using [Telegram Mini Apps](/v3/guidelines/dapps/tma/overview for a more modern and secure integration.
+
 :::
 
 In this tutorial, we’ll create a sample telegram bot that supports TON Connect 2.0 authentication using Python TON Connect SDK [pytonconnect](https://github.com/XaBbl4/pytonconnect).

@@ -5,7 +5,9 @@ import Button from '@site/src/components/button'
 # TON Connect for Telegram Bots
 
 :::warning deprecated
+
 This guide explains an outdated method of integrating TON Connect with Telegram bots. For a more secure and modern approach, consider using [Telegram Mini Apps](/v3/guidelines/dapps/tma/overview) for a more modern and secure integration.
+
 :::
 
 In this tutorial, we will develop a sample Telegram bot using the JavaScript TON Connect SDK, supporting TON Connect 2.0 authentication.

@@ -38,7 +38,9 @@ The execution model of the proposed royalty-enforcing solution includes both on-
 - Off-chain metadata includes pack configuration and sale logic: number of items per pack, royalty rules, and mutable fields (e.g., `royalty_violation`).
 
 :::info Mint API
+
 Refer to the [Mint Platform API](https://api.getgems.io/mint-platform/docs) for detailed integration information and endpoints.
+
 :::
 
 **2. NFT store integration:** NFT stores integrate solely through the mint API and do not interact with smart contracts directly.
@@ -234,9 +236,9 @@ This diagram illustrates the end-to-end data flow of NFT 2.0 item distribution t
 
 ## See also
 
-* [NFT standard: TEP-62](https://github.com/ton-blockchain/TEPs/blob/master/text/0062-nft-standard.md)
-* [NFT royalty standard extension: TEP-66](https://github.com/ton-blockchain/TEPs/blob/master/text/0066-nft-royalty-standard.md)
-* [NFT processing](/v3/guidelines/dapps/asset-processing/nft-processing/nfts)
+- [NFT standard: TEP-62](https://github.com/ton-blockchain/TEPs/blob/master/text/0062-nft-standard.md)
+- [NFT royalty standard extension: TEP-66](https://github.com/ton-blockchain/TEPs/blob/master/text/0066-nft-royalty-standard.md)
+- [NFT processing](/v3/guidelines/dapps/asset-processing/nft-processing/nfts)
 
 
 <Feedback/>
-Original file line number
+Diff line change
@@ Expand Up / @@ -16,7 +16,9 @@ Each account consists of: @@
     - **Code** — the logic that determines how the account reacts to incoming messages and generates outgoing ones. This defines the account’s behavior on the blockchain.
     :::note
     Accounts that include both **code** and **data**, in addition to their properties, are considered **smart contracts** on the blockchain.
     :::
@@ Expand Down @@