Küçük bir bahçenin zanaatı
Bir dijital bahçe tek koşulla canlı kalır: ona dokunmak ucuz olacak. "Şu cümleyi düzelt" demek klonla, dal aç, düzenle, commit’le, push’la, CI’ı bekle demek olduğu anda, o cümle bozuk kalır. Bu bahçenin yanıtı, okuma yüzeyi ile yazma yüzeyini aynı yüzey yapmaktır — blok blok düzenleme.
§1Küçük notlar, sık bağlantılar
Bir bahçe notu, bitirilebilecek kadar küçük ve bulunabilecek kadar iyi bağlanmış olmakla ekmeğini hak eder. Uçsuz bucaksız tek bir sayfa yerine birbirine bağlı beş notu yeğleyin; yapıyı bir içindekiler tablosu değil, wikilink’ler taşısın. Ölü bağlantılar yöntemin parçasıdır — her biri, kendinize borçlu olduğunuz bir nottur.
§2Budama
Eski notlar iki türlü çürür: ya yanlışlaşır ya öksüz kalır. Yanlışlık kolay olanıdır — kusurlu bloğu gördüğünüz yerde düzenleyin; eskiden ne dediğini günlük hatırlar (ayrıntılar sürüm geçmişinde). Öksüzler budama ister: ya bağlayın, ya başka bir nota katın, ya da vicdan azabı duymadan silin. Bir bahçe biriktirdikleriyle değil, canlı tuttuklarıyla ölçülür.
§3Törenselliği araçlar taşısın
Commit’ler, geçmiş, yedekler — tören gerçektir ama sizin sırtınızda olmamalıdır. autocommit açıkken kayıtlar kendi kendine git commit’i olur; içe aktarmalar gelen kutusundan kendi kendine gelir; çeviriler bile yapay zekâ desteğinde tek tıktır — bunun nereye kadar gittiğini bu bahçenin on sekiz sürümü söylüyor. Size kalansa baştan beri ilginç olan tek kısımdır: söyleyecek bir şeyinizin olması.