domains / llm-infra / menloresearch/jan
Configuration structure clarity
Ensure configuration parameters are properly structured, accurately documented, and clearly indicate their scope and purpose. Configuration hierarchies should be explicit (global, assistant-level, thread-level), parameter categories should be well-defined (init vs runtime), and documented values must match actual system behavior.
Ensure configuration parameters are properly structured, accurately documented, and clearly indicate their scope and purpose. Configuration hierarchies should be explicit (global, assistant-level, thread-level), parameter categories should be well-defined (init vs runtime), and documented values must match actual system behavior.
Key practices:
- Categorize parameters by their lifecycle and mutability (e.g.,
initfor initialization-time settings,runtimefor dynamic updates) - Document configuration scope clearly (global defaults, assistant-level overrides, thread-specific settings)
- Verify documented specifications match actual behavior and update when changes occur
- Provide clear examples and visual aids for complex configuration hierarchies
Example structure:
{
"parameters": {
"init": {
"model_path": "/path/to/model",
"max_memory": "8GB"
},
"runtime": {
"temperature": 0.7,
"max_tokens": 2048
}
}
}
This prevents user confusion and ensures configurations work as documented across different scopes and contexts.