---
title: "Meaning & Key Takeaway of: All joking aside, these diagrams do…"
description: "\"“All joking aside, these diagrams do suffer from one or more of the following problems: • Notation (e.g. colour coding, shapes, etc) is not explained o..."
image: "https://sms4smile.com/quotes/i/b76/simon-brown-68916_diagrams_all-joking-aside-these-diagrams-do-suffe_2731901.jpg"
---

#  All joking aside, these diagrams do suffer from one or…

![“All joking aside, these diagrams do suffer from one or more of the following problems: • Notation (e.g. colour coding, shapes, etc) is not explained or is inconsistent. • The purpose and meaning of elements is ambiguous. • Relationships between elements are missing or ambiguous. • Generic terms…” quote by Simon Brown](https://sms4smile.com/quotes/i/b76/simon-brown-68916_diagrams_all-joking-aside-these-diagrams-do-suffe_2731901.jpg)   [Download](https://sms4smile.com/quotes/i/b76/simon-brown-68916_diagrams_all-joking-aside-these-diagrams-do-suffe_2731901.jpg) [Open image](https://sms4smile.com/quotes/i/b76/simon-brown-68916_diagrams_all-joking-aside-these-diagrams-do-suffe_2731901.jpg)

> ““All joking aside, these diagrams do suffer from one or more of the following problems: • Notation (e.g. colour coding, shapes, etc) is not explained or is inconsistent. • The purpose and meaning of elements is ambiguous. • Relationships between elements are missing or ambiguous. • Generic terms such as “business logic” are used. • Technology choices (or options, if doing up front design) are omitted. • Levels of abstraction are mixed. • Too much or too little detail. • No context or a logical starting point.””

Simon Brown

## About This Quote

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

Effective diagrams must be clear, consistent, and purposeful, avoiding ambiguous symbols, mixed abstractions, and missing context.

**In simple terms:** Clear, purposeful diagrams matter.

Key Takeaway

Create diagrams with consistent notation and context.

Themes

communication design visualization

Mood

analytical practical

Type

technical educational

When to use this quote

- software architecture
- project planning
- team workshops

Key Concepts

clarity abstraction contextual relevance

Questions to Reflect On

- How can you simplify diagrams for non‑technical stakeholders?
- What symbols best convey your design intent?

A Different Perspective

Complexity can still overwhelm without proper audience framing.

★ ★ ★ ★ ★   No ratings yet

[Programming](https://sms4smile.com/quotes/about/programming/) [Starting point](https://sms4smile.com/quotes/about/starting-point/)

## Related quotes

> [I admit that these terms and the diagrams connected with them repel some readers, and fill others with the vain imagination that they have…](https://sms4smile.com/quotes/alfred-marshall/i-admit-that-these-terms-and-the-diagrams-connected-with-them-repel/)

[Alfred Marshall](https://sms4smile.com/quotes/author/alfred-marshall/)

> [My whole background is character acting: weird costumes, fat suits, playing men, playing animals - I've never played anyone with whom there's any overlapping…](https://sms4smile.com/quotes/allison-williams/my-whole-background-is-character-acting-weird-costumes-fat-suits/)

[Allison Williams](https://sms4smile.com/quotes/author/allison-williams/)

> [Make no little plans. They have no magic to stir one's blood and probably themselves will not be realized. Make big plans; aim high…](https://sms4smile.com/quotes/daniel-burnham/make-no-little-plans-they-have-no-magic-to-stir-one-s-blood-and/)

[Daniel Burnham](https://sms4smile.com/quotes/author/daniel-burnham/)

> [If you can describe clearly without a diagram the proper way of making this or that knot, then you are a master of the…](https://sms4smile.com/quotes/hilaire-belloc/if-you-can-describe-clearly-without-a-diagram-the-proper-way-of/)

[Hilaire Belloc](https://sms4smile.com/quotes/author/hilaire-belloc/)

> [All that you need in the way of technique for drawing is bound up in the technique of seeing - that is, of understanding,…](https://sms4smile.com/quotes/kimon-nicolaides/all-that-you-need-in-the-way-of-technique-for-drawing-is-bound-up-in/)

[Kimon Nicolaides](https://sms4smile.com/quotes/author/kimon-nicolaides/)

> [More than anything, the journal wanted. It wanted more than it could hold, more than words could describe, more than diagrams could illustrate. Longing…](https://sms4smile.com/quotes/maggie-stiefvater/more-than-anything-the-journal-wanted-it-wanted-more-than-it-could/)

[Maggie Stiefvater](https://sms4smile.com/quotes/author/maggie-stiefvater/)

> [Just as a chemist "isolates" a substance from contaminations that distort his view of its nature and effects, so the work of art purifies…](https://sms4smile.com/quotes/rudolf-arnheim/just-as-a-chemist-isolates-a-substance-from-contaminations-that/)

[Rudolf Arnheim](https://sms4smile.com/quotes/author/rudolf-arnheim/)

> [I don't see how it's doing society any good to have so many members walking around with vague memories of algebraic formulas and geometric…](https://sms4smile.com/quotes/paul-lockhart/i-don-t-see-how-it-s-doing-society-any-good-to-have-so-many-members/)

[Paul Lockhart](https://sms4smile.com/quotes/author/paul-lockhart/)

> [Some people really live and work within the same doctrine, the same diagram with the same logic.](https://sms4smile.com/quotes/zaha-hadid/some-people-really-live-and-work-within-the-same-doctrine-the-same/)

[Zaha Hadid](https://sms4smile.com/quotes/author/zaha-hadid/)

> [Still, this whole grim reaper thing should have come with a manual. Or a diagram of some kind. A flowchart would have been nice.](https://sms4smile.com/quotes/darynda-jones/still-this-whole-grim-reaper-thing-should-have-come-with-a-manual-or/)

[Darynda Jones](https://sms4smile.com/quotes/author/darynda-jones/)

> [You can see from a flow diagram who depends on you and whom you can depend on. You can now take joy in your…](https://sms4smile.com/quotes/w-edwards-deming/you-can-see-from-a-flow-diagram-who-depends-on-you-and-whom-you-can/)

[W. Edwards Deming](https://sms4smile.com/quotes/author/w-edwards-deming/)

> [In mysticism that love of truth which we saw as the beginning of all philosophy leaves the merely intellectual sphere, and takes on the…](https://sms4smile.com/quotes/evelyn-underhill/in-mysticism-that-love-of-truth-which-we-saw-as-the-beginning-of-all/)

[Evelyn Underhill](https://sms4smile.com/quotes/author/evelyn-underhill/)

> [What fabrications they are, mothers. Scarecrows, wax dolls for us to stick pins into, crude diagrams. We deny them an existence of their own,…](https://sms4smile.com/quotes/margaret-atwood/what-fabrications-they-are-mothers-scarecrows-wax-dolls-for-us-to/)

[Margaret Atwood](https://sms4smile.com/quotes/author/margaret-atwood/)

> [I see my self-identity in the same way I see most things: a list, in greatest to least importance. I've found I can't use…](https://sms4smile.com/quotes/stephanie-land/i-see-my-self-identity-in-the-same-way-i-see-most-things-a-list-in/)

[Stephanie Land](https://sms4smile.com/quotes/author/stephanie-land/)

> [I really see no harm which can come of giving our children a little knowledge of physiology. ... The instruction must be real, based…](https://sms4smile.com/quotes/thomas-huxley/i-really-see-no-harm-which-can-come-of-giving-our-children-a-little/)

[Thomas Huxley](https://sms4smile.com/quotes/author/thomas-huxley/)

## More by Simon Brown

> [“unlike the building industry, the software development industry lacks a standard, consistent way to think about, describe and visually communicate software architecture”](https://sms4smile.com/quotes/simon-brown/unlike-the-building-industry-the-software-development-industry-lacks/)

Simon Brown

> [“colour coding to decipher. Can you work out what the colour coding means? Is it related to input vs output functions? Or perhaps it’s…](https://sms4smile.com/quotes/simon-brown/colour-coding-to-decipher-can-you-work-out-what-the-colour-coding/)

Simon Brown

> [“Any narrative should complement the diagram rather than explain it.”](https://sms4smile.com/quotes/simon-brown/any-narrative-should-complement-the-diagram-rather-than-explain-it/)

Simon Brown

Explore all 4 Simon Brown quotes

## More Diagrams quotes

> [I admit that these terms and the diagrams connected with them repel some readers, and fill others with the vain imagination that they have…](https://sms4smile.com/quotes/alfred-marshall/i-admit-that-these-terms-and-the-diagrams-connected-with-them-repel/)

[Alfred Marshall](https://sms4smile.com/quotes/author/alfred-marshall/)

> [I see my self-identity in the same way I see most things: a list, in greatest to least importance. I've found I can't use…](https://sms4smile.com/quotes/stephanie-land/i-see-my-self-identity-in-the-same-way-i-see-most-things-a-list-in/)

[Stephanie Land](https://sms4smile.com/quotes/author/stephanie-land/)

> [What fabrications they are, mothers. Scarecrows, wax dolls for us to stick pins into, crude diagrams. We deny them an existence of their own,…](https://sms4smile.com/quotes/margaret-atwood/what-fabrications-they-are-mothers-scarecrows-wax-dolls-for-us-to/)

[Margaret Atwood](https://sms4smile.com/quotes/author/margaret-atwood/)

> [In mysticism that love of truth which we saw as the beginning of all philosophy leaves the merely intellectual sphere, and takes on the…](https://sms4smile.com/quotes/evelyn-underhill/in-mysticism-that-love-of-truth-which-we-saw-as-the-beginning-of-all/)

[Evelyn Underhill](https://sms4smile.com/quotes/author/evelyn-underhill/)

> [You can see from a flow diagram who depends on you and whom you can depend on. You can now take joy in your…](https://sms4smile.com/quotes/w-edwards-deming/you-can-see-from-a-flow-diagram-who-depends-on-you-and-whom-you-can/)

[W. Edwards Deming](https://sms4smile.com/quotes/author/w-edwards-deming/)

> [Still, this whole grim reaper thing should have come with a manual. Or a diagram of some kind. A flowchart would have been nice.](https://sms4smile.com/quotes/darynda-jones/still-this-whole-grim-reaper-thing-should-have-come-with-a-manual-or/)

[Darynda Jones](https://sms4smile.com/quotes/author/darynda-jones/)

> [Some people really live and work within the same doctrine, the same diagram with the same logic.](https://sms4smile.com/quotes/zaha-hadid/some-people-really-live-and-work-within-the-same-doctrine-the-same/)

[Zaha Hadid](https://sms4smile.com/quotes/author/zaha-hadid/)

> [I don't see how it's doing society any good to have so many members walking around with vague memories of algebraic formulas and geometric…](https://sms4smile.com/quotes/paul-lockhart/i-don-t-see-how-it-s-doing-society-any-good-to-have-so-many-members/)

[Paul Lockhart](https://sms4smile.com/quotes/author/paul-lockhart/)

> [Just as a chemist "isolates" a substance from contaminations that distort his view of its nature and effects, so the work of art purifies…](https://sms4smile.com/quotes/rudolf-arnheim/just-as-a-chemist-isolates-a-substance-from-contaminations-that/)

[Rudolf Arnheim](https://sms4smile.com/quotes/author/rudolf-arnheim/)

> [More than anything, the journal wanted. It wanted more than it could hold, more than words could describe, more than diagrams could illustrate. Longing…](https://sms4smile.com/quotes/maggie-stiefvater/more-than-anything-the-journal-wanted-it-wanted-more-than-it-could/)

[Maggie Stiefvater](https://sms4smile.com/quotes/author/maggie-stiefvater/)

> [All that you need in the way of technique for drawing is bound up in the technique of seeing - that is, of understanding,…](https://sms4smile.com/quotes/kimon-nicolaides/all-that-you-need-in-the-way-of-technique-for-drawing-is-bound-up-in/)

[Kimon Nicolaides](https://sms4smile.com/quotes/author/kimon-nicolaides/)

> [If you can describe clearly without a diagram the proper way of making this or that knot, then you are a master of the…](https://sms4smile.com/quotes/hilaire-belloc/if-you-can-describe-clearly-without-a-diagram-the-proper-way-of/)

[Hilaire Belloc](https://sms4smile.com/quotes/author/hilaire-belloc/)

> [Make no little plans. They have no magic to stir one's blood and probably themselves will not be realized. Make big plans; aim high…](https://sms4smile.com/quotes/daniel-burnham/make-no-little-plans-they-have-no-magic-to-stir-one-s-blood-and/)

[Daniel Burnham](https://sms4smile.com/quotes/author/daniel-burnham/)

> [My whole background is character acting: weird costumes, fat suits, playing men, playing animals - I've never played anyone with whom there's any overlapping…](https://sms4smile.com/quotes/allison-williams/my-whole-background-is-character-acting-weird-costumes-fat-suits/)

[Allison Williams](https://sms4smile.com/quotes/author/allison-williams/)

> [I really see no harm which can come of giving our children a little knowledge of physiology. ... The instruction must be real, based…](https://sms4smile.com/quotes/thomas-huxley/i-really-see-no-harm-which-can-come-of-giving-our-children-a-little/)

[Thomas Huxley](https://sms4smile.com/quotes/author/thomas-huxley/)

Browse all 71 Diagrams quotes

```json
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Quotation",
            "text": "“All joking aside, these diagrams do suffer from one or more of the following problems: • Notation (e.g. colour coding, shapes, etc) is not explained or is inconsistent. • The purpose and meaning of elements is ambiguous. • Relationships between elements are missing or ambiguous. • Generic terms such as “business logic” are used. • Technology choices (or options, if doing up front design) are omitted. • Levels of abstraction are mixed. • Too much or too little detail. • No context or a logical starting point.”",
            "creator": {
                "@type": "Person",
                "name": "Simon Brown"
            },
            "isPartOf": {
                "@id": "https://sms4smile.com/quotes/#website"
            },
            "url": "https://sms4smile.com/quotes/simon-brown/all-joking-aside-these-diagrams-do-suffer-from-one-or-more-of-the/",
            "about": {
                "@type": "Thing",
                "name": "Diagrams"
            },
            "@id": "https://sms4smile.com/quotes/simon-brown/all-joking-aside-these-diagrams-do-suffer-from-one-or-more-of-the/#quotation",
            "image": {
                "@type": "ImageObject",
                "@id": "https://sms4smile.com/quotes/i/b76/simon-brown-68916_diagrams_all-joking-aside-these-diagrams-do-suffe_2731901.jpg",
                "contentUrl": "https://sms4smile.com/quotes/i/b76/simon-brown-68916_diagrams_all-joking-aside-these-diagrams-do-suffe_2731901.jpg",
                "url": "https://sms4smile.com/quotes/i/b76/simon-brown-68916_diagrams_all-joking-aside-these-diagrams-do-suffe_2731901.jpg",
                "width": 1080,
                "height": 1080,
                "caption": "“All joking aside, these diagrams do suffer from one or more of the following problems: • Notation (e.g…” — Simon Brown",
                "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": "Simon Brown",
                    "item": "https://sms4smile.com/quotes/author/simon-brown/"
                },
                {
                    "@type": "ListItem",
                    "position": 4,
                    "name": "“All joking aside, these diagrams do...",
                    "item": "https://sms4smile.com/quotes/simon-brown/all-joking-aside-these-diagrams-do-suffer-from-one-or-more-of-the/"
                }
            ],
            "@id": "https://sms4smile.com/quotes/simon-brown/all-joking-aside-these-diagrams-do-suffer-from-one-or-more-of-the/#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
            }
        }
    ]
}
```
