Merge pull request #835 from bbiggerr/kernels-update

Updated kernels descriptions for clarity

Author: bbiggerr

openapi.yaml

@@ -8043,6 +8043,8 @@ paths:
       summary: Kernels List
       description: |
         Lists available Kernels.
+
+        Due to the extensive list of available kernels, please keep [pagination](/docs/api/#pagination) controls in mind when managing responses to this command.
       operationId: getKernels
       x-linode-cli-action:
         - list
@@ -22404,7 +22406,15 @@ components:
           x-linode-cli-display: 1
         kernel:
           type: string
-          description: A Kernel ID to boot a Linode with. Defaults to "linode/latest-64bit".
+          default: linode/latest-64bit
+          description: |
+            A Kernel ID to boot a Linode with. Here are examples of commonly-used kernels:
+
+            * `linode/latest-64bit` (default): Our latest kernel at the time of instance boot/reboot.
+            * `linode/grub2`: The upstream distribution-supplied kernel that is installed on the primary disk, or a custom kernel if installed.
+            * `linode/direct-disk`: The MBR (Master Boot Record) of the primary disk/root device, used instead of a Linux kernel.
+
+            For a complete list of options, use the [Kernels List](/docs/api/linode-instances/#kernels-list) command.
           example: linode/latest-64bit
           x-linode-cli-display: 3
         comments: