在這一個階段,即是將要說明詳實特定範圍的內容,擴大問件內容討論的範疇及細節,可以採以易於閱讀理解的方式進行撰寫,以利於閱讀對於特定主題想要更深入了了解,且可以做討論對話使用。
撰寫Explanation資訊解釋內容的注意事項
如何寫出好資訊解釋Explanation:
提供上下文的脈絡內容:
提供討論替代方案和意見
不要指導或提供技術參考
資訊解釋,不是指導用戶該如何做某事。
不應提供技術描述,因為整個文件中,已有其他階段處理該內容。
資訊解釋其主要的目標是可以讓閱讀者輕鬆地了解到,某一個主題的前因後果脈絡,但實際上可能執行也無法完成詳實紀錄,但可保持的原則是讓閱讀者可以了解脈絡,作為對話討論使用。
應避免把其他技術性指導內容,也在這階段內容重複說明,可避免資訊不同,且閱讀者較不好集中於內容目標上。
資訊解釋內容採以主題性的概念進行撰寫,包含當時的決策、原由、限制,來說明現在的方案是目前最合適方案。
上下文的脈絡這真的是重點,之前遇過寫到最後文具不通,使用者看越看越confuse @@
以前的前輩說,如果我寫的SPEC連一個剛入職一週的人都可以理解,那就成功一半了
沒錯!!!