Ochiq manba uchun achchiq qo'llanma

Salom. Men Ken.

Men jahldor, dunyodagi eng yaxshi kompaniyada ochiq manbaning direktoriman.

Agar siz ilgari men haqimda eshitgan bo'lsangiz, ehtimol bu ikki narsadan biriga yoki ikkalasiga ham tegishli:

  1. Tvitterda bir nechta gaplarni gapirish
  2. Slick Carousel, Webpack boshqaruv paneli, Spectacle, Cash va boshqalar kabi ochiq manbali kutubxonalar ...

Bugun biz diqqatimizni # 2 ga qaratamiz. Men yaqinda (va tarixan) ko'p odamlar Ochiq Manba atrofida yo'l-yo'riq so'rashgan edi va men bugun yozishni boshlagan kunimdir.

Maslahatlarga kirishdan oldin, NEGA siz buni qilishni xohlaganingizni va mening shaxsiy tajribamni yoritmoqchiman.

Nima uchun OSS yozish kerak

NEGA kelsak, bir nechta sabablar bor, nima uchun ochiq manba siz uchun va martaba uchun juda yaxshi narsa.

  • Bu sizning shaxsiy brendingiz uchun mo'jizalar yaratishi mumkin. Agar sizda mashhur loyiha bo'lsa, odamlar siz va sizning ishingiz bilan tanishishadi
  • Bu sizning kompaniyangiz brendi uchun mo'jizalar yaratishi mumkin. Ochiq manbali portfelni taqdim etish va saqlash brendga ko'rinishi mumkin. Xodimlarga bu ustida ishlashga vaqt berish va ularning g'oyalarini ko'rib chiqish, bu ish joyi juda yaxshi ekanligiga ishonch hosil qilishi mumkin
  • Siz dasturchi sifatida o'sishingiz mumkin! Siz shunchaki sizning / Users / Me / devshit papkasida g'o'za o'sadigan yonma-yon skriptlarni yozyapsiz. Bu qichqiriqda ko'zlar bor, shuning uchun narsalarni mahkam ushlab turishga harakat.
  • Siz qaytarib berayapsiz. Xuddi shu tarzda loyihada vaqtni qanday tejagan bo'lsangiz, Jon-Devid Dalton lodashni tashlab yuborgan, siz kodingiz bilan boshqa birovga vaqtni tejashingiz mumkin. Siz hamkorlik qilayotgan va baham ko'rganimiz sababli barchamiz vaqtni tejaydigan jamiyatning bir qismisiz.
  • Ajoyib his. Bu erda shaxsan gapirganda, lekin har safar kimdir sizga loyiha uchun minnatdorchilik bildirsa yoki siz ularni saqlab qo'ygan vaqtingiz haqida hikoya qilsa, bu juda ajoyib tuyg'u.
  • Bu sizga ish bermasligi mumkin, chunki aksariyat kompaniyalar GitHub yulduzlariga qat'iy ravishda yollamaydilar, ammo men sizga intervyu olishga yordam bermasa, men yolg'onchi bo'laman.

OSS bilan ishlash tajribam

Buni faqat yo'ldan olib tashlashga imkon bering. Men tarixda qayd etilgan eng yomon Ochiq Manba xizmatchisiman. Ok, ehtimol eng yomoni emas, lekin men har safar eng yaxshi ishimni qilmadim.

Men bir necha bor ochiq manbali loyihalarni to'g'ri boshqarishni uddalay olmadim, ammo agar ularni yaratishda etarli darajada muvaffaqiyatga erishmagan bo'lsam.

Ammo har bir loyihada, men muvaffaqiyatsizliklarimdan saboq oldim va menga yaxshiroq ishlashga yordam beradigan tushunchalar bilan yurdim va keyinroq ularni yoritaman. Albatta, men bundan yaxshilanyapman, lekin umid qilamanki, ba'zi o'quvchilar xatolarimdan saboq olishning o'rniga saboq olishlari mumkin.

