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

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

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

05İş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.

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

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

07Planlama notları

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

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.

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.

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

10Artova'da uzman desteği

PTT kayıtlarında Artova ilçesine bağlı 37 yerleşim bulunur: 5 mahalle ile 32 köy ve köy yerleşimi.

Artova'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.

Tokat genelinde Reşadiye, Almus ve Tokat Merkez 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
• test ortamı
• Playwright
• sürüm yükseltme
• Tokat
• Artova