Son güncelleme:

Hata Mesajı Nedir?

Bir hata mesajı, kullanıcının veya sistemin bir görevi tamamlamasını engelleyen bir sorunu tanımlamak için görüntülenen metindir. Diğer mesaj türleri arasında onaylar, uyarılar ve bildirimler bulunur.

Kötü yazılmış hata mesajları, kullanıcılar için bir hayal kırıklığı kaynağı olabilir ve teknik destek maliyetlerini artırabilir. İyi yazılmış bir hata mesajı kullanıcıya aşağıdaki bilgileri sağlar:

  • Ne oldu ve neden?
  • Kullanıcıya nihai sonucu nedir?
  • Kullanıcı, tekrar olmasını önlemek için ne yapabilir?

Geliştirici arabellek boyutlarını doğru kullandığı sürece, metnin uzunluğu sorun olmaz. Kullanıcının sorunu çözmek için gerekli tüm bilgilere sahip olması önemlidir. Bir mesaj bir çok kitleyi hedefliyorsa, yöneticiler, son kullanıcılar ve geliştiriciler için ayrı hata metinleri sağlamanız gerekebilir.

Düzgün Hata Mesajları için

Hata mesajlarınızı iyileştirmenin yolları şunlardır:

  • Hata koşullarından kaçının. Bir kullanıcı belirli bir eylem gerçekleştirdiğinde bir hatanın olacağını öngörebiliyorsanız, kullanıcının hataya neden olmaması için kodunuzu yeniden yazın.
  • Hatanın bilinen her nedeni için ayrı bir hata mesajı yazın. Hatanın nedenini belirlemediğiniz sürece, hatanın olası her bir nedenini açıklamak için tek, genel bir mesaj kullanmayın.
  • Sorunu açıkça belirtin ve eğer kullanıcı için yararlı olacaksa, soruna neyin neden olduğunu açıklayın. Mümkün olduğunda, sistem mesaj tablosu kaynaklarından gelen genel iletileri, soruna özgü ayrıntılı bir iletiyle değiştirin.
  • Kullanıcının sorununa bir çözüm getirin. Çözümde birden fazla adım varsa, görevi ayrıntılı olarak açıklayan bir yardım konusuna bakın.
  • Mesajın başlık çubuğunda yalnızca ürün, bileşen veya sihirbaz adını görüntüleyin. Bu, kullanıcının sorunun nerede olduğunu belirlemesine yardımcı olur. Sorunu başlık çubuğunda özetlemeyin veya “error” kelimesini eklemeyin.
  • Teknik jargon kullanmayın, izleyicilerinizin anlayacağı bir terminoloji kullanın. Argo veya kısaltmalar kullanmayın.
  • Tamam, İptal, Evet, Hayır ve Yeniden Dene gibi uygun komut düğmelerini kullanın. Bu düğmelerin kombinasyonlarını kullanabilirsiniz. Evet ve Hayır düğmelerinin her zaman birlikte kullanılması ve her zaman bir sorudan önce gelmesi gerekir.
  • Bir işlemi durdurmak ve mesaj kutusunu kapatmak için bir İptal düğmesi kullanın.
  • Bir mesaj kutusunu kapatmak için bir Kapat düğmesi kullanın.
  • Hatanın nedeni hakkında daha fazla bilgi sağlamak için bir Ayrıntılar düğmesi kullanın.
  • Sorunun çözümü hakkında daha fazla bilgi sağlamak için bir Yardım düğmesi kullanın.
  • Mesajda bir kullanıcı eylemi varsa, mesaj kutusunu kapatmak için bir Tamam düğmesi kullanın.
  • Evet ve Hayır düğmeleri bir arada kullanılmalı ve daima bir sorudan önce gelmelidir.

Hata kritik bir hataysa, olay günlüğüne yazın .

Hata Mesajlarının Stili

  • Tam ama basit cümleler kullanın.
  • Soruna neden olan koşulları veya hala var olan bir durumu tanımlamak için şimdiki zamanı kullanın. Geçmişte meydana gelen farklı bir olayı tanımlamak için geçmiş zamanı kullanabilirsiniz.
  • Mümkün olduğunda aktif sesi kullanın. Hata durumunu tanımlamak için pasif sesi kullanabilirsiniz.
  • Büyük harfli metinlerden ve ünlemlerden kaçının.
  • Sorun bir kullanıcı hatasının sonucu olsa bile kullanıcıyı hatalı hissetmeyin.
  • Hata mesajlarına insancıl özellikler eklemeyin. Programların veya donanımın düşünebileceğini veya hissedebileceğini ima etmeyin.
  • Konuşma sözcükleri veya kelime öbekleri kullanmayın. Bazı kültürlerde rahatsız edici olabilecek terimler kullanmayın.
  • Anlamı açıklığa kavuşturmak için bir edat ya da alt durumlar eklemeden birkaç isim birleştirmeyin. Örneğin, “Site Sunucusu LDAP Hizmeti dizini sunucusu”, “Site Sunucusunun LDAP Hizmeti için dizin sunucusu” olarak değiştirilmelidir.
  • Cümlenin anlamını netleştirmek için bir terimden önce tanımlayıcıları ekleyin. Örneğin, “Algıla Hayır olarak ayarlandığında InfID’yi belirtin” “Algıla seçeneği Hayır olarak ayarlandığında InfID parametresini belirt” olarak değiştirilmelidir.
  • “Kötü” kelimesinden kaçının. Kullanıcıya yanlış olanı söylemek için daha açıklayıcı terimler kullanın. Örneğin, “Kötü boyut” gibi mesajlardan kaçının. Bunun yerine, kullanıcıya bir boyut belirlerken hangi kriterleri kullanacağını söyleyin.
  • “Lütfen” kelimesinden kaçının. Gerekli bir eylemin isteğe bağlı olduğu anlamına gelebilir.
  • Hem dizinde hem de merkezi anlamla ilgili kelimeleri, ileti dizesinin başlangıcına yerleştirin.

Microsoft.com’tan alınmıştır. Daha fazla bilgi için bkz: https://docs.microsoft.com/en-us/windows/desktop/Debug/error-handling