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

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
• Sürüm kontrolü kullanmamak
• Hatayı yeniden üretmeden kod değiştirmek

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

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

06Hangi durumlarda gündeme gelir?

Yazılım yavaşladığında

Profil analiziyle darboğaz bulunur; sorgu, önbellek ve kod iyileştirmesi yapı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.

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

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

08Planlama notları

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

09Kapsamı ve maliyeti etkileyenler

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

10Tillo'da uzman desteği

Tillo, Siirt iline bağlı bir ilçedir ve PTT adres verisine göre 13 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; Tillo'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.

Siirt genelinde Baykan, Şirvan ve Pervari 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
• otomatik test
• hata kaydı
• sürüm yükseltme
• Playwright
• Siirt
• Tillo