philosophy-of-software-design

To reduce complexity in software design, use deep modules to expose powerful functionality behind minimal interfaces. This approach emphasizes information hiding and clean abstractions to lower cognitive load when evolving systems.

Design deep modules by moving from shallow interfaces to hiding implementation details behind a small, well-defined interface. Abstract internal data structures and configuration choices to provide powerful functionality with minimal exposure.

Information hiding matters for interface design because it prevents data leakage and hides internal decisions. By keeping interfaces small and abstracting implementation details, you reduce system complexity and improve long-term maintainability.

Strategic programming balances long-term maintainability with short-term delivery, whereas tactical programming focuses purely on immediate functionality. Strategic approaches favor clean abstractions and avoid leaking internal decisions into interfaces.

Avoid deep modules when implementation details are highly variable or must be exposed for user configuration. If hiding data structures or configuration choices restricts necessary flexibility, shallow interfaces might be more appropriate despite increasing complexity.