الأسماء الواضحة توثيق يعيش مع الكود

الكود وسيلة تواصل بين المطورين قبل أن يكون أوامر للحاسوب. التعبير totalAmount = price × quantity يكشف القصد، بينما تجبر أسماء مثل x وa وb القارئ على البحث في السياق لمعرفة الشيء نفسه.

سمِّ الدالة بحسب النتيجة التي تحققها، مثل generateInvoicePdf بدل generateFile، وsendOrderConfirmationEmail بدل processOrderEmail. استخدم الجمع للمجموعات والمفرد للعنصر، واجعل أسماء القيم المنطقية أسئلة طبيعية تبدأ مثلًا بـ is أو has أو can أو should.

تجنب الاختصارات غير المتفق عليها والأسماء العامة مثل data وinfo وprocess. التعليقات تشرح السبب أو القيد الذي لا يظهر من الكود، لا تعيد وصف ما تقوله الأسماء. اختيار الاسم يحتاج وقتًا قصيرًا، لكنه يتكرر نفعه في كل قراءة ومراجعة وتعديل لاحق.