Eflani'de 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ı geliştiren firma artık ulaşılamaz olduğunda

Kaynak kod düzenleme ve dokümantasyon kapsamında kod ve erişimler devralınır, belgelenir ve risk analizi çıkarılır.

02Belirtiler

• Dokümantasyon ve kurulum bilgisinin olmaması
• Kütüphane ve çatı sürümlerinin desteğinin bitmesi
• Kodu yazan kişiye veya firmaya ulaşılamaması
• Küçük bir değişikliğin başka yerleri bozması

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

Kaynak kod düzenleme ve dokümantasyon ile birlikte sık planlanan işler arasında yazılım projesi kurtarma, üçüncü taraf yazılıma modül ve yazılım projesi devralma bulunur.

07Eflani'de kaynak kod düzenleme ve dokümantasyon

Eflani'nin PTT verisindeki 236 yerleşim kaydı 2 farklı posta koduna dağılır.

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

Karabük genelinde Safranbolu, Eskipazar ve Karabük Ovacık gibi diğer ilçelerdeki işletmelerle de aynı uzaktan çalışma düzeniyle ilerlenir.

08Ekip ve çalışma biçimimiz

Projeler tasarım, yazılım geliştirme, test ve yayın adımlarını kapsayan bir ekiple yürütülür. Sürüm kontrolü (Git), otomatik testler (Playwright), konteyner tabanlı yayın (Docker), sürekli entegrasyon ve izleme araçları standart çalışma düzenimizin parçasıdır.

• Kapsam ve teslim kriterleri yazılı olur.
• Her değişiklik önce test ortamında denenir.
• Alan adı ve sunucu hesapları işletme adına açılır.

Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışıyoruz; Karabük de bunlardan biri.

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
• teknik borç
• refactoring
• test ortamı
• Karabük
• Eflani