Updating and Improving TON Documentation for Developers

Updating and Improving TON Documentation for Developers

The TON Documentation has received a major update and improvement, focusing on making it easier for developers to access and navigate. This renewal comes as a result of feedback from users who expressed that the previous documentation was scattered, inconsistent and difficult to navigate. Starting in late July, the TON Studio team committed to completely rebuilding the documentation from scratch, seeking to create a more accessible and useful resource for everyone interested in the TON blockchain.

What Changed in TON’s Documentation

One of the main modifications is the restructuring of the content, which now presents a flat structure, eliminating the nested menus that complicated the search for information. The new homepage directs users according to their needs: explore TON, build contracts, integrate wallets, or solve common problems with the community. Here are some of the new and improved sections in this update:

• Guides to mytonctrl and mylocalton.
• Development configuration (Sandbox and Blueprint, with important collaboration from TonTech).
• IDEs and SDKs.
• Analytics, oracles and bridges.
• TON Connect for dApps and wallet services.
• Standard contracts across the ecosystem, including wallets, Jettons, and NFTs.
• Smart Contract Development Guides: Common Patterns, Gas, and Security Best Practices.
• TVM instructions with improved search and better user experience.
• TL-B schemes.
• Documentation of languages such as Tolk, FunC and Tact: with a special review for FunC.
• Guide for developers coming from Ethereum.

Dr. Nikolai Durov’s original papers are now available in a web format, with cross-links and abstracts generated by artificial intelligence, improving the accessibility of information. In addition, the documentation includes Mermaid diagrams and visualizations to make it easier to understand complex concepts.

AI Assistant in the Documentation

An innovative aspect of this update is the addition of an artificial intelligence assistant directly into the documentation. This wizard allows users to ask questions in natural language and get relevant answers without the need to browse multiple pages or participate in Telegram chats whenever an impediment arises.

Next Steps in Continuous Improvement

TON developers plan to continue enriching the documentation with release pipelines assigned to technical owners, a simpler process for community contributions, interactive components, and code workspaces. It is expected that, as the knowledge base grows, AI assistance will also improve, offering increasingly accurate answers.

Community Feedback

It is important to note that this update to the documentation is thanks to the suggestions and feedback provided by developers such as Zengo, RSquad, TonTech, the TON API team and TON Core, who have contributed to shaping the changes implemented. Users are invited to explore the documentation in docs.ton.org and participate in the continuous improvement of the content.

If you spot any issues or want to contribute new content, you can open a new issue on GitHub. Also, if you’re building a project on TON, consider hosting and maintaining your documentation with us, as having everything in one place will make the experience easier for other developers and improve the effectiveness of the AI assistant.

For more details on updating the documentation, visit the original article.