Kaynak kod düzenleme ve dokümantasyon: kendin yap mı, uzman mı? (Bayburt)

01Kendiniz yapabilecekleriniz

• tüm erişim bilgilerini tek listede toplamak
• hataları ekran görüntüsü ve adımlarıyla kaydetmek
• kritik iş akışlarını yazılı hale getirmek

02Uzman gerektirenler

• kod denetimi ve teknik borç analizi
• regresyon testleriyle güvenli düzeltme
• sürüm yükseltme ve mimari iyileştirme

03Belirti, neden ve çözüm

04Yanlış uygulamanın riskleri

• Sürüm kontrolü kullanmamak
• Tüm sistemi aynı anda yeniden yazmaya kalkmak
• Yapılan değişiklikleri belgelememek

05Hangi durumlarda gündeme gelir?

Yeni özellik eklemek her seferinde riskli olduğunda

Kod iyileştirme ve test otomasyonu ile değişiklik maliyeti düşürülür.

README gerektiğinde

README, kaynak kod düzenleme ve dokümantasyon projesinde kapsamın başında konuşulan başlıklardandır; analizde kimin kullanacağı ve nasıl çalışacağı netleştirilir.

06Kaynak kod düzenleme ve dokümantasyon hangi işletmelerde kullanılır?

• Özel yazılımlar
• Eski (legacy) sistemler
• Mobil uygulamalar
• E-ticaret siteleri

07İşletim ve bakım ipuçları

• Dokümantasyon değişikliklerle birlikte güncellenir.
• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.
• Her değişiklik sürüm kontrolünde kaydedilir ve test ortamında denenir.

08Planlama notları

• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.
• Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.
• Önce kritik hatalar ve güvenlik güncellemeleri, sonra yeni özellikler.

09Kapsamı ve maliyeti etkileyenler

• aciliyet ve destek penceresi
• dokümantasyon ve test kapsamı
• kod tabanının büyüklüğü ve durumu
• erişimlerin hazır olup olmadığı

10Bayburt'ta uzman desteği

Bayburt, Karadeniz Bölgesi'nde yer alan, plaka kodu 69 olan bir ildir; PTT verisine göre 3 ilçe ve 229 mahalle ve köy kaydından oluşur.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Bayburt'taki işletmelerle ekran paylaşımlı demolar ve ortak bir proje panosu üzerinden çalışılır. Donanım kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.

Karadeniz Bölgesi'ndeki Samsun, Karabük ve Düzce gibi illerdeki işletmelerle de toplantılar uzaktan yapılır.

SSSSık sorulan sorular

→İlgili sayfalar

Bu sayfada geçen kavramlar

• README
• mimari şema
• kurulum kılavuzu
• bakım sözleşmesi
• dokümantasyon
• Git
• teknik borç
• Playwright
• hata kaydı
• test ortamı
• Bayburt