I’ve found what appear to be two forks of the pdoc documentation generator
pdoc (GitHub) and pdoc3 (GitHub). From
comparing the commit graphs, these appear to have split in mid-2018, but
perhaps later, or perhaps there are some commits crossing between the two.
The differences I’ve seen are:
-
pdoc:
- PyPI: 1st release 2013-08-09; v14.4.0 released 2024-01-18
- Github: 48 contributors, used by 2.6k, 189 forks, starred by 1.8k
- Moderate commit activity over the last year
- Hosted under a GitHub personal account
-
pdoc3:
- PyPI: 1st release 2019-01-25; v0.10.0 released 2021-08-03
- Github: 64 contributors, used by 3.8k, 143 forks, starred by 1.1k
- Little commit activity in the last year and a half
- Hosted under a GitHub organisation, but it has only one member
From the releases it looks as if pdoc3 is a fork of pdoc, but I can’t see
any explanation of why it forked or what the differences are. Given that,
and the slower pace of commits, it seems to me surprising that it has more
“users” (which I believe are projects with a requirements.txt
referencing
it) than pdoc.
At any rate, I don’t necessarily need the details of why the split
happened, but I would like to know what features pdoc3 provides that pdoc
doesn’t, and vice versa, as well as anything else relevant to making a
choice between the two.