「一個 repo 一篇」這個切法不成立
一個 repo 寫一篇總結,聽起來很乾淨,實際上會變成一篇沒人讀得完、也沒人寫得出來的東西。
AbstractThe "one post per repo" idea sounded clean but collapses under real history — replaced by calendar-based slicing.
那時候在想什麼
最初的想法很單純:每個 repo 寫一篇,講這個專案是什麼、做了哪些實驗、哪些留下來了,一頁講完。
寫起來也快。十幾個 repo 就十幾篇,一個週末可以清完。
實際做了什麼
拿 super-reversi 試算。九十二個 commit、十二天、三萬多行變動,涵蓋的東西包括整套響應式 CSS 重寫(vw 改 rem)、完整的 i18n、連擊系統從三連擊擴到七連擊、九級 AI、粒子特效系統。
要用一篇講完這些,那篇會變成流水帳。
更麻煩的是另一件事。寫成一篇總結,等於逼我把「當時的想法」壓縮成「後來的結論」。九月十三號那天我在改 CSS 單位,九月十四號在做 i18n,這兩件事之間發生了什麼、為什麼從版面跳到多語系,那個轉折才是有意思的地方。壓縮成總結之後,轉折就沒了,剩下的只有「這個專案做了 A、B、C」。
試過但沒留下
退一步想過折衷的做法:一個 repo 一篇,但用小標題分段,每段講一個主題。
還是不行。主題分段是事後的整理,我得先知道整件事的全貌才切得出主題,可是這個站的重點就是「當時不知道全貌」。用事後的架構去寫當時的過程,寫出來的東西會太聰明,不像那個當下。
結論
改成按曆格切。活躍期一週一篇,平淡期一個月一篇。切片的邊界由日曆決定,不是我事後決定的,這樣才逼得出「那一週我在想什麼」,而不是「這個專案的架構是什麼」。
super-reversi 用週切是三片,尾巴兩個 commit 的那片併進前一格,剩下兩篇,每篇二三十個 commit。那個量級講得完。
一個 repo 一篇這件事沒有留下來,可是它逼出了一個更重要的問題:切片的邊界該由誰決定。答案是日曆,不是我。