Men o'z tajribam haqida qisqacha yozishni afzal ko'raman, chunki odatdagi OSS tajribasiga nisbatan noan'anaviy. Ishoning yoki ishonmang, men butun faoliyatim davomida, ehtimol meniki bo'lmagan loyihalarga 20 dan kam hissa qo'shganman deb o'ylayman. Men tom ma'noda shunchaki narsalarni yozib, tashqariga chiqardim. Menimcha, istiqbol va kontekst bo'yicha qamrab olish muhim.

Mening birinchi OSS loyiham, ehtimol bu mening eng muvaffaqiyatli loyihamdir. Men Nyu-Yorkda yirik moda brendlari uchun elektron tijorat saytlarini yaratadigan agentlikda ishlaganimni eslayman. Men jamoada katta ishchi edim va odatda menga og'ir JS ishini bajarish uchun pir bo'lganlar. Men bilan birga jQuery kunlariga sayohat ...

E-comm moda haqida juda kulgili narsa, HAR QANDAY karusellar mavjud. Ular, shuningdek, murakkab, shuhratparast dizaynlarga moyil. Mavjud karusel / slayder kutubxonalari menga berilgan dizaynni qo'llab-quvvatlay oladigan darajada moslasha olmadi va men CoffeeScript-da noldan boshlab karusellarni yozishni boshladim. Bu ishladi, lekin bu mening hamkasblarim bilan mashhurlik nuqtai nazaridan hech qanday foyda keltirmadi.

Shunday qilib, men aniq ehtiyojni ko'rdim. Dizaynerlar bizga tashlagan, ishlatish uchun qulay va o'zgartirilishi mumkin bo'lgan har qanday narsani qo'llab-quvvatlaydigan moslashuvchan karusel plaginiga ehtiyoj. Shunday qilib yozdim. Biz uchun. Va shunda men bu juda foydali deb qaror qildim, nima uchun boshqalarga ko'p vaqt sarflamaslik kerak, shuning uchun men uni ochdim ...

Bundan chiqdi, bu hammaga ko'p vaqtni tejashga yordam berdi va odamlar unga yoqdi. Chiqarilganidan keyingi dastlabki bir necha oy ichida mashhurlik tom orqali o'tdi. Men OSS-ga yangi kelgan edim va odamlar haqiqatan ham mening narsalarimdan foydalanishganiga juda hayajonlandim, men muammolarni tezda echib, nashrlarni chiqarishga va hech kim u bilan raqobatlashmasligiga ishonch hosil qilishim uchun tuni bilan turishim kerak edi.

O'zimni bu erda biroz qisqartiraman, chunki bu mening hayotiy hikoyam emas, balki maslahatlar bo'yicha maqola: oxirida nima bo'lgan bo'lsa, men g'amxo'rlikni to'xtatdim. Men buni bir nechta narsaga bog'layman. Men ishlarni almashtirdim, shuning uchun menga aslida karusel kerak emas edi, men muammo joyida emas edim. Reaksiya chiqdi va men buni erta boshladim, shuning uchun endi jQuery narsalariga qiziqishim yo'q edi.

Ammo eng katta sabablardan biri meni kuydirib yuborish edi. Men juda ko'p ishladim. Men sharhlarni o'qidim, odamlar juda huquqli va fikrga ega edilar, odamlar karusellardan qanday foydalanmaslik kerak degan fikrga qo'shildilar (garchi men hozirgacha qilgan har bir loyiham bitta edi, va men shunchaki qo'llarim bilan ishladim) va men semirgan edim. yuqoriga ko'tarilib, xotinim xafa bo'ldi.

