Sync changes from upstream repository

Hubot · Hubot · commit 7eaa0f65647f · 2014-09-05T21:08:42.000Z
diff --git a/content/changes/2014-09-05-removing-gravatar-id.md b/content/changes/2014-09-05-removing-gravatar-id.md
@@ -0,0 +1,23 @@
+---
+kind: change
+title: Removing Gravatar ID from user payloads
+created_at: 2014-09-05
+author_name: mastahyeti
+---
+
+We have deprecated the `gravatar_id` attribute in the [user
+representation](https://developer.github.com/v3/users/). Starting September 19,
+the API will always provide an empty string as the value for this attribute.
+
+Users have been able to upload avatars directly to GitHub for [a while
+now](https://github.com/blog/1803-switch-your-picture-with-ease). If users
+haven't uploaded an avatar, we still try to fetch one from Gravatar, but that
+happens behind the scenes on GitHub's servers. As a result, the `gravatar_id`
+attribute no longer identifies a GitHub user's canonical avatar. Instead, API
+consumers should use the `avatar_url` to fetch a user's avatar. The `avatar_url`
+attribute has always been present in the [v3 user representation](/v3/users/)
+and is the only reliable way to find a GitHub user's avatar.
+
+If you have any questions or feedback, please [get drop us a line][contact].
+
+[contact]: https://github.com/contact?form[subject]=Removing+Gravatar+ID
diff --git a/content/v3/versions.md b/content/v3/versions.md
@@ -94,6 +94,9 @@ The recommendations below will help you prepare your application for the next ma
 1. User attribute: plan["collaborators"]
 : Recommendation: Do not use this attribute. It is obsolete.
 
+1. User attribute: gravatar_id
+: Recommendation: Use **avatar_url** instead.
+
 1. Pagination parameters `top` and `sha` for method: /repos/:owner/:repo/commits
 : Recommendation: When fetching [the list of commits for a repository](/v3/repos/commits/#list-commits-on-a-repository)
   use the [standard `per_page` and `page` parameters](/v3/#pagination) for pagination, instead of `per_page`,
