---
title: "Meaning & Key Takeaway of: The Principle of Least Surprise\"…"
description: "\"“The Principle of Least Surprise\" describes a general approach to software that celebrates sanity over cleverness: clear intent, reasonable defaults, a..."
image: "https://sms4smile.com/quotes/i/ad8/mattt-thompson-71141_programming_the-principle-of-least-surprise-describe_1807166.jpg"
---

#  The Principle of Least Surprise" describes a general…

![“The Principle of Least Surprise" describes a general approach to software that celebrates sanity over cleverness: clear intent, reasonable defaults, and providing a sense of control to the developer.” quote by Mattt Thompson](https://sms4smile.com/quotes/i/ad8/mattt-thompson-71141_programming_the-principle-of-least-surprise-describe_1807166.jpg)   [Download](https://sms4smile.com/quotes/i/ad8/mattt-thompson-71141_programming_the-principle-of-least-surprise-describe_1807166.jpg) [Open image](https://sms4smile.com/quotes/i/ad8/mattt-thompson-71141_programming_the-principle-of-least-surprise-describe_1807166.jpg)

> ““The Principle of Least Surprise" describes a general approach to software that celebrates sanity over cleverness: clear intent, reasonable defaults, and providing a sense of control to the developer.””

Mattt Thompson

## About This Quote

This interpretation was drafted with AI assistance. It is one reading of the quote, not the author's own explanation.

Software should prioritize clear intent and sensible defaults, giving developers control rather than relying on clever tricks.

**In simple terms:** Write software that is obvious and easy to use.

Key Takeaway

Favor simplicity and predictability in code.

Themes

software design usability clarity developer experience

Mood

analytical pragmatic

Type

technical philosophical

When to use this quote

- code reviews
- API design
- framework selection
- team onboarding
- documentation

Key Concepts

human‑centered design simplicity maintainability

Questions to Reflect On

- How can you test if a feature is surprising?
- When is cleverness justified?

A Different Perspective

Complex problems may need clever solutions despite the principle.

★ ★ ★ ★ ★   No ratings yet

[Programming](https://sms4smile.com/quotes/about/programming/)

## Related quotes

> [Actually, I didn't make the claim that Ruby follows the principle of least surprise. Someone felt the design of Ruby follows that philosophy, so…](https://sms4smile.com/quotes/yukihiro-matsumoto/actually-i-didn-t-make-the-claim-that-ruby-follows-the-principle-of/)

[Yukihiro Matsumoto](https://sms4smile.com/quotes/author/yukihiro-matsumoto/)

> [“The Principle of Least Surprise is the concept that the idea or approach being taken would not surprise a reasonably knowledgeable person in the…](https://sms4smile.com/quotes/anonymous/the-principle-of-least-surprise-is-the-concept-that-the-idea-or/)

[Anonymous](https://sms4smile.com/quotes/author/anonymous/)

> [In late modernity we grow more and more accustomed to politicians and public figures who are indebted to their appetites for their "values," to…](https://sms4smile.com/quotes/kenny-smith/in-late-modernity-we-grow-more-and-more-accustomed-to-politicians-and/)

[Kenny Smith](https://sms4smile.com/quotes/author/kenny-smith/)

> [Human integrity is determined by the heart, not by cleverness.](https://sms4smile.com/quotes/senora-roy/human-integrity-is-determined-by-the-heart-not-by-cleverness/)

[Senora Roy](https://sms4smile.com/quotes/author/senora-roy/)

> [Where there is simplicity, there are a hundred Angels, but where there is cleverness - there are none.](https://sms4smile.com/quotes/ambrose-of-optina/where-there-is-simplicity-there-are-a-hundred-angels-but-where-there/)

Ambrose of Optina

> [“Neither the Russians nor the Americans were the cleverest people, or the most experienced, in the world that followed 1945. The French were rather…](https://sms4smile.com/quotes/t-r-fehrenbach-2/neither-the-russians-nor-the-americans-were-the-cleverest-people-or/)

[T.R. Fehrenbach](https://sms4smile.com/quotes/author/t-r-fehrenbach-2/)

> [What a curious picture it is to find man, homo sapiens, of divine origin, we are told, seriously considering going underground to escape the…](https://sms4smile.com/quotes/j-william-fulbright/what-a-curious-picture-it-is-to-find-man-homo-sapiens-of-divine/)

[J. William Fulbright](https://sms4smile.com/quotes/author/j-william-fulbright/)

> [Many of the greatest men have owed their success to industry rather than to cleverness.](https://sms4smile.com/quotes/john-lubbock/many-of-the-greatest-men-have-owed-their-success-to-industry-rather/)

[John Lubbock](https://sms4smile.com/quotes/author/john-lubbock/)

> [Sometimes people try way too hard to sound clever on Facebook.](https://sms4smile.com/quotes/anonymous/sometimes-people-try-way-too-hard-to-sound-clever-on-facebook/)

[Anonymous](https://sms4smile.com/quotes/author/anonymous/)

> [Limits have to be set on how far one can simply use the... cleverness that we have to make changes.](https://sms4smile.com/quotes/leon-kass/limits-have-to-be-set-on-how-far-one-can-simply-use-the-cleverness/)

[Leon Kass](https://sms4smile.com/quotes/author/leon-kass/)

> [Ultimately, of course, you must decide for yourself whether the subjective psychological effects created by your evolved cognitive biases reflect an objective reality, perhaps…](https://sms4smile.com/quotes/jesse-bering/ultimately-of-course-you-must-decide-for-yourself-whether-the/)

[Jesse Bering](https://sms4smile.com/quotes/author/jesse-bering/)

> [A fool is a person who guesses and gets it wrong, a clever man is one who guesses, regardless of time period, and gets…](https://sms4smile.com/quotes/voltaire/a-fool-is-a-person-who-guesses-and-gets-it-wrong-a-clever-man-is-one/)

[Voltaire](https://sms4smile.com/quotes/author/voltaire/)

> [If we fail to appreciate the soul that Easternism gives us, then what we have is a disconnected, Greco-Roman, Western, egocentric, compartmentalized, reductionist, fragmented,…](https://sms4smile.com/quotes/joel-salatin/if-we-fail-to-appreciate-the-soul-that-easternism-gives-us-then-what/)

[Joel Salatin](https://sms4smile.com/quotes/author/joel-salatin/)

> [“Passion often makes a madman of the cleverest man, and renders the greatest fools clever.”](https://sms4smile.com/quotes/francois-de-la-rochefoucauld/passion-often-makes-a-madman-of-the-cleverest-man-and-renders-the/)

[François de La Rochefoucauld](https://sms4smile.com/quotes/author/francois-de-la-rochefoucauld/)

> [“Rumi observed, “Sell your cleverness and purchase bewilderment.”](https://sms4smile.com/quotes/wayne-w-dyer/rumi-observed-sell-your-cleverness-and-purchase-bewilderment/)

[Wayne W. Dyer](https://sms4smile.com/quotes/author/wayne-w-dyer/)

## More by Mattt Thompson

> [“NSPredicate is truly one of the jewels of Cocoa. Other languages would be lucky to have something with half of its capabilities in a…](https://sms4smile.com/quotes/mattt-thompson/nspredicate-is-truly-one-of-the-jewels-of-cocoa-other-languages-would/)

Mattt Thompson

> [“Ask anyone who's been around the NSBlock a few times: Key-Value Observing has the worst API in all of Cocoa.”](https://sms4smile.com/quotes/mattt-thompson/ask-anyone-who-s-been-around-the-nsblock-a-few-times-key-value/)

Mattt Thompson

> [“There are only 2 hard things in programming: naming, cache invalidation, and off-by-one-errors.”](https://sms4smile.com/quotes/mattt-thompson/there-are-only-2-hard-things-in-programming-naming-cache-invalidation/)

Mattt Thompson

Explore all 4 Mattt Thompson quotes

## More Cleverness quotes

> [“Rumi observed, “Sell your cleverness and purchase bewilderment.”](https://sms4smile.com/quotes/wayne-w-dyer/rumi-observed-sell-your-cleverness-and-purchase-bewilderment/)

[Wayne W. Dyer](https://sms4smile.com/quotes/author/wayne-w-dyer/)

> [“Passion often makes a madman of the cleverest man, and renders the greatest fools clever.”](https://sms4smile.com/quotes/francois-de-la-rochefoucauld/passion-often-makes-a-madman-of-the-cleverest-man-and-renders-the/)

[François de La Rochefoucauld](https://sms4smile.com/quotes/author/francois-de-la-rochefoucauld/)

> [If we fail to appreciate the soul that Easternism gives us, then what we have is a disconnected, Greco-Roman, Western, egocentric, compartmentalized, reductionist, fragmented,…](https://sms4smile.com/quotes/joel-salatin/if-we-fail-to-appreciate-the-soul-that-easternism-gives-us-then-what/)

[Joel Salatin](https://sms4smile.com/quotes/author/joel-salatin/)

> [A fool is a person who guesses and gets it wrong, a clever man is one who guesses, regardless of time period, and gets…](https://sms4smile.com/quotes/voltaire/a-fool-is-a-person-who-guesses-and-gets-it-wrong-a-clever-man-is-one/)

[Voltaire](https://sms4smile.com/quotes/author/voltaire/)

> [Ultimately, of course, you must decide for yourself whether the subjective psychological effects created by your evolved cognitive biases reflect an objective reality, perhaps…](https://sms4smile.com/quotes/jesse-bering/ultimately-of-course-you-must-decide-for-yourself-whether-the/)

[Jesse Bering](https://sms4smile.com/quotes/author/jesse-bering/)

> [Limits have to be set on how far one can simply use the... cleverness that we have to make changes.](https://sms4smile.com/quotes/leon-kass/limits-have-to-be-set-on-how-far-one-can-simply-use-the-cleverness/)

[Leon Kass](https://sms4smile.com/quotes/author/leon-kass/)

> [Sometimes people try way too hard to sound clever on Facebook.](https://sms4smile.com/quotes/anonymous/sometimes-people-try-way-too-hard-to-sound-clever-on-facebook/)

[Anonymous](https://sms4smile.com/quotes/author/anonymous/)

> [Many of the greatest men have owed their success to industry rather than to cleverness.](https://sms4smile.com/quotes/john-lubbock/many-of-the-greatest-men-have-owed-their-success-to-industry-rather/)

[John Lubbock](https://sms4smile.com/quotes/author/john-lubbock/)

> [What a curious picture it is to find man, homo sapiens, of divine origin, we are told, seriously considering going underground to escape the…](https://sms4smile.com/quotes/j-william-fulbright/what-a-curious-picture-it-is-to-find-man-homo-sapiens-of-divine/)

[J. William Fulbright](https://sms4smile.com/quotes/author/j-william-fulbright/)

> [“Neither the Russians nor the Americans were the cleverest people, or the most experienced, in the world that followed 1945. The French were rather…](https://sms4smile.com/quotes/t-r-fehrenbach-2/neither-the-russians-nor-the-americans-were-the-cleverest-people-or/)

[T.R. Fehrenbach](https://sms4smile.com/quotes/author/t-r-fehrenbach-2/)

> [Where there is simplicity, there are a hundred Angels, but where there is cleverness - there are none.](https://sms4smile.com/quotes/ambrose-of-optina/where-there-is-simplicity-there-are-a-hundred-angels-but-where-there/)

Ambrose of Optina

> [Human integrity is determined by the heart, not by cleverness.](https://sms4smile.com/quotes/senora-roy/human-integrity-is-determined-by-the-heart-not-by-cleverness/)

[Senora Roy](https://sms4smile.com/quotes/author/senora-roy/)

> [In late modernity we grow more and more accustomed to politicians and public figures who are indebted to their appetites for their "values," to…](https://sms4smile.com/quotes/kenny-smith/in-late-modernity-we-grow-more-and-more-accustomed-to-politicians-and/)

[Kenny Smith](https://sms4smile.com/quotes/author/kenny-smith/)

> [The art of investment has one characteristic that is not generally appreciated. A creditable, if unspectacular, result can be achieved by the lay investor…](https://sms4smile.com/quotes/benjamin-graham/the-art-of-investment-has-one-characteristic-that-is-not-generally/)

[Benjamin Graham](https://sms4smile.com/quotes/author/benjamin-graham/)

> [Books are in no hurry. An act of creation is in no hurry; it reads us, it privileges us infinitely. The notion that it…](https://sms4smile.com/quotes/george-steiner/books-are-in-no-hurry-an-act-of-creation-is-in-no-hurry-it-reads-us/)

[George Steiner](https://sms4smile.com/quotes/author/george-steiner/)

Browse all 406 Cleverness quotes

```json
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Quotation",
            "text": "“The Principle of Least Surprise\" describes a general approach to software that celebrates sanity over cleverness: clear intent, reasonable defaults, and providing a sense of control to the developer.”",
            "creator": {
                "@type": "Person",
                "name": "Mattt Thompson"
            },
            "isPartOf": {
                "@id": "https://sms4smile.com/quotes/#website"
            },
            "url": "https://sms4smile.com/quotes/mattt-thompson/the-principle-of-least-surprise-describes-a-general-approach-to/",
            "about": {
                "@type": "Thing",
                "name": "Cleverness"
            },
            "@id": "https://sms4smile.com/quotes/mattt-thompson/the-principle-of-least-surprise-describes-a-general-approach-to/#quotation",
            "image": {
                "@type": "ImageObject",
                "@id": "https://sms4smile.com/quotes/i/ad8/mattt-thompson-71141_programming_the-principle-of-least-surprise-describe_1807166.jpg",
                "contentUrl": "https://sms4smile.com/quotes/i/ad8/mattt-thompson-71141_programming_the-principle-of-least-surprise-describe_1807166.jpg",
                "url": "https://sms4smile.com/quotes/i/ad8/mattt-thompson-71141_programming_the-principle-of-least-surprise-describe_1807166.jpg",
                "width": 1080,
                "height": 1080,
                "caption": "“The Principle of Least Surprise\" describes a general approach to software that celebrates sanity over…” — Mattt Thompson",
                "creditText": "SMS4Smile Quotes",
                "creator": {
                    "@id": "https://sms4smile.com/quotes/#organization"
                }
            }
        },
        {
            "@type": "BreadcrumbList",
            "itemListElement": [
                {
                    "@type": "ListItem",
                    "position": 1,
                    "name": "Home",
                    "item": "https://sms4smile.com/"
                },
                {
                    "@type": "ListItem",
                    "position": 2,
                    "name": "Quotes",
                    "item": "https://sms4smile.com/quotes/"
                },
                {
                    "@type": "ListItem",
                    "position": 3,
                    "name": "Mattt Thompson",
                    "item": "https://sms4smile.com/quotes/author/mattt-thompson/"
                },
                {
                    "@type": "ListItem",
                    "position": 4,
                    "name": "“The Principle of Least Surprise\" describes...",
                    "item": "https://sms4smile.com/quotes/mattt-thompson/the-principle-of-least-surprise-describes-a-general-approach-to/"
                }
            ],
            "@id": "https://sms4smile.com/quotes/mattt-thompson/the-principle-of-least-surprise-describes-a-general-approach-to/#breadcrumb"
        },
        {
            "@type": "WebSite",
            "@id": "https://sms4smile.com/quotes/#website",
            "name": "SMS4Smile Quotes",
            "url": "https://sms4smile.com/quotes/",
            "publisher": {
                "@id": "https://sms4smile.com/quotes/#organization"
            }
        },
        {
            "@type": "Organization",
            "@id": "https://sms4smile.com/quotes/#organization",
            "name": "SMS4Smile Quotes",
            "url": "https://sms4smile.com/quotes/",
            "logo": {
                "@type": "ImageObject",
                "url": "https://sms4smile.com/quotes/wp-content/themes/sq/assets/icons/icon-512.png",
                "width": 512,
                "height": 512
            }
        }
    ]
}
```