使用者不會用我家的軟體產品怎麼辦?寫 Tutorial 技術文件的 6 個訣竅,幫助你提升試用產品的轉換率

更新於 發佈於 閱讀時間約 3 分鐘
raw-image

工作兩年,我已經替 5 個 SaaS 產品寫了技術文件。

過程中我發現:

現代人很沒耐心。

5 分鐘內他不知道產品怎麼用,就會關閉網頁再找其他試用品。

公司失去了一個願意付費的潛在客戶。

怎麼辦呢?你需要一份 Tutorial 技術文件!

Tutorials(教學文件)瞄準的對象是超級新手、第一次使用產品的人。

想像我們在教一個小朋友下廚。

教小孩煮什麼並不重要,重要的是

  • 讓他知道在廚房裡要注意些什麼
  • 享受做菜的樂趣
  • 最後成功做出一道菜(例如自己煎出荷包蛋!)。

關鍵是「建立一些簡單的任務,讓使用者試著去完成看看」。

例如 Mac 上的軟體- Raycast 讓使用者快速完成 5–10 個小任務,就學會產品 80% 的功能了。

Raycast Cover

Raycast Cover

那該怎麼寫出一份好的 Tutorial (教學)文件呢?

下面是我總結的 6 個訣竅。

訣竅 1. 教學起手式,自己從頭到尾做一遍

拿出一張白紙,寫下要開始使用產品的每一個步驟。(你想先打在筆記軟體上也行)

這裡的訣竅是:你必須自己從 0 到 1 完成過產品的操作,並且紀錄你的每一個動作。許多的教學文章都會犯一個錯,步驟跳太快啦!你應該也有這樣的經驗,說明書上明明是寫第 2 步,但真實狀況是你得自己多做 5 個動作。

寫教學文件的起手式,一定是自己從頭到尾做一遍。

訣竅 2. 一個教學步驟,只寫一個動作

這樣讀者才能跟上腳步。

舉個例子,我們該怎麼寫「註冊流程」呢?我建議:

  • (o) (1)點擊註冊按鈕 (2)輸入基本資料
  • (x) 「註冊並輸入基本資料」

每個步驟只做一件事情。

訣竅 3. 在教學文件開頭,先預告有幾個步驟

這樣讀者才能預測要花多久時間閱讀。

例如

  • 3 個步驟開始交易
  • 5 個步驟完成串接
  • 10 個步驟製作第一張圖卡

想想你的閱讀體驗就知道了。

你看到一份不知道要花多久時間才能完成的教學,下一步通常是…往下滑到底。然後 murmur “看起來好複雜”,接著滑鼠游標移動到瀏覽器的右上角點擊 X。

先預告,讀者才有耐心讀下去。

訣竅 4. 教學步驟中不展開細節

遇到繁瑣的步驟時,Tutorial 文件不需要展開操作細節。

例如「輸入基本資料」包含了姓名、電話、Email、地址…,不需要特別提及要填寫什麼欄位。

這些屬於「說明類」的內容,可以放到 How-to 或是 Explanation 文件中說明。

這樣做的好處是你的文件會看起來很簡潔。

訣竅 5. 教學文件中要搭配截圖

一圖勝千言,文字搭配截圖最好懂。

這裡有個提升圖片質感的訣竅。把圖片複製到 Figma 中,在 Effect 欄位新增陰影 (Shadow)。

加上陰影可以大幅提升圖片的質感。

訣竅 6. 每個教學步驟都要取個標題

標題要劃重點的作用,5–10 個字最好。

例如 “開始使用產品之前您需要一個帳號,點擊按鈕登入頁面進行註冊。”

可以取個 “註冊產品帳號” 的標題。

試試看替你的公司產品寫份 Tutorial 文件吧!

快速複習寫 Tutorial 文件的 6 個訣竅:

  1. 教學起手式,自己從頭到尾做一遍
  2. 一個教學步驟,只寫一個動作
  3. 在教學文件開頭,先預告有幾個步驟
  4. 教學步驟中不展開細節
  5. 教學文件中要搭配截圖
  6. 每個教學步驟都要取個標題

