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

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

• Yapılan değişiklikleri belgelememek
• Hatayı yeniden üretmeden kod değiştirmek
• Sürüm kontrolü kullanmamak

05Kapsamı ve maliyeti etkileyenler

• aciliyet ve destek penceresi
• kod tabanının büyüklüğü ve durumu
• aylık bakım mı olay bazlı iş mi
• kullanılan teknolojilerin güncelliği

06Hangi 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.

Yazılımı geliştiren firma artık ulaşılamaz olduğunda

Kaynak kod düzenleme ve dokümantasyon kapsamında kod ve erişimler devralınır, belgelenir ve risk analizi çıkarılır.

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.

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

• Yarım kalan projeler
• Özel yazılımlar
• Eski (legacy) sistemler
• Mobil uygulamalar

09Planlama notları

• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.
• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.
• Önce kritik hatalar ve güvenlik güncellemeleri, sonra yeni özellikler.

10Bolu'da uzman desteği

Bolu, Karadeniz Bölgesi'nde yer alan, plaka kodu 14 olan bir ildir; PTT verisine göre 9 ilçe ve 1.598 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; Bolu'daki 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 Bayburt, Rize ve Kastamonu 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
• sürüm yükseltme
• Playwright
• refactoring
• teknik borç
• Bolu