Kaynak kod düzenleme ve dokümantasyon: kendin yap mı, uzman mı? (Köprüköy)

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
• Test ortamı olmadan canlıda düzeltme yapmak
• Sürüm kontrolü kullanmamak

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

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

06Planlama notları

• İş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.
• Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.

07Hangi durumlarda gündeme gelir?

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.

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.

08Kapsamı ve maliyeti etkileyenler

• aylık bakım mı olay bazlı iş mi
• kod tabanının büyüklüğü ve durumu
• aciliyet ve destek penceresi
• dokümantasyon ve test kapsamı

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

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

10Köprüköy'de uzman desteği

Köprüköy, Erzurum iline bağlı bir ilçedir ve PTT adres verisine göre 42 mahalleden oluşur.

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

Erzurum genelinde Aşkale, Oltu ve Uzundere 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
• otomatik test
• sürüm yükseltme
• refactoring
• Erzurum
• Köprüköy