Kaynak kod düzenleme ve dokümantasyon nasıl yapılır? Konak rehberi

01Adımlar

1. Kod, erişimler ve ortamlar üzerinde durum tespiti yapmak

Bu adımın çıktısı kısa bir notla paylaşılır.

2. Riskleri ve öncelikleri listelemek

Bu adımın çıktısı kısa bir notla paylaşılır.

3. Test ortamı ve sürüm kontrolünü düzene sokmak

Adım tamamlanmadan bir sonrakine geçilmez; sonuç doğrulanır.

4. Kritik hataları ve güvenlik açıklarını gidermek

Gerekirse bu adım test ortamında önceden denenir.

5. Testleri ve dokümantasyonu tamamlamak

Gerekirse bu adım test ortamında önceden denenir.

6. Düzenli bakım ve geliştirme planına geçmek

Gerekirse bu adım test ortamında önceden denenir.

02Dikkat noktaları

• Kaçınılması gereken: yapılan değişiklikleri belgelememek
• Kaçınılması gereken: test ortamı olmadan canlıda düzeltme yapmak
• Kaçınılması gereken: tüm sistemi aynı anda yeniden yazmaya kalkmak

03Belirti, neden ve çözüm

04Konak için çalışma düzeni

Konak, İzmir iline bağlı bir ilçedir ve PTT adres verisine göre 113 mahalleden oluşur. 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.

Yazılım projelerinde analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; Konak'taki 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.

İzmir genelinde Gaziemir, Çiğli ve Karaburun gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

05Kapsamı ve maliyeti etkileyenler

• aylık bakım mı olay bazlı iş mi
• kullanılan teknolojilerin güncelliği
• kod tabanının büyüklüğü ve durumu
• dokümantasyon ve test kapsamı

06Örnek kapsam hesabı

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
• İzmir
• Konak