İçin Sorunlara Dönüştürme

Bir planı dikey dilimler (tracer bullets) kullanarak bağımsız olarak ele alınabilir sorunlara ayırın.

Issue tracker'ı ve triage etiket sözlüğü size sağlanmış olmalıdır — eğer değilse /setup-matt-pocock-skills komutunu çalıştırın.

Süreç

1. Bağlamı toplayın

Konuşma bağlamında zaten bulunan her şeyden başlayın. Kullanıcı bir issue referansı (issue numarası, URL veya dosya yolu) argüman olarak geçerse, issue tracker'dan alıp tam gövdesini ve yorumlarını okuyun.

2. Kod tabanını keşfedin (isteğe bağlı)

Henüz kod tabanını keşfetmediyseniz, kodun mevcut durumunu anlamak için bunu yapın. Issue başlıkları ve açıklamaları projenin alan sözlüğü kelimelerini kullanmalı ve dokunduğunuz alandaki ADR'lere saygı göstermelidir.

3. Dikey dilimleri taslaklayın

Planı tracer bullet sorunlarına ayırın. Her sorun, BİR katmanın yatay dilimi DEĞİL, TÜM entegrasyon katmanlarını uçtan uca kesen ince bir dikey dilimdir.

Dilimler 'HITL' veya 'AFK' olabilir. HITL dilimleri mimari karar veya tasarım incelemesi gibi insan etkileşimi gerektirir. AFK dilimleri insan etkileşimi olmadan uygulanabilir ve birleştirilebilir. Mümkün olduğunda AFK'yi HITL'ye tercih edin.

- Her dilim her katmandan dar ama TAM bir yol sunar (schema, API, UI, testler) - Tamamlanmış bir dilim kendi başına gösterilebilir veya doğrulanabilir - Az sayıda kalın dilimden çok sayıda ince dilim tercih edin

4. Kullanıcıya sorular sorun

Önerilen dağılımı numaralandırılmış bir liste olarak sunun. Her dilim için gösterin:

• Başlık: kısa açıklayıcı ad
• Tür: HITL / AFK
• Bloklanıyor: hangi diğer dilimlerin önce tamamlanması gerektiği (varsa)
• Kapsanan kullanıcı hikayeleri: bu hangi kullanıcı hikayelerine hitap ediyor (kaynak materyalde varsa)

Kullanıcıya sorun:

• Ayrıntı düzeyi doğru hissediyor mu? (çok kaba / çok detaylı)
• Bağımlılık ilişkileri doğru mu?
• Herhangi bir dilim birleştirilmeli veya daha ileri bölünmeli mi?
• Doğru dilimler HITL ve AFK olarak işaretlendi mi?

Kullanıcı dağılımı onaylayıncaya kadar yineleyin.

5. Sorunları issue tracker'a yayınlayın

Onaylanan her dilim için issue tracker'a yeni bir sorun yayınlayın. Aşağıdaki issue gövde şablonunu kullanın. Bu sorunlar AFK ajanları için hazır kabul edilir, bu nedenle aksi talimat verilmediği sürece doğru triage etiketiyle yayınlayın.

Sorunları bağımlılık sırasına göre yayınlayın (blockerler önce) böylece "Bloklanıyor" alanında gerçek issue tanımlayıcılarına referans verebilirsiniz.

## Üst

Issue tracker'daki üst sorunun bir referansı (kaynak mevcut bir sorunsa, aksi takdirde bu bölümü atlayın).

Ne inşa edilecek

Bu dikey dilimin özlü bir açıklaması. Katman-katman uygulamayı değil, uçtan uca davranışı açıklayın.

Belirli dosya yollarından veya kod parçacıklarından kaçının — çabuk eski hale gelirler. İstisna: bir prototype hızlı bir şekilde çok gözden geçirilir (state machine, reducer, schema, type şekli) — inline edin ve kısaca bir prototype'tan geldiğini not edin. Karar açısından zengin olan kısımlarına kırpın — çalışan bir demo değil, sadece önemli kısımlar.

Kabul kriterleri

• [ ] Kriter 1
• [ ] Kriter 2
• [ ] Kriter 3

Bloklanıyor

• Engelleme talebine bir referans (varsa)

Veya hiç blocker yoksa "Hiçbiri - hemen başlanabilir".

Üst sorunları kapatmayın veya değiştirmeyin.