İlk incelemeniz

Bu öğretici, mevcut bir günlük giriş özelliğiyle başlar. İncelemek istediğiniz bir gereksinimi yazacak, uygulamayı ve kanıtları inceleyecek, ardından yeni bir karar kaydedeceksiniz. Özelliğin henüz uygulanması gerekiyorsa aşağıdaki uygulama yolunu izleyip sonra incelemeye dönün.

Hazır olarak işaretlenmiş bir ajanla Noea'ya ve üzerinde çalışmak istediğiniz yerel bir projeye ihtiyacınız var. Projenizde günlük giriş özelliği yoksa onun yerine benzer ölçüde somut başka bir kural kullanın.

Kod projesini açın

Çalışma alanında Open Folder… (Klasör Aç…) veya File → Open Implementation Folder… (Dosya → Uygulama Klasörünü Aç…) seçeneğini kullanıp kodunuzun bulunduğu klasörü seçin.

Bu klasörü ilk kez açtığınızda Noea bağlı bir proje oluşturur. Var olan bir projeyi doğrudan açar; birden fazla proje bağlıysa seçim yapmanızı ister. Proje açmanın diğer yolları için Projeleri açma ve yönetme bölümüne bakın.

İncelemenin temelini doğrulayın

Kenar çubuğunda New Intent (Yeni Niyet) düğmesine tıklayıp “Günlük girişler” adını verin. Noea .noea.md uzantısını ekler ve belgeyi açar. Şunu yazın:

# Günlük girişler

Kullanıcılar günde bir kez giriş yapabilir. Art arda 7 gün giriş yaptıktan sonra kullanıcıya bir ödül ver.

macOS'te ⌘S, Windows / Linux'ta Ctrl+S ile kaydedin. Karar verdiğiniz konularla başlayın; henüz bütün sınır durumlarını sıralamanız gerekmez.

Mevcut uygulamayı araştırın

Explain (Açıkla), proje genelinde açıklamaları gözden geçirilmesi gereken içerikleri kontrol eder. Bir paragrafın Investigation (Araştırma) eylemi yalnızca o içerik bölümünü kontrol eder. Her ikisi de uygulamayı inceler ve açıklama oluşturur veya günceller; kodu değiştirmez.

Günlük girişler zaten varsa kenar çubuğundaki Explain (Açıkla) düğmesine tıklayın. Yalnızca bu paragrafı kontrol etmek için üzerine gelin ve soldaki Investigation (Araştırma) seçeneğini kullanın.

Kuralın hâlâ uygulanması gerekiyorsa yeni bir sohbet başlatın, giriş alanına @ yazarak niyet belgesini seçin ve şunu gönderin:

Bu projedeki giriş ödülünü, başvurulan niyete göre uygula. Önce mevcut kodu incele, projenin yapısına uy ve hem 7 günlük seriyi hem de atlanan bir girişi doğrula.

Mevcut olduğunda kenar çubuğundaki Realize (Uygula) düğmesini de kullanabilirsiniz; Uygulama üzerinde bir ajanla çalışma bölümüne bakın. Ajan çalışırken sohbet; yanıtları, araç çağrılarını ve dosya değişikliklerini gösterir.

Uygulama bittikten sonra otomatik olarak başlamadıysa Explain (Açıkla) düğmesine tıklayın. Normal bir sohbetteki her kod değişikliği açıklamaları güncellemez.

Uygulamayı ve kanıtları inceleyin

Niyet belgesine dönün; kenar notunu açmak için paragrafın metni dışındaki boş alana tıklayın. Şu bölümleri okuyun:

• Realization (Uygulama açıklaması): Kodun art arda günleri nasıl saydığı ve ödülleri nasıl verdiği.
• Evidence (Kanıtlar): Açıklamada başvurulan kod, komut çıktısı veya test materyali.
• Attention (Dikkat): Sizin değerlendirmenizi gerektiren eksikler, uygulama tercihleri, riskler veya öneriler.

Örneğin, uygulamanın takvim günlerini cihazın saat dilimine göre tanımladığını fark edebilirsiniz. Projenin gerçekte ne yaptığını ve bunun gereksinimlerinizle uyumlu olup olmadığını kontrol edin. Kanıtların açıklamayı ne ölçüde desteklediğini görmek için başvuruları açın.

Bir açıklamanın tamamlanması testlerin yeniden çalıştırıldığı anlamına gelmez. Test kodunu, geçmiş sonuçları ve bu çalıştırmada yapılan doğrulamayı birbirinden ayırın; Açıklamaları ve kanıtları okuma bölümüne bakın. Uygulama özgün gereksinimi karşılamıyorsa kuralı koda uydurmak yerine uygulamayı düzeltin.

Soru sorun ve bir karar kaydedin

Paragrafın üzerine gelin ve soldaki Ask about this (Bunu sor) seçeneğini kullanın. Noea sohbet girişine bir başvuru ekler. Sorunuzu ekleyip gönderin:

Mevcut uygulama saat dilimleri arasında yolculuğu nasıl ele alıyor? İki farklı konumdan giriş yapmak seriyi etkileyebilir mi? Kod üzerinden açıkla.

Davranışı anladıktan sonra hesaplamaya bir kısıt koymak isteyip istemediğinize karar verin. İstiyorsanız şunu gönderin:

Bu niyete “Bir gün, kullanıcının o anki konumundaki takvim tarihine göre belirlenir” ifadesini ekle. Önce incelemem için bir niyet değişikliği öner.

Ajan öneriyi gönderdiğinde View Changes (Değişiklikleri Görüntüle) düğmesine tıklayıp eklenen ve değiştirilen metni okuyun. Gerekirse yeni ifadeyi düzenleyip Accept My Edits (Düzenlemelerimi Kabul Et) seçeneğini kullanın; düzenleme gerekmiyorsa Accept (Kabul Et) seçeneğini kullanın.

Öneri uygulama çalışması gerektiriyorsa kabul edilmesi bu çalışmayı aynı sohbette sürdürür. Mevcut uygulama zaten gereksinimi karşılıyorsa yeni bir uygulama çalıştırması gerekmez. Sonrasında açıklama görevinin sonuçlarını kontrol edin veya gerektiğinde elle araştırın.

Öğrendiklerinizi kontrol edin

Bitirmeden önce belgeyi kaydedin ve açıklamasının güncel ifadeyi kapsadığını doğrulayın. Şu dört soruyu kendi sözcüklerinizle yanıtlamaya çalışın:

1. Bu gereksinim nasıl uygulanmış ve bu sonucu hangi kanıtlar destekliyor?
2. Ajan, niyette belirtilmemiş hangi önemli tercihi yaptı?
3. Bu tercihi anlayıp kabul ediyor muyum? Kalıcı bir kısıta dönüşmeli mi?
4. Bu davranışı bir dahaki sefere değiştirmek istersem hangi cümleyi değiştiririm?

Örneğin, bir günün nasıl tanımlandığını açıklayabilmeli, bunu destekleyen kanıtları bulabilmeli ve ödül koşulu olarak “art arda 7 gün” ifadesini gösterebilmelisiniz. Bir yanıt belirsizse ilgili paragraf hakkında soru sorun.

İlk ziyaretinizde her kuralı kaydetmeniz gerekmez. Karşınıza çıktığında saklamaya değer bir sonraki kararı ekleyin.

Ardından Önemli bir niyet yazma ve Açıklamaları ve kanıtları okuma bölümlerini okuyun.