Öneri süreci

Ne zaman öneri yazılır

Değişiklik	Gereken
Yeni bileşen	Öneri (RFC)
Var olan bileşende uyumu bozan değişiklik (özellik kaldırma ya da adını değiştirme, davranış değişikliği)	Öneri (RFC)
Var olan eksende yeni varyant, en az iki ekranda kullanılan	Varyant kaydı: ilk kullanım, ekranlar, Figma bağlantısı, onaylayan (REUSE-03)
Yeni token ya da token adı değişikliği	Değişiklik kaydı; ad değişikliğinde geçiş notu
Mimari, paket sınırı, bağımlılık ya da kural değişikliği	Karar kaydı (ADR)
Hata düzeltmesi, doküman düzeltmesi	Gerekmez

packages/ui/src altında önerisi olmayan yeni bir dosya incelemede reddedilir (REUSE-08).

Adımlar

1. Arayın. Bileşenlere genel bakış sayfasında ve Storybook’ta benzer bir bileşen arayın. Kullandığınız arama kelimesini ve karar akışında hangi adımda kaldığınızı öneriye yazın (REUSE-06).
2. Adı denetleyin. Önerilen ad var olan bir bileşenin kökünü tekrarlamamalı ve yasak eklerden birini taşımamalıdır; bkz. Adlandırma.
3. Öneriyi yazın. Aşağıdaki şablonu doldurun. Önerilen arayüz, kodu yazacak kişinin başka bir soru sormadan başlayabileceği ayrıntıda olmalıdır.
4. İnceleme. Öneri bir tasarımcı, bir geliştirici ve erişilebilirlik sorumlusu tarafından okunur. Sorular öneri üzerinde yanıtlanır.
5. Karar. Öneri kabul, değişiklikle kabul ya da ret ile kapanır; gerekçe öneriye yazılır. Kabul edilmeden kod yazılmaz.
6. Uygulama. Kabul edilen öneri Bileşen kontrol listesine göre tek bir değişiklikte uygulanır.

Öneri şablonu (RFC)

rfc-0000-bilesen-adi.md

# RFC: <Bileşen adı>

- Durum: taslak | incelemede | kabul | ret
- Yazan:
- Tarih:

## Sorun
Hangi kullanıcı hangi işi yaparken neye ihtiyaç duyuyor? Bugün nasıl çözülüyor?

## Kullanılacağı ekranlar
En az iki ekran, Figma bağlantılarıyla.

## Arama ve karar akışı
Kullanılan arama kelimeleri, incelenen bileşenler, karar akışında kalınan adım.

## Önerilen arayüz
Özellikler (ad, tür, varsayılan, açıklama), parçalar (`data-part`), durumlar ve varyantlar.

## Davranış ve hareket
Etkileşim durumları, klavye, kullanılacak hareket önayarları, azaltılmış hareket davranışı.

## Erişilebilirlik
Rol, erişilebilir ad, klavye tablosu, odak yönetimi, ekran okuyucu çıktısı, ilgili WCAG 2.2 ölçütleri.

## Token'lar
Kullanılacak anlam token'ları; gerekiyorsa yeni bileşen token'ları.

## Metinler
Kütüphanenin kendi metinleri (`ui.*`), Türkçe ve İngilizce.

## Değerlendirilen alternatifler
En az iki alternatif ve neden seçilmedikleri.

Karar kaydı şablonu (ADR)

Mimariyi, paket sınırlarını, bağımlılıkları ya da bir kuralı değiştiren her karar bir karar kaydına yazılır. Kayıtlar depoda docs/adr/ altında tutulur ve sonradan değiştirilmez; bir karar değişirse yeni bir kayıt eskisinin yerine geçer ve ona bağlantı verir.

0000-karar-basligi.md

# ADR 0000: <Karar başlığı>

- Durum: önerildi | kabul | yerine geçildi (ADR xxxx)
- Tarih:

## Bağlam
Kararı gerektiren durum ve kısıtlar.

## Seçenekler
En az üç seçenek ve her biri için değerlendirme ölçütleri.

## Karar
Seçilen seçenek ve gerekçesi.

## Sonuçlar
Kolaylaşan ve zorlaşan şeyler, geri dönüş yolu, takip edilecek işler.