added PHPDoc to most repo methods