Uso de bloques de comentarios#
Este tutorial explica cómo usar los bloques de comentarios en VEXcode GO. Al finalizar, sabrás por qué y cómo usar los comentarios para documentar un proyecto.
Los bloques de Comentarios te permiten añadir notas directamente a tu pila de bloques, que se encuentran en la categoría Lógica - Comentarios de la caja de herramientas. No afectan al funcionamiento de tu proyecto; su única función es ayudarte a ti y a los demás a comprenderlo.
cuando empezó :: hat events
[comment]
Los programadores usan comentarios para organizar su código y facilitar su lectura y comprensión, tanto para ellos mismos que retoman un proyecto más adelante como para otros que trabajan en él. El nombre de un solo bloque solo describe ese bloque, pero un comentario puede describir el comportamiento de toda una sección de bloques a la vez; así, se puede entender de un vistazo qué hace un conjunto de bloques, sin tener que leer cada uno individualmente.
Por ejemplo, este proyecto avanza hasta que choca con algo y luego retrocede. Tal como está escrito, para entenderlo es necesario leer cada bloque.
cuando empezó :: hat events
unidad [adelante v]
esperar hasta <[bumper v] pressed? :: custom-led :: custom-led>
deja de conducir
unidad [atrás v] para (100) [mm v] ▶
Agregar un comentario encima de cada sección describe su funcionamiento, lo que facilita la comprensión del proyecto a simple vista.
cuando empezó :: hat events
[Drive forward until something is in the way.]
unidad [adelante v]
esperar hasta <[bumper v] pressed? :: custom-led :: custom-led>
[Back away from the object.]
deja de conducir
unidad [atrás v] para (100) [mm v] ▶
Después de conectar el robot a VEXcode (connecting-to-your-robot.md), seleccione Iniciar para ejecutar el proyecto. El robot avanzará, se detendrá y retrocederá al chocar con algo.
