寫給想用圖解表達複雜概念的人 — 如何將複雜的事情用圖解表達清楚 ?

閱讀時間約 5 分鐘
知識圖解是一個非常實用的技能,但不是很好掌握。
在軟體業中,軟體架構師會用圖解表達系統之間的關聯,但傳統的軟體架構圖往往非常複雜,原本是要增進溝通效率,結果反而沒人看得懂。這篇文章分享由軟體架構師 Simon Brown 提出的 C4 模型,可以很好地讓圖解變的「見樹又見林」,最後我還會分享在軟體業之外的應用。
如果你是需要在工作場合中思考與溝通複雜事物的人,例如講師、產品規劃人員、工程師、設計師…等,就一起來看看這篇文章吧!

1. 架構的圖解好複雜怎麼辦?試試看 C4 模型

工程師喜歡用箭頭、框框來討論流程,因為清楚、簡單又好用。
然而到了討論後期,這些圖往往開始 “”長大,、最後大到已經不知道從哪裡看起的地步。例如一張軟體架構圖上將系統、伺服器、軟體、API、容器、元件…等細節一次呈現,結果只有畫圖的人自己看得懂。
怎麼辦呢?Simon Brown 提出了好解法-C4 模型。
圖片來源:The C4 Model for Software Architecture (infoq.com)

2. C4 模型的 4 個層級,由資訊顆粒度的粗細來區分

C4 Model 是由 Simon Brown 這位軟體架構師提出的圖解方法,他將一套系統的圖解分成 4 個層級,兼顧軟體架構的可讀性與完整性。
這4個層級依序由資訊顆粒度的大小來做區分,由大小依序是:
  • Level 1 : Context (上下文/脈絡)
  • Level 2:Containers (容器)
  • Level 3:Components (元件/組件)
  • Level 4:Code (程式碼)

Level 1 — Context

Context 是描述自家公司的「軟體系統」與「現實世界」的互動方式。
例如
  • 使用銀行軟體系統的使用者
  • 內部網路銀行系統
  • E-mail 系統
  • 銀行內部核心系統
圖片來源:The C4 Model for Software Architecture (infoq.com)

Level 2 — Containers

說明目標系統中的主要容器 (Containers) 組成。容器的例子有 :
  • Applications
  • client-side-single web page
  • server-side API application
  • data stores
  • microservices
圖片來源:The C4 Model for Software Architecture (infoq.com)

Level 3 — Components

元件(Components) 會直接對應到 1 組實際的抽象化程式碼 (例如登入相關的程式碼 — Sign-in controller)。
圖片來源:The C4 Model for Software Architecture (infoq.com)

Level 4 — Code

Code 是程式碼的實作細節,在圖解上會使用如 UML 表示程式 Class (類別) 的互動關係。

3. C4 模型帶給我的啟發,不只用在軟體、還能用在生活

C4 模型很像是看一張 Google Map,從大地圖開始、不斷 Zoom in 到一個國家的馬路上。
4 Level 只是一個概念,背後可學習的關鍵是:從大到小依序圖解。
例如我若要解說「從0到1寫出一篇文章」,可以圖解成:
  • Level 1 : 先畫出寫作的每個步驟,例如發想靈感 > 寫下草稿 > 編輯文章 > 發表文章 > 歸檔文章
  • Level 2:針對想要解說的步驟進行拆解。例如想解說「編輯文章」,我會拆成「編輯內文」、「製作文章封面」這2個模組。
  • Level 3:針對特定的模組再進行拆解,例如「製作文章封面」可以再拆解成「Unsplash (抓取免費圖片)」、「Keynote (製作封面)」
  • Level 4:最底層的細部操作,例如對於「Keynote」的操作可以「加入形狀」、「加入文字」、「加入遮罩」
透過 Zoom in,除了讓讀者可以了解每一層級該關注的內容外,也可以讓講者思考自己的工作流程是否有問題、有哪些可以優化的地方。

