Explain & deprecate merge_commit_sha

The `merge_commit_sha` is often misunderstood. It is internal GitHub plumbing that just happens to be part of the public API. In this PR, we:

- Explain it (to reduce the confusion for the current version of the API)
- Announce plans to remove it from the next version of the API