PHPDoc é uma forma de adicionar informações sobre uma estrutura(méotodo ou classe etc) elas são úteis para algumas ferramentas que geram documentação automaticamente apartir desses 'comentários'. Essas informações são importantes para IDE com elas suas classes entram no auto-complete então é fácil ir navegando de um método a outro.
Para usar o doclet é quase igual a um comentário o fato importante é que após a barra são necessarios duasdois asteriscos do conconsecutivos.
/** doclet
/* comentário