When adding new configuration options, carefully consider whether features should be enabled by default. Require explicit justification for default enablement, weighing functionality benefits against compatibility risks and user impact.
When adding new configuration options, carefully consider whether features should be enabled by default. Require explicit justification for default enablement, weighing functionality benefits against compatibility risks and user impact.
Key considerations:
Example from Helm values configuration:
custom:
# Don't enable by default - requires k8s v1.31+ APIs
# feature_gates: DynamicResourceAllocation=true
feature_gates: ""
# Enable capability by default - core functionality
root_queue:
capability: true
When in doubt, prefer conservative defaults that maintain backward compatibility, and provide clear documentation on how users can enable advanced features when needed.
Enter the URL of a public GitHub repository