Skip to main content

前言

啟發自码农高天的 Git 教學,被他淺顯易懂的說明驚訝到,並且深刻感受到繁體中文教學實在很差勁,於是決定自己寫,試圖解決我在學習 Git 時發現的問題1

  1. 沒搞清楚受眾
  2. 只介紹指令
  3. 過於細節
  4. 自創名詞
  5. 近況聊天等等無關緊要的廢話太多
  6. 放一堆 commit hash 和擷圖看的眼花撩亂
  7. 文章過長消耗耐心或是過短頻繁換頁
  8. 沒有 ToC 目錄根本不知道自己讀到哪
  9. 沒寫完的系列文章
  10. 甚至連內容都是錯的

網路上簡單搜尋一下就可以發現很多文章都或多或少都有這些問題。除此之外,我注意到初學者常見的問題是明明問題只需要一行指令就可解決,卻要在網路上過濾數篇文章非常浪費時間,所以本教學以這個邏輯完成:先學基本操作,再學進階操作,先有狀況情境,再學使用方式

我的想法是對於一個工具,使用者只要知道工具的目的以及如何使用,不必知道工具是怎麼做出來的,學會基本使用方式再去了解延伸功能,這才是正確的使用方式,而不是一開始就要學原理卻不會用(過於細節),或是直接丟給讀者兩百頁使用說明卻不知道該從哪裡讀起(只介紹指令),或者學的東西到其他地方看卻發現不一樣(自創名詞)。為了解決以上問題,本系列文章

  1. 受眾是 Git 零經驗初學者
  2. 可應付絕大多數日常問題,並且編排方式著重方便查找問題
  3. 依照使用順序依序撰寫,目標是讓人最快上手的教學

文章依序以個人使用、修改提交歷史、個人遠端使用、團隊使用介紹,除了以使用情境為主軸介紹以外,撰寫時依據使用官方翻譯而不是自己造詞。

Footnotes

  1. 基本上大多數的文章都會落入其中一項,除了第一項只是不熟悉寫作以外,問題 2~4 是非常糟糕的文章,這種類型的文章是寫身體健康不是寫來讓別人看懂的,尤其是第四點我深惡痛絕,初學者學完還要花時間驗證自己讀的名詞到底哪個才是對的;5~7 也是很嚴重的問題,我不想知道你最近發生什麼事工作上遇到什麼問題,我只想快點找到我的狀況是否符合這個問題並且解決,而且放一堆 hash 截圖導致文章又臭又長,閱讀還要對照 hash 是一件非常愚蠢的事;8~9 就不能怪作者但如果能改善的話那當然最好。