liveBook · Manning

Simplicity

As explained in Machine Learning System Design

Simplicity is the property of having relatively few concepts, dependencies, or implementation details that must be understood or managed.

Simplicity in an ML API means choosing an abstraction that hides implementation details without becoming leaky. A small set of methods and parameters makes the system easier to learn and use, while selected customization keeps debugging possible. section 13.1

Balance a simple interface with operational control:

  • Hide most handlers and parameters behind a focused interface instead of exposing their interdependencies. section 13.1
  • Retain explicit customization where it supports debugging and avoids the problems of underconfiguration. section 13.1
  • Support simplicity across integration with layered APIs, separated ML and IO components, client libraries, feature toggles, and fallbacks. section 13.6

A configurable predict interface

A better predict function gives callers optional time and seed parameters, supplies a default time when needed, and passes the resulting values to the model.

How Machine Learning System Design covers it

How deep it goes
Explains abstraction, parameter exposure, and configuration tradeoffs, but stops short of general REST or RPC design.
Examples
Uses predict-function designs and an overconfiguration-versus-underconfiguration comparison.
What it assumes
Assumes general API design knowledge and focuses on ML-specific simplicity pitfalls rather than teaching REST or RPC.
What you can do after
Apply it by designing ML APIs with few parameters, deliberate customization, and separation between ML and IO concerns.
How it connects
Connects simplicity with API design, predictability, abstraction, debugging, feature toggles, fallbacks, and client libraries.

Also explained in

Compare how 4 books explain simplicity →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Machine Learning System Design. The section links point to the parts of the book it draws on.