add pagerduty credentials doc
doc fixes and cleanup