01
從有用的成果開始
決定訪客應該能做什麼、應用程式需要哪些數據以及依賴哪些外部服務。靜態網站、API 和背景任務有不同的需求。即使它們共用一個儲存庫,也要單獨描述。
02
保持責任可見
將原始碼、執行時設定與儲存的資料視為不同的關注點。程式碼應該放在版本控制中。設定描述環境。持久化資料需要備份與復原流程。這種分離使更改其中一個元件時,不必重建其他所有元件變得更容易。
03
讓下一步可重複
記錄建置命令、預期輸出以及顯示版本運作正常的檢查。其他維護者應該能夠遵循相同的步驟。保留最後一次運作正常的版本以及返回該版本的實用方法。這裡的指南從第一個專案到 API 存取,涵蓋這些基本原則。