‫دعنا نتحدث عن مطور أساسي آخر وهذا هو التعليق على الكود الخاص بك.
‫حتى الآن ، ربما رأيتني أعلق وأضيف تعليقات إلى نصوصنا.
‫على سبيل المثال ، هنا أضفت تعليقًا على Booleans وهذا يخبر مترجم Python ، مرحبًا ، هذا تعليق
‫، لا تقم بتشغيل هذا.
‫إنه فقط من أجلي.
‫يمكنك فقط تجاهله والتخطي إلى السطر الثاني.
‫ورأيت ذلك؟
‫لقد فعلت ذلك ببساطة في بايثون بعلامة الجنيه.
‫بمجرد أن ترى Python علامة الجنيه ، فإنها تضيف تعليقًا ويمكنك القيام بذلك بعد سطر أيضًا.
‫أستطيع أن أقول أن هذا يعين متغير.
‫وعلى الرغم من أن هذا قد يبدو وكأنه سطرين ، إلا أنه في الواقع مجرد موسيقى للجناح هي التي تحدث.
‫ويمكنك أن ترى أن المترجم الفوري يتجاهل هذه التعليقات تمامًا.
‫الآن ، يبدو التعليق بسيطًا جدًا ، ولكنه مفهوم مهم.
‫وإذا كنت تريد أن تكون مبرمجًا جيدًا بجميع اللغات ، فلدينا تعليقات.
‫لكن هناك طرق جيدة وطرق سيئة للتعليق.
‫وهذا شيء يأتي مع الممارسة.
‫ولكن فيما يلي بعض الإرشادات الرئيسية.
‫عندما تعلق على التعليمات البرمجية الخاصة بك ، فإن الفكرة هي أنك تضيف تعليقات قيمة.
‫أي ، إذا أضفت تعليقًا هنا يقول ، مرحبًا ، هذا متغير اسم إشارة ، قيمة سلسلة Andre
‫، تعليق مثل هذا.
‫ليس جيدًا حقًا.
‫لماذا هذا؟
‫حسنًا ، لأن الكود الخاص بك يجب أن يكون توضيحيًا ، أليس كذلك؟
‫الفكرة هي أن نكتب رمزًا يسهل قراءته وفهمه.
‫إنه لا يحاول أن يكون ذكيًا.
‫بدلا من ذلك ، يجب أن تقرأ مثل الإنجليزية.
‫وأي مبرمج بايثون سيعرف أننا هنا ببساطة نضيف Andre كقيمة للاسم.
‫نحن نسند متغيرًا ونضيف تعليقًا مثل هذا يكون واضحًا بذاته.
‫فقط يضيف فوضى إلى التعليمات البرمجية الخاصة بك.
‫لذلك هناك مقايضة هنا.
‫من الجيد التعليق على التعليمات البرمجية الخاصة بك ، دعنا نقول إذا كنت تعمل في فرق ويأتي مطورو آخرون ويريدون
‫فهم الكود الخاص بك.
‫لكن عليك أن تتذكر أن مبدأ الكود هذا يسهل قراءته.
‫المرة الوحيدة التي تريد فيها إضافة تعليقات إلى التعليمات البرمجية الخاصة بك.
‫حسنًا ، عندما يحدث شيء مهم حقًا ، وحيث قد يكون معقدًا بعض الشيء ، عليك أولاً
‫أن تقرر ، مرحبًا ، هل هذا الرمز مكتوب بطريقة منطقية؟
‫على سبيل المثال ، إذا كان هذا متغيرًا.
‫وكان هذا متغير ب.
‫حسنًا ، قد يكون من الصعب حقًا على شخص ما فهمه.
‫لذلك يمكنك القول أن هذا هو العلم.
‫ولكن قبل إضافة هذا التعليق ، تريد أن تقول لنفسك ، حسنًا ، ربما يصعب قراءة الكود الخاص بي.
‫ربما ينبغي علي فقط تغيير المتغير إلى رائع لجعله أكثر قابلية للفهم.
‫الآن هذا شيء تقوم بتحسينه أكثر فأكثر ، وتريد استخدام التعليقات كأداة إضافية لجعل
‫شفرتك مفهومة.
‫ربما تكتب رمزًا بعد ستة أشهر من الآن تريد العودة لفهم ما فعلته.
‫لكن تذكر أن المزيد من التعليقات لا يعني بالضرورة رمزًا أفضل.
‫أنت تريد أن تكون موجزًا وأن تبقي الأمور بسيطة أثناء إضافة التعليقات فقط عند الضرورة لمساعدة الآخرين على فهم الكود
‫الخاص بك ، وليس محاولة جعل الكود غير المقروء أكثر قابلية للقراءة.
‫سوف نستكشف هذا الموضوع ونقدم لك النصائح حوله طوال الدورة.
‫لكن تذكر أن هذا المطور الرئيسي أساسي لأنك ستحتاج إليه طوال حياتك المهنية.
‫بالمناسبة ، تحتوي هذه المقالة هنا على بعض النقاط المهمة حقًا التي أعتقد أنك ستستفيد منها حقًا
‫، لا سيما في أفضل ممارسات التعليق.
‫يمكنك قراءة بعض ما يجب فعله وما لا يفعله وما يفعله بعض كبار المبرمجين عند التعليق.
‫أعلم أنه يبدو سخيفًا ، لكنه مفهوم مهم تتجاهله معظم الدورات التدريبية ، لذلك أوصي
‫بشدة بقراءة هذا.
‫سأربطها في الموارد وسأراكم في الفيديو التالي.