Contextual commits – Dzidzenu si le ʋuʋu ɖi na nusitae léle le Git ŋutinya me

Nu ‘Nuka’ godo: Kuxi si le Ðokuitsɔtsɔna Siwo Bɔbɔe Ŋu

Dɔwɔla ɖesiaɖe nya kɔnua nyuie: `git add`, `git commit -m "ɖɔ: kpɔ null pointer exception gbɔ"`. Míeŋlɔa *nu* la ɖi tsitotsito. Míeɖɔ vodada aɖe ɖo, míetsɔ nɔnɔme aɖe kpee, alo míewɔ asitɔtrɔ le nusi dzi míanɔ te ɖo ŋu. Dɔwɔnuwo abe Conventional Commits ene he ɖoɖo xɔasi aɖe vɛ na míaƒe commit gbedasiwo, si wɔe be woateŋu axlẽ wo le mɔ̃ me hena tɔtrɔwo wɔwɔ kple tɔtrɔ ƒe mɔ̃ɖaŋununya ƒe afɔɖoƒe gɔmesese. Gake nyabiasea ƒe akpa vevi aɖe buna ɣesiaɣi: *nukatae*. Nukatae woto null pointer exception sia vɛ le gɔmedzedzea me? Nukatae míetiae be míagbugbɔ awɔ module sia koŋ fifia? Nukatae wotrɔ API ƒe nuwuƒe? Commit gbedasi la gblɔa nuwɔna la na mí, gake nya siwo ƒo xlãe—susu si tae, asitsatsa ƒe hiahiã, kadodo si le afɔɖeɖe si keke ta wu gbɔ—bu zi geɖe le Slack ka, Jira tikitiwo, alo ŋkuɖodzinu si le vɔvɔm me.

Nyatakakawo ƒe Ðokuisiwo dodo ɖe ŋgɔ: Dzidzenu si Woʋu na 'Nusita'

Contextual Commits do susua ɖa be woawɔ dzidzenu si le ʋuʋu ɖi be woatsɔ akpɔ kuxi sia tututu gbɔ. Wonye takpekpe siwo li fifia ƒe kekeɖenudɔwɔwɔ, abe Conventional Commits ene, si wowɔ be woatsɔ tɔtrɔ aɖe ƒe nya siwo ƒo xlãe ade Git ƒe ŋutinya ŋutɔ me tẽ. Susu vevitɔa le bɔbɔe gake ŋusẽ le eŋu: tsɔ `Context` ƒe afɔti si woɖo ɖe ɖoɖo nu kpe ɖe wò commit gbedasi ŋu si fia asi nyateƒetsoƒe na tɔtrɔa ƒe susu. Esia menye dɔa dzikpɔkpɔdɔwɔnuwo ɖɔliɖɔli o; eƒo nu tso tɔdzisasrã si anɔ anyi ɖaa, si woateŋu akpɔ le wò kɔda kple numedzodzro siwo trɔ asi le eŋu dome.

ƒe nyawo
• Dɔwɔɖoɖo si woɖo ɖe ɖoɖo nu: Contextual Commit zãa afɔti fli, abe `Context: `, afisi `` ateŋu anye `issue`, `rfc` (Nyaŋuɖoɖo ƒe biabia), `numedzodzro`, `nudzɔdzɔ`, kple bubuawo, eye `` nye ID tɔxɛ tso ɖoɖo si do ƒome kplii gbɔ (e.g., tikiti ƒe xexlẽdzesi, a nyamedzroƒe ƒe nyatakaka ID).
• Machine-Readable: Nɔnɔme si woɖo ɖe ɖoɖo nu la ɖea mɔ na dɔwɔnuwo be woaɖe nya siwo ƒo xlãe me eye woawɔ kadodo gãwo le wo ɖokui si alo axɔ nyatakaka siwo do ƒome kplii, si ana dɔwɔla ƒe nuteƒekpɔkpɔ nanyo ɖe edzi tẽ le Git nuŋlɔɖi me.
• Dɔwɔnu-Agnostic: Wotrɔ asi le dzidzenua ŋu be wòawɔ dɔ kple ɖoɖo ɖesiaɖe—Jira, Linear, GitHub Issues, Slack, Mewayz module, alo wiki ememetɔ. `ƒomevi` ɖe ɖoɖo si ŋu wole nu ƒom tsoe la gɔme.
• Edzraa Ŋutinya ɖo: To vovo na gotagome kadodo siwo ateŋu agbã la, woɖaa nɔnɔme sia ɖe nudzraɖoƒea ƒe ŋutinya si metrɔna o me, si kpɔa egbɔ be "nukata" gakpɔtɔ nye nusi woateŋu akpɔ le kɔdaƒea ƒe agbenɔɣi katã.

