在「The Documentation System」的第一個起步,是會引導教學Tutorials開始,但文獻中也強調該階段會第一個步,而是可以作為一個循環的起點。
引導教學Tutorials
可以當作一個產品的自介或是特色說明的內容,可以是文字、圖片、影片都是可以的,當作為最初的接觸到使用者第一步的說明。
依據官方介紹,彙整重點要點如下:
目的以學習為導向,讓使用者是學習如何,並非學習什麼。
引導使用者在一系列的教學說明行,達到某種目的。
教學的內容和結果都依據撰寫者期待使用者獲得什麼樣的意義為主,但過程中,是需要讓一個初學者都可以執行實現的。
教學內容必須對於初學者有用、易於理解、有意義且明確強大的,如果可以盡可能保持最新的狀態。
要專注在具體的操作步驟上,而只是單純描述抽象概念。
盡可能用最少且明白的說明來描述必要的解釋。
Take away
用撰寫教學文件的角度,還撰寫產品SPEC的好處,可以採用更人性化的角度來說明產品開發的內容,對於閱讀者相對負擔較低。
以終為始的角度來看,用教學文件的開始引導開發者了解產品的目標及架構,讓執行時可以減少啟動摩擦力。
且以終為始的角度開始,在未來要真正運營時,也就不用再重新撰寫一份市場溝通文件,至少不用重頭寫,只要局部調整即可完成。