東西做完就沉在 commit 裡了
想把「為什麼這樣改」寫下來，可是那些理由早就忘了，剩下的只有一堆寫著 fix 的 commit。
AbstractStarting a devlog because the reasoning behind past decisions lives nowhere — only in commit messages that mostly say "fix".
那時候在想什麼
翻 super-reversi 的 log，九月那十二天有九十幾個 commit，訊息大概長這樣：
add |
移除光束 這個我完全不記得了。應該是某個特效，做出來覺得不對就砍掉。當時一定有理由，可是現在想不起來。
我想留下的就是這種東西。做出來的 GitHub 上看得到，做到一半砍掉的只有我自己知道，而我也快忘光了。
實際做了什麼
先把方向定下來。這個站不寫教學，寫的是過程。每篇對應一段真實的時間，講那段時間在想什麼、後來為什麼改主意。
分類的方式想了兩種。一種是按專案分，一個 repo 一頁；一種是按狀態分，看這東西最後留下了沒。後來覺得兩種都要，因為它們是不同的軸。專案是「在哪個坑裡」，狀態是「這一鏟挖出了什麼」。
所以最後定成五級狀態：概念實驗、進行中、已落地、已否決、階段總結。
試過但沒留下
一開始想過用純時間軸，不分專案，就一條線從頭捲到尾，看起來很純粹。
後來算了一下就放棄了。super-reversi 十二天九十幾個 commit，super-reversi2 從七月做到現在，這兩個加起來就會把時間軸塞爆。更麻煩的是它們其實是同一條線的前後段，混在一起讀，讀者根本分不出來哪一段在講哪個東西。
所以還是要分專案。時間軸留著，但只當第二個入口。
結論
方向定了，不過這篇還只是個想法。真正要驗證的是下一件事：能不能真的從 commit 把當時的脈絡挖回來。如果挖不回來，這個站就沒有存在的意義。