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

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

• Test ortamı olmadan canlıda düzeltme yapmak
• Tüm sistemi aynı anda yeniden yazmaya kalkmak
• Yapılan değişiklikleri belgelememek

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

06Planlama notları

• Önce kritik hatalar ve güvenlik güncellemeleri, sonra yeni özellikler.
• İş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.

07Kapsamı ve maliyeti etkileyenler

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

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

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

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

• Bağımlılık güvenlik uyarıları düzenli taranır.
• Dokümantasyon değişikliklerle birlikte güncellenir.
• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.

10Batman'da uzman desteği

PTT kayıtlarına göre Batman genelinde 6 ilçe ve 737 mahalle ve köy kaydı bulunur; il, Güneydoğu Anadolu Bölgesi'ndedir.

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

Güneydoğu Anadolu Bölgesi'ndeki Şırnak, Adıyaman ve Kilis gibi illerdeki işletmelerle de 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ı
• hata kaydı
• Playwright
• otomatik test
• Batman