02 — İçerik türleri ve hangisini ne zaman seçmeli

Knowledge Platform'da type alanı bir metin alanıdır, veritabanı enum'ı değil. Yani yeni bir tür eklemek migration gerektirmez. Bugün on bir tür tanımlı.

Tam liste

• Blog — görüş, deneyim, tartışma. Zamana bağlı değil.
• Haber — bir olayı duyurur. Zamana bağlıdır ve eskir.
• Sürüm Notu — belirli bir sürümde neyin değiştiği.
• Basın — basın bülteni ve medya materyali.
• Makale — bir konuyu açıklayan, kalıcı referans metni.
• Rehber — bir işi baştan sona yaptıran adım adım metin.
• Eğitim — tek bir beceriyi öğreten uygulamalı metin.
• Dokümantasyon — sistemin kendi kullanım belgeleri.
• SSS — soru-cevap ağırlıklı içerik.
• Vaka Çalışması — bir kararın veya projenin hikâyesi.
• Whitepaper — derin, referans niteliğinde uzun metin.

Önemli: tür renderer'ı değiştirmez

On bir türün hepsi aynı sayfayı kullanır: /knowledge/<slug>. Aynı hero, aynı gövde, aynı içindekiler, aynı SSS bloğu, aynı ilgili içerikler.

Tür üç şeyi etkiler:

1. Kartlarda ve makale başlığında görünen etiket.
2. /knowledge?tur=<tür> filtresi.
3. /knowledge sayfasındaki tür bazlı bölümler (bkz. yedinci bölüm).

Hangisini ne zaman seçmeli?

Makale mi, Rehber mi?

Okuyucunun sorusu "bu nedir / nasıl çalışır" ise Makale. "bunu nasıl yaparım" ise Rehber. Rehberde numaralı adımlar vardır ve okuyucu metni takip ederek bir sonuca ulaşır.

Rehber mi, Eğitim mi?

Rehber bir işi baştan sona bitirtir (kurulum, göç, yapılandırma). Eğitim tek bir beceriye odaklanır ve genelde daha dardır.

Haber mi, Sürüm Notu mu?

Haber duyurur ve okuyucuya "ne oldu" der. Sürüm Notu kaydeder ve "tam olarak ne değişti" der. Bir sürüm çıktığında ikisini birden yazmak yaygındır: kısa bir Haber ve ayrıntılı bir Sürüm Notu.

Blog mu, Vaka Çalışması mı?

Blog bir görüş sunar. Vaka Çalışması belirli bir kararın hikâyesini anlatır: durum, seçenekler, karar, sonuç.

Dokümantasyon ne zaman?

Son kullanıcıya değil, sistemi işleten kişiye yazıyorsanız. Şu an okuduğunuz metin de bu türde.

Yeni tür eklemek

types/knowledge.ts dosyasındaki tür listesine bir satır ve etiket haritasına bir karşılık eklenir. Yeni tablo, yeni motor ve yeni admin ekranı gerekmez.