paint-brush
TODO-lary nädip toplamak tehniki bergä öwrülýär (we ony dolandyrmak üçin açyk çeşme guralym)tarapyndan@azatio
Täze taryh

TODO-lary nädip toplamak tehniki bergä öwrülýär (we ony dolandyrmak üçin açyk çeşme guralym)

tarapyndan Azat S.4m2024/11/05
Read on Terminal Reader

Örän uzyn; Okamak

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 etmek bilen, Todoctor toparlara kod bazasyna gözegçiligi gaýtadan dikeltmäge mümkinçilik berýär we geljekde ösmegine taýyn bolmagyny üpjün edýär.
featured image - TODO-lary nädip toplamak tehniki bergä öwrülýär (we ony dolandyrmak üçin açyk çeşme guralym)
Azat S. HackerNoon profile picture
0-item

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:


  • Görünmeýän tehniki bergi : TODO teswirleriniň toplanmagy, koduň gowy saklanýandygyny görkezýär, aslynda bolsa doly däl meseleleri we çözülmedik meseleleri gizleýär.
  • Kodyň hiliniň peselmegi : Düzedilmedik ýagdaýynda, bu teswirler kemçiliklere, kod saklamak kyn we garaşylmadyk hereketlere goşant goşup biler.
  • Kontekstiň ýitmegi : Wagtyň geçmegi bilen döredijiler her 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.

Çözgüdi: “Todoctor” bilen tehniki bergini görmek


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.
  • Tehniki bergini göz öňüne getiriň : Soňra 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.
  • Jogapkärçiligi höweslendiriň : Todoctor bilen, her 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-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 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 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. 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üň :