diff --git a/action.yml b/action.yml
index 7a92a67..07b1d83 100644
--- a/action.yml
+++ b/action.yml
@@ -1,5 +1,5 @@
 name: 'Dynamic Badges'
-description: 'Uses shields.io to create custom badges and uploads them to a gist.'
+description: 'Creates badge descriptions to be used with shields.io/endpoint and uploads them to a gist.'
 branding:
   icon: 'tag'
   color: 'green'
@@ -26,28 +26,28 @@ inputs:
     description: 'The right color of the badge'
     required: false
   is-error:
-    description: 'The right color of the badge'
+    description: 'The color will be red and cannot be overridden'
     required: false
   named-logo:
-    description: 'The right color of the badge'
+    description: 'A logo name from simpleicons.org'
     required: false
   logo-svg:
-    description: 'The right color of the badge'
+    description: 'An svg-string to be used as logo'
     required: false
   logo-color:
-    description: 'The right color of the badge'
+    description: 'The color for the logo'
     required: false
   logo-width:
-    description: 'The right color of the badge'
+    description: 'The space allocated for the logo'
     required: false
   logo-position:
-    description: 'The right color of the badge'
+    description: 'The position of the logo'
     required: false
   style:
-    description: 'The right color of the badge'
+    description: 'The style like "flat" or "social"'
     required: false
   cache-seconds:
-    description: 'The right color of the badge'
+    description: 'The cache lifetime in seconds (must be greater than 300)'
     required: false
 runs:
   using: 'node12'