Improve pecan documentation and correct intersphinx references.

Change-Id: Iac6229a2727a3c662d3fe9e83e1aa02ef648f025