01Adımlar
1. Kod, erişimler ve ortamlar üzerinde durum tespiti yapmak
Gerekirse bu adım test ortamında önceden denenir.
2. Riskleri ve öncelikleri listelemek
Gerekirse bu adım test ortamında önceden denenir.
3. Test ortamı ve sürüm kontrolünü düzene sokmak
Gerekirse bu adım test ortamında önceden denenir.
4. Kritik hataları ve güvenlik açıklarını gidermek
Bu adımda yapılan her değişiklik kayıt altına alınır.
5. Testleri ve dokümantasyonu tamamlamak
Bu adımda yapılan her değişiklik kayıt altına alınır.
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: hatayı yeniden üretmeden kod değiştirmek
- Kaçınılması gereken: sürüm kontrolü kullanmamak
03Belirti, neden ve çözüm
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Önceki firmaya ulaşılamıyor | Kod/erişim işletmede değil | Devralma ve erişim kurtarma |
| Her düzeltme yeni hata doğuruyor | Test yok | Otomatik testler |
| Eski PHP/framework sürümü | Güncelleme yapılmamış | Kademeli sürüm yükseltme |
04Safranbolu için çalışma düzeni
Safranbolu, Karabük iline bağlı bir ilçedir ve PTT adres verisine göre 202 mahalle ve köy kaydından oluşur.
Mesafe yazılım işinin önünde engel değildir: Safranbolu'daki 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.
Aynı ildeki Karabük Ovacık, Eflani ve Karabük Merkez ilçeleri için de kaynak kod düzenleme ve dokümantasyon talepleri değerlendirilir; toplantılar uzaktan yapılır.
Sorunu kısa bir notla ve ekran görüntüsüyle WhatsApp'tan iletin; kaynak kod düzenleme ve dokümantasyon için ön değerlendirme yapalım. Telefon: 0540 003 19 81.
05Planlama notları
- Kaynak kod ve sunucu erişimi işletmede olmalıdır; değilse önce bu çözülür.
- 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.
06Hangi durumlarda gündeme gelir?
Yazılım yavaşladığında
Profil analiziyle darboğaz bulunur; sorgu, önbellek ve kod iyileştirmesi yapılır.
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.
07Örnek planlama hesabı
Örnek: otomasyonla kazanılan süre
- Günlük tekrarlanan iş
- 94
- İş başına süre
- 8 dk
- Aylık süre (22 iş günü)
- 275,7 saat
- Otomasyon sonrası doğrulama payı (%12)
- 33,1 saat
Not: örnek hesaptır; kesin plan analizde çıkar.
SSSSık sorulan sorular
Kaynak kod düzenleme ve dokümantasyon öncesinde neleri hazırlamalıyım?
Kaynak kod deposu, sunucu ve veritabanı erişimi ve varsa mevcut dokümanlar ve hata kayıtları işi hızlandırır.
Bu adımları kendim uygulayabilir miyim?
Bazı adımlar teknik bilgiyle yapılabilir; yedekleme, sürüm uyumu ve canlı ortam değişiklikleri ise deneyim gerektirir. Kendin yap mı uzman mı sayfasında ayrımı anlattık.
Bakım anlaşmasında neler olur?
İzleme, güncelleme, yedek kontrolü, hata düzeltme ve küçük geliştirmeler kapsamda yazılı olarak belirtilir; kapsam dışı işler ayrıca planlanır.
Sadece Karabük için mi çalışıyorsunuz?
Evet. Askadar Yazılım, Türkiye'nin 81 ilindeki işletmelerle uzaktan çalışır; gerektiğinde yerinde çalışma ayrıca planlanır.
Safranbolu'dan yazıyorum; toplantılar nasıl yapılıyor?
Analiz, tasarım ve geliştirme çoğunlukla uzaktan, görüntülü toplantılarla yürür; donanım kurulumu, saha keşfi veya kullanıcı eğitimi gereken işlerde yerinde çalışma planlanır.
Adımların sırası değişebilir mi?
Mevcut duruma göre değişebilir; ancak yedek ve test adımları her zaman önce gelir.
Kaynak kod düzenleme ve dokümantasyon sırasında site veya uygulama kapanır mı?
Hazırlık test ortamında yapılır; canlı ortamdaki değişiklik önceden haber verilen kısa bir bakım penceresinde uygulanır.
→İlgili sayfalar
Kaynak Kod Düzenleme ve Dokümantasyon hakkında diğer konular
- Kaynak kod düzenleme ve dokümantasyon kontrol listesiAdım adım kontrol listesi
- Kaynak kod düzenleme ve dokümantasyon sık yapılan hatalarKaçınılması gerekenler
- Kaynak kod düzenleme ve dokümantasyon fiyatlarıMaliyeti belirleyenler
- Kaynak kod düzenleme ve dokümantasyon sonrası bakımİşlem sonrası kalıcılık
- Kaynak kod düzenleme ve dokümantasyonTespit, uygulama ve teslim
Safranbolu'da ilgili hizmetler
Karabük içindeki diğer ilçeler
Bu sayfada geçen kavramlar
- README
- mimari şema
- kurulum kılavuzu
- bakım sözleşmesi
- dokümantasyon
- Git
- refactoring
- teknik borç
- test ortamı
- hata kaydı
- Karabük
- Safranbolu