"Документация будет использоваться только разработчиками. Хотел использовать PhpDoc, но это немного для другого"
Простите, для чего другого?
По опыту скажу, гораздо проще разобраться в коде если он сделан в едином стиле, в том числе и комментарии.
Если вы собираетесь брать опытных программистов, то такой подход спасет вас от кучи лишних вопросов от них, а программистов от кучи экспериментов для выяснения, что же делает это "волшебный" метод)
