> I think you can make those reasons clear in your docs without causing the sort of confusion I had. ... The hand-waving "I couldn't configure it" doesn't work

> I think you can make those reasons clear in your docs without causing the sort of confusion I had. ... The hand-waving "I couldn't configure it" doesn't work in your favor. Excellent suggestion. I'm still full of emotion after writing that rant, but when I calm down, I'll try and craft a section on "Why Not Sphinx" in my README. It's quite literally the only criticism I've received so far. I'll keep your interpretation of pdoc's advantages in mind. > and I work with it a lot to write the docs for this project: http://mrjob.readthedocs.org/en/latest/ http://mrjob.readthedocs.org/en/latest/ You have my compliments. That is really beautiful (in every sense) documentation---you are clearly not among those who aren't conscious of putting links in obvious places. :-)