Inleiding
Om verschillende redenen moet je eigenlijk commentaar toevoegen aan je PHP scripts. Het is niet alleen voor iemand anders die misschien in je code kijkt, maar je hebt er zelf ook veel aan. Weet jij bijvoorbeeld nog wat een functie die je een paar jaar geleden hebt gescript doet? Als die functie nu honderden regels code lang is, moet je de hele functie gaan doorzoeken. Daarom is het dus nuttig om je functies van goed commentaar te voorzien.
Het is ook nuttig als je nu of later in teamverband gaat werken. Dan weet iedereen wat de functie doet.
Ik ga een paar dingen bespreken over commentaar. Bijvoorbeeld welke stijlen je kan gebruiken in PHP, hoe je informatie makkelijk kan laten zien en een veel gebruikte stijl om niet in een chaos verdwaald te raken, PHPDocumenter.