Formal gözden geçirme

Turlu gözden geçirme süreci: yorum toplama, karara bağlama, düzeltme, son onay ve denetim raporu.

Onay tek bir karardır: kişi onaylar ya da reddeder. Kalite süreci gereği bir dokümanın yayınlanmadan önce yorum toplama, karara bağlama, düzeltme ve yeniden onay döngüsünden geçmesi isteniyorsa (IEEE 1028 inceleme, ISO 9001 doküman kontrolü) gözden geçirme kullanılır. İkisi ayrı ayrı durur; gözden geçirme onayın yerini almaz, yanında çalışır.

Süreç nasıl işler

  1. 1Yorum toplanıyor · Katılımcılar dokümanı okur, gördüklerini ağırlığıyla birlikte yazar. Kimse yorum yazmak zorunda değildir; bir gözden geçiren hiçbir sorun bulmayabilir.
  2. 2Karara bağlanıyor · Gözden geçirmeyi yürüten kişi her yorumu bir kararla kapatır. Red ve şartlı kabul için gerekçe zorunludur.
  3. 3Düzeltme bekliyor · Kabul edilen maddeler doküman üzerinde işlenir, işlenen madde “işlendi” olarak işaretlenir.
  4. 4Son onayda · Davet edilen herkes onaylar. Bu turda biri “yeni yorumum var” derse süreç karara bağlamaya döner ve tur sayacı artar.
  5. 5Yayına hazır · Onaylar tamamlanır, sayfa yayınlanabilir hâle gelir.
app.themyway.app/docs/payments-api/review
Gözden geçirmeRapor
Yorum toplandı
Karara bağlandı
Düzeltme
Son onay
Yayına hazır
Son onayda2. tur· Son tarih 14.08· Yürüten: Ayşe Y.· 7. sürüm gözden geçiriliyor
Neye bakılacak
Kimlik doğrulama ve hata kodları sözleşmeye uygun mu?
DDeniz Y.*EEce K.*KKaan Ö.SSelin K.beklenmedi
KritikEce K.12.08Kabul
“API key başlıkta gönderilir”
OAuth 2.0’a geçildi ama hata kodları hâlâ eski şemayı anlatıyor.
Gerekçe: §3.2 yeniden yazıldı
MajörDeniz Y.12.08Şartlı kabul
Webhook yeniden deneme sayısı ve aralığı yazılmamış.
Gerekçe: Örnek v8’de eklenecek
MinörKaan Ö.11.08Sonraki sürüme
Terim sözlüğü eklenmeli.
OnaylıyorumYeni yorumum varYayınlama, süreç bitene kadar kapalı
Son onay turundaki bir gözden geçirme

Yorum ağırlıkları ve kararlar

  • Ağırlık: Kritik, Majör, Minör, Editoryal. Liste ağırlığa göre sıralanır, kritikler üstte kalır.
  • Karar: Kabul, Şartlı kabul, Red, Yinelenen, Sonraki sürüme.
  • Ağırlık ve karar seçenekleri sabittir; pano başına değişmez. Değişseydi panolar arası karşılaştırma ve denetim raporu anlamını yitirirdi.
  • Yorumlar tura bağlıdır: 2. turun yorumları 1. turunkilerle karışmaz.

Katılımcılar

  • Katılımcı olarak kişi ya da grup seçilir. Grup seçildiğinde üyeleri gözden geçirme başlarken tek tek katılımcıya dönüşür: sonradan gruptan çıkan biri, kimin onaylaması gerektiğini geriye dönük değiştirmez.
  • “Onayı zorunlu” işaretlenen kişiler yorum toplamanın kapanmasını bağlar. Son onayda ise davet edilen herkesin sözü vardır.
  • Yanıt vermeyen biri süreci kilitliyorsa yürüten kişi “onayını bekleme” diyerek onu geçebilir; bu da rapora yazılır.
  • Panoya erişimi olmayan bir kişi katılımcı listesinden sessizce elenir.

Son tarih verirseniz, bir gün kala henüz yorum yazmamış katılımcılara hatırlatma gider. Süre dolduğunda gözden geçirme kendiliğinden kapanmaz; geç gelen yorumu sessizce çöpe atmamak için kapatma kararı sizde kalır.

Yayın kilidi

Süren bir gözden geçirmesi olan sayfa yayınlanamaz. Kilidi doğuran şey gözden geçirmenin kendisidir; pano genelinde “her sayfa gözden geçirmeden geçsin” diye bir anahtar yoktur. Her sayfa bu süreci hak etmez ve zorunlu tutmak süreci törene çevirir. Gözden geçirme tamamlandığında sayfa editöründeki “Yayınla” düğmesi açılır.

Denetim raporu

Her gözden geçirmenin tek sayfalık bir raporu vardır ve PDF olarak indirilebilir. Rapor, denetimin aradığı soruyu cevaplar: kim katıldı, kim kaç yorum yazdı, kim hiç açmadı, yorumlar hangi ağırlıkta geldi, hangi kararla kapandı, red ve şartlı kabul kararlarının gerekçesi neydi, hangi sürüm onaylandı.

app.themyway.app/docs/payments-api/review/report
Gözden geçirme raporuPDF indir
Durum
Yayına hazır
Yürüten
Ayşe Y.
Tur
2
Süre
6 gün
Katılımcılar
EEce K.· 3 yorumOnayladı
DDeniz Y.· 2 yorumOnayladı
KKaan Ö.· Yorum vermediOnayladı
SSelin K.· Hiç açmadıOnayı beklenmedi
Ağırlığa göre
Kritik1Majör3Minör2Editoryal1
Karara göre
Kabul4Şartlı1Red1Sonraki sürüme1
Kararlar ve gerekçeleri
RedŞema sürümü URL’e taşınsın
Gerekçe: kırıcı değişiklik, v2 sürüm planına alındı
Oluşturulma 14.08.2026·7. sürüm onaylandı
PDF olarak indirilebilen gözden geçirme raporu

Gözden geçirme sayfanın sürüm numarasına bağlanır: başlarken hangi sürüm üzerinde çalışıldığı, bitince hangi sürümün onaylandığı kayda geçer. “Onaylandı” tek başına denetimde bir şey ifade etmez, “7. sürüm onaylandı” eder.