Açıklamaları ve kanıtları okuyun

Uygulama açıklamaları, niyetin bir bölümünden başlayıp kodun nasıl çalıştığını anlamanıza ve bu anlatımı destekleyen kanıtları bulmanıza yardımcı olur. Davranışa, destekleyici materyale ve hâlâ sizin değerlendirmenizi gerektiren sorulara odaklanın.

Paragraf düzeyindeki ve yerel açıklamaları açın

Düzenlemek için belge metnine tıklayın. L1 olarak işaretlenen paragraf düzeyindeki açıklamayı açmak için paragrafın içindeki, metnin dışındaki boş alana tıklayın.

Bazı açıklamalar bir sözcüğe veya ifadeye uygulanır. Kısa alt çizgileri göstermek için paragrafın üzerine gelin; ardından L2 olarak işaretlenen yerel açıklamayı okumak için birine tıklayın.

Listeler, tablolar ve kod bloklarının da açıklamaları olabilir. Listenin tamamı birlikte araştırılır; başlıklar tek başlarına araştırılmaz.

Birden fazla paragrafın kenar notunu açık tutabilirsiniz. Her paragraf aynı anda bir paragraf düzeyinde veya yerel açıklama gösterir. Dar bir pencerede not paragrafın altında görünebilir.

Üç bölümü okuyun

Bölüm	Yanıtladığı soru	Bakılacak noktalar
Realization (Uygulama açıklaması)	Uygulama bu niyeti nasıl karşılıyor?	Davranış, adımlar, sınır durumları ve uygulama tercihleri.
Evidence (Kanıtlar)	Açıklamayı neler destekliyor?	Kod başvuruları, testler, komut çıktıları ve incelenebilir diğer materyal.
Attention (Dikkat)	Başka hangi konular değerlendirilmeli?	Eksikler, uygulama tercihleri, riskler ve öneriler.

Realization varsayılan olarak açıktır. Gerektiğinde Evidence bölümünü genişletin. Gösterilecek bir konu yoksa Attention gizlenir.

Art arda 7 girişten sonra verilecek ödül için açıklama, tarihlerin nasıl biriktiğini anlatabilir, ilgili işleve ve testlere başvurabilir, saat dilimleri arasında yolculuğun nasıl ele alındığını belirtebilir. Gerçek içerik projenizin araştırmasına bağlıdır.

Kanıtları inceleyin

Kod başvuruları dosyaları sistemin varsayılan uygulamasında açar. Görselleri kenar notunda görüp büyütebilirsiniz. Komut çıktısı ve kod farkı gibi materyallerin etiketleri yeni sekme açar. Materyal artık mevcut değilse Noea bunu bildirir.

Her başvurunun sorunuzu yanıtlayıp yanıtlamadığını, testin hangi koşulları kapsadığını ve sonuçların çıkarımı destekleyip desteklemediğini sorun. Önemli bir senaryo eksikse paragrafı sorup ek araştırma veya doğrulama isteyin.

Özellikle üç kanıt türünü ayırın:

Materyal	Neyi ortaya koymaya yardımcı olur?	Neyi ortaya koymaz?
Uygulama veya test kodu	Kullanılan mantığı ve testlerin tanımladığı senaryoları.	Testlerin varlığı, çalıştırıldıkları veya geçtikleri anlamına gelmez.
Önceki çalıştırma sonuçları	O zaman nelerin çalıştığını ve o zamanki sonucunu.	Sonraki kod değişiklikleri bu sonuçları geçersiz kılabilir.
Şimdi gerçekten çalıştırılan doğrulama	Bu çalıştırmanın ortamı ve kapsamı için sonucu.	Kapsanan senaryoların geçmesi, test edilmemiş senaryoların doğruluğunu kanıtlamaz.

