Rodyti HN: Deff – šalia esanti Git skirtumo peržiūra jūsų terminale

Kodėl jūsų komandos kodo peržiūros įpročiai yra paslėpta verslo problema

Daugelio programinės įrangos verslų centre yra ypatingas atsijungimas. Lyderystė daug investuoja į CRM platformas, analizės prietaisų skydelius ir žmogiškųjų išteklių sistemas – įrankius, kurie yra iš karto matomi, išmatuojami ir susieti su pajamomis. Tuo tarpu kūrėjo darbo eiga – tikrasis variklis, kuris gamina šių įmonių parduodamą programinę įrangą – paliekama atskiriems inžinieriams, derinant visus įrankius, kuriuos jie gali rasti. Rezultatas yra neefektyvumo kratinys, kuris retai pastebimas atliekant ketvirčio apžvalgą, bet kiekvieną dieną praranda laiką, kokybę ir pinigus.

Įrankių, pvz., terminalo pagrindu veikiančių „side-by-side Diff Viewer“, atsiradimas yra kažkas svarbesnio už nedidelį kūrėjų gyvenimo kokybės pagerėjimą. Tai rodo, kad inžinierių komandos galvoja apie savo vidines darbo eigas. Kai kūrėjas gali peržiūrėti kodo pakeitimus aiškiau, mažiau konteksto perjungimų ir nereikia naršyklės skirtuko, paskesni efektai keičiasi dėl diegimo dažnio, klaidų dažnio ir galiausiai klientų pasitenkinimo. Tai ne kūrėjo problema – tai verslo problema, kuri pagaliau randa kūrėjo sprendimą.

Paslėptos konteksto perjungimo išlaidos peržiūrint kodą

Kalifornijos universiteto Irvine atliktas tyrimas parodė, kad po pertraukos visiškai susikaupti užtrunka vidutiniškai 23 minutes. Kūrėjams konteksto perjungimas kodo peržiūros metu yra ypač žalingas. Perėjimas nuo terminalo seanso prie žiniatinklio diferencijavimo įrankio, naršymas per „GitHub“ sąsają, laukimas, kol puslapiai bus įkelti, ir grįžimas prie vietinės plėtros reiškia pažintinį mokestį, kuris inžinierių komandai per dieną surenkamas dešimtis kartų.

Apsvarstykite dešimties kūrėjų komandą, kurių kiekvienas kasdien skiria 90 minučių kodo peržiūrai – tai konservatyvus įvertinimas komandoms, prižiūrinčioms gamybos kodų bazes. Jei net 20 minučių iš to laiko iššvaistote nereikalingiems konteksto perjungimams, prarandate 200 kūrėjo minučių per dieną arba maždaug 17 valandų per savaitę. Kai kūrėjo atlyginimas yra 120 000 USD per metus, tai yra daugiau nei 50 000 USD per metus, todėl produktyvumas išnyksta dėl vartotojo sąsajos trinties. Ne klaidų. Ne techninė skola. Gryna trintis dėl įrankių, kurie nebuvo sukurti taip, kaip iš tikrųjų dirba kūrėjai.

Savieji terminalų diferencijavimo įrankiai pašalina šią specifinę atliekų kategoriją, nes kūrėjai išlieka toje aplinkoje, kurioje jie jau veikia. Nėra režimo jungiklio, nėra autentifikavimo raginimo, nėra naršyklės. Peržiūra atliekama ten, kur veikia kodas, būtent ten kūrėjai praleidžia didžiąją laiko dalį. Šis, atrodytų, nedidelis darbo eigos pakeitimas sutraukia grįžtamąjį ryšį tarp kodo rašymo ir pakeitimų tikrinimo, o suspaustos grįžtamojo ryšio kilpos yra vienas patikimiausių programinės įrangos komandos veikimo prognozių.

Palyginimas vienas šalia kito: kodėl vizualinis išdėstymas keičia mūsų mąstymą