Viɖe Siwo Woate Ŋu Akpɔ na Ŋgɔyiyi Ƒuƒoƒowo

Adopting Contextual Commits naa viɖe enumake kple ɣeyiɣi didi. Le ƒuƒoƒoa me tɔ yeye siwo le dɔ aɖe wɔm gome la, Git ƒe nuŋlɔɖi xexlẽ va zua hehenana mɔzɔzɔ. Le esi teƒe be woakpɔ "refactor(auth): simplify token validation" ko la, wokpɔa commit kple `Context: rfc #45`, si do ƒome tẽ kple design document si le nya hem le mɔnu vovovoawo ŋu. Esia nana woƒe gɔmesese le dɔa ƒe xɔtuɖaŋu kple nyametsotsowɔwɔ ƒe ɖoɖowo ŋu kabakaba ŋutɔ.

Le vodadawo ɖɔɖɔɖo alo nudzɔdzɔ ƒe amekuku megbe la, dɔwɔlawo ateŋu akpɔ tɔtrɔ si me kuxi le la menye ɖe kɔda ƒe vovototo ɖeɖeko dzi o, ke boŋ ɖe vodada ŋuti nyatakaka gbãtɔ alo nudzɔdzɔ ŋuti nuŋlɔɖi (`Nɔnɔme: nudzɔdzɔ #2024-001`). Esia na gɔmesese vevi aɖe le nenye be ɖɔɖɔɖoa ku ɖe nusi gbɔ wòtso ŋu loo alo nusi wotsɔ ɖɔe ɖo koe wònye. Le ƒuƒoƒo siwo zãa modular ɖoɖo abe Mewayz ene gome la, alesi tɔtrɔ le asitsatsa ƒe module ɖeka me do ƒome kple nɔnɔme biabia le bubu me gɔmesese va zua nu maɖinu, elabena nya siwo ƒo xlãe ƒe afɔti la wɔa nusiwo dzi woanɔ te ɖo ƒe nɔnɔmetata si me kɔ le asitsaha ƒe OS bliboa me.

"Míedze Contextual Commits zazã gɔme ɣleti ade enye sia, eye wòtrɔ alesi míewɔa nu kple míaƒe codebase vevie. Git log meganye tɔtrɔwo ƒe xexlẽdzesi fafɛ o; enye ŋutinya. Etsɔa míaƒe code doa ka kple míaƒe dzeɖoɖowo, si na tameɖoɖo si le fli ɖesiaɖe megbe la me kɔ nyuie na amesiame si le ƒuƒoƒoa me." - Mɔ̃ɖaŋudɔwɔla Gãtɔ le fintech gɔmedzedze aɖe me.

Dzedze kple Nya siwo ƒo xlãe ƒe Ðokuisi

Contextual Commits tsɔtsɔ de wò dɔwɔwɔ me le bɔbɔe. Edzea egɔme kple ƒuƒoƒo ƒe nubabla le takpekpea ŋu. Àteŋu aɖe nya siwo ƒo xlãe ƒomevi siwo sɔ na wò dɔwɔnuwo ƒe hatsotso aɖe gɔme (e.g., `nya`, `slack`, `meewayz-module`). Afɔɖeɖe si kplɔe ɖo enye be nàwɔ wò commit message template yeyee be nàɖo ŋku edzi na dɔwɔlawo be woade `Context:` footer la eme. Team geɖewo zi esia dzi to git hooks alo CI checks dzi be woakpɔ egbɔ be ewɔ ɖeka. Taɖodzinua menye blibodede o ke boŋ ŋgɔyiyi—adze "nukata" léle ɖe asi le mɔ si woɖo ɖe ɖoɖo nu nu, nenye be tɔtrɔ ɖedzesiwo koe tae gɔ̃ hã. Le ɣeyiɣi aɖe megbe la, nuwɔna sia tua sidzedze sẽŋu si woateŋu adi la ɖo tẽ le wò tɔtrɔwo dzikpɔkpɔ ƒe ɖoɖoa me, si trɔa wò Git ŋutinya wòzua wò dɔa ƒe tɔtrɔ ŋutinya si me kɔ.

Nyabiase Siwo Wobiana Enuenu

Nu ‘Nuka’ godo: Kuxi si le Ðokuitsɔtsɔna Kɔkɔewo Ŋu