喜歡我的文章嗎?以下是更多關於我的資訊。
▶ 關於文章
1/ 歡迎 訂閱電子報 加入 700+ 學習愛好者的行列,每週 1 個學習行動建議!
2/ 常滑 Facebook 嗎?可以幫我的 Facebook 粉絲團 按個讚,就可以看到文章啦~
3/ 想要掌握最新文章,可以點擊「追蹤」我~
4/ 如果你覺得文章寫的不錯,可以對文章點愛心讓我知道 ❤️
▶ 關於我
Software Technical writer @ OwlTing 奧丁丁集團 我專注寫
1/ SaaS 軟體產品規劃
2/ 個人知識管理
3/ 線上寫作的文章
擁有 6+ 年的SaaS產品經理工作經驗,☕️ 歡迎講座邀約、諮詢或跟我喝杯咖啡聊聊天,我的信箱是 [email protected]
▶︎ 聯繫方式
• 📪 Email:[email protected]
• 💬 Facebook:請先加我 個人好友 並簡短說明想要諮詢的主題
▶︎ 建立人脈
歡迎使用 LinkedIn 與我交流,你可以「加我為好友」建立連結 | LinkedIn @ Chi Chu 歡迎交流
210會員
129內容數
分享學習相關的技巧、工具與方法
留言0
查看全部
發表第一個留言支持創作者!
朱騏的沙龍 的其他內容
這兩年網路上出現許多整理筆記的方式,讓人眼花撩亂。這麼多的筆記方法,每種整理方式想達到的目的都不同。礙於網路上的資訊太多太雜,許多人往往看到一個方法就直接使用,結果容易把自己的筆記庫弄的一團亂,最後只好放棄(然後重複這個循環)。這篇文章將分享 5 種筆記整理結構,分享給有需要的朋友。
這篇文章回答了從「卡片索引編號」延伸出來的 3 個問題:(1) 卡片索引是一種分類嗎?(2) 卡片如何命名?(3)卡片索引如何表達卡片之間的連結關係?簡單摘要答案就是:(1)卡片索引不是一種分類 (2) 卡片命名可以靠索引編號解決,因為它有「唯一性」(3)卡片索引可以寫成「索引筆記」,功能是紀錄思考
許多人使用卡片盒筆記法 的問題就是不知道如何連結卡片。連結卡片在「卡片盒筆記法」中太重要了,我們寫下的卡片若只是一個點、卡片連結的品質將決定我們後續產出成果的品質。為了搞清楚這個問題,我讀了2篇美國研究卡片盒專家的論文、1篇長達 7000字 的德國卡片盒論壇的文章。這篇文章討論我們該如何建立卡片連
作者申克博士(Sönke Ahrens) 在繁體版書籍線上交流講座中,分享 10 點使用卡片盒筆記法的重點原則,這篇文章摘要講座中 10 點原則的精華。有些內容翻成中文會失去脈絡,因此我在後面加上英文原文單字,並且加入一些個人理解的闡述。
在我分享多篇關於Obsidian與個人知識管理文章後,有許多人來信問我:「朱騏,我按照你的方法建立了名詞筆記與觀念筆記,一開始看到一個主題逐漸累積資料這種感覺蠻好的。但隨著時間增多,筆記連接已經多到爆炸啦!我到底要如何整理這些筆記呢?」這篇文章和你分享個人知識管理中的重要概念 - 母題
在前面的文章中,我提到4步驟整理讀書筆記、3步驟將讀書筆記寫成長文的方法,範圍都只侷限於單一文章/書籍的內容拆解與連結。這篇文章繼續延伸,談談拆分出去的觀念筆記要如何重複利用。我們要學習一個做筆記的新概念 — 加入Metadata 連結其他筆記。
這兩年網路上出現許多整理筆記的方式,讓人眼花撩亂。這麼多的筆記方法,每種整理方式想達到的目的都不同。礙於網路上的資訊太多太雜,許多人往往看到一個方法就直接使用,結果容易把自己的筆記庫弄的一團亂,最後只好放棄(然後重複這個循環)。這篇文章將分享 5 種筆記整理結構,分享給有需要的朋友。
這篇文章回答了從「卡片索引編號」延伸出來的 3 個問題:(1) 卡片索引是一種分類嗎?(2) 卡片如何命名?(3)卡片索引如何表達卡片之間的連結關係?簡單摘要答案就是:(1)卡片索引不是一種分類 (2) 卡片命名可以靠索引編號解決,因為它有「唯一性」(3)卡片索引可以寫成「索引筆記」,功能是紀錄思考
許多人使用卡片盒筆記法 的問題就是不知道如何連結卡片。連結卡片在「卡片盒筆記法」中太重要了,我們寫下的卡片若只是一個點、卡片連結的品質將決定我們後續產出成果的品質。為了搞清楚這個問題,我讀了2篇美國研究卡片盒專家的論文、1篇長達 7000字 的德國卡片盒論壇的文章。這篇文章討論我們該如何建立卡片連
作者申克博士(Sönke Ahrens) 在繁體版書籍線上交流講座中,分享 10 點使用卡片盒筆記法的重點原則,這篇文章摘要講座中 10 點原則的精華。有些內容翻成中文會失去脈絡,因此我在後面加上英文原文單字,並且加入一些個人理解的闡述。
在我分享多篇關於Obsidian與個人知識管理文章後,有許多人來信問我:「朱騏,我按照你的方法建立了名詞筆記與觀念筆記,一開始看到一個主題逐漸累積資料這種感覺蠻好的。但隨著時間增多,筆記連接已經多到爆炸啦!我到底要如何整理這些筆記呢?」這篇文章和你分享個人知識管理中的重要概念 - 母題
在前面的文章中,我提到4步驟整理讀書筆記、3步驟將讀書筆記寫成長文的方法,範圍都只侷限於單一文章/書籍的內容拆解與連結。這篇文章繼續延伸,談談拆分出去的觀念筆記要如何重複利用。我們要學習一個做筆記的新概念 — 加入Metadata 連結其他筆記。
你可能也想看
Google News 追蹤
Thumbnail
接下來第二部分我們持續討論美國總統大選如何佈局, 以及選前一週到年底的操作策略建議 分析兩位候選人政策利多/ 利空的板塊和股票
Thumbnail
🤔為什麼團長的能力是死亡筆記本? 🤔為什麼像是死亡筆記本呢? 🤨作者巧思-讓妮翁死亡合理的幾個伏筆
Thumbnail
雖說很多事看起來「真的是基礎」,但總是會被忽略!這些事不是擺爛覺得不用講、不需要要求、反正做得出來就不用學新的東西⋯⋯為什麼多數人寧可用錯的方法、花很多時間在那些明明有更好的方法「做得出來就好了」的工作模式裡?而不想要花多一點時間學習和溝通好工作的流程?
Thumbnail
《分享》2024年巴菲特寫給股東的信 By 切老 在2月24日巴菲特又如過去47年一樣,發佈了他「寫給波克夏股東的信」。自1977年開始,他就沒有停止過這項工作,彰顯了他對股東們開誠布公,與負責任的態度。身為巴菲特的忠誠信徒,每年都會仔細咀嚼這封長信,在文字間享受他的睿智 績優股鈊象的千金之謎…
Thumbnail
記得有一次接女兒放學過後到附近的公園玩耍,途中有一位女同學帶著一隻洋娃娃前來,沒多久被男同學接手把玩。此時,男同學的阿嬤焦急地大喊:「男生不要拿女生玩的娃娃啦!這樣不好看!」 我聽聞隨即告訴阿嬤:「其實娃娃不分男女都可以玩呀!就像是顏色本身也沒有性別之分⋯⋯。」我就這樣一路講到同婚的議題,
Thumbnail
       小時候父母親總是說要好好讀書,才能找到好的工作,當時筆者問父母親說:「賣蔬菜是不好的工作嗎?」 父親說:「賣蔬菜是我喜歡的工作,好好讀書可幫助你了解自己喜歡什麼工作?」 培養閱讀的動機        今年筆者參加了「書店老闆」第二季的讀書會,第一場讀書會為《我們為什麼要讀書
