Updates documentation. Still incomplete, but much, much better.

Thanks to @Chris911 for pointing out that the docs weren't just
incomplete, but wrong.  This should correct the wrong docs, but still
doesn't complete them.
Adds typehinting to PasswordValidator arg in PdoAdapter