Programma üpjünçiligini ösdürmek dünýäsinde, her bir dörediji ynamdar 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 teswirleri ýygnalyp, tehniki berginiň ümsüm jemlenmegine öwrülip biler - taslamanyň saglygyna we durnuklylygyna täsir edip biljek gizlin ýük. TODO TODO 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 https://github.com/azat-io/todoctor?embedable=true teswirleriniň gizlin meselesi TODO Ilki bilen 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 -lar köplenç wagtlaýyn yza süýşürilýär. Çözülmegiň ýerine, çözülmän galan zatlaryň artefaktlaryna öwrülýärler. TODO TODO Wagtyň geçmegi bilen 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. Görünmeýän tehniki bergi TODO : Düzedilmedik ýagdaýynda, bu teswirler kemçiliklere, kod saklamak kyn we garaşylmadyk hereketlere goşant goşup biler. Kodyň hiliniň peselmegi : Wagtyň geçmegi bilen döredijiler her -nyň maksadyny ýatdan çykaryp bilerler, esasanam toparyň agzalary gelip-gidenlerinde. Bu, kod bilen toparyň oňa düşünmeginiň arasynda aragatnaşygyň ösmegine getirýär. Kontekstiň ýitmegi TODO Uly taslamalarda ýa-da köp goşant goşanlarda mesele diňe ösýär. -lar yzygiderli üns bermezden, kod bazasynyň hemme ýerine ýaýradylyp, tehniki bergini dolandyrmak we yzarlamak kyn bolýar. TODO Çözgüdi: “Todoctor” bilen tehniki bergini görmek Bu meseläni çözenimde, 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 düşündirişlerini seljermek we yzarlamak üçin döredilen CLI kömekçi yň döredilmegine sebäp boldy. TODO TODO Todoctor- “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: nokatlaryny : Todoctor her teswirini tapmak üçin kod bazasyny gözden geçirýär, her teswiriň ýaşy, awtory we mazmuny barada maglumat ýygnaýar. TODO kesgitläň TODO : Soňra -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. Tehniki bergini göz öňüne getiriň TODO : Todoctor bilen, her -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. Jogapkärçiligi höweslendiriň TODO 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-yň tehniki durmuşa geçirilişine göz aýlamak 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 düşündirişi üçin Todoctor aşakdaky ýaly meta-maglumatlary ýygnaýar: TODO : kod bazasynda näçe wagtlap işleýär. Düşündirişiň ýaşy TODO - : Karzyň ululygyny yzarlamak üçin göni san. TODO laryň jemi sany - : Işleriň näçe wagt garaşylýandygynyň suraty. TODO laryň ortaça ýaşy : Toparyň agzalarynyň -lary iň köp ýazanlaryny görkezýän sanaw, toparlara belli bir meseleleri yzarlamaga mümkinçilik berýär. Iň köp goşant goşanlar TODO 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 meselesini näme üçin göz öňüne getirmek? Tehniki bergi ösüşi haýalladyp, koduň hiline täsir edýänçä kiçijik mesele ýaly bolup biler. 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. TODO : Todoctor-ny synap görüň https://github.com/azat-io/todoctor?embedable=true