Yordam so'rash va kod ulashish: yaxshi savol, minimal misol va XY muammosi

Qisqacha: Yaxshi savol — yarim javob. Unda maqsad, eng kichik qayta takrorlanadigan kod (minimal reproducible example), kutilgan va haqiqiy natija, asl xato matni hamda nimalar sinab ko'rilgani bo'ladi. "Salom, kim yordam beradi?" deb kutmang — savolni birinchi xabarda to'liq yozing. Kod matn yoki havola (Gist, CodePen, StackBlitz) bilan ulashiladi, ekran rasmi bilan emas — va undan oldin parol hamda tokenlar olib tashlanadi.

Bu darsda

• Qachon yordam so'rash kerakligini va undan oldin nima qilishni bilasiz.
• Yaxshi savolni 6 qismli shablon bo'yicha yoza olasiz.
• Katta koddan minimal reproducible example ajrata olasiz.
• XY muammosini taniysiz va undan qochasiz.
• Kodni Gist, CodePen yoki StackBlitz orqali xavfsiz ulasha olasiz.

Oldin bilishingiz kerak: Xato xabarini o'qish san'ati, Samarali qidirish (googling), Markdown, YAML, TOML, INI va .env.

1. Nega bu kerak?

Ikki o'quvchi bir guruhga yozdi.

Ali: "Salom, kim yordam bera oladi?" Keyin yarim soat javob kutdi. Birov "ha, nima gap?" deb yozguncha kechqurun bo'ldi.

Malika bitta xabarda yozdi: nima qilmoqchi, 4 qatorlik kod, xato matni va nimalarni sinab ko'rgani. 10 daqiqada ikki kishi javob berdi.

Guruhdagi odamlar ham band. Ular bepul, o'z vaqtidan yordam beradi. Tushunarli savolga javob berish oson va yoqimli. Tushunarsiz savolga esa avval "nima demoqchisiz?" deb so'rash kerak — ko'pchilik buni qilmaydi va o'tib ketadi.

Bu dars — yordam so'rashning "odobi va texnikasi". U dasturchilar jamoasida ham, ishda ham, internetda ham bir xil ishlaydi.

2. So'rashdan oldin

2.1 O'zingiz bir urinib ko'ring

Yordam so'rash — zaiflik emas. Lekin oldin o'zingiz bir qadam qo'yganingiz sezilishi kerak. Oldingi darslardagi uch qadam:

