# 9/2(四) 用技術寫作打造個人品牌時會遇到什麼狀況？

嗨，歡迎來到六角筆記王！

這邊想要再次恭喜大家，我們已經來到了活動的倒數第二週，**能撐到現在的你真的很棒！**

你除了寫程式以外，還可以大聲的說我正在往個人品牌的方向前進啦(๑•̀ㅁ•́๑)✧

今天我們要聊聊：**如果要靠技術寫作打造個人品牌的話，要避免哪一些地雷？**

學會與大眾溝通
---

身為初學 Vue 的小菜鳥，我必須得誠實的說，看了那麼多教學文章，怎麼這些開發者都寫的比官方文件難懂？

如果沒有辦法跳脫「工程思維」，使用通俗的語言寫作的話，我真的寧願嗑英文版的 MDN 都比較好懂一點。

所以今天要與大家分享，如果你嘗試以技術寫作吸引流量，當成未來求職的作品集的話，請注意**以下雷點不要踩：**

1. **不要自嗨**、寫一堆只有你自己知道的梗，讀者未必有興趣。
2. **寫作主題零散**，不曉得你這個人到底寫部落格要幹嘛，啊是寫日記嗎？
3. **流水帳文章**、不分段、不認真打標點符號，完全抓不到重點，看了一眼真的直接關掉視窗。

第二、三點的定義很好理解，那什麼是自嗨呢？

馬上來講一個小故事：

以前幫公司找系統工程師，於是我上了 LinkedIn 去瀏覽各式各樣的履歷，後來我看到一篇不得了的，眼球都快要噴出眼框，那位工程師是這麼寫自己自傳的：

「**我最欣賞的一位前輩是魔女少女奈葉**⋯⋯」開頭大概是長這樣，之後他很寫了一篇很長很長的文章，來讚賞魔法少女奈葉的堅毅性情。

其實看到這樣用很特殊梗的文章，通常會很吸人眼球，但通篇都這樣寫的話，會讓我去 Google 魔法少女奈葉，而不是找你來面試。

反正技術寫作的重點我已經跟你說很多次了：**聚焦問題、解決問題。**

簡單吧？

## 每日任務內容：

我猜有人寫到現在開始感到很疲勞、無奈了，反正你們已經了解本日精髓，今天就來閒聊吧：

請在任務回報區回報，閱讀文章的時候，**你最討厭看到什麼內容？如果可以的話希望筆者可以怎麼優化？**

## 任務回報區：

> 任務回報範例：
>
> **0. Vivian:**
> 我其實很討厭看到沒有同理心的內容，批評大家都會，但真正有意願解決問題的人少之又少，期望自己的文章可以解決問題，而不是造成問題。

**1. Blueberry:**
我偏格式方面，內容反倒還好～通常我只要看到半形標點符號，或是分段很混亂 (沒有分大標題、小標題，字全部擠在一起) 的文章，不管內容多優質，看沒幾秒就會關掉 XD
> [name=vivian1223] 對 XD 這一種我也會想要關掉

**2. Yunei:**
我是比較在意排版，點開的瞬間，一個心曠神怡、舒服的感覺迎面而來，就會想要繼續看下去，不過這蠻主觀，有些人就喜歡看密密麻麻的文章，會有一種自己學識淵博的感覺，但對我來說這類型文章會增加閱讀過程的難度，順便把耐心磨掉。
對了，我也去Google了魔法少女奈葉。🤣