Kognityvinis mokslas lemia tai, kodėl daugumos peržiūros užduočių gretutinis kodų palyginimas pranoksta suvienodinto skirtumo rodinius. Kai pakeitimai rodomi eilėje vieningu formatu, žmogaus smegenys darbinėje atmintyje turi išlaikyti būseną „prieš“, o apdorodamos būseną „po“. Tai psichiškai brangu. Greta esantis išdėstymas perkelia tą palyginimą į vaizdinį apdorojimą – vieną iš efektyviausių mums prieinamų pažinimo kanalų – leidžia recenzentams greičiau pastebėti anomalijas, regresijas ir logikos klaidas ir mažiau pavargdami.

Kodo peržiūros veiksmingumo tyrimai nuolat rodo, kad tikrintojai pastebi daugiau defektų, kai gali nuskaityti horizontaliai per pakeistą funkciją, o ne skaityti iš viršaus į apačią naudodami įterpimo ir ištrynimo žymeklius. Sudėtingiems refraktoriams – kai 50 eilučių funkcija tampa trimis 20 eilučių funkcijomis arba kai kintamųjų pavadinimai sistemingai keičiasi modulyje – vienas šalia kito pateiktas painią netvarką paverčia įskaitomu ketinimų pasakojimu.

Poveikis verslui yra tiesioginis: geresnės kokybės kodo peržiūros reiškia, kad gamybą pasiekia mažiau klaidų. Remiantis IBM sistemų mokslų instituto duomenimis, peržiūros metu aptiktą klaidą ištaisyti kainuoja maždaug 6 kartus pigiau nei tą, kuri aptikta kokybės užtikrinime, ir maždaug 100 kartų mažiau nei aptikta gamyboje. Įrankiai, kurie daro apžvalgininkus veiksmingesnius, nėra kūrėjų prabanga – tai investicijos į defektų mažinimą su apskaičiuojama IG.

Terminalo renesansas ir tai, ką jis signalizuoja apie kūrėjų kultūrą

Per pastaruosius trejus metus kūrėjų įrankių nuostatos pasikeitė tyliai, bet reikšmingai. Po laikotarpio, kai dominavo žiniatinklio ir GUI įrankiai, kuriuos iš dalies lėmė debesų kūrimo platformų ir naršyklėmis pagrįstų IDE, sparčiai atgimė terminalo, klaviatūros valdomi įrankiai. Tai ne nostalgija. Tai optimizavimas.

Terminalui sukurti įrankiai paprastai yra:

• Greitesnis paleidimas ir naršymas – milisekundžių paleidimo laikas, palyginti su sekundėmis elektroninėmis programoms
• Daugiau komponuojamas – jie natūraliai įjungiami į kitus terminalo įrankius, scenarijus ir automatizavimo vamzdynus
• Mažiau išteklių reikalaujanti – labai svarbu nuotoliniuose serveriuose, konteineriuose ir debesų kūrimo aplinkose
• Daugiau pasiekiama ribotoje aplinkoje – SSH seansai, CI vamzdynai, mažo pralaidumo ryšiai
• Pagal numatytuosius nustatymus optimizuota klaviatūra – sumažinamas pelės ir klaviatūros jungiklis, kuris suskaido kūrėjo dėmesį

Inžinieriai, besikreipiantys į terminalo įrankius, dažnai yra produktyviausi savo komandų nariai – ne todėl, kad terminalo įrankiai iš esmės yra pranašesni, o todėl, kad jie pritraukia kūrėjus, kurie gerai apgalvojo darbo eigos optimizavimą. Kai įmonės įrankių kultūra rodo, kad efektyvumas vertinamas, ji linkusi pritraukti ir išlaikyti inžinierius, kurie dalijasi ta verte. Laikui bėgant tai sukuria sudėtingesnį pranašumą, kuris atsispindi funkcijų greičio ir kodo kokybės metrikoje.

"Geriausi kūrėjo įrankiai nepadidina darbo eigos – jie pašalina trintį. Siekiama ne suteikti kūrėjams daugiau galimybių, o suteikti jiems jau turimas galimybes be vargo."

