Clearly document scope normalization

pengwynn · pengwynn · commit bffb2badea04 · 2014-01-30T09:09:43.000-06:00
diff --git a/content/v3/oauth.md b/content/v3/oauth.md
@@ -96,6 +96,14 @@ additional permission, but don’t forget that users can always say no.
 Check out the [Basics of Authentication guide][basics auth guide] which
 provides tips on handling modifiable token scopes.
 
+#### Normalized scopes
+
+When requesting multiple scopes, the token will be saved with a normalized list
+of scopes, discarding any scopes that are already included in any other scopes
+in the list. For example, requesting `user,gist,user:email` will result in a
+token with `user` and `gist` scopes only since the access granted with
+`user:email` scope [is included](#scopes) in the `user` scope.
+
 ### 3. Use the access token to access the API
 
 The access token allows you to make requests to the API on a behalf of a user.