Explain ve Investigation normalde her seferinde testleri, derlemeleri veya uygulamayı yeniden çalıştırmak yerine kodu ve mevcut kanıtları okur. Yalnızca okumak, karar açısından önemli bir noktayı ortaya koyamıyorsa gerektiğinde o noktayı doğrularlar. Doğrulamanın kapsamını gerçekten çalıştırılanlara göre değerlendirin.

Belirli bir testi yeniden çalıştırmak için sohbette ajandan testi yürütmesini, kapsamını ve sonucunu bildirmesini isteyin; ardından ilgili paragrafı yeniden araştırın.

Hangi tercihlerin niyete gireceğine karar verin

“Uygulama şu anda yerel depolama kullanıyor” diyen bir açıklama bugünkü yaklaşımı anlatır; gelecek sürümleri buna mecbur bırakmaz. Korunmasını istediğiniz gereksinimler niyet belgesine girer.

Bir tercihin kullanıcı deneyimini, maliyeti, gizliliği, riski veya gelecekteki kararları etkileyip etkilemediğini değerlendirin. Anladıktan sonra genellikle iki sonuçtan birine varırsınız:

Mevcut yaklaşım kabul edilebilirdir ve ileride değiştirme özgürlüğü istersiniz: kısıta dönüştürmeden kullanmaya devam edin.
Yaklaşım gelecek sürümlerde de geçerli kalmalıdır: gereksinimi açıkça yazın ve getirdiği sınırları inceleyin.

Örneğin, giriş kayıtları için bugün yerel depolamayı kabul edebilirsiniz. Çevrimdışı kullanım vazgeçilmez hâle gelirse “Kullanıcılar ağ bağlantısı olmadan da giriş yapabilmelidir” yazın ve uygulamanın bu davranışı nasıl desteklediğini araştırın. İstediğiniz davranışı ifade etmek genellikle ayrıntılı uygulama açıklamasını kopyalamaktan daha kolay sürdürülür.

Attention bölümünü anlayın

Attention öğeleri eksik, uygulama tercihi, risk veya öneri olarak sınıflandırılır. Eksik davranışı mevcut tasarım tercihlerinden ve daha fazla tartışılması gereken konulardan ayırırlar.

Paragrafın sağındaki dikkat işareti ilgili açıklamayı açar. Üzerindeki sayı, tekil sorunları değil, dikkat gerektiren konular içeren açıklama panellerini sayar. Bir eksik varsa işaret daha belirgin bir renk alır.

Kodu düzeltmeye, doğrulama eklemeye, niyeti değiştirmeye veya mevcut davranışı korumaya karar vermeden önce etkisini anlayın. Her dikkat konusu gereksinime dönüşmek zorunda değildir. İşaret olmaması yalnızca mevcut açıklamada dikkat konusu listelenmediği anlamına gelir.

Davranış gösterimlerini deneyin

Bazı açıklamalar davranışın küçük, etkileşimli bir gösterimini içerir. Deneyebilir, sıfırlayabilir veya kaynağını inceleyebilirsiniz.

Bu gösterimler, uygulamaya veya ağa erişimi olmayan yalıtılmış bir alanda çalışır ve etkileşim durumunu kaydetmez. Bir kuralı açıklarlar; gerçek yazılımın bu kurala uyup uymadığını kontrol etmek için yine kod ve doğrulama kanıtı gerekir.

Açıklamanın hâlâ geçerli olup olmadığını kontrol edin

Previous text (Önceki metin), açıklamanın düzenlemenizden önceki niyeti kapsadığı anlamına gelir. May be outdated (Güncelliğini yitirmiş olabilir), açıklamanın okuduğu veya kaynak gösterdiği dosyaların araştırmadan sonra değiştiğini belirtir. İkisi de yeniden araştırma nedenidir.

Kenar notları salt okunurdur. Bir gereksinimi değiştirmek için niyeti düzenleyin; açıklamayı kontrol etmek için Investigation veya Investigate Again (Yeniden Araştır) kullanın. Açıklamaları güncel tutma bölümüne bakın.