Sorry for the surprise, Thomas. We don’t have a mailing list for these changes right now, but we’ll be working on that.
We take breaking change management seriously and wouldn’t modify a programming interface without warning. In this case, we made a style change to be more in line with our recent brand changes and give end-users more confidence that they are actually on a PagerDuty site.
We haven’t taken down the doc you linked to yet, but we put up a new one:
https://v2.developer.pagerduty.com/docs/oauth-2-functionality
We have 2 more changes planned:
- Displaying an app icon when one is available
- Indicating when an app is not reviewed by PagerDuty
We plan to send an email to all OAuth app developers (before displaying the not verified message) to give them an opportunity to submit their app for review if it’s meant to be publicly accessible. Going forward, we can do that ahead of style changes as well although I don’t expect those to happen frequently.