Add PD doc links

Created by: dshack

Add some links to the PD API documentation, and explain the difference between the two PD APIs.

Additionally, a few tiny pedantic text edits.