(feat) add controller docs

Author: cardosofede

bots/controllers/params_docs/controller_config_template_base.md

@@ -0,0 +1,138 @@
+# Controller Configuration Documentation Template
+
+## General Description
+
+This section should provide a comprehensive overview of the controller's trading strategy and operational characteristics. Include:
+
+- **Strategy Type**: Clearly identify the trading approach (market making, directional trading, arbitrage, cross-exchange market making, etc.)
+- **Core Logic**: Explain how the controller analyzes market data and makes trading decisions
+- **Market Conditions**: 
+  - **Optimal Conditions**: Describe when this strategy performs best (e.g., high volatility, stable trends, specific liquidity conditions)
+  - **Challenging Conditions**: Identify scenarios where the strategy may underperform (e.g., low liquidity, extreme volatility spikes, trending markets for mean-reversion strategies)
+- **Risk Profile**: Outline the primary risks and how the controller manages them
+- **Expected Outcomes**: Provide realistic expectations for performance under various market conditions
+
+## Parameters
+
+Each parameter should be documented with the following structure:
+
+### `parameter_name`
+- **Type**: `data_type` (e.g., `Decimal`, `int`, `str`, `List[float]`, `OrderType`)
+- **Default**: `default_value`
+- **Range**: `[min_value, max_value]` or constraints
+- **Description**: Clear explanation of what this parameter controls
+
+#### Value Impact Analysis:
+- **Low Values** (`example_range`): Explain the behavior and implications
+- **Medium Values** (`example_range`): Typical use case and expected behavior  
+- **High Values** (`example_range`): Effects and potential risks
+- **Edge Cases**: What happens at extremes (0, negative, very large values)
+
+#### Interaction Effects:
+- List other parameters this interacts with
+- Describe how combinations affect overall behavior
+
+#### Example Configurations:
+```yaml
+# Conservative setting
+parameter_name: value_1
+
+# Moderate setting  
+parameter_name: value_2
+
+# Aggressive setting
+parameter_name: value_3
+```
+
+## Common Configurations
+
+This section presents complete, ready-to-use configurations for typical trading scenarios. Each configuration should include:
+
+### Configuration Name
+**Use Case**: Brief description of when to use this configuration
+
+**Key Characteristics**:
+- Risk level
+- Capital requirements
+- Market conditions suited for
+- Expected behavior
+
+**Template**:
+```yaml
+# Configuration description and notes
+controller_name: controller_type
+controller_type: category
+connector_name: PLACEHOLDER_EXCHANGE
+trading_pair: PLACEHOLDER_TRADING_PAIR
+portfolio_allocation: 0.XX
+
+# Core parameters with explanations
+parameter_1: value  # Why this value
+parameter_2: value  # Impact on strategy
+parameter_3: value  # Risk consideration
+
+# Advanced parameters
+parameter_4: value
+parameter_5: value
+```
+
+**Placeholders**:
+- `PLACEHOLDER_EXCHANGE`: Replace with your exchange (e.g., binance, coinbase)
+- `PLACEHOLDER_TRADING_PAIR`: Replace with your trading pair (e.g., BTC-USDT, ETH-USD)
+- Adjust numerical values based on your risk tolerance and capital
+
+### Quick Start Configurations
+
+#### 1. Conservative Configuration
+Suitable for beginners or low-risk tolerance
+```yaml
+# Full configuration here
+```
+
+#### 2. Balanced Configuration  
+Standard setup for most market conditions
+```yaml
+# Full configuration here
+```
+
+#### 3. Aggressive Configuration
+Higher risk/reward for experienced traders
+```yaml
+# Full configuration here
+```
+
+## Performance Tuning Guide
+
+### Key Parameters for Optimization
+1. **Parameter Group 1** - Impact on execution speed
+2. **Parameter Group 2** - Risk management controls
+3. **Parameter Group 3** - Profit targets and stops
+
+### Common Adjustments by Market Condition
+- **High Volatility**: Adjust parameters X, Y, Z
+- **Low Liquidity**: Modify parameters A, B, C
+- **Trending Markets**: Update parameters D, E, F
+
+## Troubleshooting
+
+### Common Issues and Solutions
+- **Issue**: Orders not filling
+  - **Solution**: Adjust spread parameters or check minimum order sizes
+  
+- **Issue**: Excessive losses
+  - **Solution**: Review stop loss settings and position sizing
+
+## Best Practices
+
+1. **Start Conservative**: Begin with smaller position sizes and wider spreads
+2. **Monitor Performance**: Track key metrics before increasing exposure
+3. **Regular Review**: Periodically assess and adjust parameters based on performance
+4. **Risk Management**: Always set appropriate stop losses and position limits
+5. **Testing**: Use paper trading or small amounts when trying new configurations
+
+## Additional Notes
+
+- Version compatibility information
+- Exchange-specific considerations
+- Regulatory compliance notes (if applicable)
+- Links to related documentation or resources