Uygulanabilir hata mesajları yazın

Bu sayfada, kullanıcının hedefini tamamlayabilmesi için sorunu nasıl düzelteceğini bildiren, harekete geçirici hata mesajları yazmayla ilgili en iyi uygulamalar açıklanmaktadır.

Bir kullanıcı Google Chat uygulamasıyla etkileşim kurarken hata mesajlarıyla karşılaşmak, hata üzerinde işlem yapılamadığında sinir bozucu bir deneyim olabilir. Örneğin, An error occurred hata mesajı, neyin yanlış gittiğini, kullanıcının sorunu nasıl düzeltebileceğini veya nasıl yardım alabileceğini açıklamadığı için kullanışlı değildir. Bu sayfada, işlem yapılabilir ve yapılamaz örnekler göstererek hata mesajlarının kullanıcılar için yararlı olacak şekilde nasıl yapılandırılacağı açıklanmaktadır.

Hata mesajı yapısı

İşleme dönüştürülebilir hata mesajları aşağıdaki yapıya sahiptir:

  • Sorun neydi? Chat uygulamasının isteği neden tamamlayamadığını söylemek, kullanıcının sorunu çözmesine yardımcı olur. Bir hatanın neden oluştuğunu açıklamak güven oluşturur.
  • Kullanıcı, hedefine ulaşmak için nasıl ilerleyebilir? Neyin yanlış gittiğini söylemek asla yeterli değildir. Kullanıcılara hatayı nasıl aşabileceklerini ve hedeflerini nasıl tamamlayabileceklerini anlatın.
  • Nasıl yardım alabilirim? Kullanıcı hâlâ takılıyorsa daha fazla yardım alabileceği yolları anlatın. Bu, /help komutu veya Chat uygulamanızın dokümanlarına yönelik bir bağlantı olabilir.

Örnek hata mesajı: Yanlış tarih biçimi

Bu örnekte, kullanıcı Chat uygulamasının beklemediği bir biçimde tarih girmiş. Kullanıcılar November 19, 2021 yazıyor ancak Chat uygulaması 2021-11-19 yazılmasını bekliyor.

Chat uygulamasının yanıt verdiği hata mesajının uygulanabilir ve uygulanamaz sürümünü aşağıda bulabilirsiniz:

İşlem yapılabilir hata

Bir kullanıcı, Chat uygulamasından başka bir kişiyle toplantı planlamasını istiyor. Chat uygulaması, iyi ve uygulanabilir 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`.

Kullanıcıya neyin yanlış gittiğini, nasıl devam edeceğini ve nasıl yardım alacağını bildiren örnek hata mesajı.

Bu hata mesajı aşağıdaki nedenlerden dolayı işlem yapılabilir bir mesajdır:

  • Ne gibi bir sorun yaşandığını belirtir. Chat uygulaması tarih biçimini tanımıyor.
  • Kullanıcıya beklenen tarih biçimini söyleyerek hatanın nasıl düzeltileceğini açıklar ve kullanıcının ne yazması gerektiğini anlamasına yardımcı olacak bir tarih örneği verir.
  • /help eğik çizgi komutuyla daha fazla yardım sunar. Kullanıcılar hâlâ takılıyorsa daha fazla bilgi edinmek için ne yapmaları gerektiğini bilir.

İşlem yapılamayan hata

Bir kullanıcı, Chat uygulamasından başka bir kişiyle toplantı planlamasını istiyor. Sohbet uygulaması, yararsız ve işlem yapılamayan bir hata mesajıyla yanıt veriyor:

Enter the correct date format.

İşleme alınabilir bilgi vermeyen örnek hata mesajı.

Bu hata mesajı aşağıdaki nedenlerden dolayı işlem yapılamaz:

  • Toplantının planlanıp planlanmadığını belirtmez. Kullanıcı toplantıyı yeniden planlamakta tereddüt edebilir veya toplantının planlandığını varsayabilir.
  • Kullanıcıya tarihi nasıl biçimlendireceğini söylemiyor. Kullanıcıların tarihi nasıl biçimlendireceğini bildiği varsayılmak yerine, tarih biçiminin yyyy-mm-dd olması gerektiği belirtilmelidir.
  • Daha fazla yardım sunmaz. Kullanıcılar takıldığında ve nasıl devam edeceğini bilmediğinde Chat uygulamasına mesaj göndermeyi bırakabilir.

Deneyin

Artık uygulanabilir hatalar yazmayı bildiğinize göre aşağıdaki senaryoda hangi hataların uygulanabilir olduğunu belirleyebilir misiniz?

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.

Hangi hata mesajı üzerinde işlem yapılabilir?
Toplantıyı planlayabilmem için /signin yazarak oturum açmanız gerekir. Daha fazla bilgi edinmek için /help yazın.
Bu hata mesajı, aşağıdakileri belirttiği için işlem yapılabilir:
  • Sorun neydi? Chat uygulamasının kimlik doğrulaması gerekir.
  • Nasıl devam edeceğiniz. Kimlik doğrulamak için /signin yazın.
  • Nasıl yardım alabilirim? Daha fazla bilgi edinmek isteyen kullanıcılar /help yazabilir.
Kimliğinizi doğrulamanız gerekir.
Bu hata mesajı, kimlik doğrulamanın nasıl yapılacağını belirtmediği için işlem yapılamaz.
Oturum açın.
Bu hata mesajında nasıl oturum açılacağı belirtilmediği ve kullanıcının oturumunun kapalı olduğu açıkça söylenmek yerine ima edildiği için işlem yapılamaz. Bu durum kafa karıştırıcıdır.
Toplantı planlanamıyor.
Bu hata mesajı, kullanıcıya toplantının neden planlanamadığını veya nasıl devam edebileceğini söylemediği için işlem yapılamaz. Yardım sağlanmaz.