Мне нужна система документации для проекта PHP, и я хотел, чтобы она могла интегрировать внешнюю документацию (варианты использования, объем проекта и т. д.) с документацией, созданной из комментариев к коду. Кажется, что phpDocumentor имеет именно тот набор функций, но внешняя документация должна быть написана в DocBook, который слишком сложен для нашей команды.
Если бы это было на питоне, sphinx был бы почти идеальным для этой работы (ReST определенно проще, чем docbook). Есть ли способ интегрировать внешнюю документацию ReST с документами, извлеченными из phpdoc? Должен ли я просто отделить внешнюю документацию (например, использовать ReST для внешней и phpdoc для внутренней)? Или у вас есть лучшее предложение по управлению внешней документацией?