Clarify some subs.
Also fix some spelling errors.
Fix some typos in the PD, plus some formatting errors.
Add an extra developer test for the POD.

Signed-off-by: Shawn Laffan <shawnlaffan@gmail.com>