**3. Rain Liao:**
* **文章的編排與美感**：我雖然做網頁設計做很久，但是對於這種==打字去編排文章==方式的呈現反而比較弱。因為很多繪圖軟題會很直覺性的移動位置，會是以整體的方向去調整，再去調整內部的細節。到現在我還會去參考之前板上參考的筆記大大們的範本比較自己的**差異性**，還有**不足**的地方，再去做調整。
* **求職目的的文章**：真的是要讓**業主看懂**，其實這有點像我們設計領域上的==作品集呈現==。主管跟老闆還有人資可能只會花幾秒的時間或幾分鐘內看完你的東西。我之前面試幾個設計師，就大概就是這樣子的方式去取捨。但是因為這裡是程式取向的文章，內容取向可能偏重**邏輯性與解決辦法**，可能寫法又會是不一樣。
* **流水帳文章**：這就是我為什麼寫想==懶人筆記==的原因，大部分的部落格呈現的文章都**太豐富**，**資料滿滿**。可是真的要找到文章的重點跟問題要花上**大半個時間**，發現解答也是讓新手看得很吃力。

**4. Gui:**
* 以前我很喜歡寫長篇大論文章，想要打造最豐富的「一篇」教學文章，讓新手只要閱讀一篇文章就能查到他喜歡的內容。
* 但後來想想是不是自以為新手很喜歡看怎麼樣的內容，但其實不是呢？
* 例如，我只是要看某一部分的資訊，但因為整篇文章太長，令人難以找尋...
* 我認為長篇大論好是因為我懂，但並不是所有人所需要的資訊都跟自己一樣。
* 後來想想，自己在利用 Google 找資料時，也有看到長篇大論找不到重點的感覺。
* 現在自己寫文章時，以切版直播班筆記為例，通常一堂課我會拆分成 1 ~ 4 篇，以系列文章下去撰寫，也能達到豐富、但同時讓讀者更容易找到想取得的資訊。

**5. Jane Lin:**
我閱讀技術文章的時候，目的有兩種。一種是學習技術，另一種是解決問題。
- 如果是學習技術，要是找到的文章寫得太簡潔、沒有說清楚來龍去派，或者沒有寫到那個點、寫得太難懂，我就得花時間找其他文章繼續閱讀。這種情況我會希望文章內容盡可能以通俗易懂的用字去詳盡說明，能舉例或配圖解釋、以表格整理更好，文長也無所謂，給我越多東西我越開心。只是這就很考驗筆者的功力，還有部落格的樣式、文字排版是否讓讀者覺得舒適耐看。
- 如果是解決問題，文章內容豐不豐富是其次，能解決我的困擾才是最重要的。這種情況我會希望文章能一針見血提供我解決問題的方案，甚至提供多個方案，讓我在第一個方案失敗之後還有其他方案可以嘗試。如果在解決問題的同時，文章中解釋了問題的成因，以及這些方案為什麼能解決這些問題，在我心裡也是大大加分的。

**6. Lou:** 看到很醜的斗大LOGO在最頂端，奇怪的斷行與擁擠的行距，我用500毫秒的速度迅速離開現場...
- 圖片的大小過大，容易醜
- 段落間請分得開一點
- 句子跟句子之間不要黏在一起

**7. yojanni :** 可能因為我是新手吧，比較喜歡的文章是偏一個主題而且還能夠再拆分小段落，每個小段都是一篇文章。不要一次把所有內容都放在同一篇文章比較好閱讀，不然文章太長看到後面其實有點累。而且閱讀拆成小段落的文章，讓新手的我閱讀完會有比較大的成就感 : )。

**8. Mao:**
這要看情況，跟 Jane Lin 的看法一樣
- 如果是要學習新技術的話，我會偏向寫得仔細的文章，把所有重要的知識點都寫出來，最近在學習 React Hook 和 React Redux，就有看到幾個非常讚的文章，而且還有附 Gif 動態圖，太用心優質了。
- 如果是一些簡單，但是忘記怎麼寫想上網查，就會想要簡單直擊重點就好了。

**9. WA:**
* 贅字，沒重點
* 內容農場文[註]
* 沒有分段落和標點符號

[註]內容農場文:是指為了牟取廣告費等商業利益或出於控制舆论、帶風向等特殊目的，快速生產大量網路文章來吸引流量的網站。

來源:[wiki](https://zh.wikipedia.org/wiki/%E5%85%A7%E5%AE%B9%E8%BE%B2%E5%A0%B4)