Ja standardowo się doczepię do komentarzy ;)
Widzę dwie rzeczy z nimi związane:
1) są wstawiane w miejscach, gdzie nie są konieczne. Jak już wiele razy pisałem (powołując się chociażby na kultowy "Czysty kod"), apka powinna się sama dokumentować. Jeśli musisz wstawić komentarze, żeby wyjaśnić co się w danym miejscu kodu dzieje, to znaczy, że masz miejsce, nad którym powinieneś popracować. Może zmienić nazwy zmiennych, nazwy funkcji, czy coś w logice działania. Przykład pierwszy z brzegu:
//READ REQUEST
$request = new Request();
//CREATE ROUTE
$r = new Route($request);
Naprawdę, te komentarze są totalnie zbędne, raczek ktokolwiek mający nawet mgliste pojęcie jak się programuje, sam na to wpadnie. A jeśli ktoś potrzebuje, żeby takie rzeczy mu wyjaśniać, to raczej nie będzie w stanie sobie podlinkować i wykorzystać Twojej (czy jakiejkolwiek innej) biblioteki.
2) wiadomo, że podczas pracy się pewne fragmenty kodu wykomentowuje, to normalna rzecz.Ale przed publikacją powinieneś kwiatki w stylu
$controller = end($controller);
//$controller = strstr($controller, '/')? ltrim(strstr($controller, '/'), '/') : $controller;
$controller = new $controller();
wywalić, bo wygląda to niezbyt fajnie, mało profesjonalnie i trochę prowizorycznie.