# CSP Solver User Guides

This directory contains user-facing documentation and guides for using the CSP Solver library.

## � **Start Here**

### **[📖 Getting Started Guide](getting_started.md)** 
**Complete beginner tutorial** - Learn CSP solving from scratch with step-by-step examples, practical problems, and hands-on exercises. Perfect for first-time users!

## �📚 Available Guides

### Core Documentation
- **[getting_started.md](getting_started.md)** - 🌟 **Complete beginner tutorial with step-by-step examples**
- **[memory_management.md](memory_management.md)** - Complete memory management guide with safety features, limits, and best practices
- **[mathematical_syntax.md](mathematical_syntax.md)** - Mathematical syntax and expression documentation
- **[precision_handling.md](precision_handling.md)** - Comprehensive precision handling guide for float variables
- **[precision_quick_reference.md](precision_quick_reference.md)** - Quick reference for precision configuration

## 🎯 Guide Categories

### � **Getting Started**
New to constraint solving? Start with the comprehensive tutorial that teaches you everything from basic concepts to solving real problems.

### �🛡️ **Safety & Resource Management**
Learn how to use the built-in safety features to prevent system crashes and manage resource usage effectively.

### 🧮 **Mathematical Operations**
Understand the mathematical syntax, expressions, and constraint building capabilities.

### 🔢 **Precision Control**
Master floating-point precision handling for accurate numerical computations.

## �️ Learning Path

**Recommended order for new users:**

1. **[getting_started.md](getting_started.md)** - Learn the fundamentals with hands-on examples
2. **[memory_management.md](memory_management.md)** - Understand safety features and resource limits  
3. **[mathematical_syntax.md](mathematical_syntax.md)** - Master advanced constraint syntax
4. **[precision_handling.md](precision_handling.md)** - Handle floating-point precision (if needed)

## 📋 Quick Links

- **Main Project**: [../../README.md](../../README.md)
- **Examples**: [../../examples/](../../examples/)
- **Development Docs**: [../development/](../development/)

---

*For development documentation, implementation details, and project planning, see [../development/](../development/)*