1 files changed, 21 insertions, 11 deletions

diff --git a/lib/api/entities/application_statistics.rb b/lib/api/entities/application_statistics.rb
index 4bcba1da464..7e75ef23675 100644
--- a/lib/api/entities/application_statistics.rb
+++ b/lib/api/entities/application_statistics.rb
@@ -6,47 +6,57 @@ module API
       include ActionView::Helpers::NumberHelper
       include CountHelper
 
-      expose :forks do |counts|
+      expose :forks,
+             documentation: { type: 'integer', example: 6, desc: 'Approximate number of repo forks' } do |counts|
         approximate_fork_count_with_delimiters(counts)
       end
 
-      expose :issues do |counts|
+      expose :issues,
+             documentation: { type: 'integer', example: 121, desc: 'Approximate number of issues' } do |counts|
         approximate_count_with_delimiters(counts, ::Issue)
       end
 
-      expose :merge_requests do |counts|
+      expose :merge_requests,
+             documentation: { type: 'integer', example: 49, desc: 'Approximate number of merge requests' } do |counts|
         approximate_count_with_delimiters(counts, ::MergeRequest)
       end
 
-      expose :notes do |counts|
+      expose :notes,
+             documentation: { type: 'integer', example: 6, desc: 'Approximate number of notes' } do |counts|
         approximate_count_with_delimiters(counts, ::Note)
       end
 
-      expose :snippets do |counts|
+      expose :snippets,
+             documentation: { type: 'integer', example: 4, desc: 'Approximate number of snippets' } do |counts|
         approximate_count_with_delimiters(counts, ::Snippet)
       end
 
-      expose :ssh_keys do |counts|
+      expose :ssh_keys,
+             documentation: { type: 'integer', example: 11, desc: 'Approximate number of SSH keys' } do |counts|
         approximate_count_with_delimiters(counts, ::Key)
       end
 
-      expose :milestones do |counts|
+      expose :milestones,
+             documentation: { type: 'integer', example: 3, desc: 'Approximate number of milestones' } do |counts|
         approximate_count_with_delimiters(counts, ::Milestone)
       end
 
-      expose :users do |counts|
+      expose :users, documentation: { type: 'integer', example: 22, desc: 'Approximate number of users' } do |counts|
         approximate_count_with_delimiters(counts, ::User)
       end
 
-      expose :projects do |counts|
+      expose :projects,
+             documentation: { type: 'integer', example: 4, desc: 'Approximate number of projects' } do |counts|
         approximate_count_with_delimiters(counts, ::Project)
       end
 
-      expose :groups do |counts|
+      expose :groups,
+             documentation: { type: 'integer', example: 1, desc: 'Approximate number of projects' } do |counts|
         approximate_count_with_delimiters(counts, ::Group)
       end
 
-      expose :active_users do |_|
+      expose :active_users,
+             documentation: { type: 'integer', example: 21, desc: 'Number of active users' } do |_|
         number_with_delimiter(::User.active.count)
       end
     end