1 files changed, 15 insertions, 5 deletions
diff --git a/lib/api/entities/commit_note.rb b/lib/api/entities/commit_note.rb
index fe91712b48d..0632dc467b8 100644
--- a/lib/api/entities/commit_note.rb
+++ b/lib/api/entities/commit_note.rb
@@ -3,12 +3,22 @@
 module API
   module Entities
     class CommitNote < Grape::Entity
-      expose :note
-      expose(:path) { |note| note.diff_file.try(:file_path) if note.diff_note? }
-      expose(:line) { |note| note.diff_line.try(:line) if note.diff_note? }
-      expose(:line_type) { |note| note.diff_line.try(:type) if note.diff_note? }
+      expose :note, documentation: { type: 'string', example: 'this doc is really nice' }
+
+      expose :path, documentation: { type: 'string', example: 'README.md' } do |note|
+        note.diff_file.try(:file_path) if note.diff_note?
+      end
+
+      expose :line, documentation: { type: 'integer', example: 11 } do |note|
+        note.diff_line.try(:line) if note.diff_note?
+      end
+
+      expose :line_type, documentation: { type: 'string', example: 'new' } do |note|
+        note.diff_line.try(:type) if note.diff_note?
+      end
+
       expose :author, using: Entities::UserBasic
-      expose :created_at
+      expose :created_at, documentation: { type: 'dateTime', example: '2016-01-19T09:44:55.600Z' }
     end
   end
 end