updated section DApps & main page for DApps

ton-community · Sep 13, 2023 · 8108542 · 8108542
1 parent c0da776
commit 8108542
Show file tree

Hide file tree

Showing 3 changed files with 85 additions and 80 deletions.
diff --git a/docs/develop/dapps/README.mdx b/docs/develop/dapps/README.mdx
@@ -1,8 +1,7 @@
 import Button from '@site/src/components/button'
 
-# Overview
-
-To start with DApps on TON, you need to understand the basics of the blockchain and the TON architecture. You can find this information in the [Concepts](/learn/introduction) section.
+# Getting Started
+Before diving into DApps, make sure you understand the underlying blockchain principles. You might find our [The Open Network](/learn/introduction) and [Blockchain of Blockchains](/learn/overviews/ton-blockchain) articles useful.
 
 Comparing to the pure [Smart Contracts](/develop/smart-contracts/) development, DApps development is more complex. You need to understand [how to work with APIs](/develop/dapps/apis/), how to use authenticate user using [TON Connect](/develop/dapps/ton-connect/overview) and how to use [SDKs](/develop/dapps/apis/sdk) to work with the blockchain.
 
@@ -12,81 +11,75 @@ colorType="secondary" sizeType={'sm'}>
 Choose an SDK
 </Button>
 
-## Basic tools
+## Basic Tools and Resources
+
+Here are some key resources that you'll need throughout your DApp development journey:
 
