Type-hint object parameters, consistent variable names, PHPDoc