Merge pull request #2587 from Dorthu/document-final-changes

Documents final changes to release

Author: jamesottinger

docs/src/data/endpoints/profile.yaml

@@ -316,6 +316,7 @@ endpoints:
       as well as applications that you have created and authorized yourself.
     methods:
       GET:
+        response: oauthapp
         description: >
           Returns all application allowed to access your user's resources.
         examples:

docs/src/data/objects/linode.yaml

@@ -26,21 +26,18 @@ schema:
       type: Integer
       value: 10000
       description: Disk IO Rate ops/sec (Range 0-100000, default 10000). 0 to disable.
-    transfer:
-      type: Object
-      description: Thresholds for sending email alerts.
-      in:
-        type: Integer
-        value: 0
-        description: Incoming Traffic Mbit/s (Range 0-40000, default 10). 0 to disable.
-      out:
-        type: Integer
-        value: 10
-        description: Outbound Traffic Mbit/s (Range 0-10000, default 10). 0 to disable.
-      quota:
-        type: Integer
-        value: 80
-        description: Transfer Quota % (Range 0-400, default 80). 0 to disable.
+    network_in:
+      type: Integer
+      value: 0
+      description: Incoming Traffic Mbit/s (Range 0-40000, default 10). 0 to disable.
+    network_out:
+      type: Integer
+      value: 10
+      description: Outbound Traffic Mbit/s (Range 0-10000, default 10). 0 to disable.
+    transfer_quota:
+      type: Integer
+      value: 80
+      description: Transfer Quota % (Range 0-400, default 80). 0 to disable.
   backups:
     type: Object
     seeAlso: "/reference/endpoints/linode/instances/$id/backups"

docs/src/data/objects/oauthapp.yaml

@@ -0,0 +1,41 @@
+name: OAuth App
+prefix: profile/apps
+description: >
+  An application you have authorized to access your account.
+schema:
+  id:
+    type: Integer
+    value: 123
+    description: >
+      The authorization ID for this application.
+  label:
+    type: String
+    description: >
+      This application's name.
+    value: Install-on-Linode
+  thumbnail_url:
+    type: String
+    description: A link to this application's thumbnail, or null if unset.
+    value: null
+  scopes:
+    type: String
+    description: >
+      The OAuth Scopes you granted this application when you authorized it.
+      These were presented on login.linode.com when you were granting the
+      application access to your account.
+    value: linodes:*
+  created:
+    type: Datetime
+    description: When you granted this application access to your account.
+    value: 2017-10-02T07:37:23
+  expiry:
+    type: Datetime
+    description: >
+      The date and time when this token is no longer honored as valid.  You can
+      expire a token immediately by sending a DELETE request to its resource.
+    value: 2017-10-16T07:37:23
+  website:
+    type: String
+    description: >
+      The domain where this application lives, as determined by its redirect_uri.
+    value: http://localhost:8000