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

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
• Yapılan değişiklikleri belgelememek
• Hatayı yeniden üretmeden kod değiştirmek

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

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

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

• Her değişiklik sürüm kontrolünde kaydedilir ve test ortamında denenir.
• Hata kayıtları önceliğe göre sınıflandırılır.
• Bağımlılık güvenlik uyarıları düzenli taranır.

07Planlama notları

• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.
• Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.
• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.

08Hangi durumlarda gündeme gelir?

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.

Yeni özellik eklemek her seferinde riskli olduğunda

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

09Kapsamı ve maliyeti etkileyenler

• aylık bakım mı olay bazlı iş mi
• kod tabanının büyüklüğü ve durumu
• erişimlerin hazır olup olmadığı
• aciliyet ve destek penceresi

10Ahırlı'da uzman desteği

Ahırlı'nın PTT verisindeki 15 yerleşim kaydı 2 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.

Mesafe yazılım işinin önünde engel değildir: Ahırlı'daki ekiplerle görüntülü görüşme, ekran paylaşımı ve test ortamı bağlantısıyla çalışılır; cihaz kurulumu veya saha keşfi gerekirse yerinde ziyaret planlanır.

Aynı ildeki Selçuklu, Sarayönü ve Güneysınır 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
• test ortamı
• refactoring
• sürüm yükseltme
• Konya
• Ahırlı