Если у меня есть служба на основе REST, написанная в рамках Symfony [symfony-project.org] (например, PHP), есть ли какие-то достойные инструменты / фреймворки, которые будут анализировать мой код и создавать документацию API? В основе Java-based framework входят возможности документации, аналогичные тем, что мне нужно, вы можете посмотреть пример этого здесь: http://enunciate.codehaus.org/wannabecool/step1/index.html . Я понимаю, что предпосылка […]
phpDocumentor, похоже, является стандартом для документирования PHP-кода, хотя мне нужно задаться вопросом, почему он не обновлялся годами? Однако он не подходит для документирования точек входа для REST API; IE, внешние доступные точки входа, которые будут интересовать конечный пользователь вашей системы, в отличие от документирования всех внутренних классов и т. Д., Что представляет интерес только для […]