ton-community
diff --git a/‎.editorconfig
Lines changed: 8 additions & 0 deletions b/‎.editorconfig
Lines changed: 8 additions & 0 deletions
diff --git a/‎.eslintignore
Lines changed: 3 additions & 0 deletions b/‎.eslintignore
Lines changed: 3 additions & 0 deletions
diff --git a/‎.eslintrc.js
Lines changed: 15 additions & 0 deletions b/‎.eslintrc.js
Lines changed: 15 additions & 0 deletions
diff --git a/‎.github/ISSUE_TEMPLATE/feature_request.yaml
Lines changed: 2 additions & 16 deletions b/‎.github/ISSUE_TEMPLATE/feature_request.yaml
Lines changed: 2 additions & 16 deletions
diff --git a/‎.github/labeler.yml
Lines changed: 1 addition & 1 deletion b/‎.github/labeler.yml
Lines changed: 1 addition & 1 deletion
diff --git a/‎.github/workflows/lint.yml
Lines changed: 19 additions & 0 deletions b/‎.github/workflows/lint.yml
Lines changed: 19 additions & 0 deletions
diff --git a/‎.gitignore
Lines changed: 2 additions & 0 deletions b/‎.gitignore
Lines changed: 2 additions & 0 deletions
diff --git a/‎README.md
Lines changed: 21 additions & 6 deletions b/‎README.md
Lines changed: 21 additions & 6 deletions
diff --git a/‎crowdin.yml
Lines changed: 12 additions & 0 deletions b/‎crowdin.yml
Lines changed: 12 additions & 0 deletions
diff --git a/‎deployment/Docker/nginx.conf
Lines changed: 1 addition & 1 deletion b/‎deployment/Docker/nginx.conf
Lines changed: 1 addition & 1 deletion
diff --git a/‎docs/contribute/archive/hacktoberfest-2022/README.mdx
Lines changed: 23 additions & 11 deletions b/‎docs/contribute/archive/hacktoberfest-2022/README.mdx
Lines changed: 23 additions & 11 deletions
diff --git a/‎docs/contribute/docs/schemes-guidelines.mdx
Lines changed: 92 additions & 0 deletions b/‎docs/contribute/docs/schemes-guidelines.mdx
Lines changed: 92 additions & 0 deletions
@@ -0,0 +1,8 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
@@ -0,0 +1,3 @@
+./.docusaurus
+./build
+./node_modules
@@ -0,0 +1,15 @@
+// .eslintrc.js example
+module.exports = {
+  env: {
+    browser: true,
+    es2021: true
+  },
+  parser: "@typescript-eslint/parser",
+  parserOptions: {
+    ecmaVersion: "latest",
+    sourceType: "module"
+  },
+  rules: {
+    indent: ["error", 2]
+  }
+}
@@ -1,6 +1,6 @@
-name: Feature request
+name: Docs feature request
 description: Suggest an idea for this project
-title: Feature request
+title: Docs feature request
 labels: ["feature :sparkles:"]
 body:
   - type: textarea
@@ -17,22 +17,8 @@ body:
       description: A clear and concise description of what you want to happen
     validations:
       required: true
-  - type: textarea
-    id: feature_request_alternatives
-    attributes:
-      label: Describe alternatives you've considered
-      description: A clear and concise description of any alternative solutions or features you've considered
-    validations:
-      required: true
   - type: textarea
     id: feature_request_additional_context
     attributes:
       label: Additional context
       description: Add any other context or screenshots about the feature request here
-  - type: markdown
-    attributes:
-      value: |
-        **Want to contribute?**
-  - type: markdown
-    attributes:
-      value: We love contributions from the TON community! Please comment on an issue if you're interested in helping out with a PR.
@@ -8,7 +8,7 @@
   - i18n/**/*
 
 "documentation :book:":
-  - README.md
+  - academy-overview.md
 
 "tooling :wrench:":
   - .github/**/*
 
