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

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

• Test ortamı olmadan canlıda düzeltme yapmak
• Hatayı yeniden üretmeden kod değiştirmek
• Tüm sistemi aynı anda yeniden yazmaya kalkmak

05Planlama notları

• 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.
• İşe kod ve altyapı incelemesiyle başlanır: kaynak kod, erişimler, sürümler, dokümantasyon.

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

• Dokümantasyon değişikliklerle birlikte güncellenir.
• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.
• Bağımlılık güvenlik uyarıları düzenli taranır.

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

• Özel yazılımlar
• Mobil uygulamalar
• E-ticaret siteleri
• Web siteleri

08Kapsamı ve maliyeti etkileyenler

• dokümantasyon ve test kapsamı
• erişimlerin hazır olup olmadığı
• kullanılan teknolojilerin güncelliği
• aciliyet ve destek penceresi

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

10Tatvan'da uzman desteği

Tatvan, Bitlis iline bağlı bir ilçedir ve PTT adres verisine göre 119 mahalle ve köy kaydından oluşur.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Tatvan'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 Güroymak, Ahlat ve Adilcevaz 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
• teknik borç
• refactoring
• Playwright
• Bitlis
• Tatvan