updated PHPDoc of models