1 files changed, 19 insertions, 6 deletions
diff --git a/lib/api/entities/license.rb b/lib/api/entities/license.rb
index 8ecf8a430fe..6318fec6774 100644
--- a/lib/api/entities/license.rb
+++ b/lib/api/entities/license.rb
@@ -4,12 +4,25 @@ module API
   module Entities
     # Serializes a Licensee::License
     class License < Entities::LicenseBasic
-      expose :popular?, as: :popular
-      expose(:description) { |license| license.meta['description'] }
-      expose(:conditions) { |license| license.meta['conditions'] }
-      expose(:permissions) { |license| license.meta['permissions'] }
-      expose(:limitations) { |license| license.meta['limitations'] }
-      expose :content
+      expose :popular?, as: :popular, documentation: { type: 'boolean' }
+
+      expose :description, documentation: { type: 'string', example: 'A simple license' } do |license|
+        license.meta['description']
+      end
+
+      expose :conditions, documentation: { type: 'string', is_array: true, example: 'include-copyright' } do |license|
+        license.meta['conditions']
+      end
+
+      expose :permissions, documentation: { type: 'string', is_array: true, example: 'commercial-use' } do |license|
+        license.meta['permissions']
+      end
+
+      expose :limitations, documentation: { type: 'string', is_array: true, example: 'liability' } do |license|
+        license.meta['limitations']
+      end
+
+      expose :content, documentation: { type: 'string', example: 'GNU GENERAL PUBLIC LICENSE' }
     end
   end
 end