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

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
• Tüm sistemi aynı anda yeniden yazmaya kalkmak
• Hatayı yeniden üretmeden kod değiştirmek

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

• Dokümantasyon değişikliklerle birlikte güncellenir.
• 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.

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.

Yeni özellik eklemek her seferinde riskli olduğunda

Kod iyileştirme ve test otomasyonu ile değişiklik maliyeti düşürülür.

07Kapsamı ve maliyeti etkileyenler

• kullanılan teknolojilerin güncelliği
• erişimlerin hazır olup olmadığı
• dokümantasyon ve test kapsamı
• aylık bakım mı olay bazlı iş mi

08Planlama notları

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

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

• Yarım kalan projeler
• Mobil uygulamalar
• Web siteleri
• Özel yazılımlar

10Hacılar'da uzman desteği

Hacılar'ın PTT verisindeki 12 yerleşim kaydı 2 farklı posta koduna dağılır.

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

Aynı ildeki Bünyan, Sarıoğlan ve İncesu 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
• hata kaydı
• otomatik test
• Kayseri
• Hacılar