-Here you can see links to the most important resources for you to get started with TON:
+1. [Developer Wallets](/participate/wallets/apps)
+2. [Blockchain Explorers](/participate/explorers)
+3. [API Documentation](/develop/dapps/apis/)
+4. [SDKs for Various Languages](/develop/dapps/apis/sdk)
+5. [Using the Testnet](/develop/smart-contracts/environment/testnet)
+6. [TON Unfreezer](https://unfreezer.ton.org/)
 
-- [Wallet Apps for Developers](/participate/wallets/apps) — to create and manage wallets.
-- [List of Explorers](/participate/explorers) — to view the state of the blockchain.
-- [API Types](/develop/dapps/apis/) — different ways to interact with the blockchain.
-- [List of SDKs](/develop/dapps/apis/sdk) — list of SDKs for different languages and APIs.
-- [Testnet and how to use it](/develop/smart-contracts/environment/testnet) — to test your contracts.
-- [TON Unfreezer](https://unfreezer.ton.org/) - to unfreeze contracts that ran out of gas for rent.
+### Asset Management
 
-## Asset processing
+Working with assets? These guides cover the essentials:
 
-* [Payment processing](/develop/dapps/asset-processing/)
-* [NFT processing](/develop/dapps/asset-processing/nft)
-* [Metadata parsing](/develop/dapps/asset-processing/metadata)
+- [Payments Processing](/develop/dapps/asset-processing/)
+- [Token (Jetton) Processing](/develop/dapps/asset-processing/jettons)
+- [Handling NFTs](/develop/dapps/asset-processing/nft)
+- [Parsing Metadata](/develop/dapps/asset-processing/metadata)
 
-## Introduction to DeFi
+### Introduction to DeFi
 
-* [Toncoin processing](/develop/dapps/defi/coins)
-* [Tokens on TON (Jettons & NFTs)](/develop/dapps/defi/tokens)
-* [TON Payments](/develop/dapps/defi/ton-payments)
-* [Subscriptions on TON](/develop/dapps/defi/subscriptions)
+Interested in decentralized finance (DeFi)? Here's how to handle different types of assets:
 
-## Tutorials and examples
+- [Understanding Toncoin](/develop/dapps/defi/coins)
+- [Tokens: Jettons & NFTs](/develop/dapps/defi/tokens)
+- [TON Payments](/develop/dapps/defi/ton-payments)
+- [Setting up Subscriptions](/develop/dapps/defi/subscriptions)
 
-### Basics
+## Tutorials and Examples
 
-* Jettons (Tokens): [Mint your first Jetton](/develop/dapps/tutorials/jetton-minter)
-* NFTs: [Step by step NFT collection minting](/develop/dapps/tutorials/collection-minting)
+### DeFi Basics
 
+- Create Your First Token: [Mint Your First Jetton](/develop/dapps/tutorials/jetton-minter)
+- Step by Step: [NFT Collection Minting](/develop/dapps/tutorials/collection-minting)
 
-### JavaScript
+### Language-Specific Guides
 
-* Payment processing using JavaScript:
-  * [Create a key pair and a wallet](https://github.com/toncenter/examples/blob/main/common.js) (tonweb)
-  * [Accepting deposits to a single wallet](https://github.com/toncenter/examples/blob/main/deposits-single-wallet.js) (tonweb)
-  * [Accepting deposits to multiple wallets](https://github.com/toncenter/examples/blob/main/deposits.js) (tonweb)
-  * [Withdrawal process](https://github.com/toncenter/examples/blob/main/withdrawals.js) (tonweb)
-  * [Payment channel example](https://github.com/toncenter/payment-channels-example/blob/main/index.js) (tonweb)
-* [TON Bridge front-end](https://github.com/ton-blockchain/bridge) (Vue.js, no comments)
-* [Web Wallet source code](https://github.com/toncenter/ton-wallet) (tonweb, no comments)
-* [Bot for sales of dumplings](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot-js)
+#### JavaScript
 
+- [Payment Process](https://github.com/toncenter/examples)
+- [TON Bridge](https://github.com/ton-blockchain/bridge)
+- [Web Wallet](https://github.com/toncenter/ton-wallet)
+- [Dumpling Sales Bot](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot-js)
 
-### Python
+#### Python
 
-- [psylopank/pytonlib examples](https://github.com/psylopunk/pytonlib/tree/main/examples)
-- [Transfer NFT & Jettons by creating a transfer message from the owner wallet](https://github.com/tonfactory/tonsdk#transfer-nft--jettons-by-creating-a-transfer-message-from-an-owner-wallet)
-- [Create mnemonic, init wallet class, create an external message to deploy the wallet](https://github.com/tonfactory/tonsdk#create-mnemonic-init-wallet-class-create-external-message-to-deploy-the-wallet)
-- [Storefront bot with payments in TON](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot)
-- [Bot with own balance](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot-2)
+- [Example Projects](https://github.com/psylopunk/pytonlib/tree/main/examples)
+- [Storefront Bot](/develop/dapps/tutorials/accept-payments-in-a-telegram-bot)
 
-### Go
+#### Go
 
-- [10+ examples from xssnick/tonutils-go](https://github.com/xssnick/tonutils-go/tree/master/example)
-- [7+ examples from tonkeeper/tongo](https://github.com/tonkeeper/tongo/tree/master/example)
+- [Examples](https://github.com/xssnick/tonutils-go/tree/master/example)
 
-### ZK
+### Advanced Topics
 
-* [Simple ZK on TON](/develop/dapps/tutorials/simple-zk-on-ton)
+- [Zero-Knowledge Proofs](/develop/dapps/tutorials/simple-zk-on-ton)
 
-### Wallets examples
+### Wallets Examples
 
 - [Desktop standard wallet (C++ and Qt)](https://github.com/ton-blockchain/wallet-desktop)
 - [Android standard wallet (Java)](https://github.com/ton-blockchain/wallet-android)
 - [iOS standard wallet (Swift)](https://github.com/ton-blockchain/wallet-ios)
 - [TonLib CLI (C++)](https://github.com/ton-blockchain/ton/blob/master/tonlib/tonlib/tonlib-cli.cpp)
 
-### No necessary material?
+## 👨‍💻 Contribution
 
-You have 2 ways here: write tutorial by you own or describe the problem for the community.
+Missing some crucial material? You can either write a tutorial yourself or describe the problem for the community.
+
+<Button href="/contribute/participate" colorType="primary" sizeType={'sm'}>Contribute</Button>
+  <Button href="https://github.com/ton-community/ton-docs/issues/new?assignees=&labels=feature+%3Asparkles%3A%2Ccontent+%3Afountain_pen%3A&template=suggest_tutorial.yaml&title=Suggest+a+tutorial" colorType={'secondary'} sizeType={'sm'}>Suggest a Tutorial</Button>
 
-<Button href="/contribute/participate"
-        colorType="primary" sizeType={'sm'}>
-  Contribute
-</Button>
-<Button href="https://github.com/ton-community/ton-docs/issues/new?assignees=&labels=feature+%3Asparkles%3A%2Ccontent+%3Afountain_pen%3A&template=suggest_tutorial.yaml&title=Suggest+a+tutorial" colorType={'secondary'} sizeType={'sm'}>Describe your idea</Button>
diff --git a/docs/develop/dapps/telegram-apps/README.mdx b/docs/develop/dapps/telegram-apps/README.mdx
@@ -1,3 +1,6 @@
+---
+description: Telegram Web Apps (or TWAs) are web applications that run inside the Telegram messenger. They are built using web technologies — HTML, CSS, and JavaScript.
+---
 import Button from '@site/src/components/button'
 
 # What is TWA?

diff --git a/sidebars.js b/sidebars.js
@@ -145,16 +145,6 @@ const sidebars = {
       'type': 'html',
       'value': '<span class=\'menu__link\'><b><small> Development </small></b></span>',
     },
-    {
-      type: 'category',
-      label: 'APIs and SDKs',
-      items: [
-        'develop/dapps/apis/README',
-        'develop/dapps/apis/toncenter',
-        'develop/dapps/apis/adnl',
-        'develop/dapps/apis/sdk'
-      ],
-    },
     {
       type: 'category',
       label: 'Smart Contracts',
@@ -302,26 +292,15 @@ const sidebars = {
         },
         {
           type: 'category',
-          label: 'Learn',
+          label: 'APIs and SDKs',
           items: [
-            {
-              type: 'doc',
-              id: 'develop/dapps/tutorials/collection-minting',
-              label: 'NFT collection minting',
-            },
-            'develop/dapps/tutorials/jetton-minter',
-            {
-              type: 'category',
-              label: 'Telegram bots',
-              items: [
-                'develop/dapps/tutorials/accept-payments-in-a-telegram-bot',
-                'develop/dapps/tutorials/accept-payments-in-a-telegram-bot-2',
-                'develop/dapps/tutorials/accept-payments-in-a-telegram-bot-js',
-              ],
-            },
-            'develop/dapps/tutorials/simple-zk-on-ton',
+            'develop/dapps/apis/README',
+            'develop/dapps/apis/toncenter',
+            'develop/dapps/apis/adnl',
+            'develop/dapps/apis/sdk'
           ],
         },
+
         {
           type: 'category',
           label: 'Guidelines',
@@ -343,6 +322,36 @@ const sidebars = {
             'develop/dapps/defi/subscriptions',
           ],
         },
+        {
+          type: 'category',
+          label: 'Tutorials & Examples',
+          items: [
+            {
+              type: 'doc',
+              id: 'develop/dapps/tutorials/collection-minting',
+              label: 'NFT Minting Guide',
+            },
+            {
+              type: 'doc',
+              id: 'develop/dapps/tutorials/jetton-minter',
+              label: 'Mint Your First Token',
+            },
+            {
+              type: 'doc',
+              id: 'develop/dapps/tutorials/simple-zk-on-ton',
+              label: 'Zero-Knowledge Proofs',
+            },
+            {
+              type: 'category',
+              label: 'Telegram Bot Examples',
+              items: [
+                'develop/dapps/tutorials/accept-payments-in-a-telegram-bot',
+                'develop/dapps/tutorials/accept-payments-in-a-telegram-bot-2',
+                'develop/dapps/tutorials/accept-payments-in-a-telegram-bot-js',
+              ],
+            },
+          ],
+        },
       ]
     },
     {