Kullanılabilir teslim; kaynak dosyaları, yayın talimatlarını, içerikleri ve açık hesap kontrolünü içerir. Ekiple çalışırken erişimi doğrulayın. Yeni bakım sorumlusundan güncel kaynağı bulmasını, üretim sunucusunu tanımlamasını ve metin değişikliğinin nasıl yayınlandığını açıklamasını isteyin. Derleme belgesiz servislere veya sırlara bağlıysa tek başına zip dosyası yeterli olmayabilir.
Dosya sahibi olmakla hesapları yönetmek aynı şey değildir
Adı web sitesi olan bir klasörü almak, siteyi sürdürebileceğiniz anlamına gelmeyebilir. Alan adı, DNS, barındırma, kaynak kod deposu ve kurumsal e-posta farklı hesaplarda olabilir. İyi teslim, her hizmetin hangi hesapta bulunduğunu, sahibini, amacını ve yenileme sorumlusunu belirtir. Bu envanter özel tutulmalıdır; herkese açık dokümantasyon sayfası değildir.
Tedarikçi değişse de devam edebilen sahiplik düzenini tercih edin. Mümkünse ana hesaplar işletmenin olur, işbirliği yapanlara gerekli yetki verilir. Tek parolayı birçok kişiyle paylaşmak sonraki değişikliklerin izlenmesini zorlaştırır. Kurtarma adreslerini ve erişim yöntemlerini ilk ekip hâlâ ulaşılabilirken doğrulayın. Parola, kurtarma kodu veya yayın secret'larını depoya yazmayın.
Örneğin alan adı müşteride, hosting tedarikçide olabilir. Bu bilinçli bir düzen olabilir; ancak bakım sona ererse ne olacağı anlaşılmalıdır. Site dışa aktarılabilir mi, hangi hizmetlere bağlıdır, taşımak ne gerektirir? Açık cevap, her şey size ait gibi geniş bir cümleden daha işe yarar.
Başka bir geliştiricinin kullanabileceği teslim isteyin
Kaynak kod, siteyi yeniden üretmek için gerekli dosyaları, paket bilgilerini ve build talimatını içermelidir. Yalnız yayınlanmış HTML kopyası görüntülemeye yeterli olabilir fakat tasarımı düzenli değiştirmeye yetmeyebilir. Tersine, kurulum adımları ve ayar notları bulunmayan kaynak deposu da sonraki geliştiriciyi tahmine zorlar.
Herkese açık ayarlar, özel çalışma zamanı değişkenleri ve ayrıca sağlanacak secret'lar için kısa açıklama isteyin. Gereken ayarın adı dokümana yazılır, gerçek gizli değeri yazılmaz. Veritabanı varsa şema ve migration süreci bulunmalı; müşteri kayıtları teslim örneğine karışmamalıdır. Özgün içerikler, lisans kayıtları ve düzenlenebilir tasarım kaynaklarının kapsamda olup olmadığı açıkça listelenmelidir.
Pratik kontrol, yetkili bir kişinin talimatları temiz bir klasörde izlemesidir. Bağımlılıklar kurulabiliyor mu, site üretilebiliyor mu, hangi dış hesapların gerekli olduğu anlaşılıyor mu? Bu, tedarikçinin yalnız kendi bilgisayarındaki belgelenmemiş ayarlara bağlı çalışan örneği göstermesinden daha sağlam bir doğrulamadır.
Canlı durumu ve devam eden sorumlulukları kaydedin
Teslim anında alan adını, yayın tarihini, kullanılan sürümü ve bilinen sınırları yazın. Formun işletim yolunu da belirtin: kayıt nereye gider, kim bakar, servis hatası nasıl fark edilir? Bildirim isteğe bağlıysa bildirim gelmemesiyle veritabanında kayıt oluşmamasını ayırın. İşletme gerçek başvuru geçmişinin hangi sistemde bulunduğunu bilmelidir.
Teslim sonrası desteği tanımlayın. Anlaşılmış işte hata düzeltmek, hizmet metni değiştirmek ve rezervasyon motoru eklemek farklı işlerdir. Açık destek düzeni, gelecekteki her isteğin otomatik ücretsiz veya tamamen sorumluluk dışı sayılmasını önler. Yenileme ve ücretli hizmet giderlerini de bu kayda bağlayın.
Projeyi kapatırken gereksiz geçici erişimleri kaldırın; devam eden erişimleri bilinçli tutun. Yetki değişiminden sonra siteyi ve formu tekrar kontrol edin, çünkü yayın veya kayıt işlemi etkilenebilir. İyi teslim dosyaları, kontrolü ve bilgiyi birlikte verir. İşletme ne aldığını, işletimin ne gerektirdiğini ve başka bir yetkili kişinin işi nasıl sürdürebileceğini anlar.
Teslimi küçük bir prova ile tamamlayın. Sahip veya yetkili bakım kişisi alan adı hesabını bulsun, güncel kaynak sürümünü belirlesin ve başvuruların nerede incelendiğini anlatsın. Sonra herhangi bir secret göstermeden yeniden üretim talimatına ulaşsın. Bu alıştırma dosyalar tek tek tam görünse de aralarındaki eksik bağlantıları ortaya çıkarabilir. Talimatın yalnız yazarı tarafından anlaşılması yeterli değildir.
Tedarikçide kalan erişimi ve nedenini yazın. Bakım anlaşması devam eden yetkiyi gerektirebilir; kapsamı bilinçli olmalıdır. Hesap aktarılamıyorsa sınırsız sahiplik sözü yerine dışa aktarım veya taşıma yolunu belgeleyin. DNS ve fatura değişimini kimin onaylayabileceğini belirtin. Rutin işlem başka projeyi veya alan adını yanlışlıkla etkilememelidir.
Son teslim listesi tarih ve kabul notu içersin. Orijinal satış teklifini tekrar etmek yerine gerçekten alınan dosya ve çalışan süreçleri anlatsın. Bir iş sahibin eksik hesabına bağlıysa açıkça işaretleyin. Böylece gelecekteki ekip, dış kurulum bağımlılığıyla hiç teslim edilmemiş kod veya içeriği ayırt eder. Bunların çözümü ve sorumlusu farklıdır.
Görsel ve font lisanslarını ayrıca kontrol edin. Kaynak kodun devri üçüncü taraf görselin her amaçla sınırsız kullanımını sağlamaz. Lisans metni, kaynak ve gerekiyorsa satın alma kaydı korunmalıdır. Müşterinin verdiği fotoğraf ve logo için de yayın yetkisi açıklığı gerekir. Dosya teslimi ile hakların niteliği birbirine karıştırılmamalıdır.
Sonraki geliştirici için küçük mimari özeti yararlıdır: hangi kısım statik, hangi endpoint dinamik, fiyat nereden geliyor, diller nasıl eşleniyor? Yüzlerce sayfa doküman gerekmez; doğru giriş noktaları gerekir. Bir deneme değişikliği yapıp önizlemeyi açabilmek teslimin anlaşılır olduğunu gösterir. İşletmenin bağımsızlığı her satırı kodlayabilmesi değil, yetkili birinin işi sürdürebileceği bilgi ve kontrolü elinde bulundurmasıdır.
Hesap envanterini örnek bir değişiklikle sınayın. İşletme yarın alan adı yenileme uyarısı alsa kim işlem yapacak, hangi hesap kullanılacak ve ödeme sorumlusu kim olacak? Bir sonraki geliştirici yeni sürüm yayınlayacaksa hangi yetkiye ihtiyacı var? Bu soruların cevabı dosya klasöründe bulunmuyorsa teslimde eksik bilgi olabilir. Erişim yönteminin kendisini belgeleyin ama secret değerini genel notlara koymayın. Yerel örnek ayarlar ile üretim ayarları ayırt edilsin. Başka Orvun projesinin hesabı veya veritabanı yanlışlıkla bu siteye ait sanılmamalıdır. Her kaynak adı amacını açıkça göstermelidir. Yetki kaldırılmadan önce gerekli erişimin sahibinde bulunduğu doğrulansın. Sonrasında site ve form tekrar açılarak denensin. Bu kısa prova, dosya teslimini gerçek işletim bağımsızlığına dönüştürür. İleride ekip değiştiğinde kimin neyi bildiğine dair belirsizliği azaltır.
Uygulama kontrolü
- Repo erişimini alın
- Alan adı ve DNS bilgisini belgeleyin
- Yedek ve geri yükleme adımlarını kaydedin
Somut örnek: Yeni bakım sorumlusundan güncel kaynağı bulmasını, üretim sunucusunu tanımlamasını ve metin değişikliğinin nasıl yayınlandığını açıklamasını isteyin.
Dikkat edilmesi gereken sınır: Derleme belgesiz servislere veya sırlara bağlıysa tek başına zip dosyası yeterli olmayabilir.
