Addressed PR feedback

Josh Sager · Josh Sager · commit 967861303d08 · 2018-05-03T08:40:44.000-04:00
diff --git a/openapi.yaml b/openapi.yaml
@@ -416,7 +416,7 @@ paths:
       description: >
          This endpoint returns a collection of Event objects representing
          actions taken on your Account. The events returned depends on your
-         Grants.
+         grants.
       operationId: getEvents
       x-linode-cli-action: list
       security:
@@ -1443,10 +1443,10 @@ paths:
       summary: List Users
       description: >
         Returns a paginated list of Users on your account.  Users may access all
-        or part of your account based on their restricted status and Grants.  An
+        or part of your account based on their restricted status and grants.  An
         unrestricted user may access everything on the account, whereas restricted
         user may only access entities or perform actions they've been given specific
-        Grants to.
+        grants to.
       operationId: getUsers
       x-linode-cli-action: list
       security:
@@ -1489,7 +1489,7 @@ paths:
       description: >
         Creates a new User on your account.  Once created, the user will be
         able to log in and access portions of your account.  Access is
-        determined by whether or not they are restricted, and what Grants they
+        determined by whether or not they are restricted, and what grants they
         have been given.
       operationId: createUser
       x-linode-cli-action: create
@@ -1591,7 +1591,7 @@ paths:
       description: >
         Update information about a user on your account.  This can be used to
         change the restricted status of a user.  When making a user restricted,
-        no Grants will be configured by default and you must then set up Grants
+        no grants will be configured by default and you must then set up grants
         in order for the user to access anything on the account.
       operationId: updateUser
       x-linode-cli-action: update
@@ -1634,7 +1634,7 @@ paths:
       summary: Delete User
       description: >
         Deletes a user. The deleted user will be immediately logged out and
-        may no longer log in or perform any actions. All Grants that user had
+        may no longer log in or perform any actions. All grants that user had
         will be lost.
       operationId: deleteUser
       x-linode-cli-action: delete
@@ -1673,11 +1673,11 @@ paths:
       x-linode-grant: unrestricted only
       tags:
       - account
-      summary: View User's Grants
+      summary: View User's grants
       description: >
         Returns the full grants structure for this user. This includes all
         entities on the account alongside what level of access this user has
