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`.
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.
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.
/signin
yazarak oturum açmanız gerekir. Daha fazla bilgi edinmek için /help
yazın.- 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.