PHP プロジェクトのドキュメンテーション システムが必要で、コード コメントから生成されたドキュメンテーションと外部ドキュメンテーション (ユース ケース、プロジェクト スコープなど) を統合できるようにしたいと考えていました。phpDocumentor は正確に適切な機能セットを備えているようですが、外部ドキュメントは DocBook で作成する必要があり、これは私たちのチームにとって複雑すぎます。
それが Python の場合、sphinx はこの仕事にほぼ完璧です (ReST は間違いなく docbook よりも簡単です)。外部の ReST ドキュメントを phpdoc から抽出したドキュメントと統合する方法はありますか? 外部ドキュメントを分離する必要がありますか (たとえば、外部には ReST を使用し、内部には phpdoc を使用します)。または、外部ドキュメントを管理するためのより良い提案はありますか?