Використання блоків коментарів

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] ▶

Після підключення робота до VEXcode виберіть Пуск, щоб запустити проєкт. Робот рухатиметься вперед, зупинятиметься та відходитиме назад, коли зіткнеться з чимось.