Теги PHPDocumentor применяются для описания различных участков кода. Разделим теги по категориям описываемого кода.
Для любых категорий
author
copyright
deprecated
example
ignore
internal
link
see
since
source(except Files)
todo
uses
version
Файлы
filesource
Классы
method
property
property-read
property-write
Файлы и Классы
license
category
package
subpackage
Методы классов
api
Методы классов и Функции
param
return
throws
Свойства классов
var
Переменные
global