我需要一个 PHP 项目的文档系统,并且我希望它能够将外部文档(用例、项目范围等)与从代码注释生成的文档集成。似乎 phpDocumentor 具有完全正确的功能集,但外部文档必须用 DocBook 编写,这对我们的团队来说太复杂了。
如果它在 python 中,sphinx 将非常适合这项工作(ReST 绝对比 docbook 简单)。有什么方法可以将外部 ReST 文档与从 phpdoc 中提取的文档集成在一起?我是否应该将外部文档分开(例如,将 ReST 用于外部,将 phpdoc 用于内部)?或者您对管理外部文档有更好的建议吗?