Thumbnail
故事就發生在茱麗葉的家鄉,浪漫古城義大利的「維洛納」,傳統的地中海氣候,這時應該正值乾季,石砌的房舍、哥德式的建物,眼底都是充滿熱情的橘黃色調,好像到處都飄著麵包和葡萄酒的香氣。所謂的「故鄉」、「茱麗葉的家」,其實是這座城市的包裝,覆上一層經典愛情故事的濾鏡,給了旅人們心生嚮往的理由。
Thumbnail
久違的戀上第九集心得!這次依然也是聚焦在看到的人際關係與交流中的技巧與議題,非想給大家!
Thumbnail
這本《高產出的本事》就是本教你有效率地產出優質內容的好書。如果你常煩腦無法清楚向他人傳達自己的概念,或開會報告總被老闆嫌沒邏輯、沒說服力,那這本書會非常適合你;如果你是內容創作者,有經營部落格或粉專,那本書更是值得細品。
Thumbnail
劇情長片《陽光普照》2019年在台灣上映後佳評如潮,電影中探討許多發人深省的議題,不但獲得金馬獎多項獎項肯定,也在第93屆奧斯卡進入最佳國際電影初選15強,直至今日仍是觀眾願意一再回味的經典之作,而該片的成功也與演員精湛表現有著正相關,在電影當中飾演阿和未婚妻小玉的吳岱凌,在出現的場次中表現令人印象
Thumbnail
接下來第二部分我們持續討論美國總統大選如何佈局, 以及選前一週到年底的操作策略建議 分析兩位候選人政策利多/ 利空的板塊和股票
Thumbnail
🤔為什麼團長的能力是死亡筆記本? 🤔為什麼像是死亡筆記本呢? 🤨作者巧思-讓妮翁死亡合理的幾個伏筆
Thumbnail
雖說很多事看起來「真的是基礎」,但總是會被忽略!這些事不是擺爛覺得不用講、不需要要求、反正做得出來就不用學新的東西⋯⋯為什麼多數人寧可用錯的方法、花很多時間在那些明明有更好的方法「做得出來就好了」的工作模式裡?而不想要花多一點時間學習和溝通好工作的流程?
Thumbnail
《分享》2024年巴菲特寫給股東的信 By 切老 在2月24日巴菲特又如過去47年一樣,發佈了他「寫給波克夏股東的信」。自1977年開始,他就沒有停止過這項工作,彰顯了他對股東們開誠布公,與負責任的態度。身為巴菲特的忠誠信徒,每年都會仔細咀嚼這封長信,在文字間享受他的睿智 績優股鈊象的千金之謎…
Thumbnail
記得有一次接女兒放學過後到附近的公園玩耍,途中有一位女同學帶著一隻洋娃娃前來,沒多久被男同學接手把玩。此時,男同學的阿嬤焦急地大喊:「男生不要拿女生玩的娃娃啦!這樣不好看!」 我聽聞隨即告訴阿嬤:「其實娃娃不分男女都可以玩呀!就像是顏色本身也沒有性別之分⋯⋯。」我就這樣一路講到同婚的議題,
Thumbnail
       小時候父母親總是說要好好讀書,才能找到好的工作,當時筆者問父母親說:「賣蔬菜是不好的工作嗎?」 父親說:「賣蔬菜是我喜歡的工作,好好讀書可幫助你了解自己喜歡什麼工作?」 培養閱讀的動機        今年筆者參加了「書店老闆」第二季的讀書會,第一場讀書會為《我們為什麼要讀書
