Programma üpjünçiligini ösdürmek dünýäsinde, her bir dörediji ynamdar TODO
düşündirişi bilen tanyş. Köplenç kody, refaktory täzeden gözden geçirmek ýa-da soňraky döwürde bir işi ýerine ýetirmek üçin çalt ýatlatma hökmünde ulanylýar. Timeöne wagtyň geçmegi bilen bu TODO
teswirleri ýygnalyp, tehniki berginiň ümsüm jemlenmegine öwrülip biler - taslamanyň saglygyna we durnuklylygyna täsir edip biljek gizlin ýük.
Gözden geçirilmese, bu dargadylan ýatlatmalar kod bazasyna agram salýar, bu döredijilere ugrukdyrmak, düzeltmek we giňeltmek kynlaşdyrýar. Öz işimde bu meselä ilkinji gezek duş geldim we netijede tehniki bergini görünýän we herekete getirýän gural bilen çözmek kararyna geldim: Todoctor .
TODO
teswirleriniň gizlin meselesi
Ilki bilen TODO
düşündiriş zyýansyz ýa-da peýdaly bolup görünýär. Döredijiler üçin bir zada täzeden göz aýlamak - belki algoritmi optimizirlemek, kyn bölümi gaýtadan işlemek, köne garaşlylygy çalyşmak ýa-da dowam etdirilýän aýratynlygy tamamlamak üçin signaldyr. Şeýle-de bolsa, iş tertibi, ileri tutulýan ugurlary üýtgetmek we berk möhletler bilen bu TODO
-lar köplenç wagtlaýyn yza süýşürilýär. Çözülmegiň ýerine, çözülmän galan zatlaryň artefaktlaryna öwrülýärler.
Wagtyň geçmegi bilen TODO
teswirleri birnäçe meseläni döredip biler:
TODO
teswirleriniň toplanmagy, koduň gowy saklanýandygyny görkezýär, aslynda bolsa doly däl meseleleri we çözülmedik meseleleri gizleýär.TODO
-nyň maksadyny ýatdan çykaryp bilerler, esasanam toparyň agzalary gelip-gidenlerinde. Bu, kod bilen toparyň oňa düşünmeginiň arasynda aragatnaşygyň ösmegine getirýär. Uly taslamalarda ýa-da köp goşant goşanlarda mesele diňe ösýär. TODO
-lar yzygiderli üns bermezden, kod bazasynyň hemme ýerine ýaýradylyp, tehniki bergini dolandyrmak we yzarlamak kyn bolýar.
Bu meseläni çözenimde, TODO
teswirlerini gizlemekden we toparlaryň aňsatlyk bilen baha berip we çözüp boljak hereketli giňişlige çykarmak üçin guralyň zerurdygyna düşündim. Bu, JavaScript we TypeScript kod bazalarynda TODO
düşündirişlerini seljermek we yzarlamak üçin döredilen CLI kömekçi Todoctor- yň döredilmegine sebäp boldy.
“Todoctor” -yň kömegi bilen döredijiler we toparlar wagtyň geçmegi bilen tehniki bergilerini göz öňüne getirip we dolandyryp bilerler, arassalamagy we gaýtadan işlemegi ileri tutmak barada habarly karar bermäge kömek edip bilerler. Bu nähili işleýär:
TODO
nokatlaryny kesgitläň : Todoctor her TODO
teswirini tapmak üçin kod bazasyny gözden geçirýär, her teswiriň ýaşy, awtory we mazmuny barada maglumat ýygnaýar.TODO
-laryň sanynyň wagtyň geçmegi bilen nähili ösendigini görkezýän grafika bilen hasabat döredýär we toparlara tehniki bergilerini aýdyň görkezýär.TODO
-nyň ýaşyny yzarlap bilersiňiz, kimiň döredendigini görüp bilersiňiz we kod bazasyndaky garaşylýan ähli meseleleriň tertipli sanawyny görüp bilersiňiz.
Bu ölçegler arkaly, Todoctor tehniki bergini taslamanyň görünýän, dolandyrylýan elementine öwürýär. Bu aç-açanlyk toparlary möhüm meseleler boýunça çäre görmäge itergi berip biler we bu kodlara eýeçilik we hil medeniýetini ösdürmäge kömek eder.
Todoctor ýönekeýligi we ulanylyşyny göz öňünde tutup, islendik ösüş işine bökdençsiz birleşmäge mümkinçilik berdi. Gural JavaScript-de ýazylyp, bir buýruk bilen gurmagy we işlemegi aňsatlaşdyrýan CLI kömekçi hökmünde işleýär.
Her TODO
düşündirişi üçin Todoctor aşakdaky ýaly meta-maglumatlary ýygnaýar:
Düşündirişiň ýaşy : TODO
kod bazasynda näçe wagtlap işleýär.
TODO
- laryň jemi sany : Karzyň ululygyny yzarlamak üçin göni san.
TODO
- laryň ortaça ýaşy : Işleriň näçe wagt garaşylýandygynyň suraty.
Iň köp goşant goşanlar : Toparyň agzalarynyň TODO
-lary iň köp ýazanlaryny görkezýän sanaw, toparlara belli bir meseleleri yzarlamaga mümkinçilik berýär.
Todoctor bu maglumatlary ulanyp, kod bazasyna goşup ýa-da topar bilen paýlaşyp boljak giňişleýin HTML hasabatyny döredýär.
“Todoctor” -y ulanyp başlamak üçin ony guruň we taslamaňyzyň düýbünde aşakdaky buýrugy işlediň:
npx todoctor
Birnäçe sekundyň içinde Todoctor kod koduňyzy seljerer we tehniki bergiňiz we hereketli düşünjeleriňiz barada doly düşünje berer.
Tehniki bergi ösüşi haýalladyp, koduň hiline täsir edýänçä kiçijik mesele ýaly bolup biler. TODO
düşündirişleri, gysga möhletde peýdaly bolsa-da, aňsatlyk bilen ýatdan çykarylan borçnamalara öwrülip biler. Bu ýatlatmalary göze görnüp duran we ölçäp bolýan edip, Todoctor toparlara kod bazasyna gözegçiligi gaýtadan dikeltmäge mümkinçilik döredýär we geljekde ösmegine taýyn bolmagyny üpjün edýär.
Todoctor-ny synap görüň :