多人協作
請求在看什麼
Pull request 這個名字很工具。你把它看成一張請求:請看這個狀態,決定要不要讓它變成大家的那一份。
請求裡至少要有三塊
第一塊是行為:客服按下去之後,哪一種輸入的結果變了。第二塊是你怎麼知道它變對了:走哪一筆退貨、空白時應該停。第三塊是收回:若上了之後不對,回到哪一個有名字的狀態。三塊缺任何一塊,這張請求就只是一疊改過的文字。
文字本身可以附在旁邊,給要看實作的人。PM 先讀這三塊。三塊讀懂了,你才決定要不要往下看細節。讀不懂,請作者補句子,不要開始猜。
它不是群組裡的一句「我改好了」
群組訊息會被沖走,也沒有跟那個狀態綁在一起。請求掛在那個狀態上,下週還指得到「我們當時核准的是這一個」。FDE 的交付會被問「線上為什麼變成這樣」。指到那張請求,比翻聊天紀錄可靠。
所以請人看的時候,把連結和那三塊放在一起。不要只說「幫看一下」而不說要看的決定是什麼。
小請求比大請求容易說真话
一張請求同時改天數、權限、畫面文案,看的人只能選全部收下或全部退回。兩種都很粗。把決定拆開,一張請求一個行為,核准才有意義。這跟 commit 只做一種決定是同一件事,只是現在多了一個人要點頭。
你若是那個寫請求的人,先寫行為再貼改動。你若是那個被請來看的人,行為寫不出來就先退回,這是在幫團隊,不是在刁難。
範例 · 一張退貨請求的三塊
- 行為:訂單編號是空的,不再出現可退或不可退,只出現轉人工。
- 怎麼確認:用一筆空白、一筆七天內有效單各走一次。
- 收回:回到名字是「空白仍會給結論」之前的那個狀態。不在正式環境上現改。
練習
把你最近一次「我改好了」改寫成三塊:行為、怎麼確認、怎樣收回。
若怎樣收回寫的是「再修就好」,改成指向上一個有名字的狀態。
完成的時候
- 你能說明 pull request 是在請人看一個決定。
- 你寫得出行為、確認、收回三塊。