Software Engineering KB

Home

❯

05 Software Design and Architecture

❯

00 OOP and SOLID Principles

❯

01 Concept

❯

Principle of Least Astonishment

Principle of Least Astonishment

Feb 10, 20261 min read

  • design-principles
  • least-astonishment

Principle of Least Astonishment

← Back to Other Design Principles

Code should do what the reader expects. Components should behave in a way that most users will expect, avoiding surprising side effects or counterintuitive APIs. Predictability reduces bugs and eases onboarding.

Key Properties

  • Consistent Naming
  • Predictable Side Effects

Related

  • KISS (simplicity aids predictability)
  • API Design (apply to API surfaces)

design-principles least-astonishment


Graph View

  • Principle of Least Astonishment
  • Key Properties
  • Related

Backlinks

  • Other Design Principles
  • Consistent Naming
  • Predictable Side Effects

Created with Quartz v4.5.2 © 2026

  • GitHub