استخدام كتل التعليقات#

Using Comment Blocks

يشرح هذا الدرس كيفية استخدام كتل التعليقات في VEXcode GO. بنهاية الدرس، ستعرف لماذا وكيف تستخدم التعليقات لتوثيق مشروعك.

تتيح لك مربعات التعليقات إضافة ملاحظات مباشرةً إلى مجموعة المربعات الخاصة بك، والتي تجدها في فئة المنطق - التعليقات في صندوق الأدوات. وهي لا تؤثر على كيفية عمل مشروعك، بل هي موجودة فقط لمساعدتك أنت والآخرين على فهمه.

كتلة التعليقات الافتراضية، أدناه عند بدء التشغيل.#
عند البدء :: hat events
[comment]

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

على سبيل المثال، يتقدم هذا المشروع حتى يصطدم بشيء ما، ثم يتراجع. وبصياغة هذا النص، يتطلب فهمه قراءة كل فقرة على حدة.

مشروع يستمر حتى يصطدم بشيء ما، ثم يتراجع.#
عند البدء :: hat events
تشغيل [للأمام v]
انتظر حتى <[bumper v] مضغوط؟ :: custom-led>
إيقاف القيادة
تشغيل [للخلف v] لمسافة (100) [مم v] ▶

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

نفس المشروع، مع تعليقات تصف سلوك كل قسم.#
عند البدء :: hat events
[Drive forward until something is in the way.]
تشغيل [للأمام v]
انتظر حتى <[bumper v] مضغوط؟ :: custom-led>
[Back away from the object.]
إيقاف القيادة
تشغيل [للخلف v] لمسافة (100) [مم v] ▶

After connecting your robot to VEXcode, select Start to run the project. The robot will drive forward, stop and back away once it bumps into something.

لقطة شاشة لشريط أدوات VEXcode GO، مع تمييز زر البدء.