pdoc and pdoc3 confusion

[aahnik]

I went to the website linked in this GitHub repo. https://pdoc3.github.io/pdoc/

I did pip3.8 install pdoc3 as stated.

Then this below thing messed up everything

Markdown did not get rendered properly. Fenced code (inside ```) did not render.
And the HTML was not looking like shown in the website. Also links were not clickable

But when I used pdoc3 command instead of pdoc, everything got sorted. Fenced code got rendered with color highlighting.
and the look was great.

At the bottom of the rendered page there was a link that says

I clicked on the link and reached the website https://pdoc3.github.io/pdoc/, from which I took the topmost screenshot

[kernc]

Pdoc3 does install as pdoc:

pdoc/setup.py

Lines 39 to 44 in d8b9dbc

	entry_points={
	"console_scripts": [
	"pdoc = pdoc.cli:main",
	"pdoc3 = pdoc.cli:main",
	],
	},

The only reason this wouldn't work is by having a prior bin/pdoc installed and pip not overwrite it. I'm almost certain pip did produce a warning, though.

Related: #131

[aahnik]

No pip did not produce any warning. It may be due to my system. There are multiple versions and virtual environments. May be I made some other mistake that messed up something.

But using pdoc3 changed my experience. Earlier I was frustrated and miserable.

Now seeing the ease of pdoc3 I have fallen in love with writing documentation.

Thanks a lot @kernc for this wonderful project.

No doubt pdoc3 is the best tool out there to generate docs.

[kernc]

Oh, my, I have doubts. 😅 Ymmv. But thanks! ❤️