github/developer.github.com — pull request #350 by jasonrudolph (2013-11-04 13:30:40+00:00)
Title: Clarify list of expected API changes

To get us one step closer to [ending beta mode on API v3][1]:

- Replace the "Expected Changes" section with a "Deprecations" section. Explain that the items in this section:
- Are officially supported in API v3
- Will be removed from the _next_ major version of the API
- Provide a recommendation for dealing with each deprecated feature.
- Remove deprecated attributes from response examples.
- Move the deprecation notice inline for the beta `/user/emails` response format. This format will _not_ be part of v3, so it doesn't belong in the v3 deprecations list.

/cc @pengwynn @gjtorikian @izuzak @jdennes

[1]: https://github.com/github/platform/blame/d03110e7e46850d68ce6992608163480680667fc/docs/api_roadmap.md#L6-L10