Dɔwɔla ɖesiaɖe nya kɔnua nyuie: `git add`, `git commit -m "ɖɔ: kpɔ null pointer exception gbɔ"`. Míeŋlɔa *nu* la ɖi tsitotsito. Míeɖɔ vodada aɖe ɖo, míetsɔ nɔnɔme aɖe kpee, alo míewɔ asitɔtrɔ le nusi dzi míanɔ te ɖo ŋu. Dɔwɔnuwo abe Conventional Commits ene he ɖoɖo xɔasi aɖe vɛ na míaƒe commit gbedasiwo, si wɔe be woateŋu axlẽ wo le mɔ̃ me hena tɔtrɔwo wɔwɔ kple tɔtrɔ ƒe mɔ̃ɖaŋununya ƒe afɔɖoƒe gɔmesese. Gake nyabiasea ƒe akpa vevi aɖe buna ɣesiaɣi: *nukatae*. Nukatae woto null pointer exception sia vɛ le gɔmedzedzea me? Nukatae míetiae be míagbugbɔ awɔ module sia koŋ fifia? Nukatae wotrɔ API ƒe nuwuƒe? Commit gbedasi la gblɔa nuwɔna la na mí, gake nya siwo ƒo xlãe—susu si tae, asitsatsa ƒe hiahiã, kadodo si le afɔɖeɖe si keke ta wu gbɔ—bu zi geɖe le Slack ka, Jira tikitiwo, alo ŋkuɖodzinu si le vɔvɔm me.

Contextual Commits dodo ɖe ŋgɔ: Dzidzenu si le ʋuʋu ɖi na 'Nusita'

Contextual Commits do susua ɖa be woawɔ dzidzenu si le ʋuʋu ɖi be woatsɔ akpɔ kuxi sia tututu gbɔ. Wonye takpekpe siwo li fifia ƒe kekeɖenudɔwɔwɔ, abe Conventional Commits ene, si wowɔ be woatsɔ tɔtrɔ aɖe ƒe nya siwo ƒo xlãe ade Git ƒe ŋutinya ŋutɔ me tẽ. Susu vevitɔa le bɔbɔe gake ŋusẽ le eŋu: tsɔ `Context` ƒe afɔti si woɖo ɖe ɖoɖo nu kpe ɖe wò commit gbedasi ŋu si fia asi nyateƒetsoƒe na tɔtrɔa ƒe susu. Esia menye dɔa dzikpɔkpɔdɔwɔnuwo ɖɔliɖɔli o; eƒo nu tso tɔdzisasrã si anɔ anyi ɖaa, si woateŋu akpɔ le wò kɔda kple numedzodzro siwo trɔ asi le eŋu dome.

Viɖe Siwo Woate Ŋu Akpɔ na Ŋgɔyiyi Ƒuƒoƒowo

Adopting Contextual Commits naa viɖe enumake kple ɣeyiɣi didi. Le ƒuƒoƒoa me tɔ yeye siwo le dɔ aɖe wɔm gome la, Git ƒe nuŋlɔɖi xexlẽ va zua hehenana mɔzɔzɔ. Le esi teƒe be woakpɔ "refactor(auth): simplify token validation" ko la, wokpɔa commit kple `Context: rfc #45`, si do ƒome tẽ kple design document si le nya hem le mɔnu vovovoawo ŋu. Esia nana woƒe gɔmesese le dɔa ƒe xɔtuɖaŋu kple nyametsotsowɔwɔ ƒe ɖoɖowo ŋu kabakaba ŋutɔ.

Dzedze kple Nya siwo ƒo xlãe ƒe Ðokuisi

Contextual Commits tsɔtsɔ de wò dɔwɔwɔ me le bɔbɔe. Edzea egɔme kple ƒuƒoƒo ƒe nubabla le takpekpea ŋu. Àteŋu aɖe nya siwo ƒo xlãe ƒomevi siwo sɔ na wò dɔwɔnuwo ƒe hatsotso aɖe gɔme (e.g., `nya`, `slack`, `meewayz-module`). Afɔɖeɖe si kplɔe ɖo enye be nàwɔ wò commit message template yeyee be nàɖo ŋku edzi na dɔwɔlawo be woade `Context:` footer la eme. Team geɖewo zi esia dzi to git hooks alo CI checks dzi be woakpɔ egbɔ be ewɔ ɖeka. Taɖodzinua menye blibodede o ke boŋ ŋgɔyiyi—adze "nukata" léle ɖe asi le mɔ si woɖo ɖe ɖoɖo nu nu, nenye be tɔtrɔ ɖedzesiwo koe tae gɔ̃ hã. Le ɣeyiɣi aɖe megbe la, nuwɔna sia tua sidzedze sẽŋu si woateŋu adi la ɖo tẽ le wò tɔtrɔwo dzikpɔkpɔ ƒe ɖoɖoa me, si trɔa wò Git ŋutinya wòzua wò dɔa ƒe tɔtrɔ ŋutinya si me kɔ.