Uygulanabilir hata mesajları yazın

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

Kullanıcılar Google Chat uygulamasıyla etkileşime girerken, hata mesajlarıyla karşılaşabilir. Hata mesajları, kullanıcının işlem yapamadığı durumlarda can sıkıcı olabilir. Örneğin, An error occurred hata mesajı, hatanın neden oluştuğunu, kullanıcının sorunu nasıl düzeltebileceğini veya nasıl yardım alabileceğini açıklamadığı için yararlı değildir. Bu sayfada, uygulanabilir ve uygulanamaz ö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ı

İşlenebilen hata mesajları 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. Hatanın neden oluştuğunu açıklamak güven oluşturur.
  • Kullanıcının hedefine nasıl ulaşabileceği. Yalnızca sorunun ne olduğunu söylemek yeterli değildir. Kullanıcılara hatayı nasıl atlayabileceklerini ve hedeflerine nasıl ulaşabileceklerini anlatın.
  • Yardım alma Kullanıcı hâlâ sorun yaşıyorsa daha fazla yardım alabileceği yerleri belirtin. Bu, bir /help komutu veya Chat uygulamanızın dokümanlarına bağlantı olabilir.

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

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

Chat uygulamasının yanıt olarak verdiği hata mesajının uygulanabilir ve uygulanamaz sürümleri aşağıda verilmiştir:

Uygulanabilir hata

Bir kullanıcı, Chat uygulamasından başka bir kişiyle toplantı planlamasını ister. 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 hatanın ne olduğunu, nasıl devam edeceğini ve nasıl yardım alacağını bildiren örnek hata mesajı.

Bu hata mesajı aşağıdaki nedenlerle işlem yapılabilir:

  • Sorunun ne olduğunu 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ıların ne yazacağını anlamalarına yardımcı olacak örnek bir tarih verir.
  • /help eğik çizgi komutuyla daha fazla yardım sunar. Kullanıcılar hâlâ sorun yaşıyorsa daha fazla bilgi edinebilir.

Yapılamayacak hata

Bir kullanıcı, Chat uygulamasından başka bir kişiyle toplantı planlamasını ister. Sohbet uygulaması, faydalı olmayan ve işlem yapılamayan bir hata mesajıyla yanıt verir:

Enter the correct date format.

İşlem yapılabilir bilgi vermeyen örnek hata mesajı.

Bu hata mesajı aşağıdaki nedenlerden dolayı işleme alınamaz:

  • Toplantıyı planlayıp planlamadığı belirtilmez. Kullanıcı, toplantıyı yeniden planlamaya çekinebilir veya toplantının planlandığını varsayabilir.
  • Kullanıcıya tarihi nasıl biçimlendireceğini söylemez. Kullanıcıların tarihi nasıl biçimlendireceğini bildiği varsayılmak yerine, yyyy-mm-dd tarih biçiminin beklendiği belirtilmelidir.
  • Daha fazla yardım sunmaz. Kullanıcılar takıldığında ve nasıl devam edeceklerini bilmediğinde Chat uygulamasına mesaj göndermeyi bırakabilir.

Deneyin

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

Chat uygulaması, kullanıcılar Chat uygulamasına schedule anahtar kelimesiyle mesaj gönderdiğinde takvim etkinlikleri oluşturur. Chat uygulamasında takvim etkinliği oluşturmak için 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 içerdiği için işlem yapılabilir:
  • Sorun neydi? Sohbet uygulaması için kimlik doğrulama gerekir.
  • Devam etmek için: Kimlik doğrulaması yapmak için /signin yazın.
  • Yardım alma. Kullanıcı daha fazla bilgi isterse /help yazabilir.
Kimliğinizi doğrulamanız gerekir.
Kimlik doğrulamanın nasıl yapılacağı bu hata mesajında belirtilmediği için bu mesajla ilgili işlem yapılamaz.
Oturum açın.
Bu hata mesajı, oturum açmanın nasıl yapılacağını belirtmediği ve kullanıcının oturumunun açıkça kapatıldığını belirtmek yerine kapalı olduğunu ima ettiği için işleme yönelik değildir. Bu da kafa karıştırıcıdır.
Toplantı planlanamıyor.
Toplantının neden planlanamadığını veya kullanıcının nasıl devam edebileceğini belirtmediği için bu hata mesajı işleme alınamaz. Yardım sağlanmaz.