1. Xabarni o'qing — tur, matn, manzil (xato xabarini o'qish).
2. Qidiring — asl xato matnini qo'shtirnoqda (samarali qidirish).
3. Hujjatga qarang — README yoki MDN (hujjat o'qish).

15–20 daqiqa qoidasi: shu uch qadamdan keyin 15–20 daqiqa ichida siljish bo'lmasa — so'rang. Soatlab bir joyda turish ham xato: vaqt yo'qoladi, ruhiyat tushadi.

2.2 Kauchuk o'rdak yana yordam beradi

Muammo yechish darsida ko'rgan kauchuk o'rdak usulini eslang: muammoni ovoz chiqarib, qatorma-qator tushuntirsangiz, xato ko'pincha o'zi chiqib keladi. Yaxshi savol yozish ham xuddi shunday ta'sir qiladi — ko'p dasturchilar savolni yozib bo'lmasdan javobni topadi.

Tekshirib ko'ring: Siz 5 daqiqa oldin xato ko'rdingiz va hali xabarni o'qimadingiz. Guruhga yozish vaqti keldimi?

3. Yaxshi savolning tuzilishi

3.1 "So'rash uchun so'ramang"

Chatlarda eng ko'p uchraydigan odat:

• "Salom" — va javob kutish.
• "JavaScript'ni biladigan bormi?" — va javob kutish.

Inglizcha buning nomi bor: don't ask to ask — "so'rash uchun ruxsat so'ramang". Kimdir "ha, bilaman" desa ham, u sizning savolingizni hali bilmaydi. Yana bir aylana kutish kerak bo'ladi.

To'g'ri: salom va savolni bitta xabarda yozing. Odob saqlanadi, vaqt ham tejaladi.

3.2 Olti qismli shablon

Muhit (environment) — kodingiz ishlayotgan sharoit: operatsion tizim, Node.js va paketlar versiyasi. Bir xil kod Windows va Linux'da, Node 22 va Node 24 da har xil ishlashi mumkin.

3.3 To'liq namuna

Telegram yoki Discord uchun yozilgan savol:

Salom! npm skriptim ishga tushmayapti.

Maqsad: `npm run dev` bilan loyihamni ishga tushirmoqchiman.

package.json:
{
  "name": "dokon",
  "scripts": {
    "start": "node server.js"
  }
}

Kutilgan: server ishga tushishi.
Haqiqiy: npm error Missing script: "dev"

Sinab ko'rdim: `npm install` qildim — o'zgarmadi.
Muhit: Windows 11, Node 24.21.0, npm 11.19.0.

Haqiqiy xabarda package.json qismi va xato matnini alohida kod bloki ichiga olgan ma'qul (pastdagi maslahatga qarang).

Bu savolga javob berish uchun 10 soniya yetadi: scripts ichida dev yo'q, faqat start bor. Yo npm start yozish kerak, yo package.json ga dev skriptini qo'shish.

Ko'rdingizmi? Savol to'liq bo'lgani uchun yordamchi hech narsa so'rab o'tirmadi.

Maslahat: Telegram va Discord'da kodni uchta teskari qo'shtirnoq () ichiga oling — u shriftda chiroyli, bo'sh joylar buzilmagan holda chiqadi. Bu [Markdown darsida](/javascript/01-qism-kompyuter-fayllar-va-terminal/37-markdown-dasturchi-yozuv-tili) o'rgangan kod bloki. Discord'da ```` js ```` deb yozsangiz, kod rangli ham bo'ladi.

Tekshirib ko'ring: Shablondagi qaysi qism yo'q bo'lsa, yordamchi eng ko'p qiynaladi: "Muhit" yoki "Haqiqiy natija"?

4. Minimal reproducible example

4.1 Nima u?

Yangi boshlovchi ko'pincha butun loyihani — 500 qator kodni yoki arxivni — yuboradi. Begona odamning 500 qatorini hech kim o'qimaydi.

Minimal reproducible example (qisqacha MRE yoki "minimal misol") — xatoni ko'rsatadigan eng kichik kod. Uchta shart bor:

• Minimal — muammoga aloqasi yo'q hamma narsa olib tashlangan.
• To'liq (complete) — boshqa odam uni o'zida ishga tushira oladi: hech narsa yetishmaydi.
• Qayta takrorlanadigan (reproducible) — ishga tushirilganda aynan sizdagi xato chiqadi.

O'xshatish: avtoservis. Mashinangizda g'alati tovush bor. Ustaga "mashinam yomon" demaysiz. "Chapga burilganda, 40 km/soat tezlikda, oldingi g'ildirakdan taqillaydi" deysiz. Usta bitta sinov bilan tovushni eshitadi.

4.2 To'liq yechilgan misol: 200 qatordan 1 qatorgacha

Jasurning dokon.js dasturida 200 qator bor: mahsulotlar ro'yxati, chegirmalar, chek chiqarish. Chekda jami narx 50002000 so'm chiqyapti, 7000 bo'lishi kerak edi.

Jasur qismlarni birma-bir olib tashlaydi va har safar tekshiradi:

1. Chegirmalarni olib tashladi — xato qoldi. Demak, chegirmada emas.
2. Mahsulotlar ro'yxatini ikkitaga qisqartirdi — xato qoldi.
3. Chek bezaklarini olib tashladi — xato qoldi.
4. Nihoyat, hammasi bitta qatorga tushdi:

console.log("5000" + 2000); // 50002000

Mana MRE. Endi hamma ko'radi: "5000" — qo'shtirnoqda, ya'ni matn. Matnga son "qo'shilganda" JavaScript ularni yopishtirib qo'yadi. Nega shunday ekani — JavaScript qismida to'liq o'rganamiz. Muhimi — muammoning o'zi 200 qatordan 1 qatorga tushdi.

Ajablanarlisi: MRE tayyorlash jarayonida ko'pincha javobni o'zingiz topasiz. Jasur ham 4-qadamda qo'shtirnoqni ko'rib, sababni tushundi.

4.3 O'zingiz to'ldiring

Katta koddan MRE ajratish tartibi:

1. Xatoga aloqasi yo'q qismni olib .
2. Har olib tashlashdan keyin xato hali ham — tekshirasiz.
3. Xato yo'qolsa — oxirgi olib tashlangan qism muammoga aloqador; uni qaytarasiz.
4. Qolgan kodni alohida faylga olib, node fayl.js bilan boshqa kompyuterda ham xato chiqishini tekshirasiz.

Tekshirib ko'ring: Siz MRE yubordingiz, lekin unda import qilingan faylingiz yo'q. Yordamchi kodni ishga tushirolmadi. MRE'ning qaysi sharti buzilgan?

5. XY muammosi

5.1 Nima u?

XY muammosi (XY problem) — odam o'z asl muammosi (X) haqida emas, uni hal qilish uchun o'ylab topgan yo'li (Y) haqida so'rashi.

Hayotiy misol: siz dorixonada "menga eng o'tkir pichoq kerak" deysiz. Aslida esa dori qutisining plomba lentasini ocholmayapsiz. Sotuvchi sizga pichoq tanlab beradi. Agar "qutini qanday ochaman?" deganingizda, u "mana bu yerini torting" deb bir soniyada ko'rsatardi.

5.2 Dasturlashdagi misol

Sardor fayl turini (rasm, hujjat, video) aniqlamoqchi (X). U o'yladi: "fayl nomining oxirgi 3 harfini olsam — jpg, pdf, mp4 chiqadi" (Y). Va guruhga so'radi: "matnning oxirgi 3 harfini qanday olaman?"

flowchart TD
    X["X: asl maqsad — fayl turini bilish"] --> Y["Y: o'ylab topilgan yo'l — oxirgi 3 harf"]
    Y --> Q["Savol faqat Y haqida"]
    Q --> J["Javob Y ga beriladi"]
    J --> P["rasm.jpeg da buziladi: 'peg'"]

Unga to'g'ri javob berishdi — oxirgi 3 harfni olishni. Lekin rasm.jpeg (4 harfli kengaytma) yoki README (kengaytmasiz) kelganda dastur buzildi. Agar u X ni aytganida, unga Node.js'dagi tayyor usul — path.extname() — aytilardi. U kengaytmani uzunligidan qat'i nazar to'g'ri ajratadi.

Qoida: savolda doim maqsadingizni (X) ham yozing. Shablondagi "Maqsad" qismi aynan shu uchun.

Tekshirib ko'ring: Malika so'radi: "Terminalda 50 ta faylni qanday qilib birma-bir qo'lda qayta nomlasam tezroq bo'ladi?" Bu XY muammosimi? X nima bo'lishi mumkin?

6. Kodni ulashish

6.1 Ekran rasmi emas — matn

Monitorni telefonda qiyshiq rasmga olish. Uni o'qish qiyin, nusxalab bo'lmaydi, qidiruvga berib bo'lmaydi.

Ekran rasmi (screenshot) — biroz yaxshiroq, lekin baribir nusxalab bo'lmaydi.

Kod va xato — matn sifatida, kod blokida. Uzun bo'lsa — havola bilan.

Ekran rasmi faqat "ko'rinish" haqidagi savolda o'rinli: masalan, sahifa dizayni buzilganini ko'rsatish uchun.

6.2 Kod ulashish xizmatlari

Qaysi birini tanlash:

• Bitta fayl, ishga tushirish shart emas — Gist.
• HTML/CSS muammo — CodePen yoki JSFiddle. HTML va CSS'ni keyingi qismdan boshlab o'rganamiz — o'shanda CodePen eng ko'p ishlatadigan vositangiz bo'ladi.
• Node.js yoki npm paketli loyiha — StackBlitz. Yordamchi havolani ochadi va xatoni o'z ko'zi bilan ko'radi.

Tekshirib ko'ring: Sizning muammoingiz npm paketi o'rnatilgan kichik Node.js loyihasida. Yordamchi xatoni o'zida ko'rishi uchun qaysi xizmat eng qulay?

7. Hujumchi nigohi

Kod ulashish — xavfsizlik bilan bog'liq ish. Hujumchi qanday foydalanadi?

Hujum: ochiq joylarga (Gist, GitHub, ommaviy Telegram guruh) qo'yilgan kod avtomatik dasturlar — botlar — tomonidan doimiy kuzatiladi. Ular matn ichidan parol, API kalit va tokenlarni qidiradi. Topilgan kalit bir necha daqiqada ishlatilishi mumkin: sizning hisobingizdan xizmatga pul sarflanadi, bot boshqariladi yoki baza o'g'irlanadi.

Eng ko'p uchraydigan sizib chiqish yo'llari:

• .env faylini butunligicha nusxalab yuborish.
• Xato xabari ichida token yoki parol bilan to'liq manzil qolib ketishi.
• Ekran rasmida ochiq turgan terminal yoki sozlama oynasi.

Himoya:

1. Ulashishdan oldin kodni ko'zdan kechiring: PASSWORD, TOKEN, KEY, SECRET so'zlarini qidiring.
2. Haqiqiy qiymatni o'rinbosar bilan almashtiring: BOT_TOKEN=sizning_tokeningiz. Bu .env darsidagi .env.example qoidasi bilan bir xil.
3. Gist'dagi "secret" (maxfiy) varianti aslida maxfiy emas: havolani bilgan har kim uni ocha oladi. U faqat qidiruvda chiqmaydi, xolos.
4. Kalit tashqariga chiqdimi — uni o'chirish yetmaydi, almashtiring (yangisini oling, eskisini bekor qiling).

8. Qayerda so'rash va javobdan keyin

8.1 Joylar

• Stack Overflow — dunyodagi eng katta dasturchilar savol-javob sayti. Qoidalari qat'iy: savol inglizcha, bitta savol — bitta muammo, MRE majburiy. "Salom" va "rahmat" yozilmaydi — faqat mazmun. Takroriy savol yopiladi, shuning uchun avval qidiring.
• Telegram va Discord hamjamiyatlari — o'zbek dasturchilarining guruhlari, kutubxonalarning rasmiy Discord serverlari. Tezroq va erkinroq, lekin shablon bu yerda ham ishlaydi.
• GitHub Issues va Discussions — faqat aniq bir kutubxonadagi xato yoki savol uchun (hujjat o'qish darsida ko'rgan edik).
• Ustoz yoki hamkasb — ishda eng tez yo'l. Uning vaqtini hurmat qilish uchun ham shablondan foydalaning.
• AI yordamchilar — tez va doim tayyor, lekin xato qilishi mumkin. Ular haqida keyingi darsda.

8.2 Javob kelgandan keyin

• Rahmat ayting va natijani yozing: "ishladi" yoki "ishlamadi, endi bunday xato chiqdi".
• Yechimni yozib qo'ying. O'zingiz topgan bo'lsangiz ham: "Muammo X ekan, Y bilan hal bo'ldi". Ertaga xuddi shu savol bilan kelgan odam qidiruvda sizning xabaringizni topadi.
• Stack Overflow'da yordam bergan javobni qabul qiling (yashil belgi) — qidirish darsida uning ahamiyatini ko'rgan edik.

Tekshirib ko'ring: Siz guruhda savol berdingiz, keyin javobni o'zingiz topdingiz. Eng to'g'ri harakat qaysi: xabarni o'chirish, jim turish yoki yechimni yozish?

9. Ko'p uchraydigan xatolar

9.1 "Ishlamayapti" — va boshqa hech narsa

"Kodim ishlamayapti, yordam bering."

Nima ishlamayapti, qanday xato chiqdi, nima kutgan edingiz — 3.2 dagi shablon.

9.2 Xato matnini o'z so'zingiz bilan qayta aytish

"Qandaydir not defined degan xato chiqdi."

Xatoni to'liq, asl holida nusxalang: ReferenceError: narx is not defined. Bir so'z ham muhim bo'lishi mumkin.

9.3 Butun loyihani yuborish

Arxiv yoki 500 qatorlik fayl.

MRE: xatoni ko'rsatadigan eng kichik, to'liq kod.

9.4 Maxfiy qiymat bilan kod ulashish

.env yoki tokenli kodni guruhga tashlash.

Ulashishdan oldin tekshirish va o'rinbosar qo'yish (7-bo'lim).

9.5 Bir savolni hamma joyga birdan tashlash

Bir xil savolni 10 ta guruhga bir vaqtda yozish va hech birida javobni kuzatmaslik.

Bir-ikki mos joyga yozing. Boshqa joyda yechim topsangiz, birinchisiga ham yozib qo'ying.

10. Mashqlar

1-mashq (oson)

Quyidagi xabarni 3.2 shablon bo'yicha qayta yozing. Yetishmayotgan ma'lumot o'rniga taxminiy, lekin aniq qiymat qo'ying.

"Salom, node ishlamayapti, nima qilay?"

Ishora: olti qism — maqsad, kod, kutilgan, haqiqiy, sinab ko'rganlarim, muhit.

Salom! node buyrug'i topilmayapti.

Maqsad: salom.js faylini ishga tushirmoqchiman.
Buyruq: node salom.js
Kutilgan: "Salom" chiqishi.
Haqiqiy: bash: node: command not found
Sinab ko'rdim: Node.js'ni o'rnatdim, terminalni qayta
ochmadim.
Muhit: Windows 11, Git Bash.

2-mashq (o'rta)

Bu XY muammosimi? X va Y ni ajrating va to'g'ri savolni yozing.

"Terminal oynasini qanday qilib kattaroq qilsam bo'ladi? Xato xabari juda uzun, oxiri ko'rinmay qolyapti."

Ishora: 5-bo'lim — odam nima qilmoqchi va buning uchun qanday yo'l o'ylab topgan.

3-mashq (qiyin)

Sizda Telegram bot kodi bor (hali bot yozishni bilmasangiz ham, vaziyatni tasavvur qiling). Unda 150 qator kod, .env faylida BOT_TOKEN=7291... bor. Bot /start buyrug'iga javob bermayapti. Yordam so'rash rejangizni tuzing: nimani ulashasiz, nimani ulashmaysiz, qaysi xizmat orqali va xabar qanday ko'rinishda bo'ladi.

Ishora: 4-bo'lim (MRE), 6.2 (xizmatlar) va 7-bo'lim (maxfiy qiymatlar).

11. Real ishda

• Jamoada. Yangi xodimdan hech kim hamma narsani bilishini kutmaydi. Lekin yaxshi savol berishni kutadi. Ko'p kompaniyalarda norasmiy qoida bor: "15–30 daqiqa o'zing urin, keyin so'ra". Juda erta so'rash ham, soatlab jim o'tirish ham yomon.
• Ish yozishmalarida. Slack yoki Telegram'da hamkasbga yozganda ham xuddi shu shablon: maqsad, holat, xato, sinaganlar. Bu "katta" dasturchilarning ham odati.
• Kod ko'rib chiqishda. Keyinroq o'rganadigan pull request va issue'lar ham xuddi shu tuzilishda yoziladi: nima, nega, qanday tekshirildi.
• Intervyu. "Bilmagan narsangizga duch kelsangiz nima qilasiz?" — "o'zim qidiraman, hujjatni o'qiyman, 20 daqiqada siljimasam — minimal misol bilan so'rayman".

Xulosa

• Yordam so'rashdan oldin: xabarni o'qing, qidiring, hujjatga qarang; 15–20 daqiqada siljish bo'lmasa — so'rang.
• "So'rash uchun so'ramang": salom va savol — bitta to'liq xabarda.
• Yaxshi savol: maqsad, kod, kutilgan va haqiqiy natija (asl xato matni), sinab ko'rilganlar, muhit.
• MRE — xatoni ko'rsatadigan eng kichik, to'liq kod; uni tayyorlash ko'pincha javobni o'zi ochadi.
• XY muammosidan qochish uchun doim asl maqsadni (X) ayting.
• Kod matn yoki havola (Gist, CodePen, StackBlitz) bilan ulashiladi; parol va tokenlar oldin olib tashlanadi.

Keyingi dars: AI dasturlash yordamchilari xaritasi — ChatGPT, Claude, Copilot va boshqa AI vositalar nimaga qodir, nimaga yo'q va ulardan o'rganish davrida xavfsiz foydalanish qoidalari.