O'shandan beri men turli sohalarda bir nechta mashhur kutubxonalarga ega bo'ldim, ularning har biri turli xil muammoni hal qilishdi. Mening eng katta qo'rquvim - men boshqa mashhur kutubxonani hech qachon yozmayman, mening xitlarim orqamda. Men shu paytgacha undan qochib qutulganman va bardosh bilan bardosh berishga qodirman, ammo meni bezovta qilishni to'xtata olmaydigan narsalardan biri, bu la'nati karuselni boshqarish bilan Internetning yarmini ishdan bo'shatganimdir.

Shunday qilib, mening OSS bo'yicha maslahatlarim va umid qilamanki, siz ulardan foydalanishingiz va muvaffaqiyatli loyihalarga ega bo'lishingiz mumkin va ochiq manbali aybni zeriktirmaslik uchun viski ishlatmang.

Ishni boshlash

Ochiq manba - bu muzokaralar qilish kabi ko'p narsa. Ko'p odamlar nima sotayotganlari etarli deb o'ylamaydilar. Va bu zarbalar. Agar siz imposter sindromi haqidagi ma'lumotlarni o'qigan bo'lsangiz, bu mutlaqo to'g'ri. Har bir odamning bilim pirogining o'z burchagi bor va hech kimda butun pirog mavjud emas. Siz sotayotgan narsaga muhtoj bo'lgan har doim kimdir bor.

Men o'zimning aniq afzalliklarim bor: a) fuck bermaslik va b) o'rganilmagan ishonchning g'alati miqdori, shuning uchun men shunchaki tashlandim, lekin ko'p odamlar uchun bu qiyinligini payqadim.

Mening maslahatim:

JUST ISHLAB CHIQARING

Nimasi yomon bo'lishi mumkin? Odamlar baqirishadimi? Men sizlarga kido haqida yangiliklar oldim, siz eng mukammal, foydali, fitkin aqlni zarb qiluvchi kodni chiqarib yuborishingiz mumkin edi, bu hech qachon GitHubga tegishi mumkin edi va nima deb o'ylaysiz? Ba'zi eshak kirib, nimanidir hushtak chalib yuboradi. Uning muqarrarligi. Eng yomon vaziyat stsenariysi, siz biror narsani o'rganasiz. Kimdir "Hey, bu ishlashni susaytiradi" kabi bo'lishi mumkin, yoki siz "Uh dasturlashda yomonman, men tashlanmayman" kabi bo'lishingiz mumkin yoki "Oh voy, maslahat uchun rahmat, uni to'g'rilab qo'ygansiz, endi bu yaxshiroq". Uni yaxshilaydigan odam bo'ling.

Xo'sh, nimani qurish kerak? Xo'sh, million dollar savol shu erda!

Men buni quyidagicha ko'rmoqdaman:

  • Sizda muammo bor
  • Muammoni hal qilishingiz mumkin
  • Siz shu qadar chiroyli tarzda o'ralgan echimni taqdim etasizki, odamlar muammolaringizni echishda sizning echimingizdan foydalanishni istaydilar

Shunday qilib, uni qanday qilib go'zal qilish haqida gapirishga imkon bering ...

API Dizayn

Shunday qilib, sizning fikringiz bor. Sizda muammo bor edi va endi uni hal qildingiz. Ammo boshqa odamlar undan to'g'ri foydalanishlarini xohlaysizmi? Boshqa odamlar sizning shiyponingizni ishlatishni xohlashlari haqida ba'zi maslahatlar.

Avvalo, raqobatchilar va texnik xususiyatlarni ko'rib chiqing. Agar kimdir kutubxonasi siznikiga o'xshash narsani qilsa, sizga uni ajratib turadigan narsa kerak bo'ladi. Keyingi mehmonxonani qurmoqchi ekanligingizni aytaylik. Yaxshi qovoqcha omad (afsuski, bu yo'ldan qutulish kerak). Ammo bundan tashqari, bozorning bozor ulushiga kirish uchun sizga ilgak kerak bo'ladi. Bu kichikroq yoki tezroq yoki yaxshiroq API bo'lishi kerak edi. Qayerga ketayotganimni ko'rayapsizmi?

