For what it's worth, the PDO reference page is the result of taking the existing OO doc approach and trying to include an introductory tutorial within the only logical spot.
In Dan's defense, it was also groundbreaking, as one of the first documented OO extensions/sections.
S
