It even has a subchapter named "Authentication Problems" though it seems like discussion of (typical) default peer dynamics is missing.
In particular, if you connect via local socket (also a default) the order of entries in (typical default) pg_hba.conf says you must login using peer, not password.