API dizayni haqida gap ketganda, muvozanat bo'lishi kerak. Siz kutubxonadan hech narsa qilmasdan ishlaydigan kutubxonani yasashingiz mumkin, ammo keyin odamlar zerikishni xohlashlaridan shikoyat qilishadi. Siz hamma vaqt eng moslashuvchan, sozlanadigan kutubxonani yasashingiz mumkin edi, ammo keyin siz Tobias Koppers / Shon T. Larkin bo'lar edingiz va odamlar uni sozlashdan shikoyat qilishadi (Kechirasiz, Shon, men kerak edi. V4-da juda yaxshi ish).

Siz qutini ishlab chiqish va kerak bo'lganda sozlash uchun mukammal muvozanatni topishni xohlaysiz. Buning ustiga, siz narsalarni ravshan, tushunarli va bemalol tutishni xohlaysiz. Juda aqlli bo'lmang yoki barchangizni xafa qilasiz.

Men qilishni yaxshi ko'radigan bitta narsa, manbamni juda aniq va aqlli bo'lmagan tarzda yozish. O'z hissangizni qo'shishni osonlashtiradi. Nimalarni nomlang, masturbator funktsional dasturlash bilan shug'ullanmang, agar siz hack qilmoqchi bo'lsangiz, nima uchun bu haqda izoh qo'ying.

O'zim xohlagan narsaning soxta fantaziya APIsi bajarilmaguncha, hozirgi kunlarda men bironta kod satrini yozmayman. Vaqt o'tishi bilan siz uni haqiqatga aylantirishingiz kerak bo'lgan paytda o'zgaradi, lekin bunga intilishning katta maqsadi. API qachon to'g'ri ekanligini bilib olasiz, chunki siz uni ishlatishni his qilasiz.

Chiqarishga tayyor bo'lish

Shunday qilib, siz oldinga o'tdingiz, muammongizni hal qildingiz, uni chiroyli qilib o'rab oldingiz va u borishga tayyor. Endi uni ozod qilish vaqti keldi. Ammo buni amalga oshirishdan oldin, ba'zi odamlar uni ishlatishini istasangiz, yuz berishi kerak bo'lgan ba'zi narsalar mavjud.

BA'ZI FUKKING HUJJATLARINI YAZING.

Men bu erda umuman hazillashmayman. Hujjatlaringiz eng yaxshi yozilgan hujjatlar bo'lishi kerak. "Oddiy" va "shunchaki" kabi xushomadgo'y basharalarni aytishdan saqlaning. Siz yuqorisida sarlavhali havolalar indeksi kerak. Sizga birinchi marotaba qanday qilib ishga tushirishni batafsil tushuntirib beradigan boshlang'ich bo'lim kerak. Sizga kulgili tafsilot bilan hujjatlangan API-ning har qanday burchagi va ayg'oqchasi kerak.

Agar usulingiz bo'lsa, siz kutilgan dalillar, turlar va qaytish turlarini hujjatlashtirishingiz kerak. Siz nima qilayotganini hujjatlashtirishingiz kerak. Siz undan qanday foydalanishni ko'rsatishingiz kerak. Kutubxonangizdan foydalanishni osonlashtiring.

Qanday qilib hissa qo'shishingizni hujjatlashtirishingiz kerak. O'rnatish bosqichlarini qanday bajarishni hujjatlashtirishingiz kerak. Agar siz boshqa loyihaga yoki kontseptsiyaga murojaat qilsangiz, unga havolangizni bering. Agar siz umuman havolaga ega bo'lgan narsaga murojaat qilsangiz, unga bog'lang.

Ehtiyot bo'ling, bu katta farqni keltirib chiqaradi.

BA'ZI ISHLAB CHIQARISH TESTLARINI YOZING.

