如何寫一份好讀的 API 技術文件？推薦學習技術寫作的好資源 — Documenting APIs

要點新的技能樹了！

學習這份教材，真的是一個享受！

1. 介紹學習動機

介紹為什麼 Technical Writer 要學習撰寫 REST API 的技術文件，讓學生可以知道學完後到底可以獲得什麼。

厲害的是，他引用了超過 10 個來源的調查數據、寫了 2 篇文章專門分享學習的好處，這讓學習目標變得具體。

2. 分享老師自己的經歷

Tom Johnson 特別花一篇文章的篇幅，介紹自己起初也只是個在學校教寫作的老師，迫於生計壓力才陸續轉職成行銷文案寫手、到現在的技術寫手。

他承認自己不能算是個 Developer，但這不構成自己無法寫高度技術導向的 API 文件。看完介紹，我不但充滿信心、也對這個講師充滿好感，在後面上課也學得很愉快。

3. 列舉詳細的案例，讓學生跟著操作

許多公司不會聘請「技術寫手」，通常都是 PM、業務、客服兼著寫。這些人不是沒有技術背景、就是不會 Coding。但要學習寫 API 文件，怎麼能不知道工程師會如何使用 API 呢？

於是 Tom Johnson 使用 Open Weather 和 Pet Store 這兩個免費的 API 資源，帶領學生實作一個簡單的 HTML、搭配 Javascript jQuery 的 ajax 函式，讓學生可以體會一個前端工程師在拿到 API Response 後，會如何使用在前端網頁的開發上。

我發自內心的讚嘆：

這是我目前看到最好的技術寫作學習教材，除了學到了技術知識外、也學習到一個好課程可以如何設計。

這份教學多達 200 頁，若要影印成 PDF 檔案會是高達 500 頁的份量。這麼好的教材，重點是：免費！

我知道 Technical Writer 在台灣非常冷門，連線上課程、學習書籍也幾乎沒有中文版的。因此分享這個學習資源給有需要的人。

問題是，誰會需要看這個課程呢？

我想到 3 種人

• 技術寫手：不用說，一定要看的。
• 軟體產品經理：你會更了解前後端工程師在開發時需要的產品規格，並且知道自家公司的產品如何跟外部夥伴串接系統。
• 軟體工程師：你可以設身處地的引導使用自家 API 的外部開發者、使用者，給他們一個超讚的使用體驗 (那些寫的不清不楚的 API Doc，真的會讓人血壓飆高)。

課程在此，請自取 👉 Documenting APIs

---

▶ 關於文章

• 歡迎訂閱 寫作電子報 ，我會跟你分享所有自己在網路上寫作的技巧、故事、經驗。希望你在看完電子報後，能實際去寫、讓更多網路上的人看到你的專業。
• 常滑 Facebook 嗎？可以幫我的 Facebook 粉絲團 按個讚，就可以看到文章啦～
• 想要掌握最新文章，可以點擊下方「Follow」我～
• 如果你覺得文章寫的不錯，可以對文章拍手讓我知道 👏🏻

▶ 關於我

我是朱騏，一個寫作能力超強的軟體技術寫手與產品經理，喜歡研究自媒體寫作、個人知識管理、個人品牌經營。

我可以提供自媒體寫作、個人知識管理、個人品牌經營的

• 1 對 1 諮詢：請參考 1 對 1 諮詢服務
• 講座邀約：請寄 Email 至 contact@chichu.co，並說明主題需求與我討論。

在網路上寫作簡直要你的命了嗎？如果你想要找到自己能寫的主題、在網路上累積自己的專業能見度，你應該聽一個在網路上寫作超過 1000 篇的實戰專家教你怎麼做。(aka 朱騏)

→ I’m Chi 訂閱制：每週分享 2 篇「自媒體寫作」技巧與訣竅文章。教你撰寫高價值的專業內容、製作數位產品的方法，讓你的專業幫助到更多人、賺到被動收入提升營收。