Update README.md

Minor grammar/capitalization edits
Update call_person.rb

Typo and added context about PD events API
Update call_person.rb
Update README.md

Add PagerDuty API doc links
Merge pull request #7 from dshack/master

Add PD doc links