Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Tact Doc infrastructure integration and preparation #890

Open
TonSquare opened this issue Dec 4, 2024 · 2 comments
Open

Tact Doc infrastructure integration and preparation #890

TonSquare opened this issue Dec 4, 2024 · 2 comments
Labels
Approved This proposal is approved by the committee Developer Tool Related to tools or utilities used by developers

Comments

@TonSquare
Copy link
Contributor

TonSquare commented Dec 4, 2024

Summary

The Translation Program is a collaborative effort to translate various documents related to Tact into multiple languages, making the website more accessible to billions of non-English speakers worldwide.

Context

This grant is for Tact infrastructure integration and preparation only. It's in cooperation with @reveloper and the Tact maintainer @anton-trunov.

The transaction itself is in cooperation with TON Society and multiple language communities.

References

Questbook link:
https://questbook.app/dashboard/?grantId=0xd92881bea3923fec2d8e61aa947c981faa4ab970&chainId=10&proposalId=67401a6a90449961f5a1be6c

Our merged PR for Tact:
tact-lang/tact#942
https://docs.tact-lang.org/zh-cn/

The translation itself is in cooperation with TON Society, here is the approved grant link for operation budget, and official social media campaign link:
https://questbook.app/dashboard/?proposalId=670e479c8868f5130aced859&chainId=10&grantId=65c7836df27e2e1702d2d279

https://x.com/tonsocietyhk/status/1863512755413881004

More info about the localization program we've developed and been maintaining:
https://docs.ton.org/v3/contribute/localization-program/overview

Estimate suggested reward

5000 USD in TON and SBT

@TonSquare TonSquare added the Developer Tool Related to tools or utilities used by developers label Dec 4, 2024
@delovoyhomie delovoyhomie added the Approved This proposal is approved by the committee label Feb 7, 2025
@sansx
Copy link

sansx commented Feb 22, 2025

Multilingual Localization Collaboration System for Tact Documentation

https://docs.tact-lang.org/zh-cn/

Funding Ask

5,000 USD

Breakdown of Costs

Task Hours Cost
Tact Docs Framework i18n Update 40 800
Framework Adaptation (Nextra) 30 600
Framework Adaptation (Astro) 30 600
GitHub Automation 20 400
Vercel Automation 20 400
Crowdin Integration 30 600
Glossary Management System 20 400
OpenAI/DeepL API Integration 20 400
Translator Workflow Optimization 20 400
Detailed Localization Guideline 20 400

Telegram Handle

@MaxwellEQT

Key Deliverables

  1. Localization Framework Architecture: Design a robust framework for multilingual support in Tact documentation.
  2. Tact Docs Framework i18n Update: Modify the Tact documentation framework to support internationalization.
  3. Framework Adaptation (Nextra): Adapt and integrate the Nextra framework for improved documentation workflows.
  4. Framework Adaptation (Astro): Adapt and integrate the Astro framework for additional flexibility and performance.
  5. GitHub Automation: Set up automation workflows for file management and translation updates.
  6. Vercel Automation: Enable automated deployment previews for each language version.
  7. Crowdin Integration: Integrate Crowdin for seamless translator collaboration.
  8. Glossary Management System: Provide a dedicated glossary solution to ensure consistent terminology.
  9. OpenAI/DeepL API Integration: Enhance translator efficiency with AI-generated translation drafts.
  10. Translator Workflow Optimization: Streamline translator processes through automation and tools.
  11. Detailed Localization Guideline: Document clear instructions for developers, translators, and proofreaders.

Overview of the technology stack to be used

Automation system via multiple platform integrations

  • Github Action: Store and manage the source files of code and technical documentation, track change history, and manage different versions of documentation

  • Crowdin: crowdin is a localization management platform

  • Vercel: provide a preview version of docs based on the latest pull request

  • DeepL/OpenAI: Integrated with Crowdin, provides translators with an initial translated version as a reference, provide the best translation for every docs pages according to the context

Seamlessly integrate with existing Mandarin TON/Tact/TMA Docs

Image

Terminology/Glossary support

Provide dedicated glossary solution to provide native crypto/tech terminology for different languages
https://github.com/TownSquareXYZ/ton-i18n-glossary/

Detailed onboarding guidelines for developers, language coordinator, proofreader, translator

We’ve provided very detailed documentation for the localization program.

GitHub repository of the team/project

https://github.com/TownSquareXYZ/tact

https://crowdin.com/project/tact

What are success metrics for your project and who are the target users?

The project aims to achieve the following goals:

  • Build a localization system suitable for multilingual communities.
  • Automate development, integration, and deployment processes.
  • Decouple the roles of developers, translators, and verifiers for streamlined workflows.
  • Provide incentives for community contributions.
  • Integrate advanced AI systems to improve translation quality and efficiency.

Target Users: Developers, language coordinators, proofreaders, and translators involved in creating and maintaining Tact documentation. Initial focus includes Mandarin, Japanese, and Korean communities, with plans to expand to Ukrainian, Russian, Polish, and German communities.

Supporting Links

@Bkaan55
Copy link

Bkaan55 commented Mar 9, 2025

🔥🔥🔥👍🏻😇

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Approved This proposal is approved by the committee Developer Tool Related to tools or utilities used by developers
Projects
None yet
Development

No branches or pull requests

5 participants
@sansx @delovoyhomie @TonSquare @Bkaan55 and others