Kilavuz dokümantasyonu ve ürün güncellemeleri.https://blog.kilavuz.app/trhttps://blog.kilavuz.app/blog/2026-kilavuz-launch/https://blog.kilavuz.app/blog/2026-kilavuz-launch/Sat, 01 Aug 2026 00:00:00 GMT<p>Kilavuz’un ilk sürümünü bugün yayınladık. Bu yazı, ürünün hangi parçalarla doğduğunu ve bizi izleyen birkaç hafta içinde nelerin geleceğini özetliyor.</p> <h2 id="ne-yapar">Ne yapar?</h2> <p>Kilavuz, hiyerarşik soru listelerini tasarlayıp Markdown’a aktarmanız için tasarlanmış bir üründür. Tipik bir kullanım şöyle akar:</p> <ul> <li>Ekipteki herkes aynı proje altında soruları düzenler.</li> <li>Bir kök sorunun altına sınırsız derinlikte alt sorular eklenebilir.</li> <li>Sorular sürüklenip bırakılarak yeniden sıralanır.</li> <li>Son hali geldiğinde, ağaç tek bir Markdown dosyası olarak indirilir.</li> </ul> <p>Bu akış özellikle röportaj taslakları, retrospektifler, keşif notları ve QA kontrol listeleri için işe yarıyor; biz de kendi çalışmalarımızda bu yüzden kullanıyoruz.</p> <h2 id="bugünkü-sürümde-neler-var">Bugünkü sürümde neler var?</h2> <ul> <li><strong>Üç plan</strong>: Ücretsiz, bireysel ve ekip. Plan karşılaştırması <a href="https://blog.kilavuz.app/pricing-and-billing/">fiyatlandırma sayfasında</a> var.</li> <li><strong>Soru ağacı düzenleme</strong>: Sürükle-bırak yeniden sıralama ve yumuşak silme. Silinen bir soru, altındaki soruları yetim bırakmaz.</li> <li><strong>Markdown’a aktarma</strong>: Ağacın tamamı hiyerarşik numaralandırma ile birlikte tek dosyada indirilir. Uç noktanın ayrıntıları <a href="https://blog.kilavuz.app/reference/api/">API referansında</a> var.</li> <li><strong>Yönetim paneli</strong>: Kullanıcı yönetimi, faturalama görünümü ve denetim kayıtları. Yalnızca yöneticilere açıktır.</li> <li><strong>Çerez onayı ve dil seçimi</strong>: Türkçe varsayılan, İngilizce kullanılabilir; seçim tarayıcıda saklanır.</li> </ul> <h2 id="nereden-başlarsınız">Nereden başlarsınız?</h2> <ol> <li><code dir="auto">https://kilavuz.app</code> adresine gidin ve <strong>Kayıt ol</strong> ile bir hesap açın.</li> <li><a href="https://blog.kilavuz.app/guides/getting-started/">Başlangıç rehberindeki</a> adımları takip ederek ilk soru ağacınızı kurun.</li> <li>Bir sorunuz olursa bu blogdaki yorumları ya da e-posta yoluyla bize ulaşın.</li> </ol> <h2 id="sırada-ne-var">Sırada ne var?</h2> <ul> <li><strong>Ekip içi işbirliği</strong>: Birden çok kişinin aynı ağaç üzerinde eşzamanlı çalışması için çakışma çözümü.</li> <li><strong>Şablonlar</strong>: Sık kullanılan soru ağaçları için başlangıç şablonları (mülakat, retrospektif, keşif).</li> <li><strong>Dışa aktarma genişletmesi</strong>: Markdown’a ek olarak JSON ve OPML formatlarında dışa aktarma.</li> </ul> <p>Bu yol haritası, ürünü kullanan ilk ekiplerden gelen geri bildirimlerle şekillenecek. Geri bildirimlerinizi blog yorumları üzerinden veya <code dir="auto">hello@kilavuz.app</code> üzerinden bekliyoruz; yanıt süremiz, kaç kişi yazdığına bağlı olarak değişebilir.</p>kilavuzlansmanürünhttps://blog.kilavuz.app/blog/building-kilavuz-product/https://blog.kilavuz.app/blog/building-kilavuz-product/Sat, 01 Aug 2026 00:00:00 GMT<p>Bu yazı, Kilavuz’un hangi sorunu çözmek için doğduğunu ve tasarım kararlarının nedenlerini anlatıyor. Ürün sayfasındaki özellik listesinden farklı olarak, burada “neden” kısmına odaklanıyoruz.</p> <h2 id="çıkış-noktası">Çıkış noktası</h2> <p>Bir ekip içinde yapılandırılmış notlar tutmak istediğinizde elinizde iki yaygın seçenek var:</p> <ul> <li><strong>Belge düzenleyici</strong>: Serbest metin olarak soruları alt alta yazarsınız; hiyerarşi görsel olarak bozulur, yeniden sıralamak zahmetlidir.</li> <li><strong>Proje yönetim aracı</strong>: Her soru bir “ticket” olur; bu sefer ağaç yapısı kaybolur, bilgi dağılır.</li> </ul> <p>Bu iki uç arasında kalan bir boşluk var: hiyerarşiyi koruyarak serbest metin yazmak, taşımak ve başka formatlara dönüştürmek. Kilavuz, bu boşluğu doldurmak için doğdu.</p> <h2 id="tasarım-ilkeleri">Tasarım ilkeleri</h2> <p>Ürünü tasarlarken üç ilkeye bağlı kaldık:</p> <ol> <li><strong>Veri yapısı önce</strong>: Hiyerarşi, kullanıcının gözünden değil, veritabanının gözünden birinci sınıf bir yapı. Bu yüzden <code dir="auto">parentId</code>, <code dir="auto">sortKey</code> ve <code dir="auto">depth</code> alanları modelin temelinde yer alıyor.</li> <li><strong>Yumuşak silme</strong>: Bir soruyu silmek, altındaki bilgiyi kaybetmeniz anlamına gelmemeli. <code dir="auto">softDeleteQuestion</code> eylemi, alt soruları yetim bırakmadan hedef kaydı damgalar.</li> <li><strong>Sahip olunan tek dışa aktarma formatı</strong>: Markdown, ekibimizin ve müşterilerimizin zaten bildiği bir format. JSON ve OPML yol haritasında; ilk günden itibaren ek bir biçim yükü getirmedik.</li> </ol> <h2 id="türkçe-neden-varsayılan">Türkçe neden varsayılan?</h2> <p>Ekibimiz Türkçe konuşuyor; müşterilerimizin önemli bir kısmı da Türkçe çalışıyor. Ürünün Türkçe varsayılanla doğması, kendi işimizi yaparken en az dirençle karşılaşmak anlamına geliyordu. İngilizce seçeneği, gerçek bir eksiği kapatmak için değil, ürünü uluslararası kullanıma açık tutmak için eklendi. Dil seçimi, bir veri olarak değil, bir UI tercihi olarak saklanıyor; bu sayede sunucu tarafı verileri dil-agnostik kalıyor.</p> <h2 id="neyi-özellikle-yapmadık">Neyi özellikle yapmadık?</h2> <ul> <li><strong>SDK form kontrollerini Türkçeye çevirmedik</strong>. Wasp SDK’sının iç form bileşenleri İngilizce kalır; bu istisna bilinçli bir kapsam kararıdır.</li> <li><strong>Sunucu hata iletilerini çevirmedik</strong>. API hata gövdeleri İngilizce kalır; bunlar geliştiriciye yöneliktir.</li> <li><strong>Kişiselleştirilmiş bir fatura şablonu yazmadık</strong>. PDF faturalar, Stripe’ın şablonundan alınır.</li> </ul> <p>Bu “yapmadık” listesi, kapsamımızın sınırlarını netleştiriyor. Ürünü kullanırken bir sınırla karşılaşırsanız, bunun bilinçli bir karar mı yoksa eksik bir özellik mi olduğunu sormak için bize ulaşabilirsiniz.</p> <h2 id="bundan-sonra">Bundan sonra</h2> <p>Önümüzdeki aylarda ürünü gerçek kullanım verileriyle şekillendireceğiz. Yol haritasını ve değişiklik günlüklerini <a href="https://blog.kilavuz.app/blog/">blog</a> üzerinden paylaşmaya devam edeceğiz.</p>kilavuzürünhikaye