Opmerkingen en overzichtelijke sketches

Code wordt veel vaker gelezen dan geschreven. Opmerkingen zijn notities die je achterlaat, zodat je toekomstige zelf de sketch begrijpt. 📝

Typ twee schuine strepen en de rest van die regel is een opmerking. Het bord negeert die volledig bij het uitvoeren van je code.

Je kunt na echte code op dezelfde regel een opmerking plaatsen. Deze legt die specifieke stap uit zonder iets te verstoren. Handig voor snelle context.

Voor langere notities zet je tekst tussen slash-star en star-slash. Dit blok kan meerdere regels beslaan en is ideaal voor beschrijvingen.

Alles binnen een opmerking is onzichtbaar voor het bord. Het is er uitsluitend voor lezers en heeft dus nooit invloed op het gedrag van je apparaat.

Goede opmerkingen leggen uit waarom een regel bestaat, niet alleen wat deze doet. Noteer de reden, want de code laat de actie al zien.

Regels tussen accolades moeten enkele spaties inspringen. Deze inspringing laat zien wat bij elkaar hoort en maakt de logica gemakkelijk te overzien.

Een duidelijke naam is beter dan een opmerking. Als je een pin ledPin noemt in plaats van alleen een getal, weet de lezer precies wat deze bestuurt.

Schakel een regel tijdelijk uit door er schuine strepen voor te zetten. Met commentaar uitschakelen kun je testen zonder code te verwijderen die je misschien terug wilt.

Beschrijf niet elke regel. Een opmerking zoals dat je één bij x optelt, voegt rommel toe en geen waarde. Bewaar notities voor onderdelen die echt uitleg nodig hebben.

Een nette spatiëring, duidelijke namen en nuttige opmerkingen maken een sketch maanden later nog gemakkelijk aan te passen. Leesbare code is betrouwbare code.

Je hebt geleerd opmerkingen te gebruiken met // en slash-star, binnen accolades in te springen en dingen duidelijke namen te geven. Leesbare sketches blijven gemakkelijk te onderhouden. 🎉