Toshkent axborot texnologiyalari universiteti televizion texnologiyalar fakulteti «audiovizual texnologiyalar» kafedrasi

Izohlar. Izohlar kodni emas dasturchining maqsadlarini tushuntirib berish shartligi xaqida ko‘pchilik mutaxassislarni fikrlari bir joydan chiqadi. Dasturlash tilida bayon etilishi mumkin bo‘lgan narsalar izohga chiqarilmasligi shart – xususan, o‘zgaruvchanlarni, vazifalarni, sinflarni uslublarni va x.kz. aytib turadigan nomlardan foydalanish kerak, dasturni tushunilishi yengil bo‘lgan qismlarga bo‘lish kerak, sinflar va ma’lumotlar bazasi tuzilishi maksimal darajada tushunarli va tiniq va x.kz. bo‘lishiga intilish kerak.
Bilimdonlarga dasturlash konsepsiyasi, dastur matniga shu darajada batafsil va puhta o‘ylangan sharhlarni kiritishni ma’qul deb ta’kidlaydiki toki ular nafaqat ijro qilinayotgan kod uchun, balki hamrohlik qilib boradigan xujjatlar uchun ham boshlang‘ich matn bo‘lib qolsin.
Izohlarni yozish uchun sarflangan vaqt, dasturni har qanday modifikatsiyalash o‘zini oqlaydi. Lekin, hamma narsani bir qatorda, xatto o‘z-o‘zidan ko‘rinib turgan harakatlarni ham qo‘shib izohlash arzimaydi.
Quyidagilarni izohlash lozim:

• 
  Fayl sarlavhasi, ushbu fayl ichidagilarni tavsiflab;
  
• 
  Funksiya sarlavhasi, uning argumentlari maqsadi va asl ma’nosini tushuntirib;
  
• 
  Kiritiladigan o‘zgaruvchanlar va ma’lumotlar tuzilishi;
  
• 
  Amalga oshirilayotgan algoritimlarni asosiy bosqich va o‘ziga hosligi.
  
• 
  Tez tushunib olinishi qiyin bo‘lgan har qanday joylari, ayniqsa har xil dasturiy murakkabliklar va nostandart harakatlardan foydalanilganda. Dasturchilar o‘zining ishlash jarayonida ayrim izohlardan foydalanadilar.
  

Bu kabi izohlar, ayniqsa bir kod ustida bir necha nafar ishlab chiquvchilar ishlayotgan vaqtida foydali bo‘ladi. Shunday qilib, dasturchi odatda tugallanmagan kod uchastkasini, yana keyinroq tuzatishga qaror qilingach ………… izohi bilan belgilanadi. XXX yoki ZZZ izohlari, tuzatmay turib ishni davom ettirib bo‘lmaydigan jiddiy xatolik topilganligini anglatadi.