Merge pull request #2821 from SzySteve/docs/distribution

documentation for distribution/image unification

Author: Dorthu

docs/src/data/endpoints/images.yaml

@@ -10,6 +10,7 @@ endpoints:
     methods:
       GET:
         response: image
+        paginationKey: images
         oauth: 'images:view'
         description: |
           Returns a list of images.
@@ -38,7 +39,7 @@ endpoints:
       PUT:
         oauth: 'images:modify'
         description: |
-          Modifies a given image
+          Modifies a given image. Only private images belonging to you are modifiable.
         examples:
           curl: |
             curl -H "Content-Type: application/json" \
@@ -54,7 +55,7 @@ endpoints:
       DELETE:
         oauth: 'images:delete'
         description: |
-          Deletes a given image
+          Deletes a given image.Only private images belonging to you are deletable.
         examples:
           curl: |
             curl -H "Authorization: Bearer $TOKEN" \

docs/src/data/endpoints/linodes.yaml

@@ -1188,13 +1188,14 @@ endpoints:
   /linode/distributions:
     group: Distributions
     description: >
-      View the collection of distributions.
+      THIS ENDPOINT IS DEPRECATED. USE /images INSTEAD. Returns information about this distribution.
     methods:
       GET:
-        response: distribution
+        response: image
         paginationKey: distributions
         description: >
-          Returns a list of distributions.
+          THIS ENDPOINT IS DEPRECATED. USE /images INSTEAD. Returns information about this distribution.
+        seeAlso: ["/reference/endpoints/images"]
         examples:
           curl: |
             curl https://$api_root/$version/linode/distributions
@@ -1204,12 +1205,13 @@ endpoints:
     group: Distributions
     type: resource
     description: >
-      Returns information about a specific distribution.
+      THIS ENDPOINT IS DEPRECATED. USE /images INSTEAD. Returns information about this distribution.
     methods:
       GET:
-        response: distribution
+        response: image
         description: >
-          Returns information about this distribution.
+          THIS ENDPOINT IS DEPRECATED. USE /images INSTEAD. Returns information about this distribution.
+        seeAlso: ["/reference/endpoints/images"]
         examples:
           curl: |
             curl https://$api_root/$version/linode/distributions/$distribution_id

docs/src/data/objects/image.yaml

@@ -1,6 +1,7 @@
 name: Image
 description: >
-  Image objects describe an image that was made based off a device on a Linode
+  Image objects describe an image that was made based off a device, or an official
+  image created by Linode for public use.
 schema:
   id:
     type: Integer
@@ -53,3 +54,11 @@ schema:
     type: String
     value: "2017-10-19T11:21:01"
     description: The last time this image was used.
+  min_deploy_size:
+    type: Integer
+    value: 1000
+    description: The minimum size this image needs to deploy.
+  creator:
+    type: String
+    value: your_username
+    description: The name of the user who created this image, or linode for official images.