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.

Tekrarlanabilirlik: yeni bir başlangıç mümkündür

Tekrarlanabilirlik her sonucun son karakterine kadar aynı olması demek değildir. Başka bir kişinin ya da uzun aradan sonra senin, başlangıç noktasını, adımları ve kalite ölçütünü bulabilmesi demektir. Nelerin değiştiğini görebilir, alternatif deneyebilir ve sonuçları karşılaştırabilirsin.

Bu nedenle sadece ne yapıldığını yazma. Sonraki çalıştırmanın yeterince iyi olduğunu nasıl anlayacağını da yaz. Kısa bir kontrol çoğu kez uzun bir açıklamadan daha değerlidir: „cevabı bu üç gereksinimle karşılaştır", „eksik bilgiyi görünür tut" veya „varsayım kanıtsızsa dur". Belgeleme böylece etkin bir çalışma yardımına dönüşür.

Kalite kontrolü en kolay unutulan ve en çok ihtiyaç duyulan parçadır. „İyi görünüyor"u „şu noktaları karşılıyor"a çevirir. Bir kez yazıldığında, sonraki çalıştırmada ölçüt üzerine yeniden tartışılmaz; yalnızca ölçülür.

Tek sayfalık proje kaydı

Tek bir kayıt girişimi bir arada tutar. Hedefi, başlangıç noktasını, kararları, kuralları, açık noktaları ve bir tekrar yolunu tek sayfada toplar — kararlar hâlâ tazeyken kopyala ve doldur.

# PROJE KAYDI

**Hedef**
Bu çalışma … için … işini kolaylaştırmalı.

**Başlangıç noktası ve malzeme**
Önemli olanlar: …

**Alınan kararlar**
… seçtik, çünkü …

**Sonuç için kurallar**
… olmalı ve … olmamalı.

**Açık noktalar ve varsayımlar**
Hâlâ kontrol edilmesi gereken: …

**Nasıl tekrarlanır**
… ile başla. Sonra … kontrol et.

İyi bir proje kaydı değişime karşı sigorta değildir. Değişimi daha güvenli kılar. Hedef, kararlar, açık sorular ve kontroller görünür kaldığında proje; sohbetin, toplantının veya o anda üzerinde çalışan kişinin ötesinde bir geleceğe sahip olur.

Çalışma kâğıdı: Çalışmaya devam edebilen bir proje kaydı oluştur

Tamamlanmış ya da sürmekte olan bir çalışma seç. Kronoloji yazma. Altı ay sonra anlamlı biçimde yeniden başlayabileceğin tek bir sayfa hazırla.

Hedefi ve kullanıcıyı adlandır. Tek cümle yaz: Hangi sorun, kim için daha kolay oluyor? Somut yön vermeyen her kelimeyi çıkar.

Malzemeyi kararlardan ayır. En önemli temelleri, onlardan doğan kararlardan ayrı yaz. Sonradan değişebilecek bir kararı işaretle.

Varsayımları görünür bırak. En az bir varsayımı test edilebilir bir cümle olarak kur. Onu doğrulayacak veya sorgulayacak bilgiyi ekle.

Yeniden başlama yolunu yaz. Başlangıç noktasını, sonraki adımı ve kalite kontrolünü en fazla beş cümleyle anlat. Ardından kaydı projeyi bilmeyen birine ver.

İndirilecek tüm materyaller — konu özeti ve çalışma kâğıdı: