Software engineering Best practices – Configuration

1. Making configuration explicit but simple at the same time to avoid client surprises. The goal should be, if it is read by multiple audience, it should convey the same meaning and should be agnostic to the audience/engineer’s experience.
2. In modern distributed system, which are divided into control plane & data plane, any configuration to an API or service, is a control plane operation and gets better suited with control plane APIs and not to be confused with data plane API input filter.