Temel iş akışı08 / 16
Açıklamaları güncel tutun
Bu sayfada
Niyeti veya kodu değiştirdikten sonra açıklamaların hâlâ geçerli olup olmadığını kontrol edin. Proje genelinde dikkat gerektiren açıklamaları ele almak için kenar çubuğundaki Explain (Açıkla), tek bir içerik bölümünü kontrol etmek için paragrafın Investigation (Araştırma) eylemini kullanın.
Nelerin değiştiğini belirleyin
| Durum | Anlamı | Sonraki adım |
|---|---|---|
| Araştırılacak içerik | Yeni veya düzenlenmiş ifadenin kendine ait açıklaması yoktur. | Kaydedip araştırın. Gereksinim henüz karşılanmıyorsa önce uygulayın. |
| Önceki metnin açıklaması | Paragraf değişmiştir ama not hâlâ eski ifadeyi açıklıyordur. | Metin farklarını inceleyip yeniden araştırın. |
| Güncelliğini yitirmiş olabilir | Açıklamanın okuduğu veya kaynak gösterdiği dosyalar değişmiştir. | Değişen dosyaları inceleyip açıklamayı yeniden kontrol edin. |
| Değişiklik bulunamadı | Araştırılmayı bekleyen veya güncelliğini yitirmiş olabilecek diye işaretlenen içerik yoktur. | Gerektiğinde belirli soruları okumayı veya doğrulamayı sürdürün. |
“Güncelliğini yitirmiş olabilir” sonucu mutlaka yanlış demek değildir; dosya değişikliği ilgisiz olabilir. “Değişiklik bulunamadı” ise testlerin geçtiğinin veya bütün özelliklerin tamamlandığının kanıtı değildir.
Bir paragrafı araştırın
Belgeyi kaydedin, paragrafın üzerine gelin ve soldaki Investigation (Araştırma) seçeneğini kullanın. Mevcut bir kenar notu Investigate Again (Yeniden Araştır) seçeneğini de sunabilir.
Bu işlem yalnızca seçilen içeriğin açıklamasını günceller. İçerikte kaydedilmemiş değişiklikler varsa araştırma kullanılamaz ve Noea önce kaydetmenizi ister.
Örneğin, yinelenen ödülleri önleyen kodu değiştirdikten sonra ilgili kuralı araştırarak açıklamasının geçerli uygulamayı anlattığını kontrol edin.
Proje genelindeki açıklamaları güncelleyin
Araştırılmayı bekleyen içeriği ve destekleyici dosyaları değişmiş açıklamaları kontrol etmek için kenar çubuğundaki Explain (Açıkla) düğmesine tıklayın. Proje açık değilse, proje salt okunursa veya bağlı uygulama klasörü yoksa bu eylem kullanılamaz.
Elle başlatılan Explain görevi aşamaları, ilerlemeyi ve tek tek sonuçları gösteren bir sohbet açar. Görev çalışırken bu sohbete normal mesaj gönderemezsiniz; ancak projedeki diğer sohbetleri kullanabilirsiniz.
Görev bittiğinde hangi açıklamaların değiştiğini, hangilerinin doğru kaldığını ve hangi kontrollerin başarısız veya yarım kaldığını görmek için sonuçları genişletin. Bir görevin sona ermesi her kontrolün başarılı olduğu anlamına gelmez.
Explain'in neleri kontrol ettiğini anlayın
Explain niyeti kodla karşılaştırır ve hem paragraf düzeyindeki hem de yerel açıklamaları kontrol eder. Doğru içeriği korur, düzeltilmesi gerekenleri günceller; her açıklamayı yeniden yazması gerekmez.
Güncellenmiş açıklama testlerin yeniden çalıştırıldığı anlamına gelmez. Davranışı doğrulamak için normal bir sohbette ilgili kontrolleri isteyin, ardından ilgili içeriği araştırın. Doğrulamanın kapsamını yorumlamak için Açıklamaları ve kanıtları okuma bölümüne bakın.
Explain'in ne zaman otomatik çalıştığını bilin
Settings → Current Project → Automation → Explain automatically after implementing (Ayarlar → Geçerli Proje → Otomasyon → Uygulamadan sonra otomatik açıkla) varsayılan olarak etkindir. Başlıca tetikleyiciler şunlardır:
| Eylem | Otomatik Explain |
|---|---|
| Niyeti değiştiren ve hâlâ uygulama gerektiren bir öneriyi kabul etmek. | Uygulama görevi normal biçimde bittikten sonra. |
| Niyeti değiştiren ancak uygulama tarafından zaten karşılanan bir öneriyi kabul etmek. | Kabulden sonra. |
| Çalışmaya kenar çubuğundaki Realize ile başlamak. | İlk tur normal biçimde bittikten sonra. |
| Niyet metnini değiştiren bir düzenleme planını kabul etmek. | Kabulden sonra, yukarıdaki ayardan bağımsız olarak. |
| Yalnızca dosya adlarını veya klasör yapısını yeniden düzenlemek. | Tetiklenmez. |
| Normal sohbette yalnızca kodu değiştirmek, Implement Directly seçmek ya da uygulamanın başarısız olması veya durması. | Tetiklenmez; Explain'i elle çalıştırın. |
Otomatik Explain, normal bir sohbet oluşturmadan arka planda çalışır. Özgün sohbetinizde devam edin ve ilerlemeyi Runs (Çalıştırmalar) altında kontrol edin.
Kayıtları inceleyin ve yeniden çalıştırın
Kenar çubuğundaki Runs (Çalıştırmalar) bölümü açıklama görevlerini saklar. Bir görevi genişleterek çalıştırmalarının salt okunur kayıtlarını görüntüleyin. Sohbet değiştirdikten veya uygulamayı yeniden başlattıktan sonra da kayıtlara erişebilirsiniz.
Hata veya kesinti sonrasında Run Again (Yeniden Çalıştır) seçin. Mevcut açıklamalar korunur. Yeni çalışma bittiğinde daha önce başarısız veya yarım kalan öğelerin ele alındığını kontrol edin.
Her işlem için ajan seçin
Explain'in kullandığı ajan görevin nasıl başlatıldığına bağlıdır. Proje işlemi ayarları ve kapsamları için Ajanlar, modeller ve kullanım bölümüne bakın.
Açıklamalar güncellenmiyorsa Sorun giderme ve sık sorulan sorular bölümüne bakın.