✍ نوشتن پیام های خطای بهتر: یک راهنمای ساده با الهام از Google

پیام های خطا بخشی از تجربه کاربر هستند. هنگامی که درست انجام شد ، آنها به کاربران کمک می کنند تا درک کنند که چه اشتباهی و چگونه آن را برطرف می کنند. اما وقتی ضعیف انجام شود ، آنها کاربران را گیج می کنند و توسعه دهندگان را ناامید می کنند.
این راهنما با الهام از دستورالعمل های پیام خطای Google ، به شما در نوشتن پیام های خطای بهتر و واضح تر کمک می کند.
🔧 قوانین عمومی برای نوشتن پیام های خطای خوب
❌ خطاها را پنهان نکنید
همیشه وقتی چیزی از کار افتاد ، یک پیام واضح نشان دهید. خرابی های خاموش یک مشکل بزرگ است:
- کاربران گیج می شوند.
- توسعه دهندگان هیچ سرنخی ندارند که از سیاههها اشتباه گرفته است.
✅ این کار را انجام دهید:
نمی تواند تغییرات شما را ذخیره کند. لطفاً اتصال اینترنت خود را بررسی کنید و دوباره امتحان کنید.
✅ به کاربر بگویید چه اشتباهی رخ داده است
مستقیم و خاص باشید. از عبارات مبهم مانند “چیزی اشتباه پیش آمد” خودداری کنید.
🚫 نکن:
خطا رخ داد
✅ انجام دهید:
ما نمی توانیم پرونده را بارگذاری کنیم. قالب پرونده پشتیبانی نمی شود.
🧭 به کاربر کمک کنید تا آن را برطرف کند
یک پیام خطا باید به کاربران بگوید که چه کاری می توانند انجام دهند.
🚫 نکن:
ورودی نامعتبر
✅ انجام دهید:
رمز عبور باید حداقل 8 نویسه باشد و یک شماره را شامل شود.
👤 برای انسان بنویسید ، نه ماشین
از کدهای خطای فنی یا خطای داخلی در پیام خودداری کنید. گزارش ها برای توسعه دهندگان است – پیام ها برای کاربران است.
🚫 نکن:
500: خطای سرور داخلی – NullReferenceException
✅ انجام دهید:
با عرض پوزش ، چیزی از طرف ما اشتباه پیش آمد. لطفاً صفحه را تازه کنید یا بعداً دوباره امتحان کنید.
🔤 از زبان ساده و دوستانه استفاده کنید
درک زبان خود را آسان نگه دارید. نیازی به صداگذاری رباتیک نیست.
🚫 نکن:
دسترسی به دلیل خرابی تأیید اعتبار رد شد.
✅ انجام دهید:
برای مشاهده این صفحه باید وارد سیستم شوید.
📱 در همه صفحه ها پیام ها را پاک کنید
آن را کوتاه و معنی دار نگه دارید – به خصوص در تلفن همراه. کاربران ممکن است آن را در صفحه های کوچک بخوانند.
✅ خوب:
بدون اتصال به اینترنت. دوباره امتحان کنید
🧪 نکات پاداش
- کاربر را سرزنش نکنید. مودبانه و محترم باشید.
- از اصطلاحات مداوم استفاده کنید. اگر در یک مکان “وارد سیستم شوید” ، در جای دیگر “وارد شوید”.
- از همه جا “لطفا” استفاده نکنید. فقط هنگام درخواست از کاربر برای انجام کاری از آن استفاده کنید.
- فقط در صورت مفید بودن از طنز استفاده کنید. هرگز در مورد از دست دادن داده ها یا خطاهای جدی شوخی نکنید.
✨ چند الگو که می توانید استفاده کنید
وضعیت | نمونه پیام |
---|---|
زمینه مورد نیاز خالی است | این زمینه نمی تواند خالی باشد. |
قالب ایمیل نامعتبر است | یک آدرس ایمیل معتبر وارد کنید. |
خطای سرور | مشکلی پیش آمد بعداً دوباره امتحان کنید. |
عمل نیاز به ورود به سیستم دارد | لطفاً برای ادامه وارد شوید. |
بدون اتصال به اینترنت | شما آفلاین هستید اتصال خود را بررسی کنید. |
thoughts افکار نهایی
یک پیام خطای خوب فقط توضیح نمی دهد که چه اشتباهی رخ داده است. مانند یک انسان صحبت می کند ، نه یک روبات.
واضح ، مفید است و باعث می شود کاربران احساس پشتیبانی کنند ، گیر نشوند.
این پیام های کوچک می تواند تفاوت زیادی در نحوه تجربه افراد محصول شما ایجاد کند.
آیا می خواهید عمیق تر شیرجه بزنید؟ راهنمای کامل Google را بررسی کنید.