# dist_agent_lang Documentation
Welcome to the comprehensive documentation for `dist_agent_lang` (DAL), a hybrid programming language for decentralized and centralized network integration.
---
## 🌐 **PUBLIC DOCUMENTATION (AI/LLM Optimized)**
### ➡️ **[START HERE: Public Documentation Index](PUBLIC_DOCUMENTATION_INDEX.md)**
**This is the main public-facing documentation optimized for:**
- Human developers
- AI assistants (GitHub Copilot, Cursor, ChatGPT, etc.)
- LLM training and code generation
- Automated documentation tools
**Quick Links:**
- [Installation & Quick Start](PUBLIC_DOCUMENTATION_INDEX.md#getting-started)
- [Language Reference](PUBLIC_DOCUMENTATION_INDEX.md#language-reference)
- [Standard Library (stdlib)](PUBLIC_DOCUMENTATION_INDEX.md#standard-library-stdlib)
- [Package Management](PUBLIC_DOCUMENTATION_INDEX.md#package-management)
- [CLI Reference](PUBLIC_DOCUMENTATION_INDEX.md#cli-reference)
- [Examples & Code Snippets](PUBLIC_DOCUMENTATION_INDEX.md#examples)
- [AI/LLM Integration Guide](PUBLIC_DOCUMENTATION_INDEX.md#aillm-integration-guide)
---
## 📚 Documentation Structure
### 🚀 Getting Started
- **[Installation & Quick Start](getting_started/INSTALLATION.md)** - Get up and running quickly
- **[Installation Guide](getting_started/INSTALLATION.md)** - Installation instructions
- **[Usage Guide](project/USAGE_GUIDE.md)** - How to use the language
- **[Getting Started README](getting_started/README.md)** - Getting started overview
### 📖 Guides
- **[API Reference](api_reference.md)** - Complete API documentation
- **[Syntax Reference](syntax.md)** - Language syntax guide
- **[Best Practices](guides/BEST_PRACTICES.md)** - Development best practices
- **[Configuration Guide](project/CONFIGURATION_GUIDE.md)** - Configuration options
- **[Deployment Guide](guides/DEPLOYMENT_GUIDE.md)** - Deployment instructions
### 🎓 Tutorials
- **[DeFi Token Tutorial](tutorials/01_defi_token.md)** - Build a DeFi token
- **[AI Trading Agent](tutorials/02_ai_trading_agent.md)** - Create an AI trading agent
- **[Hybrid Marketplace](tutorials/03_hybrid_marketplace_cloudadmin.md)** - Build a hybrid marketplace
### 🔄 Migration
- **[From Solidity](migration/FROM_SOLIDITY.md)** - Migrate from Solidity
### 🧪 Testing
- **[Testing Quick Reference](TESTING_QUICK_REFERENCE.md)** - Testing commands and overview
- **[Three-Layer Testing](THREE_LAYER_TESTING.md)** - Unit, integration, and mutation testing
- **[Testing Guide](getting_started/TESTING_GUIDE.md)** - How to run tests
### 📋 Specialized Guides
- **[AI Features](guides/AI_FEATURES_GUIDE.md)** - AI and agent features
- **[CloudAdmin Guide](guides/CLOUDADMIN_GUIDE.md)** - CloudAdmin integration
- **[KYC/AML Features](KYC_AML_FEATURES.md)** - KYC/AML capabilities
- **[XNFT Dynamic RWA](XNFT_DYNAMIC_RWA_GUIDE.md)** - XNFT and RWA features
- **[Compliance Architecture](guides/COMPLIANCE_ARCHITECTURE.md)** - Compliance features
- **[Hybrid Integration](guides/HYBRID_INTEGRATION_GUIDE.md)** - Hybrid system integration
## 🗂️ Directory Structure
```
docs/
├── getting_started/ # Quick start, installation, usage, testing
├── guides/ # User guides and references
├── tutorials/ # Step-by-step tutorials
├── migration/ # Migration guides (e.g. FROM_SOLIDITY.md)
├── GIT_QUICK_REFERENCE.md # Git/GitHub commands for this repo
├── TESTING_QUICK_REFERENCE.md
├── THREE_LAYER_TESTING.md
└── README.md # This file
```
## 🔍 Finding Documentation
- **New to the language?** Start with [Installation](getting_started/INSTALLATION.md) or [Getting Started](getting_started/README.md)
- **Looking for API docs?** See [API Reference](api_reference.md)
- **Want examples?** Check [Tutorials](tutorials/)
- **Contributing?** See [CONTRIBUTING.md](../CONTRIBUTING.md)
## 📝 Contributing
Documentation improvements are welcome! Please see the main [CONTRIBUTING.md](../CONTRIBUTING.md) for guidelines.
## 📄 License
See the main [LICENSE](../LICENSE) file for license information.