lots of pod markup fixes
Merge pull request #397 from karenetheridge/topic/doc_links

lots of pod markup fixes