Kaip kodo peržiūros kokybė tiesiogiai patenka į klientų rezultatus

Ypač „SaaS“ įmonėms ryšys tarp inžinerinių procesų kokybės ir klientų patirties yra artimesnis, nei dauguma vadovų įsivaizduoja. 2024 m. DORA (DevOps Research and Assessment) ataskaitoje nustatyta, kad elitinės programinės įrangos tiekimo komandos diegia 973 kartus dažniau nei prastai veikiančios, o pakeitimų nesėkmių dažnis yra 7 kartus mažesnis. Tai nėra abstrakti techninė metrika – jie tiesiogiai parodo veikimo laiką, funkcijų išleidimo dažnį ir greitį, kuriuo išsprendžiamos klientų praneštos problemos.

Daugelio komandų kliūtis yra ne kodo rašymas, o jo patvirtinimas. Ištraukite užklausas, kurios neperžiūrimos 24 ar 48 valandas, blokuoja kitus kūrėjus, sukuria sujungimo konfliktus ir atitolina klientų vertės pristatymą. Kiekvienas peržiūros įrankių patobulinimas, kuris pagreitina peržiūros ciklą ir padidina recenzento pasitikėjimą, virsta greitesniu suliejimu, dažnesniu leidimu ir greitesniu atsaku į klientų poreikius. Įmonei, kuri aptarnauja 138 000 vartotojų, naudojančių daugybę modulių, pvz., „Mewayz“, kur darbo užmokesčio apskaitos klaida arba CRM duomenų klaida turi tiesioginių realių pasekmių, kodo peržiūros proceso kokybė yra neatsiejama nuo klientų patirties kokybės.

Komandos, investuojančios į peržiūros įrankius kartu su verslo operacijų įrankiais – naudodamos tokias platformas kaip „Mewayz“ personalo darbo eigoms valdyti, projektų stebėjimui ir komandos veiklos duomenims – sukuria nuoseklų grįžtamojo ryšio ciklą. Kai modulio diegimas sukelia palaikymo bilietų šuolį, verslo OS užfiksuoja tą signalą; inžinierių komanda, turinti veiksmingų peržiūros įrankių, gali greitai nustatyti, pataisyti ir perskirstyti. Abi sistemos veikia kartu.

Kūrėjo įrankių grandinės politikos, kuri neužgožia savarankiškumo, kūrimas

Viena iš dažniausiai daromų klaidų, kurias daro augančios inžinerinės organizacijos, yra bandymas pernelyg agresyviai standartizuoti vieną įrankių rinkinį „dėl nuoseklumo“. Nors kai kurie standartai yra vertingi, ypač kalbant apie versijų valdymą, CI / CD ir diegimo konfigūraciją, įpareigojant konkrečias redaktoriaus konfigūracijas, terminalo nuostatas ar skirtingų peržiūros įrankius, paprastai atsitinka. Kūrėjai yra žinių darbuotojai, kurių produktyvumas yra glaudžiai susijęs su aplinkos komfortu. Priversti kūrėją, kuris galvoja apie terminalo sparčiuosius klavišus, kiekvieną dieną naudoti žiniatinklio kodo peržiūros sąsają, prilygsta kairiarankiui chirurgui liepti operuoti dešiniarankiu.

Sveikesnis požiūris yra apibrėžti rezultatus ir leisti komandoms savarankiškai pasirinkti įrankius, kurie juos pasiekia. Rezultatai, kuriuos verta standartizuoti, yra šie: peržiūros užbaigimas per 24 valandas, bent du patvirtinimai prieš sujungimą, joks gamybos diegimas nepraėjus CI ir dokumentuotas architektūrinių sprendimų pagrindimas. Tai, kaip kūrėjas iš tikrųjų skaito ir vertina skirtumus, kad atitiktų tuos standartus, daugiausia turėtų būti jų pasirinkimas.

