1 files changed, 11 insertions, 10 deletions
diff --git a/lib/api/entities/packages/debian/distribution.rb b/lib/api/entities/packages/debian/distribution.rb
index 97a3c479f40..a11f4337f38 100644
--- a/lib/api/entities/packages/debian/distribution.rb
+++ b/lib/api/entities/packages/debian/distribution.rb
@@ -5,17 +5,18 @@ module API
     module Packages
       module Debian
         class Distribution < Grape::Entity
-          expose :id
-          expose :codename
-          expose :suite
-          expose :origin
-          expose :label
-          expose :version
-          expose :description
-          expose :valid_time_duration_seconds
+          expose :id, documentation: { type: 'integer', example: 1 }
+          expose :codename, documentation: { type: 'string', example: 'unstable' }
+          expose :suite, documentation: { type: 'string', example: 'unstable' }
+          expose :origin, documentation: { type: 'string', example: 'Grep' }
+          expose :label, documentation: { type: 'string', example: 'grep.be' }
+          expose :version, documentation: { type: 'string', example: '12' }
+          expose :description, documentation: { type: 'string', example: 'My description' }
+          expose :valid_time_duration_seconds, documentation: { type: 'integer', example: 604800 }
 
-          expose :component_names, as: :components
-          expose :architecture_names, as: :architectures
+          expose :component_names, as: :components, documentation: { is_array: true, type: 'string', example: 'main' }
+          expose :architecture_names, as: :architectures,
+                                      documentation: { is_array: true, type: 'string', example: 'amd64' }
         end
       end
     end