Uso de bloques de comentarios#
Este tutorial cubre cómo usar los bloques de comentarios en VEXcode GO. Al final, 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 inicie :: hat events
[comment]
Los programadores usan comentarios para organizar su código y facilitar su lectura y comprensión, tanto para ellos mismos que regresan a un proyecto más tarde 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, para que puedas entender lo que hace una pila de bloques de un vistazo, sin leer cada bloque individual.
Por ejemplo, este proyecto avanza hasta que choca con algo y luego retrocede. Como está escrito, la comprensión requiere leer cada bloque.
cuando inicie :: hat events
conducir [adelante v]
esperar hasta <¿[bumper v] presionado? :: custom-led>
detener conducción
conducir [reversa v] por (100) [mm v] ▶
Agregar un comentario encima de cada sección describe su comportamiento, lo que hace que el proyecto sea más fácil de entender de un vistazo.
cuando inicie :: hat events
[Drive forward until something is in the way.]
conducir [adelante v]
esperar hasta <¿[bumper v] presionado? :: custom-led>
[Back away from the object.]
detener conducción
conducir [reversa v] por (100) [mm v] ▶
Después de conectar tu robot a VEXcode, selecciona Iniciar para ejecutar el proyecto. El robot avanzará, se detendrá y retrocederá una vez que se tropiece con algo.
