Tut'ta kaynak kod düzenleme ve dokümantasyon

01Hangi durumlarda gerekir?

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.

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

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

02Belirtiler

• Hataların tekrar tekrar ortaya çıkması
• Küçük bir değişikliğin başka yerleri bozması
• Dokümantasyon ve kurulum bilgisinin olmaması
• Kütüphane ve çatı sürümlerinin desteğinin bitmesi

03Belirti, neden ve çözüm

04Hangi sistemlerde uygulanır?

• Web siteleri
• Özel yazılımlar
• Mobil uygulamalar
• E-ticaret siteleri
• Yarım kalan projeler
• Eski (legacy) sistemler

05İş nasıl ilerler?

1. Kod, erişimler ve ortamlar üzerinde durum tespiti yapmak
2. Riskleri ve öncelikleri listelemek
3. Test ortamı ve sürüm kontrolünü düzene sokmak
4. Kritik hataları ve güvenlik açıklarını gidermek
5. Testleri ve dokümantasyonu tamamlamak
6. Düzenli bakım ve geliştirme planına geçmek

06Kapsam

• README
• mimari şema
• kurulum kılavuzu

Bu projeler çoğu zaman yazılım projesi kurtarma, üçüncü taraf yazılıma modül ve yazılım projesi devralma gibi işlerle birlikte ele alınır.

07Tut'ta kaynak kod düzenleme ve dokümantasyon

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

Adıyaman genelinde Adıyaman Gölbaşı, Adıyaman Merkez ve Çelikhan gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

08Çalışma düzenimiz

Çalışma düzenimizde sürüm kontrolü, otomatik testler, konteyner tabanlı yayın ve izleme araçları standarttır; her değişiklik bu adımlardan geçerek canlıya çıkar.

• Yayın sonrası bakım ve destek planlanır.
• Her değişiklik önce test ortamında denenir.
• Kapsam ve teslim kriterleri yazılı olur.

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz: görüntülü toplantı, ekran paylaşımlı demo ve ortak proje panosu. Donanım kurulumu, depo barkod sistemi kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanı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
• sürüm yükseltme
• refactoring
• otomatik test
• Adıyaman
• Tut