Няколко правила за да направите вашата програма в LEGO Mindstorms EV3 по-красива. Pro Preview

1. Всички имена в програмата ви трябва да обясняват това за което се отнасят!

   Още като се започне от името на програмата ви и дори проекта ви, чак до най-малката променлива всичко трябва да има "говорещо" име. Под "говорещо" се има предвид да може някой, който не знае какво прави определена част, веднага да се досети като прочете името. Примерно ако направите програма, която да кара робота да прави квадрат, няма да я кръстите Генчо! По-"говорещо" име би било "kvadrat" или "square". Или променлива, която запазва колко живот има един играч в игра можем да я кръстим "jivot" или "Hitpoints". Ако обаче има двама или повече играча в нашата игра, често хората правят грешката да кръстят живота, така че да не се разбира за кого се отнася: "jivot1", "jivot2"... По-правилно в този случай би било нещо, което казва "животът на играч 1" - "Player1_Hitpoints". Долната черта често се използва при наименуване в програмирането, тъй като разстоянието се използва за започване на нещо ново и често не може да се слага в име. В такива случаи могат да се използват и съкращения, но трябва да сте сигурни, че всички които ги четат ще ги разберат, например "P1_HP".

2. Нищо не трябва да се повтаря повече от веднъж!

   По-рано ви разказвахме за DRY принципа - Do not Repeat Yourself! Ако видите, че някаква част от програмата се повтаря, веднага я слагате в цикъл или си правите собствено блокче или и двете! Това помага за скъсяване на програмата и също за разбиването ѝ на части, което помага за по-лесно четене.

3. Разделете програмата на части (модули)!

   Това е изключително важна част от правенето на красива програма, толкова важна, че имаме отделен туториал само за това тук. Целта на това правило е всяка част от програмата да прави точно определено нещо. Изпълнено добре, това ще ви помогне с изпълнението на първото правило. Ако програмата ви работи, има малко значение как разделяте отделните сегменти, може да сложите само малко растояние между тях, може да ги направите на собствени блокчета. В зависимост от програмата, може дори да ги поставите в различни нишки! Важното е ако имаме цъкъл, който кара робота да прави квадрат и също да показва картинка, можем да сложим картинката извън цикъла или дори в друг цикъл.

4. Използвайте коментари за да обясните неща които не са очевидни!

   Коментарите са инструмент, който много от нас не знаят, че съществува или просто не използват. Въпреки това те са черешката на тортата ако искате кодът ви да се разбира от други хора и дори да се харесва! Коментарите са много полезни за места, които не могат да се наименуват, като суичове или математически операции. Те се използват за да обяснят определени операции, които не са особено очевидни. Например имате робот, който трябва да измери дължината, ширината и височината на една стая и да върне обема. Може да обясните каква е формулата или за какво ви трябва, ако не се записва в променлива, трябва да обясните че резултата е обема на стаята.

Правенето на четлива и лесна за разбиране програма е нещо, което доста хора забравят докато правят сложни програми, които правят готини неща. Проблемът е, че ако имат нужда от помощ по сложна програма, която изглежда така:

то никой няма да се наеме да им помогне. Затова е важно вашата програма да бъде красива и удобна за четене!