Thumbnail
故事就發生在茱麗葉的家鄉,浪漫古城義大利的「維洛納」,傳統的地中海氣候,這時應該正值乾季,石砌的房舍、哥德式的建物,眼底都是充滿熱情的橘黃色調,好像到處都飄著麵包和葡萄酒的香氣。所謂的「故鄉」、「茱麗葉的家」,其實是這座城市的包裝,覆上一層經典愛情故事的濾鏡,給了旅人們心生嚮往的理由。
Thumbnail
久違的戀上第九集心得!這次依然也是聚焦在看到的人際關係與交流中的技巧與議題,非想給大家!
Thumbnail
這本《高產出的本事》就是本教你有效率地產出優質內容的好書。如果你常煩腦無法清楚向他人傳達自己的概念,或開會報告總被老闆嫌沒邏輯、沒說服力,那這本書會非常適合你;如果你是內容創作者,有經營部落格或粉專,那本書更是值得細品。
Thumbnail
劇情長片《陽光普照》2019年在台灣上映後佳評如潮,電影中探討許多發人深省的議題,不但獲得金馬獎多項獎項肯定,也在第93屆奧斯卡進入最佳國際電影初選15強,直至今日仍是觀眾願意一再回味的經典之作,而該片的成功也與演員精湛表現有著正相關,在電影當中飾演阿和未婚妻小玉的吳岱凌,在出現的場次中表現令人印象