اسم واضح للكود = صفحات أقل من التعليقات

التسمية الجيدة اختصار لصفحات من التعليقات

كم مرة فتحت كود ووجدت أسماء مثل:

let x;
function doStuff() {}

وبقيت تحاول فهم ما الذي يفعله هذا الكود حقًا؟

بينما اسم واضح مثل:

function validateUserPayment() {}

يختصر الفكرة كاملة دون حاجة لشرح.

التسمية الجيدة ليست تفصيلًا شكليًا، بل هي لغة تواصل بينك وبين كل من سيقرأ الكود بعدك، وحتى بينك وبين نفسك عندما تعود إليه بعد فترة.

الاسم الواضح لمتغير أو دالة يوفر وقتًا وجهدًا أكثر من صفحات من التعليقات.

اكتب الكود ليفهمه غيرك، ولتفهمه أنت عندما تعود إليه لاحقًا.