@@ -0,0 +1,19 @@
+name: Lint
+
+on: pull_request
+
+jobs:
+  eslint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-node@v3
+        with:
+          node-version: 16
+      - run: npm ci # or yarn install
+      - uses: sibiraj-s/action-eslint@v3
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }} # optional
+          ignore-path: .eslintignore
+          extensions: 'js,jsx,ts,tsx'
+          annotations: true
@@ -24,3 +24,5 @@ npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 .gitpod.yml
+
+.env
@@ -5,7 +5,7 @@
 This is the official repository for The Open Network documentation.
 
 Latest documentation release: [docs.ton.org](https://docs.ton.org)
-
+ 
 The mission of this documentation is to collect all available information and knowledge that can help TON developers.
 
 You can improve the documentation by following steps below.
@@ -21,7 +21,7 @@ TON is an actively growing ecosystem, and every day many devs contribute to its
 You can participate in TON by helping organize knowledge, making Pull Requests and creating tutorials to help other developers. 
 Feedback, lectures, technical articles, tutorials, and examples. All this can help the developers community grow even faster!
 
-Join TON Docs Club chat in Telegram and get the latest tasks from maintainers:
+Join TON Docs Club chat in Telegram to join contributors party:
 * https://t.me/+c-0fVO4XHQsyOWM8
 
 ---
@@ -30,12 +30,11 @@ Join TON Docs Club chat in Telegram and get the latest tasks from maintainers:
 
 ## How to Contribute? 🦄
 
-As said before, it's up to you.
-
 If you are a developer and faced some difficulties, successfully overcoming them - share this knowledge with future developers!
 
-— Have an idea? [Submit an issue](https://github.com/ton-community/ton-docs/issues/new/choose).  
-— Want to validate changes? [Setup your environment](https://github.com/ton-community/ton-docs#set-up-your-environment-%EF%B8%8F).
+— Have an issue? [Prepare a solution with TON Docs Wizard](https://t.me/ton_docs_bot).  
+— Have an idea? [Submit a Feature Request](https://github.com/ton-community/ton-docs/issues/new/choose).  
+— Want to contribute? [Setup your environment](https://github.com/ton-community/ton-docs#set-up-your-environment-%EF%B8%8F).
 
 Contributing best practices:  [docs/contribute](https://ton.org/docs/contribute)
 
@@ -68,9 +67,25 @@ Use Gitpod (a free, online VS code-like IDE) for contributing. It will launch a
     ```
     npm run start
     ```
+6. Build with multiple locales and run it locally
+
+    ```
+    npm run build
+    npm run serve
+    ```
 
 This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
 
+## Contributors Wall
+<a href="https://github.com/ton-community/ton-docs/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=ton-community/ton-docs&max=204" />
+</a>
+
+<p align="right" style="font-size: 14px; color: #555; margin-top: 20px;">
+  <a href="#readme-top" style="text-decoration: none; color: blue; font-weight: bold;">
+    ↑ Back to Top ↑
+  </a>
+</p>
 ## License
 
 [GPL-3.0](https://choosealicense.com/licenses/gpl-3.0/)
 
@@ -0,0 +1,12 @@
+project_id: '663652'
+api_token_env: CROWDIN_PERSONAL_TOKEN
+preserve_hierarchy: 1
+files:
+  - source: /i18n/en/**/*
+    translation: /i18n/%two_letters_code%/**/%original_file_name%
+  - source: /docs/**/*
+    translation: /i18n/%two_letters_code%/docusaurus-plugin-content-docs/current/**/%original_file_name%
+    ignore:
+      - /docs/**/*.png
+  - source: /src/pages/learn/**/*
+    translation: /i18n/%two_letters_code%/docusaurus-plugin-content-pages/learn/**/%original_file_name%
@@ -2,7 +2,7 @@ server {
     server_name _;
 
     location / {
-        root   /app;
+        root /app;
         try_files $uri $uri/index.html $uri.html 404.html;
     }
 }
@@ -1,13 +1,13 @@
 import Button from '@site/src/components/button'
 
 # What is Hacktoberfest?
-
+````mdx-code-block 
 <div style={{ textAlign: 'center', margin: '50px 0' }}>
   <img alt="tlb structure"
        src="/docs/img/docs/hacktoberfest.webp"
        width="100%" />
 </div>
-
+````
 [Hacktoberfest](https://hacktoberfest.digitalocean.com/) is a month-long celebration of *open-source projects*, their *maintainers*, and the entire community of *contributors*. Each October, open source maintainers give new contributors extra attention as they guide developers through their first pull requests.
 
 For the TON Community it's time to help ecosystem growth together, so let's join the whole world with our **Hack-TON-berfest** party and become *#1 open-source ecosystem of the year*!
@@ -30,14 +30,16 @@ For everyone in TON it's an opportunity to drive the growth of the entire ecosys
 ## What are the rewards?
 
 To motivate the community to contribute to open source projects in the TON Ecosystem, you'll be able to receive a special reward from TON Foundation. Every participant will receive a **Limited Hack-TON-berfest NFT** achievement as a proof of participating:
-
-<div style={{textAlign:'center', margin: '0 auto'}}>
-  <video width="300" style={{borderRadius:'10pt', margin:'15pt auto'}} muted={true} autoPlay={true} loop={true}>
+````mdx-code-block 
+<div style={{width: '100%', textAlign:'center', margin: '0 auto'}}>
+  <video width="300" style={{width: '100%', borderRadius:'10pt', margin:'15pt auto'}} muted={true} autoPlay={true} loop={true}>
     <source src="/docs/files/nft-sm.mp4" type="video/mp4" />
-        Your browser does not support the video tag.
+````
+Your browser does not support the video tag.
+````mdx-code-block 
   </video>
 </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.
 :::
@@ -46,8 +48,18 @@ You have plenty of time to participate in the event. Let's build decentralized I
 
 
 
-  <Button href="/contribute/hacktoberfest/as-contributor"
+````mdx-code-block 
+<Button href="/contribute/hacktoberfest/as-contributor"
      colorType="primary" sizeType={'lg'}>
-    I want to become a Contributor
-  </Button>
-  <Button href="/contribute/hacktoberfest/as-maintainer" colorType={'secondary'} sizeType={'lg'}>I'm a Maintainer</Button>
+````
+I want to become a Contributor
+````mdx-code-block 
+</Button>
+````
+````mdx-code-block 
+<Button href="/contribute/hacktoberfest/as-maintainer" colorType={'secondary'} sizeType={'lg'}>
+````
+I'm a Maintainer
+````mdx-code-block 
+</Button>
+````
@@ -0,0 +1,92 @@
+import ConceptImage from '@site/src/components/conceptImage';
+import ThemedImage from '@theme/ThemedImage';
+
+# Graphic Explanations Guidelines
+
+Maintaining consistency in documentation is crucial, and to achieve this, a specific standard for visualizing processes in smart contracts has been developed.
+
+## Graphic Explanation Notation
+
+### Message Processing Graph
+
+To depict message processing, it's advisable to utilize a graphical representation resembling a smart contract graph, complete with labels for transactions and messages.
+
+If the order of transactions doesn't matter, you can omit their labels. This simplifies the diagram, making it easier to read and understand the details related to messages and contracts.
+
+#### Annotation Primitives
+
+|Figure|Description|
+|------|-----------|
+|![](/img/docs/scheme-templates/message-processing-graphs/circle_for_smart_contract.svg?raw=true) | Circle - Smart Contract entity |
+|![](/img/docs/scheme-templates/message-processing-graphs/rectangle_for_regular_message.svg?raw=true)  | Rectangle - Message Entity |
+|![](/img/docs/scheme-templates/message-processing-graphs/dashed_rectgl_for_optional_message.svg?raw=true)  | Dashed Rectangle - Optional Message Entity |
+|![](/img/docs/scheme-templates/message-processing-graphs/line_for_transaction.svg?raw=true) | Transactions (numeration optional)|
+|![](/img/docs/scheme-templates/message-processing-graphs/person_figure_for_actor.svg?raw=true) | Actor|
+
+* Avoid using big quantity different and bright colors.
+* Use the modification of figures, such as using a dashed border line.
+* For better comprehension, different transactions could be displayed with distinct line styles (solid and dashed).
+
+
+#### Message Processing Example
+````mdx-code-block
+<br></br>
+<ThemedImage
+  alt=""
+  sources={{
+    light: '/img/docs/message-delivery/message_delivery_2.svg?raw=true',
+    dark: '/img/docs/message-delivery/message_delivery_2.svg?raw=true',
+  }}
+/>
+<br></br>
+````
+
+
+Learn references directly from Visio [message-processing.vsdx](/static/schemes-visio/message-processing.vsdx).
+
+
+### Formats and Colors
+
+#### Fonts
+
+* **Inter** fonts family  for all text within diagrams.
+
+#### Colors - Light Mode
+* Pencil Hand Drawn(default theme)
+
+#### Colors - Dark Mode
+* Font `#e3e3e3`
+* Background `#232328`
+* Light Highlight(arrows and scheme borders) `#058dd2`
+* Dark Highlight(arrows and scheme borders) `#0088cc`
+* InnerBackGround(for nested blocks) `#333337`
+
+
+#### Version Control Policy
+
+* Set diagrams in the documentation by SVG format for schemes to ensure readability on various devices.
+* Store original files in the project's Git repository under the "/static/visio" directory, making them easier to modify in the future.
+
+
+### Sequence Diagram
+In the case of complex and repetitive communication schemes between 2-3 actors, it is advisable to use a sequence diagram. For messages, use the notation of a common synchronous message arrow.
+
+#### Example
+````mdx-code-block 
+<br></br>
+<div class="text--center">
+<ThemedImage
+  alt=""
+  sources={{
+    light: '/img/docs/message-delivery/message_delivery_7.svg?raw=true',
+    dark: '/img/docs/message-delivery/message_delivery_7.svg?raw=true',
+  }}
+/>
+</div>
+<br></br>
+````
+
+### Scheme References
+
+* [message-processing.vsdx](/schemes-visio/message_processing.vsdx)
+
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+./.docusaurus`
	`2`	`+./build`
	`3`	`+./node_modules`
Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,7 @@ server {`
`2`	`2`	`server_name _;`
`3`	`3`
`4`	`4`	`location / {`
`5`		`- root /app;`
	`5`	`+ root /app;`
`6`	`6`	`try_files $uri $uri/index.html $uri.html 404.html;`
`7`	`7`	`}`
`8`	`8`	`}`