Write clean code

Hieronder een voorbeeld van een stuk code, wat geschreven is in PHP. Dit zorgt ervoor dat er een piramide wordt gemaakt van sterretjes. Echter is in de code niet duidelijk welke variabele wat doet, waardoor er comments gebruikt moeten worden om dit te verduidelijken.


<?php

echo "Hoeveel stapels wil je hebben? " . PHP_EOL;
$k = readline("");
// k is een cijfer (de hoogte van je stapel)
$sterretjes = '';
// x1 is een sterretje

for ($i = 0; $i < $k; $i++) {
    $sterretjes .= "*";

    echo $sterretjes . PHP_EOL;
}

Hieronder de aangepaste versie, waarbij de variabelen een duidelijke naam hebben en de comments dus overbodig worden.


<<?php

echo "Hoeveel lagen wil je hebben? " . PHP_EOL;
$aantalLagen = readline("");
$laag = '';

for ($huidigeHoogte = 0; $huidigeHoogte < $aantalLagen; $huidigeHoogte++) {
    $laag .= "*";
    echo $laag . PHP_EOL;
}