Kaynak kod düzenleme ve dokümantasyon gerektiren sorunlar ve belirtiler (Sincik)

01Belirtiler, olası nedenler ve ilk kontrol

Dokümantasyon ve kurulum bilgisinin olmaması

Olası neden: kod/erişim işletmede değil. İlk kontrol: devralma ve erişim kurtarma.

Hataların tekrar tekrar ortaya çıkması

Olası neden: test yok. İlk kontrol: otomatik testler.

Kütüphane ve çatı sürümlerinin desteğinin bitmesi

Olası neden: güncelleme yapılmamış. İlk kontrol: kademeli sürüm yükseltme.

Küçük bir değişikliğin başka yerleri bozması

Olası neden: kod/erişim işletmede değil. İlk kontrol: devralma ve erişim kurtarma.

02Kategoride sık görülen sorunlar

03Planlama 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.
• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.

04Kapsamı ve maliyeti etkileyenler

• erişimlerin hazır olup olmadığı
• aciliyet ve destek penceresi
• kullanılan teknolojilerin güncelliği
• aylık bakım mı olay bazlı iş mi

05Kaynak 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

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

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

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

08Sincik'te hızlı tespit

Sincik'in PTT verisindeki 93 yerleşim kaydı 3 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; Sincik'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 Besni, Adıyaman Merkez ve Kahta 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
• Playwright
• otomatik test
• Adıyaman
• Sincik