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

01Belirtiler, olası nedenler ve ilk kontrol

Kodu yazan kişiye veya firmaya ulaşılamaması

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üçük bir değişikliğin başka yerleri bozması

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

Dokümantasyon ve kurulum bilgisinin olmaması

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

02Kategoride sık görülen sorunlar

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

04Planlama notları

• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.
• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.
• Değişiklikler sürüm kontrolüyle (Git) ve test ortamında yapılır.

05Kapsamı ve maliyeti etkileyenler

• kullanılan teknolojilerin güncelliği
• kod tabanının büyüklüğü ve durumu
• erişimlerin hazır olup olmadığı
• dokümantasyon ve test kapsamı

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

• Yarım kalan projeler
• Mobil uygulamalar
• Özel yazılımlar
• Eski (legacy) sistemler

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

08Adilcevaz'da hızlı tespit

PTT kayıtlarında Adilcevaz ilçesine bağlı 51 yerleşim bulunur: 14 mahalle ile 37 köy ve köy yerleşimi.

Adilcevaz'da bulunan bir işletmeyle çalışırken toplantılar görüntülü yapılır, her aşama test ortamında paylaşılır ve geri bildirimler ortak panoda toplanır; yerinde bulunmak gereken kurulum ve eğitim adımları ayrıca planlanır.

Bitlis genelinde Bitlis Merkez, Güroymak ve Ahlat 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
• Playwright
• refactoring
• hata kaydı
• otomatik test
• Bitlis
• Adilcevaz