add phpDoc description to class vars and methods, and code style to PSR-2