你可以看看 我寫的 Tutorial 文件, 會更了解上面的說明。


覺得這篇貼文實用嗎?你可以

  • 📰 歡迎 訂閱電子報 加入 2300+ 學習愛好者的行列,每週 1 個學習行動建議!
  • 🧑‍💻 常滑 Facebook 嗎?可以 追蹤我,就可以看到我的最新想法啦~
  • ❤️ 如果你覺得文章寫的不錯,可以對文章按愛心讓我知道


avatar-img
211會員
129內容數
分享學習相關的技巧、工具與方法
留言0
查看全部
avatar-img
發表第一個留言支持創作者!
朱騏的沙龍 的其他內容
學習寫API文件很困難,尤其很難在網路上尋找好的教材。在這篇文章中我會分你分享 Tom Johnson 的 “Documenting APIs” 課程。他提供了一個簡單的學習路徑,幫助你了解基礎 API 知識和寫作技巧。如果你想精進自己的 API 文件寫作能力,這個課程不要錯過!
對公司團隊來說,培養「寫文件」文化是非常棒的事情。例如降低新人 onboarding 時的教育成本、跨團隊溝通的時間成本。但多數的人都覺得「寫文件」是一件麻煩的事情。如果公司團隊要開始推行「寫文件」文化,應該如何做呢? 我有 6 點建議。
「為什麼非產品部門的同事,對產品操作會這麼不熟悉呢?」這是許多產品團隊都可能遭遇的問題。這篇文章分享我在公司舉辦 Workshop (工作坊)的經驗。包含 3 部分:(1) 為什麼要舉辦 Workshop? (2) 如何準備 Workshop?(3) 我從 Workshop 學到的 3 點經驗教訓
SaaS 公司提供即時、線上的軟體產品/服務,因此讓小白使用者「好上手」是非常重要的。但使用者卡關時怎麼辦?一個不用浪費公司太多人力、又能讓使用者快速排除問題的方法就是:「提供技術文件」。如果你的公司內部/產品團隊沒有專門的Technical Writer,看完這篇文章可以讓你了解 4 種產品必要的
我曾經擔任 PM 將近 6 年的時間、在新職位 - Technical Writer 工作 9 個月的時間,這篇文章分享關於「寫文件」這件事 - 包含 Technical Writer 在做些什麼、跟「產品經理(Product Manager)」的差異。如果你對軟體產業有興趣,一起來看看這篇文章吧。
換新工作滿半年了,這是我入職場7年第一次轉換不同職能的工作,在心境上有很多的感觸跟自我對話,其中最重要的就是「身份認同」這件事情,這篇文章分享 4 點感觸給同為想要轉換職能的人。
學習寫API文件很困難,尤其很難在網路上尋找好的教材。在這篇文章中我會分你分享 Tom Johnson 的 “Documenting APIs” 課程。他提供了一個簡單的學習路徑,幫助你了解基礎 API 知識和寫作技巧。如果你想精進自己的 API 文件寫作能力,這個課程不要錯過!
對公司團隊來說,培養「寫文件」文化是非常棒的事情。例如降低新人 onboarding 時的教育成本、跨團隊溝通的時間成本。但多數的人都覺得「寫文件」是一件麻煩的事情。如果公司團隊要開始推行「寫文件」文化,應該如何做呢? 我有 6 點建議。
「為什麼非產品部門的同事,對產品操作會這麼不熟悉呢?」這是許多產品團隊都可能遭遇的問題。這篇文章分享我在公司舉辦 Workshop (工作坊)的經驗。包含 3 部分:(1) 為什麼要舉辦 Workshop? (2) 如何準備 Workshop?(3) 我從 Workshop 學到的 3 點經驗教訓
SaaS 公司提供即時、線上的軟體產品/服務,因此讓小白使用者「好上手」是非常重要的。但使用者卡關時怎麼辦?一個不用浪費公司太多人力、又能讓使用者快速排除問題的方法就是:「提供技術文件」。如果你的公司內部/產品團隊沒有專門的Technical Writer,看完這篇文章可以讓你了解 4 種產品必要的
我曾經擔任 PM 將近 6 年的時間、在新職位 - Technical Writer 工作 9 個月的時間,這篇文章分享關於「寫文件」這件事 - 包含 Technical Writer 在做些什麼、跟「產品經理(Product Manager)」的差異。如果你對軟體產業有興趣,一起來看看這篇文章吧。
換新工作滿半年了,這是我入職場7年第一次轉換不同職能的工作,在心境上有很多的感觸跟自我對話,其中最重要的就是「身份認同」這件事情,這篇文章分享 4 點感觸給同為想要轉換職能的人。
你可能也想看
Google News 追蹤
Thumbnail
現代社會跟以前不同了,人人都有一支手機,只要打開就可以獲得各種資訊。過去想要辦卡或是開戶就要跑一趟銀行,然而如今科技快速發展之下,金融App無聲無息地進到你生活中。但同樣的,每一家銀行都有自己的App時,我們又該如何選擇呢?(本文係由國泰世華銀行邀約) 今天我會用不同角度帶大家看這款國泰世華CUB
Thumbnail
嘿,大家新年快樂~ 新年大家都在做什麼呢? 跨年夜的我趕工製作某個外包設計案,在工作告一段落時趕上倒數。 然後和兩個小孩過了一個忙亂的元旦。在深夜時刻,看到朋友傳來的解籤網站,興致勃勃熬夜體驗了一下,覺得非常好玩,或許有人玩過了,但還是想寫上來分享紀錄一下~
Thumbnail
【這是新手發表貼文時,最常犯的錯誤之一】 —過度渴望在一篇文章中灌輸所有資訊給觀眾。 這就像是明明只分享了一碗湯麵的照片, 卻在下文列出二十道不同的料理菜單, 包括咖哩飯等等。 觀眾的接收能力有限, 他們無法同時吸收太多資訊。 因此,精選內容和用字遣詞非常重要。 確保
Thumbnail
作者身為八個百萬事業的創辦者,他想要證明他是可以教導別人這些方法的。首先他先提出三個核心步驟
Thumbnail
這篇文章介紹成功寫作的步驟,透過卡片盒筆記法來提高生產力與寫作力。包括多工的正確理解、為了理解而閱讀、聰明的筆記法、發展想法、分享見解以及養成習慣。文章中分享了具體步驟以及相關心得。
Thumbnail
本文談論了使用ChatGPT的心得和學習新技術的10個步驟,透過這些方法和步驟可以幫助學習者快速有效地掌握新技術。
Thumbnail
在設計有四年快五年的時間,大部分都是從實戰經驗中去不斷摸索產品開發的流程。從視覺傳達的背景出來,在用戶體驗的經驗都是在實際開發中去摸索出來的。不是理論派,只是根據我本人的經驗摸索出來的設計方法,也不會用太多高深的詞彙說明。 以前搜尋怎麼做產品設計?究竟是要從什麼步驟開始的這件事情,大部分看到的
Thumbnail
想要推出迷你課程卻不知道該如何下手嗎?不用擔心,Justin Welsh 分享了一個超棒的方法讓你能節省時間又能測試市場!迷你課程是濃縮的精華,用不到 1 小時的影片,教大家學會一個超實用的技能。文章中分享了 8 個步驟,幫助你打造自己的迷你課程,並提供了相關資源供查詢。
不是創造夢幻客戶,而是創造長久生意的大客戶。 為什麼這麼說呢? 因為大多數的時候,我們其實很希望趕快可以把我們想要分享的產品、事業,把它分享給對方。可是在這個過程當中,往往對方沒辦法可以去理解跟接受,因為對方還沒ready好。 所以在過去學習銷售的過程當中,有很多的流程跟方法。
做好一件事其實非常簡單,但是對有些人卻非常困難,作者這裡分享幾個小技巧。1:我會先將步驟先想好,這樣不僅不會手忙腳亂,也可以提高效率。我如果要寫功課,就會先想好要先寫哪一項功課,我會簡單的功課和難的功課交錯寫,才不至於太痛苦。 2:你要將會讓你分心的事或物想辦法解決和想辦法克制。像
Thumbnail
這篇文章提供了五種方法,協助你確定讀者的痛點以提出產品創意。另外,還包括了一些提升線上服務業務成功的建議。
Thumbnail
現代社會跟以前不同了,人人都有一支手機,只要打開就可以獲得各種資訊。過去想要辦卡或是開戶就要跑一趟銀行,然而如今科技快速發展之下,金融App無聲無息地進到你生活中。但同樣的,每一家銀行都有自己的App時,我們又該如何選擇呢?(本文係由國泰世華銀行邀約) 今天我會用不同角度帶大家看這款國泰世華CUB
Thumbnail
嘿,大家新年快樂~ 新年大家都在做什麼呢? 跨年夜的我趕工製作某個外包設計案,在工作告一段落時趕上倒數。 然後和兩個小孩過了一個忙亂的元旦。在深夜時刻,看到朋友傳來的解籤網站,興致勃勃熬夜體驗了一下,覺得非常好玩,或許有人玩過了,但還是想寫上來分享紀錄一下~
Thumbnail
【這是新手發表貼文時,最常犯的錯誤之一】 —過度渴望在一篇文章中灌輸所有資訊給觀眾。 這就像是明明只分享了一碗湯麵的照片, 卻在下文列出二十道不同的料理菜單, 包括咖哩飯等等。 觀眾的接收能力有限, 他們無法同時吸收太多資訊。 因此,精選內容和用字遣詞非常重要。 確保
Thumbnail
作者身為八個百萬事業的創辦者,他想要證明他是可以教導別人這些方法的。首先他先提出三個核心步驟
Thumbnail
這篇文章介紹成功寫作的步驟,透過卡片盒筆記法來提高生產力與寫作力。包括多工的正確理解、為了理解而閱讀、聰明的筆記法、發展想法、分享見解以及養成習慣。文章中分享了具體步驟以及相關心得。
Thumbnail
本文談論了使用ChatGPT的心得和學習新技術的10個步驟,透過這些方法和步驟可以幫助學習者快速有效地掌握新技術。
Thumbnail
在設計有四年快五年的時間,大部分都是從實戰經驗中去不斷摸索產品開發的流程。從視覺傳達的背景出來,在用戶體驗的經驗都是在實際開發中去摸索出來的。不是理論派,只是根據我本人的經驗摸索出來的設計方法,也不會用太多高深的詞彙說明。 以前搜尋怎麼做產品設計?究竟是要從什麼步驟開始的這件事情,大部分看到的
Thumbnail
想要推出迷你課程卻不知道該如何下手嗎?不用擔心,Justin Welsh 分享了一個超棒的方法讓你能節省時間又能測試市場!迷你課程是濃縮的精華,用不到 1 小時的影片,教大家學會一個超實用的技能。文章中分享了 8 個步驟,幫助你打造自己的迷你課程,並提供了相關資源供查詢。
不是創造夢幻客戶,而是創造長久生意的大客戶。 為什麼這麼說呢? 因為大多數的時候,我們其實很希望趕快可以把我們想要分享的產品、事業,把它分享給對方。可是在這個過程當中,往往對方沒辦法可以去理解跟接受,因為對方還沒ready好。 所以在過去學習銷售的過程當中,有很多的流程跟方法。
做好一件事其實非常簡單,但是對有些人卻非常困難,作者這裡分享幾個小技巧。1:我會先將步驟先想好,這樣不僅不會手忙腳亂,也可以提高效率。我如果要寫功課,就會先想好要先寫哪一項功課,我會簡單的功課和難的功課交錯寫,才不至於太痛苦。 2:你要將會讓你分心的事或物想辦法解決和想辦法克制。像
Thumbnail
這篇文章提供了五種方法,協助你確定讀者的痛點以提出產品創意。另外,還包括了一些提升線上服務業務成功的建議。