Ši filosofija apima platesnį verslo įrankių paketą. „Mewayz“ modulinė architektūra atspindi tą patį principą – organizacijos gali aktyvuoti modulius, atitinkančius jų darbo eigą (logistikos įmonių parko valdymas, paslaugų įmonių rezervavimas, kūrėjams skirtos „link-in-bio“ priemonės), nepriversdamos prisijungti prie monolitinės sistemos, kuri primeta nereikalingą struktūrą. Geriausios verslo operacinės sistemos, kaip ir geriausios kūrėjų įrankių grandinės, turi savo nuomonę apie rezultatus, tačiau išlieka lanksčios įgyvendinant.

Svarbių dalykų įvertinimas: kūrėjų produktyvumas AI padedamo kodavimo amžiuje

Pokalbis apie kūrėjo produktyvumo vertinimą tapo niuansyvesnis ir tapo dar svarbesnis, nes dirbtinio intelekto kodavimo asistentai tampa pagrindiniais. Kai „GitHub Copilot“ per kelias sekundes gali sukurti 40 eilučių funkciją, kliūtis dar labiau pasislenka peržiūros ir patvirtinimo link. Kūrėjas, kuris rašo kodą dvigubai greičiau, bet peržiūri jį tokiu pačiu tempu, greitai sukurs peržiūrų atsilikimą, kuris visiškai paneigia greičio padidėjimą. Dėl to investicijos į peržiūros įrankius yra ne tik naudingos, bet ir būtinos organizacijoms, kurios naudojasi dirbtinio intelekto pagalba.

Prasminga šiuolaikinių inžinierių komandų našumo metrika turėtų apimti:

1. Vidutinis sujungimo laikas – nuo PR atviro iki sujungimo, kaip peržiūros efektyvumo tarpinis rodiklis
2. Peržiūros kruopštumo balas – komentarai vienam PR, palyginti su pakeitimo dydžiu, nurodant peržiūros gylį
3. Defektų rodiklis po sujungimo – sujungus aptiktos klaidos procentais nuo visų pakeitimų
4. Diegimo dažnis – kaip dažnai pakeitimai pasiekia gamybą, atspindintį dujotiekio būklę
5. Pakeitimų nesėkmių dažnis – įdiegimų, sukeliančių incidentus, procentas, atspindintis kokybišką vartų valdymą

Norint stebėti šią metriką, reikia įrankių, fiksuojančių duomenis proceso lygiu. Verslo operacijas valdančios platformos – žmogiškųjų išteklių sistemos, stebinčios komandos pajėgumą, projektų valdymo moduliai, stebintys sprinto greitį, analizės įrankiai, siejantys diegimo laiką su klientų pasitenkinimo balais – gali suteikti aplinką, dėl kurios inžinerinė metrika tampa prasminga. Defektų padidėjimas po sujungimo per ketvirtį, kai komandoje buvo per mažai darbuotojų, pasakoja apie kitokią istoriją nei tas pats padidėjimas visu pajėgumu, todėl norint tinkamai reaguoti į šį skirtumą, verslo duomenys turi būti pasiekiami kartu su inžineriniais duomenimis.

Sudėtinga grąža, kai rimtai žiūrima į kūrėjo įrankius

Įmonės, kurios kūrėjų įrankius laiko rimta verslo investicija, o ne eilutės elementu, kurį reikia sumažinti arba susirūpinimą visiškai pavesti atskiriems inžinieriams, nuolat lenkia savo kolegas tiek programinės įrangos kokybe, tiek komandos išlaikymu. Koreliacija nėra atsitiktinė. Kai kūrėjai mano, kad į jų produktyvumą organizaciniu lygmeniu žiūrima rimtai, šis signalas atsiliepia per samdymą, išlaikymą ir kasdienę motyvaciją tokiais būdais, kuriuos sunku kiekybiškai įvertinti, bet neįmanoma ignoruoti.

