Tushunarli xatolik xabarlarini qanday yozish kerak
Amaliyot3 daqInnovialabs tahririyati
Qisqacha
Yaxshi xatolik xabari oddiy tilda nima bo‘lganini, nega va uni tuzatish uchun nima qilish kerakligini aytadi — ayblovsiz, kodlarsiz va texnik atamalarsiz — hamda foydalanuvchi allaqachon qarab turgan joyda paydo bo‘ladi.
Yaxshi xatolik formulasi
Xatolik xabari uchta savolga javob beradi:
- Nima bo‘ldi — umumiy so‘zlarsiz, aniq.
- Nega — agar sabab vaziyatni tushunishga yordam bersa.
- Qanday tuzatish mumkin — foydalanuvchi hozirning o‘zida qila oladigan keyingi qadam.
Misol: «Faylni saqlab bo‘lmadi: diskda joy qolmagan. Keraksiz fayllarni o‘chiring yoki boshqa papkani tanlang».
Sabab aniq bo‘lsa yoki foydalanuvchiga hech narsa bermasa, ikkinchi bandni tushirib qoldirish mumkin. Uchinchisini tushirib bo‘lmaydi: chiqish yo‘li yo‘q xato — boshi berk ko‘cha.
Ohang qoidalari
- Ayblamang. «Siz noto‘g‘ri parol kiritdingiz» → «Parol mos kelmadi». Xato — bu vaziyat, odamning aybi emas.
- Texnikasiz. Kodlar, istisno nomlari va «Error 500» foydalanuvchiga hech narsa demaydi. Kodni qo‘llab-quvvatlash xizmati uchun mayda matnda qoldirish mumkin.
- Dramasiz va hazilga ehtiyotkorlik bilan. «Voy!» va undov belgilari odamning to‘lovi o‘tmay qolganda asabga tegadi. Hazil faqat zararsiz holatlarda, masalan 404 sahifasida o‘rinli.
- Aniq. «Nimadir xato ketdi» emas, aynan nima va nima qilish kerak.
- Qisqa. Bir-ikki gap. Tafsilotlar haqiqatan kerak bo‘lsa — havola orqali.
- Butun mahsulotda bir xil. Bir xil vaziyatlarni bir xil so‘zlar bilan tasvirlang.
- Faqat rang bilan emas. Qizil rangni ikonka va matn bilan to‘ldiring — uni rangni farqlashda qiynaladigan odamlar ham, ekran o‘quvchi dasturlardan foydalanuvchilar ham sezishi kerak.
Xatoni qayerda ko‘rsatish kerak
| Vaziyat | Qayerda ko‘rsatish |
|---|---|
| Forma maydonidagi xato | Maydon ostida, foydalanuvchi undan chiqqan zahoti |
| Yuborishda bir nechta xato | Forma tepasida maydonlarga havolali ro‘yxat + har bir maydon yonida xabar |
| Harakat bajarilmadi (saqlanmadi, yuborilmadi) | Harakat joyi yonida «Qayta urinish» tugmali bildirishnoma |
| Aloqa yo‘q | Aloqa tiklangach yo‘qoladigan bezovta qilmaydigan panel |
| Sahifa topilmadi yoki mavjud emas | Keyingi yo‘llar ko‘rsatilgan alohida ekran: qidiruv, bosh sahifa, yordam |
| Jiddiy xato, ma’lumotlar yo‘qolishi mumkin | Modal oyna — faqat shu holatda |
Tamoyil: xato foydalanuvchi allaqachon qarab turgan joyda paydo bo‘ladi va u o‘qimaguncha o‘z-o‘zidan yo‘qolmaydi. Bir-ikki soniyada yo‘qoladigan qalqib chiquvchi bildirishnomalar tasdiqlash uchun mos, xatolar uchun emas.
Oldin va keyin
| Avval | Keyin |
|---|---|
| Noto‘g‘ri kiritish | Telefon raqamini to‘liq kiriting, masalan +998 90 123 45 67 |
| Error 500. Internal Server Error | Sahifani yuklab bo‘lmadi. Bir daqiqadan keyin yangilang, yordam bermasa — qo‘llab-quvvatlash xizmatiga yozing |
| Tranzaksiya rad etildi | Bank to‘lovni rad etdi. Karta ma’lumotlarini tekshiring yoki boshqa to‘lov usulini tanlang |
| Maydon majburiy | Emailni kiriting — unga buyurtma tasdig‘i keladi |
| Voy! Nimadir xato ketdi :( | Xabarni yuborib bo‘lmadi. Internet aloqasini tekshiring va qayta urinib ko‘ring |
| Parol talablarga mos emas | Parol kamida 8 ta belgidan iborat bo‘lishi va kamida bitta raqamni o‘z ichiga olishi kerak |
| Fayl qo‘llab-quvvatlanmaydi | 10 MB gacha bo‘lgan JPG yoki PNG formatidagi rasmni yuklang |
E’tibor bering: yaxshi variantda deyarli har doim harakat fe’li bor — «kiriting», «tekshiring», «yuklang».
Xabar berishdan ko‘ra oldini olgan yaxshi
Eng yaxshi xato — sodir bo‘lmagan xato.
- Talablarni oldindan ko‘rsating: parol formati, fayl hajmi chegarasi — kiritishdan keyin emas, oldin.
- Turli formatlarni qabul qiling: bo‘sh joyli telefon, nuqta yoki chiziqcha bilan yozilgan sana.
- Mavjud bo‘lmagan variantlarni tanlab, xato olishga yo‘l qo‘ymasdan, izoh bilan nofaol qiling.
- Xatodan keyin hammasini qaytadan to‘ldirmaslik uchun kiritilgan ma’lumotlarni saqlang.
Nashr qilishdan oldingi chek-list
- Tizimning ichki tuzilishini bilmasdan nima bo‘lgani tushunarlimi?
- Aniq keyingi qadam bormi?
- Ayblov, jargon va ortiqcha undovlar yo‘qmi?
- Xabar muammo yonidami va faqat rang orqali emas, boshqacha ham ko‘rinadimi?
- Kiritilgan ma’lumotlar saqlanadimi?