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

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

• Hatayı yeniden üretmeden kod değiştirmek
• Tüm sistemi aynı anda yeniden yazmaya kalkmak
• Yapılan değişiklikleri belgelememek

05Kapsamı ve maliyeti etkileyenler

• dokümantasyon ve test kapsamı
• aciliyet ve destek penceresi
• kullanılan teknolojilerin güncelliği
• aylık bakım mı olay bazlı iş mi

06Planlama notları

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

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

• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.
• Hata kayıtları önceliğe göre sınıflandırılır.
• Dokümantasyon değişikliklerle birlikte güncellenir.

08Hangi durumlarda gündeme gelir?

Yeni özellik eklemek her seferinde riskli olduğunda

Kod iyileştirme ve test otomasyonu ile değişiklik maliyeti düşürü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.

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

• Mobil uygulamalar
• E-ticaret siteleri
• Yarım kalan projeler
• Özel yazılımlar

10Manyas'ta uzman desteği

Manyas, Balıkesir iline bağlı bir ilçedir ve PTT adres verisine göre 50 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; Manyas'taki 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.

Balıkesir genelinde Ayvalık, Savaştepe ve Bigadiç 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ı
• sürüm yükseltme
• refactoring
• teknik borç
• Balıkesir
• Manyas