Reviewing API Changes in a Pull Request: Spec Diffs vs Cloud Collection Histories

Quick answer API changes belong in a pull request where the diff is the review artifact. When requests and responses live in a plain spec file, a change to a field, a status code, or a required flag s