Bu sayfada, kullanıcıya hedefini tamamlayabilmesi için sorunu nasıl çözeceğini söyleyen, eyleme dönüştürülebilir hata mesajları yazmaya yönelik en iyi uygulamalar açıklanmaktadır.
Kullanıcılar bir Google Chat uygulamasıyla etkileşimde bulunduğunda, hatayla ilgili işlem yapılamadığında hata mesajlarıyla karşılaşmak can sıkıcı bir deneyim olabilir.
Örneğin, An error occurred hata mesajı neyin yanlış gittiğini, kullanıcının sorunu nasıl çözebileceğini veya kullanıcının nasıl yardım alabileceğini açıklamadığı için kullanışlı değildir. Bu sayfada, işlem yapılabilir ve gerçekleştirilemez örnekler göstererek hata mesajlarının kullanıcılar için faydalı olacak şekilde nasıl yapılandırılacağı açıklanmaktadır.
Hata mesajı yapısı
İşlem yapılabilir hata mesajı aşağıdaki yapıya sahiptir:
- Sorun neydi? Chat uygulamasının bir isteği neden tamamlayamadığını belirtmek, kullanıcının sorunu çözmesine yardımcı olur. Bir hatanın neden oluştuğunu açıklayarak güven tesis edebilirsiniz.
- Kullanıcının hedefine doğru nasıl ilerleyebileceği. Sadece ne olup bittiğini söylemek yetmez. Kullanıcılara hatayı atlatıp hedefini tamamlamaları için neler yapabileceklerini anlatın.
- Yardım alma. Kullanıcı hâlâ sorun yaşıyorsa nasıl daha fazla
yardım alabileceğini söyleyin. Bu, bir
/helpkomutu veya Chat uygulamanızla ilgili dokümanların bağlantısı olabilir.
Örnek hata mesajı: Yanlış tarih biçimi
Bu örnekte kullanıcı, tarihi Chat uygulamasının beklemediği bir biçimde girmiştir. November 19, 2021 yazmışlar ama Chat uygulaması şunu bekliyor:
2021-11-19.
Chat uygulamasının yanıt verdiği hata mesajının işlem yapılabilir ve uygulanamaz bir sürümü şu şekildedir:
İşlem yapılabilir hata
Bir kullanıcı, Chat uygulamasından başka bir kişiyle toplantı planlamasını istiyor. Chat uygulaması, gerektiği gibi, işleme dökülebilir bir hata mesajıyla yanıt verir:
I don't recognize the date format you entered. Write dates as `yyyy-mm-dd`; for example, `2000-01-31`. For help, type `/help`.
Bu hata mesajıyla ilgili olarak, aşağıdaki nedenlerden dolayı işlem yapılabilir:
- Neyin yanlış gittiğini söylüyor. Chat uygulaması, tarih biçimini tanımaz.
- Kullanıcıya beklenen tarih biçimini bildirerek hatanın nasıl düzeltileceğini açıklar ve kullanıcıların ne yazacaklarını anlamalarına yardımcı olan örnek bir tarih verir.
/helpeğik çizgi komutuyla daha fazla yardım sunar. Hâlâ kararsız kalan kullanıcılar, nasıl daha fazla bilgi edineceklerini bilir.
İşlem yapılamayan hata
Bir kullanıcı, Chat uygulamasından başka bir kişiyle toplantı planlamasını istiyor. Chat uygulaması, faydalı olmayan, işlem yapılamayan bir hata mesajıyla yanıt verir:
Enter the correct date format.
Bu hata mesajı, aşağıdaki nedenlerden dolayı işleme alınamıyor:
- Toplantıyı planlayıp planlamadığı belirtmez. Kullanıcı toplantıyı yeniden planlama konusunda tereddüt edebilir veya toplantıyı planlanmış zannedebilir.
- Kullanıcıya tarihin nasıl biçimlendirileceğini söylemez. Kullanıcıların tarihi biçimlendirmeyi bildiğini varsaymak yerine
yyyy-mm-ddtarih biçimini beklediğini belirtmelidir. - Daha fazla yardım sağlamaz. Kullanıcılar takılıp durduklarında ne yapacaklarını bilemediklerinde Chat uygulamasına mesaj göndermeyi bırakabilirler.
Deneyin
Artık işlem yapılabilir hataların nasıl yazılacağını bildiğinize göre, aşağıdaki senaryoda bu hatalardan hangisinin işlem yapılabileceğini belirleyebilirsiniz:
Bir Chat uygulaması, kullanıcılar schedule anahtar kelimesini kullanarak Chat uygulamasına mesaj gönderdiğinde takvim etkinlikleri oluşturur. Takvim etkinliği oluşturmak için Chat uygulamasında kullanıcı kimlik doğrulaması gerekir. Kullanıcının kimliği doğrulanmamışsa Chat uygulaması bir hata mesajıyla yanıt verir.
/signin yazarak oturum açmalısınız. Daha fazla bilgi edinmek için /help yazın.- Sorun neydi? Chat uygulaması için kimlik doğrulama gerekir.
- İlerlemek için ne yapmalısınız? Kimlik doğrulaması için
/signinyazın. - Nasıl yardım alınır? Kullanıcı daha fazla bilgi isterse
/helpyazabilir.