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

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

• Tüm sistemi aynı anda yeniden yazmaya kalkmak
• Sürüm kontrolü kullanmamak
• Test ortamı olmadan canlıda düzeltme yapmak

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

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

06Planlama notları

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

07Kapsamı ve maliyeti etkileyenler

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

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

• Hata kayıtları önceliğe göre sınıflandırılır.
• Bağımlılık güvenlik uyarıları düzenli taranır.
• Dokümantasyon değişikliklerle birlikte güncellenir.

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.

Yeni özellik eklemek her seferinde riskli olduğunda

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

10Altıeylül'de uzman desteği

Altıeylül, Balıkesir iline bağlı bir ilçedir ve PTT adres verisine göre 95 mahalleden oluşur. 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.

Mesafe yazılım işinin önünde engel değildir: Altıeylül'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.

Balıkesir genelinde Kepsut, Balıkesir Edremit ve Ayvalık 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
• Balıkesir
• Altıeylül