Belge içeriği06 / 16

Temel iş akışı06 / 16

Niyet değişikliklerini tartışın ve inceleyin

Bu sayfada

Bir görüşme yeni bir ürün kararına ulaştığında ajandan bunu niyet önerisine dönüştürmesini isteyin. İfadeyi inceleyin, gerekiyorsa düzenleyin ve belgelerinize yazılıp yazılmayacağına karar verin.

Somut bağlamla başlayın

İlgili paragrafın üzerine gelin ve soldaki Ask about this (Bunu sor) seçeneğini kullanın. Noea giriş alanına bir başvuru ekler ve belgeyi sohbetin yanında gösterir. Mesajı otomatik olarak göndermez.

Belge, paragraf veya açıklama aramak için giriş alanına @ da yazabilirsiniz. Seçilen içerik başvuru etiketi olarak görünür ve mesajınızla birlikte ajana sağlanır.

Örneğin:

Bu ödül kuralı, bir giriş atlandığında ne olacağını belirtmiyor. Mevcut davranışı uygulamaya dayanarak açıkla, ardından telafi girişlerine izin verip vermememiz gerektiğini tartışalım.

Karar verdikten sonra öneri isteyin:

Bu kurala “Ayda bir telafi girişine izin ver” ifadesini ekle. İncelemem için bir niyet değişikliği öner.

Kodu mu düzelteceğinize, gereksinimi mi değiştireceğinize karar verin

Niyetle uygulama uyuşmadığında önce özgün gereksinimin hâlâ geçerli olup olmadığını sorun. Belge art arda 7 gün sonra ödül istiyor ama kod ödülü 6. günde veriyorsa:

KararınızSonraki adım
Gereksinim hâlâ 7 gün.Niyeti koruyun. Ajandan uygulamayı düzeltmesini ve sınır durumunu doğrulamasını isteyin.
Görüşmeden sonra 6 güne karar verdiniz.Niyeti değiştirin, yeni tetikleme koşulunu inceleyin ve uygulamayı kontrol edin.

Niyeti yalnızca mevcut koda uydurmak için yeniden yazmayın. Önce ajanın gereksinimi anladığını, sonra kodun onu karşıladığını kontrol edin. Yanlış anlamaları netleştirin, uygulama hatalarını düzeltin; niyeti ancak kuralı değiştirmeye karar verdiğinizde değiştirin.

Düzeltme istediğinizde açık olun:

7 gün koşulunu koru. Ödülün erken verilmesini düzelt; 6. günde ödül verilmediğini, 7. günde verildiğini doğrula. Niyeti mevcut koda uydurmak için değiştirme.

Öneri kartlarıyla değişiklik önerilerini ayırın

Bir suggestion (öneri) kartı, ajanın niyete eklemeye değer bulduğu bir konuyu kaydeder. Adopt (Benimse), bunu mevcut uygulamanın zaten karşıladığı bir değişiklik önerisine dönüştürmek için geçerli sohbette çalışmayı başlatır; niyetinize doğrudan yazmaz. Dismiss (Reddet), öneriyi benimsemediğinizi kaydeder.

Bir proposal (değişiklik önerisi), incelemeniz için belirli belge değişikliklerini içerir. Ajan gönderdikten sonra geçerli tur tamamlandığında, durduğunda veya başarısız olduğunda kartı görünür. İncelemek için View Changes (Değişiklikleri Görüntüle) seçin.

Değişiklikleri belgede inceleyin

İnceleme görünümü belgenin düzenini korur. Eklemeler açık yeşil arka planla; silmeler açık kırmızı arka planla ve üstü çizili olarak görünür. Değiştirmelerde eski ve yeni metin gösterilir, uygun yerlerde sözcük düzeyindeki farklar vurgulanır.

Değişiklikler arasında gezinmek için alttaki inceleme çubuğunu kullanın veya belge değiştirmek için dosya adını seçin. Karar, tüm dosyaları dahil önerinin tamamına uygulanır. Paragrafları veya dosyaları ayrı ayrı kabul edemezsiniz.

Eklenen metni ve bir değiştirmenin yeni tarafını düzenleyebilirsiniz. Özgün metin, silmeler ve etkilenmeyen paragraflar bu inceleme durumunda düzenlenemez. Düzenlemeden sonra birincil eylem Accept My Edits (Düzenlemelerimi Kabul Et) olur.

Karar vermeden önce yalnızca hangi sözcüklerin değiştiğini değil, bu sözcüklerin ne gerektirdiğini de kontrol edin:

  • Eklenen koşulları ve terimleri kendi sözcüklerinizle açıklayabiliyor musunuz?
  • Tek seferlik bir yönerge yanlışlıkla kalıcı gereksinim sayıldı mı?
  • Ajan, mevcut koda uydurmak için bir kısıtı fark ettirmeden zayıflattı mı?
  • Bu davranışı bir dahaki sefere değiştirmek istediğinizde doğru cümleyi bulabilecek misiniz?

Bir şey belirsizse sohbete dönüp ajandan öneriyi açıklamasını veya düzeltmesini isteyin.

Bir eylem seçin

EylemNiyet belgesiUygulama
Accept (Kabul Et)Önerinin tamamını yazar.Çalışma gerekiyorsa sürdürür; gereksinim zaten karşılanıyorsa yeni çalışma başlatmaz.
Accept My Edits (Düzenlemelerimi Kabul Et)Önerinin tamamını düzenlemelerinizle yazar.Düzenlenmiş öneriye göre sürdürür.
Implement Directly (Doğrudan Uygula)Öneriyi yazmaz.Onu uygular; yalnızca hâlâ uygulama gerektiren önerilerde kullanılabilir.
Dismiss (Reddet)Öneriyi uygulamaz.Uygulamayı başlatmaz.

Bir kararın gelecekteki geliştirmeye yön vermesini istiyorsanız inceleyip kabul edin. Implement Directly bu isteği niyet olarak kaydetmez.

Bir öneriyi reddetmek daha önce yapılmış kod değişikliklerini geri almaz. Örneğin ajan, mevcut davranışı belgelemenizi önermeden önce çalışmayı tamamlamış olabilir.

Yenilenen önerileri ve değişen belgeleri ele alın

Ajan aynı sohbette öneriyi yenileyebilir. Yeni sürüm bekleyen incelemenin yerini alır; eski kartta sürüm bildirimi kalır. Eski incelemede yapıp kabul etmediğiniz düzenlemeler otomatik olarak taşınmaz.

Geçerli belge artık önerinin başlangıç metniyle eşleşmiyorsa kabul devre dışı kalır. Ajanın belgeyi yeniden okuyup uygulanabilir değişiklikler oluşturması için Ask Agent to Re-propose on Current Version (Ajanın Geçerli Sürüm İçin Yeniden Önermesini İste) seçeneğini kullanın.

Kabulden sonra

Uygulama gerektiren bir öneri mevcut sohbette devam eder. Tamamlanmazsa karttaki Continue Implementing (Uygulamaya Devam Et) seçeneğini kullanın. Sonrasında belgeye dönüp açıklamayı kontrol edin; otomatik güncellenmediyse Explain'i elle çalıştırın.

İncelemelerin otomatik açılmasını durdurmak için Settings → Current Project → Automation → Open review automatically (Ayarlar → Geçerli Proje → Otomasyon → İncelemeyi otomatik aç) ayarını kapatın; ardından incelemeye öneri kartından girin. Bu ayar öneriyi kabul etmeyi değil, incelemenin açılmasını yönetir.

Açıklamaları güncel tutma bölümüyle devam edin.