如何寫出好的教學？

教學性質的文章我是都張貼在其他地方，但其實到後來也越來越懶得寫了。

這篇，應該算是到目前為止的一個心得總結而已，其實我心裡也是還有很多問號的。

教文章的目的就是引導讀者去瞭解一樣事物或技術，一開始你必須先設定一下心中的讀者，否則寫出來的文章很可能是「程度高的人不屑看；程度低的人看不懂」這種情況。

首先複習一下一句老話：「文不如表，表不如圖。」意思就是說對讀者而言，圖片式的解說比表格更容易理解；而表格式的解說又比文字式的更容易理解。

雖說如此，但很多教學其實還是以文字為主，這是因為無論是圖片或是表格處理起來都較為麻煩，對寫作者的困擾也比較多，除了一些比較好心(也可以說比較笨，網路上許多教學都是義務性質，花比較多時間是在燃燒自己而已)的作者外──其實純文字才是主力。

本文主要是論述網路上流傳的教學，網路上圖片教學終究是少數，這是為什麼呢？我個人先就自身經驗講一下以圖片為主力的教學，會遇到哪些狀況好了：

1.優良的圖片空間難找。

圖片的讀取較文字比起來需要更大更順暢的空間，這些優良的空間在網路上是很少的，如果是免費的圖檔空間往往代表不穩定、傳輸速度慢；如果是付費空間，就代表除了寫作、拍圖、上傳的心力外，作者必須再負擔空間的費用。而有些圖檔空間有流量的限制，如果被人盜連那麼流量很快就用完了，這時被讀者嫌棄圖片開不出來是常有的事。

2.處理的時間太長。

圖片拍下來還必須有一些處理，例如裁剪、轉檔、更名，教學用的圖檔數量都不少，如果不做一些處理會在實際敘述時產生很多不必要的麻煩。

3.文章的編輯麻煩。

一些地方圖片張貼時有一些語法存在，這裡不贅述。只貼一兩張圖是還好，但如果你一次要貼出10幾張圖片呢？這編輯就傷腦筋了，你必須一一確認順序看看有沒有出錯。我個人是習慣圖片下還要再加一些解說，那編輯起來就更麻煩嘍。

當然，你可以直接用影像編輯軟體在圖片中加字敘述，但如果需要敘述的量多時，這不是一個好辦法。

另外也可以將圖檔轉成GIF製作成單張的動畫，但檔案大小與畫面品質及圖檔空間的限制要注意一下。

4.修正的困難度較高。

簡易來說，事後發現漏拍或拍錯了一張圖要怎麼解決呢？這抽換或增修工程我就不贅述了。

以上的麻煩也有一個替代的方式，就是拍成影像檔然後你自己獻聲指導，不過這還會有其他的麻煩存在。其實稍微想一下就應該知道，技術門檻高、硬體門檻高、網路空間門檻高、修正困難度更高，這方式不適合一般人使用。

綜合以上所言，我個人認為以圖片為主力的教學是件吃力不討好的事，但教學效果來說是很不錯的，他可以輕易的帶領讀者一步一步的去完成某些事物，比方說軟體設定與使用、系統教學等等，如果是一些比較抽象的東西必須要自己動手畫出來那就更是浩大的工程。

而以文字為主的教學又會碰到什麼樣的難題呢？

1.敘述困難。
2.文字精確度掌握。
3.文字長度掌握。
4.通俗與專業的拿捏。
5.要不要把讀者當笨蛋。

有些觀念或步驟其實是很難用文字敘述，純文字教學最容易遇到的困難就是「我要怎麼把我腦海中看到的東西圖像化後再文字化？」當然這個不太好舉例，通常有這疑問的部份往往是在比較偏離生活常識的部份。比方說，我說這是一把菜刀，家家戶戶都有菜刀，你可以很輕易的就知道菜刀大致的樣子與功能；新聞報導說有人持西瓜刀砍人！你就算不知道西瓜刀長怎樣，在日常生活中也多少有被利器劃傷的經驗，那麼你也可以想像被砍大概是怎樣的痛苦。

那如果我今天是在描述骨材的篩分析呢？把取得之骨材，放進搖篩機中，試驗完畢後將每一號篩中的試體取出秤重，並將數據記錄之後完成粒徑分怖曲線。

什麼是骨材？什麼是搖篩機？什麼是粒徑分怖曲線？

當然上頭篩分析的例子不盡理想，為什麼？因為其實我設定就是讀土木的人才看得懂，有些東西翻課本或問老師都非常清楚，但如果我今天設定的東西是要給初學者或不是那麼清楚的人看，那麼這段描述就顯然不夠了，我可能還要說一下這動作的目的與意義，還必須解釋一下一些名詞。

許多教學在讀者設定這部份都滿糟糕的，有些更顯然是把讀者設定在跟他們差不多的水準，一些細節沒有去注意的話是對讀者沒有什麼幫助的。

隨著你設定的不同，你就必須去調整這五點的輕重。

有些的論述是讀者本身就有義務自學，而不是凡事都要靠別人解說，這部份我其實也很贊同，而這也是每個作者自由心證的部份。我個人最佩服的是能夠讓一般人也瞭解專業知識與技能的文章，這需要非常大的耐心與毅力，如果是技職體系或大學系所的學生，可以試著拿起你的專業課本，隨便翻開一個章節，接著讓一個完全不懂的人瞭解這一章節在講什麼。

你必須花很多時間在比喻、描述與試著讓對方產生想像上，對你來說可能很直覺的認為A=B、B=C，所以直接就講出A=C的論述，但聽的人會覺得莫名其妙，為什麼A會等於C呢？更慘的情況是你因為A=C太簡單就跳過直接進行下一步，他連A=C都沒辦法硬記死背下來。

設定讀者其實是最關鍵與最困難的地方，當你能想像出讀者大概是什麼樣的人後，自然而然的你會去思考「這樣寫好不好？」，而不僅僅是「這樣寫對不對？」。

所以有時候我會先在開頭請那些高手直接離開，因為這根本不是要寫給他們看的東西，讀者程度如果顯然在文章之上，看完只會有幾個感覺：講太少、贅述太多、用詞不夠精準。

這時候有一個問題產生了，我可不可以說「看不懂是你家的事」？然後採用最精準的描述與辭彙？可以，當然沒問題，這時候是你把設定的讀者水準調高了，也就是說初學者不在你的眼光之中。我個人認為這是最省事省時的寫法了，其實本來一些細微末節作者是沒有責任帶讀者一一去瞭解的，好心一點的會請讀者先去充實一下基本知識，更直接一點就是硬上直接來，不懂？這就真的是你家的事了。


其實教學應該因不同題材與目的調整手法與表現方式，而先一步設定好讀者更是重要的，不要在一群沒有相關背景的人中說出太深入的東西，因為他們連A=C都沒有機會硬背死記又怎能瞭解你說的東西呢？要就是一步步帶著他們進入；要不就是不要理會等到有人有興趣再談。

當然，我也看過不少驕傲的作者，但其實這部份是個人選擇，他們的驕傲是有本錢的，這些東西是他們一步一步得來的，說真的──肯說個一兩句就算不錯了。

但如果你是想分享、帶領更多人進入你喜歡的世界，就得小心不要成為那些驕傲的人了，因為這樣的教學是沒有太大幫助的。

記住一句話「術業有專攻」，每個人一生中都有許多機會遇到許多驕傲的作者，而做一個讀者只需要記得一件事，就是問自己「我是不是他心目中的讀者？」

最後，猜猜看本篇心目中的讀者是什麼樣子呢？