Meni bu haqda eshiting. Siz bu shilimshiqni tegishli foiz bilan qoplashingiz kerak. Buning sababi nima:

  • Bu sizning kutubxonangizning sog'lig'iga bo'lgan ishonchni ilhomlantiradi
  • Bu sizga PRlarni ishonchli tarzda birlashtirishga imkon beradi
  • Bu sizga bir muncha vaqt loyihadan uzoqda bo'lganingizda, unga ishonch bilan ishlashga imkon beradi

Bir safar men kutubxonani bo'shatdim va Pol Irish ichkariga kirib: "Agar u biron-bir sinovga duch kelsa yaxshi bo'lardi", deb xursand bo'lib kuldi. Tabiiyki, men "Muqaddas yor, uning Pavlusi" kabi edim va testlarni yozishga bordim. Men BU TESTLARNI O'ZGARTIRIShDAN 15 MENGA YO'Q! Rahmat Pol!

Hech narsa qilmasangiz, xudoning la'nati sinovlarini yozing. Iltimos, iltimos. Yuqorida gilos bilan. Bu menga ko'p vaqt va qayg'udan xalos bo'lardi.

Sinovlaringizni yozib bo'lgandan so'ng, uni Travis yoki boshqa narsalarga o'rnating va keyin siz kechasi uxlashingiz mumkin.

NISMALARNI FOYDALANING.

Qanday sinovlarni engib o'tmasin, turlar to'g'ri keladi. Shu kunlarda agar siz JS-ni yozmasangiz, xavfsizlik kamarlarisiz haydab ketasiz. Bundan tashqari, TS yoki Flow-dan foydalanayotgan tobora ko'proq odamlar ushbu turlarning mavjudligini kutmoqdalar. O'zingizning libslaringizni turlarga yozing, eksport qiling va ularning turlarini taqdim eting, keyinroq menga rahmat. Yoki boshqa kimdir uni keyinroq, uchinchi tomon uslubida, eskirgan va noto‘g‘ri kiritishiga ruxsat bering. Istaganingizni qiling.

Repo shartlari

  • README.md
  • CONTRIBUTING.md
  • LITENSE.txt
  • Haqiqiy, to'ldirilgan pack.json

Shunday qilib, O'QING, dux. Siz har doim LICENSE.txt-ni kiritishingiz kerak, yoki ba'zi odamlar sizning repolaringizdan foydalana olmaydilar. Faqat MIT qiling. O'zingiz yozgan bulshit litsenziyasi bilan yoqimli bo'lmang. Faqat MIT. Shunchaki bajargin.

CONTRIBUTING.md nafaqat loyihada qanday ishlash kerakligini aniqlabgina qolmay, balki o'zingizni xulq-atvor kodingiz bilan ulash / qo'shishingiz uchun juda yaxshi joy. Siz kontseptsiyaga qo'shilasizmi yoki yo'qmi, xulq-atvor kodini kiriting. Menga ishoning. Bu ba'zi odamlarga o'z hissalarini qo'shish va ishtirok etishlarini osonlashtiradi va agar siz keyinchalik biron bir muammoga duch kelsangiz, bu ishtiyoqsiz odamlarga bot-bot berayotganda ishora qiladigan ajoyib belgi.

BONUS NARXLARI

Shunday qilib, siz ajoyib hujjatlar yozdingiz, API zich, barcha shartlar joyida va siz repo-ni chiqarmasdan oldin uni super qonuniy qilishga tayyormiz. Menda ba'zi fikrlar bor.

Nishonlar. Hech narsa sizning repoingizni nishonlarga qaraganda ancha aniqroq qiladi. Ko'plab yorliqlar xato bo'lib ko'rinadi, ammo agar siz foydali bo'lganlarni qo'shsangiz, bu qonuniylik muhri. Bu sizning g'amxo'rligingizni ko'rsatadi.

Npm versiyasi, sinov holati, qamrov raqamlari kabi narsalar. Yaxshi niyat.

