# Multi-Language DAP SDK Documentation ## Project Overview This project provides comprehensive multi-language documentation for DAP SDK (Distributed Applications Platform SDK), making the foundational platform accessible to developers worldwide. ## About DAP SDK DAP SDK is the foundational platform that underlies Cellframe SDK, providing essential low-level libraries and infrastructure for building high-performance distributed applications. **Key Features:** - **Core Infrastructure** - Memory management, logging, configuration - **Cryptographic Functions** - Hashing, signatures, encryption - **Network Layer** - Asynchronous I/O, streams, protocols - **Plugin System** - Dynamic loading and module management - **Testing Framework** - Unit testing and benchmarking - **Cross-Platform** - Linux, macOS, Windows support ## Current Status ### πŸ“‹ Project Status: **INITIALIZATION PHASE** - **English Documentation**: In development - **Translation Plan**: To be implemented after core documentation completion - **Target Languages**: 15+ languages planned ## Planned Language Support | Language | Code | README | Core Documentation | API Reference | Status | |----------|------|--------|-------------------|---------------|---------| | English | en | βœ… | πŸ”„ | ⏳ | Primary | | Russian | ru | ⏳ | ⏳ | ⏳ | Planned | | Spanish | es | ⏳ | ⏳ | ⏳ | Planned | | Chinese (Simplified) | zh | ⏳ | ⏳ | ⏳ | Planned | | Portuguese | pt | ⏳ | ⏳ | ⏳ | Planned | | German | de | ⏳ | ⏳ | ⏳ | Planned | | French | fr | ⏳ | ⏳ | ⏳ | Planned | | Italian | it | ⏳ | ⏳ | ⏳ | Planned | | Turkish | tr | ⏳ | ⏳ | ⏳ | Planned | | Polish | pl | ⏳ | ⏳ | ⏳ | Planned | | Japanese | ja | ⏳ | ⏳ | ⏳ | Planned | | Korean | ko | ⏳ | ⏳ | ⏳ | Planned | | Arabic | ar | ⏳ | ⏳ | ⏳ | Planned | | Hindi | hi | ⏳ | ⏳ | ⏳ | Planned | | Vietnamese | vi | ⏳ | ⏳ | ⏳ | Planned | **Legend**: βœ… Complete | πŸ”„ In Progress | ⏳ Planned | ❌ Not Started ## Documentation Structure ### Core English Documentation - **[[../DAP SDK Reference|Main Hub]]** - Central navigation and overview - **[[../Modules/Module Overview|Module Overview]]** - Complete module reference - **[[../ETC/Installation Guide|Installation Guide]]** - Setup instructions - **[[../ETC/API Reference|API Reference]]** - Function documentation ### Translation Organization ``` πŸ“ Other Languages/ β”œβ”€β”€ πŸ“„ README.md (This file - translation status) β”œβ”€β”€ πŸ“ ru/ (Russian translations) β”‚ β”œβ”€β”€ πŸ“„ README.md (Russian overview) β”‚ β”œβ”€β”€ πŸ“„ DAP SDK.md (Main hub in Russian) β”‚ └── πŸ“„ [Module].md (Module documentation) β”œβ”€β”€ πŸ“ es/ (Spanish translations) β”‚ β”œβ”€β”€ πŸ“„ README.md (Spanish overview) β”‚ └── ... └── ... (Additional languages) ``` ## Translation Guidelines ### Technical Standards 1. **API Function Names**: Remain in English - `dap_common_init()`, `dap_hash_fast()`, etc. 2. **Data Type Names**: Remain in English - `dap_config_t`, `dap_events_t`, etc. 3. **Code Comments**: Translated to target language ```c // Π˜Π½ΠΈΡ†ΠΈΠ°Π»ΠΈΠ·Π°Ρ†ΠΈΡ систСмы (Russian) // InicializaciΓ³n del sistema (Spanish) ``` 4. **Documentation Text**: Fully localized - Technical explanations in native language - Cultural adaptation where appropriate - Consistent terminology within language ### Quality Requirements - **Technical Accuracy** - Priority over literal translation - **Consistency** - Uniform terminology across documentation - **Readability** - Natural flow in target language - **Completeness** - All sections translated ## Development Roadmap ### Phase 1: Core English Documentation (Current) - Complete all module documentation - Establish API reference - Create comprehensive examples - Finalize documentation structure ### Phase 2: Primary Language Translations **Target Languages:** - Russian (ru) - Large developer community - Spanish (es) - Growing market - Chinese (zh) - Major developer base - Portuguese (pt) - Brazilian market ### Phase 3: Extended Language Support **Additional Languages:** - German, French, Italian (European markets) - Japanese, Korean (Asian markets) - Arabic, Hindi (Emerging markets) ### Phase 4: Community Translations - Community-driven translations - Translation validation process - Maintenance and updates ## Repository Information **DAP SDK Repository:** [https://gitlab.demlabs.net/dap/dap-sdk](https://gitlab.demlabs.net/dap/dap-sdk) - **Commits**: 2,475+ - **Branches**: 154 - **Created**: May 2, 2020 - **License**: GNU GPLv3 ## Contributing to Translations ### For Translators 1. Review the English documentation structure 2. Understand technical terminology 3. Follow translation guidelines 4. Maintain consistency with established terms 5. Test code examples in translated documentation ### For Reviewers 1. Verify technical accuracy 2. Check language quality and flow 3. Ensure cultural appropriateness 4. Validate code examples 5. Review cross-references and links ### Translation Process 1. **Preparation** - Study source documentation 2. **Translation** - Create initial translation 3. **Technical Review** - Verify accuracy 4. **Language Review** - Check quality and flow 5. **Integration** - Add to documentation structure 6. **Testing** - Verify links and examples ## Contact and Support - **Main Documentation**: [DAP SDK Documentation Hub](DAP%20SDK%20Reference.md) - **Repository**: [GitLab Repository](https://gitlab.demlabs.net/dap/dap-sdk) - **Issues**: [GitLab Issues](https://gitlab.demlabs.net/dap/dap-sdk/-/issues) --- **Project Status**: Initialization Phase **Next Milestone**: Complete English documentation **Translation Target**: 15+ languages **Last Updated**: December 2024 ### Core Translation Components Primary documentation sections for translation: - **[[../ETC/Installation Guide|Installation Guide]]** - Setup instructions - **[[../ETC/First Application|First Application]]** - Tutorial walkthrough - **[[../ETC/Architecture Overview|Architecture Overview]]** - Technical overview - **[[../ETC/Development Guide|Development Guide]]** - Programming guide - **[[../ETC/Troubleshooting|Troubleshooting]]** - Problem resolution - **[[../ETC/Glossary|Glossary]]** - Function documentation ### Translation Project Goals Current priorities for translation development: - Establish core documentation foundation - Create comprehensive module references - Develop tutorial and guide materials - Complete function documentation