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

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

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.
• Hata kayıtları önceliğe göre sınıflandırılır.

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.

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.

07Planlama 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.

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

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

09Pendik'te uzman desteği

Pendik'in PTT verisindeki 36 yerleşim kaydı 9 farklı posta koduna dağılır. Birden fazla ilçede ekibi veya şubesi olan işletmelerde kaynak kod düzenleme ve dokümantasyon için kullanıcı rolleri, şube bazlı görünürlük ve merkezi raporlar birlikte planlanır.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Pendik'teki 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 Şile, Üsküdar ve Sarıyer 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
• sürüm yükseltme
• teknik borç
• otomatik test
• refactoring
• İstanbul
• Pendik