paint-brush
Msimbo Harufu 285 - Jinsi ya Kurekebisha Kazi Zisizo za Lazimakwa@mcsee
290 usomaji

Msimbo Harufu 285 - Jinsi ya Kurekebisha Kazi Zisizo za Lazima

kwa Maximiliano Contieri
Maximiliano Contieri HackerNoon profile picture

Maximiliano Contieri

@mcsee

I’m a sr software engineer specialized in Clean Code, Design...

3 min read2025/01/11
Read on Terminal Reader
Read this story in a terminal
Print this story
tldt arrow
sw-flagSW
Soma hadithi hii kwa kiswahili!
en-flagEN
Read this story in the original language, English!
bn-flagBN
এই গল্পটি বাংলায় পড়ুন!
es-flagES
Lee esta historia en Español!
ja-flagJA
この物語を日本語で読んでください!
sr-flagSR
Прочитајте ову причу на српском!
ka-flagKA
წაიკითხეთ ეს ამბავი ქართულად!
kk-flagKK
Бұл оқиғаны қазақша оқыңыз!
sq-flagSQ
Lexojeni këtë histori në shqip!
hu-flagHU
Olvasd el ezt a történetet magyarul!
ms-flagMS
Baca cerita ini dalam bahasa Melayu!
af-flagAF
Lees hierdie storie in Afrikaans!
th-flagTH
อ่านเรื่องนี้เป็นภาษาไทย!
SW

Ndefu sana; Kusoma

Kazi zilizo na majina yasiyoeleweka huficha dhamira na kuwachanganya wasomaji. Tumia majina ya maelezo, yenye mwelekeo wa vitendo.
featured image - Msimbo Harufu 285 - Jinsi ya Kurekebisha Kazi Zisizo za Lazima
Maximiliano Contieri HackerNoon profile picture
Maximiliano Contieri

Maximiliano Contieri

@mcsee

I’m a sr software engineer specialized in Clean Code, Design and TDD Book "Clean Code Cookbook" 500+ articles written

0-item

STORY’S CREDIBILITY

Original Reporting

Original Reporting

This story contains new, firsthand information uncovered by the writer.

Kuwa Muhimu!!

TL;DR: Kazi zilizo na majina yasiyoeleweka huficha dhamira na kuwachanganya wasomaji. Tumia majina ya maelezo, yenye mwelekeo wa vitendo.

Matatizo

  • Kusudi la utendakazi lisilo wazi
  • Kuongezeka kwa mzigo wa utambuzi
  • Muktadha unaopotosha
  • Kupungua kwa usomaji
  • Ushirikiano mgumu
  • Utendaji uliofichwa

Ufumbuzi

  1. Tumia vitenzi vyenye mwelekeo wa vitendo
  2. Fafanua majina
  3. Onyesha madhumuni ya chaguo za kukokotoa
  4. Epuka masharti ya jumla
  5. Toa muktadha wa maana
  6. Eleza wajibu mmoja kwa uwazi
  7. Linganisha hatua na matokeo

Refactorings

https://hackernoon.com/improving-the-code-one-line-at-a-time

Muktadha

Kazi zilizotajwa kwa maneno ya jumla huwalazimisha wasomaji kuzama katika utekelezaji ili kuelewa tabia zao.


Hii inapoteza muda na huongeza uwezekano wa makosa.


Kutaja kunakuwa muhimu zaidi wakati wa kufanya kazi na vitendaji vya pekee, ambapo jina la darasa halitoi muktadha wa ziada.


Suala hili linahusiana moja kwa moja na kanuni ya Mwambie, Usiulize .


Badala ya kufichua tabia zisizoeleweka ambazo humlazimu mpigaji kukisia utendakazi, majina shuruti huwasilisha kitendo halisi, kikimwongoza msomaji bila kuhitaji kukagua msimbo.


Unapotaja kazi kwa maelezo, unaondoa ubashiri usio wa lazima na upatanishe na kanuni hii.

Sampuli ya Kanuni

Si sahihi

 public String dateFormatting(Date date) { return new SimpleDateFormat("yyyy-MM-dd").format(date); } public void load() { System.out.println("Loading..."); }

Sawa

 public String formatDate(Date date) { return new SimpleDateFormat("yyyy-MM-dd").format(date); } public void loadUserPreferences() { System.out.println("Loading user preferences..."); }

Ugunduzi

  • [x] Mwongozo

