你好，我是A11y新手村的Sam Sam！新年將至，預祝大家新年快樂🎉
今天帶來的是A11y新手村的賀歲新年篇，不聊 Accessibility，聊聊我們團隊在寫了半年文章之後的一些心得，希望能給想要寫知識型文章的人一點靈感。
這邊知識型文章的意思是，寫作者想要透過總結並分享自己的經驗、學習思考、筆記或想法來創造價值。例如在社群中知名的AAPD、產品三眼怪，都有許多讓我們成員學習良多的好文章。
A11y新手村也致力於分享網路無障礙相關的知識，如《表單錯誤訊息設計❷：註冊表單交互case study》和《巧用 tabindex 讓你的 UI 更鍵盤友善》等面向設計師或工程師的原創文章。
看到這裡，你可能會想：「大過年的，為什麼我非得要寫文章不可呢？」
有人說過「寫作是最好的自我投資」，而實際上開始規律寫作之後，我個人也感受到這是一個受益無窮的技能。最直接的好處例如可以在整理自己的作品集時更清晰。如果建立長期寫作習慣，也可以建立自己的個人專業品牌。
即便沒有上述的需求，定期整理自己的所思所想並試著分享，其實也是能夠整理自己思緒，訓練自己邏輯思考與表達能力的好方法。
但是其實我們大多數的成員也都在創立新手村之前沒有寫過文章，很多時候也都是一邊寫一邊摸索。比起成功經驗的分享，本文更像是總結我們反覆討論之後總結認為寫好一篇的知識型文章的要點是什麼的心得分享，希望能夠給對於分享自己經驗與知識有興趣的人參考。
本篇文章內容比較多，句句充滿我們團隊討論文字到三更半夜的血淚精華(?)，建議書籤起來，隨時觀看🔖
題外話，我其實沒有開過手搖店，但在寫這篇文章的途中，我也發現寫文章跟開手搖店與開發飲品的邏輯很像。所以雖然有點突然，請陪我這個業餘的店長一起開一家幻想手搖店吧！
要開一家最棒的店、調配出一杯最棒的手搖，我們會需要哪些步驟呢？
- 開店選址：定義文章目標客群
- 定義手搖單品的定位與價值：定義這篇文章想要帶給讀者的價值：「這篇文章想讓[填空]的讀者認識到[填空]」
- 思考飲料的食譜：思考文章架構。在架構階段可以給他人看是否能夠表達自己的核心觀點
- 實際調配飲料：稀釋知識濃度，善用比喻與多媒體表現形式
- 試喝：與他人討論並迭代
下面讓我們具體介紹每一個步驟的小細節吧！
當我們在為手搖店選址的時候，我們會對整體目標客群有一定的分析，例如開在學校旁邊可能會需要便宜大碗的品項，也會有老師們會集體訂飲料的需求。寫文章的時候，能夠有一個具體的目標讀者是非常重要的。你是想要寫給同行看？還沒入門的新手看？還是未來的面試官？
像開店選址一樣，隨著目標客群不同，我們也會推出不同的文章內容，也會考慮到目標客群的背景知識程度而選擇使用的用語與恰當的舉例與比喻。
舉例來說，在開始A11y新手村的時候我們發現，中文的 Web Accessibility 相關內容還不多，因此我們的目標讀者就鎖定在IT領域從業的開發人員，以工程師、設計師、PM等為主。
我們想像的目標客群並 不一定對 Accessibility 了解，但是可以預期對該行業的基本專業知識較為理解。 例如：設計師基本知道什麼是易用性 ( usability )，按鈕 ( button )的各個狀態等；程式設計師基本知道什麼是HTML語意等）。
因此在撰寫文章時可以使用該文章的目標的基本專業術語，但是在闡述Accessibility 知識時，需要特別注意減少使用未解釋的 Accessibility 專業用語，或是確保有對該專業用語的說明。
每個細分客群所具備的背景知識，乃至於習慣的閱讀與行文，排版方式都有所不同，例如工程師可能會更希望有具體的程式碼（如codepen範例），設計師會更希望有圖式或是大量的範例、優缺點來支撐每個論點。
在你寫文章的時候，可以思考自己寫的文章是要給誰看的？要先大概想像或實際了解目標讀者對主題的理解程度是什麼？即便都是產品設計師，隨著行業的不同，所有的專業知識也會有很大不同。例如B端設計師可能更熟悉企業內軟體設計，有些就會牽涉到專業知識，這時如果要向同行解釋工作內容，也必須要有意識地思考「這個領域可能一般讀者不會很了解，可能可以先跳過或要花更多篇幅解釋」。
在確定了手搖店面向的客群之後，我們要開始思考我們推出每個新品項的時候，想要帶給顧客怎麼樣的價值？是想要強調豐富的配料？保留果肉的營養？還是精選茶的風味？
一篇文章試圖只傳達少數核心訊息
就像是如果一杯飲料中塞入了茶、奶、果汁、各種配料⋯⋯雖然很豐富，但是顧客就因此很難了解這杯飲料最想要傳遞的味道是什麼。
一篇文章的核心知識點盡量少且明確，也是希望讀者在看完之後能夠帶走的價值定義地越少越明確，越可能在短時間內帶給讀者價值。
可以使用這樣一個模板來思考：「這篇文章想讓[填空]的讀者認識到[填空]」。以新手村的文章為例：
- 《點字二三事❶：認識點字》：讓[沒接觸過點字知識]的讀者認識到[點字的基本構成與基本知識（包括由來，組成與不同系統）]。
- 《讓視障者遨遊虛擬世界：螢幕閱讀器是什麼？》：讓[沒聽過螢幕閱讀器]的讀者知道[螢幕閱讀器這個輔助型科技以及它的使用者是誰]。
- 《移動無障礙-交通篇(上)》：讓[沒實際接觸過視障者]的讀者認識到[一位視障者平時的交通與出行情況，會用什麼方法去辨識路？會使用什麼科技？]
尊重讀者的時間與注意力
在這個走三步就有一家新的手搖店的時代，正如在茫茫網海之中，光是相遇便是有緣。我們也需要了解到， 一篇文章最終能夠讓讀者帶走的東西是有限的。 即便是作品集，面試官通常也不會每一個作品都詳讀。如何在有限的時間與注意力裡面帶給讀者對於他們有價值的東西，就顯得格外重要。
以我們而言，我們目前文章大約的閱讀時長在兩分鐘左右， 也因此要考慮是，在兩分鐘左右的時間，我們能夠交付給讀者的最大價值是什麼？
當我們決定了飲料要傳遞的核心訊息之後，就要開始思考要如何才能最大限度地傳達這個訊息。如果我們決定以「果香」作為這杯飲料的主題，就可以開始思考，例如飲料基底、搭配的糖漿、配料、混合方式與配比⋯⋯當然調飲高手可以一邊調製飲料一邊去嘗試配方，但是作為初學者的我們，事前計畫就非常重要了。
⚠️ 一篇文章最重要的是他的架構 ⚠️
一篇文章好不好理解，也取決於這個架構本身脈絡是否清晰。文章最基礎的架構可以先用列點的方式列出來，想像是在寫一本書的目錄。以《巧用 tabindex 讓你的 UI 更鍵盤友善》一文為例：
文章目標：
介紹 tabindex 為何，不好與好的使用方式的實際例子，讓大家看完可以知道如何更好的使用 tabindex。
文章架構：
- 前言（導言）：為什麼我們需要 tabindex？沒有他們會造成什麼問題？
- 背景知識介紹：物件的聚焦狀態是什麼？
- HTML 中元素的 tabindex 屬性
- tabindex 不好的使用方式
- tabindex 好的運用方式
- 結語：總結文章知識點
一個好的文章架構應該像是看食譜，光是看材料跟調味料表就能大概想像味道，也是層層遞進、環環相扣的。
以我們作為網路知識型文章而言，不含前言與結論，一篇文章中有三到四個小段落（大約三千到五千字左右）就很多了，可以思考如何在三四個主題中有效表達核心觀點。
在我們的實際經驗中，寫文章往往不是不知道要寫什麼，而是很容易陷入「這個也想寫」、「那個也想寫」的局面，最後導致一篇文章太過冗長或是瑣碎的細節太多導致讀者無法跟上。我個人在寫作時會刻意放好幾天再去重看一遍，這樣就會重新跟自己的作品產生距離，也更容易客觀地發現自己離題的部分。
💡 如果可以的話，可以在架構階段就給別人看過
因為每個人的背景知識不同，自己覺得通順的文章架構，可能在他人眼中會有些跳tone，又或是想要表達的知識點太多。如果在不容易懂的文章架構的基礎上去寫文章，之後更改的成本也更高。因此可以的話，可以把想要表達的觀點與大綱一起給別人看過，看看是不是能夠傳遞自己的觀點。
以客群看得懂的語言書寫，稀釋知識濃度
如果把一篇文章比喻為一杯鮮果汁，當然濃度越醇，味道也就越濃厚。我們都希望客人可以喝到最濃醇香的果汁，但你要想像這是一杯不習慣酸味的人的葡萄柚果汁，如果一開始就100%純葡萄柚加下去，大家就會覺得這個味道太刺激太陌生了，所以我們需要去加糖，加水，加其他熟悉的配料去稀釋讓這個果汁更好入口。
如前所述，A11y新手村的目標客群假定是以不了解 Accessibility 相關知識為前提的人，所以如何讓讀者在不具有相關基礎知識的情況下也能進入狀況，從而帶走價值就非常重要。以下是幾種我們自己常用的「稀釋」手法：
善用各種不同的舉例
當有人反映「看不懂」的時候，就可以思考要用什麼舉例方式讓文章更淺顯易懂。
◆ 使用讀者更熟悉的週遭事物去做比方
例如：「例如扛了一台看起來很厲害的電飯鍋，號稱一鍵按下，不僅可以炊飯、蒸蛋糕還可以變身壓力鍋⋯⋯！滿心雀喜準備要炊煮一鍋香噴的米飯時，發現螢幕版上功能琳琅滿目又是不熟的語言，當場變成字盲，只好邊看著說明書邊操作，一鍵一鍵按試著去尋找功能，試著去摸索藏在機器內的訊息。」
◆ 使用故事實際舉例，讓讀者帶入情境
例如：「讓我們想像一個情境：有位來造訪您頁面的使用者小伍，他使用鍵盤導航瀏覽內容。小伍看到一個像按鈕樣式的元素，並期望點擊後發生特定的動作，但什麼也沒發生。因為他看到像「按鈕」樣式的元素不加思索的就按下 space 鍵，但實際上是個超連結的 "a" 元素，而 "a" 元素是使用 enter 鍵才能觸發定位導航功能的，此時小伍想必很困惑：『怎麼點擊了卻沒反應？』」
◆ 使用實際案例去輔助理解抽象概念
例如：《圖像驗證碼，與如何讓它更好的3個設計思路》一文中，有實際截圖的各網站的圖片案例去輔助理解不同類型的圖像驗證碼。
善用圖片，動畫等輔助型媒體來幫助理解
- 特別是當我們預期「讀者沒有接觸類似知識」的時候，例如操作 Screen reader 的方式，點字打字機的操作方式等等。
- 圖片與動畫也更能讓人感受到操作者（無障礙科技使用者）的操作方式。
- 在有文字作為理解的主要媒介之上，能夠添加更多的圖片與動畫也是很好稀釋知識濃度的方式。
飲料做好之後，先不要急著寫上菜單，我們可以先找幾個親朋好友來試喝，獲得一些誠實的意見。
與寫作本身相同，團隊成員之間的討論其實也是我們整體流程中很重要的一環。在我們初期創作階段，因為大家對於這種寫作方式還並不熟悉，所以有他人客觀的意見與評價就很重要了。
以下是我們在創作第一篇知識型文章《讓視障者遨遊虛擬世界：螢幕閱讀器是什麼？》的第一段落的初稿與定稿的對比圖。
我們的作者擁有很豐富的螢幕閱讀器知識，因此可以寫出十分專業的文章。但是對於像我一樣對知識點還不是很熟悉的讀者，可能會發現初稿閱讀起來會有點吃力。這時候透過一起討論「這個地方是不是可以再舉個例子更好懂？」、「這裡是不是可以用實際例子來說明？」，我們一起共同將文章寫得讓更多人能夠理解。
審閱並不代表在批評或是代表撰寫者寫得不好，而是一起為了讓受眾獲得價值而分工
給別人看文章，甚至是被給予意見難免會緊張，但是 審閱並不代表文章寫得不好。
知識型文章因為有其受眾與目的，所以需要透過大家一起討論來完成。例如通常撰寫者作為最了解該文章與知識點的人，容易會因為了解而不自覺寫得太深奧（就像喝慣榴槤果汁的人，喝100%的果汁也不覺得濃），此時作為團隊成員就需要作為讀者或是編輯來跟寫作者給予反饋（例如反映：「這一段太濃啦！」）來一起完成文章。
給予意見的人應該為了清楚表達執筆者的意圖的明確可操作反饋
我不是專業編輯，所以參考了很多書籍，以下是我個人覺得很受用的幾個要點：
- 評論方式也有一定規範，優先順序是從整體到細部、重要性高到低的順序。
- 文章想要傳達的核心觀點的清晰度
- 整體架構與目次是否恰當
- 行文用詞等是否看得懂
- 盡量提出明確可操作的建議：「感覺XX概念沒有很懂，是不是可以再加上依家例子來說明？」
- 反過來說，太過曖昧的評論就很難具有參考價值，例如：「我覺得這篇文章有點難懂」，執筆者也無法具體去改善。
『與其當一個資訊的消費者，不如當生產者。成為資訊生產者比資訊消費者快樂很多倍，也會覺得更有價值和成就感。一旦品嘗過這種滋味就會上癮，這就是研究的極道。』
東大教授上野千鶴子在著作裡的這句話讓我印象深刻。
誠然，我在文章開頭列舉了很多寫文章的好處，但是撇開這些功利的理由，我覺得成為知識生產者的過程本身是讓人開心，甚至是過癮的。
就像是完成一個作品，企劃時想破了頭、中途會想摔筆不想寫、聽到別人的回饋會懷疑自己⋯⋯但是回過頭來看努力的過程與最後產出的結果，這種成就感和價值是很難在其他事情上獲得的，也是我想持續經營A11y新手村的主要動力之一。
新的一年，期許我們都成為更好的知識生產者。
我相信把這篇文章看到這邊的你，也是對於分享知識有熱情、想要嘗試看看的人。我相信即便大家都是同樣的職位，但是在不同脈絡下累積的Know How，乃至於每個人對於事件的不同想法，都很值得留下來作為經驗，透過分享、傳遞和交流，我們可以形成一個更好的社群。
A11y新手村在新的一年也會持續為大家提供網路無障礙相關的知識與內容！可以的話，請拍手讓我們知道你喜歡這樣的內容，也歡迎追蹤我們定期收看唷！
