我发现了 pdoc 文档生成器的两个分支 pdoc(GitHub)和pdoc3(GitHub)。从 比较提交图,这些似乎在 2018 年中期就分裂了,但是 也许稍后,或者也许两者之间有一些交叉的提交。 我看到的差异是:
pdoc:
pdoc3:
从发行版来看,pdoc3 似乎是 pdoc 的一个分支,但我看不到 关于它为什么分叉或者有什么区别的任何解释。鉴于, 而且提交速度较慢,在我看来令人惊讶的是它有更多 “用户”(我相信这是带有
requirements.txt
引用的项目
它)而不是 pdoc。
无论如何,我不一定需要为什么拆分的详细信息 发生了,但我想知道 pdoc3 提供了哪些功能 pdoc 不,反之亦然,以及与制作相关的任何其他内容 两者之间选择。
注意:我不要求任何人推荐其中之一,我对此类建议也不感兴趣。我只对有助于我自己做出决定的“事实”感兴趣。 (对于不同的项目,这个决定可能会有所不同。)