Kullanıcı rehberi vs kullanıcı kılavuzu: aralarındaki fark nedir ve hangisi ne zaman kullanılır

"Kullanıcı rehberi" ve "kullanıcı kılavuzu" terimleri o kadar sık birbirinin yerine kullanılır ki çoğu insan aynı anlama geldiklerini varsayar. Öyle değiller; ya da en azından, ne oluşturacağınıza ve kullanıcılarınızın gerçekte neye ihtiyaç duyduğuna karar verirken bu ayrım önem taşır.

Kullanıcı rehberi ve kullanıcı kılavuzu arasındaki farkı anlamak, doğru kitle için doğru dokümantasyonu üretmenize, gerekenden fazlasını oluşturmaktan kaçınmanıza ve ürününüz değiştikçe belgelerinizi kullanışlı tutmanıza yardımcı olur.

Temel ayrım#

Kullanıcı kılavuzu, kapsamlı bir başvuru belgesidir. Bir ürünün tüm işlevselliğini; her özelliği, her ayarı, her olası eylemi yapılandırılmış ve eksiksiz bir formatta kapsar. Kullanıcının belirli bir sorusu olduğunda başvurması içindir, baştan sona okunması için değil.

Bunu bir sözlük gibi düşünün: sırayla okuduğunuz bir şey değil, belirli bir şeyin ne işe yaradığını bilmeniz gerektiğinde arama yaptığınız bir kaynak.

Kullanıcı rehberi, görev odaklı bir belgedir. Kullanıcılara belirli hedefler, iş akışları veya kullanım durumları boyunca rehberlik eder; "işte yapabileceğiniz her şey" yerine "X nasıl yapılır" konusuna odaklanır. Ürünün özellik setine göre değil, kullanıcıların neyi başarmaya çalıştığına göre yapılandırılmıştır.

Bunu bir yemek kitabı gibi düşünün: sonuçlara göre düzenlenmiş, adım adım takip edilmek üzere tasarlanmış.

Uygulamada, birçok dokümantasyon ekibi her ikisini de oluşturur; ürünün tamamını anlamak isteyen kullanıcılar için kapsamlı bir başvuru kılavuzu ve yeni kullanıcıların tamamlaması gereken yaygın iş akışları için hedefe yönelik rehberler.

Kullanıcı kılavuzu: ne zaman kullanılır#

Kullanıcı kılavuzu şu durumlarda doğru tercihtir:

• Ürününüz önemli bir derinliğe sahipse: Düzinelerce özellik, ayar veya yapılandırma seçeneği varsa, kullanıcıların bir şeylere bakabileceği bir yere ihtiyacı vardır. Kullanıcı kılavuzu bu başvuru katmanını sağlar.
• Kitleniz ileri düzey kullanıcıları içeriyorsa: İleri düzey kullanıcılar ürünün tamamını keşfeder. Sadece ilk ne yapacaklarını değil, nelerin mümkün olduğunu bilmek isterler.
• Uyumluluk veya yasal gereklilikler geçerliyse: Bazı sektörlerde kapsamlı dokümantasyon yasal veya sözleşmeye dayalı bir zorunluluktur. Kullanıcı kılavuzu bu ihtiyacı karşılar.
• Fiziksel bir ürün veya karmaşık bir yazılım sistemi belgeliyorsanız: Geleneksel kullanıcı kılavuzları donanım, kurumsal yazılım ve teknik sistemler için hala standart formattır.

Bir kullanıcı kılavuzu tipik olarak şunları kapsar: özellik açıklamaları, ayarlar ve yapılandırma, hata kodları ve sorun giderme, teknik özellikler ve mevcut tüm işlevler için eksiksiz bir başvuru.

Kullanıcı rehberi: ne zaman kullanılır#

Kullanıcı rehberi şu durumlarda doğru tercihtir:

• Yeni kullanıcıların hızlıca başlamasına yardımcı olmak istiyorsanız: İşe alım rehberleri, hızlı başlangıç kılavuzları ve başlangıç kılavuzlarının tümü kullanıcı rehberleridir. Ürünün yapabileceği her şeye değil, en önemli eylemlere odaklanırlar.
• Belirli ve yaygın bir iş akışını çözüyorsanız: "İlk projenizi nasıl kurarsınız" veya "verileri CSV'ye nasıl aktarırsınız" — bunlar kullanıcı rehberi konularıdır. Görev odaklı ve uygulanabilirdirler.
• Kitleniz teknik olmayan kullanıcıları içeriyorsa: Kullanıcı rehberleri günlük dil kullanır ve ürünün arka planda ne yaptığına değil, ne yapılması gerektiğine odaklanır.
• Kullanıcıların değere hızlı ulaşmasını istiyorsanız: En önemli 3 iş akışını kapsayan 4 sayfalık bir kullanıcı rehberi okunur. 200 sayfalık bir kullanıcı kılavuzu ise bir kez indirilir ve asla açılmaz.

Bir kullanıcı rehberi tipik olarak şunları kapsar: başlangıç adımları, temel iş akışı kılavuzları, yaygın kullanım durumları ve göreve özel nasıl yapılır içerikleri.