Unaweza kugundua harufu hii kwa kukagua majina ya utendakazi yanayotumia maneno yasiyoeleweka kama vile do , run , process , load , n.k.


Linter otomatiki zinaweza kualamisha ruwaza hizi au kuangazia vitendaji vilivyo na majina ya jumla kupita kiasi.

Lebo

  • Kutaja

Kiwango

  • [x] Mwanzilishi

Kwa Nini Upinzani Ni Muhimu

Majina ya kazi yanapaswa kuunda mawasiliano ya moja kwa moja kati ya jina na utendakazi wao.


Kuvunja Bijection hii hulazimisha wasanidi programu kuchunguza maelezo ya msimbo kwa muktadha, kupunguza kasi ya utatuzi, ukaguzi na viendelezi.

Kizazi cha AI

Zana za AI wakati mwingine hutoa majina ya kazi ya jumla bila kuelewa kikoa chako.


Unapotumia AI, taja kwamba majina ya chaguo za kukokotoa lazima yawe ya maelezo na yenye mwelekeo wa vitendo.

Utambuzi wa AI

Miundo ya AI inaweza kusaidia kugundua majina yenye utata kwa kulinganisha saini za kazi na mbinu bora za kutaja zilizoainishwa awali.


Kuchanganya AI na ukaguzi wa msimbo wa mwongozo hutoa matokeo bora.

Jaribu Them!

Kumbuka: Wasaidizi wa AI hufanya makosa mengi

Bila Maelekezo Sahihi

Pamoja na Maagizo Maalum

GumzoGPT

GumzoGPT

Claude

Claude

Kuchanganyikiwa

Kuchanganyikiwa

Copilot

Copilot

Gemini

Gemini

Hitimisho

Majina ya kazi sio tu lebo; ni mikataba na msomaji.


Majina yenye utata yanavunja mkataba huu na kusababisha mkanganyiko.


Majina yenye maelezo, yanayolenga vitendo hurahisisha mawasiliano na kurahisisha msimbo wako kudumisha na kupanua.

Mahusiano


article preview
HACKERNOON

How to Find The Stinky Parts of Your Code (Part VII) | HackerNoon

We see several symptoms and situations that make us doubt the quality of our development.


article preview
HACKERNOON

How to Find the Stinky Parts of Your Code [Part XXXI] | HackerNoon

Beginners are afraid to remove code. And many seniors too.


article preview
HACKERNOON

How to Find The Stinky Parts of Your Code (Part VIII) | HackerNoon

Yet more code smells? Plenty of!


article preview
HACKERNOON

How to Find the Stinky Parts of Your Code [Part XXXV] | HackerNoon

Most of these smells are just hints of something that might be wrong. Therefore, they are not required to be fixed per se… (You should look into it, though.)

Tazama pia


article preview
HACKERNOON

What Exactly Is A Name: The Quest [Part I] | HackerNoon

We all agree: a good name is always the most important thing. Let’s find them.


article preview
HACKERNOON

What Exactly Is A Name: Rehab [Part II] | HackerNoon

We all agree: a good name is always the most important thing. Let’s find them.

Kanusho

Code Harufu ni maoni yangu.

Mikopo

Picha na britihlibrary kwenye Unsplash


Jina la utendaji linapaswa kuwa kitenzi au kishazi cha kitenzi, na linahitaji kuwa na maana

Robert C. Martin


article preview
HACKERNOON

400+ Thought-Provoking Software Engineering Quotes | HackerNoon

The most complete curated collection of software and programming quotes


Nakala hii ni sehemu ya Msururu wa CodeSmell.


article preview
HACKERNOON

How to Find the Stinky Parts of Your Code (Part I) | HackerNoon

The code smells bad. Let’s see how to change the aromas. In this series, we will see several symptoms and situations that make us doubt the quality of our developments. We will present possible solutions. Most of these smells are just hints of something that might be wrong. They are not rigid rules.


L O A D I N G
. . . comments & more!

About Author

Maximiliano Contieri HackerNoon profile picture
Maximiliano Contieri@mcsee
I’m a sr software engineer specialized in Clean Code, Design and TDD Book "Clean Code Cookbook" 500+ articles written

HANG TAGS

MAKALA HII ILIWASILISHWA NDANI...

Read on Terminal Reader
Read this story in a terminal
 Terminal
Read this story w/o Javascript
Read this story w/o Javascript
 Lite
X REMOVE AD