Создание документации к REST API (php)

Понадобилось разработать API для одного сервиса, решил сделать все по "правильному", сделать если не REST, то хотя-бы подобие. Был прикручен роутер, т.е. обрабатывает запросы типа

$router->get('/users/{userId}', function($userId) { тут обработчик функции });

Собственно в чем проблема - попутно надо сделать для фронтендера документацию к данному api. Погуглив про всякие сваггеры, и прочее, самым адекватным и простым решением показался phpdocumentor. Разметка по комментариям - красота, если-бы не одно но. Комментарии в классах он отлично берет, по ним строит документацию, но мне то нужно документировать обращения к роутам. Создание комментариев перед роутами эффекта не дают, в выводе по ним совсем пусто.

Быть может, надо как-то по особому это делать, или, быть может, кто-то сталкивался с такой проблемой, и как-то решал ее другой тулзой, а не phpdoc.