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

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

• Sürüm kontrolü kullanmamak
• Hatayı yeniden üretmeden kod değiştirmek
• Yapılan değişiklikleri belgelememek

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

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

• Mobil uygulamalar
• Eski (legacy) sistemler
• E-ticaret siteleri
• Özel yazılımlar

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

• Hata kayıtları önceliğe göre sınıflandırılır.
• Dokümantasyon değişikliklerle birlikte güncellenir.
• Her değişiklik sürüm kontrolünde kaydedilir ve test ortamında denenir.

08Planlama notları

• Bakım kapsamı yazılı tanımlanır: izleme, güncelleme, hata düzeltme, küçük geliştirme.
• Önce kritik hatalar ve güvenlik güncellemeleri, sonra yeni özellikler.
• Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.

09Osmangazi'de uzman desteği

Osmangazi'nin PTT verisindeki 137 yerleşim kaydı 21 farklı posta koduna dağılır. Bu kayıtlardan 1 tanesi organize sanayi veya serbest bölge kaydıdır. Birden fazla ilçede ekibi veya şubesi olan işletmelerde kaynak kod düzenleme ve dokümantasyon için kullanıcı rolleri, şube bazlı görünürlük ve merkezi raporlar birlikte planlanır.

Osmangazi'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. Osmangazi'de 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.

Bursa genelinde İnegöl, Karacabey ve Orhangazi 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
• test ortamı
• teknik borç
• Bursa
• Osmangazi