Bir projeyi aylar sonra da çalıştırabilmek için belgele

Bir proje bitmiş görünebilir ama yine de kaybolmuş olabilir. Çıktısı kalır, hikâyesi yok olur: hangi başlangıç koşullarının geçerli olduğu, hangi kararın bilinçli seçildiği, hangi varsayımın hâlâ geçerli olduğu ve çalışmanın nasıl tekrar kontrol edileceği bilinmez. Belgeleme sonradan eklenen bir iş değildir. Çalışmanın ilk anının ötesinde var olma biçimidir.

Kayıp nadiren gürültüyle gelir. Sessizce gelir: bir kişi ayrılır, bir sohbet silinir, bir araç güncellenir. Dün apaçık olan şey, yarım yıl sonra yalnızca gerekçesiz bir sonuçtur. Bunu önlemek daha çok yazmayı değil, yalnızca doğru olanı yazmayı gerektirir.

Her şeyi değil, önemli olanı kaydet

İyi belgeleme her hareketin günlüğü değildir. Sonraki bir kararı anlaşılır kılan bilgiyi korur. Her ayrıntıyı kaydetmek gürültü üretir. Sadece sonucu saklamak ise bilmece üretir. Arada kısa ve sağlam bir açıklama vardır: Amaç neydi? Ne kararlaştırıldı? Çalıştığını nasıl anlarız? Birinin faydalı biçimde devam etmek için ne bilmesi gerekir?

Bu sorular özellikle insanlar, araçlar veya konuşmalar değiştiğinde önemlidir. Yeni bir sistem geçmiş hakkında romana ihtiyaç duymaz. Açık bir duruma ihtiyacı vardır: hedef, malzeme, kurallar, açık soru ve sonraki incelenebilir adım. Bu, devamlılık için yeterli ve güncel tutmak için yeterince küçüktür.

Basit bir kural yardımcı olur: yeniden okuduğunda kendinin unutmuş olacağı şeyi belgele. Apaçık olanı değil, şaşırtıcı olanı — artık kimsenin aklında tutmadığı o dönüşü. Bu tek soru kaydı küçük, değerini yüksek tutar.

Yolu olmayan sonuca güvenmek zordur

Birkaç ay sonra ikna edici bir dosya bulduğunu düşün. Tam görünür. Fakat neden tam bu yapı seçildi? Hangi kaynaklar veya gereksinimler belirleyiciydi? Bilinçli olarak ne dışarıda bırakıldı? Bu cevaplar olmadan her değişiklik tahmine dönüşür. Metni veya aracı kullanabilirsin ama uyarlamanın ilk amacı koruyup korumadığını güvenilir biçimde değerlendiremezsin.

Belgeleme yolu dokunulmaz kılmaz. Onu görünür kılar. Tam da bu nedenle sonra geliştirmek mümkündür. Varsayımlara dair not, eski kararların savunması değildir. Onları yeni bilgiyle test etmeye davettir.

Güven mükemmellikten değil, izlenebilirlikten doğar. Görünür biçimde gerekçelendirilmiş bir sonuç hata içerebilir — bulup düzeltebilirsin. Gerekçesiz bir sonuca ya körü körüne inanılır ya da tamamen atılır. Yol, üçüncü seçeneği açan şeydir: bilinçli değiştirmek.

En küçük faydalı proje kaydı

Birçok çalışma için bir sayfa yeterlidir. Hedefi anlatan bir cümleyle başlar: Hangi sorun, kim için daha kolay olmalı? Bunun altında kullanılan malzemeler, en önemli kararlar ve sonucun uyması gereken kurallar yer alır. Ardından açık noktalar ve çalışmayı kontrol etmek veya tekrarlamak için kısa yönerge gelir.

Bu yapı olguları, kararları ve varsayımları ayırır. Bu ayrım önemlidir. Malzeme değişebilir. Kararlar gözden geçirilebilir. Varsayımlar test ister. Her şey sadece akıcı metindeyse bu durumlar bulanıklaşır. Ayrı durduklarında proje, hiç kimse geçmişini tahmin etmek zorunda kalmadan yaşayabilir.