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