Bundan tashqari, Markdown xom HTML-ni qo'llab-quvvatlaydi, shuning uchun sizning repo sarlavhangizni chiroyli qilishingiz mumkin. Narsalarni markazga keltiring, narxlar qo'shing va biroz o'zgartiring.

Agar siz haqiqatan ham oltin olishni xohlasangiz, bu erga o'z hissangizni qo'shing: https://github.com/kentcdodds/all-contributors

Loyihaga hissa qo'shgan odamlarni tanib olish juda yoqimli usul. Xudo C. Kent Dodds - NICE GUY UChUN. JIN URSIN.

Bo'shatish va marketing

Shunday qilib, hamma narsa tor, porlash vaqti keldi. Qanday qilib odamlarni o'zingizning yangi liboslaringizni tekshirib ko'rishlari uchun ishlatishingiz mumkin?

Mening tavsiyalarim juda aniq. Dushanba kuni EST soat 12 da chiqaring. Bu Evropaning kuni tugadi, Nyu-Yorkdagi tushlik tanaffusi va ertalab San-Frantsiskosda biron bir narsa qilinmasdan oldin. Sizning maqsadli auditoriyangizning katta qismi barmoqlarini bukib, Internetda aylanib yurishgan.

Qanday qilib ozod qilinishiga kelsak, menimcha, Twitter bu birinchi bekat. G'ayritabiiy da'volarni bering.

"Klaviatura yordamida CSS yozishdan charchadingizmi? Endi siz buni XBox tekshirgichi yordamida qilishingiz mumkin! ”

Siz axlatxonaga tushib qoldingizmi? ULAR FUKKIN VRIDA KO'RAMAYDI? »

Senchi. Ammo kancangiz bor. Va rasmlardan foydalaning. Yoki video. Bu narsa nima qilishini va nima uchun uni ishlatishi kerakligini darhol havolasi bilan aniqlang. Jarayon ketishi kerak:

  • Twitter-ni ko'rib chiqish
  • Oh, bu tvitga qarang
  • Jin ursin! Bu narsa NIMA qiladi !?
  • Bosish havolasi
  • Repoga tushgan erlar, oh ajoyib ko'rinadi
  • Boshlash uchun ketadi
  • Nusxalash / joylashtirish, terminalga, Rok va Rollga joylash
  • [yulduzchani bosish]

Yo'l yurishingiz sizning kuzatuvchilaringiz soniga va sotuvingizning qaysi texnikasiga bog'liqligiga qarab farq qilishi mumkin, ammo bu odatda ishlaydi. Twitter-dan tashqarida HN (uzr) va Reddit-ni ochish uchun ajoyib vositalar mavjud.

Bundan tashqari, agar g'oya sizga kerak bo'lsa, nashrni blog posti bilan birga kuzatib boring, ayniqsa agar siz uni kompaniya shiori ostida qilsangiz. Siz uni uzoqroq shaklda ko'rsatishingiz mumkin.

Dadil bo'ling. O'zinga ishon. Shitingizni birdaniga olib tashlashga tayyor bo'ling.

Ta'minot

Men bu qismga kirishdan qo'rqardim, chunki mening tajribam an'anaviy ravishda to'shakni silkitardi. Ammo men bilgan narsalarim haqida tasavvurga sig'maydigan tarzda gapirishdan mamnunman va umid qilamanki, nima bo'lishini bilib olsangiz.

Shunday qilib, siz kutubxonangizni bo'shatdingiz. Bu ikki yo'ldan biriga o'tdi:

  1. U uchib ketdi.

Kim e'tibor beradi. Men doim shunday bo'lganman. Chizilgan taxtaga qayting. Ba'zida ba'zi narsalar olovga olib kelmaydi. Bu sizni so'rib olganingiz yoki g'oyangiz singib ketgan degani emas, bu shunchaki vaqt emas edi. Muhimi shundaki, siz biron bir narsani qurgansiz. Siz uni to'g'ri qurdingiz. Keyingi safar nimadir qursangiz, muvaffaqiyatga tayyor bo'lasiz. O'zingizni orqangizdan mahkamlang, siz fuckkin jo'natdingiz!

