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

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

• Hatayı yeniden üretmeden kod değiştirmek
• Sürüm kontrolü kullanmamak
• Tüm sistemi aynı anda yeniden yazmaya kalkmak

05İş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.
• Aylık bakım raporunda yapılan işler ve açık riskler paylaşılır.

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

• Eski (legacy) sistemler
• Özel yazılımlar
• Web siteleri
• Mobil uygulamalar

07Hangi durumlarda gündeme gelir?

Yeni özellik eklemek her seferinde riskli olduğunda

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

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

Profil analiziyle darboğaz bulunur; sorgu, önbellek ve kod iyileştirmesi yapılır.

08Kapsamı ve maliyeti etkileyenler

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

09Planlama notları

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

10Gümüşhane'de uzman desteği

PTT kayıtlarına göre Gümüşhane genelinde 6 ilçe ve 1.087 mahalle ve köy kaydı bulunur; il, Karadeniz Bölgesi'ndedir. Gümüşhane'de PTT verisine göre 1 OSB/SB kaydı bulunur; üretim ve tedarik zinciriyle çalışan işletmelerde kaynak kod düzenleme ve dokümantasyon için B2B süreçler ve mevcut programlarla entegrasyon ayrıca konuşulur.

Mesafe yazılım işinin önünde engel değildir: Gümüşhane'deki ekiplerle görüntülü görüşme, ekran paylaşımı ve test ortamı bağlantısıyla çalışılır; cihaz kurulumu veya saha keşfi gerekirse yerinde ziyaret planlanır.

Karadeniz Bölgesi'ndeki Zonguldak, Tokat ve Kastamonu gibi illerdeki işletmelerle de 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
• refactoring
• Playwright
• Gümüşhane