Galų skirtumo įrankis yra mažas dalykas. Tai gali būti keli šimtai kodo eilučių, savaitgalio projektas kvalifikuotam inžinieriui. Tačiau filosofija, kurią ji įkūnija – kad svarbi kasdienio kūrėjo darbo tekstūra, kad trintis turi kainą, kad tinkamas įrankis darbui dažniausiai yra tas, kuris atitinka kontekstą, kuriame darbas iš tikrųjų vyksta – yra filosofija, kuri, plačiai taikoma, sukuria inžinierių organizacijas, kurios pristato greičiau, mažiau laužo ir pritraukia geresnius žmones.

Modulinės operacijų platformos, pvz., „Mewayz“ pagrindu veikiančioms įmonėms yra lygiagreti pamoka. Tie patys principai, kuriais vadovaujantis yra geras skirtumų žiūrėtojas – kontekstinis, greitas, sukomponuojamas, sukurtas pagal tikrąsias, o ne idealizuotas darbo eigas – taip pat sukuria gerą verslo operacinę sistemą. Moduliai, atitinkantys komandos darbo būdą, duomenys, kurie pateikiami sprendimų priėmimo vietoje, ir infrastruktūra, kuri netrukdo, kai viskas veikia sklandžiai. Kasdien naudojami įrankiai niekada nėra tie, kurie turi daugiausiai funkcijų. Jie turi mažiausią trintį tarp ketinimo ir rezultato.

Dažniausiai užduodami klausimai

Kas yra Deff ir kaip jis pagerina kodo peržiūros procesą?

Deff yra terminalu pagrįstas įrankis, kuris pateikia Git skirtumus greta esančiu išdėstymu, todėl lengviau palyginti pakeitimus neperjungiant prie naršyklės sąsajos. Išlaikant tikrintojus terminale, sumažinamas konteksto perjungimas, pagreitėja grįžtamojo ryšio ciklai ir padedama komandoms anksčiau pastebėti problemas – kodo peržiūrą iš kliūties paverčia sklandia kūrimo darbo eigos dalimi.

Kodėl neefektyvios kūrėjų darbo eigos kenkia visam verslui, o ne tik inžinerijai?

Lėta kodo peržiūra atitolina leidimus, padidina klaidų pašalinimo dažnį ir eikvoja vyresniųjų inžinierių laiką – išlaidas, kurios atsiranda dėl praleistų terminų ir prastesnės produkto kokybės. Įmonės, kurios konsoliduoja operacijas tokiose platformose kaip „Mewayz“ (207 modulių verslo OS už 19 USD per mėnesį, pasiekiama adresu app.mewayz.com), supranta, kad kiekvienos komandos darbo eigos, įskaitant inžineriją, optimizavimas tiesiogiai apsaugo pajamas ir konkurencinį greitį.

Ar terminalais pagrįsti diferencijavimo įrankiai, pvz., Deff, gali tilpti į modernią, greitą komandų aplinką?

Visiškai. Terminalo įrankiai yra lengvi, juos galima rašyti ir natūraliai integruoti į CI vamzdynus ir esamas Git darbo eigas. Komandoms, kurios jau valdo projektus, užduotis ir bendravimą „viskas viename“ platformoje, pvz., „Mewayz“, adresu app.mewayz.com, susiejant tikslinį terminalų diferencijavimo įrankį su centralizuota verslo OS, sukuriamas mažas krūvas, kuriame tiek verslo, tiek inžinerinės operacijos išlieka efektyvios ir išmatuojamos.

Į ką komandos turėtų atkreipti dėmesį vertindamos įrankius, skirtus pagerinti savo kodo peržiūros įpročius?

Ieškokite įrankių, kurie sumažina trintį nereikalaujant kapitalinio darbo eigos remonto – greitas paleidimas, klaviatūra valdoma navigacija ir suderinamumas su esama Git sąranka yra pagrindiniai signalai. Tas pats principas galioja ir verslo įrankiams: tokios platformos kaip „Mewayz“ sujungia 207 modulius tik už 19 USD/mėn (app.mewayz.com), todėl komandos išvengia paslėptų išlaidų, susijusių su dešimčių atjungtų įrankių sujungimo inžinerijos ir veiklos srityse.