iT邦幫忙

2024 iThome 鐵人賽

DAY 18
0
IT 管理

沒有終點的敏捷日記系列 第 18

Day18 - 寫出人人看得懂的User Story(4)-故事段落與描述方式

  • 分享至 

  • xImage
  •  

前面文章了解描述(Description)、驗收條件(AC)後,我們可以知道寫一則User Stroy 就像在寫故事,你需要讓讀者一頁一頁地被吸引,跟隨你的情節走到最後;在這篇中,我們將繼續揭開撰寫好User Stroy的密技,讓它既清晰明確,又易於維護。如果你曾經寫過一份需求文檔,那你可能知道這感覺——就像在爬一座無盡的山,今天我會幫你找到捷徑,讓整件事情變得不再那麼辛苦!

技巧一:避免讓畫面牽著鼻子走

我們知道,系統畫面經常更新,按鈕的設計、位置、顏色每天都有可能變,所以,不要藥讓你的 AC 被畫面「綁架」,不要描述那些具體的位置或界面元件,否則每次 UI 調整,你的 AC 也得跟著變動。

- 錯誤(X):使用者可以點按右上的 [新增] 按鈕,開啟 {新增職務} 的畫面。
這樣寫,下一次設計師把按鈕挪到左邊,你就得重寫 AC,這樣是不是太麻煩了?
- 正確(O):使用者可以執行 [新增] 按鈕,進行新增職務的操作。
這樣寫,不論按鈕跑到哪裡,AC 都穩如泰山!

技巧二:跟著「時間軸」和「重要性」來鋪陳情節

想像一下,你正在寫一個故事,最好遵循一個清晰的時間順序和情節發展——我們叫這個「快樂路徑」。先講清楚最常見、最流暢的流程,再來講不那麼順利的情況。如果你先描述出最糟的結果,那讀者可能會覺得自己一開始就進入了地獄!

- 錯誤(X):若查不到資料,顯示「查無資料」;若查到資料,則在 1 秒內返回查詢結果。
這就像是你打開一本小說,第一段就告訴你主角死了——誰還想往下看?
- 正確(O):若查到資料,則在 1 秒內返回查詢結果;若查不到資料,顯示「查無資料」。
先讓讀者走過平坦的路,然後再告訴他們可能會有的荊棘,這才是一個順暢的體驗。

技巧三:句型簡潔,避免倒裝句

在寫 AC 時,讓主詞+動詞的句型成為你的好朋友。當你的語句簡潔明了,讀者可以輕鬆理解你要表達的內容。如果語句太過複雜,他們可能會開始懷疑自己是不是需要讀一份「文言文」訓練指南。

- 錯誤(X):我可以將表單送出。
這雖然不是致命的錯誤,但也太過於繞口,不夠直白。
- 正確(O):我可以送出表單。
簡單明瞭,毫無多餘,這才是高效的 AC 描述!


看完這個系列文章,希望你對撰寫 User Story 有了全新的認識,其實,寫一則 User Story 不用堆砌複雜的詞句,而是要讓每個人都能輕鬆讀懂、順利跟上情節,這樣不僅開發團隊開心,使用者的需求也能真正被滿足。

希望讓大家透過這些小技巧,讓寫需求文件不用再像爬山那樣艱辛,而是走上一條又簡單又明瞭的捷徑!


上一篇
Day17 - 寫出人人看得懂的User Story(3)- 驗收條件(AC)
下一篇
Day19 - 使用範例描述需求(1) - 範例描述的格式
系列文
沒有終點的敏捷日記22
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言