Expand README with representations and benchmarks

Added sections for supported representations, benchmark functions, and development guidelines.

Author: Rahuldrabit

README.md

@@ -205,11 +205,131 @@ cfg.elite_ratio = 0.05
 cfg.seed = 1
 ```
 
-## Contributing
+## 📊 Supported Representations & Operators
 
-- Keep changes focused and add/update tests when applicable.
-- Prefer small PRs: one feature/fix at a time.
+### Binary Representation
+- **Crossovers**: One-point, Two-point, Uniform
+- **Mutations**: Bit-flip
+- **Use Cases**: Feature selection, binary optimization
 
+### Real-Valued Representation
+- **Crossovers**: Arithmetic, Blend (BLX-α), SBX, One-point, Two-point, Uniform
+- **Mutations**: Gaussian, Uniform
+- **Use Cases**: Continuous function optimization, parameter tuning
+
+### Integer Representation
+- **Crossovers**: One-point, Two-point, Uniform, Arithmetic
+- **Mutations**: Random resetting, Creep
+- **Use Cases**: Discrete optimization, scheduling problems
+
+### Permutation Representation
+- **Crossovers**: Order crossover (OX), Partially mapped crossover (PMX), Cycle crossover
+- **Mutations**: Swap, Insert, Scramble, Inversion
+- **Use Cases**: Traveling salesman problem, job scheduling
+
+## 🧪 Benchmark Functions
+
+The framework includes 5 standard optimization test functions:
+
+1. **Sphere Function**: Simple unimodal function (baseline)
+2. **Rastrigin Function**: Highly multimodal with many local optima
+3. **Ackley Function**: One global minimum with many local minima
+4. **Schwefel Function**: Deceptive function with global optimum far from local optima
+5. **Rosenbrock Function**: Narrow valley, challenging for optimization
+
+## 🔬 Running Benchmarks
+
+The framework includes a comprehensive benchmark suite that tests:
+- **Operator Performance**: Speed of crossover, mutation, and selection operators
+- **Function Optimization**: Convergence quality on test functions
+- **Scalability**: Performance vs. population size and problem dimension
+
+### Benchmark Results
+
+**Operator Performance (typical results on modern CPU):**
+| Operator Category | Representative | Throughput |
+|-------------------|----------------|------------|
+| Binary Crossover | TwoPointCrossover | 2M ops/sec |
+| Real Crossover | BlendCrossover (BLX-α) | 5M ops/sec |
+| Permutation Crossover | OrderCrossover (OX) | 869K ops/sec |
+| Binary Mutation | BitFlipMutation | 1.1M ops/sec |
+| Real Mutation | GaussianMutation | 6.6M ops/sec |
+| Permutation Mutation | SwapMutation | 20M ops/sec |
+| Selection | TournamentSelection | 181K ops/sec |
+
+**Function Optimization (convergence times):**
+| Function | Generations | Time (ms) | Best Fitness |
+|----------|-------------|-----------|--------------|
+| Sphere | 100 | ~1 | >500 |
+| Rastrigin | 200 | ~5 | >60 |
+| Ackley | 150 | ~4 | >60 |
+| Schwefel | 200 | ~7 | Variable |
+| Rosenbrock | 300 | ~8 | >200 |
+
+*Results will vary based on hardware, problem configuration, and random seed.*
+
+### Understanding Benchmark Output
+
+The benchmark tool generates:
+- **Console output**: Real-time progress and summary statistics
+- **benchmark_results.txt**: Detailed results with all metrics
+- **benchmark_results.csv**: Machine-readable format (with `--csv` flag)
+
+## 🏗️ Architecture & Efficiency
+
+For a detailed analysis of the framework's architecture, efficiency, and usability across C++, Python, and C, see [ARCHITECTURE.md](ARCHITECTURE.md).
+
+**Key Highlights:**
+- ⚡ **Performance**: Native C++17 with zero-overhead abstractions
+- 🔧 **Extensible**: Easy to add custom operators and fitness functions
+- 🌐 **Multi-language**: C++ core with Python bindings
+- 📊 **Validated**: Comprehensive benchmark suite included
+- 🧪 **Tested**: Multiple test programs and sanity checks
+
+## 🔍 Development
+
+### Adding New Operators
+
+1. Create header and implementation files in the appropriate directory
+2. Inherit from the base operator class
+3. Implement required virtual methods
+4. Optionally expose convenience factories alongside `ga::make*` helpers
+
+### Adding New Fitness Functions
+
+1. Add declaration to `simple-GA-Test/fitness-function.h`
+2. Implement in `simple-GA-Test/fitness-fuction.cc`
+3. Add to the `GAConfig::FunctionType` enum
+4. Update the fitness function selection logic
+
+### Building for Development
+
+```bash
+# Debug build with symbols
+cmake -DCMAKE_BUILD_TYPE=Debug ..
+cmake --build .
+
+# Run with debug output
+./bin/simple_ga_test
+```
+
+## 📝 Output
+
+The program generates:
+- **Console output**: Progress information and final results
+- **ga_results.txt**: Detailed results including:
+  - Best fitness values per generation
+  - Average fitness values
+  - Best individual's chromosome
+  - Optimization statistics
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests if applicable
+5. Submit a pull request
 ## License
 
 Apache-2.0