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

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
• Tüm sistemi aynı anda yeniden yazmaya kalkmak
• Hatayı yeniden üretmeden kod değiştirmek

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

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

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

07Planlama notları

• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.
• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.
• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.

08Kapsamı ve maliyeti etkileyenler

• kod tabanının büyüklüğü ve durumu
• erişimlerin hazır olup olmadığı
• aylık bakım mı olay bazlı iş mi
• kullanılan teknolojilerin güncelliği

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

• Her değişiklik sürüm kontrolünde kaydedilir ve test ortamında denenir.
• Bağımlılık güvenlik uyarıları düzenli taranır.
• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.

10Aslanapa'da uzman desteği

PTT kayıtlarında Aslanapa ilçesine bağlı 44 yerleşim bulunur: 4 mahalle ile 40 köy ve köy yerleşimi.

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

Kütahya genelinde Kütahya Merkez, Simav ve Emet gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

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ç
• hata kaydı
• refactoring
• Kütahya
• Aslanapa