Huddi shu narsani bu yerga ham copy qilib PR yuborishingiz mumkin. Agar kimgadir qiziq bo'lsa marhamat.

https://github.com/floss-uz/regulator

done

Bu hali ham actual, tushunarli bo'lishi uchun replyAnswers ichiga hamma textlarni joylab qo'yganman.

https://github.com/floss-uz/regulator/issues/3

Biz issue va PR templatelar ustida ham ishlayabmiz, bundan asosiy maqsad har bir issue, feauture request, pull requestlarning tartibli va aniqroq ma'lumotga ega bo'lishi. Masalan nimadir kimnidir qurilmasida, muhitida ishlamadi xatolik chiqdi.

Bulardan maqsad shuki, aynan shu xatolikni imkon qadar tushunarli qilib yetkazishi.

Kimdir qandaydir issuega PR yuborsa ham huddi shunday holat, conversationlar kamroq fa maksimal effektiv bo'lishi uchun Pull requestlarda kerak bo'lsa qanday uslubda test qilingani ham yoziladi.

Xozircha birgina bot misolida manashunday holat shakillandi.

Agar fikr va takliflar bo'lsa PR commentlarida yozaveringlar.

https://github.com/floss-uz/regulator/pull/4

Biz yaqin kunlarda reja qilgan xujjatlar quyidagilardan iborat.

PR templates
Issue templates
Readme docs guideline
Codeofconduct
Contrabuting guides

Bulardan tashqari endilikda sekin sekin kodga commentlar ham qoldirishni boshlayman.

Eng muhimi imkon qadar informativ va moslashishga oson bo'lishi.

Tassavur qiling siz qandaydir loyiha qilyabsiz, aytaylik qandaydir muammoni hal etadigan kichik kutbxona.

Readme.md fayl ichiga ushbu kutbxona haqida ma'lumot yozasiz. Agar uncha katta bo'lmasa user documentation ham o'sha yerga qo'shib ketiladi. Tabiyki sizda unchalik ham ko'p faylar bo'lmaydi. Shu sababdan qo'shimcha contextlar kerak bo'lmaydi.

Lekin qancha aniq context berilsa biror narsani hal etish yoki tushunish shuncha oson bo'ladi. Biror ishni o'zingizcha qilib qo'ydingiz bo'ldi emas. Balki shu ishga masuliyat olish va qilingan ishni yetkazib berishgacha bo'lgan jarayonlarda ham qatnashish kerak. Masalan qandaydir PR yubordingiz, siz yozgan kodni review qilganlar feedback berishdi, demak diskussiyani davom ettirib ular bilan kelishib ushbu ishni ohirigacha yetkazish lozim bo'ladi. Bu narsalarni tashkillashtirish va ikki toon amal qilishi uchun esa yuqorida aytilgan xujjatlarga yaxshilab etibor qilish kerak.

Bazilar aytadiki bu narsalar allaqachon bor tayyorini olib qo'ysa bo'ldi, deyishadi ammo masala shundaki siz qilayotgan loyiha, sizning jamoa ishlaydigan muhit va qoidalar hammanikidan birmuncha farqli bo'lishi mumkin shu sababdan githubga kirsangiz turli loyihalarda turlicha workflow organizationi ko'rasizlar. Ha asoslar deyarli birxil ammo detallar ancha farqli bo'ladi va manashu detallar katta axamiyatga ega.

Yangi challenge, bu safar tarjima emas. Aniq narsa yani command optionlarni parserini qilish kerak.

https://github.com/floss-uz/regulator/issues/9

Fikrimcha github PRlar va Issuelarda bo'ladigan suxbatlar eng zo'ri.

1. Doyim ancha tor va aniq context bor.
2. Hamma o'z vaqtini o'zi belgilaydi va asinxron komunikatsiya imkoni mavjud. Bu yaxshigina moslashuvchanlik berib qo'yadi.
3. Manashu conversationlar shu joyda mixlanib qoladi, kerak bo'lganida topib reference qilish yoki bo'lmasam biroz muddatdan kegin yana bir o'qib qayta contextga kirib olish mumkin.
4. Masalan bitta issue ketidan boshqa issuelar ochilishi mumkin chunki ancha toza discussionlar sababli bir biriga bog'liq narsalarni kimdir aytib qolishi mumkin.

Bizda ham sekin sekin manashu madaniyat shakillanyabti va albatta bu hursand qiladi !

Shu joyiga esimga kelib qoldi ))

https://www.youtube.com/watch?v=9sJUDx7iEJw