Add PD doc links

Add some links to the PD API documentation, and explain the difference between the two PD APIs. 

Additionally, a few tiny pedantic text edits.