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

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
• Test ortamı olmadan canlıda düzeltme yapmak

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

• Dokümantasyon değişikliklerle birlikte güncellenir.
• Hata kayıtları önceliğe göre sınıflandırılır.
• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.

06Planlama notları

• 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.
• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.

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

• Mobil uygulamalar
• Yarım kalan projeler
• Eski (legacy) sistemler
• Web siteleri

08Kapsamı ve maliyeti etkileyenler

• aylık bakım mı olay bazlı iş mi
• kod tabanının büyüklüğü ve durumu
• dokümantasyon ve test kapsamı
• erişimlerin hazır olup olmadığı

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

Yazılım yavaşladığında

Profil analiziyle darboğaz bulunur; sorgu, önbellek ve kod iyileştirmesi yapılır.

10Eğirdir'de uzman desteği

Eğirdir'in PTT verisindeki 80 yerleşim kaydı 3 farklı posta koduna dağılır.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Eğirdir'deki 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.

Aynı ildeki Sütçüler, Yenişarbademli ve Uluborlu 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
• refactoring
• hata kaydı
• sürüm yükseltme
• Isparta
• Eğirdir