SSS: kullanıcı rehberi ve kullanıcı kılavuzu farkı hakkında sıkça sorulan sorular#

SaaS ürünlerinin her ikisine de ihtiyacı var mı?

Çoğu SaaS ürünü her ikisinden de faydalanır, ancak öncelik ürünün karmaşıklığına bağlıdır. Basit ve odaklanmış bir araç muhtemelen iyi yazılmış bir dizi kullanıcı rehberine (başlangıç, yaygın iş akışları, SSS) ihtiyaç duyar ancak kapsamlı bir kullanıcı kılavuzuna ihtiyaç duymaz. Birçok özelliği, entegrasyonu ve yapılandırması olan karmaşık bir platform, kullanıcıların ayrıntılı bilgiye ihtiyaç duyduklarında arama yapabilecekleri bir başvuru kılavuzundan faydalanır.

Hangisi önce gelir?

Kullanıcı rehberleriyle başlayın. Bunlar, bir SaaS ürününün sahip olabileceği en yüksek değerli dokümantasyon olan aktivasyon ve işe alımı doğrudan destekler. Ürününüz olgunlaştıkça ve kullanıcılarınızın soruları daha ileri seviyeye ulaştıkça başvuru kılavuzu içeriğini zamanla oluşturun.

Yardım merkezi makaleleri ne olacak?

Yardım merkezi makaleleri farklı bir formattaki kullanıcı rehberleridir; daha kısa, daha spesifik ve aranabilir bir bilgi tabanında yayınlanırlar. Çoğu SaaS yardım merkezi, geleneksel kullanıcı kılavuzları değil, konuya göre düzenlenmiş kullanıcı rehberi koleksiyonlarıdır. Bir yardım merkezindeki kullanıcı kılavuzu eşdeğeri, tüm işlevselliği kapsamlı bir şekilde ele alan eksiksiz dokümantasyon sitesidir (Stripe Docs veya Notion Yardım Merkezi gibi).

Her biri hangi formatta olmalı?

Kullanıcı rehberleri birden fazla formatta iyi çalışır: yazılı adım adım makaleler, eğitim videoları, açıklamalı ekran görüntüleri veya bunların bir kombinasyonu. Amaç görev tamamlamadır, bu yüzden kullanıcıların işi gerçekten yapmasına yardımcı olan her formatı kullanın.

Kullanıcı kılavuzları neredeyse her zaman yazılı belgelerdir; kullanıcıların doğrusal olarak okumak yerine arama yaptığı ve göz gezdirdiği yapılandırılmış başvuru içerikleridir. Ayrıntılı tablolar, tanımlar ve düzenlenmiş bölümler burada anlatı tarzı yazılardan daha iyi çalışır.

Yapay zeka dokümantasyonu bunu nasıl değiştiriyor?

Clevera gibi yapay zeka dokümantasyon araçları, özellikle kullanıcı rehberi içeriği üretmeyi çok daha hızlı hale getirdi. Bir iş akışını gerçekleştirirken kendinizi kaydedersiniz ve yapay zeka eş zamanlı olarak anlatımlı bir eğitim videosu ve yazılı bir adım adım rehber oluşturur. Bu, eskisinden çok daha kısa sürede üretilen, görev odaklı ve iş akışı tabanlı bir kullanıcı rehberi içeriğidir.

Kullanıcı kılavuzu içeriğini otomatikleştirmek daha zordur çünkü bir özelliğin tüm davranışlarını, uç durumlarını ve teknik ayrıntılarını kapsamlı bir şekilde ele almayı gerektirir; bu da derin ürün bilgisine sahip bir insan yazar gerektirir. Ancak yapay zeka yine de bölümleri taslak haline getirerek, yapıyı düzenleyerek ve eksiklikleri ortaya çıkararak yardımcı olabilir.

Bir bakışta temel farklar#

Çoğu ekip için pratik cevap#

Dokümantasyon çabanıza nereye yatırım yapacağınıza karar veren bir SaaS ekibiyseniz: en önemli iş akışlarınız için kullanıcı rehberleriyle başlayın. Yeni kullanıcıların başlamasına, aktivasyona ulaşmasına ve ilk haftalarında ihtiyaç duyma olasılıklarının en yüksek olduğu görevlerde başarılı olmalarına yardımcı olun.

İleri düzey kullanıcılarınızın neye ihtiyaç duyduğuna dair net bir resme sahip olduğunuzda başvuru kılavuzu içeriğini oluşturun; bu genellikle destek biletleri, yardım merkezi arama verileri ve kullanıcı görüşmeleriyle desteklenir.

Ve eğer her ikisini de oluşturuyorsanız: onları ayrı tutun. Kullanıcı kılavuzu olmaya çalışan bir kullanıcı rehberi, rehber olarak kullanılamayacak kadar uzun hale gelir. Rehber gibi okunan bir kullanıcı kılavuzu ise onu başvuru kaynağı olarak değerli kılan eksiksizliğini kaybeder.