2. Mashhur bo'ldi.

Shunday qilib, bu erda siz haqiqatan ham fuck. Odamlar sizning shitirlashingizni yaxshi ko'radilar. Uni tvitlashmoqda. Siz xatolarni tuzatmoqdasiz va savollar berasiz va fikrni himoya qilasiz. Menda ba'zi fikrlar bor.

Birinchidan, kimdir sizning ustingizdan ishlashga qiziqish bildirsa, ularni xizmat ko'rsatuvchi qilib qo'ying. To'hta:

Agar HIMOYINGIZ LIBINGIZDA IShTIROKChILARNI qiziqtirsa, ULARNI BOShQARISh UChUN

Mana shuning uchun: vaqt o'tadi, yangi texnologiyalar paydo bo'ladi, muammolar o'zgaradi. Siz o'zgarasiz. Repoingiz hali ham o'sha erda bo'ladi. Agar delegatsiya qilmasangiz, sizda yomon vaqt bo'ladi. Siz texnik xizmatdan charchaysiz, siz loyihadan norozi bo'lasiz va u shit shouga aylanadi. Bunga menga ishoning, delegat.

Keyin, odamlar bilan muomala qilish haqida gaplashmoqchiman.

Bu ochiq manbaning eng katta qismlaridan biri bo'lib, kodni yozishdan ko'ra ko'proq vaqt talab etiladi. Odamlar siz bilan gaplashmoqchi. Odamlar huquqqa ega bo'lishadi. Odamlar sizning loyihangizni ommaviy ravishda namoyish qilishmoqchi.

Bu odamlarni siking.

Men narsalar haqida kurashish uchun ko'p vaqt sarflaganman va bu energiyani boshqa joyda o'tkazsam edi. Menga ishoning, nafratlanuvchilarni siking.

Biroq, nafratni aniqlashda hushyor bo'ling. Bilasizmi, ba'zida odamlar aslida ular bo'lmaganida, nafratlanuvchi bo'lib ko'rinishi mumkin. Shuni inobatga oling, siz ushbu manbani DUNYOga yuborayapsiz. Agar siz Amerikalik ekanligingizni va uni ingliz tilida bajargan bo'lsangiz, hamma ham ingliz tilida gaplashmasligini yodda tutish kerak.

Repostonda rus tilida hissa qo'shmoqchimisiz? Ammo siz rus tilini bilmaysiz. Shunday qilib, Google Translate-ga "Hey, bu qachon amalga oshirilishini aniq belgilab qo'yadigan jadval mavjud". Keyin tarjimani rus tilida "Bu qachon amalga oshiriladi" deb ayting. Bir qarashda siz "Hey, bu yigitlarning muammosi nimada" kabi bo'lishingiz mumkin, keyinchalik bu ohang Internetda yaxshi chiqmasligini va tarjima o'rtasida unchalik yaxshi emasligini bilib olasiz.

Ehtiyot bo'ling, ba'zida odamlar dik emas, ular sizning tilingizda gapirishmaydi.

Buning ustiga, men sizga ayta oladigan eng yaxshi narsa bu sizning PR-laringizda qat'iy CI bo'lish va nashr etilgan va PR-shablonlarni to'ldirishdir. Ushbu repo-da bir necha metrli nashrlarni va PRlarni olasiz, va agar siz ularni boshqarish uchun biron bir imkoniyatga ega bo'lishni istasangiz, siz ba'zi asosiy qoidalarni o'rnatishni xohlaysiz. Tavsiya qilaman:

  • Qayta tiklash yoki muvaffaqiyatsiz sinov holatini so'rang
  • Xatolik yuzaga kelgan vaziyatni so'rang