-        to each of them.  Individual users may view their own Grants at the
+        to each of them.  Individual users may view their own grants at the
         [/profile/grants](/#operation/getProfileGrants)
         endpoint, but will not see entities that they have no access to.
       operationId: getUserGrants
@@ -1689,14 +1689,14 @@ paths:
         - account:read_only
       responses:
         '200':
-          description: The user's Grants.
+          description: The user's grants.
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/GrantsResponse'
         '204':
           description: >
-            This is an unrestricted user, and therefore has no Grants to return.
+            This is an unrestricted user, and therefore has no grants to return.
             This user may access everything on the account and perform all actions.
         default:
           $ref: '#/components/responses/ErrorResponse'
@@ -1709,11 +1709,11 @@ paths:
       x-linode-grant: unrestricted only
       tags:
       - account
-      summary: Update User's Grants
+      summary: Update User's grants
       description: >
-        Update the Grants a user has. This can be used to give a user access
+        Update the grants a user has. This can be used to give a user access
         to new entities or actions, or take access away. You do not need to
-        include the Grant for every entity on the account in this request; any
+        include the grant for every entity on the account in this request; any
         that are not included will remain unchanged.
       operationId: updateUserGrants
       x-linode-cli-action: update-grants
@@ -1723,7 +1723,7 @@ paths:
       - oauth:
         - account:read_write
       requestBody:
-        description: The Grants to update. Omitted Grants will be left unchanged.
+        description: The grants to update. Omitted grants will be left unchanged.
         required: true
         content:
           application/json:
@@ -2550,7 +2550,7 @@ paths:
       summary: Create Linode
       description: |
         This endpoint allows you to create a new Linode server on your account. In order for this
-        request to complete successfully, your user must have the `add_linodes` Grant. Creating a
+        request to complete successfully, your user must have the `add_linodes` grant. Creating a
         new Linode will incur a charge on your account.
 
         Linodes can be created using one of the available types. See
@@ -3223,7 +3223,7 @@ paths:
       description: >
         You can clone your Linode's existing disks or configuration profiles to
         another Linode on your account. In order for this request to complete
-        successfully, your user must have the `add_linodes` Grant. Cloning to a
+        successfully, your user must have the `add_linodes` grant. Cloning to a
         new Linode will incur a charge on your account.
 
         If cloning to an existing Linode, any actions currently running or
@@ -7733,7 +7733,7 @@ paths:
         This returns a GrantsResponse describing what the acting user has been
         granted access to. For unrestricted users, this will return a  204 and
         no body because unrestricted users have access to everything without
-        Grants. This will not return information about entities you do not have
+        grants. This will not return information about entities you do not have
         access to. This endpoint is useful when writing third-party OAuth
         applications to see what options you should present to the acting user
         (for example, if they do not have `global.add_linodes`, you might not
@@ -7754,7 +7754,7 @@ paths:
                 $ref: '#/components/schemas/GrantsResponse'
         '204':
           description: >
-            This is an unrestricted user, who has no Grants. This user can access
+            This is an unrestricted user, who has no grants. This user can access
             everything on the account.
         default:
           $ref: '#/components/responses/ErrorResponse'
@@ -8557,7 +8557,7 @@ paths:
       description: >
         This endpoint allows you to create a new Volume on your account. In order
         for this to complete successfully, your user must have the `add_volumes`
-        Grant. Creating a new Volume will start accruing additional charges
+        grant. Creating a new Volume will start accruing additional charges
         on your account.
 
         Volume service may not be available in all regions. See
@@ -8835,7 +8835,7 @@ paths:
       description: >
         This endpoint allows you to create a new Volume on your account. In
         order for this request to complete successfully, your user must have the
-        `add_volumes` Grant. The new Volume will have the same size and data as
+        `add_volumes` grant. The new Volume will have the same size and data as
         the source Volume. Creating a new Volume will incur a charge on your
         account.
       tags:
@@ -9877,7 +9877,7 @@ components:
         entity related to your Account. For example, booting a Linode would
         create an Event.
 
-        The events returned depends on your Grants.
+        The events returned depends on your grants.
       properties:
         id:
           type: integer
@@ -10050,7 +10050,7 @@ components:
         id:
           type: integer
           description: >
-            The ID of the entity this Grant applies to.
+            The ID of the entity this grant applies to.
           example: 123
         permissions:
           type: string
@@ -10065,16 +10065,16 @@ components:
         label:
           type: string
           description: >
-            The current label of the entity this Grant applies to, for display
+            The current label of the entity this grant applies to, for display
             purposes.
           example: example-entity
           readOnly: true
     GrantsResponse:
       type: object
       description: >
-        A structure representing all Grants a restricted user has on the
+        A structure representing all grants a restricted user has on the
         account.  Not available for unrestricted users, as they have access to
-        everything without Grants. If retrieved from the `/profile/grants`
+        everything without grants. If retrieved from the `/profile/grants`
         endpoint, entities to which a user has no access will be omitted.
       properties:
         global:
@@ -10134,50 +10134,50 @@ components:
           items:
             $ref: '#/components/schemas/Grant'
           description: >
-            The Grants this user has pertaining to Linodes on this account.
+            The grants this user has pertaining to Linodes on this account.
             There will be one entry per Linode on the account.
         domain:
           type: array
           items:
             $ref: '#/components/schemas/Grant'
           description: >
-            The Grants this user has pertaining to Domains on this account.
+            The grants this user has pertaining to Domains on this account.
             There will be one entry per Domain on the account.
         nodebalancer:
           type: array
           items:
             $ref: '#/components/schemas/Grant'
           description: >
-            The Grants this user has pertaining to NodeBalancers on this
-            account.  There will be one entry per NodeBalancer on the account.
+            The grants this user has pertaining to NodeBalancers on this
+            account. There will be one entry per NodeBalancer on the account.
         image:
           type: array
           items:
             $ref: '#/components/schemas/Grant'
           description: >
-            The Grants this user has pertaining to Images on this account.
+            The grants this user has pertaining to Images on this account.
             There will be one entry per Image on the account.
         longview:
           type: array
           items:
             $ref: '#/components/schemas/Grant'
           description: >
-            The Grants this user has pertaining to Longview Clients on this
-            account.  There will be one entry per Longview Client on the
+            The grants this user has pertaining to Longview Clients on this
+            account. There will be one entry per Longview Client on the
             account.
         stackscript:
           type: array
           items:
             $ref: '#/components/schemas/Grant'
           description: >
-            The Grants this user has pertaining to StackScripts on this
-            account.  There will be one entry per StackScript on the account.
+            The grants this user has pertaining to StackScripts on this
+            account. There will be one entry per StackScript on the account.
         volume:
           type: array
           items:
             $ref: '#/components/schemas/Grant'
           description: >
-            The Grants this user has pertaining to Volumes on this account.
+            The grants this user has pertaining to Volumes on this account.
             There will be one entry per Volume on the account.
     ImagePrivate:
       type: object
