improved PD documentation