Xatolikni aniqlashga vaqtingiz yo'q. Foydalanuvchilarga xatoning mavjudligini isbotlab bering va uni aniqlashni sodda qilib qo'ying, shunda uni tuzatish uchun vaqt sarflashingiz mumkin.

Shuningdek, CONTRIBUTING.md-da odamlar PR bilan ishlashdan oldin biron-bir masalada sizning fikrlaringizni boshqarishlari kerakligini ta'kidlash kerak. Achinarlisi shundaki, kimdir hech qachon PR bilan ishlamasa, bu hech qachon qabul qilinmaydi.

PRlarni qabul qilish haqida gap ketganda, men sizni ushbu bo'limda qoldirmoqchi bo'lgan oxirgi narsa shundaki, siz odamlar so'ragan narsani qilishingiz shart emas. Men foydalanuvchilarga murojaat qilish orqali ko'plab API-larni yo'q qildim.

Ko'p marta, ba'zi odamlar bitta kichik muammoli bitta narsaga muhtoj, ammo bu katta jamiyat uchun ahamiyatsiz. O'zingizning API-dagi har qanday o'zgartirishlar haqida hushyor bo'ling, chunki g'alati holatlarga ega bo'lgan odamlar sizning API UP-ni FUCK qiladi. Asl gliderlar uchun telemetriya tizimini yaratgan ba'zi bir do'stim uchun nima kerak emas, asosiy lib uchun nima qilish kerak.

Oh, men yolg'on gapirdim, oxirgi narsa. FOYDALANUVCHI VERSIYADAN FOYDALANING. MUSTAHKAM.

Iltimos, iltimos. Yoki yo'q, va hamma o'zlarining xudolari la'nati onglarini yo'qotadilar. Bundan tashqari, teglarni bosing. Va yozuvlarni yozib qo'ying. Batafsil nashr. Sizning kutubxonangiz rivojlanib borar ekan, bu nima bo'layotganini bilish uchun sarmoyadorlar uchun muhimdir.

Shaffof, aniq va ma'lumotli bo'ling. Imtiyozli davrlarsiz narsalarni bekor qilmang. Agar odamlar sizning kutubxonangizga sarmoya kiritsalar va siz narsalarni o'zgartirib, dasturlarini buzsangiz, ular baxtli lagerchilar bo'lmaydi. O'zingizning yangilanishlaringizni rahm-shafqat bilan qiling.

Xulosa

Hozircha, siz nafaqat OSS-ni so'ribgina qolmay, balki yozishni ham anglaganimni angladingiz. Lekin odamlar so'rashdi, shuning uchun men etkazib berdim. Umid qilamanki, bu gijjalar so'zi o'zlarining ochiq manbalarini chiqarishni xohlaydigan kishiga yordam beradi va ularni biroz vaqtni tejashga va biroz yomonlashishga olib keladi.

Bu gaplar uchun juda ko'p narsa bor, lekin agar siz barcha katakchalarni belgilasangiz, tarixanikidan yaxshiroq vaqt topasiz va muvaffaqiyatga erishish uchun yaxshi imkoniyatga ega bo'lasiz.

Bularning barchasi bilan, menda so'nggi bitta maslahat bor. Agar xohlamasangiz, buni qilmang. O'zingizni shunday his qilmang. Siz ishsiz ish topishingiz mumkin. Siz ularsiz yaxshi dasturchi bo'lishingiz mumkin. Men bundan katta foyda oldim va buni qilishdan zavqlandim, lekin oilam bilan yoki sevimli mashg'ulotlarim bilan shug'ullanishim yoki passivlikni ta'minlaydigan biron bir ish bilan shug'ullanishim mumkin bo'lgan kutubxonalarni bepul o'tkazgan vaqtimni hech qachon qaytarib bermayman. daromad. Buni xohlaganingiz uchun qiling. Agar siz o'zingiz qurayotgan narsaga ishtiyoqsiz bo'lsangiz, ehtimol bu muvaffaqiyat qozonmaydi.