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

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

• Tüm sistemi aynı anda yeniden yazmaya kalkmak
• Hatayı yeniden üretmeden kod değiştirmek
• Sürüm kontrolü kullanmamak

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?

• Yarım kalan projeler
• Web siteleri
• E-ticaret siteleri
• Eski (legacy) sistemler

07Kapsamı ve maliyeti etkileyenler

• erişimlerin hazır olup olmadığı
• aylık bakım mı olay bazlı iş mi
• aciliyet ve destek penceresi
• kullanılan teknolojilerin güncelliği

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

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

09Planlama notları

• Önce kritik hatalar ve güvenlik güncellemeleri, sonra yeni özellikler.
• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.
• Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.

10Gürpınar'da uzman desteği

Gürpınar'ın PTT verisindeki 79 yerleşim kaydı 1 farklı posta koduna dağılır. Büyükşehirlerde merkez ve şube yapısıyla çalışan işletmeler için kaynak kod düzenleme ve dokümantasyon tasarımında merkez-şube yetki yapısı ve birleşik raporlama öne çıkar.

Gürpınar'da bulunan bir işletmeyle çalışırken toplantılar görüntülü yapılır, her aşama test ortamında paylaşılır ve geri bildirimler ortak panoda toplanır; yerinde bulunmak gereken kurulum ve eğitim adımları ayrıca planlanır.

Aynı ildeki İpekyolu, Başkale ve Çaldıran ilçeleri için de kaynak kod düzenleme ve dokümantasyon talepleri değerlendirilir; 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
• hata kaydı
• Van
• Gürpınar