How the fuck was any of Pythons docs better than Perl’s? ??????????
Docs, error messages etc are WAY superior in Perl. Idiot.
Django's docs were better than Catalysts (I would agree with you that python's docs aren't great).
Catalyst being Perl had more than one way to do everything, to the point that i couldn't actually work out what the framework was other than the URL router. Django had a far more sane approach which would seem to be needed if its your first time venturing into a web framework.
There are a lot of concepts to understand with a framework so my guess is that's actually your problem, but as far as documentation goes, Django's is pretty good.